Class SpawnClient

The active provider — exposed so the CLI/terminal can build a ShellCtx.

Ids of fan-outs (sweeps + queues) still running.

Extend an instance's TTL deadline by a duration. Returns the new deadline (ms).

Orphans among the currently-known instances: managed + live + past their TTL deadline by the grace window (spored should have reaped them but didn't — the #19 failure mode). Call refresh() first for fresh data. Pure detection; reaping is a separate, confirmed action (reapOrphans).

Terminate the given orphans (or all currently-detected ones). Returns the instance ids terminated. The caller is responsible for confirming first — this always terminates. Emits an "info" event per reap and refreshes.

Swap the compute backend at runtime (e.g. mock → real AWS from a creds form).

Set sim speed (mock only). 1 = realtime, 60 = 1 min/sec.

Fire a completion signal (drops the watched file) to demo on-complete.

Start a job array: N identical launches from one base input, each stamped with its index via the spawn:job-array-* tags, fanned out under the monitor loop (concurrency cap / launch delay). Returns the built JobArray; progress arrives via "jobarray" events. Same cost-safety guard as launch().

Begin the monitor loop (ticks every intervalMs of wall time).

Start a batch job queue: validate + order the config into a DAG of members and register a fan-out that the monitor loop pumps each tick, launching each job's instance as its dependencies complete and capacity allows. Returns the built Queue; progress arrives via "queue" events. Same cost-safety guard as launch() applies to a real backend.

Start a parameter sweep: expand the spec into members and register a fan-out that the monitor loop pumps each tick (launching members as the concurrency cap allows). Returns the built Sweep for identity/inspection. Progress is delivered via "sweep" events; call startMonitor() (or step() in tests) to drive it. A real launch inherits the same cost-safety guard as launch().

Advance the sim clock by a duration and run one tick (mock only, for tests/step).

Snapshot of a registered fan-out's per-member status, or null if unknown.