Skip to main content

Module spawn

Module spawn 

Source
Expand description

Host discovery and process ownership.

Structs§

ExitClassification
Classified exit evidence. A crash may carry a code or a signal.
MuseChild
The SDK-owned host process and its stdio handles.
MuseHostDiscoveryError
No host was supplied explicitly and no executable muse was on PATH.
SpawnOptions
Inputs for an SDK-owned muse serve process.

Enums§

CloseAttribution
How the spawned-host close path credits available exit evidence.
ExitKind
Semantic host-exit class shared with the Python and TypeScript SDKs.
RetryGuidance
Whether retrying a documented host refusal can help.
SpawnError
A discovery failure or an OS refusal to launch the discovered binary.

Constants§

COMPATIBILITY_PAGE_URL
The compatibility matrix cited by discovery errors.
DEFAULT_SHUTDOWN_TIMEOUT
Default SpawnOptions::shutdown_timeout: how long MuseChild::close (and so MuseClient::close) lets the host drain after stdin EOF before it escalates (SIGTERM on Unix; the platform kill elsewhere). It is the host’s own stdio drain timeout, so a healthy host finishes its orderly wind-down (turn cancel, durable session end) inside it.
HOST_BINARY_NAME
The executable searched for when callers do not pass muse_bin.
SIGTERM_GRACE
Fixed grace between SIGTERM and SIGKILL inside MuseChild::close. Not a knob: by then the host has had its whole drain window, so this only covers a signal handler’s final flush. Off Unix, where the first escalation is already the platform kill, it only spaces the repeated kill request; the reap stays unbounded.
STDERR_DRAIN_TIMEOUT
Bound on waiting for the host’s stderr tail once its exit was observed.
STDERR_TAIL_LIMIT
Maximum retained host stderr evidence for exit classification.

Functions§

classify_exit
Classify raw process evidence using the host’s documented exit table.
discover_muse_bin
Resolve muse_bin, then PATH; return an explicit path verbatim.
spawn_muse
Spawn an SDK-owned host driven by the caller’s runtime.