| name | session-spawn |
| description | Spawn sub-agent sessions via the Gateway sessions_spawn method. |
| metadata | {"CARNELIAN":{"emoji":"🔀","requires":{"env":["GATEWAY_URL","GATEWAY_TOKEN"]},"primaryEnv":"GATEWAY_URL"},"carnelian":{"runtime":"node","version":"1.0.0","sandbox":{"network":"localhost","resourceLimits":{"maxMemoryMB":64,"maxCpuPercent":10,"timeoutSecs":15},"env":{"GATEWAY_URL":"${GATEWAY_URL}","GATEWAY_TOKEN":"${GATEWAY_TOKEN}"}},"capabilities":["net.ws"]}} |
session-spawn
Spawn sub-agent sessions via the Gateway sessions_spawn method.
Ported from CARNELIAN session-spawn-tool.ts.
Input
{
task: string;
label?: string;
agentId?: string;
model?: string;
thinking?: boolean;
runTimeoutSeconds?: number;
cleanup?: "keep" | "delete";
}
Output
{
status: "accepted";
childSessionKey: string;
runId: string;
}
Notes
- CARNELIAN dependency: The CARNELIAN gateway must be running
- Default gateway URL:
ws://127.0.0.1:18789
sessions_spawn is forbidden from sub-agent sessions
- Child session key format:
agent:default:subagent:<uuid>
- If
model is provided, the skill calls sessions.patch to set the model before spawning
- No npm packages needed in the wrapper
- Uses WebSocket JSON-RPC for communication