Skip to main content

Module spawn

Module spawn 

Source
Expand description

Sub-session spawn scheduler.

Provides a background queue for spawning child sessions. Spawn is async (tool returns immediately), but the UI can observe child progress via events forwarded to the parent session stream.

Structs§

ChildLaunchGuard
NativeTaskLiveness
A heartbeat is a successful renewal attempted after this exact Task entered. It measures owner liveness independently of the Task’s progress.
NativeTaskStart
A live native owner’s once-only Agent execution entry, never persisted or reconstructed from Actor/Session timestamps. It proves no heartbeat or progress. Engine owns this physical fact; Orchestration decides its meaning. Server adapters only join it to current Ticket/Host authority. Stop, shutdown and restart provide no live sample and cannot recover execution permission.
QueueCapacityReservation
One in-memory queue slot, not an execution grant. Dropping it releases capacity without publishing a job or Start. The original cancellation gate stays bound to the reservation and cannot be replaced before commit.
SessionInboxRuntimeBinding
Runtime-scoped durable inbox resources used by external actor drivers.
SpawnContext
SpawnJob
SpawnScheduler

Traits§

ChildRunLaunchHook
Optional application-layer preparation for a child run launched through the canonical scheduler.
ExternalChildRunner
External child session runtimes emit events and respect the cancel token.

Type Aliases§

QueueAdmissionCheck
A process-local Host admission check, evaluated at the synchronous queue commit after capacity waits. It must not block or perform I/O and cannot reconstruct authority from a persisted job.