ACP Agents¶

Stdio Agent Commands¶

The generic ACP adapter launches an Agent Client Protocol process and speaks newline-delimited JSON-RPC over stdio:

> agent:
    acp: npx @zed-industries/codex-acp

Command strings are shell-split without invoking a shell. Python may pass a sequence to avoid quoting ambiguity.

Explicit Commands¶

ACP does not have an implicit command source. Every runnable ACP configuration must bind the command in multiline > agent: syntax or construct ACPAdapter(command=...) in Python. Plain > agent: acp, CLI command options, and environment command fallbacks are intentionally unsupported.

Working Directory and Environment¶

> settings:
    cwd: /workspace/project
    env: `{"MODE": "review"}`
    timeout: 300

Clients are reused by (command, cwd, env) and each prompt opens a fresh ACP session. Stdio process cwd and session/new.cwd receive the configured cwd.

Timeouts¶

timeout is the prompt request timeout and must be a positive number. request_timeout on ACPAdapter governs protocol requests by default. Disconnect errors include the last 40 stderr lines for diagnosis.

Model Selection¶

Generic ACP model selection is not currently mapped. > model: and > effort: are unsupported capability overrides. Configure the child ACP agent's own default model through its command/environment.

Prompt and Structured Results¶

ACP supports raw text only:

> agent:
    acp: npx @zed-industries/codex-acp
>> Inspect the repository and return [answer: str] summarizing the risk.
= `answer`

Kedi concatenates agent_message_chunk text updates. Structured >> output raises NotImplementedError; no prompting shim fabricates a schema.

ACP Capability Mapping¶

Kedi sends protocol initialization, session/new with cwd and an empty mcpServers list, session/prompt, streamed updates, then session/close. Each call is independent.

Current Limits¶

no structured output;
no Kedi tool registration;
no Kedi MCP projection;
no model or effort override;
no Kedi subagents;
only text agent_message_chunk updates are collected.