zidane/acp

Converts MCP server entries from an ACP session request to Zidane McpServerConfig values. http becomes streamable-http, sse stays sse, and anything else is treated as a stdio command.

Converts the ACP prompt content blocks of a session/prompt request to Zidane prompt parts. Images and audio without embedded data, and unknown block types, become text parts and add a warning.

Creates an ACP agent server. The server speaks ACP v1: initialize, authenticate, logout, session/new, session/load, session/resume, session/list, session/delete, session/close, session/prompt, session/set_mode, session/set_config_option, and the session/cancel notification. It does no I/O itself, so connect it to a transport with createJsonRpcConnection or use runAcpStdioServer. Throws when neither provider nor models is set, or when defaultModelId is not in models.

Builds agent tools for client-declared specs. Each tool sends a CLIENT_TOOL_CALL_METHOD request to the client and returns the reply text. If the call is aborted, it sends CLIENT_TOOL_CANCEL_METHOD and rejects. A reply with isError: true throws.

Creates a JSON-RPC 2.0 connection over a pair of byte streams. Frames are newline-delimited JSON by default. Replies to incoming requests come from onRequest; the returned peer sends requests and notifications. Reading starts when start is called.

Validate _meta.zidane.clientTools. Returns undefined when the key is absent (so resume can keep the existing set) and throws on malformed specs.

Runs an ACP agent over stdio, usually as the entry point of an editor-facing agent process. Creates the server with createAcpServer, connects it to a JSON-RPC connection on input and output, and starts reading. Throws if neither provider nor models is set.

Converts stored session content blocks to ACP content blocks, for replaying history. Thinking blocks become text. Images and documents without data become resource_link blocks. Audio without data and system notes are dropped.

Maps the outcome of an agent run to an ACP stop reason. An abort gives cancelled, reaching the turn limit gives max_turn_requests. Otherwise the last turn finish reason decides: length gives max_tokens, content-filter and error give refusal, and anything else gives end_turn.

Converts a tool result to ACP tool call content. A string becomes one text content item. Block arrays map block by block, and unsupported blocks fall back to their text form.

Return preset with the default ACP search/fetch tools filled in. The preset's own tools win on name collision, so this only adds what's missing. Applied to the default base and by the zidane-acp CLI — never to a host-provided AcpServerOptions.preset, which is honored verbatim.

Replaces the read_file, write_file and shell tools with versions that run on the ACP client. Uses the client file system and terminal so the user sees editor state and terminal output. Tools the client cannot back, or that are missing from tools, are left as they are.

Error with a JSON-RPC error code. Throwing it from a handler produces an error response with that code and data.

Error thrown when the other side answers a request with a JSON-RPC error response. Carries the remote code and data next to the remote message.

ACP major protocol version this server speaks. initialize answers with this value.

JSON-RPC method the agent sends to the client to run a client-declared tool.

Notification the agent sends when it abandons a pending CLIENT_TOOL_CALL_METHOD.

Capabilities an ACP client declares in initialize. They decide which requests the agent may send back.

Options for wrapToolsForAcpClient.

A tool the ACP client declares in session/new / session/load / session/resume under _meta.zidane.clientTools. The agent sees it like any other tool; execution round-trips to the client over CLIENT_TOOL_CALL_METHOD.

ACP Implementation metadata. The spec requires name + version; title is an optional UI label. Incoming clientInfo is treated loosely (see InitializeRequest) since we never reflect it back on the wire.

A user-selectable model exposed to ACP clients as a category: 'model' session config option. Each choice carries its OWN provider so switching a model can switch provider + credentials. provider may be a factory so the credentials for a model are only resolved when that model is first selected.

A model-specific boolean option, exposed to the client as a select control.

The remote side of an ACP connection, used to send requests and notifications to it.

Controls when the agent asks the client for permission before running a tool.

Result of converting an ACP prompt to Zidane prompt parts, see acpPromptToPromptParts.

The ACP agent side. Handles requests and notifications from an ACP client and sends updates back through a peer.

Options for createAcpServer. Set provider or models.

In-memory state of one open ACP session.

Authentication features the agent supports.

Capabilities the agent advertises in the initialize response.

An audio content block.

Params of the authenticate request.

An authentication method the agent offers.

A slash command the agent offers in a session.

Input description for an AvailableCommand.

Embedded resource content in binary form.

Params of the session/cancel notification. Aborts the running prompt of a session.

Reply the client returns for a CLIENT_TOOL_CALL_METHOD request.

Params of the session/close request.

Hints about how a content block should be used or shown.

A piece of streamed message content, carried by session/update notifications.

Monetary cost of a session so far.

Params of the terminal/create request. The agent sends it to start a command in a client terminal.

Params of the session/delete request.

A content block that carries a resource inline.

An environment variable passed to a stdio MCP server.

An HTTP header sent to an HTTP or SSE MCP server.

An image content block.

Params of the initialize request, the first call of a connection.

Result of the initialize request.

A JSON-RPC peer bound to a pair of byte streams. Call start to begin reading.

Options for createJsonRpcConnection.

Error object of a JsonRpcFailure.

A JSON-RPC 2.0 response to a request that failed.

A JSON-RPC 2.0 notification. It has no id and gets no response.

A JSON-RPC 2.0 request. The receiver answers it with a response carrying the same id.

A JSON-RPC 2.0 response to a request that succeeded.

Params of the session/list request.

Result of the session/list request.

Params of the session/load request. Replays the stored history as session/update notifications.

session/load and session/resume responses do NOT echo sessionId and carry no inline message history. Conversation history is replayed via session/update notifications before the response is returned.

MCP server transports the agent supports. stdio is always supported.

Params of the session/new request.

Result of the session/new request.

A choice offered to the user in a permission request.

One entry of an execution plan.

Content types the agent accepts in a prompt. Text and resource links are always accepted.

Params of the session/prompt request. Starts one turn of the agent.

Result of session/prompt, sent when the turn ends.

Params of the fs/read_text_file request. The agent sends it to read a file through the client.

Params of the session/request_permission request. The agent sends it to ask the user before a tool call runs.

A reference to a resource the agent can fetch. The content is not embedded.

Params of the session/resume request. Restores a stored session without replaying its history.

Options for runAcpStdioServer: the AcpServerOptions plus the stdio transport settings.

Optional session methods the agent supports. A key being present means the method is available.

A session configuration option. ACP v1 currently defines a single select (dropdown) variant; id + name + type are required.

A named group of select options.

One choice of a select config option.

Summary of a stored or open session, returned by session/list.

A mode the session can run in, such as build or plan.

The modes a session offers and the active one.

Params of the session/update notification, the agent stream to the client.

Params of the session/set_config_option request.

Result of session/set_config_option.

Params of the session/set_mode request.

How a terminal command ended.

Result of the terminal/output request.

A text content block.

Embedded resource content in text form.

A file location a tool call touches.

A tool call report or an update to one, carried by tool_call and tool_call_update session updates.

Params of the fs/write_text_file request. The agent sends it to write a file through the client.

Converts tool result content to ACP tool call content.

An MCP server the client asks the agent to connect to. stdio servers are launched as a command. http and sse servers are reached by URL.

Converts stored session content blocks to ACP content blocks.

A block of content in a prompt or a message.

Contents of an embedded resource, as text or binary.

Identifier of a JSON-RPC request.

Any JSON-RPC message: a request, a notification or a response.

A JSON-RPC response, either a success or a failure.

How the user answered a permission request: cancelled, or selected with the chosen optionId.

Result of session/resume. Same shape as LoadSessionResponse.

Author of a message.

Semantic category of a config option. Clients use it to place the control. Custom strings are allowed.

Choices of a select option: a flat list or a list of groups.

Payload of a session/update notification, discriminated by sessionUpdate. Covers message and thought chunks, tool calls, plans, command lists, mode and config changes, session info and usage.

Why a prompt turn ended: end_turn, max_tokens, max_turn_requests, refusal or cancelled.

Content produced by a tool call: plain content, a file diff, or a terminal reference.

Execution status of a tool call.

Category of a tool, used by clients for icons and grouping.

JSON-RPC and ACP error codes used in error responses.