Repository navigation
remote_handler 0.4.0
[0.4.0] — 2026-07-02
A feature release on top of 0.3.0. The headline is a rewrite of trajectory
post-processing into a self-contained plugin framework
(remote_handler.processing), plus a mace-jax ASE calculator, a staged
active-learning handler, and connection resilience for the subprocess-ssh path.
Breaking: the old optimizer entry points are gone, replaced by
remote_handler.processing (no compatibility shims).
Added
remote_handler.processing— a self-contained, extensible trajectory-
processing framework, organized by feature rather than by layer. A
RemoteTrajectoryProcessorshards a trajectory and runs an ordered list of
Processorsteps over each shard (viaprocessing/driver.pyon the cluster);
RemoteOptimizationHandleris a thin factory for the optimize step.
Structural analysis is just the core with the processors you want, e.g.
processors=[RDFProcessor(), SteinhardtProcessor()].- Processor plugin contract — each processor keeps its whole trio in one
module: anArgsschema (single source of truth), a cluster-siderun, and
a host-sideProcessorspec, wired viaregister(name, run, schema=...).
Downstream packages self-register the same way; the driver imports each
processor'sregistration_modulebefore resolving steps, so a downstream
processor works with no custom driver. Built-ins:optimize,rdf. - Per-processor argument validation — the driver validates every step's
args against its schema at job start (schema.from_dict(args).validate()),
so a malformed composed payload fails fast instead of deep inside an array
task. The hostbuild_argsfills the same schema, so emit and check can't
drift. - mace-jax ASE calculator (
scripts/mace/mace_jax_ase.py,
MaceJaxEnsembleCalculator) — single model or stacked-params ensemble, with
amax_neighborsbucket ladder to bound JIT recompiles and per-structure
energy/force uncertainty from the ensemble spread. StagedActiveLearningHandler(+Stage,InputSource,SelectorActor)
— a staged active-learning loop with explicit per-stage inputs and selection.- Selector as an actor —
SelectorActorplus novelty/uncertainty-based
selection wired through the loop; selectors take an explicitreference
argument rather than mutating shared state. - Connection resilience — an opt-in
ConnectionPolicy(per-cluster
resilient_connection) that pauses-and-retries SSH operations when a
credential expires instead of crashing, resuming once it is refreshed. configure_logging— a utility for timestamped logging.remote_handler show extrasnow also reports the installedremote_handler
version and conda env, per configured machine.
Changed
UniformSelector→StrideSelector. The old name remains as a subclass
alias that emits aDeprecationWarning; it will be removed in a future
release.- Every subprocess
sshinvocation is now non-interactive by construction
(stdinclosed,-o BatchMode=yes -o ConnectTimeout=…, detached session)
and bounded byConnectionPolicy.command_timeout(default 120s, applies even
when resilience is off), so a stalled connection surfaces as an error rather
than an indefinite hang.
Fixed
- Subprocess
sshno longer hangs on an interactive QR/MFA prompt when a
stepcertificate expires: the prompt can't grab the terminal, and a bounded
timeout turns the stall into aTimeoutExpiredthat is classified transient
and retried under an enabled policy. squeuestatus polling treats a purged (completed) job —squeue -j
exiting with "Invalid job id specified" — as finished, instead of crashing
the driver (the failure seen when a job completes while the connection is
briefly down).- Collection of finetuned MACE models.
lock.shnow includestorch-sim; the uv lock was refreshed.
Removed
- The old optimizer entry points, replaced by
remote_handler.processingwith
no compatibility shims:workflows/optimizer.py,
workflows/processors.py,workflows/run_optimizer.py, and the deprecated
scripts/jaxnest/optimize_traj.py. Import handlers and processors from
remote_handler.processinginstead.