@spec encode_authenticate(map()) :: map()

Encodes an authenticate request.

Authentication is currently in RFD draft stage in the ACP spec. Error code -32000 indicates authentication is required.

Parameters

• params — authentication parameters (provider-specific)

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_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_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 resume an existing session.

@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_set_config_option(String.t(), String.t(), any()) :: map()

Encodes a session/setConfigOption request.

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

Encodes a session/setMode request.

Generates a unique request ID.

Parses a raw JSON-RPC message without validation.