@spec encode_authenticate(String.t() | map()) :: map()

Encodes an authenticate request.

ACP v1 authentication uses a "methodId" selected from the agent's authMethods initialize response. A map may still be passed for adapter compatibility.

Parameters

• method_id_or_params — auth method ID string or full params map

Encodes a JSON-RPC error response.

@spec encode_file_read_response(integer() | String.t(), String.t()) :: map()

Encodes a response to a fs/read_text_file request from the agent.

@spec encode_file_write_response(integer() | String.t()) :: map()

Encodes a response to a fs/write_text_file request from the agent.

@spec encode_initialize(map(), map() | nil, pos_integer()) :: map()

Encodes an initialize request.

Parameters

• client_info — %{"name" => ..., "version" => ...}
• capabilities — client capabilities map (optional)
• protocol_version — integer (default: 1)

@spec encode_logout() :: map()

Encodes a logout request. Stabilized in ACP spec May 21, 2026.

@spec encode_permission_response(integer() | String.t(), map()) :: map()

Encodes a response to a session/request_permission request from the agent.

Encodes a JSON-RPC success response.

@spec encode_session_cancel(String.t()) :: map()

Encodes a session/cancel notification (no id field).

@spec encode_session_close(String.t()) :: map()

Encodes a session/close request. Stabilized in ACP spec April 23, 2026.

@spec encode_session_list(keyword()) :: map()

Encodes a session/list request. Stabilized in ACP spec March 9, 2026.

@spec encode_session_load(String.t(), String.t() | nil, [map()] | nil) :: map()

Encodes a session/load request to load an existing session and replay history.

@spec encode_session_new(String.t() | nil, [map()] | nil) :: map()

Encodes a session/new request.

@spec encode_session_prompt(String.t(), [map()]) :: map()

Encodes a session/prompt request.

@spec encode_session_resume(String.t(), String.t() | nil, [map()] | nil) :: map()

Encodes a session/resume request. Stabilized in ACP spec April 22, 2026.

@spec encode_session_set_config_option(String.t(), String.t(), any()) :: map()

Encodes a session/set_config_option request.

@spec encode_session_set_mode(String.t(), String.t()) :: map()

Encodes a session/set_mode request.

Generates a unique request ID.

Parses a raw JSON-RPC message without validation.