displayName
agent-launch-mux
protocolType
spawn
nativeSide
- claude --print --input-format stream-json
- codex --model M --reasoning R
- gh copilot (indirection through gh CLI)
- cursor
- gemini-cli
- opencode, pi, omp, openclaw, hermes, qwen — per-agent CLIs
canonicalSide
Unified InvocationOptions → SpawnArgs → process lifecycle
position
Between Agent-Platform (the productized agent) and the calling SDK / orchestrator
bridgingConcerns
- spawn args per agent (positional prompt vs --prompt, model flag formats, thinking flags)
- env-var conventions per agent (ANTHROPIC_API_KEY vs OPENAI_API_KEY vs GITHUB_TOKEN)
- working-directory mapping (especially --add-dir for skill directories)
- subprocess management (Unix pgroups vs Windows Job Objects)
- signal propagation (especially across ssh / docker / k8s)
- retry policy and lifecycle hooks (onSpawnError, onTimeout, onProcessExit, shouldRetry)
- min-version enforcement (semver gate)
- execution-mode dispatch (local / docker / ssh / k8s / cloud)
catalogInputNodeKinds
- AgentVersion
- LaunchConfig
- LaunchContract
- Execution
trustChainParticipation
planned
description
Spawns and supervises Invocations across all supported agent products.
Owns the 9-state Invocation lifecycle (spawned → running → paused →
interrupted → aborted | timed-out | completed | crashed | killed).
Distinct from the babysitter SDK Process Run — a Run can dispatch one
or more Invocations.