II.
Adapter overview
Reference · liveadapter:agent-launch-adapter
agent-launch-adapter overview
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.
Attributes
displayName
agent-launch-adapter
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)
- OpenClaw 2026.5.27 package launches honor npm dist exclusions, Docker runtime workspace templates, and stricter postpublish checks
- 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.
Outgoing edges
bridges_for39
- agentVersion:claude:ge-0-0-0·AgentVersionClaude Code
- agentVersion:codex:ge-0-119-0·AgentVersionCodex CLI
- agentVersion:cursor:ge-0-0-0·AgentVersionCursor
- agentVersion:gemini:ge-0-43-0·AgentVersionGemini CLI
- agentVersion:opencode:ge-0-0-0·AgentVersionOpenCode
- agentVersion:copilot:ge-1-0-51
- agentVersion:pi:ge-0-75-4
- agentVersion:omp:ge-15-5-6
- agentVersion:openclaw:ge-2026-5-27·AgentVersionOpenClaw
- agent-version:hermes@current·AgentVersionHermes
- agent-version:qwen@current·AgentVersion
- agent-version:droid@current·AgentVersion
- agent-version:amp@current·AgentVersion
- agentVersion:claude:ge-0-0-0·AgentVersionClaude Code
- agentVersion:codex:ge-0-119-0·AgentVersionCodex CLI
- agentVersion:cursor:ge-0-0-0·AgentVersionCursor
- agentVersion:gemini:ge-0-43-0·AgentVersionGemini CLI
- agentVersion:opencode:ge-0-0-0·AgentVersionOpenCode
- agentVersion:copilot:ge-1-0-55-3·AgentVersionGitHub Copilot CLI
- agentVersion:pi:ge-0-75-4
- agentVersion:omp:ge-15-2-4
- agentVersion:openclaw:ge-2026-5-27·AgentVersionOpenClaw
- agent-version:hermes@current·AgentVersionHermes
- agent-version:qwen@current·AgentVersion
- agent-version:droid@current·AgentVersion
- agent-version:amp@current·AgentVersion
- agentVersion:claude:ge-0-0-0·AgentVersionClaude Code
- agentVersion:codex:ge-0-119-0·AgentVersionCodex CLI
- agentVersion:cursor:ge-0-0-0·AgentVersionCursor
- agentVersion:gemini:ge-0-43-0·AgentVersionGemini CLI
- agentVersion:opencode:ge-0-0-0·AgentVersionOpenCode
- agentVersion:copilot:ge-1-0-51
- agentVersion:pi:ge-0-75-5·AgentVersionPi CLI (>=0.77.0)
- agentVersion:omp:ge-15-2-4
- agentVersion:openclaw:ge-2026-5-27·AgentVersionOpenClaw
- agent-version:hermes@current·AgentVersionHermes
- agent-version:qwen@current·AgentVersion
- agent-version:droid@current·AgentVersion
- agent-version:amp@current·AgentVersion
bridges_protocol_type3
- layer:8-execution·LayerExecution
- layer:8-execution·LayerExecution
- layer:8-execution·LayerExecution
Incoming edges
None.