cascade-run

name	cascade-run
description	Communicate with Windsurf Cascade via JSONL channel files (message/delegate/request_help/share_context/status).
metadata	{"CARNELIAN":{"emoji":"🌊"},"carnelian":{"runtime":"node","version":"1.0.0","sandbox":{"network":"none","resourceLimits":{"maxMemoryMB":64,"maxCpuPercent":10,"timeoutSecs":120}},"capabilities":["fs.read","fs.write"]}}

cascade-run

Communicate with Windsurf Cascade via JSONL channel files (message/delegate/request_help/share_context/status).

Ported from CARNELIAN cascade-tool.ts.

Input

{
  action: string;           // Required: action to perform
  text?: string;            // Optional: message text (for message/delegate/request_help/share_context)
  wait?: boolean;           // Optional: wait for response (default true)
}

Supported Actions

Action	Description	Required Fields
message	Send message to Cascade	text
delegate	Delegate task to Cascade	text
request_help	Request help from Cascade	text
share_context	Share context with Cascade	text
status	Get channel status	-

Channel Files

• Outbound: $CARNELIAN_HOME/cascade-channel.jsonl (messages to Cascade)
• Inbound: $CARNELIAN_HOME/cascade-responses.jsonl (responses from Cascade)

Output

With wait=true (default):

{
  ok: true;
  response: string;         // Response from Cascade
}

With wait=false:

{
  ok: true;
  queued: true;
  messageId: string;        // Message ID for tracking
}

Status action:

{
  pendingMessages: number;
  lastMessage?: string;
  lastResponse?: string;
}

Notes

• CARNELIAN dependency: Windsurf Cascade must be running with the MCP bridge configured
• Default channel directory: ~/.CARNELIAN or %USERPROFILE%/.CARNELIAN
• wait=true polls for up to 120 seconds (2s intervals)
• Uses crypto.randomUUID() for message ID generation
• No npm packages needed in the wrapper
• No network access required (sandbox: none)