StreamController

StrictMode-safe lifecycle hook for framework bindings.

React 18+ StrictMode intentionally mounts → unmounts → remounts components in dev to surface effect-cleanup bugs. A naive useEffect(() => () => controller.dispose()) would permanently tear the controller down on that first synthetic unmount, leaving every subsequent submit() a silent no-op.

Call activate from the bind site's effect and return the result as the effect's cleanup. The controller uses deferred disposal: a release() only schedules a dispose on the next microtask, which is cancelled if another activate() arrives before it fires (the normal StrictMode remount path).

Cancel a queued submission by id. Returns true when the entry was found and removed, false otherwise.

Today this only removes the entry from the client-side mirror — once the server exposes queue cancel (roadmap A0.3) the controller will additionally issue a cancel call against the active transport.

Drop every queued submission. Server-side cancel arrives with A0.3.

Tear everything down.

Detaches the bound thread (so no further bind() calls reopen runtimes) and disposes every live runtime in parallel. Safe to call multiple times — subsequent calls find an empty registry and resolve immediately.

Current underlying ThreadStream (v2 escape hatch).

Fetch the checkpointed thread state and seed the root snapshot. Re-calling with a different threadId swaps the underlying ThreadStream, rewires the registry to the new thread, and resets assemblers.

Abort the currently tracked run and mark the controller idle.

Submit input or a resume command to the active thread.

Listen for ThreadStream lifecycle (swap on thread-id change, detach on dispose). The listener fires immediately with the current thread (may be undefined).