From 52866d9798bba882a595745cdfed7ddd1c72c941 Mon Sep 17 00:00:00 2001 From: Ben Brandt Date: Mon, 29 Jun 2026 14:54:27 +0200 Subject: [PATCH 1/3] fix(untable-v2): make v2 auth capabilities optional --- agent-client-protocol-schema/src/v1/client.rs | 4 ++-- agent-client-protocol-schema/src/v2/client.rs | 12 ++++++------ agent-client-protocol-schema/src/v2/conversion.rs | 4 ++-- docs/protocol/v2/draft/schema.mdx | 6 ++---- schema-generator/src/main.rs | 6 +++++- schema/v2/schema.unstable.json | 14 +++++++------- 6 files changed, 24 insertions(+), 22 deletions(-) diff --git a/agent-client-protocol-schema/src/v1/client.rs b/agent-client-protocol-schema/src/v1/client.rs index 2c41319e5..57909c683 100644 --- a/agent-client-protocol-schema/src/v1/client.rs +++ b/agent-client-protocol-schema/src/v1/client.rs @@ -2513,11 +2513,11 @@ pub enum ClientResponse { /// Successful result returned for a `mcp/disconnect` request. #[cfg(feature = "unstable_mcp_over_acp")] DisconnectMcpResponse(#[serde(default)] DisconnectMcpResponse), - /// Successful result returned by an extension method outside the core ACP method set. - ExtMethodResponse(ExtResponse), /// Successful result returned by an MCP-over-ACP `mcp/message` request. #[cfg(feature = "unstable_mcp_over_acp")] MessageMcpResponse(MessageMcpResponse), + /// Successful result returned by an extension method outside the core ACP method set. + ExtMethodResponse(ExtResponse), } /// All possible notifications that an agent can send to a client. diff --git a/agent-client-protocol-schema/src/v2/client.rs b/agent-client-protocol-schema/src/v2/client.rs index 4d2a1e60b..b01aa602e 100644 --- a/agent-client-protocol-schema/src/v2/client.rs +++ b/agent-client-protocol-schema/src/v2/client.rs @@ -1547,7 +1547,7 @@ pub struct ClientCapabilities { #[serde_as(deserialize_as = "DefaultOnError")] #[schemars(extend("x-deserialize-default-on-error" = true))] #[serde(default)] - pub auth: AuthCapabilities, + pub auth: Option, /// **UNSTABLE** /// /// This capability is not part of the spec yet, and may be removed or changed at any point. @@ -1608,8 +1608,8 @@ impl ClientCapabilities { /// in its `InitializeResponse`. #[cfg(feature = "unstable_auth_methods")] #[must_use] - pub fn auth(mut self, auth: AuthCapabilities) -> Self { - self.auth = auth; + pub fn auth(mut self, auth: impl IntoOption) -> Self { + self.auth = auth.into_option(); self } @@ -1926,11 +1926,11 @@ pub enum ClientResponse { /// Successful result returned for a `mcp/disconnect` request. #[cfg(feature = "unstable_mcp_over_acp")] DisconnectMcpResponse(#[serde(default)] DisconnectMcpResponse), - /// Successful result returned by an extension method outside the core ACP method set. - ExtMethodResponse(ExtResponse), /// Successful result returned by an MCP-over-ACP `mcp/message` request. #[cfg(feature = "unstable_mcp_over_acp")] MessageMcpResponse(MessageMcpResponse), + /// Successful result returned by an extension method outside the core ACP method set. + ExtMethodResponse(ExtResponse), } /// All possible notifications that an agent can send to a client. @@ -2010,7 +2010,7 @@ mod tests { })) .unwrap(); - assert_eq!(capabilities.auth, AuthCapabilities::default()); + assert_eq!(capabilities.auth, None); } #[test] diff --git a/agent-client-protocol-schema/src/v2/conversion.rs b/agent-client-protocol-schema/src/v2/conversion.rs index 7c8d89544..7a9fd23e0 100644 --- a/agent-client-protocol-schema/src/v2/conversion.rs +++ b/agent-client-protocol-schema/src/v2/conversion.rs @@ -1907,7 +1907,7 @@ impl IntoV1 for super::ClientCapabilities { #[cfg(feature = "unstable_plan_operations")] plan: None, #[cfg(feature = "unstable_auth_methods")] - auth: auth.into_v1()?, + auth: auth.map(IntoV1::into_v1).transpose()?.unwrap_or_default(), #[cfg(feature = "unstable_elicitation")] elicitation: into_v1_default_on_error(elicitation), #[cfg(feature = "unstable_nes")] @@ -1942,7 +1942,7 @@ impl IntoV2 for crate::v1::ClientCapabilities { } = self; Ok(super::ClientCapabilities { #[cfg(feature = "unstable_auth_methods")] - auth: auth.into_v2()?, + auth: Some(auth.into_v2()?), #[cfg(feature = "unstable_elicitation")] elicitation: into_v2_default_on_error(elicitation), #[cfg(feature = "unstable_nes")] diff --git a/docs/protocol/v2/draft/schema.mdx b/docs/protocol/v2/draft/schema.mdx index 21348c775..fb97ac14f 100644 --- a/docs/protocol/v2/draft/schema.mdx +++ b/docs/protocol/v2/draft/schema.mdx @@ -324,7 +324,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/d ClientCapabilities} > Capabilities supported by the client. - - Default: `{"auth":{}}` + - Default: `{}` Implementation} required> @@ -2807,7 +2807,7 @@ these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/draft/extensibility) -AuthCapabilities} > +AuthCapabilities | null} > **UNSTABLE** This capability is not part of the spec yet, and may be removed or changed at any point. @@ -2816,8 +2816,6 @@ Authentication capabilities supported by the client. Determines which authentication method types the agent may include in its `InitializeResponse`. - - Default: `{}` - ElicitationCapabilities | null} > **UNSTABLE** diff --git a/schema-generator/src/main.rs b/schema-generator/src/main.rs index d0e24f95c..83fa61d55 100644 --- a/schema-generator/src/main.rs +++ b/schema-generator/src/main.rs @@ -1915,7 +1915,11 @@ starting with '$/' it is free to ignore the notification." } "fs/write_text_file" => self.client.get("WriteTextFileRequest").unwrap(), "fs/read_text_file" => self.client.get("ReadTextFileRequest").unwrap(), - "session/update" => self.client.get("SessionNotification").unwrap(), + "session/update" => self + .client + .get("SessionUpdateNotification") + .or_else(|| self.client.get("SessionNotification")) + .unwrap(), "terminal/create" => self.client.get("CreateTerminalRequest").unwrap(), "terminal/output" => self.client.get("TerminalOutputRequest").unwrap(), "terminal/release" => self.client.get("ReleaseTerminalRequest").unwrap(), diff --git a/schema/v2/schema.unstable.json b/schema/v2/schema.unstable.json index 0a8273014..f3ddedadb 100644 --- a/schema/v2/schema.unstable.json +++ b/schema/v2/schema.unstable.json @@ -6813,9 +6813,7 @@ "capabilities": { "description": "Capabilities supported by the client.", "x-deserialize-default-on-error": true, - "default": { - "auth": {} - }, + "default": {}, "allOf": [ { "$ref": "#/$defs/ClientCapabilities" @@ -6839,13 +6837,15 @@ "properties": { "auth": { "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nAuthentication capabilities supported by the client.\nDetermines which authentication method types the agent may include\nin its `InitializeResponse`.", - "x-deserialize-default-on-error": true, - "default": {}, - "allOf": [ + "anyOf": [ { "$ref": "#/$defs/AuthCapabilities" + }, + { + "type": "null" } - ] + ], + "x-deserialize-default-on-error": true }, "elicitation": { "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nElicitation capabilities supported by the client.\nDetermines which elicitation modes the agent may use.", From 504013074731e4c2a2bc98b5b6fd0c80e31f0956 Mon Sep 17 00:00:00 2001 From: Ben Brandt Date: Mon, 29 Jun 2026 14:55:35 +0200 Subject: [PATCH 2/3] refactor(schema): Rename v2 session update types --- agent-client-protocol-schema/src/v2/client.rs | 13 +- .../src/v2/conversion.rs | 24 +- docs/protocol/v1/draft/schema.mdx | 775 ++---- docs/protocol/v1/schema.mdx | 378 +-- docs/protocol/v2/draft/schema.mdx | 2 +- docs/protocol/v2/schema.mdx | 2 +- schema/v1/meta.json | 2 +- schema/v1/meta.unstable.json | 2 +- schema/v1/schema.json | 1152 ++++++-- schema/v1/schema.unstable.json | 2353 +++++++++++++---- schema/v2/meta.json | 2 +- schema/v2/schema.json | 1279 +++++++-- schema/v2/schema.unstable.json | 44 +- 13 files changed, 4132 insertions(+), 1896 deletions(-) diff --git a/agent-client-protocol-schema/src/v2/client.rs b/agent-client-protocol-schema/src/v2/client.rs index b01aa602e..c1cdf83c2 100644 --- a/agent-client-protocol-schema/src/v2/client.rs +++ b/agent-client-protocol-schema/src/v2/client.rs @@ -48,7 +48,7 @@ use super::{ClientNesCapabilities, PositionEncodingKind}; #[schemars(extend("x-side" = "client", "x-method" = SESSION_UPDATE_NOTIFICATION))] #[serde(rename_all = "camelCase")] #[non_exhaustive] -pub struct SessionNotification { +pub struct UpdateSessionNotification { /// The ID of the session this update pertains to. pub session_id: SessionId, /// The actual update content. @@ -65,7 +65,7 @@ pub struct SessionNotification { pub meta: Option, } -impl SessionNotification { +impl UpdateSessionNotification { /// Builds [`SessionNotification`] with the required notification fields set; optional fields start unset or empty. #[must_use] pub fn new(session_id: impl Into, update: SessionUpdate) -> Self { @@ -743,13 +743,13 @@ impl Cost { #[serde(rename_all = "camelCase")] #[non_exhaustive] pub struct ContentChunk { - /// A single item of content - pub content: ContentBlock, /// A unique identifier for the message this chunk belongs to. /// /// All chunks belonging to the same message share the same `messageId`. /// A change in `messageId` indicates a new message has started. pub message_id: MessageId, + /// A single item of content + pub content: ContentBlock, /// The _meta property is reserved by ACP to allow clients and agents to attach additional /// metadata to their interactions. Implementations MUST NOT make assumptions about values at /// these keys. @@ -1424,7 +1424,6 @@ pub enum PermissionOptionKind { #[non_exhaustive] pub struct RequestPermissionResponse { /// The user's decision on the permission request. - // This extra-level is unfortunately needed because the output must be an object pub outcome: RequestPermissionOutcome, /// The _meta property is reserved by ACP to allow clients and agents to attach additional /// metadata to their interactions. Implementations MUST NOT make assumptions about values at @@ -1956,7 +1955,7 @@ pub enum AgentNotification { /// stop reason. /// /// See protocol docs: [Agent Reports Output](https://agentclientprotocol.com/protocol/prompt-lifecycle#3-agent-reports-output) - SessionNotification(Box), + UpdateSessionNotification(Box), /// **UNSTABLE** /// /// This capability is not part of the spec yet, and may be removed or changed at any point. @@ -1986,7 +1985,7 @@ impl AgentNotification { #[must_use] pub fn method(&self) -> &str { match self { - Self::SessionNotification(_) => CLIENT_METHOD_NAMES.session_update, + Self::UpdateSessionNotification(_) => CLIENT_METHOD_NAMES.session_update, #[cfg(feature = "unstable_elicitation")] Self::CompleteElicitationNotification(_) => CLIENT_METHOD_NAMES.elicitation_complete, #[cfg(feature = "unstable_mcp_over_acp")] diff --git a/agent-client-protocol-schema/src/v2/conversion.rs b/agent-client-protocol-schema/src/v2/conversion.rs index 7a9fd23e0..36bb4ef6e 100644 --- a/agent-client-protocol-schema/src/v2/conversion.rs +++ b/agent-client-protocol-schema/src/v2/conversion.rs @@ -949,7 +949,7 @@ impl IntoV2 for crate::v1::ProtocolLevelNotification { } } -impl IntoV1Many for super::SessionNotification { +impl IntoV1Many for super::UpdateSessionNotification { type Output = crate::v1::SessionNotification; fn into_v1_many(self) -> Result> { @@ -975,7 +975,7 @@ impl IntoV1Many for super::SessionNotification { } impl IntoV2 for crate::v1::SessionNotification { - type Output = super::SessionNotification; + type Output = super::UpdateSessionNotification; fn into_v2(self) -> Result { let Self { @@ -983,7 +983,7 @@ impl IntoV2 for crate::v1::SessionNotification { update, meta, } = self; - Ok(super::SessionNotification { + Ok(super::UpdateSessionNotification { session_id: session_id.into_v2()?, update: update.into_v2()?, meta: meta.into_v2()?, @@ -2169,7 +2169,7 @@ impl IntoV1Many for super::AgentNotification { fn into_v1_many(self) -> Result> { Ok(match self { - Self::SessionNotification(value) => { + Self::UpdateSessionNotification(value) => { return value .into_v1_many()? .into_iter() @@ -2203,7 +2203,7 @@ impl IntoV2 for crate::v1::AgentNotification { fn into_v2(self) -> Result { Ok(match self { Self::SessionNotification(value) => { - super::AgentNotification::SessionNotification(Box::new(value.into_v2()?)) + super::AgentNotification::UpdateSessionNotification(Box::new(value.into_v2()?)) } #[cfg(feature = "unstable_elicitation")] Self::CompleteElicitationNotification(value) => { @@ -9641,7 +9641,7 @@ mod tests { for update in cases { let notification = v1::SessionNotification::new("sess", update); let original_json = serde_json::to_value(¬ification).expect("v1 serialize"); - let as_v2: v2::SessionNotification = + let as_v2: v2::UpdateSessionNotification = v1_to_v2(notification.clone()).expect("v1 -> v2 conversion"); let v2_json = serde_json::to_value(&as_v2).expect("v2 serialize"); assert_eq!( @@ -9665,7 +9665,8 @@ mod tests { "sess", v1::SessionUpdate::ToolCall(v1::ToolCall::new("tc", "title")), ); - let create_v2: v2::SessionNotification = v1_to_v2(create).expect("v1 -> v2 conversion"); + let create_v2: v2::UpdateSessionNotification = + v1_to_v2(create).expect("v1 -> v2 conversion"); assert!(matches!( create_v2.update, v2::SessionUpdate::ToolCallUpdate(_) @@ -9689,7 +9690,8 @@ mod tests { v1::ToolCallUpdateFields::new().status(v1::ToolCallStatus::Completed), )), ); - let update_v2: v2::SessionNotification = v1_to_v2(update).expect("v1 -> v2 conversion"); + let update_v2: v2::UpdateSessionNotification = + v1_to_v2(update).expect("v1 -> v2 conversion"); assert!(matches!( update_v2.update, v2::SessionUpdate::ToolCallUpdate(_) @@ -9765,7 +9767,7 @@ mod tests { #[test] fn v2_full_message_session_notification_fans_out_to_v1_chunk_notifications() { - let notification = v2::SessionNotification::new( + let notification = v2::UpdateSessionNotification::new( "sess", v2::SessionUpdate::AgentMessage(v2::AgentMessage::new("msg_agent").content(vec![ v2::ContentBlock::Text(v2::TextContent::new("hello")), @@ -9803,8 +9805,8 @@ mod tests { fn v2_json_rpc_agent_notification_fans_out_to_v1_chunk_notifications() { let message = v2::JsonRpcMessage::wrap(v2::Notification { method: "session/update".into(), - params: Some(v2::AgentNotification::SessionNotification(Box::new( - v2::SessionNotification::new( + params: Some(v2::AgentNotification::UpdateSessionNotification(Box::new( + v2::UpdateSessionNotification::new( "sess", v2::SessionUpdate::AgentMessage(v2::AgentMessage::new("msg_agent").content( vec![ diff --git a/docs/protocol/v1/draft/schema.mdx b/docs/protocol/v1/draft/schema.mdx index 93027d567..cf5fa8de5 100644 --- a/docs/protocol/v1/draft/schema.mdx +++ b/docs/protocol/v1/draft/schema.mdx @@ -3,10 +3,7 @@ title: "Schema" description: "Schema definitions for the Agent Client Protocol" --- - - The schema file can be downloaded directly from the [latest GitHub - release](https://github.com/agentclientprotocol/agent-client-protocol/releases/latest/download/schema.unstable.json). - +The schema file can be downloaded directly from the [latest GitHub release](https://github.com/agentclientprotocol/agent-client-protocol/releases/latest/download/schema.unstable.json). ## Agent @@ -43,7 +40,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - AuthMethodId} required> The ID of the authentication method to use. @@ -64,7 +60,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - @@ -88,7 +83,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - TextDocumentContentChangeEvent[]} required> The content changes. @@ -124,7 +118,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - SessionId} required> The session ID for this notification. @@ -154,7 +147,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Position} required> The current cursor position. @@ -193,7 +185,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - The language identifier of the document (e.g., "rust", "python"). @@ -232,7 +223,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - SessionId} required> The session ID for this notification. @@ -246,7 +236,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Establishes the connection with a client and negotiates protocol capabilities. This method is called once at the beginning of the connection to: - - Negotiate the protocol version to use - Exchange capability information between client and agent - Determine available authentication methods @@ -273,19 +262,16 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ClientCapabilities} > Capabilities supported by the client. - Default: `{"fs":{"readTextFile":false,"writeTextFile":false},"terminal":false,"auth":{"terminal":false}}` - Implementation | null} > Information about the Client name and version sent to the Agent. Note: in future versions of the protocol, this will be required. - ProtocolVersion} required> The latest protocol version supported by the client. @@ -309,32 +295,27 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - AgentCapabilities} > Capabilities supported by the agent. - Default: `{"loadSession":false,"promptCapabilities":{"image":false,"audio":false,"embeddedContext":false},"mcpCapabilities":{"http":false,"sse":false,"acp":false},"sessionCapabilities":{},"auth":{}}` - Implementation | null} > Information about the Agent name and version sent to the Client. Note: in future versions of the protocol, this will be required. - AuthMethod[]} > Authentication methods supported by the agent. - Default: `[]` - ProtocolVersion} required> The protocol version the client specified if supported by the agent, or the latest protocol version supported by the agent. The client should disconnect, if it doesn't support this version. - ### logout @@ -360,7 +341,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - #### LogoutResponse @@ -377,7 +357,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - @@ -410,7 +389,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - McpConnectionId} required> The MCP-over-ACP connection this message is sent on. @@ -422,7 +400,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Optional inner MCP params. If omitted or set to `null`, the inner MCP message has no params. - #### MessageMcpRequest @@ -443,7 +420,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - McpConnectionId} required> The MCP-over-ACP connection this message is sent on. @@ -455,7 +431,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Optional inner MCP params. If omitted or set to `null`, the inner MCP message has no params. - #### MessageMcpResponse @@ -468,6 +443,7 @@ Response to `mcp/message`. This is the inner MCP response result payload. Any JSON value is valid. + ### nes/accept @@ -489,7 +465,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - The ID of the accepted suggestion. @@ -527,7 +502,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - SessionId} required> The ID of the NES session to close. @@ -547,7 +521,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - @@ -571,7 +544,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - The ID of the rejected suggestion. @@ -606,7 +578,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - NesRepository | null} > Repository metadata, if the workspace is a git repository. @@ -632,7 +603,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - SessionId} required> The session ID for the newly started NES session. @@ -661,7 +631,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - NesSuggestContext | null} > Context for the suggestion, included based on agent capabilities. @@ -699,7 +668,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - NesSuggestion[]} required> The list of suggestions. @@ -732,7 +700,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Provider id to disable. @@ -756,7 +723,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - @@ -786,7 +752,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - #### ListProvidersResponse @@ -807,7 +772,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ProviderInfo[]} required> Configurable providers with current routing info suitable for UI display. @@ -842,7 +806,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - LlmProtocol} required> Protocol type for this provider. @@ -876,7 +839,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - @@ -887,7 +849,6 @@ Cancels ongoing operations for a session. This is a notification sent by the client to cancel an ongoing prompt turn. Upon receiving this notification, the Agent SHOULD: - - Stop all language model requests as soon as possible - Abort all tool call invocations in progress - Send any pending `session/update` notifications @@ -911,7 +872,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - SessionId} required> The ID of the session to cancel operations for. @@ -947,7 +907,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - SessionId} required> The ID of the session to close. @@ -967,7 +926,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - @@ -993,7 +951,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - SessionId} required> The ID of the session to delete. @@ -1013,7 +970,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - @@ -1054,7 +1010,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - "string"[]} > Additional workspace roots to activate for this session. Each path must be absolute. @@ -1062,7 +1017,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d When omitted or empty, no additional roots are activated. When non-empty, this is the complete resulting additional-root list for the forked session. - The working directory for this session. @@ -1092,7 +1046,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - SessionConfigOption[] | null} > Initial session configuration options if supported by the Agent. @@ -1101,7 +1054,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Initial mode state if supported by the Agent See protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/v1/draft/session-modes) - SessionId} required> Unique identifier for the newly created forked session. @@ -1132,7 +1084,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Opaque cursor token from a previous response's nextCursor field for cursor-based pagination @@ -1155,7 +1106,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Opaque cursor token. If present, pass this in the next request's cursor parameter @@ -1173,7 +1123,6 @@ Loads an existing session to resume a previous conversation. This method is only available if the agent advertises the `loadSession` capability. The agent should: - - Restore the session context and conversation history - Connect to the specified MCP servers - Stream the entire conversation history back to the client via notifications @@ -1198,7 +1147,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - "string"[]} > Additional workspace roots to activate for this session. Each path must be absolute. @@ -1207,7 +1155,6 @@ When omitted or empty, no additional roots are activated. When non-empty, this is the complete resulting additional-root list for the loaded session. It may differ from any previously used or reported list as long as the request `cwd` matches the session's `cwd`. - The working directory for this session. @@ -1233,7 +1180,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - SessionConfigOption[] | null} > Initial session configuration options if supported by the Agent. @@ -1242,7 +1188,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Initial mode state if supported by the Agent See protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/v1/draft/session-modes) - @@ -1253,7 +1198,6 @@ Creates a new conversation session with the agent. Sessions represent independent conversation contexts with their own history and state. The agent should: - - Create a new session context - Connect to any specified MCP servers - Return a unique session ID for future requests @@ -1278,7 +1222,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - "string"[]} > Additional workspace roots for this session. Each path must be absolute. @@ -1286,7 +1229,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d These expand the session's filesystem scope without changing `cwd`, which remains the base for relative paths. When omitted or empty, no additional roots are activated for the new session. - The working directory for this session. Must be an absolute path. @@ -1311,7 +1253,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - SessionConfigOption[] | null} > Initial session configuration options if supported by the Agent. @@ -1320,13 +1261,11 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Initial mode state if supported by the Agent See protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/v1/draft/session-modes) - SessionId} required> Unique identifier for the created session. Used in all subsequent requests for this conversation. - @@ -1335,7 +1274,6 @@ Used in all subsequent requests for this conversation. Processes a user prompt within a session. This method handles the whole lifecycle of a prompt: - - Receives user messages with optional context (files, images, etc.) - Processes the prompt using language models - Reports language model content and tool calls to the Clients @@ -1363,7 +1301,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ContentBlock[]} required> The blocks of content that compose the user's message. @@ -1379,7 +1316,6 @@ The client MAY include referenced pieces of context as either When available, `ContentBlock::Resource` is preferred as it avoids extra round-trips and allows the message to include pieces of context from sources the agent may not have access to. - SessionId} required> The ID of the session to send this user message to @@ -1401,7 +1337,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - StopReason} required> Indicates why the agent stopped processing the turn. @@ -1412,7 +1347,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d This capability is not part of the spec yet, and may be removed or changed at any point. Token usage for this turn (optional). - @@ -1444,7 +1378,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - "string"[]} > Additional workspace roots to activate for this session. Each path must be absolute. @@ -1453,7 +1386,6 @@ When omitted or empty, no additional roots are activated. When non-empty, this is the complete resulting additional-root list for the resumed session. It may differ from any previously used or reported list as long as the request `cwd` matches the session's `cwd`. - The working directory for this session. @@ -1479,7 +1411,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - SessionConfigOption[] | null} > Initial session configuration options if supported by the Agent. @@ -1488,7 +1419,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Initial mode state if supported by the Agent See protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/v1/draft/session-modes) - @@ -1510,7 +1440,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - SessionConfigId} required> The ID of the configuration option to set. @@ -1545,17 +1474,15 @@ variant. -SessionConfigValueId} - required -> +SessionConfigValueId} required> The value ID. + + #### SetSessionConfigOptionResponse Response to `session/set_config_option` method. @@ -1570,7 +1497,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - SessionConfigOption[]} required> The full set of configuration options and their current values. @@ -1607,7 +1533,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - SessionModeId} required> The ID of the mode to set. @@ -1630,7 +1555,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ## Client @@ -1640,7 +1564,6 @@ Defines the interface that ACP-compliant clients must implement. Clients are typically code editors (IDEs, text editors) that provide the interface between users and AI agents. They manage the environment, handle user interactions, and control access to resources. - ### elicitation/complete @@ -1668,7 +1591,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ElicitationId} required> The ID of the elicitation that completed. @@ -1705,7 +1627,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - A human-readable message describing what input is needed. @@ -1721,11 +1642,7 @@ Form-based elicitation where the client renders a form from the provided schema. The discriminator value. Must be `"form"`. -ElicitationSchema} - required -> +ElicitationSchema} required> A JSON Schema describing the form fields to present to the user. @@ -1737,11 +1654,7 @@ URL-based elicitation where the client directs the user to a URL. -ElicitationId} - required -> +ElicitationId} required> The unique identifier for this elicitation. @@ -1754,6 +1667,8 @@ URL-based elicitation where the client directs the user to a URL. + + #### CreateElicitationResponse **UNSTABLE** @@ -1772,7 +1687,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - **Variants:** @@ -1785,7 +1699,7 @@ The user accepted and provided content. The discriminator value. Must be `"accept"`. - + The user-provided content, if any, as an object matching the requested schema. @@ -1816,6 +1730,8 @@ The elicitation was cancelled. + + ### fs/read_text_file @@ -1842,19 +1758,16 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Maximum number of lines to read. - Minimum: `0` - Line number to start reading from (1-based). - Minimum: `0` - Absolute path to the file to read. @@ -1877,7 +1790,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Content payload returned by this response. @@ -1909,7 +1821,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - The text content to write to the file. @@ -1935,7 +1846,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - @@ -1965,7 +1875,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - McpServerAcpId} required> The ACP MCP server ID that was provided by the component declaring the MCP server. @@ -1989,7 +1898,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - McpConnectionId} required> The unique identifier for this MCP-over-ACP connection. @@ -2022,7 +1930,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - McpConnectionId} required> The MCP-over-ACP connection to close. @@ -2046,7 +1953,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - @@ -2079,7 +1985,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - McpConnectionId} required> The MCP-over-ACP connection this message is sent on. @@ -2091,7 +1996,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Optional inner MCP params. If omitted or set to `null`, the inner MCP message has no params. - #### MessageMcpRequest @@ -2112,7 +2016,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - McpConnectionId} required> The MCP-over-ACP connection this message is sent on. @@ -2124,7 +2027,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Optional inner MCP params. If omitted or set to `null`, the inner MCP message has no params. - #### MessageMcpResponse @@ -2137,6 +2039,7 @@ Response to `mcp/message`. This is the inner MCP response result payload. Any JSON value is valid. + ### session/request_permission @@ -2169,7 +2072,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - PermissionOption[]} required> Available permission options for the user to choose from. @@ -2195,7 +2097,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - RequestPermissionOutcome} required> The user's decision on the permission request. @@ -2234,7 +2135,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - SessionId} required> The ID of the session this update pertains to. @@ -2275,7 +2175,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - "string"[]} > Array of command arguments. @@ -2300,7 +2199,6 @@ string output, even if this means the retained output is slightly less than the specified limit. - Minimum: `0` - SessionId} required> The session ID for this request. @@ -2320,7 +2218,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - TerminalId} required> The unique identifier for the created terminal. @@ -2356,7 +2253,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - SessionId} required> The session ID for this request. @@ -2379,7 +2275,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - @@ -2406,7 +2301,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - SessionId} required> The session ID for this request. @@ -2429,7 +2323,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - TerminalExitStatus | null} > Exit status if the command has completed. @@ -2471,7 +2364,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - SessionId} required> The session ID for this request. @@ -2494,7 +2386,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - @@ -2518,7 +2409,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - SessionId} required> The session ID for this request. @@ -2541,13 +2431,11 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - The process exit code (may be null if terminated by signal). - Minimum: `0` - The signal that terminated the process (may be null if exited normally). @@ -2563,7 +2451,6 @@ agents. For example if the implementation uses a single threaded synchronous programming language then there is little it can do to react to a `$/cancel_request` notification. If an agent or client receives notifications starting with '$/' it is free to ignore the notification. - ### $/cancel_request @@ -2581,9 +2468,8 @@ Upon receiving this notification, the receiver: 1. MUST cancel the corresponding request activity and all nested activities 2. MAY send any pending notifications. 3. MUST send one of these responses for the original request: - -- Valid response with appropriate data (partial results or cancellation marker) -- Error response with code `-32800` (Cancelled) + - Valid response with appropriate data (partial results or cancellation marker) + - Error response with code `-32800` (Cancelled) See protocol docs: [Cancellation](https://agentclientprotocol.com/protocol/v1/draft/cancellation) @@ -2607,7 +2493,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - RequestId} required> The ID of the request to cancel. @@ -2627,13 +2512,11 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - LogoutCapabilities | null} > Whether the agent supports the logout method. By supplying `\{\}` it means that the agent supports the logout method. - ## AgentCapabilities @@ -2655,25 +2538,21 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - AgentAuthCapabilities} > Authentication-related capabilities supported by the agent. - Default: `{}` - Whether the agent supports `session/load`. - Default: `false` - McpCapabilities} > MCP capabilities supported by the agent. - Default: `{"http":false,"sse":false,"acp":false}` - NesCapabilities | null} > **UNSTABLE** @@ -2681,7 +2560,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d This capability is not part of the spec yet, and may be removed or changed at any point. NES (Next Edit Suggestions) capabilities supported by the agent. - PositionEncodingKind | null} > **UNSTABLE** @@ -2689,13 +2567,11 @@ NES (Next Edit Suggestions) capabilities supported by the agent. This capability is not part of the spec yet, and may be removed or changed at any point. The position encoding selected by the agent from the client's supported encodings. - PromptCapabilities} > Prompt capabilities supported by the agent. - Default: `{"image":false,"audio":false,"embeddedContext":false}` - ProvidersCapabilities | null} > **UNSTABLE** @@ -2705,13 +2581,11 @@ This capability is not part of the spec yet, and may be removed or changed at an Provider configuration capabilities supported by the agent. By supplying `\{\}` it means that the agent supports provider configuration methods. - SessionCapabilities} > Session lifecycle and prompt capabilities advertised by the agent. - Default: `{}` - ## Annotations @@ -2728,7 +2602,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Role[] | null} > Intended recipients for this content, such as the user or assistant. @@ -2754,7 +2627,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -2788,7 +2660,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Whether the client supports `terminal` authentication methods. @@ -2796,7 +2667,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d When `true`, the agent may include `terminal` entries in its authentication methods. - Default: `false` - ## AuthEnvVar @@ -2817,7 +2687,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Human-readable label for this variable, displayed in client UI. @@ -2831,7 +2700,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Defaults to `false`. - Default: `false` - Whether this value is a secret (e.g. API key, token). @@ -2840,7 +2708,6 @@ Clients should use a password-style input for secret vars. Defaults to `true`. - Default: `true` - ## AuthMethod @@ -2867,7 +2734,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Optional description providing more details about this authentication method. @@ -2906,7 +2772,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - "string"[]} > Additional arguments to pass when running the agent binary for terminal auth. @@ -2943,7 +2808,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Optional description providing more details about this authentication method. @@ -2958,6 +2822,8 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d + + ## AuthMethodAgent Agent handles authentication itself. @@ -2974,7 +2840,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Optional description providing more details about this authentication method. @@ -3006,7 +2871,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Optional description providing more details about this authentication method. @@ -3050,7 +2914,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - "string"[]} > Additional arguments to pass when running the agent binary for terminal auth. @@ -3082,7 +2945,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Human-readable description of what the command does. @@ -3110,7 +2972,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - A hint to display when the input hasn't been provided yet @@ -3130,7 +2991,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - AvailableCommand[]} required> Commands the agent can execute @@ -3150,7 +3010,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Base64-encoded bytes for a binary resource payload. @@ -3182,7 +3041,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ## BooleanPropertySchema @@ -3199,7 +3057,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Default value. @@ -3230,7 +3087,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - AuthCapabilities} > **UNSTABLE** @@ -3242,7 +3098,6 @@ Determines which authentication method types the agent may include in its `InitializeResponse`. - Default: `{"terminal":false}` - ElicitationCapabilities | null} > **UNSTABLE** @@ -3251,14 +3106,12 @@ This capability is not part of the spec yet, and may be removed or changed at an Elicitation capabilities supported by the client. Determines which elicitation modes the agent may use. - FileSystemCapabilities} > File system capabilities supported by the client. Determines which file operations the agent can request. - Default: `{"readTextFile":false,"writeTextFile":false}` - ClientNesCapabilities | null} > **UNSTABLE** @@ -3266,7 +3119,6 @@ Determines which file operations the agent can request. This capability is not part of the spec yet, and may be removed or changed at any point. NES (Next Edit Suggestions) capabilities supported by the client. - PlanCapabilities | null} > **UNSTABLE** @@ -3277,7 +3129,6 @@ Whether the client supports `plan_update` and `plan_removed` session updates. Optional. Omitted means the client does not advertise support. Supplying `\{\}` means the client can receive both update types. - PositionEncodingKind[]} > **UNSTABLE** @@ -3285,7 +3136,6 @@ Supplying `\{\}` means the client can receive both update types. This capability is not part of the spec yet, and may be removed or changed at any point. The position encodings supported by the client, in order of preference. - ClientSessionCapabilities | null} > **UNSTABLE** @@ -3293,13 +3143,11 @@ The position encodings supported by the client, in order of preference. This capability is not part of the spec yet, and may be removed or changed at any point. Session-related capabilities supported by the client. - Whether the Client support all `terminal/*` methods. - Default: `false` - ## ClientNesCapabilities @@ -3316,7 +3164,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - NesJumpCapabilities | null} > Whether the client supports the `jump` suggestion kind. @@ -3346,14 +3193,12 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - SessionConfigOptionsCapabilities | null} > Config option capabilities supported by the client. Omitted or `null` means the client does not advertise support for any config option extensions. - ## ConfigOptionUpdate @@ -3370,7 +3215,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - SessionConfigOption[]} required> The full set of configuration options and their current values. @@ -3390,7 +3234,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ContentBlock} required> The actual content block. @@ -3404,7 +3247,6 @@ They provide a structured way to handle various types of user-facing content—w it's text from language models, images for analysis, or embedded resources for context. Content blocks appear in: - - User prompts sent via `session/prompt` - Language model output streamed through `session/update` notifications - Progress updates and results from tool calls @@ -3430,7 +3272,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -3458,7 +3299,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -3492,7 +3332,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -3523,7 +3362,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -3568,7 +3406,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -3583,6 +3420,8 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d + + ## ContentChunk A streamed item of content @@ -3597,7 +3436,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ContentBlock} required> A single item of content @@ -3607,7 +3445,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d All chunks belonging to the same message share the same `messageId`. A change in `messageId` indicates a new message has started. - ## Cost @@ -3624,7 +3461,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Total cumulative cost for session. @@ -3649,7 +3485,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - SessionModeId} required> The ID of the current mode @@ -3673,7 +3508,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - The new content after modification. @@ -3697,7 +3531,7 @@ The user accepted the elicitation and provided content. **Properties:** - + The user-provided content, if any, as an object matching the requested schema. @@ -3719,7 +3553,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ElicitationFormCapabilities | null} > Whether the client supports form-based elicitation. @@ -3735,25 +3568,27 @@ Allowed wire representations for `ElicitationContentValue`. **Type:** Union - String value accepted in elicitation response content. +String value accepted in elicitation response content. - Integer value accepted in elicitation response content. +Integer value accepted in elicitation response content. - Number value accepted in elicitation response content. +Number value accepted in elicitation response content. - Boolean value accepted in elicitation response content. +Boolean value accepted in elicitation response content. - String array value accepted in elicitation response content. +String array value accepted in elicitation response content. + + ## ElicitationFormCapabilities **UNSTABLE** @@ -3772,7 +3607,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ## ElicitationFormMode @@ -3787,11 +3621,7 @@ Form-based elicitation mode where the client renders a form from the provided sc **Shared properties:** -ElicitationSchema} - required -> +ElicitationSchema} required> A JSON Schema describing the form fields to present to the user. @@ -3802,24 +3632,10 @@ Tied to a session, optionally to a specific tool call within that session. -SessionId} - required -> +SessionId} required> The session this elicitation is tied to. - - - ToolCallId - - | null - - } -> +ToolCallId | null} > Optional tool call within the session. @@ -3832,17 +3648,15 @@ Tied to a specific JSON-RPC request outside of a session -RequestId} - required -> +RequestId} required> The request this elicitation is tied to. + + ## ElicitationId **UNSTABLE** @@ -3874,7 +3688,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Default value. @@ -3892,13 +3705,11 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Maximum string length. - Minimum: `0` - Minimum string length. - Minimum: `0` - EnumOption[] | null} > Titled enum options for titled single-select enums. @@ -3927,7 +3738,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Default value. @@ -3962,7 +3772,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Default value. @@ -3997,7 +3806,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Default value. @@ -4026,7 +3834,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - <>"string"[] | null} > Default selected values. @@ -4041,13 +3848,11 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Maximum number of items to select. - Minimum: `0` - Minimum number of items to select. - Minimum: `0` - Optional title for the property. @@ -4059,6 +3864,8 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d + + ## ElicitationRequestScope **UNSTABLE** @@ -4072,11 +3879,7 @@ Request-scoped elicitation, tied to a specific JSON-RPC request outside of a ses **Properties:** -RequestId} - required -> +RequestId} required> The request this elicitation is tied to. @@ -4097,7 +3900,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Optional description of what this schema represents. @@ -4106,7 +3908,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Property definitions (must be primitive types). - Default: `{}` - <>"string"[] | null} > List of required property names. @@ -4118,7 +3919,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Type discriminator. Always `"object"`. - Default: `"object"` - ## ElicitationSchemaType @@ -4128,9 +3928,11 @@ Type discriminator for elicitation schemas. **Type:** Union - Object schema type. +Object schema type. + + ## ElicitationSessionScope **UNSTABLE** @@ -4147,24 +3949,10 @@ during a tool call and needs to redirect it to the user. **Properties:** -SessionId} - required -> +SessionId} required> The session this elicitation is tied to. - - - ToolCallId - - | null - - } -> +ToolCallId | null} > Optional tool call within the session. @@ -4175,9 +3963,11 @@ Items definition for untitled multi-select enum properties. **Type:** Union - String schema type. +String schema type. + + ## ElicitationUrlCapabilities **UNSTABLE** @@ -4196,7 +3986,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ## ElicitationUrlMode @@ -4211,11 +4000,7 @@ URL-based elicitation mode where the client directs the user to a URL. **Shared properties:** -ElicitationId} - required -> +ElicitationId} required> The unique identifier for this elicitation. @@ -4229,24 +4014,10 @@ Tied to a session, optionally to a specific tool call within that session. -SessionId} - required -> +SessionId} required> The session this elicitation is tied to. - - - ToolCallId - - | null - - } -> +ToolCallId | null} > Optional tool call within the session. @@ -4259,17 +4030,15 @@ Tied to a specific JSON-RPC request outside of a session -RequestId} - required -> +RequestId} required> The request this elicitation is tied to. + + ## EmbeddedResource The contents of a resource, embedded into a prompt or tool call result. @@ -4284,7 +4053,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -4310,7 +4078,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - MIME type describing the encoded media payload. @@ -4336,7 +4103,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Base64-encoded bytes for a binary resource payload. @@ -4351,6 +4117,8 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d + + ## EnumOption A titled enum option with a const value and human-readable title. @@ -4365,7 +4133,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - The constant value for this option. @@ -4388,7 +4155,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - The name of the environment variable. @@ -4411,17 +4177,16 @@ See protocol docs: [JSON-RPC Error Object](https://www.jsonrpc.org/specification **Properties:** ErrorCode} required> - A number indicating the error type that occurred. This must be an integer as - defined in the JSON-RPC specification. + A number indicating the error type that occurred. +This must be an integer as defined in the JSON-RPC specification. - - Optional primitive or structured value that contains additional information - about the error. This may include debugging information or context-specific - details. + + Optional primitive or structured value that contains additional information about the error. +This may include debugging information or context-specific details. - A string providing a short description of the error. The message should be - limited to a concise single sentence. + A string providing a short description of the error. +The message should be limited to a concise single sentence. ## ErrorCode @@ -4434,25 +4199,25 @@ and use the reserved range (-32000 to -32099) for protocol-specific errors. **Type:** Union - **Parse error**: Invalid JSON was received by the server. An error occurred on - the server while parsing the JSON text. +**Parse error**: Invalid JSON was received by the server. +An error occurred on the server while parsing the JSON text. - **Invalid request**: The JSON sent is not a valid Request object. +**Invalid request**: The JSON sent is not a valid Request object. - **Method not found**: The method does not exist or is not available. +**Method not found**: The method does not exist or is not available. - **Invalid params**: Invalid method parameter(s). +**Invalid params**: Invalid method parameter(s). - **Internal error**: Internal JSON-RPC error. Reserved for - implementation-defined server errors. +**Internal error**: Internal JSON-RPC error. +Reserved for implementation-defined server errors. @@ -4462,16 +4227,14 @@ This capability is not part of the spec yet, and may be removed or changed at an Execution of the method was aborted either due to a cancellation request from the caller or because of resource constraints or shutdown. - - **Authentication required**: Authentication is required before this operation - can be performed. +**Authentication required**: Authentication is required before this operation can be performed. - **Resource not found**: A given resource, such as a file, was not found. +**Resource not found**: A given resource, such as a file, was not found. @@ -4480,13 +4243,14 @@ because of resource constraints or shutdown. This capability is not part of the spec yet, and may be removed or changed at any point. The agent requires user input via a URL-based elicitation before it can proceed. - - Other undefined error code. +Other undefined error code. + + ## ExtNotification Allows the Agent to send an arbitrary notification that is not part of the ACP spec. @@ -4495,6 +4259,7 @@ while maintaining protocol compatibility. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ## ExtRequest Allows for sending an arbitrary request that is not part of the ACP spec. @@ -4503,6 +4268,7 @@ protocol compatibility. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ## ExtResponse Allows for sending an arbitrary response to an `ExtRequest` that is not part of the ACP spec. @@ -4511,6 +4277,7 @@ protocol compatibility. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ## FileSystemCapabilities File system capabilities that a client may support. @@ -4527,19 +4294,16 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Whether the Client supports `fs/read_text_file` requests. - Default: `false` - Whether the Client supports `fs/write_text_file` requests. - Default: `false` - ## HttpHeader @@ -4556,7 +4320,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - The name of the HTTP header. @@ -4579,7 +4342,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -4610,7 +4372,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Intended for programmatic or logical use, but can be used as a display @@ -4621,7 +4382,6 @@ name fallback if title isn’t present. and easily understood. If not provided, the name should be used for display. - Version of the implementation. Can be displayed to the user or used @@ -4642,7 +4402,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Default value. @@ -4676,29 +4435,31 @@ Protocol names that do not begin with `_` are reserved for the ACP spec. **Type:** Union - Anthropic API protocol. +Anthropic API protocol. - OpenAI API protocol. +OpenAI API protocol. - Azure OpenAI API protocol. +Azure OpenAI API protocol. - Google Vertex AI API protocol. +Google Vertex AI API protocol. - AWS Bedrock API protocol. +AWS Bedrock API protocol. - Unknown or custom protocol. +Unknown or custom protocol. + + ## LogoutCapabilities Logout capabilities supported by the agent. @@ -4715,7 +4476,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ## McpCapabilities @@ -4732,7 +4492,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - **UNSTABLE** @@ -4742,19 +4501,16 @@ This capability is not part of the spec yet, and may be removed or changed at an Agent supports `McpServer::Acp`. - Default: `false` - Agent supports `McpServer::Http`. - Default: `false` - Agent supports `McpServer::Sse`. - Default: `false` - ## McpConnectionId @@ -4791,7 +4547,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - HttpHeader[]} required> HTTP headers to set when making requests to the MCP server. @@ -4822,7 +4577,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - HttpHeader[]} required> HTTP headers to set when making requests to the MCP server. @@ -4858,14 +4612,12 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - McpServerAcpId} required> Unique identifier for this MCP server, generated by the component providing it. Providers MUST NOT reuse an ID for multiple ACP-transport MCP servers that are visible on the same ACP connection. - Human-readable name identifying this MCP server. @@ -4890,7 +4642,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - "string"[]} required> Command-line arguments to pass to the MCP server. @@ -4908,6 +4659,8 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d + + ## McpServerAcp **UNSTABLE** @@ -4929,14 +4682,12 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - McpServerAcpId} required> Unique identifier for this MCP server, generated by the component providing it. Providers MUST NOT reuse an ID for multiple ACP-transport MCP servers that are visible on the same ACP connection. - Human-readable name identifying this MCP server. @@ -4970,7 +4721,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - HttpHeader[]} required> HTTP headers to set when making requests to the MCP server. @@ -4996,7 +4746,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - HttpHeader[]} required> HTTP headers to set when making requests to the MCP server. @@ -5022,7 +4771,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - "string"[]} required> Command-line arguments to pass to the MCP server. @@ -5060,7 +4808,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - "string"[]} required> Allowed enum values. @@ -5083,7 +4830,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - EnumOption[]} required> Titled enum options. @@ -5092,6 +4838,8 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d + + ## MultiSelectPropertySchema Schema for multi-select (array) properties in an elicitation form. @@ -5106,7 +4854,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - <>"string"[] | null} > Default selected values. @@ -5121,13 +4868,11 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Maximum number of items to select. - Minimum: `0` - Minimum number of items to select. - Minimum: `0` - Optional title for the property. @@ -5147,7 +4892,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - NesContextCapabilities | null} > Context the agent wants attached to each suggestion request. @@ -5170,7 +4914,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - NesDiagnosticsCapabilities | null} > Whether the agent wants diagnostics context. @@ -5205,7 +4948,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - The diagnostic message. @@ -5227,21 +4969,23 @@ Severity of a diagnostic. **Type:** Union - An error. +An error. - A warning. +A warning. - An informational message. +An informational message. - A hint. +A hint. + + ## NesDiagnosticsCapabilities Capabilities for diagnostics context. @@ -5256,7 +5000,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ## NesDocumentDidChangeCapabilities @@ -5273,7 +5016,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - TextDocumentSyncKind} required> The sync kind the agent wants: `"full"` or `"incremental"`. @@ -5293,7 +5035,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ## NesDocumentDidFocusCapabilities @@ -5310,7 +5051,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ## NesDocumentDidOpenCapabilities @@ -5327,7 +5067,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ## NesDocumentDidSaveCapabilities @@ -5344,7 +5083,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ## NesDocumentEventCapabilities @@ -5361,7 +5099,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - NesDocumentDidChangeCapabilities | null} > Whether the agent wants `document/didChange` events, and the sync kind. @@ -5393,13 +5130,11 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Maximum number of edit history entries the agent can use. - Minimum: `0` - ## NesEditHistoryEntry @@ -5416,7 +5151,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - A diff representing the edit. @@ -5439,7 +5173,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Position | null} > Optional suggested cursor position after applying edits. @@ -5468,7 +5201,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - NesDocumentEventCapabilities | null} > Document event capabilities. @@ -5488,19 +5220,16 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - The end line of the excerpt (zero-based). - Minimum: `0` - The start line of the excerpt (zero-based). - Minimum: `0` - The text content of the excerpt. @@ -5520,7 +5249,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ## NesJumpSuggestion @@ -5537,7 +5265,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Unique identifier for accept/reject tracking. @@ -5563,7 +5290,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - The language identifier. @@ -5572,7 +5298,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Timestamp in milliseconds since epoch of when the file was last focused. - Minimum: `0` - The URI of the file. @@ -5595,7 +5320,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ## NesRecentFile @@ -5612,7 +5336,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - The language identifier. @@ -5638,13 +5361,11 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Maximum number of recent files the agent can use. - Minimum: `0` - ## NesRejectReason @@ -5654,21 +5375,23 @@ The reason a suggestion was rejected. **Type:** Union - The user explicitly dismissed the suggestion. +The user explicitly dismissed the suggestion. - The suggestion was shown but the user continued editing without interacting. +The suggestion was shown but the user continued editing without interacting. - The suggestion was superseded by a newer suggestion. +The suggestion was superseded by a newer suggestion. - The request was cancelled before the agent returned a response. +The request was cancelled before the agent returned a response. + + ## NesRelatedSnippet A related code snippet from a file. @@ -5683,7 +5406,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - NesExcerpt[]} required> The code excerpts. @@ -5706,7 +5428,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ## NesRenameCapabilities @@ -5723,7 +5444,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ## NesRenameSuggestion @@ -5740,7 +5460,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Unique identifier for accept/reject tracking. @@ -5769,7 +5488,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - The repository name. @@ -5795,7 +5513,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ## NesSearchAndReplaceSuggestion @@ -5812,7 +5529,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Unique identifier for accept/reject tracking. @@ -5844,7 +5560,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - NesDiagnostic[] | null} > Current diagnostics (errors, warnings). @@ -5882,7 +5597,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Position | null} > Optional suggested cursor position after applying edits. @@ -5914,7 +5628,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Unique identifier for accept/reject tracking. @@ -5943,7 +5656,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Unique identifier for accept/reject tracking. @@ -5975,7 +5687,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Unique identifier for accept/reject tracking. @@ -5999,6 +5710,8 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d + + ## NesTextEdit A text edit within a suggestion. @@ -6013,7 +5726,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - The replacement text. @@ -6029,17 +5741,19 @@ What triggered the suggestion request. **Type:** Union - Triggered by user typing or cursor movement. +Triggered by user typing or cursor movement. - Triggered by a diagnostic appearing at or near the cursor. +Triggered by a diagnostic appearing at or near the cursor. - Triggered by an explicit user action (keyboard shortcut). +Triggered by an explicit user action (keyboard shortcut). + + ## NesUserAction A user action (typing, cursor movement, etc.). @@ -6054,7 +5768,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - The kind of action (e.g., "insertChar", "cursorMovement"). @@ -6066,7 +5779,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Timestamp in milliseconds since epoch. - Minimum: `0` - The URI of the file where the action occurred. @@ -6086,13 +5798,11 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Maximum number of user actions the agent can use. - Minimum: `0` - ## NumberPropertySchema @@ -6109,7 +5819,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Default value. @@ -6141,7 +5850,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - PermissionOptionKind} required> Hint about the nature of this permission option. @@ -6168,21 +5876,23 @@ Helps clients choose appropriate icons and UI treatment. **Type:** Union - Allow this operation only this time. +Allow this operation only this time. - Allow this operation and remember the choice. +Allow this operation and remember the choice. - Reject this operation only this time. +Reject this operation only this time. - Reject this operation and remember the choice. +Reject this operation and remember the choice. + + ## Plan An execution plan for accomplishing complex tasks. @@ -6203,14 +5913,12 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - PlanEntry[]} required> The list of tasks to be accomplished. When updating a plan, the agent must send a complete list of all entries with their current status. The client replaces the entire plan with each update. - ## PlanCapabilities @@ -6231,7 +5939,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ## PlanEntry @@ -6252,7 +5959,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Human-readable description of what this task aims to accomplish. @@ -6276,17 +5982,19 @@ See protocol docs: [Plan Entries](https://agentclientprotocol.com/protocol/v1/dr **Type:** Union - High priority task - critical to the overall goal. +High priority task - critical to the overall goal. - Medium priority task - important but not critical. +Medium priority task - important but not critical. - Low priority task - nice to have but not essential. +Low priority task - nice to have but not essential. + + ## PlanEntryStatus Status of a plan entry in the execution flow. @@ -6297,17 +6005,19 @@ See protocol docs: [Plan Entries](https://agentclientprotocol.com/protocol/v1/dr **Type:** Union - The task has not started yet. +The task has not started yet. - The task is currently being worked on. +The task is currently being worked on. - The task has been successfully completed. +The task has been successfully completed. + + ## PlanFile **UNSTABLE** @@ -6326,7 +6036,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - PlanId} required> The plan ID to update. @@ -6363,14 +6072,12 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - PlanEntry[]} required> The list of tasks to be accomplished. When updating an item-based plan, the agent must send a complete list of all entries with their current status. The client replaces that plan with each update. - PlanId} required> The plan ID to update. @@ -6394,7 +6101,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Markdown content for the plan. @@ -6421,7 +6127,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - PlanId} required> The plan ID to remove. @@ -6445,7 +6150,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - PlanUpdateContent} required> The updated plan content. @@ -6472,14 +6176,12 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - PlanEntry[]} required> The list of tasks to be accomplished. When updating an item-based plan, the agent must send a complete list of all entries with their current status. The client replaces that plan with each update. - PlanId} required> The plan ID to update. @@ -6502,7 +6204,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - PlanId} required> The plan ID to update. @@ -6528,7 +6229,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Markdown content for the plan. @@ -6543,6 +6243,8 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d + + ## Position A zero-based position in a text document. @@ -6559,19 +6261,16 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Zero-based character offset (encoding-dependent). - Minimum: `0` - Zero-based line number. - Minimum: `0` - ## PositionEncodingKind @@ -6583,17 +6282,19 @@ Follows the same conventions as LSP 3.17. The default is UTF-16. **Type:** Union - Character offsets count UTF-16 code units. This is the default. +Character offsets count UTF-16 code units. This is the default. - Character offsets count Unicode code points. +Character offsets count Unicode code points. - Character offsets count UTF-8 code units (bytes). +Character offsets count UTF-8 code units (bytes). + + ## PromptCapabilities Prompt capabilities supported by the agent in `session/prompt` requests. @@ -6619,13 +6320,11 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Agent supports `ContentBlock::Audio`. - Default: `false` - Agent supports embedded context in `session/prompt` requests. @@ -6634,13 +6333,11 @@ When enabled, the Client is allowed to include `ContentBlock::Resource` in prompt requests for pieces of context that are referenced in the message. - Default: `false` - Agent supports `ContentBlock::Image`. - Default: `false` - ## ProtocolVersion @@ -6652,10 +6349,10 @@ Non-breaking changes should be introduced via capabilities. **Type:** `integer (uint16)` -| Constraint | Value | -| ---------- | ------- | -| Minimum | `0` | -| Maximum | `65535` | +| Constraint | Value | +| ---------- | ----- | +| Minimum | `0` | +| Maximum | `65535` | ## ProviderCurrentConfig @@ -6675,7 +6372,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - LlmProtocol} required> Protocol currently used by this provider. @@ -6702,7 +6398,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ProviderCurrentConfig | null} > Current effective non-secret routing config. @@ -6739,7 +6434,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ## Range @@ -6756,7 +6450,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Position} required> The end position (exclusive). @@ -6780,17 +6473,19 @@ The Server MUST reply with the same value in the Response object if included. Th **Type:** Union - The JSON-RPC `null` request id. +The JSON-RPC `null` request id. - A numeric JSON-RPC request id. +A numeric JSON-RPC request id. - A string JSON-RPC request id. +A string JSON-RPC request id. + + ## RequestPermissionOutcome The outcome of a permission request. @@ -6826,7 +6521,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - PermissionOptionId} required> The ID of the option the user selected. @@ -6838,6 +6532,8 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d + + ## ResourceLink A resource that the server is capable of reading, included in a prompt or tool call result. @@ -6852,7 +6548,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -6883,13 +6578,15 @@ The sender or recipient of messages and data in a conversation. **Type:** Union - The assistant side of a conversation. +The assistant side of a conversation. - The user side of a conversation. +The user side of a conversation. + + ## SelectedPermissionOutcome The user selected one of the provided options. @@ -6904,7 +6601,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - PermissionOptionId} required> The ID of the option the user selected. @@ -6929,7 +6625,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ## SessionCapabilities @@ -6954,7 +6649,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - SessionAdditionalDirectoriesCapabilities | null} > Whether the agent supports `additionalDirectories` on supported session lifecycle requests. @@ -6962,7 +6656,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Agents that also support `session/list` may return `SessionInfo.additionalDirectories` to report the complete ordered additional-root list associated with a listed session. - SessionCloseCapabilities | null} > Whether the agent supports `session/close`. @@ -6972,7 +6665,6 @@ additional-root list associated with a listed session. Optional. Omitted or `null` both mean the agent does not advertise support. Supplying `\{\}` means the agent supports deleting sessions from `session/list`. - SessionForkCapabilities | null} > **UNSTABLE** @@ -6980,7 +6672,6 @@ Supplying `\{\}` means the agent supports deleting sessions from `session/list`. This capability is not part of the spec yet, and may be removed or changed at any point. Whether the agent supports `session/fork`. - SessionListCapabilities | null} > Whether the agent supports `session/list`. @@ -7005,7 +6696,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ## SessionConfigBoolean @@ -7050,7 +6740,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - SessionConfigOptionCategory | null} > Optional semantic category for this option (UX only). @@ -7072,18 +6761,10 @@ Single-value selector (dropdown). -SessionConfigValueId} - required -> +SessionConfigValueId} required> The currently selected value. -SessionConfigSelectOptions} - required -> +SessionConfigSelectOptions} required> The set of selectable options. @@ -7112,6 +6793,8 @@ Boolean on/off toggle. + + ## SessionConfigOptionCategory Semantic category for a session configuration option. @@ -7127,25 +6810,27 @@ Category names that do not begin with `_` are reserved for the ACP spec. **Type:** Union - Session mode selector. +Session mode selector. - Model selector. +Model selector. - Model-related configuration parameter. +Model-related configuration parameter. - Thought/reasoning level selector. +Thought/reasoning level selector. - Unknown / uncategorized selector. +Unknown / uncategorized selector. + + ## SessionConfigOptionsCapabilities **UNSTABLE** @@ -7164,7 +6849,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - BooleanConfigOptionCapabilities | null} > Whether the client supports boolean session configuration options. @@ -7173,7 +6857,6 @@ Omitted or `null` means the client does not advertise support. Supplying `\{\}` means agents may include `type: "boolean"` entries in `configOptions`, and the client may send `session/set_config_option` requests with `type: "boolean"` and a boolean `value`. - ## SessionConfigSelect @@ -7184,18 +6867,10 @@ A single-value selector (dropdown) session configuration option payload. **Properties:** -SessionConfigValueId} - required -> +SessionConfigValueId} required> The currently selected value. -SessionConfigSelectOptions} - required -> +SessionConfigSelectOptions} required> The set of selectable options. @@ -7213,7 +6888,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - SessionConfigGroupId} required> Unique identifier for this group. @@ -7239,7 +6913,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Optional description for this option value. @@ -7258,13 +6931,15 @@ Possible values for a session configuration option. **Type:** Union - A flat list of options with no grouping. +A flat list of options with no grouping. - A list of options grouped under headers. +A list of options grouped under headers. + + ## SessionConfigValueId Unique identifier for a session configuration option value. @@ -7287,7 +6962,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ## SessionForkCapabilities @@ -7310,7 +6984,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ## SessionId @@ -7338,7 +7011,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - "string"[]} > Additional workspace roots reported for this session. Each path must be absolute. @@ -7346,7 +7018,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d When present, this is the complete ordered additional-root list reported by the Agent. Omitted and empty values are equivalent: the response reports no additional roots. - The working directory for this session. Must be an absolute path. @@ -7378,7 +7049,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Human-readable title for the session. Set to null to clear. @@ -7403,7 +7073,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ## SessionMode @@ -7422,7 +7091,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Optional human-readable details shown with this protocol object. @@ -7454,7 +7122,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - SessionMode[]} required> The set of modes that the Agent can operate in @@ -7479,7 +7146,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ## SessionUpdate @@ -7503,7 +7169,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ContentBlock} required> A single item of content @@ -7513,7 +7178,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d All chunks belonging to the same message share the same `messageId`. A change in `messageId` indicates a new message has started. - The discriminator value. Must be `"user_message_chunk"`. @@ -7533,7 +7197,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ContentBlock} required> A single item of content @@ -7543,7 +7206,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d All chunks belonging to the same message share the same `messageId`. A change in `messageId` indicates a new message has started. - The discriminator value. Must be `"agent_message_chunk"`. @@ -7563,7 +7225,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ContentBlock} required> A single item of content @@ -7573,7 +7234,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d All chunks belonging to the same message share the same `messageId`. A change in `messageId` indicates a new message has started. - The discriminator value. Must be `"agent_thought_chunk"`. @@ -7593,7 +7253,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ToolCallContent[]} > Content produced by the tool call. @@ -7639,7 +7298,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ToolCallContent[] | null} > Replace the content collection. @@ -7684,14 +7342,12 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - PlanEntry[]} required> The list of tasks to be accomplished. When updating a plan, the agent must send a complete list of all entries with their current status. The client replaces the entire plan with each update. - The discriminator value. Must be `"plan"`. @@ -7715,7 +7371,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - PlanUpdateContent} required> The updated plan content. @@ -7742,7 +7397,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - PlanId} required> The plan ID to remove. @@ -7765,7 +7419,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - AvailableCommand[]} required> Commands the agent can execute @@ -7790,7 +7443,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - SessionModeId} required> The ID of the current mode @@ -7813,7 +7465,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - SessionConfigOption[]} required> The full set of configuration options and their current values. @@ -7836,7 +7487,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - The discriminator value. Must be `"session_info_update"`. @@ -7862,7 +7512,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Cost | null} > Cumulative session cost (optional). @@ -7874,18 +7523,18 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Total context window size in tokens. - Minimum: `0` - Tokens currently in context. - Minimum: `0` - + + ## StopReason Reasons why an agent stops processing a prompt turn. @@ -7895,22 +7544,22 @@ See protocol docs: [Stop Reasons](https://agentclientprotocol.com/protocol/v1/dr **Type:** Union - The turn ended successfully. +The turn ended successfully. - The turn ended because the agent reached the maximum number of tokens. +The turn ended because the agent reached the maximum number of tokens. - The turn ended because the agent reached the maximum number of allowed agent - requests between user turns. +The turn ended because the agent reached the maximum number of allowed +agent requests between user turns. - The turn ended because the agent refused to continue. The user prompt and - everything that comes after it won't be included in the next prompt, so this - should be reflected in the UI. +The turn ended because the agent refused to continue. The user prompt +and everything that comes after it won't be included in the next +prompt, so this should be reflected in the UI. @@ -7920,9 +7569,10 @@ This stop reason MUST be returned when the client sends a `session/cancel` notification, even if the cancellation causes exceptions in underlying operations. Agents should catch these exceptions and return this semantically meaningful response to confirm successful cancellation. - + + ## StringFormat String format types for string properties in elicitation schemas. @@ -7930,21 +7580,23 @@ String format types for string properties in elicitation schemas. **Type:** Union - Email address format. +Email address format. - URI format. +URI format. - Date format (YYYY-MM-DD). +Date format (YYYY-MM-DD). - Date-time format (ISO 8601). +Date-time format (ISO 8601). + + ## StringPropertySchema Schema for string properties in an elicitation form. @@ -7962,7 +7614,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Default value. @@ -7980,13 +7631,11 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Maximum string length. - Minimum: `0` - Minimum string length. - Minimum: `0` - EnumOption[] | null} > Titled enum options for titled single-select enums. @@ -8016,7 +7665,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - TerminalId} required> Identifier of the terminal instance to embed in the content stream. @@ -8036,13 +7684,11 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - The process exit code (may be null if terminated by signal). - Minimum: `0` - The signal that terminated the process (may be null if exited normally). @@ -8068,7 +7714,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -8094,7 +7739,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Range | null} > The range of the document that changed. If `None`, the entire content is replaced. @@ -8110,13 +7754,15 @@ How the agent wants document changes delivered. **Type:** Union - Client sends the entire file content on each change. +Client sends the entire file content on each change. - Client sends only the changed ranges. +Client sends only the changed ranges. + + ## TextResourceContents Text-based resource contents. @@ -8131,7 +7777,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - MIME type describing the encoded media payload. @@ -8157,7 +7802,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - EnumOption[]} required> Titled enum options. @@ -8182,7 +7826,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ToolCallContent[]} > Content produced by the tool call. @@ -8233,7 +7876,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ContentBlock} required> The actual content block. @@ -8256,7 +7898,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - The new content after modification. @@ -8289,7 +7930,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - TerminalId} required> Identifier of the terminal instance to embed in the content stream. @@ -8301,6 +7941,8 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d + + ## ToolCallId Unique identifier for a tool call within a session. @@ -8326,13 +7968,11 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Optional line number within the file. - Minimum: `0` - The file path being accessed or modified. @@ -8349,22 +7989,24 @@ See protocol docs: [Status](https://agentclientprotocol.com/protocol/v1/draft/to **Type:** Union - The tool call hasn't started running yet because the input is either streaming - or we're awaiting approval. +The tool call hasn't started running yet because the input is either +streaming or we're awaiting approval. - The tool call is currently running. +The tool call is currently running. - The tool call completed successfully. +The tool call completed successfully. - The tool call failed with an error. +The tool call failed with an error. + + ## ToolCallUpdate An update to an existing tool call. @@ -8384,7 +8026,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ToolCallContent[] | null} > Replace the content collection. @@ -8423,45 +8064,47 @@ See protocol docs: [Creating](https://agentclientprotocol.com/protocol/v1/draft/ **Type:** Union - Reading files or data. +Reading files or data. - Modifying files or content. +Modifying files or content. - Removing files or data. +Removing files or data. - Moving or renaming files. +Moving or renaming files. - Searching for information. +Searching for information. - Running commands or code. +Running commands or code. - Internal reasoning or planning. +Internal reasoning or planning. - Retrieving external data. +Retrieving external data. - Switching the current session mode. +Switching the current session mode. - Other tool types (default). +Other tool types (default). + + ## UnstructuredCommandInput All text that was typed after the command name is provided as input. @@ -8476,7 +8119,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - A hint to display when the input hasn't been provided yet @@ -8496,7 +8138,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - "string"[]} required> Allowed enum values. @@ -8523,43 +8164,36 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Total cache read tokens. - Minimum: `0` - Total cache write tokens. - Minimum: `0` - Total input tokens across all turns. - Minimum: `0` - Total output tokens across all turns. - Minimum: `0` - Total thought/reasoning tokens - Minimum: `0` - Sum of all token types across session. - Minimum: `0` - ## UsageUpdate @@ -8576,7 +8210,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - Cost | null} > Cumulative session cost (optional). @@ -8585,13 +8218,11 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Total context window size in tokens. - Minimum: `0` - Tokens currently in context. - Minimum: `0` - ## WorkspaceFolder @@ -8608,7 +8239,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - The display name of the folder. @@ -8616,3 +8246,4 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d The URI of the folder. + diff --git a/docs/protocol/v1/schema.mdx b/docs/protocol/v1/schema.mdx index 65b4a2ed3..c617fbc2e 100644 --- a/docs/protocol/v1/schema.mdx +++ b/docs/protocol/v1/schema.mdx @@ -3,10 +3,7 @@ title: "Schema" description: "Schema definitions for the Agent Client Protocol" --- - - The schema file can be downloaded directly from the [latest GitHub - release](https://github.com/agentclientprotocol/agent-client-protocol/releases/latest/download/schema.json). - +The schema file can be downloaded directly from the [latest GitHub release](https://github.com/agentclientprotocol/agent-client-protocol/releases/latest/download/schema.json). ## Agent @@ -43,7 +40,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - AuthMethodId} required> The ID of the authentication method to use. @@ -64,7 +60,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - ### initialize @@ -72,7 +67,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e Establishes the connection with a client and negotiates protocol capabilities. This method is called once at the beginning of the connection to: - - Negotiate the protocol version to use - Exchange capability information between client and agent - Determine available authentication methods @@ -99,19 +93,16 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - ClientCapabilities} > Capabilities supported by the client. - Default: `{"fs":{"readTextFile":false,"writeTextFile":false},"terminal":false}` - Implementation | null} > Information about the Client name and version sent to the Agent. Note: in future versions of the protocol, this will be required. - ProtocolVersion} required> The latest protocol version supported by the client. @@ -135,32 +126,27 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - AgentCapabilities} > Capabilities supported by the agent. - Default: `{"loadSession":false,"promptCapabilities":{"image":false,"audio":false,"embeddedContext":false},"mcpCapabilities":{"http":false,"sse":false},"sessionCapabilities":{},"auth":{}}` - Implementation | null} > Information about the Agent name and version sent to the Client. Note: in future versions of the protocol, this will be required. - AuthMethod[]} > Authentication methods supported by the agent. - Default: `[]` - ProtocolVersion} required> The protocol version the client specified if supported by the agent, or the latest protocol version supported by the agent. The client should disconnect, if it doesn't support this version. - ### logout @@ -186,7 +172,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - #### LogoutResponse @@ -203,7 +188,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - @@ -214,7 +198,6 @@ Cancels ongoing operations for a session. This is a notification sent by the client to cancel an ongoing prompt turn. Upon receiving this notification, the Agent SHOULD: - - Stop all language model requests as soon as possible - Abort all tool call invocations in progress - Send any pending `session/update` notifications @@ -238,7 +221,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - SessionId} required> The ID of the session to cancel operations for. @@ -274,7 +256,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - SessionId} required> The ID of the session to close. @@ -294,7 +275,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - @@ -320,7 +300,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - SessionId} required> The ID of the session to delete. @@ -340,7 +319,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - @@ -368,7 +346,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - Opaque cursor token from a previous response's nextCursor field for cursor-based pagination @@ -391,7 +368,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - Opaque cursor token. If present, pass this in the next request's cursor parameter @@ -409,7 +385,6 @@ Loads an existing session to resume a previous conversation. This method is only available if the agent advertises the `loadSession` capability. The agent should: - - Restore the session context and conversation history - Connect to the specified MCP servers - Stream the entire conversation history back to the client via notifications @@ -434,7 +409,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - "string"[]} > Additional workspace roots to activate for this session. Each path must be absolute. @@ -443,7 +417,6 @@ When omitted or empty, no additional roots are activated. When non-empty, this is the complete resulting additional-root list for the loaded session. It may differ from any previously used or reported list as long as the request `cwd` matches the session's `cwd`. - The working directory for this session. @@ -469,7 +442,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - SessionConfigOption[] | null} > Initial session configuration options if supported by the Agent. @@ -478,7 +450,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e Initial mode state if supported by the Agent See protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/v1/session-modes) - @@ -489,7 +460,6 @@ Creates a new conversation session with the agent. Sessions represent independent conversation contexts with their own history and state. The agent should: - - Create a new session context - Connect to any specified MCP servers - Return a unique session ID for future requests @@ -514,7 +484,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - "string"[]} > Additional workspace roots for this session. Each path must be absolute. @@ -522,7 +491,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e These expand the session's filesystem scope without changing `cwd`, which remains the base for relative paths. When omitted or empty, no additional roots are activated for the new session. - The working directory for this session. Must be an absolute path. @@ -547,7 +515,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - SessionConfigOption[] | null} > Initial session configuration options if supported by the Agent. @@ -556,13 +523,11 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e Initial mode state if supported by the Agent See protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/v1/session-modes) - SessionId} required> Unique identifier for the created session. Used in all subsequent requests for this conversation. - @@ -571,7 +536,6 @@ Used in all subsequent requests for this conversation. Processes a user prompt within a session. This method handles the whole lifecycle of a prompt: - - Receives user messages with optional context (files, images, etc.) - Processes the prompt using language models - Reports language model content and tool calls to the Clients @@ -599,7 +563,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - ContentBlock[]} required> The blocks of content that compose the user's message. @@ -615,7 +578,6 @@ The client MAY include referenced pieces of context as either When available, `ContentBlock::Resource` is preferred as it avoids extra round-trips and allows the message to include pieces of context from sources the agent may not have access to. - SessionId} required> The ID of the session to send this user message to @@ -637,7 +599,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - StopReason} required> Indicates why the agent stopped processing the turn. @@ -672,7 +633,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - "string"[]} > Additional workspace roots to activate for this session. Each path must be absolute. @@ -681,7 +641,6 @@ When omitted or empty, no additional roots are activated. When non-empty, this is the complete resulting additional-root list for the resumed session. It may differ from any previously used or reported list as long as the request `cwd` matches the session's `cwd`. - The working directory for this session. @@ -707,7 +666,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - SessionConfigOption[] | null} > Initial session configuration options if supported by the Agent. @@ -716,7 +674,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e Initial mode state if supported by the Agent See protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/v1/session-modes) - @@ -738,7 +695,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - SessionConfigId} required> The ID of the configuration option to set. @@ -764,7 +720,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - SessionConfigOption[]} required> The full set of configuration options and their current values. @@ -801,7 +756,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - SessionModeId} required> The ID of the mode to set. @@ -824,7 +778,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - ## Client @@ -834,7 +787,6 @@ Defines the interface that ACP-compliant clients must implement. Clients are typically code editors (IDEs, text editors) that provide the interface between users and AI agents. They manage the environment, handle user interactions, and control access to resources. - ### fs/read_text_file @@ -861,19 +813,16 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - Maximum number of lines to read. - Minimum: `0` - Line number to start reading from (1-based). - Minimum: `0` - Absolute path to the file to read. @@ -896,7 +845,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - Content payload returned by this response. @@ -928,7 +876,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - The text content to write to the file. @@ -954,7 +901,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - @@ -989,7 +935,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - PermissionOption[]} required> Available permission options for the user to choose from. @@ -1015,7 +960,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - RequestPermissionOutcome} required> The user's decision on the permission request. @@ -1054,7 +998,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - SessionId} required> The ID of the session this update pertains to. @@ -1095,7 +1038,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - "string"[]} > Array of command arguments. @@ -1120,7 +1062,6 @@ string output, even if this means the retained output is slightly less than the specified limit. - Minimum: `0` - SessionId} required> The session ID for this request. @@ -1140,7 +1081,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - TerminalId} required> The unique identifier for the created terminal. @@ -1176,7 +1116,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - SessionId} required> The session ID for this request. @@ -1199,7 +1138,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - @@ -1226,7 +1164,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - SessionId} required> The session ID for this request. @@ -1249,7 +1186,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - TerminalExitStatus | null} > Exit status if the command has completed. @@ -1291,7 +1227,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - SessionId} required> The session ID for this request. @@ -1314,7 +1249,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - @@ -1338,7 +1272,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - SessionId} required> The session ID for this request. @@ -1361,13 +1294,11 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - The process exit code (may be null if terminated by signal). - Minimum: `0` - The signal that terminated the process (may be null if exited normally). @@ -1387,13 +1318,11 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - LogoutCapabilities | null} > Whether the agent supports the logout method. By supplying `\{\}` it means that the agent supports the logout method. - ## AgentCapabilities @@ -1415,37 +1344,31 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - AgentAuthCapabilities} > Authentication-related capabilities supported by the agent. - Default: `{}` - Whether the agent supports `session/load`. - Default: `false` - McpCapabilities} > MCP capabilities supported by the agent. - Default: `{"http":false,"sse":false}` - PromptCapabilities} > Prompt capabilities supported by the agent. - Default: `{"image":false,"audio":false,"embeddedContext":false}` - SessionCapabilities} > Session lifecycle and prompt capabilities advertised by the agent. - Default: `{}` - ## Annotations @@ -1462,7 +1385,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - Role[] | null} > Intended recipients for this content, such as the user or assistant. @@ -1488,7 +1410,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -1521,7 +1442,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - Optional description providing more details about this authentication method. @@ -1549,7 +1469,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - Optional description providing more details about this authentication method. @@ -1581,7 +1500,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - Human-readable description of what the command does. @@ -1609,7 +1527,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - A hint to display when the input hasn't been provided yet @@ -1629,7 +1546,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - AvailableCommand[]} required> Commands the agent can execute @@ -1649,7 +1565,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - Base64-encoded bytes for a binary resource payload. @@ -1680,20 +1595,17 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - FileSystemCapabilities} > File system capabilities supported by the client. Determines which file operations the agent can request. - Default: `{"readTextFile":false,"writeTextFile":false}` - Whether the Client support all `terminal/*` methods. - Default: `false` - ## ConfigOptionUpdate @@ -1710,7 +1622,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - SessionConfigOption[]} required> The full set of configuration options and their current values. @@ -1730,7 +1641,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - ContentBlock} required> The actual content block. @@ -1744,7 +1654,6 @@ They provide a structured way to handle various types of user-facing content—w it's text from language models, images for analysis, or embedded resources for context. Content blocks appear in: - - User prompts sent via `session/prompt` - Language model output streamed through `session/update` notifications - Progress updates and results from tool calls @@ -1770,7 +1679,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -1798,7 +1706,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -1832,7 +1739,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -1863,7 +1769,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -1908,7 +1813,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -1923,6 +1827,8 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e + + ## ContentChunk A streamed item of content @@ -1937,7 +1843,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - ContentBlock} required> A single item of content @@ -1947,7 +1852,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e All chunks belonging to the same message share the same `messageId`. A change in `messageId` indicates a new message has started. - ## Cost @@ -1964,7 +1868,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - Total cumulative cost for session. @@ -1989,7 +1892,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - SessionModeId} required> The ID of the current mode @@ -2013,7 +1915,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - The new content after modification. @@ -2039,7 +1940,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -2065,7 +1965,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - MIME type describing the encoded media payload. @@ -2091,7 +1990,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - Base64-encoded bytes for a binary resource payload. @@ -2106,6 +2004,8 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e + + ## EnvVariable An environment variable to set when launching an MCP server. @@ -2120,7 +2020,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - The name of the environment variable. @@ -2143,17 +2042,16 @@ See protocol docs: [JSON-RPC Error Object](https://www.jsonrpc.org/specification **Properties:** ErrorCode} required> - A number indicating the error type that occurred. This must be an integer as - defined in the JSON-RPC specification. + A number indicating the error type that occurred. +This must be an integer as defined in the JSON-RPC specification. - - Optional primitive or structured value that contains additional information - about the error. This may include debugging information or context-specific - details. + + Optional primitive or structured value that contains additional information about the error. +This may include debugging information or context-specific details. - A string providing a short description of the error. The message should be - limited to a concise single sentence. + A string providing a short description of the error. +The message should be limited to a concise single sentence. ## ErrorCode @@ -2166,40 +2064,41 @@ and use the reserved range (-32000 to -32099) for protocol-specific errors. **Type:** Union - **Parse error**: Invalid JSON was received by the server. An error occurred on - the server while parsing the JSON text. +**Parse error**: Invalid JSON was received by the server. +An error occurred on the server while parsing the JSON text. - **Invalid request**: The JSON sent is not a valid Request object. +**Invalid request**: The JSON sent is not a valid Request object. - **Method not found**: The method does not exist or is not available. +**Method not found**: The method does not exist or is not available. - **Invalid params**: Invalid method parameter(s). +**Invalid params**: Invalid method parameter(s). - **Internal error**: Internal JSON-RPC error. Reserved for - implementation-defined server errors. +**Internal error**: Internal JSON-RPC error. +Reserved for implementation-defined server errors. - **Authentication required**: Authentication is required before this operation - can be performed. +**Authentication required**: Authentication is required before this operation can be performed. - **Resource not found**: A given resource, such as a file, was not found. +**Resource not found**: A given resource, such as a file, was not found. - Other undefined error code. +Other undefined error code. + + ## ExtNotification Allows the Agent to send an arbitrary notification that is not part of the ACP spec. @@ -2208,6 +2107,7 @@ while maintaining protocol compatibility. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + ## ExtRequest Allows for sending an arbitrary request that is not part of the ACP spec. @@ -2216,6 +2116,7 @@ protocol compatibility. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + ## ExtResponse Allows for sending an arbitrary response to an `ExtRequest` that is not part of the ACP spec. @@ -2224,6 +2125,7 @@ protocol compatibility. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + ## FileSystemCapabilities File system capabilities that a client may support. @@ -2240,19 +2142,16 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - Whether the Client supports `fs/read_text_file` requests. - Default: `false` - Whether the Client supports `fs/write_text_file` requests. - Default: `false` - ## HttpHeader @@ -2269,7 +2168,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - The name of the HTTP header. @@ -2292,7 +2190,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -2323,7 +2220,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - Intended for programmatic or logical use, but can be used as a display @@ -2334,7 +2230,6 @@ name fallback if title isn’t present. and easily understood. If not provided, the name should be used for display. - Version of the implementation. Can be displayed to the user or used @@ -2357,7 +2252,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - ## McpCapabilities @@ -2374,19 +2268,16 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - Agent supports `McpServer::Http`. - Default: `false` - Agent supports `McpServer::Sse`. - Default: `false` - ## McpServer @@ -2413,7 +2304,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - HttpHeader[]} required> HTTP headers to set when making requests to the MCP server. @@ -2444,7 +2334,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - HttpHeader[]} required> HTTP headers to set when making requests to the MCP server. @@ -2475,7 +2364,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - "string"[]} required> Command-line arguments to pass to the MCP server. @@ -2493,6 +2381,8 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e + + ## McpServerHttp HTTP transport configuration for MCP. @@ -2507,7 +2397,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - HttpHeader[]} required> HTTP headers to set when making requests to the MCP server. @@ -2533,7 +2422,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - HttpHeader[]} required> HTTP headers to set when making requests to the MCP server. @@ -2559,7 +2447,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - "string"[]} required> Command-line arguments to pass to the MCP server. @@ -2594,7 +2481,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - PermissionOptionKind} required> Hint about the nature of this permission option. @@ -2621,21 +2507,23 @@ Helps clients choose appropriate icons and UI treatment. **Type:** Union - Allow this operation only this time. +Allow this operation only this time. - Allow this operation and remember the choice. +Allow this operation and remember the choice. - Reject this operation only this time. +Reject this operation only this time. - Reject this operation and remember the choice. +Reject this operation and remember the choice. + + ## Plan An execution plan for accomplishing complex tasks. @@ -2656,14 +2544,12 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - PlanEntry[]} required> The list of tasks to be accomplished. When updating a plan, the agent must send a complete list of all entries with their current status. The client replaces the entire plan with each update. - ## PlanEntry @@ -2684,7 +2570,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - Human-readable description of what this task aims to accomplish. @@ -2708,17 +2593,19 @@ See protocol docs: [Plan Entries](https://agentclientprotocol.com/protocol/v1/ag **Type:** Union - High priority task - critical to the overall goal. +High priority task - critical to the overall goal. - Medium priority task - important but not critical. +Medium priority task - important but not critical. - Low priority task - nice to have but not essential. +Low priority task - nice to have but not essential. + + ## PlanEntryStatus Status of a plan entry in the execution flow. @@ -2729,17 +2616,19 @@ See protocol docs: [Plan Entries](https://agentclientprotocol.com/protocol/v1/ag **Type:** Union - The task has not started yet. +The task has not started yet. - The task is currently being worked on. +The task is currently being worked on. - The task has been successfully completed. +The task has been successfully completed. + + ## PromptCapabilities Prompt capabilities supported by the agent in `session/prompt` requests. @@ -2765,13 +2654,11 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - Agent supports `ContentBlock::Audio`. - Default: `false` - Agent supports embedded context in `session/prompt` requests. @@ -2780,13 +2667,11 @@ When enabled, the Client is allowed to include `ContentBlock::Resource` in prompt requests for pieces of context that are referenced in the message. - Default: `false` - Agent supports `ContentBlock::Image`. - Default: `false` - ## ProtocolVersion @@ -2798,10 +2683,10 @@ Non-breaking changes should be introduced via capabilities. **Type:** `integer (uint16)` -| Constraint | Value | -| ---------- | ------- | -| Minimum | `0` | -| Maximum | `65535` | +| Constraint | Value | +| ---------- | ----- | +| Minimum | `0` | +| Maximum | `65535` | ## RequestId @@ -2818,17 +2703,19 @@ The Server MUST reply with the same value in the Response object if included. Th **Type:** Union - The JSON-RPC `null` request id. +The JSON-RPC `null` request id. - A numeric JSON-RPC request id. +A numeric JSON-RPC request id. - A string JSON-RPC request id. +A string JSON-RPC request id. + + ## RequestPermissionOutcome The outcome of a permission request. @@ -2864,7 +2751,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - PermissionOptionId} required> The ID of the option the user selected. @@ -2876,6 +2762,8 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e + + ## ResourceLink A resource that the server is capable of reading, included in a prompt or tool call result. @@ -2890,7 +2778,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -2921,13 +2808,15 @@ The sender or recipient of messages and data in a conversation. **Type:** Union - The assistant side of a conversation. +The assistant side of a conversation. - The user side of a conversation. +The user side of a conversation. + + ## SelectedPermissionOutcome The user selected one of the provided options. @@ -2942,7 +2831,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - PermissionOptionId} required> The ID of the option the user selected. @@ -2967,7 +2855,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - ## SessionCapabilities @@ -2992,7 +2879,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - SessionAdditionalDirectoriesCapabilities | null} > Whether the agent supports `additionalDirectories` on supported session lifecycle requests. @@ -3000,7 +2886,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e Agents that also support `session/list` may return `SessionInfo.additionalDirectories` to report the complete ordered additional-root list associated with a listed session. - SessionCloseCapabilities | null} > Whether the agent supports `session/close`. @@ -3010,7 +2895,6 @@ additional-root list associated with a listed session. Optional. Omitted or `null` both mean the agent does not advertise support. Supplying `\{\}` means the agent supports deleting sessions from `session/list`. - SessionListCapabilities | null} > Whether the agent supports `session/list`. @@ -3035,7 +2919,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - ## SessionConfigGroupId @@ -3060,18 +2943,10 @@ Single-value selector (dropdown). **Properties:** -SessionConfigValueId} - required -> +SessionConfigValueId} required> The currently selected value. -SessionConfigSelectOptions} - required -> +SessionConfigSelectOptions} required> The set of selectable options. @@ -3093,25 +2968,27 @@ Category names that do not begin with `_` are reserved for the ACP spec. **Type:** Union - Session mode selector. +Session mode selector. - Model selector. +Model selector. - Model-related configuration parameter. +Model-related configuration parameter. - Thought/reasoning level selector. +Thought/reasoning level selector. - Unknown / uncategorized selector. +Unknown / uncategorized selector. + + ## SessionConfigSelect A single-value selector (dropdown) session configuration option payload. @@ -3120,18 +2997,10 @@ A single-value selector (dropdown) session configuration option payload. **Properties:** -SessionConfigValueId} - required -> +SessionConfigValueId} required> The currently selected value. -SessionConfigSelectOptions} - required -> +SessionConfigSelectOptions} required> The set of selectable options. @@ -3149,7 +3018,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - SessionConfigGroupId} required> Unique identifier for this group. @@ -3175,7 +3043,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - Optional description for this option value. @@ -3194,13 +3061,15 @@ Possible values for a session configuration option. **Type:** Union - A flat list of options with no grouping. +A flat list of options with no grouping. - A list of options grouped under headers. +A list of options grouped under headers. + + ## SessionConfigValueId Unique identifier for a session configuration option value. @@ -3223,7 +3092,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - ## SessionId @@ -3251,7 +3119,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - "string"[]} > Additional workspace roots reported for this session. Each path must be absolute. @@ -3259,7 +3126,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e When present, this is the complete ordered additional-root list reported by the Agent. Omitted and empty values are equivalent: the response reports no additional roots. - The working directory for this session. Must be an absolute path. @@ -3291,7 +3157,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - Human-readable title for the session. Set to null to clear. @@ -3316,7 +3181,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - ## SessionMode @@ -3335,7 +3199,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - Optional human-readable details shown with this protocol object. @@ -3367,7 +3230,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - SessionMode[]} required> The set of modes that the Agent can operate in @@ -3392,7 +3254,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - ## SessionUpdate @@ -3416,7 +3277,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - ContentBlock} required> A single item of content @@ -3426,7 +3286,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e All chunks belonging to the same message share the same `messageId`. A change in `messageId` indicates a new message has started. - The discriminator value. Must be `"user_message_chunk"`. @@ -3446,7 +3305,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - ContentBlock} required> A single item of content @@ -3456,7 +3314,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e All chunks belonging to the same message share the same `messageId`. A change in `messageId` indicates a new message has started. - The discriminator value. Must be `"agent_message_chunk"`. @@ -3476,7 +3333,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - ContentBlock} required> A single item of content @@ -3486,7 +3342,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e All chunks belonging to the same message share the same `messageId`. A change in `messageId` indicates a new message has started. - The discriminator value. Must be `"agent_thought_chunk"`. @@ -3506,7 +3361,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - ToolCallContent[]} > Content produced by the tool call. @@ -3552,7 +3406,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - ToolCallContent[] | null} > Replace the content collection. @@ -3597,14 +3450,12 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - PlanEntry[]} required> The list of tasks to be accomplished. When updating a plan, the agent must send a complete list of all entries with their current status. The client replaces the entire plan with each update. - The discriminator value. Must be `"plan"`. @@ -3624,7 +3475,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - AvailableCommand[]} required> Commands the agent can execute @@ -3649,7 +3499,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - SessionModeId} required> The ID of the current mode @@ -3672,7 +3521,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - SessionConfigOption[]} required> The full set of configuration options and their current values. @@ -3695,7 +3543,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - The discriminator value. Must be `"session_info_update"`. @@ -3721,7 +3568,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - Cost | null} > Cumulative session cost (optional). @@ -3733,18 +3579,18 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e Total context window size in tokens. - Minimum: `0` - Tokens currently in context. - Minimum: `0` - + + ## StopReason Reasons why an agent stops processing a prompt turn. @@ -3754,22 +3600,22 @@ See protocol docs: [Stop Reasons](https://agentclientprotocol.com/protocol/v1/pr **Type:** Union - The turn ended successfully. +The turn ended successfully. - The turn ended because the agent reached the maximum number of tokens. +The turn ended because the agent reached the maximum number of tokens. - The turn ended because the agent reached the maximum number of allowed agent - requests between user turns. +The turn ended because the agent reached the maximum number of allowed +agent requests between user turns. - The turn ended because the agent refused to continue. The user prompt and - everything that comes after it won't be included in the next prompt, so this - should be reflected in the UI. +The turn ended because the agent refused to continue. The user prompt +and everything that comes after it won't be included in the next +prompt, so this should be reflected in the UI. @@ -3779,9 +3625,10 @@ This stop reason MUST be returned when the client sends a `session/cancel` notification, even if the cancellation causes exceptions in underlying operations. Agents should catch these exceptions and return this semantically meaningful response to confirm successful cancellation. - + + ## Terminal Embed a terminal created with `terminal/create` by its id. @@ -3800,7 +3647,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - TerminalId} required> Identifier of the terminal instance to embed in the content stream. @@ -3820,13 +3666,11 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - The process exit code (may be null if terminated by signal). - Minimum: `0` - The signal that terminated the process (may be null if exited normally). @@ -3852,7 +3696,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -3875,7 +3718,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - MIME type describing the encoded media payload. @@ -3906,7 +3748,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - ToolCallContent[]} > Content produced by the tool call. @@ -3957,7 +3798,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - ContentBlock} required> The actual content block. @@ -3980,7 +3820,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - The new content after modification. @@ -4013,7 +3852,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - TerminalId} required> Identifier of the terminal instance to embed in the content stream. @@ -4025,6 +3863,8 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e + + ## ToolCallId Unique identifier for a tool call within a session. @@ -4050,13 +3890,11 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - Optional line number within the file. - Minimum: `0` - The file path being accessed or modified. @@ -4073,22 +3911,24 @@ See protocol docs: [Status](https://agentclientprotocol.com/protocol/v1/tool-cal **Type:** Union - The tool call hasn't started running yet because the input is either streaming - or we're awaiting approval. +The tool call hasn't started running yet because the input is either +streaming or we're awaiting approval. - The tool call is currently running. +The tool call is currently running. - The tool call completed successfully. +The tool call completed successfully. - The tool call failed with an error. +The tool call failed with an error. + + ## ToolCallUpdate An update to an existing tool call. @@ -4108,7 +3948,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - ToolCallContent[] | null} > Replace the content collection. @@ -4147,45 +3986,47 @@ See protocol docs: [Creating](https://agentclientprotocol.com/protocol/v1/tool-c **Type:** Union - Reading files or data. +Reading files or data. - Modifying files or content. +Modifying files or content. - Removing files or data. +Removing files or data. - Moving or renaming files. +Moving or renaming files. - Searching for information. +Searching for information. - Running commands or code. +Running commands or code. - Internal reasoning or planning. +Internal reasoning or planning. - Retrieving external data. +Retrieving external data. - Switching the current session mode. +Switching the current session mode. - Other tool types (default). +Other tool types (default). + + ## UnstructuredCommandInput All text that was typed after the command name is provided as input. @@ -4200,7 +4041,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - A hint to display when the input hasn't been provided yet @@ -4220,7 +4060,6 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - Cost | null} > Cumulative session cost (optional). @@ -4229,11 +4068,10 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e Total context window size in tokens. - Minimum: `0` - Tokens currently in context. - Minimum: `0` - + diff --git a/docs/protocol/v2/draft/schema.mdx b/docs/protocol/v2/draft/schema.mdx index fb97ac14f..63ed28c7a 100644 --- a/docs/protocol/v2/draft/schema.mdx +++ b/docs/protocol/v2/draft/schema.mdx @@ -2005,7 +2005,7 @@ stop reason. See protocol docs: [Agent Reports Output](https://agentclientprotocol.com/protocol/v2/draft/prompt-lifecycle#3-agent-reports-output) -#### SessionNotification +#### SessionUpdateNotification Notification containing a session update from the agent. diff --git a/docs/protocol/v2/schema.mdx b/docs/protocol/v2/schema.mdx index d8446541b..4e45e2bca 100644 --- a/docs/protocol/v2/schema.mdx +++ b/docs/protocol/v2/schema.mdx @@ -839,7 +839,7 @@ stop reason. See protocol docs: [Agent Reports Output](https://agentclientprotocol.com/protocol/v2/prompt-lifecycle#3-agent-reports-output) -#### SessionNotification +#### SessionUpdateNotification Notification containing a session update from the agent. diff --git a/schema/v1/meta.json b/schema/v1/meta.json index 9281f19f3..12e2733db 100644 --- a/schema/v1/meta.json +++ b/schema/v1/meta.json @@ -26,4 +26,4 @@ "terminal_wait_for_exit": "terminal/wait_for_exit", "terminal_kill": "terminal/kill" } -} +} \ No newline at end of file diff --git a/schema/v1/meta.unstable.json b/schema/v1/meta.unstable.json index d8937f384..ddb9475d3 100644 --- a/schema/v1/meta.unstable.json +++ b/schema/v1/meta.unstable.json @@ -49,4 +49,4 @@ "protocolMethods": { "cancel_request": "$/cancel_request" } -} +} \ No newline at end of file diff --git a/schema/v1/schema.json b/schema/v1/schema.json index 6d1baa89c..3588c089f 100644 --- a/schema/v1/schema.json +++ b/schema/v1/schema.json @@ -9,10 +9,14 @@ "properties": { "jsonrpc": { "type": "string", - "enum": ["2.0"] + "enum": [ + "2.0" + ] } }, - "required": ["jsonrpc"], + "required": [ + "jsonrpc" + ], "anyOf": [ { "title": "Request", @@ -47,10 +51,14 @@ "properties": { "jsonrpc": { "type": "string", - "enum": ["2.0"] + "enum": [ + "2.0" + ] } }, - "required": ["jsonrpc"], + "required": [ + "jsonrpc" + ], "anyOf": [ { "title": "Request", @@ -191,7 +199,10 @@ ] } }, - "required": ["id", "method"], + "required": [ + "id", + "method" + ], "x-docs-ignore": true }, "RequestId": { @@ -237,12 +248,19 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "path", "content"], + "required": [ + "sessionId", + "path", + "content" + ], "x-side": "client", "x-method": "fs/write_text_file" }, @@ -268,26 +286,38 @@ }, "line": { "description": "Line number to start reading from (1-based).", - "type": ["integer", "null"], + "type": [ + "integer", + "null" + ], "format": "uint32", "minimum": 0, "x-deserialize-default-on-error": true }, "limit": { "description": "Maximum number of lines to read.", - "type": ["integer", "null"], + "type": [ + "integer", + "null" + ], "format": "uint32", "minimum": 0, "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "path"], + "required": [ + "sessionId", + "path" + ], "x-side": "client", "x-method": "fs/read_text_file" }, @@ -322,12 +352,19 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "toolCall", "options"], + "required": [ + "sessionId", + "toolCall", + "options" + ], "x-side": "client", "x-method": "session/request_permission" }, @@ -369,12 +406,18 @@ }, "title": { "description": "Update the human-readable title.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "content": { "description": "Replace the content collection.", - "type": ["array", "null"], + "type": [ + "array", + "null" + ], "items": { "$ref": "#/$defs/ToolCallContent" }, @@ -383,7 +426,10 @@ }, "locations": { "description": "Replace the locations collection.", - "type": ["array", "null"], + "type": [ + "array", + "null" + ], "items": { "$ref": "#/$defs/ToolCallLocation" }, @@ -400,12 +446,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["toolCallId"] + "required": [ + "toolCallId" + ] }, "ToolCallId": { "description": "Unique identifier for a tool call within a session.", @@ -503,7 +554,9 @@ "const": "content" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/Content" @@ -519,7 +572,9 @@ "const": "diff" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/Diff" @@ -535,7 +590,9 @@ "const": "terminal" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/Terminal" @@ -559,7 +616,9 @@ "const": "text" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/TextContent" @@ -575,7 +634,9 @@ "const": "image" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/ImageContent" @@ -591,7 +652,9 @@ "const": "audio" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/AudioContent" @@ -607,7 +670,9 @@ "const": "resource_link" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/ResourceLink" @@ -623,7 +688,9 @@ "const": "resource" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/EmbeddedResource" @@ -641,7 +708,10 @@ "properties": { "audience": { "description": "Intended recipients for this content, such as the user or assistant.", - "type": ["array", "null"], + "type": [ + "array", + "null" + ], "items": { "$ref": "#/$defs/Role" }, @@ -650,18 +720,27 @@ }, "lastModified": { "description": "Timestamp indicating when the underlying resource was last modified.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "priority": { "description": "Relative importance of this content when clients choose what to surface.", - "type": ["number", "null"], + "type": [ + "number", + "null" + ], "format": "double", "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -704,12 +783,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["text"] + "required": [ + "text" + ] }, "ImageContent": { "description": "An image provided to or from an LLM.", @@ -737,17 +821,26 @@ }, "uri": { "description": "URI associated with this resource or media payload.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["data", "mimeType"] + "required": [ + "data", + "mimeType" + ] }, "AudioContent": { "description": "Audio provided to or from an LLM.", @@ -775,12 +868,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["data", "mimeType"] + "required": [ + "data", + "mimeType" + ] }, "ResourceLink": { "description": "A resource that the server is capable of reading, included in a prompt or tool call result.", @@ -800,12 +899,18 @@ }, "description": { "description": "Optional human-readable details shown with this protocol object.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "mimeType": { "description": "MIME type describing the encoded media payload.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "name": { @@ -814,13 +919,19 @@ }, "size": { "description": "Optional size of the linked resource in bytes, if known.", - "type": ["integer", "null"], + "type": [ + "integer", + "null" + ], "format": "int64", "x-deserialize-default-on-error": true }, "title": { "description": "Optional display title for end-user UI.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "uri": { @@ -829,12 +940,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["name", "uri"] + "required": [ + "name", + "uri" + ] }, "EmbeddedResourceResource": { "description": "Resource content that can be embedded in a message.", @@ -865,7 +982,10 @@ "properties": { "mimeType": { "description": "MIME type describing the encoded media payload.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "text": { @@ -878,12 +998,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["text", "uri"] + "required": [ + "text", + "uri" + ] }, "BlobResourceContents": { "description": "Binary resource contents.", @@ -895,7 +1021,10 @@ }, "mimeType": { "description": "MIME type describing the encoded media payload.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "uri": { @@ -904,12 +1033,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["blob", "uri"] + "required": [ + "blob", + "uri" + ] }, "EmbeddedResource": { "description": "The contents of a resource, embedded into a prompt or tool call result.", @@ -937,12 +1072,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["resource"] + "required": [ + "resource" + ] }, "Content": { "description": "Standard content block (text, images, resources).", @@ -958,12 +1098,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["content"] + "required": [ + "content" + ] }, "Diff": { "description": "A diff representing file modifications.\n\nShows changes to files in a format suitable for display in the client UI.\n\nSee protocol docs: [Content](https://agentclientprotocol.com/protocol/tool-calls#content)", @@ -975,7 +1120,10 @@ }, "oldText": { "description": "The original content (None for new files).", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "newText": { @@ -984,12 +1132,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["path", "newText"] + "required": [ + "path", + "newText" + ] }, "TerminalId": { "description": "Typed identifier used for terminal values on the wire.", @@ -1009,12 +1163,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["terminalId"] + "required": [ + "terminalId" + ] }, "ToolCallLocation": { "description": "A file location being accessed or modified by a tool.\n\nEnables clients to implement \"follow-along\" features that track\nwhich files the agent is working with in real-time.\n\nSee protocol docs: [Following the Agent](https://agentclientprotocol.com/protocol/tool-calls#following-the-agent)", @@ -1026,19 +1185,27 @@ }, "line": { "description": "Optional line number within the file.", - "type": ["integer", "null"], + "type": [ + "integer", + "null" + ], "format": "uint32", "minimum": 0, "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["path"] + "required": [ + "path" + ] }, "PermissionOption": { "description": "An option presented to the user when requesting permission.", @@ -1066,12 +1233,19 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["optionId", "name", "kind"] + "required": [ + "optionId", + "name", + "kind" + ] }, "PermissionOptionId": { "description": "Unique identifier for a permission option.", @@ -1138,24 +1312,36 @@ }, "cwd": { "description": "Working directory for the command (absolute path).", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "outputByteLimit": { "description": "Maximum number of output bytes to retain.\n\nWhen the limit is exceeded, the Client truncates from the beginning of the output\nto stay within the limit.\n\nThe Client MUST ensure truncation happens at a character boundary to maintain valid\nstring output, even if this means the retained output is slightly less than the\nspecified limit.", - "type": ["integer", "null"], + "type": [ + "integer", + "null" + ], "format": "uint64", "minimum": 0, "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "command"], + "required": [ + "sessionId", + "command" + ], "x-side": "client", "x-method": "terminal/create" }, @@ -1173,12 +1359,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["name", "value"] + "required": [ + "name", + "value" + ] }, "TerminalOutputRequest": { "description": "Request to get the current output and status of a terminal.", @@ -1202,12 +1394,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "terminalId"], + "required": [ + "sessionId", + "terminalId" + ], "x-side": "client", "x-method": "terminal/output" }, @@ -1233,12 +1431,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "terminalId"], + "required": [ + "sessionId", + "terminalId" + ], "x-side": "client", "x-method": "terminal/release" }, @@ -1264,12 +1468,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "terminalId"], + "required": [ + "sessionId", + "terminalId" + ], "x-side": "client", "x-method": "terminal/wait_for_exit" }, @@ -1295,12 +1505,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "terminalId"], + "required": [ + "sessionId", + "terminalId" + ], "x-side": "client", "x-method": "terminal/kill" }, @@ -1446,7 +1662,10 @@ ] } }, - "required": ["id", "result"] + "required": [ + "id", + "result" + ] }, { "title": "Error", @@ -1470,7 +1689,10 @@ ] } }, - "required": ["id", "error"] + "required": [ + "id", + "error" + ] } ], "x-docs-ignore": true @@ -1534,12 +1756,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["protocolVersion"], + "required": [ + "protocolVersion" + ], "x-side": "agent", "x-method": "initialize" }, @@ -1609,7 +1836,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1639,7 +1869,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1663,7 +1896,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1735,7 +1971,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1747,7 +1986,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1759,7 +2001,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1771,7 +2016,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1783,7 +2031,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1795,7 +2046,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1819,7 +2073,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1831,7 +2088,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1869,17 +2129,26 @@ }, "description": { "description": "Optional description providing more details about this authentication method.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["id", "name"] + "required": [ + "id", + "name" + ] }, "AuthMethodId": { "description": "Typed identifier used for auth method values on the wire.", @@ -1895,7 +2164,10 @@ }, "title": { "description": "Intended for UI and end-user contexts — optimized to be human-readable\nand easily understood.\n\nIf not provided, the name should be used for display.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "version": { @@ -1904,12 +2176,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["name", "version"] + "required": [ + "name", + "version" + ] }, "AuthenticateResponse": { "description": "Response to the `authenticate` method.", @@ -1917,7 +2195,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1931,7 +2212,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1965,7 +2249,10 @@ }, "configOptions": { "description": "Initial session configuration options if supported by the Agent.", - "type": ["array", "null"], + "type": [ + "array", + "null" + ], "items": { "$ref": "#/$defs/SessionConfigOption" }, @@ -1974,12 +2261,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId"], + "required": [ + "sessionId" + ], "x-side": "agent", "x-method": "session/new" }, @@ -2006,12 +2298,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["currentModeId", "availableModes"] + "required": [ + "currentModeId", + "availableModes" + ] }, "SessionModeId": { "description": "Unique identifier for a Session Mode.", @@ -2035,17 +2333,26 @@ }, "description": { "description": "Optional human-readable details shown with this protocol object.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["id", "name"] + "required": [ + "id", + "name" + ] }, "SessionConfigOption": { "description": "A session configuration option selector and its current state.", @@ -2065,7 +2372,10 @@ }, "description": { "description": "Optional description for the Client to display to the user.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "category": { @@ -2082,12 +2392,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["id", "name"], + "required": [ + "id", + "name" + ], "oneOf": [ { "description": "Single-value selector (dropdown).", @@ -2098,7 +2414,9 @@ "const": "select" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/SessionConfigSelect" @@ -2187,17 +2505,26 @@ }, "description": { "description": "Optional description for this option value.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["value", "name"] + "required": [ + "value", + "name" + ] }, "SessionConfigSelectGroup": { "description": "A group of possible values for a session configuration option.", @@ -2226,12 +2553,19 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["group", "name", "options"] + "required": [ + "group", + "name", + "options" + ] }, "SessionConfigGroupId": { "description": "Unique identifier for a session configuration option value group.", @@ -2258,7 +2592,10 @@ ] } }, - "required": ["currentValue", "options"] + "required": [ + "currentValue", + "options" + ] }, "LoadSessionResponse": { "description": "Response from loading an existing session.", @@ -2278,7 +2615,10 @@ }, "configOptions": { "description": "Initial session configuration options if supported by the Agent.", - "type": ["array", "null"], + "type": [ + "array", + "null" + ], "items": { "$ref": "#/$defs/SessionConfigOption" }, @@ -2287,7 +2627,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2310,17 +2653,25 @@ }, "nextCursor": { "description": "Opaque cursor token. If present, pass this in the next request's cursor parameter\nto fetch the next page. If absent, there are no more results.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessions"], + "required": [ + "sessions" + ], "x-side": "agent", "x-method": "session/list" }, @@ -2351,22 +2702,34 @@ }, "title": { "description": "Human-readable title for the session", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "updatedAt": { "description": "ISO 8601 timestamp of last activity", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "cwd"] + "required": [ + "sessionId", + "cwd" + ] }, "DeleteSessionResponse": { "description": "Response from deleting a session.", @@ -2374,7 +2737,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2400,7 +2766,10 @@ }, "configOptions": { "description": "Initial session configuration options if supported by the Agent.", - "type": ["array", "null"], + "type": [ + "array", + "null" + ], "items": { "$ref": "#/$defs/SessionConfigOption" }, @@ -2409,7 +2778,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2423,7 +2795,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2437,7 +2812,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2460,12 +2838,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["configOptions"], + "required": [ + "configOptions" + ], "x-side": "agent", "x-method": "session/set_config_option" }, @@ -2483,12 +2866,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["stopReason"], + "required": [ + "stopReason" + ], "x-side": "agent", "x-method": "session/prompt" }, @@ -2546,7 +2934,10 @@ "x-deserialize-default-on-error": true } }, - "required": ["code", "message"] + "required": [ + "code", + "message" + ] }, "ErrorCode": { "description": "Predefined error codes for common JSON-RPC and ACP-specific errors.\n\nThese codes follow the JSON-RPC 2.0 specification for standard errors\nand use the reserved range (-32000 to -32099) for protocol-specific errors.", @@ -2648,7 +3039,9 @@ ] } }, - "required": ["method"], + "required": [ + "method" + ], "x-docs-ignore": true }, "SessionNotification": { @@ -2673,12 +3066,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "update"], + "required": [ + "sessionId", + "update" + ], "x-side": "client", "x-method": "session/update" }, @@ -2694,7 +3093,9 @@ "const": "user_message_chunk" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/ContentChunk" @@ -2710,7 +3111,9 @@ "const": "agent_message_chunk" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/ContentChunk" @@ -2726,7 +3129,9 @@ "const": "agent_thought_chunk" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/ContentChunk" @@ -2742,7 +3147,9 @@ "const": "tool_call" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/ToolCall" @@ -2758,7 +3165,9 @@ "const": "tool_call_update" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/ToolCallUpdate" @@ -2774,7 +3183,9 @@ "const": "plan" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/Plan" @@ -2790,7 +3201,9 @@ "const": "available_commands_update" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/AvailableCommandsUpdate" @@ -2806,7 +3219,9 @@ "const": "current_mode_update" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/CurrentModeUpdate" @@ -2822,7 +3237,9 @@ "const": "config_option_update" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/ConfigOptionUpdate" @@ -2838,7 +3255,9 @@ "const": "session_info_update" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/SessionInfoUpdate" @@ -2854,7 +3273,9 @@ "const": "usage_update" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/UsageUpdate" @@ -2896,12 +3317,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["content"] + "required": [ + "content" + ] }, "ToolCall": { "description": "Represents a tool call that the language model has requested.\n\nTool calls are actions that the agent executes on behalf of the language model,\nsuch as reading files, executing code, or fetching data from external sources.\n\nSee protocol docs: [Tool Calls](https://agentclientprotocol.com/protocol/tool-calls)", @@ -2965,12 +3391,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["toolCallId", "title"] + "required": [ + "toolCallId", + "title" + ] }, "PlanEntry": { "description": "A single entry in the execution plan.\n\nRepresents a task or goal that the assistant intends to accomplish\nas part of fulfilling the user's request.\nSee protocol docs: [Plan Entries](https://agentclientprotocol.com/protocol/agent-plan#plan-entries)", @@ -2998,12 +3430,19 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["content", "priority", "status"] + "required": [ + "content", + "priority", + "status" + ] }, "PlanEntryPriority": { "description": "Priority levels for plan entries.\n\nUsed to indicate the relative importance or urgency of different\ntasks in the execution plan.\nSee protocol docs: [Plan Entries](https://agentclientprotocol.com/protocol/agent-plan#plan-entries)", @@ -3060,12 +3499,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["entries"] + "required": [ + "entries" + ] }, "AvailableCommand": { "description": "Information about a command.", @@ -3093,12 +3537,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["name", "description"] + "required": [ + "name", + "description" + ] }, "AvailableCommandInput": { "description": "The input specification for a command.", @@ -3124,12 +3574,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["hint"] + "required": [ + "hint" + ] }, "AvailableCommandsUpdate": { "description": "Available commands are ready or have changed", @@ -3146,12 +3601,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["availableCommands"] + "required": [ + "availableCommands" + ] }, "CurrentModeUpdate": { "description": "The current mode of the session has changed\n\nSee protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/session-modes)", @@ -3167,12 +3627,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["currentModeId"] + "required": [ + "currentModeId" + ] }, "ConfigOptionUpdate": { "description": "Session configuration options have been updated.", @@ -3189,12 +3654,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["configOptions"] + "required": [ + "configOptions" + ] }, "SessionInfoUpdate": { "description": "Update to session metadata. All fields are optional to support partial updates.\n\nAgents send this notification to update session information like title or custom metadata.\nThis allows clients to display dynamic session names and track session state changes.", @@ -3202,17 +3672,26 @@ "properties": { "title": { "description": "Human-readable title for the session. Set to null to clear.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "updatedAt": { "description": "ISO 8601 timestamp of last activity. Set to null to clear.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3233,12 +3712,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["amount", "currency"] + "required": [ + "amount", + "currency" + ] }, "UsageUpdate": { "description": "Context window and cost update for a session.", @@ -3270,12 +3755,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["used", "size"] + "required": [ + "used", + "size" + ] }, "ExtNotification": { "description": "Allows the Agent to send an arbitrary notification that is not part of the ACP spec.\nExtension notifications provide a way to send one-way messages for custom functionality\nwhile maintaining protocol compatibility.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)" @@ -3427,7 +3918,10 @@ ] } }, - "required": ["id", "method"], + "required": [ + "id", + "method" + ], "x-docs-ignore": true }, "InitializeRequest": { @@ -3472,12 +3966,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["protocolVersion"], + "required": [ + "protocolVersion" + ], "x-side": "agent", "x-method": "initialize" }, @@ -3506,7 +4005,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3530,7 +4032,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3550,12 +4055,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["methodId"], + "required": [ + "methodId" + ], "x-side": "agent", "x-method": "authenticate" }, @@ -3565,7 +4075,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3601,12 +4114,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["cwd", "mcpServers"], + "required": [ + "cwd", + "mcpServers" + ], "x-side": "agent", "x-method": "session/new" }, @@ -3622,7 +4141,9 @@ "const": "http" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/McpServerHttp" @@ -3638,7 +4159,9 @@ "const": "sse" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/McpServerSse" @@ -3670,12 +4193,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["name", "value"] + "required": [ + "name", + "value" + ] }, "McpServerHttp": { "description": "HTTP transport configuration for MCP.", @@ -3700,12 +4229,19 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["name", "url", "headers"] + "required": [ + "name", + "url", + "headers" + ] }, "McpServerSse": { "description": "SSE transport configuration for MCP.", @@ -3730,12 +4266,19 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["name", "url", "headers"] + "required": [ + "name", + "url", + "headers" + ] }, "McpServerStdio": { "description": "Stdio transport configuration for MCP.", @@ -3769,12 +4312,20 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["name", "command", "args", "env"] + "required": [ + "name", + "command", + "args", + "env" + ] }, "LoadSessionRequest": { "description": "Request parameters for loading an existing session.\n\nOnly available if the Agent supports the `loadSession` capability.\n\nSee protocol docs: [Loading Sessions](https://agentclientprotocol.com/protocol/session-setup#loading-sessions)", @@ -3812,12 +4363,19 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["mcpServers", "cwd", "sessionId"], + "required": [ + "mcpServers", + "cwd", + "sessionId" + ], "x-side": "agent", "x-method": "session/load" }, @@ -3827,17 +4385,26 @@ "properties": { "cwd": { "description": "Filter sessions by working directory. Must be an absolute path.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "cursor": { "description": "Opaque cursor token from a previous response's nextCursor field for cursor-based pagination", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3859,12 +4426,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId"], + "required": [ + "sessionId" + ], "x-side": "agent", "x-method": "session/delete" }, @@ -3904,12 +4476,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "cwd"], + "required": [ + "sessionId", + "cwd" + ], "x-side": "agent", "x-method": "session/resume" }, @@ -3927,12 +4505,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId"], + "required": [ + "sessionId" + ], "x-side": "agent", "x-method": "session/close" }, @@ -3958,12 +4541,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "modeId"], + "required": [ + "sessionId", + "modeId" + ], "x-side": "agent", "x-method": "session/set_mode" }, @@ -3997,12 +4586,19 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "configId", "value"], + "required": [ + "sessionId", + "configId", + "value" + ], "x-side": "agent", "x-method": "session/set_config_option" }, @@ -4029,12 +4625,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "prompt"], + "required": [ + "sessionId", + "prompt" + ], "x-side": "agent", "x-method": "session/prompt" }, @@ -4141,7 +4743,10 @@ ] } }, - "required": ["id", "result"] + "required": [ + "id", + "result" + ] }, { "title": "Error", @@ -4165,7 +4770,10 @@ ] } }, - "required": ["id", "error"] + "required": [ + "id", + "error" + ] } ], "x-docs-ignore": true @@ -4176,7 +4784,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -4194,12 +4805,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["content"], + "required": [ + "content" + ], "x-side": "client", "x-method": "fs/read_text_file" }, @@ -4217,12 +4833,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["outcome"], + "required": [ + "outcome" + ], "x-side": "client", "x-method": "session/request_permission" }, @@ -4238,7 +4859,9 @@ "const": "cancelled" } }, - "required": ["outcome"] + "required": [ + "outcome" + ] }, { "description": "The user selected one of the provided options.", @@ -4249,7 +4872,9 @@ "const": "selected" } }, - "required": ["outcome"], + "required": [ + "outcome" + ], "allOf": [ { "$ref": "#/$defs/SelectedPermissionOutcome" @@ -4275,12 +4900,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["optionId"] + "required": [ + "optionId" + ] }, "CreateTerminalResponse": { "description": "Response containing the ID of the created terminal.", @@ -4296,12 +4926,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["terminalId"], + "required": [ + "terminalId" + ], "x-side": "client", "x-method": "terminal/create" }, @@ -4331,12 +4966,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["output", "truncated"], + "required": [ + "output", + "truncated" + ], "x-side": "client", "x-method": "terminal/output" }, @@ -4346,19 +4987,28 @@ "properties": { "exitCode": { "description": "The process exit code (may be null if terminated by signal).", - "type": ["integer", "null"], + "type": [ + "integer", + "null" + ], "format": "uint32", "minimum": 0, "x-deserialize-default-on-error": true }, "signal": { "description": "The signal that terminated the process (may be null if exited normally).", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -4370,7 +5020,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -4384,19 +5037,28 @@ "properties": { "exitCode": { "description": "The process exit code (may be null if terminated by signal).", - "type": ["integer", "null"], + "type": [ + "integer", + "null" + ], "format": "uint32", "minimum": 0, "x-deserialize-default-on-error": true }, "signal": { "description": "The signal that terminated the process (may be null if exited normally).", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -4410,7 +5072,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -4458,7 +5123,9 @@ ] } }, - "required": ["method"], + "required": [ + "method" + ], "x-docs-ignore": true }, "CancelNotification": { @@ -4475,14 +5142,19 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId"], + "required": [ + "sessionId" + ], "x-side": "agent", "x-method": "session/cancel" } } -} +} \ No newline at end of file diff --git a/schema/v1/schema.unstable.json b/schema/v1/schema.unstable.json index 6b9174e5b..99f24246c 100644 --- a/schema/v1/schema.unstable.json +++ b/schema/v1/schema.unstable.json @@ -9,10 +9,14 @@ "properties": { "jsonrpc": { "type": "string", - "enum": ["2.0"] + "enum": [ + "2.0" + ] } }, - "required": ["jsonrpc"], + "required": [ + "jsonrpc" + ], "anyOf": [ { "title": "Request", @@ -47,10 +51,14 @@ "properties": { "jsonrpc": { "type": "string", - "enum": ["2.0"] + "enum": [ + "2.0" + ] } }, - "required": ["jsonrpc"], + "required": [ + "jsonrpc" + ], "anyOf": [ { "title": "Request", @@ -85,7 +93,9 @@ "properties": { "jsonrpc": { "type": "string", - "enum": ["2.0"] + "enum": [ + "2.0" + ] }, "method": { "description": "The notification method name.", @@ -114,7 +124,10 @@ ] } }, - "required": ["jsonrpc", "method"], + "required": [ + "jsonrpc", + "method" + ], "x-docs-ignore": true } ], @@ -266,7 +279,10 @@ ] } }, - "required": ["id", "method"], + "required": [ + "id", + "method" + ], "x-docs-ignore": true }, "RequestId": { @@ -312,12 +328,19 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "path", "content"], + "required": [ + "sessionId", + "path", + "content" + ], "x-side": "client", "x-method": "fs/write_text_file" }, @@ -343,26 +366,38 @@ }, "line": { "description": "Line number to start reading from (1-based).", - "type": ["integer", "null"], + "type": [ + "integer", + "null" + ], "format": "uint32", "minimum": 0, "x-deserialize-default-on-error": true }, "limit": { "description": "Maximum number of lines to read.", - "type": ["integer", "null"], + "type": [ + "integer", + "null" + ], "format": "uint32", "minimum": 0, "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "path"], + "required": [ + "sessionId", + "path" + ], "x-side": "client", "x-method": "fs/read_text_file" }, @@ -397,12 +432,19 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "toolCall", "options"], + "required": [ + "sessionId", + "toolCall", + "options" + ], "x-side": "client", "x-method": "session/request_permission" }, @@ -444,12 +486,18 @@ }, "title": { "description": "Update the human-readable title.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "content": { "description": "Replace the content collection.", - "type": ["array", "null"], + "type": [ + "array", + "null" + ], "items": { "$ref": "#/$defs/ToolCallContent" }, @@ -458,7 +506,10 @@ }, "locations": { "description": "Replace the locations collection.", - "type": ["array", "null"], + "type": [ + "array", + "null" + ], "items": { "$ref": "#/$defs/ToolCallLocation" }, @@ -475,12 +526,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["toolCallId"] + "required": [ + "toolCallId" + ] }, "ToolCallId": { "description": "Unique identifier for a tool call within a session.", @@ -578,7 +634,9 @@ "const": "content" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/Content" @@ -594,7 +652,9 @@ "const": "diff" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/Diff" @@ -610,7 +670,9 @@ "const": "terminal" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/Terminal" @@ -634,7 +696,9 @@ "const": "text" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/TextContent" @@ -650,7 +714,9 @@ "const": "image" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/ImageContent" @@ -666,7 +732,9 @@ "const": "audio" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/AudioContent" @@ -682,7 +750,9 @@ "const": "resource_link" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/ResourceLink" @@ -698,7 +768,9 @@ "const": "resource" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/EmbeddedResource" @@ -716,7 +788,10 @@ "properties": { "audience": { "description": "Intended recipients for this content, such as the user or assistant.", - "type": ["array", "null"], + "type": [ + "array", + "null" + ], "items": { "$ref": "#/$defs/Role" }, @@ -725,18 +800,27 @@ }, "lastModified": { "description": "Timestamp indicating when the underlying resource was last modified.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "priority": { "description": "Relative importance of this content when clients choose what to surface.", - "type": ["number", "null"], + "type": [ + "number", + "null" + ], "format": "double", "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -779,12 +863,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["text"] + "required": [ + "text" + ] }, "ImageContent": { "description": "An image provided to or from an LLM.", @@ -812,17 +901,26 @@ }, "uri": { "description": "URI associated with this resource or media payload.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["data", "mimeType"] + "required": [ + "data", + "mimeType" + ] }, "AudioContent": { "description": "Audio provided to or from an LLM.", @@ -850,12 +948,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["data", "mimeType"] + "required": [ + "data", + "mimeType" + ] }, "ResourceLink": { "description": "A resource that the server is capable of reading, included in a prompt or tool call result.", @@ -875,12 +979,18 @@ }, "description": { "description": "Optional human-readable details shown with this protocol object.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "mimeType": { "description": "MIME type describing the encoded media payload.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "name": { @@ -889,13 +999,19 @@ }, "size": { "description": "Optional size of the linked resource in bytes, if known.", - "type": ["integer", "null"], + "type": [ + "integer", + "null" + ], "format": "int64", "x-deserialize-default-on-error": true }, "title": { "description": "Optional display title for end-user UI.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "uri": { @@ -904,12 +1020,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["name", "uri"] + "required": [ + "name", + "uri" + ] }, "EmbeddedResourceResource": { "description": "Resource content that can be embedded in a message.", @@ -940,7 +1062,10 @@ "properties": { "mimeType": { "description": "MIME type describing the encoded media payload.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "text": { @@ -953,12 +1078,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["text", "uri"] + "required": [ + "text", + "uri" + ] }, "BlobResourceContents": { "description": "Binary resource contents.", @@ -970,7 +1101,10 @@ }, "mimeType": { "description": "MIME type describing the encoded media payload.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "uri": { @@ -979,12 +1113,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["blob", "uri"] + "required": [ + "blob", + "uri" + ] }, "EmbeddedResource": { "description": "The contents of a resource, embedded into a prompt or tool call result.", @@ -1012,12 +1152,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["resource"] + "required": [ + "resource" + ] }, "Content": { "description": "Standard content block (text, images, resources).", @@ -1033,12 +1178,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["content"] + "required": [ + "content" + ] }, "Diff": { "description": "A diff representing file modifications.\n\nShows changes to files in a format suitable for display in the client UI.\n\nSee protocol docs: [Content](https://agentclientprotocol.com/protocol/tool-calls#content)", @@ -1050,7 +1200,10 @@ }, "oldText": { "description": "The original content (None for new files).", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "newText": { @@ -1059,12 +1212,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["path", "newText"] + "required": [ + "path", + "newText" + ] }, "TerminalId": { "description": "Typed identifier used for terminal values on the wire.", @@ -1084,12 +1243,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["terminalId"] + "required": [ + "terminalId" + ] }, "ToolCallLocation": { "description": "A file location being accessed or modified by a tool.\n\nEnables clients to implement \"follow-along\" features that track\nwhich files the agent is working with in real-time.\n\nSee protocol docs: [Following the Agent](https://agentclientprotocol.com/protocol/tool-calls#following-the-agent)", @@ -1101,19 +1265,27 @@ }, "line": { "description": "Optional line number within the file.", - "type": ["integer", "null"], + "type": [ + "integer", + "null" + ], "format": "uint32", "minimum": 0, "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["path"] + "required": [ + "path" + ] }, "PermissionOption": { "description": "An option presented to the user when requesting permission.", @@ -1141,12 +1313,19 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["optionId", "name", "kind"] + "required": [ + "optionId", + "name", + "kind" + ] }, "PermissionOptionId": { "description": "Unique identifier for a permission option.", @@ -1213,24 +1392,36 @@ }, "cwd": { "description": "Working directory for the command (absolute path).", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "outputByteLimit": { "description": "Maximum number of output bytes to retain.\n\nWhen the limit is exceeded, the Client truncates from the beginning of the output\nto stay within the limit.\n\nThe Client MUST ensure truncation happens at a character boundary to maintain valid\nstring output, even if this means the retained output is slightly less than the\nspecified limit.", - "type": ["integer", "null"], + "type": [ + "integer", + "null" + ], "format": "uint64", "minimum": 0, "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "command"], + "required": [ + "sessionId", + "command" + ], "x-side": "client", "x-method": "terminal/create" }, @@ -1248,12 +1439,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["name", "value"] + "required": [ + "name", + "value" + ] }, "TerminalOutputRequest": { "description": "Request to get the current output and status of a terminal.", @@ -1277,12 +1474,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "terminalId"], + "required": [ + "sessionId", + "terminalId" + ], "x-side": "client", "x-method": "terminal/output" }, @@ -1308,12 +1511,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "terminalId"], + "required": [ + "sessionId", + "terminalId" + ], "x-side": "client", "x-method": "terminal/release" }, @@ -1339,12 +1548,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "terminalId"], + "required": [ + "sessionId", + "terminalId" + ], "x-side": "client", "x-method": "terminal/wait_for_exit" }, @@ -1370,12 +1585,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "terminalId"], + "required": [ + "sessionId", + "terminalId" + ], "x-side": "client", "x-method": "terminal/kill" }, @@ -1389,7 +1610,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1404,7 +1628,9 @@ "const": "form" } }, - "required": ["mode"], + "required": [ + "mode" + ], "allOf": [ { "$ref": "#/$defs/ElicitationFormMode" @@ -1420,7 +1646,9 @@ "const": "url" } }, - "required": ["mode"], + "required": [ + "mode" + ], "allOf": [ { "$ref": "#/$defs/ElicitationUrlMode" @@ -1431,7 +1659,9 @@ "discriminator": { "propertyName": "mode" }, - "required": ["message"], + "required": [ + "message" + ], "x-side": "client", "x-method": "elicitation/create" }, @@ -1460,7 +1690,9 @@ "x-deserialize-default-on-error": true } }, - "required": ["sessionId"] + "required": [ + "sessionId" + ] }, "ElicitationRequestScope": { "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nRequest-scoped elicitation, tied to a specific JSON-RPC request outside of a session\n(e.g., during auth/configuration phases before any session is started).", @@ -1475,7 +1707,9 @@ ] } }, - "required": ["requestId"] + "required": [ + "requestId" + ] }, "ElicitationSchema": { "description": "Type-safe elicitation schema for requesting structured user input.\n\nThis represents a JSON Schema object with primitive-typed properties,\nas required by the elicitation specification.", @@ -1493,7 +1727,10 @@ }, "title": { "description": "Optional title for the schema.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "properties": { @@ -1507,7 +1744,10 @@ }, "required": { "description": "List of required property names.", - "type": ["array", "null"], + "type": [ + "array", + "null" + ], "items": { "type": "string" }, @@ -1516,12 +1756,18 @@ }, "description": { "description": "Optional description of what this schema represents.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1549,7 +1795,9 @@ "const": "string" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/StringPropertySchema" @@ -1565,7 +1813,9 @@ "const": "number" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/NumberPropertySchema" @@ -1581,7 +1831,9 @@ "const": "integer" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/IntegerPropertySchema" @@ -1597,7 +1849,9 @@ "const": "boolean" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/BooleanPropertySchema" @@ -1613,7 +1867,9 @@ "const": "array" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/MultiSelectPropertySchema" @@ -1664,12 +1920,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["const", "title"] + "required": [ + "const", + "title" + ] }, "StringPropertySchema": { "description": "Schema for string properties in an elicitation form.\n\nWhen `enum` or `oneOf` is set, this represents a single-select enum\nwith `\"type\": \"string\"`.", @@ -1677,31 +1939,46 @@ "properties": { "title": { "description": "Optional title for the property.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "description": { "description": "Human-readable description.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "minLength": { "description": "Minimum string length.", - "type": ["integer", "null"], + "type": [ + "integer", + "null" + ], "format": "uint32", "minimum": 0, "x-deserialize-default-on-error": true }, "maxLength": { "description": "Maximum string length.", - "type": ["integer", "null"], + "type": [ + "integer", + "null" + ], "format": "uint32", "minimum": 0, "x-deserialize-default-on-error": true }, "pattern": { "description": "Pattern the string must match.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "format": { @@ -1718,12 +1995,18 @@ }, "default": { "description": "Default value.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "enum": { "description": "Enum values for untitled single-select enums.", - "type": ["array", "null"], + "type": [ + "array", + "null" + ], "items": { "type": "string" }, @@ -1732,7 +2015,10 @@ }, "oneOf": { "description": "Titled enum options for titled single-select enums.", - "type": ["array", "null"], + "type": [ + "array", + "null" + ], "items": { "$ref": "#/$defs/EnumOption" }, @@ -1741,7 +2027,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1753,35 +2042,53 @@ "properties": { "title": { "description": "Optional title for the property.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "description": { "description": "Human-readable description.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "minimum": { "description": "Minimum value (inclusive).", - "type": ["number", "null"], + "type": [ + "number", + "null" + ], "format": "double", "x-deserialize-default-on-error": true }, "maximum": { "description": "Maximum value (inclusive).", - "type": ["number", "null"], + "type": [ + "number", + "null" + ], "format": "double", "x-deserialize-default-on-error": true }, "default": { "description": "Default value.", - "type": ["number", "null"], + "type": [ + "number", + "null" + ], "format": "double", "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1793,35 +2100,53 @@ "properties": { "title": { "description": "Optional title for the property.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "description": { "description": "Human-readable description.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "minimum": { "description": "Minimum value (inclusive).", - "type": ["integer", "null"], + "type": [ + "integer", + "null" + ], "format": "int64", "x-deserialize-default-on-error": true }, "maximum": { "description": "Maximum value (inclusive).", - "type": ["integer", "null"], + "type": [ + "integer", + "null" + ], "format": "int64", "x-deserialize-default-on-error": true }, "default": { "description": "Default value.", - "type": ["integer", "null"], + "type": [ + "integer", + "null" + ], "format": "int64", "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1833,22 +2158,34 @@ "properties": { "title": { "description": "Optional title for the property.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "description": { "description": "Human-readable description.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "default": { "description": "Default value.", - "type": ["boolean", "null"], + "type": [ + "boolean", + "null" + ], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1900,12 +2237,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["type", "enum"] + "required": [ + "type", + "enum" + ] }, "ElicitationStringType": { "description": "Items definition for untitled multi-select enum properties.", @@ -1932,12 +2275,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["anyOf"] + "required": [ + "anyOf" + ] }, "MultiSelectPropertySchema": { "description": "Schema for multi-select (array) properties in an elicitation form.", @@ -1945,24 +2293,36 @@ "properties": { "title": { "description": "Optional title for the property.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "description": { "description": "Human-readable description.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "minItems": { "description": "Minimum number of items to select.", - "type": ["integer", "null"], + "type": [ + "integer", + "null" + ], "format": "uint64", "minimum": 0, "x-deserialize-default-on-error": true }, "maxItems": { "description": "Maximum number of items to select.", - "type": ["integer", "null"], + "type": [ + "integer", + "null" + ], "format": "uint64", "minimum": 0, "x-deserialize-default-on-error": true @@ -1977,7 +2337,10 @@ }, "default": { "description": "Default selected values.", - "type": ["array", "null"], + "type": [ + "array", + "null" + ], "items": { "type": "string" }, @@ -1986,12 +2349,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["items"] + "required": [ + "items" + ] }, "ElicitationFormMode": { "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nForm-based elicitation mode where the client renders a form from the provided schema.", @@ -2026,7 +2394,9 @@ ] } ], - "required": ["requestedSchema"] + "required": [ + "requestedSchema" + ] }, "ElicitationId": { "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nUnique identifier for an elicitation.", @@ -2070,7 +2440,10 @@ ] } ], - "required": ["elicitationId", "url"] + "required": [ + "elicitationId", + "url" + ] }, "ConnectMcpRequest": { "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nRequest parameters for `mcp/connect`.", @@ -2086,12 +2459,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["acpId"], + "required": [ + "acpId" + ], "x-side": "client", "x-method": "mcp/connect" }, @@ -2117,18 +2495,27 @@ }, "params": { "description": "Optional inner MCP params.\n\nIf omitted or set to `null`, the inner MCP message has no params.", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["connectionId", "method"], + "required": [ + "connectionId", + "method" + ], "x-side": "both", "x-method": "mcp/message" }, @@ -2150,12 +2537,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["connectionId"], + "required": [ + "connectionId" + ], "x-side": "client", "x-method": "mcp/disconnect" }, @@ -2373,7 +2765,10 @@ ] } }, - "required": ["id", "result"] + "required": [ + "id", + "result" + ] }, { "title": "Error", @@ -2397,7 +2792,10 @@ ] } }, - "required": ["id", "error"] + "required": [ + "id", + "error" + ] } ], "x-docs-ignore": true @@ -2462,12 +2860,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["protocolVersion"], + "required": [ + "protocolVersion" + ], "x-side": "agent", "x-method": "initialize" }, @@ -2574,7 +2977,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2604,7 +3010,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2634,7 +3043,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2718,7 +3130,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2730,7 +3145,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2742,7 +3160,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2754,7 +3175,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2766,7 +3190,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2778,7 +3205,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2790,7 +3220,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2814,7 +3247,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2826,7 +3262,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2838,7 +3277,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2874,7 +3316,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2898,7 +3343,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2970,7 +3418,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2982,7 +3433,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3002,12 +3456,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["syncKind"] + "required": [ + "syncKind" + ] }, "TextDocumentSyncKind": { "description": "How the agent wants document changes delivered.", @@ -3030,7 +3489,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3042,7 +3504,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3054,7 +3519,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3138,7 +3606,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3150,14 +3621,20 @@ "properties": { "maxCount": { "description": "Maximum number of recent files the agent can use.", - "type": ["integer", "null"], + "type": [ + "integer", + "null" + ], "format": "uint32", "minimum": 0, "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3169,7 +3646,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3181,14 +3661,20 @@ "properties": { "maxCount": { "description": "Maximum number of edit history entries the agent can use.", - "type": ["integer", "null"], + "type": [ + "integer", + "null" + ], "format": "uint32", "minimum": 0, "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3200,14 +3686,20 @@ "properties": { "maxCount": { "description": "Maximum number of user actions the agent can use.", - "type": ["integer", "null"], + "type": [ + "integer", + "null" + ], "format": "uint32", "minimum": 0, "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3219,7 +3711,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3231,7 +3726,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3269,7 +3767,9 @@ "const": "env_var" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/AuthMethodEnvVar" @@ -3285,7 +3785,9 @@ "const": "terminal" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/AuthMethodTerminal" @@ -3317,7 +3819,10 @@ }, "label": { "description": "Human-readable label for this variable, displayed in client UI.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "secret": { @@ -3334,12 +3839,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["name"] + "required": [ + "name" + ] }, "AuthMethodEnvVar": { "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nEnvironment variable authentication method.\n\nThe user provides credentials that the client passes to the agent as environment variables.", @@ -3359,7 +3869,10 @@ }, "description": { "description": "Optional description providing more details about this authentication method.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "vars": { @@ -3373,17 +3886,27 @@ }, "link": { "description": "Optional link to a page where the user can obtain their credentials.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["id", "name", "vars"] + "required": [ + "id", + "name", + "vars" + ] }, "AuthMethodTerminal": { "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nTerminal-based authentication method.\n\nThe client runs an interactive terminal for the user to authenticate via a TUI.", @@ -3403,7 +3926,10 @@ }, "description": { "description": "Optional description providing more details about this authentication method.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "args": { @@ -3425,12 +3951,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["id", "name"] + "required": [ + "id", + "name" + ] }, "AuthMethodAgent": { "description": "Agent handles authentication itself.\n\nThis is the default authentication method type.", @@ -3450,17 +3982,26 @@ }, "description": { "description": "Optional description providing more details about this authentication method.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["id", "name"] + "required": [ + "id", + "name" + ] }, "Implementation": { "description": "Metadata about the implementation of the client or agent.\nDescribes the name and version of an ACP implementation, with an optional\ntitle for UI representation.", @@ -3472,7 +4013,10 @@ }, "title": { "description": "Intended for UI and end-user contexts — optimized to be human-readable\nand easily understood.\n\nIf not provided, the name should be used for display.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "version": { @@ -3481,12 +4025,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["name", "version"] + "required": [ + "name", + "version" + ] }, "AuthenticateResponse": { "description": "Response to the `authenticate` method.", @@ -3494,7 +4044,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3517,12 +4070,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["providers"], + "required": [ + "providers" + ], "x-side": "agent", "x-method": "providers/list" }, @@ -3561,12 +4119,19 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["id", "supported", "required"] + "required": [ + "id", + "supported", + "required" + ] }, "LlmProtocol": { "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nWell-known API protocol identifiers for LLM providers.\n\nAgents and clients MUST handle unknown protocol identifiers gracefully.\n\nProtocol names beginning with `_` are free for custom use, like other ACP extension methods.\nProtocol names that do not begin with `_` are reserved for the ACP spec.", @@ -3621,12 +4186,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["apiType", "baseUrl"] + "required": [ + "apiType", + "baseUrl" + ] }, "SetProviderResponse": { "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nResponse to `providers/set`.", @@ -3634,7 +4205,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3648,7 +4222,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3662,7 +4239,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3696,7 +4276,10 @@ }, "configOptions": { "description": "Initial session configuration options if supported by the Agent.", - "type": ["array", "null"], + "type": [ + "array", + "null" + ], "items": { "$ref": "#/$defs/SessionConfigOption" }, @@ -3705,12 +4288,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId"], + "required": [ + "sessionId" + ], "x-side": "agent", "x-method": "session/new" }, @@ -3737,12 +4325,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["currentModeId", "availableModes"] + "required": [ + "currentModeId", + "availableModes" + ] }, "SessionModeId": { "description": "Unique identifier for a Session Mode.", @@ -3766,17 +4360,26 @@ }, "description": { "description": "Optional human-readable details shown with this protocol object.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["id", "name"] + "required": [ + "id", + "name" + ] }, "SessionConfigOption": { "description": "A session configuration option selector and its current state.", @@ -3796,7 +4399,10 @@ }, "description": { "description": "Optional description for the Client to display to the user.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "category": { @@ -3813,12 +4419,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["id", "name"], + "required": [ + "id", + "name" + ], "oneOf": [ { "description": "Single-value selector (dropdown).", @@ -3829,7 +4441,9 @@ "const": "select" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/SessionConfigSelect" @@ -3845,7 +4459,9 @@ "const": "boolean" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/SessionConfigBoolean" @@ -3934,17 +4550,26 @@ }, "description": { "description": "Optional description for this option value.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["value", "name"] + "required": [ + "value", + "name" + ] }, "SessionConfigSelectGroup": { "description": "A group of possible values for a session configuration option.", @@ -3973,12 +4598,19 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["group", "name", "options"] + "required": [ + "group", + "name", + "options" + ] }, "SessionConfigGroupId": { "description": "Unique identifier for a session configuration option value group.", @@ -4005,7 +4637,10 @@ ] } }, - "required": ["currentValue", "options"] + "required": [ + "currentValue", + "options" + ] }, "SessionConfigBoolean": { "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nA boolean on/off toggle session configuration option payload.", @@ -4016,7 +4651,9 @@ "type": "boolean" } }, - "required": ["currentValue"] + "required": [ + "currentValue" + ] }, "LoadSessionResponse": { "description": "Response from loading an existing session.", @@ -4036,7 +4673,10 @@ }, "configOptions": { "description": "Initial session configuration options if supported by the Agent.", - "type": ["array", "null"], + "type": [ + "array", + "null" + ], "items": { "$ref": "#/$defs/SessionConfigOption" }, @@ -4045,7 +4685,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -4068,17 +4711,25 @@ }, "nextCursor": { "description": "Opaque cursor token. If present, pass this in the next request's cursor parameter\nto fetch the next page. If absent, there are no more results.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessions"], + "required": [ + "sessions" + ], "x-side": "agent", "x-method": "session/list" }, @@ -4109,22 +4760,34 @@ }, "title": { "description": "Human-readable title for the session", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "updatedAt": { "description": "ISO 8601 timestamp of last activity", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "cwd"] + "required": [ + "sessionId", + "cwd" + ] }, "DeleteSessionResponse": { "description": "Response from deleting a session.", @@ -4132,7 +4795,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -4166,7 +4832,10 @@ }, "configOptions": { "description": "Initial session configuration options if supported by the Agent.", - "type": ["array", "null"], + "type": [ + "array", + "null" + ], "items": { "$ref": "#/$defs/SessionConfigOption" }, @@ -4175,12 +4844,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId"], + "required": [ + "sessionId" + ], "x-side": "agent", "x-method": "session/fork" }, @@ -4202,7 +4876,10 @@ }, "configOptions": { "description": "Initial session configuration options if supported by the Agent.", - "type": ["array", "null"], + "type": [ + "array", + "null" + ], "items": { "$ref": "#/$defs/SessionConfigOption" }, @@ -4211,7 +4888,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -4225,7 +4905,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -4239,7 +4922,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -4262,12 +4948,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["configOptions"], + "required": [ + "configOptions" + ], "x-side": "agent", "x-method": "session/set_config_option" }, @@ -4297,12 +4988,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["stopReason"], + "required": [ + "stopReason" + ], "x-side": "agent", "x-method": "session/prompt" }, @@ -4360,33 +5056,49 @@ }, "thoughtTokens": { "description": "Total thought/reasoning tokens", - "type": ["integer", "null"], + "type": [ + "integer", + "null" + ], "format": "uint64", "minimum": 0, "x-deserialize-default-on-error": true }, "cachedReadTokens": { "description": "Total cache read tokens.", - "type": ["integer", "null"], + "type": [ + "integer", + "null" + ], "format": "uint64", "minimum": 0, "x-deserialize-default-on-error": true }, "cachedWriteTokens": { "description": "Total cache write tokens.", - "type": ["integer", "null"], + "type": [ + "integer", + "null" + ], "format": "uint64", "minimum": 0, "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["totalTokens", "inputTokens", "outputTokens"] + "required": [ + "totalTokens", + "inputTokens", + "outputTokens" + ] }, "StartNesResponse": { "description": "Response to `nes/start`.", @@ -4402,12 +5114,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId"], + "required": [ + "sessionId" + ], "x-side": "agent", "x-method": "nes/start" }, @@ -4426,12 +5143,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["suggestions"], + "required": [ + "suggestions" + ], "x-side": "agent", "x-method": "nes/suggest" }, @@ -4447,7 +5169,9 @@ "const": "edit" } }, - "required": ["kind"], + "required": [ + "kind" + ], "allOf": [ { "$ref": "#/$defs/NesEditSuggestion" @@ -4463,7 +5187,9 @@ "const": "jump" } }, - "required": ["kind"], + "required": [ + "kind" + ], "allOf": [ { "$ref": "#/$defs/NesJumpSuggestion" @@ -4479,7 +5205,9 @@ "const": "rename" } }, - "required": ["kind"], + "required": [ + "kind" + ], "allOf": [ { "$ref": "#/$defs/NesRenameSuggestion" @@ -4495,7 +5223,9 @@ "const": "searchAndReplace" } }, - "required": ["kind"], + "required": [ + "kind" + ], "allOf": [ { "$ref": "#/$defs/NesSearchAndReplaceSuggestion" @@ -4525,12 +5255,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["range", "newText"] + "required": [ + "range", + "newText" + ] }, "Range": { "description": "A range in a text document, expressed as start and end positions.", @@ -4554,12 +5290,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["start", "end"] + "required": [ + "start", + "end" + ] }, "Position": { "description": "A zero-based position in a text document.\n\nThe meaning of `character` depends on the negotiated position encoding.", @@ -4579,12 +5321,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["line", "character"] + "required": [ + "line", + "character" + ] }, "NesEditSuggestion": { "description": "A text edit suggestion.", @@ -4621,12 +5369,19 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["id", "uri", "edits"] + "required": [ + "id", + "uri", + "edits" + ] }, "NesJumpSuggestion": { "description": "A jump-to-location suggestion.", @@ -4650,12 +5405,19 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["id", "uri", "position"] + "required": [ + "id", + "uri", + "position" + ] }, "NesRenameSuggestion": { "description": "A rename symbol suggestion.", @@ -4683,12 +5445,20 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["id", "uri", "position", "newName"] + "required": [ + "id", + "uri", + "position", + "newName" + ] }, "NesSearchAndReplaceSuggestion": { "description": "A search-and-replace suggestion.", @@ -4712,17 +5482,28 @@ }, "isRegex": { "description": "Whether `search` is a regular expression. Defaults to `false`.", - "type": ["boolean", "null"], + "type": [ + "boolean", + "null" + ], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["id", "uri", "search", "replace"] + "required": [ + "id", + "uri", + "search", + "replace" + ] }, "CloseNesResponse": { "description": "Response from closing an NES session.", @@ -4730,7 +5511,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -4767,7 +5551,10 @@ "x-deserialize-default-on-error": true } }, - "required": ["code", "message"] + "required": [ + "code", + "message" + ] }, "ErrorCode": { "description": "Predefined error codes for common JSON-RPC and ACP-specific errors.\n\nThese codes follow the JSON-RPC 2.0 specification for standard errors\nand use the reserved range (-32000 to -32099) for protocol-specific errors.", @@ -4901,7 +5688,9 @@ ] } }, - "required": ["method"], + "required": [ + "method" + ], "x-docs-ignore": true }, "SessionNotification": { @@ -4926,12 +5715,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "update"], + "required": [ + "sessionId", + "update" + ], "x-side": "client", "x-method": "session/update" }, @@ -4947,7 +5742,9 @@ "const": "user_message_chunk" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/ContentChunk" @@ -4963,7 +5760,9 @@ "const": "agent_message_chunk" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/ContentChunk" @@ -4979,7 +5778,9 @@ "const": "agent_thought_chunk" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/ContentChunk" @@ -4995,7 +5796,9 @@ "const": "tool_call" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/ToolCall" @@ -5011,7 +5814,9 @@ "const": "tool_call_update" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/ToolCallUpdate" @@ -5027,7 +5832,9 @@ "const": "plan" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/Plan" @@ -5043,7 +5850,9 @@ "const": "plan_update" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/PlanUpdate" @@ -5059,7 +5868,9 @@ "const": "plan_removed" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/PlanRemoved" @@ -5075,7 +5886,9 @@ "const": "available_commands_update" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/AvailableCommandsUpdate" @@ -5091,7 +5904,9 @@ "const": "current_mode_update" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/CurrentModeUpdate" @@ -5107,7 +5922,9 @@ "const": "config_option_update" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/ConfigOptionUpdate" @@ -5123,7 +5940,9 @@ "const": "session_info_update" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/SessionInfoUpdate" @@ -5139,7 +5958,9 @@ "const": "usage_update" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/UsageUpdate" @@ -5181,12 +6002,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["content"] + "required": [ + "content" + ] }, "ToolCall": { "description": "Represents a tool call that the language model has requested.\n\nTool calls are actions that the agent executes on behalf of the language model,\nsuch as reading files, executing code, or fetching data from external sources.\n\nSee protocol docs: [Tool Calls](https://agentclientprotocol.com/protocol/tool-calls)", @@ -5250,12 +6076,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["toolCallId", "title"] + "required": [ + "toolCallId", + "title" + ] }, "PlanEntry": { "description": "A single entry in the execution plan.\n\nRepresents a task or goal that the assistant intends to accomplish\nas part of fulfilling the user's request.\nSee protocol docs: [Plan Entries](https://agentclientprotocol.com/protocol/agent-plan#plan-entries)", @@ -5283,12 +6115,19 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["content", "priority", "status"] + "required": [ + "content", + "priority", + "status" + ] }, "PlanEntryPriority": { "description": "Priority levels for plan entries.\n\nUsed to indicate the relative importance or urgency of different\ntasks in the execution plan.\nSee protocol docs: [Plan Entries](https://agentclientprotocol.com/protocol/agent-plan#plan-entries)", @@ -5345,12 +6184,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["entries"] + "required": [ + "entries" + ] }, "PlanUpdateContent": { "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nUpdated content for a plan.", @@ -5364,7 +6208,9 @@ "const": "items" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/PlanItems" @@ -5380,7 +6226,9 @@ "const": "file" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/PlanFile" @@ -5396,7 +6244,9 @@ "const": "markdown" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/PlanMarkdown" @@ -5435,12 +6285,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["id", "entries"] + "required": [ + "id", + "entries" + ] }, "PlanFile": { "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nA plan represented by a file URI.", @@ -5460,12 +6316,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["id", "uri"] + "required": [ + "id", + "uri" + ] }, "PlanMarkdown": { "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nA plan represented as raw markdown content.", @@ -5485,12 +6347,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["id", "content"] + "required": [ + "id", + "content" + ] }, "PlanUpdate": { "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nA content update for a plan identified by ID.", @@ -5506,12 +6374,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["plan"] + "required": [ + "plan" + ] }, "PlanRemoved": { "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nRemoval notice for a plan identified by ID.", @@ -5527,12 +6400,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["id"] + "required": [ + "id" + ] }, "AvailableCommand": { "description": "Information about a command.", @@ -5560,12 +6438,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["name", "description"] + "required": [ + "name", + "description" + ] }, "AvailableCommandInput": { "description": "The input specification for a command.", @@ -5591,12 +6475,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["hint"] + "required": [ + "hint" + ] }, "AvailableCommandsUpdate": { "description": "Available commands are ready or have changed", @@ -5613,12 +6502,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["availableCommands"] + "required": [ + "availableCommands" + ] }, "CurrentModeUpdate": { "description": "The current mode of the session has changed\n\nSee protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/session-modes)", @@ -5634,12 +6528,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["currentModeId"] + "required": [ + "currentModeId" + ] }, "ConfigOptionUpdate": { "description": "Session configuration options have been updated.", @@ -5656,12 +6555,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["configOptions"] + "required": [ + "configOptions" + ] }, "SessionInfoUpdate": { "description": "Update to session metadata. All fields are optional to support partial updates.\n\nAgents send this notification to update session information like title or custom metadata.\nThis allows clients to display dynamic session names and track session state changes.", @@ -5669,17 +6573,26 @@ "properties": { "title": { "description": "Human-readable title for the session. Set to null to clear.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "updatedAt": { "description": "ISO 8601 timestamp of last activity. Set to null to clear.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -5700,12 +6613,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["amount", "currency"] + "required": [ + "amount", + "currency" + ] }, "UsageUpdate": { "description": "Context window and cost update for a session.", @@ -5737,12 +6656,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["used", "size"] + "required": [ + "used", + "size" + ] }, "CompleteElicitationNotification": { "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nNotification sent by the agent when a URL-based elicitation is complete.", @@ -5758,12 +6683,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["elicitationId"], + "required": [ + "elicitationId" + ], "x-side": "client", "x-method": "elicitation/complete" }, @@ -5785,18 +6715,27 @@ }, "params": { "description": "Optional inner MCP params.\n\nIf omitted or set to `null`, the inner MCP message has no params.", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["connectionId", "method"], + "required": [ + "connectionId", + "method" + ], "x-side": "both", "x-method": "mcp/message" }, @@ -6022,7 +6961,10 @@ ] } }, - "required": ["id", "method"], + "required": [ + "id", + "method" + ], "x-docs-ignore": true }, "InitializeRequest": { @@ -6070,12 +7012,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["protocolVersion"], + "required": [ + "protocolVersion" + ], "x-side": "agent", "x-method": "initialize" }, @@ -6173,7 +7120,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -6197,7 +7147,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -6221,7 +7174,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -6245,7 +7201,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -6257,7 +7216,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -6269,7 +7231,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -6287,7 +7252,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -6323,7 +7291,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -6335,7 +7306,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -6347,7 +7321,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -6395,7 +7372,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -6407,7 +7387,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -6419,7 +7402,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -6431,7 +7417,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -6451,12 +7440,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["methodId"], + "required": [ + "methodId" + ], "x-side": "agent", "x-method": "authenticate" }, @@ -6466,7 +7460,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -6504,12 +7501,19 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["id", "apiType", "baseUrl"], + "required": [ + "id", + "apiType", + "baseUrl" + ], "x-side": "agent", "x-method": "providers/set" }, @@ -6523,12 +7527,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["id"], + "required": [ + "id" + ], "x-side": "agent", "x-method": "providers/disable" }, @@ -6538,7 +7547,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -6574,12 +7586,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["cwd", "mcpServers"], + "required": [ + "cwd", + "mcpServers" + ], "x-side": "agent", "x-method": "session/new" }, @@ -6595,7 +7613,9 @@ "const": "http" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/McpServerHttp" @@ -6611,7 +7631,9 @@ "const": "sse" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/McpServerSse" @@ -6627,7 +7649,9 @@ "const": "acp" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/McpServerAcp" @@ -6659,12 +7683,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["name", "value"] + "required": [ + "name", + "value" + ] }, "McpServerHttp": { "description": "HTTP transport configuration for MCP.", @@ -6689,12 +7719,19 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["name", "url", "headers"] + "required": [ + "name", + "url", + "headers" + ] }, "McpServerSse": { "description": "SSE transport configuration for MCP.", @@ -6719,12 +7756,19 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["name", "url", "headers"] + "required": [ + "name", + "url", + "headers" + ] }, "McpServerAcp": { "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nACP transport configuration for MCP.\n\nThe MCP server is provided by an ACP component and communicates over the ACP channel\nusing `mcp/connect`, `mcp/message`, and `mcp/disconnect`.", @@ -6744,12 +7788,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["name", "id"] + "required": [ + "name", + "id" + ] }, "McpServerStdio": { "description": "Stdio transport configuration for MCP.", @@ -6783,12 +7833,20 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["name", "command", "args", "env"] + "required": [ + "name", + "command", + "args", + "env" + ] }, "LoadSessionRequest": { "description": "Request parameters for loading an existing session.\n\nOnly available if the Agent supports the `loadSession` capability.\n\nSee protocol docs: [Loading Sessions](https://agentclientprotocol.com/protocol/session-setup#loading-sessions)", @@ -6826,12 +7884,19 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["mcpServers", "cwd", "sessionId"], + "required": [ + "mcpServers", + "cwd", + "sessionId" + ], "x-side": "agent", "x-method": "session/load" }, @@ -6841,17 +7906,26 @@ "properties": { "cwd": { "description": "Filter sessions by working directory. Must be an absolute path.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "cursor": { "description": "Opaque cursor token from a previous response's nextCursor field for cursor-based pagination", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -6873,12 +7947,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId"], + "required": [ + "sessionId" + ], "x-side": "agent", "x-method": "session/delete" }, @@ -6918,12 +7997,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "cwd"], + "required": [ + "sessionId", + "cwd" + ], "x-side": "agent", "x-method": "session/fork" }, @@ -6963,12 +8048,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "cwd"], + "required": [ + "sessionId", + "cwd" + ], "x-side": "agent", "x-method": "session/resume" }, @@ -6986,12 +8077,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId"], + "required": [ + "sessionId" + ], "x-side": "agent", "x-method": "session/close" }, @@ -7017,12 +8113,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "modeId"], + "required": [ + "sessionId", + "modeId" + ], "x-side": "agent", "x-method": "session/set_mode" }, @@ -7048,12 +8150,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "configId"], + "required": [ + "sessionId", + "configId" + ], "anyOf": [ { "description": "A boolean value (`type: \"boolean\"`).", @@ -7068,7 +8176,10 @@ "const": "boolean" } }, - "required": ["type", "value"] + "required": [ + "type", + "value" + ] }, { "title": "value_id", @@ -7084,7 +8195,9 @@ ] } }, - "required": ["value"] + "required": [ + "value" + ] } ], "x-side": "agent", @@ -7113,12 +8226,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "prompt"], + "required": [ + "sessionId", + "prompt" + ], "x-side": "agent", "x-method": "session/prompt" }, @@ -7128,12 +8247,18 @@ "properties": { "workspaceUri": { "description": "The root URI of the workspace.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "workspaceFolders": { "description": "The workspace folders.", - "type": ["array", "null"], + "type": [ + "array", + "null" + ], "items": { "$ref": "#/$defs/WorkspaceFolder" }, @@ -7154,7 +8279,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -7176,12 +8304,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["uri", "name"] + "required": [ + "uri", + "name" + ] }, "NesRepository": { "description": "Repository metadata for an NES session.", @@ -7201,12 +8335,19 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["name", "owner", "remoteUrl"] + "required": [ + "name", + "owner", + "remoteUrl" + ] }, "SuggestNesRequest": { "description": "Request for a code suggestion.", @@ -7271,12 +8412,21 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "uri", "version", "position", "triggerKind"], + "required": [ + "sessionId", + "uri", + "version", + "position", + "triggerKind" + ], "x-side": "agent", "x-method": "nes/suggest" }, @@ -7306,7 +8456,10 @@ "properties": { "recentFiles": { "description": "Recently accessed files.", - "type": ["array", "null"], + "type": [ + "array", + "null" + ], "items": { "$ref": "#/$defs/NesRecentFile" }, @@ -7315,7 +8468,10 @@ }, "relatedSnippets": { "description": "Related code snippets.", - "type": ["array", "null"], + "type": [ + "array", + "null" + ], "items": { "$ref": "#/$defs/NesRelatedSnippet" }, @@ -7324,7 +8480,10 @@ }, "editHistory": { "description": "Recent edit history.", - "type": ["array", "null"], + "type": [ + "array", + "null" + ], "items": { "$ref": "#/$defs/NesEditHistoryEntry" }, @@ -7333,7 +8492,10 @@ }, "userActions": { "description": "Recent user actions (typing, navigation, etc.).", - "type": ["array", "null"], + "type": [ + "array", + "null" + ], "items": { "$ref": "#/$defs/NesUserAction" }, @@ -7342,7 +8504,10 @@ }, "openFiles": { "description": "Currently open files in the editor.", - "type": ["array", "null"], + "type": [ + "array", + "null" + ], "items": { "$ref": "#/$defs/NesOpenFile" }, @@ -7351,7 +8516,10 @@ }, "diagnostics": { "description": "Current diagnostics (errors, warnings).", - "type": ["array", "null"], + "type": [ + "array", + "null" + ], "items": { "$ref": "#/$defs/NesDiagnostic" }, @@ -7360,7 +8528,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -7384,12 +8555,19 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["uri", "languageId", "text"] + "required": [ + "uri", + "languageId", + "text" + ] }, "NesRelatedSnippet": { "description": "A related code snippet from a file.", @@ -7410,12 +8588,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["uri", "excerpts"] + "required": [ + "uri", + "excerpts" + ] }, "NesExcerpt": { "description": "A code excerpt from a file.", @@ -7439,12 +8623,19 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["startLine", "endLine", "text"] + "required": [ + "startLine", + "endLine", + "text" + ] }, "NesEditHistoryEntry": { "description": "An entry in the edit history.", @@ -7460,12 +8651,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["uri", "diff"] + "required": [ + "uri", + "diff" + ] }, "NesUserAction": { "description": "A user action (typing, cursor movement, etc.).", @@ -7495,12 +8692,20 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["action", "uri", "position", "timestampMs"] + "required": [ + "action", + "uri", + "position", + "timestampMs" + ] }, "NesOpenFile": { "description": "An open file in the editor.", @@ -7528,19 +8733,28 @@ }, "lastFocusedMs": { "description": "Timestamp in milliseconds since epoch of when the file was last focused.", - "type": ["integer", "null"], + "type": [ + "integer", + "null" + ], "format": "uint64", "minimum": 0, "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["uri", "languageId"] + "required": [ + "uri", + "languageId" + ] }, "NesDiagnostic": { "description": "A diagnostic (error, warning, etc.).", @@ -7572,12 +8786,20 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["uri", "range", "severity", "message"] + "required": [ + "uri", + "range", + "severity", + "message" + ] }, "NesDiagnosticSeverity": { "description": "Severity of a diagnostic.", @@ -7618,12 +8840,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId"], + "required": [ + "sessionId" + ], "x-side": "agent", "x-method": "nes/close" }, @@ -7746,27 +8973,30 @@ ] }, { - "title": "ExtMethodResponse", - "description": "Successful result returned by an extension method outside the core ACP method set.", + "title": "MessageMcpResponse", + "description": "Successful result returned by an MCP-over-ACP `mcp/message` request.", "allOf": [ { - "$ref": "#/$defs/ExtResponse" + "$ref": "#/$defs/MessageMcpResponse" } ] }, { - "title": "MessageMcpResponse", - "description": "Successful result returned by an MCP-over-ACP `mcp/message` request.", + "title": "ExtMethodResponse", + "description": "Successful result returned by an extension method outside the core ACP method set.", "allOf": [ { - "$ref": "#/$defs/MessageMcpResponse" + "$ref": "#/$defs/ExtResponse" } ] } ] } }, - "required": ["id", "result"] + "required": [ + "id", + "result" + ] }, { "title": "Error", @@ -7790,7 +9020,10 @@ ] } }, - "required": ["id", "error"] + "required": [ + "id", + "error" + ] } ], "x-docs-ignore": true @@ -7801,7 +9034,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -7819,12 +9055,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["content"], + "required": [ + "content" + ], "x-side": "client", "x-method": "fs/read_text_file" }, @@ -7842,12 +9083,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["outcome"], + "required": [ + "outcome" + ], "x-side": "client", "x-method": "session/request_permission" }, @@ -7863,7 +9109,9 @@ "const": "cancelled" } }, - "required": ["outcome"] + "required": [ + "outcome" + ] }, { "description": "The user selected one of the provided options.", @@ -7874,7 +9122,9 @@ "const": "selected" } }, - "required": ["outcome"], + "required": [ + "outcome" + ], "allOf": [ { "$ref": "#/$defs/SelectedPermissionOutcome" @@ -7900,12 +9150,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["optionId"] + "required": [ + "optionId" + ] }, "CreateTerminalResponse": { "description": "Response containing the ID of the created terminal.", @@ -7921,12 +9176,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["terminalId"], + "required": [ + "terminalId" + ], "x-side": "client", "x-method": "terminal/create" }, @@ -7956,12 +9216,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["output", "truncated"], + "required": [ + "output", + "truncated" + ], "x-side": "client", "x-method": "terminal/output" }, @@ -7971,19 +9237,28 @@ "properties": { "exitCode": { "description": "The process exit code (may be null if terminated by signal).", - "type": ["integer", "null"], + "type": [ + "integer", + "null" + ], "format": "uint32", "minimum": 0, "x-deserialize-default-on-error": true }, "signal": { "description": "The signal that terminated the process (may be null if exited normally).", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -7995,7 +9270,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -8009,19 +9287,28 @@ "properties": { "exitCode": { "description": "The process exit code (may be null if terminated by signal).", - "type": ["integer", "null"], + "type": [ + "integer", + "null" + ], "format": "uint32", "minimum": 0, "x-deserialize-default-on-error": true }, "signal": { "description": "The signal that terminated the process (may be null if exited normally).", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -8035,7 +9322,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -8049,7 +9339,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -8064,7 +9357,9 @@ "const": "accept" } }, - "required": ["action"], + "required": [ + "action" + ], "allOf": [ { "$ref": "#/$defs/ElicitationAcceptAction" @@ -8080,7 +9375,9 @@ "const": "decline" } }, - "required": ["action"] + "required": [ + "action" + ] }, { "description": "The elicitation was cancelled.", @@ -8091,7 +9388,9 @@ "const": "cancel" } }, - "required": ["action"] + "required": [ + "action" + ] } ], "discriminator": { @@ -8141,7 +9440,10 @@ "properties": { "content": { "description": "The user-provided content, if any, as an object matching the requested schema.", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": { "$ref": "#/$defs/ElicitationContentValue" @@ -8163,12 +9465,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["connectionId"], + "required": [ + "connectionId" + ], "x-side": "client", "x-method": "mcp/connect" }, @@ -8178,7 +9485,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -8298,7 +9608,9 @@ ] } }, - "required": ["method"], + "required": [ + "method" + ], "x-docs-ignore": true }, "CancelNotification": { @@ -8315,12 +9627,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId"], + "required": [ + "sessionId" + ], "x-side": "agent", "x-method": "session/cancel" }, @@ -8355,12 +9672,21 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "uri", "languageId", "version", "text"], + "required": [ + "sessionId", + "uri", + "languageId", + "version", + "text" + ], "x-side": "agent", "x-method": "document/didOpen" }, @@ -8396,12 +9722,20 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "uri", "version", "contentChanges"], + "required": [ + "sessionId", + "uri", + "version", + "contentChanges" + ], "x-side": "agent", "x-method": "document/didChange" }, @@ -8427,12 +9761,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["text"] + "required": [ + "text" + ] }, "DidCloseDocumentNotification": { "description": "Notification sent when a file is closed.", @@ -8452,12 +9791,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "uri"], + "required": [ + "sessionId", + "uri" + ], "x-side": "agent", "x-method": "document/didClose" }, @@ -8479,12 +9824,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "uri"], + "required": [ + "sessionId", + "uri" + ], "x-side": "agent", "x-method": "document/didSave" }, @@ -8527,12 +9878,21 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "uri", "version", "position", "visibleRange"], + "required": [ + "sessionId", + "uri", + "version", + "position", + "visibleRange" + ], "x-side": "agent", "x-method": "document/didFocus" }, @@ -8554,12 +9914,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "id"], + "required": [ + "sessionId", + "id" + ], "x-side": "agent", "x-method": "nes/accept" }, @@ -8593,12 +9959,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "id"], + "required": [ + "sessionId", + "id" + ], "x-side": "agent", "x-method": "nes/reject" }, @@ -8641,14 +10013,19 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["requestId"], + "required": [ + "requestId" + ], "x-side": "protocol", "x-method": "$/cancel_request" } } -} +} \ No newline at end of file diff --git a/schema/v2/meta.json b/schema/v2/meta.json index e1ecdb25a..24d94da14 100644 --- a/schema/v2/meta.json +++ b/schema/v2/meta.json @@ -18,4 +18,4 @@ "session_request_permission": "session/request_permission", "session_update": "session/update" } -} +} \ No newline at end of file diff --git a/schema/v2/schema.json b/schema/v2/schema.json index b54695397..fc7b02028 100644 --- a/schema/v2/schema.json +++ b/schema/v2/schema.json @@ -9,10 +9,14 @@ "properties": { "jsonrpc": { "type": "string", - "enum": ["2.0"] + "enum": [ + "2.0" + ] } }, - "required": ["jsonrpc"], + "required": [ + "jsonrpc" + ], "anyOf": [ { "title": "Request", @@ -47,10 +51,14 @@ "properties": { "jsonrpc": { "type": "string", - "enum": ["2.0"] + "enum": [ + "2.0" + ] } }, - "required": ["jsonrpc"], + "required": [ + "jsonrpc" + ], "anyOf": [ { "title": "Request", @@ -88,10 +96,14 @@ "properties": { "jsonrpc": { "type": "string", - "enum": ["2.0"] + "enum": [ + "2.0" + ] } }, - "required": ["jsonrpc"], + "required": [ + "jsonrpc" + ], "anyOf": [ { "title": "Request", @@ -123,10 +135,14 @@ "properties": { "jsonrpc": { "type": "string", - "enum": ["2.0"] + "enum": [ + "2.0" + ] } }, - "required": ["jsonrpc"], + "required": [ + "jsonrpc" + ], "anyOf": [ { "title": "Result", @@ -255,7 +271,10 @@ ] } }, - "required": ["id", "result"] + "required": [ + "id", + "result" + ] }, { "title": "Error", @@ -279,7 +298,10 @@ ] } }, - "required": ["id", "error"] + "required": [ + "id", + "error" + ] } ], "x-docs-ignore": true @@ -296,10 +318,14 @@ "properties": { "jsonrpc": { "type": "string", - "enum": ["2.0"] + "enum": [ + "2.0" + ] } }, - "required": ["jsonrpc"], + "required": [ + "jsonrpc" + ], "anyOf": [ { "title": "Request", @@ -331,10 +357,14 @@ "properties": { "jsonrpc": { "type": "string", - "enum": ["2.0"] + "enum": [ + "2.0" + ] } }, - "required": ["jsonrpc"], + "required": [ + "jsonrpc" + ], "anyOf": [ { "title": "Result", @@ -373,7 +403,10 @@ ] } }, - "required": ["id", "result"] + "required": [ + "id", + "result" + ] }, { "title": "Error", @@ -397,7 +430,10 @@ ] } }, - "required": ["id", "error"] + "required": [ + "id", + "error" + ] } ], "x-docs-ignore": true @@ -454,7 +490,10 @@ ] } }, - "required": ["id", "method"], + "required": [ + "id", + "method" + ], "x-docs-ignore": true }, "RequestId": { @@ -509,12 +548,19 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "toolCall", "options"], + "required": [ + "sessionId", + "toolCall", + "options" + ], "x-side": "client", "x-method": "session/request_permission" }, @@ -536,7 +582,10 @@ }, "title": { "description": "Human-readable title describing what the tool is doing.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "kind": { @@ -565,7 +614,10 @@ }, "content": { "description": "Content produced by the tool call.", - "type": ["array", "null"], + "type": [ + "array", + "null" + ], "items": { "$ref": "#/$defs/ToolCallContent" }, @@ -574,7 +626,10 @@ }, "locations": { "description": "File locations affected by this tool call.\nEnables \"follow-along\" features in clients.", - "type": ["array", "null"], + "type": [ + "array", + "null" + ], "items": { "$ref": "#/$defs/ToolCallLocation" }, @@ -591,12 +646,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["toolCallId"] + "required": [ + "toolCallId" + ] }, "ToolCallId": { "description": "Unique identifier for a tool call within a session.", @@ -704,7 +764,9 @@ "const": "content" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/Content" @@ -720,7 +782,9 @@ "const": "diff" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/Diff" @@ -737,7 +801,9 @@ "type": "string" } }, - "required": ["type"], + "required": [ + "type" + ], "not": { "anyOf": [ { @@ -748,7 +814,9 @@ "const": "content" } }, - "required": ["type"] + "required": [ + "type" + ] }, { "type": "object", @@ -758,7 +826,9 @@ "const": "diff" } }, - "required": ["type"] + "required": [ + "type" + ] } ] }, @@ -781,7 +851,9 @@ "const": "text" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/TextContent" @@ -797,7 +869,9 @@ "const": "image" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/ImageContent" @@ -813,7 +887,9 @@ "const": "audio" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/AudioContent" @@ -829,7 +905,9 @@ "const": "resource_link" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/ResourceLink" @@ -845,7 +923,9 @@ "const": "resource" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/EmbeddedResource" @@ -862,7 +942,9 @@ "type": "string" } }, - "required": ["type"], + "required": [ + "type" + ], "not": { "anyOf": [ { @@ -873,7 +955,9 @@ "const": "text" } }, - "required": ["type"] + "required": [ + "type" + ] }, { "type": "object", @@ -883,7 +967,9 @@ "const": "image" } }, - "required": ["type"] + "required": [ + "type" + ] }, { "type": "object", @@ -893,7 +979,9 @@ "const": "audio" } }, - "required": ["type"] + "required": [ + "type" + ] }, { "type": "object", @@ -903,7 +991,9 @@ "const": "resource_link" } }, - "required": ["type"] + "required": [ + "type" + ] }, { "type": "object", @@ -913,7 +1003,9 @@ "const": "resource" } }, - "required": ["type"] + "required": [ + "type" + ] } ] }, @@ -930,7 +1022,10 @@ "properties": { "audience": { "description": "Intended recipients for this content, such as the user or assistant.", - "type": ["array", "null"], + "type": [ + "array", + "null" + ], "items": { "$ref": "#/$defs/Role" }, @@ -939,18 +1034,27 @@ }, "lastModified": { "description": "Timestamp indicating when the underlying resource was last modified.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "priority": { "description": "Relative importance of this content when clients choose what to surface.", - "type": ["number", "null"], + "type": [ + "number", + "null" + ], "format": "double", "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -998,12 +1102,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["text"] + "required": [ + "text" + ] }, "ImageContent": { "description": "An image provided to or from an LLM.", @@ -1031,17 +1140,26 @@ }, "uri": { "description": "URI associated with this resource or media payload.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["data", "mimeType"] + "required": [ + "data", + "mimeType" + ] }, "AudioContent": { "description": "Audio provided to or from an LLM.", @@ -1069,12 +1187,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["data", "mimeType"] + "required": [ + "data", + "mimeType" + ] }, "ResourceLink": { "description": "A resource that the server is capable of reading, included in a prompt or tool call result.", @@ -1094,12 +1218,18 @@ }, "description": { "description": "Optional human-readable details shown with this protocol object.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "mimeType": { "description": "MIME type describing the encoded media payload.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "name": { @@ -1108,13 +1238,19 @@ }, "size": { "description": "Optional size of the linked resource in bytes, if known.", - "type": ["integer", "null"], + "type": [ + "integer", + "null" + ], "format": "int64", "x-deserialize-default-on-error": true }, "title": { "description": "Optional display title for end-user UI.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "uri": { @@ -1123,12 +1259,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["name", "uri"] + "required": [ + "name", + "uri" + ] }, "EmbeddedResourceResource": { "description": "Resource content that can be embedded in a message.", @@ -1159,7 +1301,10 @@ "properties": { "mimeType": { "description": "MIME type describing the encoded media payload.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "text": { @@ -1172,12 +1317,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["text", "uri"] + "required": [ + "text", + "uri" + ] }, "BlobResourceContents": { "description": "Binary resource contents.", @@ -1189,7 +1340,10 @@ }, "mimeType": { "description": "MIME type describing the encoded media payload.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "uri": { @@ -1198,12 +1352,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["blob", "uri"] + "required": [ + "blob", + "uri" + ] }, "EmbeddedResource": { "description": "The contents of a resource, embedded into a prompt or tool call result.", @@ -1231,12 +1391,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["resource"] + "required": [ + "resource" + ] }, "Content": { "description": "Standard content block (text, images, resources).", @@ -1252,12 +1417,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["content"] + "required": [ + "content" + ] }, "Diff": { "description": "A diff representing file modifications.\n\nShows changes to files in a format suitable for display in the client UI.\n\nSee protocol docs: [Content](https://agentclientprotocol.com/protocol/v2/tool-calls#content)", @@ -1269,7 +1439,10 @@ }, "oldText": { "description": "The original content (None for new files).", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "newText": { @@ -1278,12 +1451,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["path", "newText"] + "required": [ + "path", + "newText" + ] }, "ToolCallLocation": { "description": "A file location being accessed or modified by a tool.\n\nEnables clients to implement \"follow-along\" features that track\nwhich files the agent is working with in real-time.\n\nSee protocol docs: [Following the Agent](https://agentclientprotocol.com/protocol/v2/tool-calls#following-the-agent)", @@ -1295,19 +1474,27 @@ }, "line": { "description": "Optional line number within the file.", - "type": ["integer", "null"], + "type": [ + "integer", + "null" + ], "format": "uint32", "minimum": 0, "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["path"] + "required": [ + "path" + ] }, "PermissionOption": { "description": "An option presented to the user when requesting permission.", @@ -1335,12 +1522,19 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["optionId", "name", "kind"] + "required": [ + "optionId", + "name", + "kind" + ] }, "PermissionOptionId": { "description": "Unique identifier for a permission option.", @@ -1509,7 +1703,10 @@ ] } }, - "required": ["id", "result"] + "required": [ + "id", + "result" + ] }, { "title": "Error", @@ -1533,7 +1730,10 @@ ] } }, - "required": ["id", "error"] + "required": [ + "id", + "error" + ] } ], "x-docs-ignore": true @@ -1580,12 +1780,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["protocolVersion", "info"], + "required": [ + "protocolVersion", + "info" + ], "x-side": "agent", "x-method": "initialize" }, @@ -1606,7 +1812,10 @@ }, "title": { "description": "Intended for UI and end-user contexts — optimized to be human-readable\nand easily understood.\n\nIf not provided, the name should be used for display.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "version": { @@ -1615,12 +1824,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["name", "version"] + "required": [ + "name", + "version" + ] }, "AgentCapabilities": { "description": "Capabilities supported by the agent.\n\nAdvertised during initialization to inform the client about\navailable features and content types.\n\nSee protocol docs: [Agent Capabilities](https://agentclientprotocol.com/protocol/v2/initialization#agent-capabilities)", @@ -1652,7 +1867,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1760,7 +1978,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1808,7 +2029,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1820,7 +2044,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1832,7 +2059,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1844,7 +2074,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1880,7 +2113,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1892,7 +2128,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1904,7 +2143,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1916,7 +2158,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1928,7 +2173,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1940,7 +2188,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1952,7 +2203,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1964,7 +2218,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1976,7 +2233,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1988,7 +2248,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2006,7 +2269,9 @@ "const": "agent" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/AuthMethodAgent" @@ -2036,17 +2301,27 @@ }, "description": { "description": "Optional description providing more details about this authentication method.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["type", "id", "name"], + "required": [ + "type", + "id", + "name" + ], "not": { "anyOf": [ { @@ -2057,7 +2332,9 @@ "const": "agent" } }, - "required": ["type"] + "required": [ + "type" + ] } ] }, @@ -2087,17 +2364,26 @@ }, "description": { "description": "Optional description providing more details about this authentication method.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["id", "name"] + "required": [ + "id", + "name" + ] }, "LoginAuthResponse": { "description": "Response to the `auth/login` method.", @@ -2105,7 +2391,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2119,7 +2408,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2141,7 +2433,10 @@ }, "configOptions": { "description": "Initial session configuration options if supported by the Agent.", - "type": ["array", "null"], + "type": [ + "array", + "null" + ], "items": { "$ref": "#/$defs/SessionConfigOption" }, @@ -2150,12 +2445,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId"], + "required": [ + "sessionId" + ], "x-side": "agent", "x-method": "session/new" }, @@ -2177,7 +2477,10 @@ }, "description": { "description": "Optional description for the Client to display to the user.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "category": { @@ -2194,12 +2497,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["id", "name"], + "required": [ + "id", + "name" + ], "anyOf": [ { "description": "Single-value selector (dropdown).", @@ -2210,7 +2519,9 @@ "const": "select" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/SessionConfigSelect" @@ -2227,7 +2538,9 @@ "type": "string" } }, - "required": ["type"], + "required": [ + "type" + ], "not": { "anyOf": [ { @@ -2238,7 +2551,9 @@ "const": "select" } }, - "required": ["type"] + "required": [ + "type" + ] } ] }, @@ -2326,17 +2641,26 @@ }, "description": { "description": "Optional description for this option value.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["value", "name"] + "required": [ + "value", + "name" + ] }, "SessionConfigSelectGroup": { "description": "A group of possible values for a session configuration option.", @@ -2365,12 +2689,19 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["group", "name", "options"] + "required": [ + "group", + "name", + "options" + ] }, "SessionConfigGroupId": { "description": "Unique identifier for a session configuration option value group.", @@ -2397,7 +2728,10 @@ ] } }, - "required": ["currentValue", "options"] + "required": [ + "currentValue", + "options" + ] }, "LoadSessionResponse": { "description": "Response from loading an existing session.", @@ -2405,7 +2739,10 @@ "properties": { "configOptions": { "description": "Initial session configuration options if supported by the Agent.", - "type": ["array", "null"], + "type": [ + "array", + "null" + ], "items": { "$ref": "#/$defs/SessionConfigOption" }, @@ -2414,7 +2751,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2437,17 +2777,25 @@ }, "nextCursor": { "description": "Opaque cursor token. If present, pass this in the next request's cursor parameter\nto fetch the next page. If absent, there are no more results.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessions"], + "required": [ + "sessions" + ], "x-side": "agent", "x-method": "session/list" }, @@ -2478,22 +2826,34 @@ }, "title": { "description": "Human-readable title for the session", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "updatedAt": { "description": "ISO 8601 timestamp of last activity", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "cwd"] + "required": [ + "sessionId", + "cwd" + ] }, "DeleteSessionResponse": { "description": "Response from deleting a session.", @@ -2501,7 +2861,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2515,7 +2878,10 @@ "properties": { "configOptions": { "description": "Initial session configuration options if supported by the Agent.", - "type": ["array", "null"], + "type": [ + "array", + "null" + ], "items": { "$ref": "#/$defs/SessionConfigOption" }, @@ -2524,7 +2890,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2538,7 +2907,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2561,12 +2933,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["configOptions"], + "required": [ + "configOptions" + ], "x-side": "agent", "x-method": "session/set_config_option" }, @@ -2576,7 +2953,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2608,7 +2988,10 @@ "x-deserialize-default-on-error": true } }, - "required": ["code", "message"] + "required": [ + "code", + "message" + ] }, "ErrorCode": { "description": "Predefined error codes for common JSON-RPC and ACP-specific errors.\n\nThese codes follow the JSON-RPC 2.0 specification for standard errors\nand use the reserved range (-32000 to -32099) for protocol-specific errors.", @@ -2685,11 +3068,11 @@ "description": "All possible notifications that an agent can send to a client.\n\nThis enum is used internally for routing RPC notifications. You typically won't need\nto use this directly.\n\nNotifications do not expect a response.", "anyOf": [ { - "title": "SessionNotification", + "title": "UpdateSessionNotification", "description": "Handles session update notifications from the agent.\n\nThis is a notification endpoint (no response expected) that receives\nreal-time updates about session progress, including message updates,\nmessage chunks, tool calls, and execution plans.\n\nNote: Clients SHOULD continue accepting tool call updates even after\nsending a `session/cancel` notification, as the agent may send final\nupdates before reporting an idle `state_update` with the cancelled\nstop reason.\n\nSee protocol docs: [Agent Reports Output](https://agentclientprotocol.com/protocol/v2/prompt-lifecycle#3-agent-reports-output)", "allOf": [ { - "$ref": "#/$defs/SessionNotification" + "$ref": "#/$defs/UpdateSessionNotification" } ] }, @@ -2710,10 +3093,12 @@ ] } }, - "required": ["method"], + "required": [ + "method" + ], "x-docs-ignore": true }, - "SessionNotification": { + "UpdateSessionNotification": { "description": "Notification containing a session update from the agent.\n\nUsed to stream real-time progress and results during prompt processing.\n\nSee protocol docs: [Agent Reports Output](https://agentclientprotocol.com/protocol/v2/prompt-lifecycle#3-agent-reports-output)", "type": "object", "properties": { @@ -2735,12 +3120,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "update"], + "required": [ + "sessionId", + "update" + ], "x-side": "client", "x-method": "session/update" }, @@ -2756,7 +3147,9 @@ "const": "user_message_chunk" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/ContentChunk" @@ -2772,7 +3165,9 @@ "const": "user_message" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/UserMessage" @@ -2788,7 +3183,9 @@ "const": "agent_message_chunk" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/ContentChunk" @@ -2804,7 +3201,9 @@ "const": "agent_message" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/AgentMessage" @@ -2820,7 +3219,9 @@ "const": "agent_thought_chunk" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/ContentChunk" @@ -2836,7 +3237,9 @@ "const": "agent_thought" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/AgentThought" @@ -2852,7 +3255,9 @@ "const": "state_update" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/StateUpdate" @@ -2868,7 +3273,9 @@ "const": "tool_call_content_chunk" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/ToolCallContentChunk" @@ -2884,7 +3291,9 @@ "const": "tool_call_update" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/ToolCallUpdate" @@ -2900,7 +3309,9 @@ "const": "plan_update" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/PlanUpdate" @@ -2916,7 +3327,9 @@ "const": "available_commands_update" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/AvailableCommandsUpdate" @@ -2932,7 +3345,9 @@ "const": "config_option_update" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/ConfigOptionUpdate" @@ -2948,7 +3363,9 @@ "const": "session_info_update" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/SessionInfoUpdate" @@ -2964,7 +3381,9 @@ "const": "usage_update" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "allOf": [ { "$ref": "#/$defs/UsageUpdate" @@ -2981,7 +3400,9 @@ "type": "string" } }, - "required": ["sessionUpdate"], + "required": [ + "sessionUpdate" + ], "not": { "anyOf": [ { @@ -2992,7 +3413,9 @@ "const": "user_message_chunk" } }, - "required": ["sessionUpdate"] + "required": [ + "sessionUpdate" + ] }, { "type": "object", @@ -3002,7 +3425,9 @@ "const": "user_message" } }, - "required": ["sessionUpdate"] + "required": [ + "sessionUpdate" + ] }, { "type": "object", @@ -3012,7 +3437,9 @@ "const": "agent_message_chunk" } }, - "required": ["sessionUpdate"] + "required": [ + "sessionUpdate" + ] }, { "type": "object", @@ -3022,7 +3449,9 @@ "const": "agent_message" } }, - "required": ["sessionUpdate"] + "required": [ + "sessionUpdate" + ] }, { "type": "object", @@ -3032,7 +3461,9 @@ "const": "agent_thought_chunk" } }, - "required": ["sessionUpdate"] + "required": [ + "sessionUpdate" + ] }, { "type": "object", @@ -3042,7 +3473,9 @@ "const": "agent_thought" } }, - "required": ["sessionUpdate"] + "required": [ + "sessionUpdate" + ] }, { "type": "object", @@ -3052,7 +3485,9 @@ "const": "state_update" } }, - "required": ["sessionUpdate"] + "required": [ + "sessionUpdate" + ] }, { "type": "object", @@ -3062,7 +3497,9 @@ "const": "tool_call_content_chunk" } }, - "required": ["sessionUpdate"] + "required": [ + "sessionUpdate" + ] }, { "type": "object", @@ -3072,7 +3509,9 @@ "const": "tool_call_update" } }, - "required": ["sessionUpdate"] + "required": [ + "sessionUpdate" + ] }, { "type": "object", @@ -3082,7 +3521,9 @@ "const": "plan_update" } }, - "required": ["sessionUpdate"] + "required": [ + "sessionUpdate" + ] }, { "type": "object", @@ -3092,7 +3533,9 @@ "const": "available_commands_update" } }, - "required": ["sessionUpdate"] + "required": [ + "sessionUpdate" + ] }, { "type": "object", @@ -3102,7 +3545,9 @@ "const": "config_option_update" } }, - "required": ["sessionUpdate"] + "required": [ + "sessionUpdate" + ] }, { "type": "object", @@ -3112,7 +3557,9 @@ "const": "session_info_update" } }, - "required": ["sessionUpdate"] + "required": [ + "sessionUpdate" + ] }, { "type": "object", @@ -3122,7 +3569,9 @@ "const": "usage_update" } }, - "required": ["sessionUpdate"] + "required": [ + "sessionUpdate" + ] } ] }, @@ -3141,30 +3590,36 @@ "description": "A streamed item of content", "type": "object", "properties": { - "content": { - "description": "A single item of content", + "messageId": { + "description": "A unique identifier for the message this chunk belongs to.\n\nAll chunks belonging to the same message share the same `messageId`.\nA change in `messageId` indicates a new message has started.", "allOf": [ { - "$ref": "#/$defs/ContentBlock" + "$ref": "#/$defs/MessageId" } ] }, - "messageId": { - "description": "A unique identifier for the message this chunk belongs to.\n\nAll chunks belonging to the same message share the same `messageId`.\nA change in `messageId` indicates a new message has started.", + "content": { + "description": "A single item of content", "allOf": [ { - "$ref": "#/$defs/MessageId" + "$ref": "#/$defs/ContentBlock" } ] }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["content", "messageId"] + "required": [ + "messageId", + "content" + ] }, "UserMessage": { "description": "A user message upsert.\n\nOnly [`UserMessage::message_id`] is required. Other fields have patch\nsemantics: omitted fields leave the existing message value unchanged, `null`\nclears or unsets the value, and concrete values replace the previous value.\nFor a new `messageId`, omitted fields use client defaults. `content` is\nreplaced as a whole array; send `[]` or `null` to clear it.\n\nMessage updates and chunks are applied in the order they are received. When\na `user_message` update includes `content`, that array replaces any content\npreviously accumulated for the message, including content from earlier\nchunks. Later chunks with the same `messageId` append to the current\ncontent.", @@ -3180,7 +3635,10 @@ }, "content": { "description": "Complete replacement content for this message.", - "type": ["array", "null"], + "type": [ + "array", + "null" + ], "items": { "$ref": "#/$defs/ContentBlock" }, @@ -3189,12 +3647,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["messageId"] + "required": [ + "messageId" + ] }, "AgentMessage": { "description": "An agent message upsert.\n\nOnly [`AgentMessage::message_id`] is required. Other fields have patch\nsemantics: omitted fields leave the existing message value unchanged, `null`\nclears or unsets the value, and concrete values replace the previous value.\nFor a new `messageId`, omitted fields use client defaults. `content` is\nreplaced as a whole array; send `[]` or `null` to clear it.\n\nMessage updates and chunks are applied in the order they are received. When\nan `agent_message` update includes `content`, that array replaces any\ncontent previously accumulated for the message, including content from\nearlier chunks. Later chunks with the same `messageId` append to the current\ncontent.", @@ -3210,7 +3673,10 @@ }, "content": { "description": "Complete replacement content for this message.", - "type": ["array", "null"], + "type": [ + "array", + "null" + ], "items": { "$ref": "#/$defs/ContentBlock" }, @@ -3219,12 +3685,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["messageId"] + "required": [ + "messageId" + ] }, "AgentThought": { "description": "An agent thought or reasoning message upsert.\n\nOnly [`AgentThought::message_id`] is required. Other fields have patch\nsemantics: omitted fields leave the existing thought value unchanged, `null`\nclears or unsets the value, and concrete values replace the previous value.\nFor a new `messageId`, omitted fields use client defaults. `content` is\nreplaced as a whole array; send `[]` or `null` to clear it.\n\nMessage updates and chunks are applied in the order they are received. When\nan `agent_thought` update includes `content`, that array replaces any\ncontent previously accumulated for the thought, including content from\nearlier chunks. Later chunks with the same `messageId` append to the current\ncontent.", @@ -3240,7 +3711,10 @@ }, "content": { "description": "Complete replacement content for this thought message.", - "type": ["array", "null"], + "type": [ + "array", + "null" + ], "items": { "$ref": "#/$defs/ContentBlock" }, @@ -3249,12 +3723,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["messageId"] + "required": [ + "messageId" + ] }, "RunningStateUpdate": { "description": "The agent is actively processing work in the session.", @@ -3262,7 +3741,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3321,7 +3803,10 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3333,7 +3818,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3351,7 +3839,9 @@ "const": "running" } }, - "required": ["state"], + "required": [ + "state" + ], "allOf": [ { "$ref": "#/$defs/RunningStateUpdate" @@ -3367,7 +3857,9 @@ "const": "idle" } }, - "required": ["state"], + "required": [ + "state" + ], "allOf": [ { "$ref": "#/$defs/IdleStateUpdate" @@ -3383,7 +3875,9 @@ "const": "requires_action" } }, - "required": ["state"], + "required": [ + "state" + ], "allOf": [ { "$ref": "#/$defs/RequiresActionStateUpdate" @@ -3400,7 +3894,9 @@ "type": "string" } }, - "required": ["state"], + "required": [ + "state" + ], "not": { "anyOf": [ { @@ -3411,7 +3907,9 @@ "const": "running" } }, - "required": ["state"] + "required": [ + "state" + ] }, { "type": "object", @@ -3421,7 +3919,9 @@ "const": "idle" } }, - "required": ["state"] + "required": [ + "state" + ] }, { "type": "object", @@ -3431,7 +3931,9 @@ "const": "requires_action" } }, - "required": ["state"] + "required": [ + "state" + ] } ] }, @@ -3464,12 +3966,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys. This field is optional; omitted or `null` means there is no\nchunk-level metadata.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["toolCallId", "content"] + "required": [ + "toolCallId", + "content" + ] }, "PlanUpdateContent": { "description": "Updated content for a plan.", @@ -3483,7 +3991,9 @@ "const": "items" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/PlanItems" @@ -3508,7 +4018,10 @@ ] } }, - "required": ["type", "id"], + "required": [ + "type", + "id" + ], "not": { "anyOf": [ { @@ -3519,7 +4032,9 @@ "const": "items" } }, - "required": ["type"] + "required": [ + "type" + ] }, { "type": "object", @@ -3529,7 +4044,9 @@ "const": "file" } }, - "required": ["type"] + "required": [ + "type" + ] }, { "type": "object", @@ -3539,7 +4056,9 @@ "const": "markdown" } }, - "required": ["type"] + "required": [ + "type" + ] } ] }, @@ -3580,12 +4099,19 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["content", "priority", "status"] + "required": [ + "content", + "priority", + "status" + ] }, "PlanEntryPriority": { "description": "Priority levels for plan entries.\n\nUsed to indicate the relative importance or urgency of different\ntasks in the execution plan.\nSee protocol docs: [Plan Entries](https://agentclientprotocol.com/protocol/v2/agent-plan#plan-entries)", @@ -3660,12 +4186,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["id", "entries"] + "required": [ + "id", + "entries" + ] }, "PlanUpdate": { "description": "A content update for a plan identified by ID.", @@ -3681,12 +4213,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["plan"] + "required": [ + "plan" + ] }, "AvailableCommand": { "description": "Information about a command.", @@ -3714,12 +4251,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["name", "description"] + "required": [ + "name", + "description" + ] }, "AvailableCommandInput": { "description": "The input specification for a command.", @@ -3743,7 +4286,9 @@ "type": "string" } }, - "required": ["type"], + "required": [ + "type" + ], "additionalProperties": true } ] @@ -3758,15 +4303,22 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["hint"], + "required": [ + "hint" + ], "not": { "type": "object", - "required": ["type"] + "required": [ + "type" + ] } }, "AvailableCommandsUpdate": { @@ -3784,12 +4336,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["availableCommands"] + "required": [ + "availableCommands" + ] }, "ConfigOptionUpdate": { "description": "Session configuration options have been updated.", @@ -3806,12 +4363,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["configOptions"] + "required": [ + "configOptions" + ] }, "SessionInfoUpdate": { "description": "Update to session metadata. All fields are optional to support partial updates.\n\nAgents send this notification to update session information like title or custom metadata.\nThis allows clients to display dynamic session names and track session state changes.", @@ -3819,17 +4381,26 @@ "properties": { "title": { "description": "Human-readable title for the session. Set to null to clear.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "updatedAt": { "description": "ISO 8601 timestamp of last activity. Set to null to clear.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3850,12 +4421,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["amount", "currency"] + "required": [ + "amount", + "currency" + ] }, "UsageUpdate": { "description": "Context window and cost update for a session.", @@ -3887,12 +4464,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["used", "size"] + "required": [ + "used", + "size" + ] }, "ExtNotification": { "description": "Allows the Agent to send an arbitrary notification that is not part of the ACP spec.\nExtension notifications provide a way to send one-way messages for custom functionality\nwhile maintaining protocol compatibility.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)" @@ -4035,7 +4618,10 @@ ] } }, - "required": ["id", "method"], + "required": [ + "id", + "method" + ], "x-docs-ignore": true }, "InitializeRequest": { @@ -4070,12 +4656,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["protocolVersion", "info"], + "required": [ + "protocolVersion", + "info" + ], "x-side": "agent", "x-method": "initialize" }, @@ -4085,7 +4677,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -4105,12 +4700,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["methodId"], + "required": [ + "methodId" + ], "x-side": "agent", "x-method": "auth/login" }, @@ -4120,7 +4720,10 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -4156,12 +4759,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["cwd"], + "required": [ + "cwd" + ], "x-side": "agent", "x-method": "session/new" }, @@ -4177,7 +4785,9 @@ "const": "http" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/McpServerHttp" @@ -4193,7 +4803,9 @@ "const": "stdio" } }, - "required": ["type"], + "required": [ + "type" + ], "allOf": [ { "$ref": "#/$defs/McpServerStdio" @@ -4210,7 +4822,9 @@ "type": "string" } }, - "required": ["type"], + "required": [ + "type" + ], "not": { "anyOf": [ { @@ -4221,7 +4835,9 @@ "const": "http" } }, - "required": ["type"] + "required": [ + "type" + ] }, { "type": "object", @@ -4231,7 +4847,9 @@ "const": "stdio" } }, - "required": ["type"] + "required": [ + "type" + ] } ] }, @@ -4256,12 +4874,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["name", "value"] + "required": [ + "name", + "value" + ] }, "McpServerHttp": { "description": "HTTP transport configuration for MCP.", @@ -4286,12 +4910,19 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["name", "url", "headers"] + "required": [ + "name", + "url", + "headers" + ] }, "EnvVariable": { "description": "An environment variable to set when launching an MCP server.", @@ -4307,12 +4938,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["name", "value"] + "required": [ + "name", + "value" + ] }, "McpServerStdio": { "description": "Stdio transport configuration for MCP.", @@ -4346,12 +4983,20 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["name", "command", "args", "env"] + "required": [ + "name", + "command", + "args", + "env" + ] }, "LoadSessionRequest": { "description": "Request parameters for loading an existing session.\n\nOnly available if the Agent supports the `session.load` capability.\n\nSee protocol docs: [Loading Sessions](https://agentclientprotocol.com/protocol/v2/session-setup#loading-sessions)", @@ -4389,12 +5034,19 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "cwd", "mcpServers"], + "required": [ + "sessionId", + "cwd", + "mcpServers" + ], "x-side": "agent", "x-method": "session/load" }, @@ -4404,17 +5056,26 @@ "properties": { "cwd": { "description": "Filter sessions by working directory. Must be an absolute path.", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "cursor": { "description": "Opaque cursor token from a previous response's nextCursor field for cursor-based pagination", - "type": ["string", "null"], + "type": [ + "string", + "null" + ], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -4436,12 +5097,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId"], + "required": [ + "sessionId" + ], "x-side": "agent", "x-method": "session/delete" }, @@ -4481,12 +5147,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "cwd"], + "required": [ + "sessionId", + "cwd" + ], "x-side": "agent", "x-method": "session/resume" }, @@ -4504,12 +5176,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId"], + "required": [ + "sessionId" + ], "x-side": "agent", "x-method": "session/close" }, @@ -4543,12 +5220,19 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "configId", "value"], + "required": [ + "sessionId", + "configId", + "value" + ], "x-side": "agent", "x-method": "session/set_config_option" }, @@ -4575,12 +5259,18 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId", "prompt"], + "required": [ + "sessionId", + "prompt" + ], "x-side": "agent", "x-method": "session/prompt" }, @@ -4624,7 +5314,10 @@ ] } }, - "required": ["id", "result"] + "required": [ + "id", + "result" + ] }, { "title": "Error", @@ -4648,7 +5341,10 @@ ] } }, - "required": ["id", "error"] + "required": [ + "id", + "error" + ] } ], "x-docs-ignore": true @@ -4667,12 +5363,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["outcome"], + "required": [ + "outcome" + ], "x-side": "client", "x-method": "session/request_permission" }, @@ -4688,7 +5389,9 @@ "const": "cancelled" } }, - "required": ["outcome"] + "required": [ + "outcome" + ] }, { "description": "The user selected one of the provided options.", @@ -4699,7 +5402,9 @@ "const": "selected" } }, - "required": ["outcome"], + "required": [ + "outcome" + ], "allOf": [ { "$ref": "#/$defs/SelectedPermissionOutcome" @@ -4725,12 +5430,17 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["optionId"] + "required": [ + "optionId" + ] }, "ClientNotification": { "description": "A JSON-RPC notification object.", @@ -4772,7 +5482,9 @@ ] } }, - "required": ["method"], + "required": [ + "method" + ], "x-docs-ignore": true }, "CancelSessionNotification": { @@ -4789,14 +5501,19 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": ["object", "null"], + "type": [ + "object", + "null" + ], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": ["sessionId"], + "required": [ + "sessionId" + ], "x-side": "agent", "x-method": "session/cancel" } } -} +} \ No newline at end of file diff --git a/schema/v2/schema.unstable.json b/schema/v2/schema.unstable.json index f3ddedadb..3ecaeb6ca 100644 --- a/schema/v2/schema.unstable.json +++ b/schema/v2/schema.unstable.json @@ -477,20 +477,20 @@ ] }, { - "title": "ExtMethodResponse", - "description": "Successful result returned by an extension method outside the core ACP method set.", + "title": "MessageMcpResponse", + "description": "Successful result returned by an MCP-over-ACP `mcp/message` request.", "allOf": [ { - "$ref": "#/$defs/ExtResponse" + "$ref": "#/$defs/MessageMcpResponse" } ] }, { - "title": "MessageMcpResponse", - "description": "Successful result returned by an MCP-over-ACP `mcp/message` request.", + "title": "ExtMethodResponse", + "description": "Successful result returned by an extension method outside the core ACP method set.", "allOf": [ { - "$ref": "#/$defs/MessageMcpResponse" + "$ref": "#/$defs/ExtResponse" } ] } @@ -5098,11 +5098,11 @@ "description": "All possible notifications that an agent can send to a client.\n\nThis enum is used internally for routing RPC notifications. You typically won't need\nto use this directly.\n\nNotifications do not expect a response.", "anyOf": [ { - "title": "SessionNotification", + "title": "SessionUpdateNotification", "description": "Handles session update notifications from the agent.\n\nThis is a notification endpoint (no response expected) that receives\nreal-time updates about session progress, including message updates,\nmessage chunks, tool calls, and execution plans.\n\nNote: Clients SHOULD continue accepting tool call updates even after\nsending a `session/cancel` notification, as the agent may send final\nupdates before reporting an idle `state_update` with the cancelled\nstop reason.\n\nSee protocol docs: [Agent Reports Output](https://agentclientprotocol.com/protocol/v2/draft/prompt-lifecycle#3-agent-reports-output)", "allOf": [ { - "$ref": "#/$defs/SessionNotification" + "$ref": "#/$defs/SessionUpdateNotification" } ] }, @@ -5144,7 +5144,7 @@ "required": ["method"], "x-docs-ignore": true }, - "SessionNotification": { + "SessionUpdateNotification": { "description": "Notification containing a session update from the agent.\n\nUsed to stream real-time progress and results during prompt processing.\n\nSee protocol docs: [Agent Reports Output](https://agentclientprotocol.com/protocol/v2/draft/prompt-lifecycle#3-agent-reports-output)", "type": "object", "properties": { @@ -5598,19 +5598,19 @@ "description": "A streamed item of content", "type": "object", "properties": { - "content": { - "description": "A single item of content", + "messageId": { + "description": "A unique identifier for the message this chunk belongs to.\n\nAll chunks belonging to the same message share the same `messageId`.\nA change in `messageId` indicates a new message has started.", "allOf": [ { - "$ref": "#/$defs/ContentBlock" + "$ref": "#/$defs/MessageId" } ] }, - "messageId": { - "description": "A unique identifier for the message this chunk belongs to.\n\nAll chunks belonging to the same message share the same `messageId`.\nA change in `messageId` indicates a new message has started.", + "content": { + "description": "A single item of content", "allOf": [ { - "$ref": "#/$defs/MessageId" + "$ref": "#/$defs/ContentBlock" } ] }, @@ -5621,7 +5621,7 @@ "additionalProperties": true } }, - "required": ["content", "messageId"] + "required": ["messageId", "content"] }, "UserMessage": { "description": "A user message upsert.\n\nOnly [`UserMessage::message_id`] is required. Other fields have patch\nsemantics: omitted fields leave the existing message value unchanged, `null`\nclears or unsets the value, and concrete values replace the previous value.\nFor a new `messageId`, omitted fields use client defaults. `content` is\nreplaced as a whole array; send `[]` or `null` to clear it.\n\nMessage updates and chunks are applied in the order they are received. When\na `user_message` update includes `content`, that array replaces any content\npreviously accumulated for the message, including content from earlier\nchunks. Later chunks with the same `messageId` append to the current\ncontent.", @@ -8304,20 +8304,20 @@ ] }, { - "title": "ExtMethodResponse", - "description": "Successful result returned by an extension method outside the core ACP method set.", + "title": "MessageMcpResponse", + "description": "Successful result returned by an MCP-over-ACP `mcp/message` request.", "allOf": [ { - "$ref": "#/$defs/ExtResponse" + "$ref": "#/$defs/MessageMcpResponse" } ] }, { - "title": "MessageMcpResponse", - "description": "Successful result returned by an MCP-over-ACP `mcp/message` request.", + "title": "ExtMethodResponse", + "description": "Successful result returned by an extension method outside the core ACP method set.", "allOf": [ { - "$ref": "#/$defs/MessageMcpResponse" + "$ref": "#/$defs/ExtResponse" } ] } From 189096b15e64deac3341c440b12e5492e1c4f1e6 Mon Sep 17 00:00:00 2001 From: Ben Brandt Date: Mon, 29 Jun 2026 15:04:38 +0200 Subject: [PATCH 3/3] Fix schema formatting --- docs/protocol/v1/draft/schema.mdx | 775 +++++++--- docs/protocol/v1/schema.mdx | 378 +++-- docs/protocol/v2/draft/schema.mdx | 2 +- docs/protocol/v2/schema.mdx | 2 +- schema-generator/src/main.rs | 2 +- schema/v1/meta.json | 2 +- schema/v1/meta.unstable.json | 2 +- schema/v1/schema.json | 1152 +++----------- schema/v1/schema.unstable.json | 2341 ++++++----------------------- schema/v2/meta.json | 2 +- schema/v2/schema.json | 1261 ++++------------ schema/v2/schema.unstable.json | 6 +- 12 files changed, 1845 insertions(+), 4080 deletions(-) diff --git a/docs/protocol/v1/draft/schema.mdx b/docs/protocol/v1/draft/schema.mdx index cf5fa8de5..93027d567 100644 --- a/docs/protocol/v1/draft/schema.mdx +++ b/docs/protocol/v1/draft/schema.mdx @@ -3,7 +3,10 @@ title: "Schema" description: "Schema definitions for the Agent Client Protocol" --- -The schema file can be downloaded directly from the [latest GitHub release](https://github.com/agentclientprotocol/agent-client-protocol/releases/latest/download/schema.unstable.json). + + The schema file can be downloaded directly from the [latest GitHub + release](https://github.com/agentclientprotocol/agent-client-protocol/releases/latest/download/schema.unstable.json). + ## Agent @@ -40,6 +43,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + AuthMethodId} required> The ID of the authentication method to use. @@ -60,6 +64,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + @@ -83,6 +88,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + TextDocumentContentChangeEvent[]} required> The content changes. @@ -118,6 +124,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + SessionId} required> The session ID for this notification. @@ -147,6 +154,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Position} required> The current cursor position. @@ -185,6 +193,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + The language identifier of the document (e.g., "rust", "python"). @@ -223,6 +232,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + SessionId} required> The session ID for this notification. @@ -236,6 +246,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Establishes the connection with a client and negotiates protocol capabilities. This method is called once at the beginning of the connection to: + - Negotiate the protocol version to use - Exchange capability information between client and agent - Determine available authentication methods @@ -262,16 +273,19 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ClientCapabilities} > Capabilities supported by the client. - Default: `{"fs":{"readTextFile":false,"writeTextFile":false},"terminal":false,"auth":{"terminal":false}}` + Implementation | null} > Information about the Client name and version sent to the Agent. Note: in future versions of the protocol, this will be required. + ProtocolVersion} required> The latest protocol version supported by the client. @@ -295,27 +309,32 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + AgentCapabilities} > Capabilities supported by the agent. - Default: `{"loadSession":false,"promptCapabilities":{"image":false,"audio":false,"embeddedContext":false},"mcpCapabilities":{"http":false,"sse":false,"acp":false},"sessionCapabilities":{},"auth":{}}` + Implementation | null} > Information about the Agent name and version sent to the Client. Note: in future versions of the protocol, this will be required. + AuthMethod[]} > Authentication methods supported by the agent. - Default: `[]` + ProtocolVersion} required> The protocol version the client specified if supported by the agent, or the latest protocol version supported by the agent. The client should disconnect, if it doesn't support this version. + ### logout @@ -341,6 +360,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + #### LogoutResponse @@ -357,6 +377,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + @@ -389,6 +410,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + McpConnectionId} required> The MCP-over-ACP connection this message is sent on. @@ -400,6 +422,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Optional inner MCP params. If omitted or set to `null`, the inner MCP message has no params. + #### MessageMcpRequest @@ -420,6 +443,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + McpConnectionId} required> The MCP-over-ACP connection this message is sent on. @@ -431,6 +455,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Optional inner MCP params. If omitted or set to `null`, the inner MCP message has no params. + #### MessageMcpResponse @@ -443,7 +468,6 @@ Response to `mcp/message`. This is the inner MCP response result payload. Any JSON value is valid. - ### nes/accept @@ -465,6 +489,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + The ID of the accepted suggestion. @@ -502,6 +527,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + SessionId} required> The ID of the NES session to close. @@ -521,6 +547,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + @@ -544,6 +571,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + The ID of the rejected suggestion. @@ -578,6 +606,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + NesRepository | null} > Repository metadata, if the workspace is a git repository. @@ -603,6 +632,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + SessionId} required> The session ID for the newly started NES session. @@ -631,6 +661,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + NesSuggestContext | null} > Context for the suggestion, included based on agent capabilities. @@ -668,6 +699,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + NesSuggestion[]} required> The list of suggestions. @@ -700,6 +732,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Provider id to disable. @@ -723,6 +756,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + @@ -752,6 +786,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + #### ListProvidersResponse @@ -772,6 +807,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ProviderInfo[]} required> Configurable providers with current routing info suitable for UI display. @@ -806,6 +842,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + LlmProtocol} required> Protocol type for this provider. @@ -839,6 +876,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + @@ -849,6 +887,7 @@ Cancels ongoing operations for a session. This is a notification sent by the client to cancel an ongoing prompt turn. Upon receiving this notification, the Agent SHOULD: + - Stop all language model requests as soon as possible - Abort all tool call invocations in progress - Send any pending `session/update` notifications @@ -872,6 +911,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + SessionId} required> The ID of the session to cancel operations for. @@ -907,6 +947,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + SessionId} required> The ID of the session to close. @@ -926,6 +967,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + @@ -951,6 +993,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + SessionId} required> The ID of the session to delete. @@ -970,6 +1013,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + @@ -1010,6 +1054,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + "string"[]} > Additional workspace roots to activate for this session. Each path must be absolute. @@ -1017,6 +1062,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d When omitted or empty, no additional roots are activated. When non-empty, this is the complete resulting additional-root list for the forked session. + The working directory for this session. @@ -1046,6 +1092,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + SessionConfigOption[] | null} > Initial session configuration options if supported by the Agent. @@ -1054,6 +1101,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Initial mode state if supported by the Agent See protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/v1/draft/session-modes) + SessionId} required> Unique identifier for the newly created forked session. @@ -1084,6 +1132,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Opaque cursor token from a previous response's nextCursor field for cursor-based pagination @@ -1106,6 +1155,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Opaque cursor token. If present, pass this in the next request's cursor parameter @@ -1123,6 +1173,7 @@ Loads an existing session to resume a previous conversation. This method is only available if the agent advertises the `loadSession` capability. The agent should: + - Restore the session context and conversation history - Connect to the specified MCP servers - Stream the entire conversation history back to the client via notifications @@ -1147,6 +1198,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + "string"[]} > Additional workspace roots to activate for this session. Each path must be absolute. @@ -1155,6 +1207,7 @@ When omitted or empty, no additional roots are activated. When non-empty, this is the complete resulting additional-root list for the loaded session. It may differ from any previously used or reported list as long as the request `cwd` matches the session's `cwd`. + The working directory for this session. @@ -1180,6 +1233,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + SessionConfigOption[] | null} > Initial session configuration options if supported by the Agent. @@ -1188,6 +1242,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Initial mode state if supported by the Agent See protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/v1/draft/session-modes) + @@ -1198,6 +1253,7 @@ Creates a new conversation session with the agent. Sessions represent independent conversation contexts with their own history and state. The agent should: + - Create a new session context - Connect to any specified MCP servers - Return a unique session ID for future requests @@ -1222,6 +1278,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + "string"[]} > Additional workspace roots for this session. Each path must be absolute. @@ -1229,6 +1286,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d These expand the session's filesystem scope without changing `cwd`, which remains the base for relative paths. When omitted or empty, no additional roots are activated for the new session. + The working directory for this session. Must be an absolute path. @@ -1253,6 +1311,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + SessionConfigOption[] | null} > Initial session configuration options if supported by the Agent. @@ -1261,11 +1320,13 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Initial mode state if supported by the Agent See protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/v1/draft/session-modes) + SessionId} required> Unique identifier for the created session. Used in all subsequent requests for this conversation. + @@ -1274,6 +1335,7 @@ Used in all subsequent requests for this conversation. Processes a user prompt within a session. This method handles the whole lifecycle of a prompt: + - Receives user messages with optional context (files, images, etc.) - Processes the prompt using language models - Reports language model content and tool calls to the Clients @@ -1301,6 +1363,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ContentBlock[]} required> The blocks of content that compose the user's message. @@ -1316,6 +1379,7 @@ The client MAY include referenced pieces of context as either When available, `ContentBlock::Resource` is preferred as it avoids extra round-trips and allows the message to include pieces of context from sources the agent may not have access to. + SessionId} required> The ID of the session to send this user message to @@ -1337,6 +1401,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + StopReason} required> Indicates why the agent stopped processing the turn. @@ -1347,6 +1412,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d This capability is not part of the spec yet, and may be removed or changed at any point. Token usage for this turn (optional). + @@ -1378,6 +1444,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + "string"[]} > Additional workspace roots to activate for this session. Each path must be absolute. @@ -1386,6 +1453,7 @@ When omitted or empty, no additional roots are activated. When non-empty, this is the complete resulting additional-root list for the resumed session. It may differ from any previously used or reported list as long as the request `cwd` matches the session's `cwd`. + The working directory for this session. @@ -1411,6 +1479,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + SessionConfigOption[] | null} > Initial session configuration options if supported by the Agent. @@ -1419,6 +1488,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Initial mode state if supported by the Agent See protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/v1/draft/session-modes) + @@ -1440,6 +1510,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + SessionConfigId} required> The ID of the configuration option to set. @@ -1474,15 +1545,17 @@ variant. -SessionConfigValueId} required> +SessionConfigValueId} + required +> The value ID. - - #### SetSessionConfigOptionResponse Response to `session/set_config_option` method. @@ -1497,6 +1570,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + SessionConfigOption[]} required> The full set of configuration options and their current values. @@ -1533,6 +1607,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + SessionModeId} required> The ID of the mode to set. @@ -1555,6 +1630,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ## Client @@ -1564,6 +1640,7 @@ Defines the interface that ACP-compliant clients must implement. Clients are typically code editors (IDEs, text editors) that provide the interface between users and AI agents. They manage the environment, handle user interactions, and control access to resources. + ### elicitation/complete @@ -1591,6 +1668,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ElicitationId} required> The ID of the elicitation that completed. @@ -1627,6 +1705,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + A human-readable message describing what input is needed. @@ -1642,7 +1721,11 @@ Form-based elicitation where the client renders a form from the provided schema. The discriminator value. Must be `"form"`. -ElicitationSchema} required> +ElicitationSchema} + required +> A JSON Schema describing the form fields to present to the user. @@ -1654,7 +1737,11 @@ URL-based elicitation where the client directs the user to a URL. -ElicitationId} required> +ElicitationId} + required +> The unique identifier for this elicitation. @@ -1667,8 +1754,6 @@ URL-based elicitation where the client directs the user to a URL. - - #### CreateElicitationResponse **UNSTABLE** @@ -1687,6 +1772,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + **Variants:** @@ -1699,7 +1785,7 @@ The user accepted and provided content. The discriminator value. Must be `"accept"`. - + The user-provided content, if any, as an object matching the requested schema. @@ -1730,8 +1816,6 @@ The elicitation was cancelled. - - ### fs/read_text_file @@ -1758,16 +1842,19 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Maximum number of lines to read. - Minimum: `0` + Line number to start reading from (1-based). - Minimum: `0` + Absolute path to the file to read. @@ -1790,6 +1877,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Content payload returned by this response. @@ -1821,6 +1909,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + The text content to write to the file. @@ -1846,6 +1935,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + @@ -1875,6 +1965,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + McpServerAcpId} required> The ACP MCP server ID that was provided by the component declaring the MCP server. @@ -1898,6 +1989,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + McpConnectionId} required> The unique identifier for this MCP-over-ACP connection. @@ -1930,6 +2022,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + McpConnectionId} required> The MCP-over-ACP connection to close. @@ -1953,6 +2046,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + @@ -1985,6 +2079,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + McpConnectionId} required> The MCP-over-ACP connection this message is sent on. @@ -1996,6 +2091,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Optional inner MCP params. If omitted or set to `null`, the inner MCP message has no params. + #### MessageMcpRequest @@ -2016,6 +2112,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + McpConnectionId} required> The MCP-over-ACP connection this message is sent on. @@ -2027,6 +2124,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Optional inner MCP params. If omitted or set to `null`, the inner MCP message has no params. + #### MessageMcpResponse @@ -2039,7 +2137,6 @@ Response to `mcp/message`. This is the inner MCP response result payload. Any JSON value is valid. - ### session/request_permission @@ -2072,6 +2169,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + PermissionOption[]} required> Available permission options for the user to choose from. @@ -2097,6 +2195,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + RequestPermissionOutcome} required> The user's decision on the permission request. @@ -2135,6 +2234,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + SessionId} required> The ID of the session this update pertains to. @@ -2175,6 +2275,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + "string"[]} > Array of command arguments. @@ -2199,6 +2300,7 @@ string output, even if this means the retained output is slightly less than the specified limit. - Minimum: `0` + SessionId} required> The session ID for this request. @@ -2218,6 +2320,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + TerminalId} required> The unique identifier for the created terminal. @@ -2253,6 +2356,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + SessionId} required> The session ID for this request. @@ -2275,6 +2379,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + @@ -2301,6 +2406,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + SessionId} required> The session ID for this request. @@ -2323,6 +2429,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + TerminalExitStatus | null} > Exit status if the command has completed. @@ -2364,6 +2471,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + SessionId} required> The session ID for this request. @@ -2386,6 +2494,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + @@ -2409,6 +2518,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + SessionId} required> The session ID for this request. @@ -2431,11 +2541,13 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + The process exit code (may be null if terminated by signal). - Minimum: `0` + The signal that terminated the process (may be null if exited normally). @@ -2451,6 +2563,7 @@ agents. For example if the implementation uses a single threaded synchronous programming language then there is little it can do to react to a `$/cancel_request` notification. If an agent or client receives notifications starting with '$/' it is free to ignore the notification. + ### $/cancel_request @@ -2468,8 +2581,9 @@ Upon receiving this notification, the receiver: 1. MUST cancel the corresponding request activity and all nested activities 2. MAY send any pending notifications. 3. MUST send one of these responses for the original request: - - Valid response with appropriate data (partial results or cancellation marker) - - Error response with code `-32800` (Cancelled) + +- Valid response with appropriate data (partial results or cancellation marker) +- Error response with code `-32800` (Cancelled) See protocol docs: [Cancellation](https://agentclientprotocol.com/protocol/v1/draft/cancellation) @@ -2493,6 +2607,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + RequestId} required> The ID of the request to cancel. @@ -2512,11 +2627,13 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + LogoutCapabilities | null} > Whether the agent supports the logout method. By supplying `\{\}` it means that the agent supports the logout method. + ## AgentCapabilities @@ -2538,21 +2655,25 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + AgentAuthCapabilities} > Authentication-related capabilities supported by the agent. - Default: `{}` + Whether the agent supports `session/load`. - Default: `false` + McpCapabilities} > MCP capabilities supported by the agent. - Default: `{"http":false,"sse":false,"acp":false}` + NesCapabilities | null} > **UNSTABLE** @@ -2560,6 +2681,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d This capability is not part of the spec yet, and may be removed or changed at any point. NES (Next Edit Suggestions) capabilities supported by the agent. + PositionEncodingKind | null} > **UNSTABLE** @@ -2567,11 +2689,13 @@ NES (Next Edit Suggestions) capabilities supported by the agent. This capability is not part of the spec yet, and may be removed or changed at any point. The position encoding selected by the agent from the client's supported encodings. + PromptCapabilities} > Prompt capabilities supported by the agent. - Default: `{"image":false,"audio":false,"embeddedContext":false}` + ProvidersCapabilities | null} > **UNSTABLE** @@ -2581,11 +2705,13 @@ This capability is not part of the spec yet, and may be removed or changed at an Provider configuration capabilities supported by the agent. By supplying `\{\}` it means that the agent supports provider configuration methods. + SessionCapabilities} > Session lifecycle and prompt capabilities advertised by the agent. - Default: `{}` + ## Annotations @@ -2602,6 +2728,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Role[] | null} > Intended recipients for this content, such as the user or assistant. @@ -2627,6 +2754,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -2660,6 +2788,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Whether the client supports `terminal` authentication methods. @@ -2667,6 +2796,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d When `true`, the agent may include `terminal` entries in its authentication methods. - Default: `false` + ## AuthEnvVar @@ -2687,6 +2817,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Human-readable label for this variable, displayed in client UI. @@ -2700,6 +2831,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Defaults to `false`. - Default: `false` + Whether this value is a secret (e.g. API key, token). @@ -2708,6 +2840,7 @@ Clients should use a password-style input for secret vars. Defaults to `true`. - Default: `true` + ## AuthMethod @@ -2734,6 +2867,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Optional description providing more details about this authentication method. @@ -2772,6 +2906,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + "string"[]} > Additional arguments to pass when running the agent binary for terminal auth. @@ -2808,6 +2943,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Optional description providing more details about this authentication method. @@ -2822,8 +2958,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d - - ## AuthMethodAgent Agent handles authentication itself. @@ -2840,6 +2974,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Optional description providing more details about this authentication method. @@ -2871,6 +3006,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Optional description providing more details about this authentication method. @@ -2914,6 +3050,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + "string"[]} > Additional arguments to pass when running the agent binary for terminal auth. @@ -2945,6 +3082,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Human-readable description of what the command does. @@ -2972,6 +3110,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + A hint to display when the input hasn't been provided yet @@ -2991,6 +3130,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + AvailableCommand[]} required> Commands the agent can execute @@ -3010,6 +3150,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Base64-encoded bytes for a binary resource payload. @@ -3041,6 +3182,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ## BooleanPropertySchema @@ -3057,6 +3199,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Default value. @@ -3087,6 +3230,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + AuthCapabilities} > **UNSTABLE** @@ -3098,6 +3242,7 @@ Determines which authentication method types the agent may include in its `InitializeResponse`. - Default: `{"terminal":false}` + ElicitationCapabilities | null} > **UNSTABLE** @@ -3106,12 +3251,14 @@ This capability is not part of the spec yet, and may be removed or changed at an Elicitation capabilities supported by the client. Determines which elicitation modes the agent may use. + FileSystemCapabilities} > File system capabilities supported by the client. Determines which file operations the agent can request. - Default: `{"readTextFile":false,"writeTextFile":false}` + ClientNesCapabilities | null} > **UNSTABLE** @@ -3119,6 +3266,7 @@ Determines which file operations the agent can request. This capability is not part of the spec yet, and may be removed or changed at any point. NES (Next Edit Suggestions) capabilities supported by the client. + PlanCapabilities | null} > **UNSTABLE** @@ -3129,6 +3277,7 @@ Whether the client supports `plan_update` and `plan_removed` session updates. Optional. Omitted means the client does not advertise support. Supplying `\{\}` means the client can receive both update types. + PositionEncodingKind[]} > **UNSTABLE** @@ -3136,6 +3285,7 @@ Supplying `\{\}` means the client can receive both update types. This capability is not part of the spec yet, and may be removed or changed at any point. The position encodings supported by the client, in order of preference. + ClientSessionCapabilities | null} > **UNSTABLE** @@ -3143,11 +3293,13 @@ The position encodings supported by the client, in order of preference. This capability is not part of the spec yet, and may be removed or changed at any point. Session-related capabilities supported by the client. + Whether the Client support all `terminal/*` methods. - Default: `false` + ## ClientNesCapabilities @@ -3164,6 +3316,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + NesJumpCapabilities | null} > Whether the client supports the `jump` suggestion kind. @@ -3193,12 +3346,14 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + SessionConfigOptionsCapabilities | null} > Config option capabilities supported by the client. Omitted or `null` means the client does not advertise support for any config option extensions. + ## ConfigOptionUpdate @@ -3215,6 +3370,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + SessionConfigOption[]} required> The full set of configuration options and their current values. @@ -3234,6 +3390,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ContentBlock} required> The actual content block. @@ -3247,6 +3404,7 @@ They provide a structured way to handle various types of user-facing content—w it's text from language models, images for analysis, or embedded resources for context. Content blocks appear in: + - User prompts sent via `session/prompt` - Language model output streamed through `session/update` notifications - Progress updates and results from tool calls @@ -3272,6 +3430,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -3299,6 +3458,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -3332,6 +3492,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -3362,6 +3523,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -3406,6 +3568,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -3420,8 +3583,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d - - ## ContentChunk A streamed item of content @@ -3436,6 +3597,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ContentBlock} required> A single item of content @@ -3445,6 +3607,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d All chunks belonging to the same message share the same `messageId`. A change in `messageId` indicates a new message has started. + ## Cost @@ -3461,6 +3624,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Total cumulative cost for session. @@ -3485,6 +3649,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + SessionModeId} required> The ID of the current mode @@ -3508,6 +3673,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + The new content after modification. @@ -3531,7 +3697,7 @@ The user accepted the elicitation and provided content. **Properties:** - + The user-provided content, if any, as an object matching the requested schema. @@ -3553,6 +3719,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ElicitationFormCapabilities | null} > Whether the client supports form-based elicitation. @@ -3568,27 +3735,25 @@ Allowed wire representations for `ElicitationContentValue`. **Type:** Union -String value accepted in elicitation response content. + String value accepted in elicitation response content. -Integer value accepted in elicitation response content. + Integer value accepted in elicitation response content. -Number value accepted in elicitation response content. + Number value accepted in elicitation response content. -Boolean value accepted in elicitation response content. + Boolean value accepted in elicitation response content. -String array value accepted in elicitation response content. + String array value accepted in elicitation response content. - - ## ElicitationFormCapabilities **UNSTABLE** @@ -3607,6 +3772,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ## ElicitationFormMode @@ -3621,7 +3787,11 @@ Form-based elicitation mode where the client renders a form from the provided sc **Shared properties:** -ElicitationSchema} required> +ElicitationSchema} + required +> A JSON Schema describing the form fields to present to the user. @@ -3632,10 +3802,24 @@ Tied to a session, optionally to a specific tool call within that session. -SessionId} required> +SessionId} + required +> The session this elicitation is tied to. -ToolCallId | null} > + + + ToolCallId + + | null + + } +> Optional tool call within the session. @@ -3648,15 +3832,17 @@ Tied to a specific JSON-RPC request outside of a session -RequestId} required> +RequestId} + required +> The request this elicitation is tied to. - - ## ElicitationId **UNSTABLE** @@ -3688,6 +3874,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Default value. @@ -3705,11 +3892,13 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Maximum string length. - Minimum: `0` + Minimum string length. - Minimum: `0` + EnumOption[] | null} > Titled enum options for titled single-select enums. @@ -3738,6 +3927,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Default value. @@ -3772,6 +3962,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Default value. @@ -3806,6 +3997,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Default value. @@ -3834,6 +4026,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + <>"string"[] | null} > Default selected values. @@ -3848,11 +4041,13 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Maximum number of items to select. - Minimum: `0` + Minimum number of items to select. - Minimum: `0` + Optional title for the property. @@ -3864,8 +4059,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d - - ## ElicitationRequestScope **UNSTABLE** @@ -3879,7 +4072,11 @@ Request-scoped elicitation, tied to a specific JSON-RPC request outside of a ses **Properties:** -RequestId} required> +RequestId} + required +> The request this elicitation is tied to. @@ -3900,6 +4097,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Optional description of what this schema represents. @@ -3908,6 +4106,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Property definitions (must be primitive types). - Default: `{}` + <>"string"[] | null} > List of required property names. @@ -3919,6 +4118,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Type discriminator. Always `"object"`. - Default: `"object"` + ## ElicitationSchemaType @@ -3928,11 +4128,9 @@ Type discriminator for elicitation schemas. **Type:** Union -Object schema type. + Object schema type. - - ## ElicitationSessionScope **UNSTABLE** @@ -3949,10 +4147,24 @@ during a tool call and needs to redirect it to the user. **Properties:** -SessionId} required> +SessionId} + required +> The session this elicitation is tied to. -ToolCallId | null} > + + + ToolCallId + + | null + + } +> Optional tool call within the session. @@ -3963,11 +4175,9 @@ Items definition for untitled multi-select enum properties. **Type:** Union -String schema type. + String schema type. - - ## ElicitationUrlCapabilities **UNSTABLE** @@ -3986,6 +4196,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ## ElicitationUrlMode @@ -4000,7 +4211,11 @@ URL-based elicitation mode where the client directs the user to a URL. **Shared properties:** -ElicitationId} required> +ElicitationId} + required +> The unique identifier for this elicitation. @@ -4014,10 +4229,24 @@ Tied to a session, optionally to a specific tool call within that session. -SessionId} required> +SessionId} + required +> The session this elicitation is tied to. -ToolCallId | null} > + + + ToolCallId + + | null + + } +> Optional tool call within the session. @@ -4030,15 +4259,17 @@ Tied to a specific JSON-RPC request outside of a session -RequestId} required> +RequestId} + required +> The request this elicitation is tied to. - - ## EmbeddedResource The contents of a resource, embedded into a prompt or tool call result. @@ -4053,6 +4284,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -4078,6 +4310,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + MIME type describing the encoded media payload. @@ -4103,6 +4336,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Base64-encoded bytes for a binary resource payload. @@ -4117,8 +4351,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d - - ## EnumOption A titled enum option with a const value and human-readable title. @@ -4133,6 +4365,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + The constant value for this option. @@ -4155,6 +4388,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + The name of the environment variable. @@ -4177,16 +4411,17 @@ See protocol docs: [JSON-RPC Error Object](https://www.jsonrpc.org/specification **Properties:** ErrorCode} required> - A number indicating the error type that occurred. -This must be an integer as defined in the JSON-RPC specification. + A number indicating the error type that occurred. This must be an integer as + defined in the JSON-RPC specification. - - Optional primitive or structured value that contains additional information about the error. -This may include debugging information or context-specific details. + + Optional primitive or structured value that contains additional information + about the error. This may include debugging information or context-specific + details. - A string providing a short description of the error. -The message should be limited to a concise single sentence. + A string providing a short description of the error. The message should be + limited to a concise single sentence. ## ErrorCode @@ -4199,25 +4434,25 @@ and use the reserved range (-32000 to -32099) for protocol-specific errors. **Type:** Union -**Parse error**: Invalid JSON was received by the server. -An error occurred on the server while parsing the JSON text. + **Parse error**: Invalid JSON was received by the server. An error occurred on + the server while parsing the JSON text. -**Invalid request**: The JSON sent is not a valid Request object. + **Invalid request**: The JSON sent is not a valid Request object. -**Method not found**: The method does not exist or is not available. + **Method not found**: The method does not exist or is not available. -**Invalid params**: Invalid method parameter(s). + **Invalid params**: Invalid method parameter(s). -**Internal error**: Internal JSON-RPC error. -Reserved for implementation-defined server errors. + **Internal error**: Internal JSON-RPC error. Reserved for + implementation-defined server errors. @@ -4227,14 +4462,16 @@ This capability is not part of the spec yet, and may be removed or changed at an Execution of the method was aborted either due to a cancellation request from the caller or because of resource constraints or shutdown. + -**Authentication required**: Authentication is required before this operation can be performed. + **Authentication required**: Authentication is required before this operation + can be performed. -**Resource not found**: A given resource, such as a file, was not found. + **Resource not found**: A given resource, such as a file, was not found. @@ -4243,14 +4480,13 @@ because of resource constraints or shutdown. This capability is not part of the spec yet, and may be removed or changed at any point. The agent requires user input via a URL-based elicitation before it can proceed. + -Other undefined error code. + Other undefined error code. - - ## ExtNotification Allows the Agent to send an arbitrary notification that is not part of the ACP spec. @@ -4259,7 +4495,6 @@ while maintaining protocol compatibility. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ## ExtRequest Allows for sending an arbitrary request that is not part of the ACP spec. @@ -4268,7 +4503,6 @@ protocol compatibility. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ## ExtResponse Allows for sending an arbitrary response to an `ExtRequest` that is not part of the ACP spec. @@ -4277,7 +4511,6 @@ protocol compatibility. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) - ## FileSystemCapabilities File system capabilities that a client may support. @@ -4294,16 +4527,19 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Whether the Client supports `fs/read_text_file` requests. - Default: `false` + Whether the Client supports `fs/write_text_file` requests. - Default: `false` + ## HttpHeader @@ -4320,6 +4556,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + The name of the HTTP header. @@ -4342,6 +4579,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -4372,6 +4610,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Intended for programmatic or logical use, but can be used as a display @@ -4382,6 +4621,7 @@ name fallback if title isn’t present. and easily understood. If not provided, the name should be used for display. + Version of the implementation. Can be displayed to the user or used @@ -4402,6 +4642,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Default value. @@ -4435,31 +4676,29 @@ Protocol names that do not begin with `_` are reserved for the ACP spec. **Type:** Union -Anthropic API protocol. + Anthropic API protocol. -OpenAI API protocol. + OpenAI API protocol. -Azure OpenAI API protocol. + Azure OpenAI API protocol. -Google Vertex AI API protocol. + Google Vertex AI API protocol. -AWS Bedrock API protocol. + AWS Bedrock API protocol. -Unknown or custom protocol. + Unknown or custom protocol. - - ## LogoutCapabilities Logout capabilities supported by the agent. @@ -4476,6 +4715,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ## McpCapabilities @@ -4492,6 +4732,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + **UNSTABLE** @@ -4501,16 +4742,19 @@ This capability is not part of the spec yet, and may be removed or changed at an Agent supports `McpServer::Acp`. - Default: `false` + Agent supports `McpServer::Http`. - Default: `false` + Agent supports `McpServer::Sse`. - Default: `false` + ## McpConnectionId @@ -4547,6 +4791,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + HttpHeader[]} required> HTTP headers to set when making requests to the MCP server. @@ -4577,6 +4822,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + HttpHeader[]} required> HTTP headers to set when making requests to the MCP server. @@ -4612,12 +4858,14 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + McpServerAcpId} required> Unique identifier for this MCP server, generated by the component providing it. Providers MUST NOT reuse an ID for multiple ACP-transport MCP servers that are visible on the same ACP connection. + Human-readable name identifying this MCP server. @@ -4642,6 +4890,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + "string"[]} required> Command-line arguments to pass to the MCP server. @@ -4659,8 +4908,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d - - ## McpServerAcp **UNSTABLE** @@ -4682,12 +4929,14 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + McpServerAcpId} required> Unique identifier for this MCP server, generated by the component providing it. Providers MUST NOT reuse an ID for multiple ACP-transport MCP servers that are visible on the same ACP connection. + Human-readable name identifying this MCP server. @@ -4721,6 +4970,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + HttpHeader[]} required> HTTP headers to set when making requests to the MCP server. @@ -4746,6 +4996,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + HttpHeader[]} required> HTTP headers to set when making requests to the MCP server. @@ -4771,6 +5022,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + "string"[]} required> Command-line arguments to pass to the MCP server. @@ -4808,6 +5060,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + "string"[]} required> Allowed enum values. @@ -4830,6 +5083,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + EnumOption[]} required> Titled enum options. @@ -4838,8 +5092,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d - - ## MultiSelectPropertySchema Schema for multi-select (array) properties in an elicitation form. @@ -4854,6 +5106,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + <>"string"[] | null} > Default selected values. @@ -4868,11 +5121,13 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Maximum number of items to select. - Minimum: `0` + Minimum number of items to select. - Minimum: `0` + Optional title for the property. @@ -4892,6 +5147,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + NesContextCapabilities | null} > Context the agent wants attached to each suggestion request. @@ -4914,6 +5170,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + NesDiagnosticsCapabilities | null} > Whether the agent wants diagnostics context. @@ -4948,6 +5205,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + The diagnostic message. @@ -4969,23 +5227,21 @@ Severity of a diagnostic. **Type:** Union -An error. + An error. -A warning. + A warning. -An informational message. + An informational message. -A hint. + A hint. - - ## NesDiagnosticsCapabilities Capabilities for diagnostics context. @@ -5000,6 +5256,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ## NesDocumentDidChangeCapabilities @@ -5016,6 +5273,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + TextDocumentSyncKind} required> The sync kind the agent wants: `"full"` or `"incremental"`. @@ -5035,6 +5293,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ## NesDocumentDidFocusCapabilities @@ -5051,6 +5310,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ## NesDocumentDidOpenCapabilities @@ -5067,6 +5327,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ## NesDocumentDidSaveCapabilities @@ -5083,6 +5344,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ## NesDocumentEventCapabilities @@ -5099,6 +5361,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + NesDocumentDidChangeCapabilities | null} > Whether the agent wants `document/didChange` events, and the sync kind. @@ -5130,11 +5393,13 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Maximum number of edit history entries the agent can use. - Minimum: `0` + ## NesEditHistoryEntry @@ -5151,6 +5416,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + A diff representing the edit. @@ -5173,6 +5439,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Position | null} > Optional suggested cursor position after applying edits. @@ -5201,6 +5468,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + NesDocumentEventCapabilities | null} > Document event capabilities. @@ -5220,16 +5488,19 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + The end line of the excerpt (zero-based). - Minimum: `0` + The start line of the excerpt (zero-based). - Minimum: `0` + The text content of the excerpt. @@ -5249,6 +5520,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ## NesJumpSuggestion @@ -5265,6 +5537,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Unique identifier for accept/reject tracking. @@ -5290,6 +5563,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + The language identifier. @@ -5298,6 +5572,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Timestamp in milliseconds since epoch of when the file was last focused. - Minimum: `0` + The URI of the file. @@ -5320,6 +5595,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ## NesRecentFile @@ -5336,6 +5612,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + The language identifier. @@ -5361,11 +5638,13 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Maximum number of recent files the agent can use. - Minimum: `0` + ## NesRejectReason @@ -5375,23 +5654,21 @@ The reason a suggestion was rejected. **Type:** Union -The user explicitly dismissed the suggestion. + The user explicitly dismissed the suggestion. -The suggestion was shown but the user continued editing without interacting. + The suggestion was shown but the user continued editing without interacting. -The suggestion was superseded by a newer suggestion. + The suggestion was superseded by a newer suggestion. -The request was cancelled before the agent returned a response. + The request was cancelled before the agent returned a response. - - ## NesRelatedSnippet A related code snippet from a file. @@ -5406,6 +5683,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + NesExcerpt[]} required> The code excerpts. @@ -5428,6 +5706,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ## NesRenameCapabilities @@ -5444,6 +5723,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ## NesRenameSuggestion @@ -5460,6 +5740,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Unique identifier for accept/reject tracking. @@ -5488,6 +5769,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + The repository name. @@ -5513,6 +5795,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ## NesSearchAndReplaceSuggestion @@ -5529,6 +5812,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Unique identifier for accept/reject tracking. @@ -5560,6 +5844,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + NesDiagnostic[] | null} > Current diagnostics (errors, warnings). @@ -5597,6 +5882,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Position | null} > Optional suggested cursor position after applying edits. @@ -5628,6 +5914,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Unique identifier for accept/reject tracking. @@ -5656,6 +5943,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Unique identifier for accept/reject tracking. @@ -5687,6 +5975,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Unique identifier for accept/reject tracking. @@ -5710,8 +5999,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d - - ## NesTextEdit A text edit within a suggestion. @@ -5726,6 +6013,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + The replacement text. @@ -5741,19 +6029,17 @@ What triggered the suggestion request. **Type:** Union -Triggered by user typing or cursor movement. + Triggered by user typing or cursor movement. -Triggered by a diagnostic appearing at or near the cursor. + Triggered by a diagnostic appearing at or near the cursor. -Triggered by an explicit user action (keyboard shortcut). + Triggered by an explicit user action (keyboard shortcut). - - ## NesUserAction A user action (typing, cursor movement, etc.). @@ -5768,6 +6054,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + The kind of action (e.g., "insertChar", "cursorMovement"). @@ -5779,6 +6066,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Timestamp in milliseconds since epoch. - Minimum: `0` + The URI of the file where the action occurred. @@ -5798,11 +6086,13 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Maximum number of user actions the agent can use. - Minimum: `0` + ## NumberPropertySchema @@ -5819,6 +6109,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Default value. @@ -5850,6 +6141,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + PermissionOptionKind} required> Hint about the nature of this permission option. @@ -5876,23 +6168,21 @@ Helps clients choose appropriate icons and UI treatment. **Type:** Union -Allow this operation only this time. + Allow this operation only this time. -Allow this operation and remember the choice. + Allow this operation and remember the choice. -Reject this operation only this time. + Reject this operation only this time. -Reject this operation and remember the choice. + Reject this operation and remember the choice. - - ## Plan An execution plan for accomplishing complex tasks. @@ -5913,12 +6203,14 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + PlanEntry[]} required> The list of tasks to be accomplished. When updating a plan, the agent must send a complete list of all entries with their current status. The client replaces the entire plan with each update. + ## PlanCapabilities @@ -5939,6 +6231,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ## PlanEntry @@ -5959,6 +6252,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Human-readable description of what this task aims to accomplish. @@ -5982,19 +6276,17 @@ See protocol docs: [Plan Entries](https://agentclientprotocol.com/protocol/v1/dr **Type:** Union -High priority task - critical to the overall goal. + High priority task - critical to the overall goal. -Medium priority task - important but not critical. + Medium priority task - important but not critical. -Low priority task - nice to have but not essential. + Low priority task - nice to have but not essential. - - ## PlanEntryStatus Status of a plan entry in the execution flow. @@ -6005,19 +6297,17 @@ See protocol docs: [Plan Entries](https://agentclientprotocol.com/protocol/v1/dr **Type:** Union -The task has not started yet. + The task has not started yet. -The task is currently being worked on. + The task is currently being worked on. -The task has been successfully completed. + The task has been successfully completed. - - ## PlanFile **UNSTABLE** @@ -6036,6 +6326,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + PlanId} required> The plan ID to update. @@ -6072,12 +6363,14 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + PlanEntry[]} required> The list of tasks to be accomplished. When updating an item-based plan, the agent must send a complete list of all entries with their current status. The client replaces that plan with each update. + PlanId} required> The plan ID to update. @@ -6101,6 +6394,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Markdown content for the plan. @@ -6127,6 +6421,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + PlanId} required> The plan ID to remove. @@ -6150,6 +6445,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + PlanUpdateContent} required> The updated plan content. @@ -6176,12 +6472,14 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + PlanEntry[]} required> The list of tasks to be accomplished. When updating an item-based plan, the agent must send a complete list of all entries with their current status. The client replaces that plan with each update. + PlanId} required> The plan ID to update. @@ -6204,6 +6502,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + PlanId} required> The plan ID to update. @@ -6229,6 +6528,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Markdown content for the plan. @@ -6243,8 +6543,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d - - ## Position A zero-based position in a text document. @@ -6261,16 +6559,19 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Zero-based character offset (encoding-dependent). - Minimum: `0` + Zero-based line number. - Minimum: `0` + ## PositionEncodingKind @@ -6282,19 +6583,17 @@ Follows the same conventions as LSP 3.17. The default is UTF-16. **Type:** Union -Character offsets count UTF-16 code units. This is the default. + Character offsets count UTF-16 code units. This is the default. -Character offsets count Unicode code points. + Character offsets count Unicode code points. -Character offsets count UTF-8 code units (bytes). + Character offsets count UTF-8 code units (bytes). - - ## PromptCapabilities Prompt capabilities supported by the agent in `session/prompt` requests. @@ -6320,11 +6619,13 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Agent supports `ContentBlock::Audio`. - Default: `false` + Agent supports embedded context in `session/prompt` requests. @@ -6333,11 +6634,13 @@ When enabled, the Client is allowed to include `ContentBlock::Resource` in prompt requests for pieces of context that are referenced in the message. - Default: `false` + Agent supports `ContentBlock::Image`. - Default: `false` + ## ProtocolVersion @@ -6349,10 +6652,10 @@ Non-breaking changes should be introduced via capabilities. **Type:** `integer (uint16)` -| Constraint | Value | -| ---------- | ----- | -| Minimum | `0` | -| Maximum | `65535` | +| Constraint | Value | +| ---------- | ------- | +| Minimum | `0` | +| Maximum | `65535` | ## ProviderCurrentConfig @@ -6372,6 +6675,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + LlmProtocol} required> Protocol currently used by this provider. @@ -6398,6 +6702,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ProviderCurrentConfig | null} > Current effective non-secret routing config. @@ -6434,6 +6739,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ## Range @@ -6450,6 +6756,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Position} required> The end position (exclusive). @@ -6473,19 +6780,17 @@ The Server MUST reply with the same value in the Response object if included. Th **Type:** Union -The JSON-RPC `null` request id. + The JSON-RPC `null` request id. -A numeric JSON-RPC request id. + A numeric JSON-RPC request id. -A string JSON-RPC request id. + A string JSON-RPC request id. - - ## RequestPermissionOutcome The outcome of a permission request. @@ -6521,6 +6826,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + PermissionOptionId} required> The ID of the option the user selected. @@ -6532,8 +6838,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d - - ## ResourceLink A resource that the server is capable of reading, included in a prompt or tool call result. @@ -6548,6 +6852,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -6578,15 +6883,13 @@ The sender or recipient of messages and data in a conversation. **Type:** Union -The assistant side of a conversation. + The assistant side of a conversation. -The user side of a conversation. + The user side of a conversation. - - ## SelectedPermissionOutcome The user selected one of the provided options. @@ -6601,6 +6904,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + PermissionOptionId} required> The ID of the option the user selected. @@ -6625,6 +6929,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ## SessionCapabilities @@ -6649,6 +6954,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + SessionAdditionalDirectoriesCapabilities | null} > Whether the agent supports `additionalDirectories` on supported session lifecycle requests. @@ -6656,6 +6962,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Agents that also support `session/list` may return `SessionInfo.additionalDirectories` to report the complete ordered additional-root list associated with a listed session. + SessionCloseCapabilities | null} > Whether the agent supports `session/close`. @@ -6665,6 +6972,7 @@ additional-root list associated with a listed session. Optional. Omitted or `null` both mean the agent does not advertise support. Supplying `\{\}` means the agent supports deleting sessions from `session/list`. + SessionForkCapabilities | null} > **UNSTABLE** @@ -6672,6 +6980,7 @@ Supplying `\{\}` means the agent supports deleting sessions from `session/list`. This capability is not part of the spec yet, and may be removed or changed at any point. Whether the agent supports `session/fork`. + SessionListCapabilities | null} > Whether the agent supports `session/list`. @@ -6696,6 +7005,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ## SessionConfigBoolean @@ -6740,6 +7050,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + SessionConfigOptionCategory | null} > Optional semantic category for this option (UX only). @@ -6761,10 +7072,18 @@ Single-value selector (dropdown). -SessionConfigValueId} required> +SessionConfigValueId} + required +> The currently selected value. -SessionConfigSelectOptions} required> +SessionConfigSelectOptions} + required +> The set of selectable options. @@ -6793,8 +7112,6 @@ Boolean on/off toggle. - - ## SessionConfigOptionCategory Semantic category for a session configuration option. @@ -6810,27 +7127,25 @@ Category names that do not begin with `_` are reserved for the ACP spec. **Type:** Union -Session mode selector. + Session mode selector. -Model selector. + Model selector. -Model-related configuration parameter. + Model-related configuration parameter. -Thought/reasoning level selector. + Thought/reasoning level selector. -Unknown / uncategorized selector. + Unknown / uncategorized selector. - - ## SessionConfigOptionsCapabilities **UNSTABLE** @@ -6849,6 +7164,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + BooleanConfigOptionCapabilities | null} > Whether the client supports boolean session configuration options. @@ -6857,6 +7173,7 @@ Omitted or `null` means the client does not advertise support. Supplying `\{\}` means agents may include `type: "boolean"` entries in `configOptions`, and the client may send `session/set_config_option` requests with `type: "boolean"` and a boolean `value`. + ## SessionConfigSelect @@ -6867,10 +7184,18 @@ A single-value selector (dropdown) session configuration option payload. **Properties:** -SessionConfigValueId} required> +SessionConfigValueId} + required +> The currently selected value. -SessionConfigSelectOptions} required> +SessionConfigSelectOptions} + required +> The set of selectable options. @@ -6888,6 +7213,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + SessionConfigGroupId} required> Unique identifier for this group. @@ -6913,6 +7239,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Optional description for this option value. @@ -6931,15 +7258,13 @@ Possible values for a session configuration option. **Type:** Union -A flat list of options with no grouping. + A flat list of options with no grouping. -A list of options grouped under headers. + A list of options grouped under headers. - - ## SessionConfigValueId Unique identifier for a session configuration option value. @@ -6962,6 +7287,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ## SessionForkCapabilities @@ -6984,6 +7310,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ## SessionId @@ -7011,6 +7338,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + "string"[]} > Additional workspace roots reported for this session. Each path must be absolute. @@ -7018,6 +7346,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d When present, this is the complete ordered additional-root list reported by the Agent. Omitted and empty values are equivalent: the response reports no additional roots. + The working directory for this session. Must be an absolute path. @@ -7049,6 +7378,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Human-readable title for the session. Set to null to clear. @@ -7073,6 +7403,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ## SessionMode @@ -7091,6 +7422,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Optional human-readable details shown with this protocol object. @@ -7122,6 +7454,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + SessionMode[]} required> The set of modes that the Agent can operate in @@ -7146,6 +7479,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ## SessionUpdate @@ -7169,6 +7503,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ContentBlock} required> A single item of content @@ -7178,6 +7513,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d All chunks belonging to the same message share the same `messageId`. A change in `messageId` indicates a new message has started. + The discriminator value. Must be `"user_message_chunk"`. @@ -7197,6 +7533,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ContentBlock} required> A single item of content @@ -7206,6 +7543,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d All chunks belonging to the same message share the same `messageId`. A change in `messageId` indicates a new message has started. + The discriminator value. Must be `"agent_message_chunk"`. @@ -7225,6 +7563,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ContentBlock} required> A single item of content @@ -7234,6 +7573,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d All chunks belonging to the same message share the same `messageId`. A change in `messageId` indicates a new message has started. + The discriminator value. Must be `"agent_thought_chunk"`. @@ -7253,6 +7593,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ToolCallContent[]} > Content produced by the tool call. @@ -7298,6 +7639,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ToolCallContent[] | null} > Replace the content collection. @@ -7342,12 +7684,14 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + PlanEntry[]} required> The list of tasks to be accomplished. When updating a plan, the agent must send a complete list of all entries with their current status. The client replaces the entire plan with each update. + The discriminator value. Must be `"plan"`. @@ -7371,6 +7715,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + PlanUpdateContent} required> The updated plan content. @@ -7397,6 +7742,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + PlanId} required> The plan ID to remove. @@ -7419,6 +7765,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + AvailableCommand[]} required> Commands the agent can execute @@ -7443,6 +7790,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + SessionModeId} required> The ID of the current mode @@ -7465,6 +7813,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + SessionConfigOption[]} required> The full set of configuration options and their current values. @@ -7487,6 +7836,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + The discriminator value. Must be `"session_info_update"`. @@ -7512,6 +7862,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Cost | null} > Cumulative session cost (optional). @@ -7523,18 +7874,18 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Total context window size in tokens. - Minimum: `0` + Tokens currently in context. - Minimum: `0` + - - ## StopReason Reasons why an agent stops processing a prompt turn. @@ -7544,22 +7895,22 @@ See protocol docs: [Stop Reasons](https://agentclientprotocol.com/protocol/v1/dr **Type:** Union -The turn ended successfully. + The turn ended successfully. -The turn ended because the agent reached the maximum number of tokens. + The turn ended because the agent reached the maximum number of tokens. -The turn ended because the agent reached the maximum number of allowed -agent requests between user turns. + The turn ended because the agent reached the maximum number of allowed agent + requests between user turns. -The turn ended because the agent refused to continue. The user prompt -and everything that comes after it won't be included in the next -prompt, so this should be reflected in the UI. + The turn ended because the agent refused to continue. The user prompt and + everything that comes after it won't be included in the next prompt, so this + should be reflected in the UI. @@ -7569,9 +7920,8 @@ This stop reason MUST be returned when the client sends a `session/cancel` notification, even if the cancellation causes exceptions in underlying operations. Agents should catch these exceptions and return this semantically meaningful response to confirm successful cancellation. - - + ## StringFormat @@ -7580,23 +7930,21 @@ String format types for string properties in elicitation schemas. **Type:** Union -Email address format. + Email address format. -URI format. + URI format. -Date format (YYYY-MM-DD). + Date format (YYYY-MM-DD). -Date-time format (ISO 8601). + Date-time format (ISO 8601). - - ## StringPropertySchema Schema for string properties in an elicitation form. @@ -7614,6 +7962,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Default value. @@ -7631,11 +7980,13 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Maximum string length. - Minimum: `0` + Minimum string length. - Minimum: `0` + EnumOption[] | null} > Titled enum options for titled single-select enums. @@ -7665,6 +8016,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + TerminalId} required> Identifier of the terminal instance to embed in the content stream. @@ -7684,11 +8036,13 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + The process exit code (may be null if terminated by signal). - Minimum: `0` + The signal that terminated the process (may be null if exited normally). @@ -7714,6 +8068,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -7739,6 +8094,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Range | null} > The range of the document that changed. If `None`, the entire content is replaced. @@ -7754,15 +8110,13 @@ How the agent wants document changes delivered. **Type:** Union -Client sends the entire file content on each change. + Client sends the entire file content on each change. -Client sends only the changed ranges. + Client sends only the changed ranges. - - ## TextResourceContents Text-based resource contents. @@ -7777,6 +8131,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + MIME type describing the encoded media payload. @@ -7802,6 +8157,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + EnumOption[]} required> Titled enum options. @@ -7826,6 +8182,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ToolCallContent[]} > Content produced by the tool call. @@ -7876,6 +8233,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ContentBlock} required> The actual content block. @@ -7898,6 +8256,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + The new content after modification. @@ -7930,6 +8289,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + TerminalId} required> Identifier of the terminal instance to embed in the content stream. @@ -7941,8 +8301,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d - - ## ToolCallId Unique identifier for a tool call within a session. @@ -7968,11 +8326,13 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Optional line number within the file. - Minimum: `0` + The file path being accessed or modified. @@ -7989,24 +8349,22 @@ See protocol docs: [Status](https://agentclientprotocol.com/protocol/v1/draft/to **Type:** Union -The tool call hasn't started running yet because the input is either -streaming or we're awaiting approval. + The tool call hasn't started running yet because the input is either streaming + or we're awaiting approval. -The tool call is currently running. + The tool call is currently running. -The tool call completed successfully. + The tool call completed successfully. -The tool call failed with an error. + The tool call failed with an error. - - ## ToolCallUpdate An update to an existing tool call. @@ -8026,6 +8384,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + ToolCallContent[] | null} > Replace the content collection. @@ -8064,47 +8423,45 @@ See protocol docs: [Creating](https://agentclientprotocol.com/protocol/v1/draft/ **Type:** Union -Reading files or data. + Reading files or data. -Modifying files or content. + Modifying files or content. -Removing files or data. + Removing files or data. -Moving or renaming files. + Moving or renaming files. -Searching for information. + Searching for information. -Running commands or code. + Running commands or code. -Internal reasoning or planning. + Internal reasoning or planning. -Retrieving external data. + Retrieving external data. -Switching the current session mode. + Switching the current session mode. -Other tool types (default). + Other tool types (default). - - ## UnstructuredCommandInput All text that was typed after the command name is provided as input. @@ -8119,6 +8476,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + A hint to display when the input hasn't been provided yet @@ -8138,6 +8496,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + "string"[]} required> Allowed enum values. @@ -8164,36 +8523,43 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Total cache read tokens. - Minimum: `0` + Total cache write tokens. - Minimum: `0` + Total input tokens across all turns. - Minimum: `0` + Total output tokens across all turns. - Minimum: `0` + Total thought/reasoning tokens - Minimum: `0` + Sum of all token types across session. - Minimum: `0` + ## UsageUpdate @@ -8210,6 +8576,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + Cost | null} > Cumulative session cost (optional). @@ -8218,11 +8585,13 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d Total context window size in tokens. - Minimum: `0` + Tokens currently in context. - Minimum: `0` + ## WorkspaceFolder @@ -8239,6 +8608,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/draft/extensibility) + The display name of the folder. @@ -8246,4 +8616,3 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/d The URI of the folder. - diff --git a/docs/protocol/v1/schema.mdx b/docs/protocol/v1/schema.mdx index c617fbc2e..65b4a2ed3 100644 --- a/docs/protocol/v1/schema.mdx +++ b/docs/protocol/v1/schema.mdx @@ -3,7 +3,10 @@ title: "Schema" description: "Schema definitions for the Agent Client Protocol" --- -The schema file can be downloaded directly from the [latest GitHub release](https://github.com/agentclientprotocol/agent-client-protocol/releases/latest/download/schema.json). + + The schema file can be downloaded directly from the [latest GitHub + release](https://github.com/agentclientprotocol/agent-client-protocol/releases/latest/download/schema.json). + ## Agent @@ -40,6 +43,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + AuthMethodId} required> The ID of the authentication method to use. @@ -60,6 +64,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + ### initialize @@ -67,6 +72,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e Establishes the connection with a client and negotiates protocol capabilities. This method is called once at the beginning of the connection to: + - Negotiate the protocol version to use - Exchange capability information between client and agent - Determine available authentication methods @@ -93,16 +99,19 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + ClientCapabilities} > Capabilities supported by the client. - Default: `{"fs":{"readTextFile":false,"writeTextFile":false},"terminal":false}` + Implementation | null} > Information about the Client name and version sent to the Agent. Note: in future versions of the protocol, this will be required. + ProtocolVersion} required> The latest protocol version supported by the client. @@ -126,27 +135,32 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + AgentCapabilities} > Capabilities supported by the agent. - Default: `{"loadSession":false,"promptCapabilities":{"image":false,"audio":false,"embeddedContext":false},"mcpCapabilities":{"http":false,"sse":false},"sessionCapabilities":{},"auth":{}}` + Implementation | null} > Information about the Agent name and version sent to the Client. Note: in future versions of the protocol, this will be required. + AuthMethod[]} > Authentication methods supported by the agent. - Default: `[]` + ProtocolVersion} required> The protocol version the client specified if supported by the agent, or the latest protocol version supported by the agent. The client should disconnect, if it doesn't support this version. + ### logout @@ -172,6 +186,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + #### LogoutResponse @@ -188,6 +203,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + @@ -198,6 +214,7 @@ Cancels ongoing operations for a session. This is a notification sent by the client to cancel an ongoing prompt turn. Upon receiving this notification, the Agent SHOULD: + - Stop all language model requests as soon as possible - Abort all tool call invocations in progress - Send any pending `session/update` notifications @@ -221,6 +238,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + SessionId} required> The ID of the session to cancel operations for. @@ -256,6 +274,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + SessionId} required> The ID of the session to close. @@ -275,6 +294,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + @@ -300,6 +320,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + SessionId} required> The ID of the session to delete. @@ -319,6 +340,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + @@ -346,6 +368,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + Opaque cursor token from a previous response's nextCursor field for cursor-based pagination @@ -368,6 +391,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + Opaque cursor token. If present, pass this in the next request's cursor parameter @@ -385,6 +409,7 @@ Loads an existing session to resume a previous conversation. This method is only available if the agent advertises the `loadSession` capability. The agent should: + - Restore the session context and conversation history - Connect to the specified MCP servers - Stream the entire conversation history back to the client via notifications @@ -409,6 +434,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + "string"[]} > Additional workspace roots to activate for this session. Each path must be absolute. @@ -417,6 +443,7 @@ When omitted or empty, no additional roots are activated. When non-empty, this is the complete resulting additional-root list for the loaded session. It may differ from any previously used or reported list as long as the request `cwd` matches the session's `cwd`. + The working directory for this session. @@ -442,6 +469,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + SessionConfigOption[] | null} > Initial session configuration options if supported by the Agent. @@ -450,6 +478,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e Initial mode state if supported by the Agent See protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/v1/session-modes) + @@ -460,6 +489,7 @@ Creates a new conversation session with the agent. Sessions represent independent conversation contexts with their own history and state. The agent should: + - Create a new session context - Connect to any specified MCP servers - Return a unique session ID for future requests @@ -484,6 +514,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + "string"[]} > Additional workspace roots for this session. Each path must be absolute. @@ -491,6 +522,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e These expand the session's filesystem scope without changing `cwd`, which remains the base for relative paths. When omitted or empty, no additional roots are activated for the new session. + The working directory for this session. Must be an absolute path. @@ -515,6 +547,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + SessionConfigOption[] | null} > Initial session configuration options if supported by the Agent. @@ -523,11 +556,13 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e Initial mode state if supported by the Agent See protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/v1/session-modes) + SessionId} required> Unique identifier for the created session. Used in all subsequent requests for this conversation. + @@ -536,6 +571,7 @@ Used in all subsequent requests for this conversation. Processes a user prompt within a session. This method handles the whole lifecycle of a prompt: + - Receives user messages with optional context (files, images, etc.) - Processes the prompt using language models - Reports language model content and tool calls to the Clients @@ -563,6 +599,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + ContentBlock[]} required> The blocks of content that compose the user's message. @@ -578,6 +615,7 @@ The client MAY include referenced pieces of context as either When available, `ContentBlock::Resource` is preferred as it avoids extra round-trips and allows the message to include pieces of context from sources the agent may not have access to. + SessionId} required> The ID of the session to send this user message to @@ -599,6 +637,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + StopReason} required> Indicates why the agent stopped processing the turn. @@ -633,6 +672,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + "string"[]} > Additional workspace roots to activate for this session. Each path must be absolute. @@ -641,6 +681,7 @@ When omitted or empty, no additional roots are activated. When non-empty, this is the complete resulting additional-root list for the resumed session. It may differ from any previously used or reported list as long as the request `cwd` matches the session's `cwd`. + The working directory for this session. @@ -666,6 +707,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + SessionConfigOption[] | null} > Initial session configuration options if supported by the Agent. @@ -674,6 +716,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e Initial mode state if supported by the Agent See protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/v1/session-modes) + @@ -695,6 +738,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + SessionConfigId} required> The ID of the configuration option to set. @@ -720,6 +764,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + SessionConfigOption[]} required> The full set of configuration options and their current values. @@ -756,6 +801,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + SessionModeId} required> The ID of the mode to set. @@ -778,6 +824,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + ## Client @@ -787,6 +834,7 @@ Defines the interface that ACP-compliant clients must implement. Clients are typically code editors (IDEs, text editors) that provide the interface between users and AI agents. They manage the environment, handle user interactions, and control access to resources. + ### fs/read_text_file @@ -813,16 +861,19 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + Maximum number of lines to read. - Minimum: `0` + Line number to start reading from (1-based). - Minimum: `0` + Absolute path to the file to read. @@ -845,6 +896,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + Content payload returned by this response. @@ -876,6 +928,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + The text content to write to the file. @@ -901,6 +954,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + @@ -935,6 +989,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + PermissionOption[]} required> Available permission options for the user to choose from. @@ -960,6 +1015,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + RequestPermissionOutcome} required> The user's decision on the permission request. @@ -998,6 +1054,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + SessionId} required> The ID of the session this update pertains to. @@ -1038,6 +1095,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + "string"[]} > Array of command arguments. @@ -1062,6 +1120,7 @@ string output, even if this means the retained output is slightly less than the specified limit. - Minimum: `0` + SessionId} required> The session ID for this request. @@ -1081,6 +1140,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + TerminalId} required> The unique identifier for the created terminal. @@ -1116,6 +1176,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + SessionId} required> The session ID for this request. @@ -1138,6 +1199,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + @@ -1164,6 +1226,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + SessionId} required> The session ID for this request. @@ -1186,6 +1249,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + TerminalExitStatus | null} > Exit status if the command has completed. @@ -1227,6 +1291,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + SessionId} required> The session ID for this request. @@ -1249,6 +1314,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + @@ -1272,6 +1338,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + SessionId} required> The session ID for this request. @@ -1294,11 +1361,13 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + The process exit code (may be null if terminated by signal). - Minimum: `0` + The signal that terminated the process (may be null if exited normally). @@ -1318,11 +1387,13 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + LogoutCapabilities | null} > Whether the agent supports the logout method. By supplying `\{\}` it means that the agent supports the logout method. + ## AgentCapabilities @@ -1344,31 +1415,37 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + AgentAuthCapabilities} > Authentication-related capabilities supported by the agent. - Default: `{}` + Whether the agent supports `session/load`. - Default: `false` + McpCapabilities} > MCP capabilities supported by the agent. - Default: `{"http":false,"sse":false}` + PromptCapabilities} > Prompt capabilities supported by the agent. - Default: `{"image":false,"audio":false,"embeddedContext":false}` + SessionCapabilities} > Session lifecycle and prompt capabilities advertised by the agent. - Default: `{}` + ## Annotations @@ -1385,6 +1462,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + Role[] | null} > Intended recipients for this content, such as the user or assistant. @@ -1410,6 +1488,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -1442,6 +1521,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + Optional description providing more details about this authentication method. @@ -1469,6 +1549,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + Optional description providing more details about this authentication method. @@ -1500,6 +1581,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + Human-readable description of what the command does. @@ -1527,6 +1609,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + A hint to display when the input hasn't been provided yet @@ -1546,6 +1629,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + AvailableCommand[]} required> Commands the agent can execute @@ -1565,6 +1649,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + Base64-encoded bytes for a binary resource payload. @@ -1595,17 +1680,20 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + FileSystemCapabilities} > File system capabilities supported by the client. Determines which file operations the agent can request. - Default: `{"readTextFile":false,"writeTextFile":false}` + Whether the Client support all `terminal/*` methods. - Default: `false` + ## ConfigOptionUpdate @@ -1622,6 +1710,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + SessionConfigOption[]} required> The full set of configuration options and their current values. @@ -1641,6 +1730,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + ContentBlock} required> The actual content block. @@ -1654,6 +1744,7 @@ They provide a structured way to handle various types of user-facing content—w it's text from language models, images for analysis, or embedded resources for context. Content blocks appear in: + - User prompts sent via `session/prompt` - Language model output streamed through `session/update` notifications - Progress updates and results from tool calls @@ -1679,6 +1770,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -1706,6 +1798,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -1739,6 +1832,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -1769,6 +1863,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -1813,6 +1908,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -1827,8 +1923,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e - - ## ContentChunk A streamed item of content @@ -1843,6 +1937,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + ContentBlock} required> A single item of content @@ -1852,6 +1947,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e All chunks belonging to the same message share the same `messageId`. A change in `messageId` indicates a new message has started. + ## Cost @@ -1868,6 +1964,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + Total cumulative cost for session. @@ -1892,6 +1989,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + SessionModeId} required> The ID of the current mode @@ -1915,6 +2013,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + The new content after modification. @@ -1940,6 +2039,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -1965,6 +2065,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + MIME type describing the encoded media payload. @@ -1990,6 +2091,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + Base64-encoded bytes for a binary resource payload. @@ -2004,8 +2106,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e - - ## EnvVariable An environment variable to set when launching an MCP server. @@ -2020,6 +2120,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + The name of the environment variable. @@ -2042,16 +2143,17 @@ See protocol docs: [JSON-RPC Error Object](https://www.jsonrpc.org/specification **Properties:** ErrorCode} required> - A number indicating the error type that occurred. -This must be an integer as defined in the JSON-RPC specification. + A number indicating the error type that occurred. This must be an integer as + defined in the JSON-RPC specification. - - Optional primitive or structured value that contains additional information about the error. -This may include debugging information or context-specific details. + + Optional primitive or structured value that contains additional information + about the error. This may include debugging information or context-specific + details. - A string providing a short description of the error. -The message should be limited to a concise single sentence. + A string providing a short description of the error. The message should be + limited to a concise single sentence. ## ErrorCode @@ -2064,41 +2166,40 @@ and use the reserved range (-32000 to -32099) for protocol-specific errors. **Type:** Union -**Parse error**: Invalid JSON was received by the server. -An error occurred on the server while parsing the JSON text. + **Parse error**: Invalid JSON was received by the server. An error occurred on + the server while parsing the JSON text. -**Invalid request**: The JSON sent is not a valid Request object. + **Invalid request**: The JSON sent is not a valid Request object. -**Method not found**: The method does not exist or is not available. + **Method not found**: The method does not exist or is not available. -**Invalid params**: Invalid method parameter(s). + **Invalid params**: Invalid method parameter(s). -**Internal error**: Internal JSON-RPC error. -Reserved for implementation-defined server errors. + **Internal error**: Internal JSON-RPC error. Reserved for + implementation-defined server errors. -**Authentication required**: Authentication is required before this operation can be performed. + **Authentication required**: Authentication is required before this operation + can be performed. -**Resource not found**: A given resource, such as a file, was not found. + **Resource not found**: A given resource, such as a file, was not found. -Other undefined error code. + Other undefined error code. - - ## ExtNotification Allows the Agent to send an arbitrary notification that is not part of the ACP spec. @@ -2107,7 +2208,6 @@ while maintaining protocol compatibility. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - ## ExtRequest Allows for sending an arbitrary request that is not part of the ACP spec. @@ -2116,7 +2216,6 @@ protocol compatibility. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - ## ExtResponse Allows for sending an arbitrary response to an `ExtRequest` that is not part of the ACP spec. @@ -2125,7 +2224,6 @@ protocol compatibility. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) - ## FileSystemCapabilities File system capabilities that a client may support. @@ -2142,16 +2240,19 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + Whether the Client supports `fs/read_text_file` requests. - Default: `false` + Whether the Client supports `fs/write_text_file` requests. - Default: `false` + ## HttpHeader @@ -2168,6 +2269,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + The name of the HTTP header. @@ -2190,6 +2292,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -2220,6 +2323,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + Intended for programmatic or logical use, but can be used as a display @@ -2230,6 +2334,7 @@ name fallback if title isn’t present. and easily understood. If not provided, the name should be used for display. + Version of the implementation. Can be displayed to the user or used @@ -2252,6 +2357,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + ## McpCapabilities @@ -2268,16 +2374,19 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + Agent supports `McpServer::Http`. - Default: `false` + Agent supports `McpServer::Sse`. - Default: `false` + ## McpServer @@ -2304,6 +2413,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + HttpHeader[]} required> HTTP headers to set when making requests to the MCP server. @@ -2334,6 +2444,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + HttpHeader[]} required> HTTP headers to set when making requests to the MCP server. @@ -2364,6 +2475,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + "string"[]} required> Command-line arguments to pass to the MCP server. @@ -2381,8 +2493,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e - - ## McpServerHttp HTTP transport configuration for MCP. @@ -2397,6 +2507,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + HttpHeader[]} required> HTTP headers to set when making requests to the MCP server. @@ -2422,6 +2533,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + HttpHeader[]} required> HTTP headers to set when making requests to the MCP server. @@ -2447,6 +2559,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + "string"[]} required> Command-line arguments to pass to the MCP server. @@ -2481,6 +2594,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + PermissionOptionKind} required> Hint about the nature of this permission option. @@ -2507,23 +2621,21 @@ Helps clients choose appropriate icons and UI treatment. **Type:** Union -Allow this operation only this time. + Allow this operation only this time. -Allow this operation and remember the choice. + Allow this operation and remember the choice. -Reject this operation only this time. + Reject this operation only this time. -Reject this operation and remember the choice. + Reject this operation and remember the choice. - - ## Plan An execution plan for accomplishing complex tasks. @@ -2544,12 +2656,14 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + PlanEntry[]} required> The list of tasks to be accomplished. When updating a plan, the agent must send a complete list of all entries with their current status. The client replaces the entire plan with each update. + ## PlanEntry @@ -2570,6 +2684,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + Human-readable description of what this task aims to accomplish. @@ -2593,19 +2708,17 @@ See protocol docs: [Plan Entries](https://agentclientprotocol.com/protocol/v1/ag **Type:** Union -High priority task - critical to the overall goal. + High priority task - critical to the overall goal. -Medium priority task - important but not critical. + Medium priority task - important but not critical. -Low priority task - nice to have but not essential. + Low priority task - nice to have but not essential. - - ## PlanEntryStatus Status of a plan entry in the execution flow. @@ -2616,19 +2729,17 @@ See protocol docs: [Plan Entries](https://agentclientprotocol.com/protocol/v1/ag **Type:** Union -The task has not started yet. + The task has not started yet. -The task is currently being worked on. + The task is currently being worked on. -The task has been successfully completed. + The task has been successfully completed. - - ## PromptCapabilities Prompt capabilities supported by the agent in `session/prompt` requests. @@ -2654,11 +2765,13 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + Agent supports `ContentBlock::Audio`. - Default: `false` + Agent supports embedded context in `session/prompt` requests. @@ -2667,11 +2780,13 @@ When enabled, the Client is allowed to include `ContentBlock::Resource` in prompt requests for pieces of context that are referenced in the message. - Default: `false` + Agent supports `ContentBlock::Image`. - Default: `false` + ## ProtocolVersion @@ -2683,10 +2798,10 @@ Non-breaking changes should be introduced via capabilities. **Type:** `integer (uint16)` -| Constraint | Value | -| ---------- | ----- | -| Minimum | `0` | -| Maximum | `65535` | +| Constraint | Value | +| ---------- | ------- | +| Minimum | `0` | +| Maximum | `65535` | ## RequestId @@ -2703,19 +2818,17 @@ The Server MUST reply with the same value in the Response object if included. Th **Type:** Union -The JSON-RPC `null` request id. + The JSON-RPC `null` request id. -A numeric JSON-RPC request id. + A numeric JSON-RPC request id. -A string JSON-RPC request id. + A string JSON-RPC request id. - - ## RequestPermissionOutcome The outcome of a permission request. @@ -2751,6 +2864,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + PermissionOptionId} required> The ID of the option the user selected. @@ -2762,8 +2876,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e - - ## ResourceLink A resource that the server is capable of reading, included in a prompt or tool call result. @@ -2778,6 +2890,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -2808,15 +2921,13 @@ The sender or recipient of messages and data in a conversation. **Type:** Union -The assistant side of a conversation. + The assistant side of a conversation. -The user side of a conversation. + The user side of a conversation. - - ## SelectedPermissionOutcome The user selected one of the provided options. @@ -2831,6 +2942,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + PermissionOptionId} required> The ID of the option the user selected. @@ -2855,6 +2967,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + ## SessionCapabilities @@ -2879,6 +2992,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + SessionAdditionalDirectoriesCapabilities | null} > Whether the agent supports `additionalDirectories` on supported session lifecycle requests. @@ -2886,6 +3000,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e Agents that also support `session/list` may return `SessionInfo.additionalDirectories` to report the complete ordered additional-root list associated with a listed session. + SessionCloseCapabilities | null} > Whether the agent supports `session/close`. @@ -2895,6 +3010,7 @@ additional-root list associated with a listed session. Optional. Omitted or `null` both mean the agent does not advertise support. Supplying `\{\}` means the agent supports deleting sessions from `session/list`. + SessionListCapabilities | null} > Whether the agent supports `session/list`. @@ -2919,6 +3035,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + ## SessionConfigGroupId @@ -2943,10 +3060,18 @@ Single-value selector (dropdown). **Properties:** -SessionConfigValueId} required> +SessionConfigValueId} + required +> The currently selected value. -SessionConfigSelectOptions} required> +SessionConfigSelectOptions} + required +> The set of selectable options. @@ -2968,27 +3093,25 @@ Category names that do not begin with `_` are reserved for the ACP spec. **Type:** Union -Session mode selector. + Session mode selector. -Model selector. + Model selector. -Model-related configuration parameter. + Model-related configuration parameter. -Thought/reasoning level selector. + Thought/reasoning level selector. -Unknown / uncategorized selector. + Unknown / uncategorized selector. - - ## SessionConfigSelect A single-value selector (dropdown) session configuration option payload. @@ -2997,10 +3120,18 @@ A single-value selector (dropdown) session configuration option payload. **Properties:** -SessionConfigValueId} required> +SessionConfigValueId} + required +> The currently selected value. -SessionConfigSelectOptions} required> +SessionConfigSelectOptions} + required +> The set of selectable options. @@ -3018,6 +3149,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + SessionConfigGroupId} required> Unique identifier for this group. @@ -3043,6 +3175,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + Optional description for this option value. @@ -3061,15 +3194,13 @@ Possible values for a session configuration option. **Type:** Union -A flat list of options with no grouping. + A flat list of options with no grouping. -A list of options grouped under headers. + A list of options grouped under headers. - - ## SessionConfigValueId Unique identifier for a session configuration option value. @@ -3092,6 +3223,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + ## SessionId @@ -3119,6 +3251,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + "string"[]} > Additional workspace roots reported for this session. Each path must be absolute. @@ -3126,6 +3259,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e When present, this is the complete ordered additional-root list reported by the Agent. Omitted and empty values are equivalent: the response reports no additional roots. + The working directory for this session. Must be an absolute path. @@ -3157,6 +3291,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + Human-readable title for the session. Set to null to clear. @@ -3181,6 +3316,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + ## SessionMode @@ -3199,6 +3335,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + Optional human-readable details shown with this protocol object. @@ -3230,6 +3367,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + SessionMode[]} required> The set of modes that the Agent can operate in @@ -3254,6 +3392,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + ## SessionUpdate @@ -3277,6 +3416,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + ContentBlock} required> A single item of content @@ -3286,6 +3426,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e All chunks belonging to the same message share the same `messageId`. A change in `messageId` indicates a new message has started. + The discriminator value. Must be `"user_message_chunk"`. @@ -3305,6 +3446,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + ContentBlock} required> A single item of content @@ -3314,6 +3456,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e All chunks belonging to the same message share the same `messageId`. A change in `messageId` indicates a new message has started. + The discriminator value. Must be `"agent_message_chunk"`. @@ -3333,6 +3476,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + ContentBlock} required> A single item of content @@ -3342,6 +3486,7 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e All chunks belonging to the same message share the same `messageId`. A change in `messageId` indicates a new message has started. + The discriminator value. Must be `"agent_thought_chunk"`. @@ -3361,6 +3506,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + ToolCallContent[]} > Content produced by the tool call. @@ -3406,6 +3552,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + ToolCallContent[] | null} > Replace the content collection. @@ -3450,12 +3597,14 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + PlanEntry[]} required> The list of tasks to be accomplished. When updating a plan, the agent must send a complete list of all entries with their current status. The client replaces the entire plan with each update. + The discriminator value. Must be `"plan"`. @@ -3475,6 +3624,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + AvailableCommand[]} required> Commands the agent can execute @@ -3499,6 +3649,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + SessionModeId} required> The ID of the current mode @@ -3521,6 +3672,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + SessionConfigOption[]} required> The full set of configuration options and their current values. @@ -3543,6 +3695,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + The discriminator value. Must be `"session_info_update"`. @@ -3568,6 +3721,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + Cost | null} > Cumulative session cost (optional). @@ -3579,18 +3733,18 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e Total context window size in tokens. - Minimum: `0` + Tokens currently in context. - Minimum: `0` + - - ## StopReason Reasons why an agent stops processing a prompt turn. @@ -3600,22 +3754,22 @@ See protocol docs: [Stop Reasons](https://agentclientprotocol.com/protocol/v1/pr **Type:** Union -The turn ended successfully. + The turn ended successfully. -The turn ended because the agent reached the maximum number of tokens. + The turn ended because the agent reached the maximum number of tokens. -The turn ended because the agent reached the maximum number of allowed -agent requests between user turns. + The turn ended because the agent reached the maximum number of allowed agent + requests between user turns. -The turn ended because the agent refused to continue. The user prompt -and everything that comes after it won't be included in the next -prompt, so this should be reflected in the UI. + The turn ended because the agent refused to continue. The user prompt and + everything that comes after it won't be included in the next prompt, so this + should be reflected in the UI. @@ -3625,9 +3779,8 @@ This stop reason MUST be returned when the client sends a `session/cancel` notification, even if the cancellation causes exceptions in underlying operations. Agents should catch these exceptions and return this semantically meaningful response to confirm successful cancellation. - - + ## Terminal @@ -3647,6 +3800,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + TerminalId} required> Identifier of the terminal instance to embed in the content stream. @@ -3666,11 +3820,13 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + The process exit code (may be null if terminated by signal). - Minimum: `0` + The signal that terminated the process (may be null if exited normally). @@ -3696,6 +3852,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + Annotations | null} > Optional annotations that help clients decide how to display or route this content. @@ -3718,6 +3875,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + MIME type describing the encoded media payload. @@ -3748,6 +3906,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + ToolCallContent[]} > Content produced by the tool call. @@ -3798,6 +3957,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + ContentBlock} required> The actual content block. @@ -3820,6 +3980,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + The new content after modification. @@ -3852,6 +4013,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + TerminalId} required> Identifier of the terminal instance to embed in the content stream. @@ -3863,8 +4025,6 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e - - ## ToolCallId Unique identifier for a tool call within a session. @@ -3890,11 +4050,13 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + Optional line number within the file. - Minimum: `0` + The file path being accessed or modified. @@ -3911,24 +4073,22 @@ See protocol docs: [Status](https://agentclientprotocol.com/protocol/v1/tool-cal **Type:** Union -The tool call hasn't started running yet because the input is either -streaming or we're awaiting approval. + The tool call hasn't started running yet because the input is either streaming + or we're awaiting approval. -The tool call is currently running. + The tool call is currently running. -The tool call completed successfully. + The tool call completed successfully. -The tool call failed with an error. + The tool call failed with an error. - - ## ToolCallUpdate An update to an existing tool call. @@ -3948,6 +4108,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + ToolCallContent[] | null} > Replace the content collection. @@ -3986,47 +4147,45 @@ See protocol docs: [Creating](https://agentclientprotocol.com/protocol/v1/tool-c **Type:** Union -Reading files or data. + Reading files or data. -Modifying files or content. + Modifying files or content. -Removing files or data. + Removing files or data. -Moving or renaming files. + Moving or renaming files. -Searching for information. + Searching for information. -Running commands or code. + Running commands or code. -Internal reasoning or planning. + Internal reasoning or planning. -Retrieving external data. + Retrieving external data. -Switching the current session mode. + Switching the current session mode. -Other tool types (default). + Other tool types (default). - - ## UnstructuredCommandInput All text that was typed after the command name is provided as input. @@ -4041,6 +4200,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + A hint to display when the input hasn't been provided yet @@ -4060,6 +4220,7 @@ metadata to their interactions. Implementations MUST NOT make assumptions about these keys. See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/extensibility) + Cost | null} > Cumulative session cost (optional). @@ -4068,10 +4229,11 @@ See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v1/e Total context window size in tokens. - Minimum: `0` + Tokens currently in context. - Minimum: `0` - + diff --git a/docs/protocol/v2/draft/schema.mdx b/docs/protocol/v2/draft/schema.mdx index 63ed28c7a..30c691b61 100644 --- a/docs/protocol/v2/draft/schema.mdx +++ b/docs/protocol/v2/draft/schema.mdx @@ -2005,7 +2005,7 @@ stop reason. See protocol docs: [Agent Reports Output](https://agentclientprotocol.com/protocol/v2/draft/prompt-lifecycle#3-agent-reports-output) -#### SessionUpdateNotification +#### UpdateSessionNotification Notification containing a session update from the agent. diff --git a/docs/protocol/v2/schema.mdx b/docs/protocol/v2/schema.mdx index 4e45e2bca..8ef59f4ab 100644 --- a/docs/protocol/v2/schema.mdx +++ b/docs/protocol/v2/schema.mdx @@ -839,7 +839,7 @@ stop reason. See protocol docs: [Agent Reports Output](https://agentclientprotocol.com/protocol/v2/prompt-lifecycle#3-agent-reports-output) -#### SessionUpdateNotification +#### UpdateSessionNotification Notification containing a session update from the agent. diff --git a/schema-generator/src/main.rs b/schema-generator/src/main.rs index 83fa61d55..51ea31d5a 100644 --- a/schema-generator/src/main.rs +++ b/schema-generator/src/main.rs @@ -1917,7 +1917,7 @@ starting with '$/' it is free to ignore the notification." "fs/read_text_file" => self.client.get("ReadTextFileRequest").unwrap(), "session/update" => self .client - .get("SessionUpdateNotification") + .get("UpdateSessionNotification") .or_else(|| self.client.get("SessionNotification")) .unwrap(), "terminal/create" => self.client.get("CreateTerminalRequest").unwrap(), diff --git a/schema/v1/meta.json b/schema/v1/meta.json index 12e2733db..9281f19f3 100644 --- a/schema/v1/meta.json +++ b/schema/v1/meta.json @@ -26,4 +26,4 @@ "terminal_wait_for_exit": "terminal/wait_for_exit", "terminal_kill": "terminal/kill" } -} \ No newline at end of file +} diff --git a/schema/v1/meta.unstable.json b/schema/v1/meta.unstable.json index ddb9475d3..d8937f384 100644 --- a/schema/v1/meta.unstable.json +++ b/schema/v1/meta.unstable.json @@ -49,4 +49,4 @@ "protocolMethods": { "cancel_request": "$/cancel_request" } -} \ No newline at end of file +} diff --git a/schema/v1/schema.json b/schema/v1/schema.json index 3588c089f..6d1baa89c 100644 --- a/schema/v1/schema.json +++ b/schema/v1/schema.json @@ -9,14 +9,10 @@ "properties": { "jsonrpc": { "type": "string", - "enum": [ - "2.0" - ] + "enum": ["2.0"] } }, - "required": [ - "jsonrpc" - ], + "required": ["jsonrpc"], "anyOf": [ { "title": "Request", @@ -51,14 +47,10 @@ "properties": { "jsonrpc": { "type": "string", - "enum": [ - "2.0" - ] + "enum": ["2.0"] } }, - "required": [ - "jsonrpc" - ], + "required": ["jsonrpc"], "anyOf": [ { "title": "Request", @@ -199,10 +191,7 @@ ] } }, - "required": [ - "id", - "method" - ], + "required": ["id", "method"], "x-docs-ignore": true }, "RequestId": { @@ -248,19 +237,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "path", - "content" - ], + "required": ["sessionId", "path", "content"], "x-side": "client", "x-method": "fs/write_text_file" }, @@ -286,38 +268,26 @@ }, "line": { "description": "Line number to start reading from (1-based).", - "type": [ - "integer", - "null" - ], + "type": ["integer", "null"], "format": "uint32", "minimum": 0, "x-deserialize-default-on-error": true }, "limit": { "description": "Maximum number of lines to read.", - "type": [ - "integer", - "null" - ], + "type": ["integer", "null"], "format": "uint32", "minimum": 0, "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "path" - ], + "required": ["sessionId", "path"], "x-side": "client", "x-method": "fs/read_text_file" }, @@ -352,19 +322,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "toolCall", - "options" - ], + "required": ["sessionId", "toolCall", "options"], "x-side": "client", "x-method": "session/request_permission" }, @@ -406,18 +369,12 @@ }, "title": { "description": "Update the human-readable title.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "content": { "description": "Replace the content collection.", - "type": [ - "array", - "null" - ], + "type": ["array", "null"], "items": { "$ref": "#/$defs/ToolCallContent" }, @@ -426,10 +383,7 @@ }, "locations": { "description": "Replace the locations collection.", - "type": [ - "array", - "null" - ], + "type": ["array", "null"], "items": { "$ref": "#/$defs/ToolCallLocation" }, @@ -446,17 +400,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "toolCallId" - ] + "required": ["toolCallId"] }, "ToolCallId": { "description": "Unique identifier for a tool call within a session.", @@ -554,9 +503,7 @@ "const": "content" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/Content" @@ -572,9 +519,7 @@ "const": "diff" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/Diff" @@ -590,9 +535,7 @@ "const": "terminal" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/Terminal" @@ -616,9 +559,7 @@ "const": "text" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/TextContent" @@ -634,9 +575,7 @@ "const": "image" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/ImageContent" @@ -652,9 +591,7 @@ "const": "audio" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/AudioContent" @@ -670,9 +607,7 @@ "const": "resource_link" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/ResourceLink" @@ -688,9 +623,7 @@ "const": "resource" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/EmbeddedResource" @@ -708,10 +641,7 @@ "properties": { "audience": { "description": "Intended recipients for this content, such as the user or assistant.", - "type": [ - "array", - "null" - ], + "type": ["array", "null"], "items": { "$ref": "#/$defs/Role" }, @@ -720,27 +650,18 @@ }, "lastModified": { "description": "Timestamp indicating when the underlying resource was last modified.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "priority": { "description": "Relative importance of this content when clients choose what to surface.", - "type": [ - "number", - "null" - ], + "type": ["number", "null"], "format": "double", "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -783,17 +704,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "text" - ] + "required": ["text"] }, "ImageContent": { "description": "An image provided to or from an LLM.", @@ -821,26 +737,17 @@ }, "uri": { "description": "URI associated with this resource or media payload.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "data", - "mimeType" - ] + "required": ["data", "mimeType"] }, "AudioContent": { "description": "Audio provided to or from an LLM.", @@ -868,18 +775,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "data", - "mimeType" - ] + "required": ["data", "mimeType"] }, "ResourceLink": { "description": "A resource that the server is capable of reading, included in a prompt or tool call result.", @@ -899,18 +800,12 @@ }, "description": { "description": "Optional human-readable details shown with this protocol object.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "mimeType": { "description": "MIME type describing the encoded media payload.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "name": { @@ -919,19 +814,13 @@ }, "size": { "description": "Optional size of the linked resource in bytes, if known.", - "type": [ - "integer", - "null" - ], + "type": ["integer", "null"], "format": "int64", "x-deserialize-default-on-error": true }, "title": { "description": "Optional display title for end-user UI.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "uri": { @@ -940,18 +829,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "name", - "uri" - ] + "required": ["name", "uri"] }, "EmbeddedResourceResource": { "description": "Resource content that can be embedded in a message.", @@ -982,10 +865,7 @@ "properties": { "mimeType": { "description": "MIME type describing the encoded media payload.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "text": { @@ -998,18 +878,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "text", - "uri" - ] + "required": ["text", "uri"] }, "BlobResourceContents": { "description": "Binary resource contents.", @@ -1021,10 +895,7 @@ }, "mimeType": { "description": "MIME type describing the encoded media payload.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "uri": { @@ -1033,18 +904,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "blob", - "uri" - ] + "required": ["blob", "uri"] }, "EmbeddedResource": { "description": "The contents of a resource, embedded into a prompt or tool call result.", @@ -1072,17 +937,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "resource" - ] + "required": ["resource"] }, "Content": { "description": "Standard content block (text, images, resources).", @@ -1098,17 +958,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "content" - ] + "required": ["content"] }, "Diff": { "description": "A diff representing file modifications.\n\nShows changes to files in a format suitable for display in the client UI.\n\nSee protocol docs: [Content](https://agentclientprotocol.com/protocol/tool-calls#content)", @@ -1120,10 +975,7 @@ }, "oldText": { "description": "The original content (None for new files).", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "newText": { @@ -1132,18 +984,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "path", - "newText" - ] + "required": ["path", "newText"] }, "TerminalId": { "description": "Typed identifier used for terminal values on the wire.", @@ -1163,17 +1009,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "terminalId" - ] + "required": ["terminalId"] }, "ToolCallLocation": { "description": "A file location being accessed or modified by a tool.\n\nEnables clients to implement \"follow-along\" features that track\nwhich files the agent is working with in real-time.\n\nSee protocol docs: [Following the Agent](https://agentclientprotocol.com/protocol/tool-calls#following-the-agent)", @@ -1185,27 +1026,19 @@ }, "line": { "description": "Optional line number within the file.", - "type": [ - "integer", - "null" - ], + "type": ["integer", "null"], "format": "uint32", "minimum": 0, "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "path" - ] + "required": ["path"] }, "PermissionOption": { "description": "An option presented to the user when requesting permission.", @@ -1233,19 +1066,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "optionId", - "name", - "kind" - ] + "required": ["optionId", "name", "kind"] }, "PermissionOptionId": { "description": "Unique identifier for a permission option.", @@ -1312,36 +1138,24 @@ }, "cwd": { "description": "Working directory for the command (absolute path).", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "outputByteLimit": { "description": "Maximum number of output bytes to retain.\n\nWhen the limit is exceeded, the Client truncates from the beginning of the output\nto stay within the limit.\n\nThe Client MUST ensure truncation happens at a character boundary to maintain valid\nstring output, even if this means the retained output is slightly less than the\nspecified limit.", - "type": [ - "integer", - "null" - ], + "type": ["integer", "null"], "format": "uint64", "minimum": 0, "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "command" - ], + "required": ["sessionId", "command"], "x-side": "client", "x-method": "terminal/create" }, @@ -1359,18 +1173,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "name", - "value" - ] + "required": ["name", "value"] }, "TerminalOutputRequest": { "description": "Request to get the current output and status of a terminal.", @@ -1394,18 +1202,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "terminalId" - ], + "required": ["sessionId", "terminalId"], "x-side": "client", "x-method": "terminal/output" }, @@ -1431,18 +1233,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "terminalId" - ], + "required": ["sessionId", "terminalId"], "x-side": "client", "x-method": "terminal/release" }, @@ -1468,18 +1264,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "terminalId" - ], + "required": ["sessionId", "terminalId"], "x-side": "client", "x-method": "terminal/wait_for_exit" }, @@ -1505,18 +1295,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "terminalId" - ], + "required": ["sessionId", "terminalId"], "x-side": "client", "x-method": "terminal/kill" }, @@ -1662,10 +1446,7 @@ ] } }, - "required": [ - "id", - "result" - ] + "required": ["id", "result"] }, { "title": "Error", @@ -1689,10 +1470,7 @@ ] } }, - "required": [ - "id", - "error" - ] + "required": ["id", "error"] } ], "x-docs-ignore": true @@ -1756,17 +1534,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "protocolVersion" - ], + "required": ["protocolVersion"], "x-side": "agent", "x-method": "initialize" }, @@ -1836,10 +1609,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1869,10 +1639,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1896,10 +1663,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1971,10 +1735,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1986,10 +1747,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2001,10 +1759,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2016,10 +1771,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2031,10 +1783,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2046,10 +1795,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2073,10 +1819,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2088,10 +1831,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2129,26 +1869,17 @@ }, "description": { "description": "Optional description providing more details about this authentication method.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "id", - "name" - ] + "required": ["id", "name"] }, "AuthMethodId": { "description": "Typed identifier used for auth method values on the wire.", @@ -2164,10 +1895,7 @@ }, "title": { "description": "Intended for UI and end-user contexts — optimized to be human-readable\nand easily understood.\n\nIf not provided, the name should be used for display.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "version": { @@ -2176,18 +1904,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "name", - "version" - ] + "required": ["name", "version"] }, "AuthenticateResponse": { "description": "Response to the `authenticate` method.", @@ -2195,10 +1917,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2212,10 +1931,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2249,10 +1965,7 @@ }, "configOptions": { "description": "Initial session configuration options if supported by the Agent.", - "type": [ - "array", - "null" - ], + "type": ["array", "null"], "items": { "$ref": "#/$defs/SessionConfigOption" }, @@ -2261,17 +1974,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId" - ], + "required": ["sessionId"], "x-side": "agent", "x-method": "session/new" }, @@ -2298,18 +2006,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "currentModeId", - "availableModes" - ] + "required": ["currentModeId", "availableModes"] }, "SessionModeId": { "description": "Unique identifier for a Session Mode.", @@ -2333,26 +2035,17 @@ }, "description": { "description": "Optional human-readable details shown with this protocol object.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "id", - "name" - ] + "required": ["id", "name"] }, "SessionConfigOption": { "description": "A session configuration option selector and its current state.", @@ -2372,10 +2065,7 @@ }, "description": { "description": "Optional description for the Client to display to the user.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "category": { @@ -2392,18 +2082,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "id", - "name" - ], + "required": ["id", "name"], "oneOf": [ { "description": "Single-value selector (dropdown).", @@ -2414,9 +2098,7 @@ "const": "select" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/SessionConfigSelect" @@ -2505,26 +2187,17 @@ }, "description": { "description": "Optional description for this option value.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "value", - "name" - ] + "required": ["value", "name"] }, "SessionConfigSelectGroup": { "description": "A group of possible values for a session configuration option.", @@ -2553,19 +2226,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "group", - "name", - "options" - ] + "required": ["group", "name", "options"] }, "SessionConfigGroupId": { "description": "Unique identifier for a session configuration option value group.", @@ -2592,10 +2258,7 @@ ] } }, - "required": [ - "currentValue", - "options" - ] + "required": ["currentValue", "options"] }, "LoadSessionResponse": { "description": "Response from loading an existing session.", @@ -2615,10 +2278,7 @@ }, "configOptions": { "description": "Initial session configuration options if supported by the Agent.", - "type": [ - "array", - "null" - ], + "type": ["array", "null"], "items": { "$ref": "#/$defs/SessionConfigOption" }, @@ -2627,10 +2287,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2653,25 +2310,17 @@ }, "nextCursor": { "description": "Opaque cursor token. If present, pass this in the next request's cursor parameter\nto fetch the next page. If absent, there are no more results.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessions" - ], + "required": ["sessions"], "x-side": "agent", "x-method": "session/list" }, @@ -2702,34 +2351,22 @@ }, "title": { "description": "Human-readable title for the session", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "updatedAt": { "description": "ISO 8601 timestamp of last activity", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "cwd" - ] + "required": ["sessionId", "cwd"] }, "DeleteSessionResponse": { "description": "Response from deleting a session.", @@ -2737,10 +2374,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2766,10 +2400,7 @@ }, "configOptions": { "description": "Initial session configuration options if supported by the Agent.", - "type": [ - "array", - "null" - ], + "type": ["array", "null"], "items": { "$ref": "#/$defs/SessionConfigOption" }, @@ -2778,10 +2409,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2795,10 +2423,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2812,10 +2437,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2838,17 +2460,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "configOptions" - ], + "required": ["configOptions"], "x-side": "agent", "x-method": "session/set_config_option" }, @@ -2866,17 +2483,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "stopReason" - ], + "required": ["stopReason"], "x-side": "agent", "x-method": "session/prompt" }, @@ -2934,10 +2546,7 @@ "x-deserialize-default-on-error": true } }, - "required": [ - "code", - "message" - ] + "required": ["code", "message"] }, "ErrorCode": { "description": "Predefined error codes for common JSON-RPC and ACP-specific errors.\n\nThese codes follow the JSON-RPC 2.0 specification for standard errors\nand use the reserved range (-32000 to -32099) for protocol-specific errors.", @@ -3039,9 +2648,7 @@ ] } }, - "required": [ - "method" - ], + "required": ["method"], "x-docs-ignore": true }, "SessionNotification": { @@ -3066,18 +2673,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "update" - ], + "required": ["sessionId", "update"], "x-side": "client", "x-method": "session/update" }, @@ -3093,9 +2694,7 @@ "const": "user_message_chunk" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/ContentChunk" @@ -3111,9 +2710,7 @@ "const": "agent_message_chunk" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/ContentChunk" @@ -3129,9 +2726,7 @@ "const": "agent_thought_chunk" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/ContentChunk" @@ -3147,9 +2742,7 @@ "const": "tool_call" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/ToolCall" @@ -3165,9 +2758,7 @@ "const": "tool_call_update" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/ToolCallUpdate" @@ -3183,9 +2774,7 @@ "const": "plan" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/Plan" @@ -3201,9 +2790,7 @@ "const": "available_commands_update" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/AvailableCommandsUpdate" @@ -3219,9 +2806,7 @@ "const": "current_mode_update" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/CurrentModeUpdate" @@ -3237,9 +2822,7 @@ "const": "config_option_update" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/ConfigOptionUpdate" @@ -3255,9 +2838,7 @@ "const": "session_info_update" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/SessionInfoUpdate" @@ -3273,9 +2854,7 @@ "const": "usage_update" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/UsageUpdate" @@ -3317,17 +2896,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "content" - ] + "required": ["content"] }, "ToolCall": { "description": "Represents a tool call that the language model has requested.\n\nTool calls are actions that the agent executes on behalf of the language model,\nsuch as reading files, executing code, or fetching data from external sources.\n\nSee protocol docs: [Tool Calls](https://agentclientprotocol.com/protocol/tool-calls)", @@ -3391,18 +2965,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "toolCallId", - "title" - ] + "required": ["toolCallId", "title"] }, "PlanEntry": { "description": "A single entry in the execution plan.\n\nRepresents a task or goal that the assistant intends to accomplish\nas part of fulfilling the user's request.\nSee protocol docs: [Plan Entries](https://agentclientprotocol.com/protocol/agent-plan#plan-entries)", @@ -3430,19 +2998,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "content", - "priority", - "status" - ] + "required": ["content", "priority", "status"] }, "PlanEntryPriority": { "description": "Priority levels for plan entries.\n\nUsed to indicate the relative importance or urgency of different\ntasks in the execution plan.\nSee protocol docs: [Plan Entries](https://agentclientprotocol.com/protocol/agent-plan#plan-entries)", @@ -3499,17 +3060,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "entries" - ] + "required": ["entries"] }, "AvailableCommand": { "description": "Information about a command.", @@ -3537,18 +3093,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "name", - "description" - ] + "required": ["name", "description"] }, "AvailableCommandInput": { "description": "The input specification for a command.", @@ -3574,17 +3124,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "hint" - ] + "required": ["hint"] }, "AvailableCommandsUpdate": { "description": "Available commands are ready or have changed", @@ -3601,17 +3146,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "availableCommands" - ] + "required": ["availableCommands"] }, "CurrentModeUpdate": { "description": "The current mode of the session has changed\n\nSee protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/session-modes)", @@ -3627,17 +3167,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "currentModeId" - ] + "required": ["currentModeId"] }, "ConfigOptionUpdate": { "description": "Session configuration options have been updated.", @@ -3654,17 +3189,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "configOptions" - ] + "required": ["configOptions"] }, "SessionInfoUpdate": { "description": "Update to session metadata. All fields are optional to support partial updates.\n\nAgents send this notification to update session information like title or custom metadata.\nThis allows clients to display dynamic session names and track session state changes.", @@ -3672,26 +3202,17 @@ "properties": { "title": { "description": "Human-readable title for the session. Set to null to clear.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "updatedAt": { "description": "ISO 8601 timestamp of last activity. Set to null to clear.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3712,18 +3233,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "amount", - "currency" - ] + "required": ["amount", "currency"] }, "UsageUpdate": { "description": "Context window and cost update for a session.", @@ -3755,18 +3270,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "used", - "size" - ] + "required": ["used", "size"] }, "ExtNotification": { "description": "Allows the Agent to send an arbitrary notification that is not part of the ACP spec.\nExtension notifications provide a way to send one-way messages for custom functionality\nwhile maintaining protocol compatibility.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)" @@ -3918,10 +3427,7 @@ ] } }, - "required": [ - "id", - "method" - ], + "required": ["id", "method"], "x-docs-ignore": true }, "InitializeRequest": { @@ -3966,17 +3472,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "protocolVersion" - ], + "required": ["protocolVersion"], "x-side": "agent", "x-method": "initialize" }, @@ -4005,10 +3506,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -4032,10 +3530,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -4055,17 +3550,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "methodId" - ], + "required": ["methodId"], "x-side": "agent", "x-method": "authenticate" }, @@ -4075,10 +3565,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -4114,18 +3601,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "cwd", - "mcpServers" - ], + "required": ["cwd", "mcpServers"], "x-side": "agent", "x-method": "session/new" }, @@ -4141,9 +3622,7 @@ "const": "http" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/McpServerHttp" @@ -4159,9 +3638,7 @@ "const": "sse" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/McpServerSse" @@ -4193,18 +3670,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "name", - "value" - ] + "required": ["name", "value"] }, "McpServerHttp": { "description": "HTTP transport configuration for MCP.", @@ -4229,19 +3700,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "name", - "url", - "headers" - ] + "required": ["name", "url", "headers"] }, "McpServerSse": { "description": "SSE transport configuration for MCP.", @@ -4266,19 +3730,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "name", - "url", - "headers" - ] + "required": ["name", "url", "headers"] }, "McpServerStdio": { "description": "Stdio transport configuration for MCP.", @@ -4312,20 +3769,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "name", - "command", - "args", - "env" - ] + "required": ["name", "command", "args", "env"] }, "LoadSessionRequest": { "description": "Request parameters for loading an existing session.\n\nOnly available if the Agent supports the `loadSession` capability.\n\nSee protocol docs: [Loading Sessions](https://agentclientprotocol.com/protocol/session-setup#loading-sessions)", @@ -4363,19 +3812,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "mcpServers", - "cwd", - "sessionId" - ], + "required": ["mcpServers", "cwd", "sessionId"], "x-side": "agent", "x-method": "session/load" }, @@ -4385,26 +3827,17 @@ "properties": { "cwd": { "description": "Filter sessions by working directory. Must be an absolute path.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "cursor": { "description": "Opaque cursor token from a previous response's nextCursor field for cursor-based pagination", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -4426,17 +3859,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId" - ], + "required": ["sessionId"], "x-side": "agent", "x-method": "session/delete" }, @@ -4476,18 +3904,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "cwd" - ], + "required": ["sessionId", "cwd"], "x-side": "agent", "x-method": "session/resume" }, @@ -4505,17 +3927,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId" - ], + "required": ["sessionId"], "x-side": "agent", "x-method": "session/close" }, @@ -4541,18 +3958,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "modeId" - ], + "required": ["sessionId", "modeId"], "x-side": "agent", "x-method": "session/set_mode" }, @@ -4586,19 +3997,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "configId", - "value" - ], + "required": ["sessionId", "configId", "value"], "x-side": "agent", "x-method": "session/set_config_option" }, @@ -4625,18 +4029,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "prompt" - ], + "required": ["sessionId", "prompt"], "x-side": "agent", "x-method": "session/prompt" }, @@ -4743,10 +4141,7 @@ ] } }, - "required": [ - "id", - "result" - ] + "required": ["id", "result"] }, { "title": "Error", @@ -4770,10 +4165,7 @@ ] } }, - "required": [ - "id", - "error" - ] + "required": ["id", "error"] } ], "x-docs-ignore": true @@ -4784,10 +4176,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -4805,17 +4194,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "content" - ], + "required": ["content"], "x-side": "client", "x-method": "fs/read_text_file" }, @@ -4833,17 +4217,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "outcome" - ], + "required": ["outcome"], "x-side": "client", "x-method": "session/request_permission" }, @@ -4859,9 +4238,7 @@ "const": "cancelled" } }, - "required": [ - "outcome" - ] + "required": ["outcome"] }, { "description": "The user selected one of the provided options.", @@ -4872,9 +4249,7 @@ "const": "selected" } }, - "required": [ - "outcome" - ], + "required": ["outcome"], "allOf": [ { "$ref": "#/$defs/SelectedPermissionOutcome" @@ -4900,17 +4275,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "optionId" - ] + "required": ["optionId"] }, "CreateTerminalResponse": { "description": "Response containing the ID of the created terminal.", @@ -4926,17 +4296,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "terminalId" - ], + "required": ["terminalId"], "x-side": "client", "x-method": "terminal/create" }, @@ -4966,18 +4331,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "output", - "truncated" - ], + "required": ["output", "truncated"], "x-side": "client", "x-method": "terminal/output" }, @@ -4987,28 +4346,19 @@ "properties": { "exitCode": { "description": "The process exit code (may be null if terminated by signal).", - "type": [ - "integer", - "null" - ], + "type": ["integer", "null"], "format": "uint32", "minimum": 0, "x-deserialize-default-on-error": true }, "signal": { "description": "The signal that terminated the process (may be null if exited normally).", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -5020,10 +4370,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -5037,28 +4384,19 @@ "properties": { "exitCode": { "description": "The process exit code (may be null if terminated by signal).", - "type": [ - "integer", - "null" - ], + "type": ["integer", "null"], "format": "uint32", "minimum": 0, "x-deserialize-default-on-error": true }, "signal": { "description": "The signal that terminated the process (may be null if exited normally).", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -5072,10 +4410,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -5123,9 +4458,7 @@ ] } }, - "required": [ - "method" - ], + "required": ["method"], "x-docs-ignore": true }, "CancelNotification": { @@ -5142,19 +4475,14 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId" - ], + "required": ["sessionId"], "x-side": "agent", "x-method": "session/cancel" } } -} \ No newline at end of file +} diff --git a/schema/v1/schema.unstable.json b/schema/v1/schema.unstable.json index 99f24246c..cd608976e 100644 --- a/schema/v1/schema.unstable.json +++ b/schema/v1/schema.unstable.json @@ -9,14 +9,10 @@ "properties": { "jsonrpc": { "type": "string", - "enum": [ - "2.0" - ] + "enum": ["2.0"] } }, - "required": [ - "jsonrpc" - ], + "required": ["jsonrpc"], "anyOf": [ { "title": "Request", @@ -51,14 +47,10 @@ "properties": { "jsonrpc": { "type": "string", - "enum": [ - "2.0" - ] + "enum": ["2.0"] } }, - "required": [ - "jsonrpc" - ], + "required": ["jsonrpc"], "anyOf": [ { "title": "Request", @@ -93,9 +85,7 @@ "properties": { "jsonrpc": { "type": "string", - "enum": [ - "2.0" - ] + "enum": ["2.0"] }, "method": { "description": "The notification method name.", @@ -124,10 +114,7 @@ ] } }, - "required": [ - "jsonrpc", - "method" - ], + "required": ["jsonrpc", "method"], "x-docs-ignore": true } ], @@ -279,10 +266,7 @@ ] } }, - "required": [ - "id", - "method" - ], + "required": ["id", "method"], "x-docs-ignore": true }, "RequestId": { @@ -328,19 +312,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "path", - "content" - ], + "required": ["sessionId", "path", "content"], "x-side": "client", "x-method": "fs/write_text_file" }, @@ -366,38 +343,26 @@ }, "line": { "description": "Line number to start reading from (1-based).", - "type": [ - "integer", - "null" - ], + "type": ["integer", "null"], "format": "uint32", "minimum": 0, "x-deserialize-default-on-error": true }, "limit": { "description": "Maximum number of lines to read.", - "type": [ - "integer", - "null" - ], + "type": ["integer", "null"], "format": "uint32", "minimum": 0, "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "path" - ], + "required": ["sessionId", "path"], "x-side": "client", "x-method": "fs/read_text_file" }, @@ -432,19 +397,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "toolCall", - "options" - ], + "required": ["sessionId", "toolCall", "options"], "x-side": "client", "x-method": "session/request_permission" }, @@ -486,18 +444,12 @@ }, "title": { "description": "Update the human-readable title.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "content": { "description": "Replace the content collection.", - "type": [ - "array", - "null" - ], + "type": ["array", "null"], "items": { "$ref": "#/$defs/ToolCallContent" }, @@ -506,10 +458,7 @@ }, "locations": { "description": "Replace the locations collection.", - "type": [ - "array", - "null" - ], + "type": ["array", "null"], "items": { "$ref": "#/$defs/ToolCallLocation" }, @@ -526,17 +475,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "toolCallId" - ] + "required": ["toolCallId"] }, "ToolCallId": { "description": "Unique identifier for a tool call within a session.", @@ -634,9 +578,7 @@ "const": "content" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/Content" @@ -652,9 +594,7 @@ "const": "diff" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/Diff" @@ -670,9 +610,7 @@ "const": "terminal" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/Terminal" @@ -696,9 +634,7 @@ "const": "text" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/TextContent" @@ -714,9 +650,7 @@ "const": "image" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/ImageContent" @@ -732,9 +666,7 @@ "const": "audio" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/AudioContent" @@ -750,9 +682,7 @@ "const": "resource_link" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/ResourceLink" @@ -768,9 +698,7 @@ "const": "resource" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/EmbeddedResource" @@ -788,10 +716,7 @@ "properties": { "audience": { "description": "Intended recipients for this content, such as the user or assistant.", - "type": [ - "array", - "null" - ], + "type": ["array", "null"], "items": { "$ref": "#/$defs/Role" }, @@ -800,27 +725,18 @@ }, "lastModified": { "description": "Timestamp indicating when the underlying resource was last modified.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "priority": { "description": "Relative importance of this content when clients choose what to surface.", - "type": [ - "number", - "null" - ], + "type": ["number", "null"], "format": "double", "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -863,17 +779,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "text" - ] + "required": ["text"] }, "ImageContent": { "description": "An image provided to or from an LLM.", @@ -901,26 +812,17 @@ }, "uri": { "description": "URI associated with this resource or media payload.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "data", - "mimeType" - ] + "required": ["data", "mimeType"] }, "AudioContent": { "description": "Audio provided to or from an LLM.", @@ -948,18 +850,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "data", - "mimeType" - ] + "required": ["data", "mimeType"] }, "ResourceLink": { "description": "A resource that the server is capable of reading, included in a prompt or tool call result.", @@ -979,18 +875,12 @@ }, "description": { "description": "Optional human-readable details shown with this protocol object.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "mimeType": { "description": "MIME type describing the encoded media payload.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "name": { @@ -999,19 +889,13 @@ }, "size": { "description": "Optional size of the linked resource in bytes, if known.", - "type": [ - "integer", - "null" - ], + "type": ["integer", "null"], "format": "int64", "x-deserialize-default-on-error": true }, "title": { "description": "Optional display title for end-user UI.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "uri": { @@ -1020,18 +904,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "name", - "uri" - ] + "required": ["name", "uri"] }, "EmbeddedResourceResource": { "description": "Resource content that can be embedded in a message.", @@ -1062,10 +940,7 @@ "properties": { "mimeType": { "description": "MIME type describing the encoded media payload.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "text": { @@ -1078,18 +953,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "text", - "uri" - ] + "required": ["text", "uri"] }, "BlobResourceContents": { "description": "Binary resource contents.", @@ -1101,10 +970,7 @@ }, "mimeType": { "description": "MIME type describing the encoded media payload.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "uri": { @@ -1113,18 +979,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "blob", - "uri" - ] + "required": ["blob", "uri"] }, "EmbeddedResource": { "description": "The contents of a resource, embedded into a prompt or tool call result.", @@ -1152,17 +1012,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "resource" - ] + "required": ["resource"] }, "Content": { "description": "Standard content block (text, images, resources).", @@ -1178,17 +1033,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "content" - ] + "required": ["content"] }, "Diff": { "description": "A diff representing file modifications.\n\nShows changes to files in a format suitable for display in the client UI.\n\nSee protocol docs: [Content](https://agentclientprotocol.com/protocol/tool-calls#content)", @@ -1200,10 +1050,7 @@ }, "oldText": { "description": "The original content (None for new files).", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "newText": { @@ -1212,18 +1059,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "path", - "newText" - ] + "required": ["path", "newText"] }, "TerminalId": { "description": "Typed identifier used for terminal values on the wire.", @@ -1243,17 +1084,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "terminalId" - ] + "required": ["terminalId"] }, "ToolCallLocation": { "description": "A file location being accessed or modified by a tool.\n\nEnables clients to implement \"follow-along\" features that track\nwhich files the agent is working with in real-time.\n\nSee protocol docs: [Following the Agent](https://agentclientprotocol.com/protocol/tool-calls#following-the-agent)", @@ -1265,27 +1101,19 @@ }, "line": { "description": "Optional line number within the file.", - "type": [ - "integer", - "null" - ], + "type": ["integer", "null"], "format": "uint32", "minimum": 0, "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "path" - ] + "required": ["path"] }, "PermissionOption": { "description": "An option presented to the user when requesting permission.", @@ -1313,19 +1141,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "optionId", - "name", - "kind" - ] + "required": ["optionId", "name", "kind"] }, "PermissionOptionId": { "description": "Unique identifier for a permission option.", @@ -1392,36 +1213,24 @@ }, "cwd": { "description": "Working directory for the command (absolute path).", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "outputByteLimit": { "description": "Maximum number of output bytes to retain.\n\nWhen the limit is exceeded, the Client truncates from the beginning of the output\nto stay within the limit.\n\nThe Client MUST ensure truncation happens at a character boundary to maintain valid\nstring output, even if this means the retained output is slightly less than the\nspecified limit.", - "type": [ - "integer", - "null" - ], + "type": ["integer", "null"], "format": "uint64", "minimum": 0, "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "command" - ], + "required": ["sessionId", "command"], "x-side": "client", "x-method": "terminal/create" }, @@ -1439,18 +1248,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "name", - "value" - ] + "required": ["name", "value"] }, "TerminalOutputRequest": { "description": "Request to get the current output and status of a terminal.", @@ -1474,18 +1277,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "terminalId" - ], + "required": ["sessionId", "terminalId"], "x-side": "client", "x-method": "terminal/output" }, @@ -1511,18 +1308,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "terminalId" - ], + "required": ["sessionId", "terminalId"], "x-side": "client", "x-method": "terminal/release" }, @@ -1548,18 +1339,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "terminalId" - ], + "required": ["sessionId", "terminalId"], "x-side": "client", "x-method": "terminal/wait_for_exit" }, @@ -1585,18 +1370,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "terminalId" - ], + "required": ["sessionId", "terminalId"], "x-side": "client", "x-method": "terminal/kill" }, @@ -1610,10 +1389,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1628,9 +1404,7 @@ "const": "form" } }, - "required": [ - "mode" - ], + "required": ["mode"], "allOf": [ { "$ref": "#/$defs/ElicitationFormMode" @@ -1646,9 +1420,7 @@ "const": "url" } }, - "required": [ - "mode" - ], + "required": ["mode"], "allOf": [ { "$ref": "#/$defs/ElicitationUrlMode" @@ -1659,9 +1431,7 @@ "discriminator": { "propertyName": "mode" }, - "required": [ - "message" - ], + "required": ["message"], "x-side": "client", "x-method": "elicitation/create" }, @@ -1690,9 +1460,7 @@ "x-deserialize-default-on-error": true } }, - "required": [ - "sessionId" - ] + "required": ["sessionId"] }, "ElicitationRequestScope": { "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nRequest-scoped elicitation, tied to a specific JSON-RPC request outside of a session\n(e.g., during auth/configuration phases before any session is started).", @@ -1707,9 +1475,7 @@ ] } }, - "required": [ - "requestId" - ] + "required": ["requestId"] }, "ElicitationSchema": { "description": "Type-safe elicitation schema for requesting structured user input.\n\nThis represents a JSON Schema object with primitive-typed properties,\nas required by the elicitation specification.", @@ -1727,10 +1493,7 @@ }, "title": { "description": "Optional title for the schema.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "properties": { @@ -1744,10 +1507,7 @@ }, "required": { "description": "List of required property names.", - "type": [ - "array", - "null" - ], + "type": ["array", "null"], "items": { "type": "string" }, @@ -1756,18 +1516,12 @@ }, "description": { "description": "Optional description of what this schema represents.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1795,9 +1549,7 @@ "const": "string" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/StringPropertySchema" @@ -1813,9 +1565,7 @@ "const": "number" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/NumberPropertySchema" @@ -1831,9 +1581,7 @@ "const": "integer" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/IntegerPropertySchema" @@ -1849,9 +1597,7 @@ "const": "boolean" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/BooleanPropertySchema" @@ -1867,9 +1613,7 @@ "const": "array" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/MultiSelectPropertySchema" @@ -1920,18 +1664,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "const", - "title" - ] + "required": ["const", "title"] }, "StringPropertySchema": { "description": "Schema for string properties in an elicitation form.\n\nWhen `enum` or `oneOf` is set, this represents a single-select enum\nwith `\"type\": \"string\"`.", @@ -1939,46 +1677,31 @@ "properties": { "title": { "description": "Optional title for the property.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "description": { "description": "Human-readable description.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "minLength": { "description": "Minimum string length.", - "type": [ - "integer", - "null" - ], + "type": ["integer", "null"], "format": "uint32", "minimum": 0, "x-deserialize-default-on-error": true }, "maxLength": { "description": "Maximum string length.", - "type": [ - "integer", - "null" - ], + "type": ["integer", "null"], "format": "uint32", "minimum": 0, "x-deserialize-default-on-error": true }, "pattern": { "description": "Pattern the string must match.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "format": { @@ -1995,18 +1718,12 @@ }, "default": { "description": "Default value.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "enum": { "description": "Enum values for untitled single-select enums.", - "type": [ - "array", - "null" - ], + "type": ["array", "null"], "items": { "type": "string" }, @@ -2015,10 +1732,7 @@ }, "oneOf": { "description": "Titled enum options for titled single-select enums.", - "type": [ - "array", - "null" - ], + "type": ["array", "null"], "items": { "$ref": "#/$defs/EnumOption" }, @@ -2027,10 +1741,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2042,53 +1753,35 @@ "properties": { "title": { "description": "Optional title for the property.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "description": { "description": "Human-readable description.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "minimum": { "description": "Minimum value (inclusive).", - "type": [ - "number", - "null" - ], + "type": ["number", "null"], "format": "double", "x-deserialize-default-on-error": true }, "maximum": { "description": "Maximum value (inclusive).", - "type": [ - "number", - "null" - ], + "type": ["number", "null"], "format": "double", "x-deserialize-default-on-error": true }, "default": { "description": "Default value.", - "type": [ - "number", - "null" - ], + "type": ["number", "null"], "format": "double", "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2100,53 +1793,35 @@ "properties": { "title": { "description": "Optional title for the property.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "description": { "description": "Human-readable description.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "minimum": { "description": "Minimum value (inclusive).", - "type": [ - "integer", - "null" - ], + "type": ["integer", "null"], "format": "int64", "x-deserialize-default-on-error": true }, "maximum": { "description": "Maximum value (inclusive).", - "type": [ - "integer", - "null" - ], + "type": ["integer", "null"], "format": "int64", "x-deserialize-default-on-error": true }, "default": { "description": "Default value.", - "type": [ - "integer", - "null" - ], + "type": ["integer", "null"], "format": "int64", "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2158,34 +1833,22 @@ "properties": { "title": { "description": "Optional title for the property.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "description": { "description": "Human-readable description.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "default": { "description": "Default value.", - "type": [ - "boolean", - "null" - ], + "type": ["boolean", "null"], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2237,18 +1900,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "type", - "enum" - ] + "required": ["type", "enum"] }, "ElicitationStringType": { "description": "Items definition for untitled multi-select enum properties.", @@ -2275,17 +1932,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "anyOf" - ] + "required": ["anyOf"] }, "MultiSelectPropertySchema": { "description": "Schema for multi-select (array) properties in an elicitation form.", @@ -2293,36 +1945,24 @@ "properties": { "title": { "description": "Optional title for the property.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "description": { "description": "Human-readable description.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "minItems": { "description": "Minimum number of items to select.", - "type": [ - "integer", - "null" - ], + "type": ["integer", "null"], "format": "uint64", "minimum": 0, "x-deserialize-default-on-error": true }, "maxItems": { "description": "Maximum number of items to select.", - "type": [ - "integer", - "null" - ], + "type": ["integer", "null"], "format": "uint64", "minimum": 0, "x-deserialize-default-on-error": true @@ -2337,10 +1977,7 @@ }, "default": { "description": "Default selected values.", - "type": [ - "array", - "null" - ], + "type": ["array", "null"], "items": { "type": "string" }, @@ -2349,17 +1986,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "items" - ] + "required": ["items"] }, "ElicitationFormMode": { "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nForm-based elicitation mode where the client renders a form from the provided schema.", @@ -2394,9 +2026,7 @@ ] } ], - "required": [ - "requestedSchema" - ] + "required": ["requestedSchema"] }, "ElicitationId": { "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nUnique identifier for an elicitation.", @@ -2440,10 +2070,7 @@ ] } ], - "required": [ - "elicitationId", - "url" - ] + "required": ["elicitationId", "url"] }, "ConnectMcpRequest": { "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nRequest parameters for `mcp/connect`.", @@ -2459,17 +2086,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "acpId" - ], + "required": ["acpId"], "x-side": "client", "x-method": "mcp/connect" }, @@ -2495,27 +2117,18 @@ }, "params": { "description": "Optional inner MCP params.\n\nIf omitted or set to `null`, the inner MCP message has no params.", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "connectionId", - "method" - ], + "required": ["connectionId", "method"], "x-side": "both", "x-method": "mcp/message" }, @@ -2537,17 +2150,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "connectionId" - ], + "required": ["connectionId"], "x-side": "client", "x-method": "mcp/disconnect" }, @@ -2765,10 +2373,7 @@ ] } }, - "required": [ - "id", - "result" - ] + "required": ["id", "result"] }, { "title": "Error", @@ -2792,10 +2397,7 @@ ] } }, - "required": [ - "id", - "error" - ] + "required": ["id", "error"] } ], "x-docs-ignore": true @@ -2860,17 +2462,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "protocolVersion" - ], + "required": ["protocolVersion"], "x-side": "agent", "x-method": "initialize" }, @@ -2977,10 +2574,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3010,10 +2604,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3043,10 +2634,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3130,10 +2718,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3145,10 +2730,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3160,10 +2742,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3175,10 +2754,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3190,10 +2766,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3205,10 +2778,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3220,10 +2790,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3247,10 +2814,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3262,10 +2826,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3277,10 +2838,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3316,10 +2874,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3343,10 +2898,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3418,10 +2970,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3433,10 +2982,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3456,17 +3002,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "syncKind" - ] + "required": ["syncKind"] }, "TextDocumentSyncKind": { "description": "How the agent wants document changes delivered.", @@ -3489,10 +3030,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3504,10 +3042,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3519,10 +3054,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3606,10 +3138,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3621,20 +3150,14 @@ "properties": { "maxCount": { "description": "Maximum number of recent files the agent can use.", - "type": [ - "integer", - "null" - ], + "type": ["integer", "null"], "format": "uint32", "minimum": 0, "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3646,10 +3169,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3661,20 +3181,14 @@ "properties": { "maxCount": { "description": "Maximum number of edit history entries the agent can use.", - "type": [ - "integer", - "null" - ], + "type": ["integer", "null"], "format": "uint32", "minimum": 0, "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3686,20 +3200,14 @@ "properties": { "maxCount": { "description": "Maximum number of user actions the agent can use.", - "type": [ - "integer", - "null" - ], + "type": ["integer", "null"], "format": "uint32", "minimum": 0, "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3711,10 +3219,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3726,10 +3231,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3767,9 +3269,7 @@ "const": "env_var" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/AuthMethodEnvVar" @@ -3785,9 +3285,7 @@ "const": "terminal" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/AuthMethodTerminal" @@ -3819,10 +3317,7 @@ }, "label": { "description": "Human-readable label for this variable, displayed in client UI.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "secret": { @@ -3839,17 +3334,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "name" - ] + "required": ["name"] }, "AuthMethodEnvVar": { "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nEnvironment variable authentication method.\n\nThe user provides credentials that the client passes to the agent as environment variables.", @@ -3869,10 +3359,7 @@ }, "description": { "description": "Optional description providing more details about this authentication method.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "vars": { @@ -3886,27 +3373,17 @@ }, "link": { "description": "Optional link to a page where the user can obtain their credentials.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "id", - "name", - "vars" - ] + "required": ["id", "name", "vars"] }, "AuthMethodTerminal": { "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nTerminal-based authentication method.\n\nThe client runs an interactive terminal for the user to authenticate via a TUI.", @@ -3926,10 +3403,7 @@ }, "description": { "description": "Optional description providing more details about this authentication method.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "args": { @@ -3951,18 +3425,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "id", - "name" - ] + "required": ["id", "name"] }, "AuthMethodAgent": { "description": "Agent handles authentication itself.\n\nThis is the default authentication method type.", @@ -3982,26 +3450,17 @@ }, "description": { "description": "Optional description providing more details about this authentication method.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "id", - "name" - ] + "required": ["id", "name"] }, "Implementation": { "description": "Metadata about the implementation of the client or agent.\nDescribes the name and version of an ACP implementation, with an optional\ntitle for UI representation.", @@ -4013,10 +3472,7 @@ }, "title": { "description": "Intended for UI and end-user contexts — optimized to be human-readable\nand easily understood.\n\nIf not provided, the name should be used for display.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "version": { @@ -4025,18 +3481,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "name", - "version" - ] + "required": ["name", "version"] }, "AuthenticateResponse": { "description": "Response to the `authenticate` method.", @@ -4044,10 +3494,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -4070,17 +3517,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "providers" - ], + "required": ["providers"], "x-side": "agent", "x-method": "providers/list" }, @@ -4119,19 +3561,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "id", - "supported", - "required" - ] + "required": ["id", "supported", "required"] }, "LlmProtocol": { "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nWell-known API protocol identifiers for LLM providers.\n\nAgents and clients MUST handle unknown protocol identifiers gracefully.\n\nProtocol names beginning with `_` are free for custom use, like other ACP extension methods.\nProtocol names that do not begin with `_` are reserved for the ACP spec.", @@ -4186,18 +3621,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "apiType", - "baseUrl" - ] + "required": ["apiType", "baseUrl"] }, "SetProviderResponse": { "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nResponse to `providers/set`.", @@ -4205,10 +3634,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -4222,10 +3648,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -4239,10 +3662,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -4276,10 +3696,7 @@ }, "configOptions": { "description": "Initial session configuration options if supported by the Agent.", - "type": [ - "array", - "null" - ], + "type": ["array", "null"], "items": { "$ref": "#/$defs/SessionConfigOption" }, @@ -4288,17 +3705,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId" - ], + "required": ["sessionId"], "x-side": "agent", "x-method": "session/new" }, @@ -4325,18 +3737,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "currentModeId", - "availableModes" - ] + "required": ["currentModeId", "availableModes"] }, "SessionModeId": { "description": "Unique identifier for a Session Mode.", @@ -4360,26 +3766,17 @@ }, "description": { "description": "Optional human-readable details shown with this protocol object.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "id", - "name" - ] + "required": ["id", "name"] }, "SessionConfigOption": { "description": "A session configuration option selector and its current state.", @@ -4399,10 +3796,7 @@ }, "description": { "description": "Optional description for the Client to display to the user.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "category": { @@ -4419,18 +3813,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "id", - "name" - ], + "required": ["id", "name"], "oneOf": [ { "description": "Single-value selector (dropdown).", @@ -4441,9 +3829,7 @@ "const": "select" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/SessionConfigSelect" @@ -4459,9 +3845,7 @@ "const": "boolean" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/SessionConfigBoolean" @@ -4550,26 +3934,17 @@ }, "description": { "description": "Optional description for this option value.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "value", - "name" - ] + "required": ["value", "name"] }, "SessionConfigSelectGroup": { "description": "A group of possible values for a session configuration option.", @@ -4598,19 +3973,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "group", - "name", - "options" - ] + "required": ["group", "name", "options"] }, "SessionConfigGroupId": { "description": "Unique identifier for a session configuration option value group.", @@ -4637,10 +4005,7 @@ ] } }, - "required": [ - "currentValue", - "options" - ] + "required": ["currentValue", "options"] }, "SessionConfigBoolean": { "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nA boolean on/off toggle session configuration option payload.", @@ -4651,9 +4016,7 @@ "type": "boolean" } }, - "required": [ - "currentValue" - ] + "required": ["currentValue"] }, "LoadSessionResponse": { "description": "Response from loading an existing session.", @@ -4673,10 +4036,7 @@ }, "configOptions": { "description": "Initial session configuration options if supported by the Agent.", - "type": [ - "array", - "null" - ], + "type": ["array", "null"], "items": { "$ref": "#/$defs/SessionConfigOption" }, @@ -4685,10 +4045,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -4711,25 +4068,17 @@ }, "nextCursor": { "description": "Opaque cursor token. If present, pass this in the next request's cursor parameter\nto fetch the next page. If absent, there are no more results.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessions" - ], + "required": ["sessions"], "x-side": "agent", "x-method": "session/list" }, @@ -4760,34 +4109,22 @@ }, "title": { "description": "Human-readable title for the session", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "updatedAt": { "description": "ISO 8601 timestamp of last activity", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "cwd" - ] + "required": ["sessionId", "cwd"] }, "DeleteSessionResponse": { "description": "Response from deleting a session.", @@ -4795,10 +4132,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -4832,10 +4166,7 @@ }, "configOptions": { "description": "Initial session configuration options if supported by the Agent.", - "type": [ - "array", - "null" - ], + "type": ["array", "null"], "items": { "$ref": "#/$defs/SessionConfigOption" }, @@ -4844,17 +4175,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId" - ], + "required": ["sessionId"], "x-side": "agent", "x-method": "session/fork" }, @@ -4876,10 +4202,7 @@ }, "configOptions": { "description": "Initial session configuration options if supported by the Agent.", - "type": [ - "array", - "null" - ], + "type": ["array", "null"], "items": { "$ref": "#/$defs/SessionConfigOption" }, @@ -4888,10 +4211,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -4905,10 +4225,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -4922,10 +4239,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -4948,17 +4262,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "configOptions" - ], + "required": ["configOptions"], "x-side": "agent", "x-method": "session/set_config_option" }, @@ -4988,17 +4297,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "stopReason" - ], + "required": ["stopReason"], "x-side": "agent", "x-method": "session/prompt" }, @@ -5056,49 +4360,33 @@ }, "thoughtTokens": { "description": "Total thought/reasoning tokens", - "type": [ - "integer", - "null" - ], + "type": ["integer", "null"], "format": "uint64", "minimum": 0, "x-deserialize-default-on-error": true }, "cachedReadTokens": { "description": "Total cache read tokens.", - "type": [ - "integer", - "null" - ], + "type": ["integer", "null"], "format": "uint64", "minimum": 0, "x-deserialize-default-on-error": true }, "cachedWriteTokens": { "description": "Total cache write tokens.", - "type": [ - "integer", - "null" - ], + "type": ["integer", "null"], "format": "uint64", "minimum": 0, "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "totalTokens", - "inputTokens", - "outputTokens" - ] + "required": ["totalTokens", "inputTokens", "outputTokens"] }, "StartNesResponse": { "description": "Response to `nes/start`.", @@ -5114,17 +4402,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId" - ], + "required": ["sessionId"], "x-side": "agent", "x-method": "nes/start" }, @@ -5143,17 +4426,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "suggestions" - ], + "required": ["suggestions"], "x-side": "agent", "x-method": "nes/suggest" }, @@ -5169,9 +4447,7 @@ "const": "edit" } }, - "required": [ - "kind" - ], + "required": ["kind"], "allOf": [ { "$ref": "#/$defs/NesEditSuggestion" @@ -5187,9 +4463,7 @@ "const": "jump" } }, - "required": [ - "kind" - ], + "required": ["kind"], "allOf": [ { "$ref": "#/$defs/NesJumpSuggestion" @@ -5205,9 +4479,7 @@ "const": "rename" } }, - "required": [ - "kind" - ], + "required": ["kind"], "allOf": [ { "$ref": "#/$defs/NesRenameSuggestion" @@ -5223,9 +4495,7 @@ "const": "searchAndReplace" } }, - "required": [ - "kind" - ], + "required": ["kind"], "allOf": [ { "$ref": "#/$defs/NesSearchAndReplaceSuggestion" @@ -5255,18 +4525,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "range", - "newText" - ] + "required": ["range", "newText"] }, "Range": { "description": "A range in a text document, expressed as start and end positions.", @@ -5290,18 +4554,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "start", - "end" - ] + "required": ["start", "end"] }, "Position": { "description": "A zero-based position in a text document.\n\nThe meaning of `character` depends on the negotiated position encoding.", @@ -5321,18 +4579,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "line", - "character" - ] + "required": ["line", "character"] }, "NesEditSuggestion": { "description": "A text edit suggestion.", @@ -5369,19 +4621,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "id", - "uri", - "edits" - ] + "required": ["id", "uri", "edits"] }, "NesJumpSuggestion": { "description": "A jump-to-location suggestion.", @@ -5405,19 +4650,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "id", - "uri", - "position" - ] + "required": ["id", "uri", "position"] }, "NesRenameSuggestion": { "description": "A rename symbol suggestion.", @@ -5445,20 +4683,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "id", - "uri", - "position", - "newName" - ] + "required": ["id", "uri", "position", "newName"] }, "NesSearchAndReplaceSuggestion": { "description": "A search-and-replace suggestion.", @@ -5482,28 +4712,17 @@ }, "isRegex": { "description": "Whether `search` is a regular expression. Defaults to `false`.", - "type": [ - "boolean", - "null" - ], + "type": ["boolean", "null"], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "id", - "uri", - "search", - "replace" - ] + "required": ["id", "uri", "search", "replace"] }, "CloseNesResponse": { "description": "Response from closing an NES session.", @@ -5511,10 +4730,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -5551,10 +4767,7 @@ "x-deserialize-default-on-error": true } }, - "required": [ - "code", - "message" - ] + "required": ["code", "message"] }, "ErrorCode": { "description": "Predefined error codes for common JSON-RPC and ACP-specific errors.\n\nThese codes follow the JSON-RPC 2.0 specification for standard errors\nand use the reserved range (-32000 to -32099) for protocol-specific errors.", @@ -5688,9 +4901,7 @@ ] } }, - "required": [ - "method" - ], + "required": ["method"], "x-docs-ignore": true }, "SessionNotification": { @@ -5715,18 +4926,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "update" - ], + "required": ["sessionId", "update"], "x-side": "client", "x-method": "session/update" }, @@ -5742,9 +4947,7 @@ "const": "user_message_chunk" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/ContentChunk" @@ -5760,9 +4963,7 @@ "const": "agent_message_chunk" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/ContentChunk" @@ -5778,9 +4979,7 @@ "const": "agent_thought_chunk" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/ContentChunk" @@ -5796,9 +4995,7 @@ "const": "tool_call" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/ToolCall" @@ -5814,9 +5011,7 @@ "const": "tool_call_update" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/ToolCallUpdate" @@ -5832,9 +5027,7 @@ "const": "plan" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/Plan" @@ -5850,9 +5043,7 @@ "const": "plan_update" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/PlanUpdate" @@ -5868,9 +5059,7 @@ "const": "plan_removed" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/PlanRemoved" @@ -5886,9 +5075,7 @@ "const": "available_commands_update" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/AvailableCommandsUpdate" @@ -5904,9 +5091,7 @@ "const": "current_mode_update" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/CurrentModeUpdate" @@ -5922,9 +5107,7 @@ "const": "config_option_update" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/ConfigOptionUpdate" @@ -5940,9 +5123,7 @@ "const": "session_info_update" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/SessionInfoUpdate" @@ -5958,9 +5139,7 @@ "const": "usage_update" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/UsageUpdate" @@ -6002,17 +5181,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "content" - ] + "required": ["content"] }, "ToolCall": { "description": "Represents a tool call that the language model has requested.\n\nTool calls are actions that the agent executes on behalf of the language model,\nsuch as reading files, executing code, or fetching data from external sources.\n\nSee protocol docs: [Tool Calls](https://agentclientprotocol.com/protocol/tool-calls)", @@ -6076,18 +5250,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "toolCallId", - "title" - ] + "required": ["toolCallId", "title"] }, "PlanEntry": { "description": "A single entry in the execution plan.\n\nRepresents a task or goal that the assistant intends to accomplish\nas part of fulfilling the user's request.\nSee protocol docs: [Plan Entries](https://agentclientprotocol.com/protocol/agent-plan#plan-entries)", @@ -6115,19 +5283,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "content", - "priority", - "status" - ] + "required": ["content", "priority", "status"] }, "PlanEntryPriority": { "description": "Priority levels for plan entries.\n\nUsed to indicate the relative importance or urgency of different\ntasks in the execution plan.\nSee protocol docs: [Plan Entries](https://agentclientprotocol.com/protocol/agent-plan#plan-entries)", @@ -6184,17 +5345,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "entries" - ] + "required": ["entries"] }, "PlanUpdateContent": { "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nUpdated content for a plan.", @@ -6208,9 +5364,7 @@ "const": "items" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/PlanItems" @@ -6226,9 +5380,7 @@ "const": "file" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/PlanFile" @@ -6244,9 +5396,7 @@ "const": "markdown" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/PlanMarkdown" @@ -6285,18 +5435,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "id", - "entries" - ] + "required": ["id", "entries"] }, "PlanFile": { "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nA plan represented by a file URI.", @@ -6316,18 +5460,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "id", - "uri" - ] + "required": ["id", "uri"] }, "PlanMarkdown": { "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nA plan represented as raw markdown content.", @@ -6347,18 +5485,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "id", - "content" - ] + "required": ["id", "content"] }, "PlanUpdate": { "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nA content update for a plan identified by ID.", @@ -6374,17 +5506,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "plan" - ] + "required": ["plan"] }, "PlanRemoved": { "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nRemoval notice for a plan identified by ID.", @@ -6400,17 +5527,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "id" - ] + "required": ["id"] }, "AvailableCommand": { "description": "Information about a command.", @@ -6438,18 +5560,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "name", - "description" - ] + "required": ["name", "description"] }, "AvailableCommandInput": { "description": "The input specification for a command.", @@ -6475,17 +5591,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "hint" - ] + "required": ["hint"] }, "AvailableCommandsUpdate": { "description": "Available commands are ready or have changed", @@ -6502,17 +5613,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "availableCommands" - ] + "required": ["availableCommands"] }, "CurrentModeUpdate": { "description": "The current mode of the session has changed\n\nSee protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/session-modes)", @@ -6528,17 +5634,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "currentModeId" - ] + "required": ["currentModeId"] }, "ConfigOptionUpdate": { "description": "Session configuration options have been updated.", @@ -6555,17 +5656,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "configOptions" - ] + "required": ["configOptions"] }, "SessionInfoUpdate": { "description": "Update to session metadata. All fields are optional to support partial updates.\n\nAgents send this notification to update session information like title or custom metadata.\nThis allows clients to display dynamic session names and track session state changes.", @@ -6573,26 +5669,17 @@ "properties": { "title": { "description": "Human-readable title for the session. Set to null to clear.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "updatedAt": { "description": "ISO 8601 timestamp of last activity. Set to null to clear.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -6613,18 +5700,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "amount", - "currency" - ] + "required": ["amount", "currency"] }, "UsageUpdate": { "description": "Context window and cost update for a session.", @@ -6656,18 +5737,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "used", - "size" - ] + "required": ["used", "size"] }, "CompleteElicitationNotification": { "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nNotification sent by the agent when a URL-based elicitation is complete.", @@ -6683,17 +5758,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "elicitationId" - ], + "required": ["elicitationId"], "x-side": "client", "x-method": "elicitation/complete" }, @@ -6715,27 +5785,18 @@ }, "params": { "description": "Optional inner MCP params.\n\nIf omitted or set to `null`, the inner MCP message has no params.", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "connectionId", - "method" - ], + "required": ["connectionId", "method"], "x-side": "both", "x-method": "mcp/message" }, @@ -6961,10 +6022,7 @@ ] } }, - "required": [ - "id", - "method" - ], + "required": ["id", "method"], "x-docs-ignore": true }, "InitializeRequest": { @@ -7012,17 +6070,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "protocolVersion" - ], + "required": ["protocolVersion"], "x-side": "agent", "x-method": "initialize" }, @@ -7120,10 +6173,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -7147,10 +6197,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -7174,10 +6221,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -7201,10 +6245,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -7216,10 +6257,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -7231,10 +6269,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -7252,10 +6287,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -7291,10 +6323,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -7306,10 +6335,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -7321,10 +6347,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -7372,10 +6395,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -7387,10 +6407,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -7402,10 +6419,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -7417,10 +6431,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -7440,17 +6451,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "methodId" - ], + "required": ["methodId"], "x-side": "agent", "x-method": "authenticate" }, @@ -7460,10 +6466,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -7501,19 +6504,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "id", - "apiType", - "baseUrl" - ], + "required": ["id", "apiType", "baseUrl"], "x-side": "agent", "x-method": "providers/set" }, @@ -7527,17 +6523,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "id" - ], + "required": ["id"], "x-side": "agent", "x-method": "providers/disable" }, @@ -7547,10 +6538,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -7586,18 +6574,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "cwd", - "mcpServers" - ], + "required": ["cwd", "mcpServers"], "x-side": "agent", "x-method": "session/new" }, @@ -7613,9 +6595,7 @@ "const": "http" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/McpServerHttp" @@ -7631,9 +6611,7 @@ "const": "sse" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/McpServerSse" @@ -7649,9 +6627,7 @@ "const": "acp" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/McpServerAcp" @@ -7683,18 +6659,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "name", - "value" - ] + "required": ["name", "value"] }, "McpServerHttp": { "description": "HTTP transport configuration for MCP.", @@ -7719,19 +6689,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "name", - "url", - "headers" - ] + "required": ["name", "url", "headers"] }, "McpServerSse": { "description": "SSE transport configuration for MCP.", @@ -7756,19 +6719,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "name", - "url", - "headers" - ] + "required": ["name", "url", "headers"] }, "McpServerAcp": { "description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nACP transport configuration for MCP.\n\nThe MCP server is provided by an ACP component and communicates over the ACP channel\nusing `mcp/connect`, `mcp/message`, and `mcp/disconnect`.", @@ -7788,18 +6744,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "name", - "id" - ] + "required": ["name", "id"] }, "McpServerStdio": { "description": "Stdio transport configuration for MCP.", @@ -7833,20 +6783,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "name", - "command", - "args", - "env" - ] + "required": ["name", "command", "args", "env"] }, "LoadSessionRequest": { "description": "Request parameters for loading an existing session.\n\nOnly available if the Agent supports the `loadSession` capability.\n\nSee protocol docs: [Loading Sessions](https://agentclientprotocol.com/protocol/session-setup#loading-sessions)", @@ -7884,19 +6826,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "mcpServers", - "cwd", - "sessionId" - ], + "required": ["mcpServers", "cwd", "sessionId"], "x-side": "agent", "x-method": "session/load" }, @@ -7906,26 +6841,17 @@ "properties": { "cwd": { "description": "Filter sessions by working directory. Must be an absolute path.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "cursor": { "description": "Opaque cursor token from a previous response's nextCursor field for cursor-based pagination", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -7947,17 +6873,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId" - ], + "required": ["sessionId"], "x-side": "agent", "x-method": "session/delete" }, @@ -7997,18 +6918,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "cwd" - ], + "required": ["sessionId", "cwd"], "x-side": "agent", "x-method": "session/fork" }, @@ -8048,18 +6963,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "cwd" - ], + "required": ["sessionId", "cwd"], "x-side": "agent", "x-method": "session/resume" }, @@ -8077,17 +6986,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId" - ], + "required": ["sessionId"], "x-side": "agent", "x-method": "session/close" }, @@ -8113,18 +7017,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "modeId" - ], + "required": ["sessionId", "modeId"], "x-side": "agent", "x-method": "session/set_mode" }, @@ -8150,18 +7048,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "configId" - ], + "required": ["sessionId", "configId"], "anyOf": [ { "description": "A boolean value (`type: \"boolean\"`).", @@ -8176,10 +7068,7 @@ "const": "boolean" } }, - "required": [ - "type", - "value" - ] + "required": ["type", "value"] }, { "title": "value_id", @@ -8195,9 +7084,7 @@ ] } }, - "required": [ - "value" - ] + "required": ["value"] } ], "x-side": "agent", @@ -8226,18 +7113,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "prompt" - ], + "required": ["sessionId", "prompt"], "x-side": "agent", "x-method": "session/prompt" }, @@ -8247,18 +7128,12 @@ "properties": { "workspaceUri": { "description": "The root URI of the workspace.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "workspaceFolders": { "description": "The workspace folders.", - "type": [ - "array", - "null" - ], + "type": ["array", "null"], "items": { "$ref": "#/$defs/WorkspaceFolder" }, @@ -8279,10 +7154,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -8304,18 +7176,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "uri", - "name" - ] + "required": ["uri", "name"] }, "NesRepository": { "description": "Repository metadata for an NES session.", @@ -8335,19 +7201,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "name", - "owner", - "remoteUrl" - ] + "required": ["name", "owner", "remoteUrl"] }, "SuggestNesRequest": { "description": "Request for a code suggestion.", @@ -8412,21 +7271,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "uri", - "version", - "position", - "triggerKind" - ], + "required": ["sessionId", "uri", "version", "position", "triggerKind"], "x-side": "agent", "x-method": "nes/suggest" }, @@ -8456,10 +7306,7 @@ "properties": { "recentFiles": { "description": "Recently accessed files.", - "type": [ - "array", - "null" - ], + "type": ["array", "null"], "items": { "$ref": "#/$defs/NesRecentFile" }, @@ -8468,10 +7315,7 @@ }, "relatedSnippets": { "description": "Related code snippets.", - "type": [ - "array", - "null" - ], + "type": ["array", "null"], "items": { "$ref": "#/$defs/NesRelatedSnippet" }, @@ -8480,10 +7324,7 @@ }, "editHistory": { "description": "Recent edit history.", - "type": [ - "array", - "null" - ], + "type": ["array", "null"], "items": { "$ref": "#/$defs/NesEditHistoryEntry" }, @@ -8492,10 +7333,7 @@ }, "userActions": { "description": "Recent user actions (typing, navigation, etc.).", - "type": [ - "array", - "null" - ], + "type": ["array", "null"], "items": { "$ref": "#/$defs/NesUserAction" }, @@ -8504,10 +7342,7 @@ }, "openFiles": { "description": "Currently open files in the editor.", - "type": [ - "array", - "null" - ], + "type": ["array", "null"], "items": { "$ref": "#/$defs/NesOpenFile" }, @@ -8516,10 +7351,7 @@ }, "diagnostics": { "description": "Current diagnostics (errors, warnings).", - "type": [ - "array", - "null" - ], + "type": ["array", "null"], "items": { "$ref": "#/$defs/NesDiagnostic" }, @@ -8528,10 +7360,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -8555,19 +7384,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "uri", - "languageId", - "text" - ] + "required": ["uri", "languageId", "text"] }, "NesRelatedSnippet": { "description": "A related code snippet from a file.", @@ -8588,18 +7410,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "uri", - "excerpts" - ] + "required": ["uri", "excerpts"] }, "NesExcerpt": { "description": "A code excerpt from a file.", @@ -8623,19 +7439,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "startLine", - "endLine", - "text" - ] + "required": ["startLine", "endLine", "text"] }, "NesEditHistoryEntry": { "description": "An entry in the edit history.", @@ -8651,18 +7460,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "uri", - "diff" - ] + "required": ["uri", "diff"] }, "NesUserAction": { "description": "A user action (typing, cursor movement, etc.).", @@ -8692,20 +7495,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "action", - "uri", - "position", - "timestampMs" - ] + "required": ["action", "uri", "position", "timestampMs"] }, "NesOpenFile": { "description": "An open file in the editor.", @@ -8733,28 +7528,19 @@ }, "lastFocusedMs": { "description": "Timestamp in milliseconds since epoch of when the file was last focused.", - "type": [ - "integer", - "null" - ], + "type": ["integer", "null"], "format": "uint64", "minimum": 0, "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "uri", - "languageId" - ] + "required": ["uri", "languageId"] }, "NesDiagnostic": { "description": "A diagnostic (error, warning, etc.).", @@ -8786,20 +7572,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "uri", - "range", - "severity", - "message" - ] + "required": ["uri", "range", "severity", "message"] }, "NesDiagnosticSeverity": { "description": "Severity of a diagnostic.", @@ -8840,17 +7618,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId" - ], + "required": ["sessionId"], "x-side": "agent", "x-method": "nes/close" }, @@ -8993,10 +7766,7 @@ ] } }, - "required": [ - "id", - "result" - ] + "required": ["id", "result"] }, { "title": "Error", @@ -9020,10 +7790,7 @@ ] } }, - "required": [ - "id", - "error" - ] + "required": ["id", "error"] } ], "x-docs-ignore": true @@ -9034,10 +7801,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -9055,17 +7819,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "content" - ], + "required": ["content"], "x-side": "client", "x-method": "fs/read_text_file" }, @@ -9083,17 +7842,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "outcome" - ], + "required": ["outcome"], "x-side": "client", "x-method": "session/request_permission" }, @@ -9109,9 +7863,7 @@ "const": "cancelled" } }, - "required": [ - "outcome" - ] + "required": ["outcome"] }, { "description": "The user selected one of the provided options.", @@ -9122,9 +7874,7 @@ "const": "selected" } }, - "required": [ - "outcome" - ], + "required": ["outcome"], "allOf": [ { "$ref": "#/$defs/SelectedPermissionOutcome" @@ -9150,17 +7900,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "optionId" - ] + "required": ["optionId"] }, "CreateTerminalResponse": { "description": "Response containing the ID of the created terminal.", @@ -9176,17 +7921,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "terminalId" - ], + "required": ["terminalId"], "x-side": "client", "x-method": "terminal/create" }, @@ -9216,18 +7956,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "output", - "truncated" - ], + "required": ["output", "truncated"], "x-side": "client", "x-method": "terminal/output" }, @@ -9237,28 +7971,19 @@ "properties": { "exitCode": { "description": "The process exit code (may be null if terminated by signal).", - "type": [ - "integer", - "null" - ], + "type": ["integer", "null"], "format": "uint32", "minimum": 0, "x-deserialize-default-on-error": true }, "signal": { "description": "The signal that terminated the process (may be null if exited normally).", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -9270,10 +7995,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -9287,28 +8009,19 @@ "properties": { "exitCode": { "description": "The process exit code (may be null if terminated by signal).", - "type": [ - "integer", - "null" - ], + "type": ["integer", "null"], "format": "uint32", "minimum": 0, "x-deserialize-default-on-error": true }, "signal": { "description": "The signal that terminated the process (may be null if exited normally).", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -9322,10 +8035,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -9339,10 +8049,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -9357,9 +8064,7 @@ "const": "accept" } }, - "required": [ - "action" - ], + "required": ["action"], "allOf": [ { "$ref": "#/$defs/ElicitationAcceptAction" @@ -9375,9 +8080,7 @@ "const": "decline" } }, - "required": [ - "action" - ] + "required": ["action"] }, { "description": "The elicitation was cancelled.", @@ -9388,9 +8091,7 @@ "const": "cancel" } }, - "required": [ - "action" - ] + "required": ["action"] } ], "discriminator": { @@ -9440,10 +8141,7 @@ "properties": { "content": { "description": "The user-provided content, if any, as an object matching the requested schema.", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": { "$ref": "#/$defs/ElicitationContentValue" @@ -9465,17 +8163,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "connectionId" - ], + "required": ["connectionId"], "x-side": "client", "x-method": "mcp/connect" }, @@ -9485,10 +8178,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -9608,9 +8298,7 @@ ] } }, - "required": [ - "method" - ], + "required": ["method"], "x-docs-ignore": true }, "CancelNotification": { @@ -9627,17 +8315,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId" - ], + "required": ["sessionId"], "x-side": "agent", "x-method": "session/cancel" }, @@ -9672,21 +8355,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "uri", - "languageId", - "version", - "text" - ], + "required": ["sessionId", "uri", "languageId", "version", "text"], "x-side": "agent", "x-method": "document/didOpen" }, @@ -9722,20 +8396,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "uri", - "version", - "contentChanges" - ], + "required": ["sessionId", "uri", "version", "contentChanges"], "x-side": "agent", "x-method": "document/didChange" }, @@ -9761,17 +8427,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "text" - ] + "required": ["text"] }, "DidCloseDocumentNotification": { "description": "Notification sent when a file is closed.", @@ -9791,18 +8452,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "uri" - ], + "required": ["sessionId", "uri"], "x-side": "agent", "x-method": "document/didClose" }, @@ -9824,18 +8479,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "uri" - ], + "required": ["sessionId", "uri"], "x-side": "agent", "x-method": "document/didSave" }, @@ -9878,21 +8527,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "uri", - "version", - "position", - "visibleRange" - ], + "required": ["sessionId", "uri", "version", "position", "visibleRange"], "x-side": "agent", "x-method": "document/didFocus" }, @@ -9914,18 +8554,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "id" - ], + "required": ["sessionId", "id"], "x-side": "agent", "x-method": "nes/accept" }, @@ -9959,18 +8593,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "id" - ], + "required": ["sessionId", "id"], "x-side": "agent", "x-method": "nes/reject" }, @@ -10013,19 +8641,14 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "requestId" - ], + "required": ["requestId"], "x-side": "protocol", "x-method": "$/cancel_request" } } -} \ No newline at end of file +} diff --git a/schema/v2/meta.json b/schema/v2/meta.json index 24d94da14..e1ecdb25a 100644 --- a/schema/v2/meta.json +++ b/schema/v2/meta.json @@ -18,4 +18,4 @@ "session_request_permission": "session/request_permission", "session_update": "session/update" } -} \ No newline at end of file +} diff --git a/schema/v2/schema.json b/schema/v2/schema.json index fc7b02028..ede20c7b6 100644 --- a/schema/v2/schema.json +++ b/schema/v2/schema.json @@ -9,14 +9,10 @@ "properties": { "jsonrpc": { "type": "string", - "enum": [ - "2.0" - ] + "enum": ["2.0"] } }, - "required": [ - "jsonrpc" - ], + "required": ["jsonrpc"], "anyOf": [ { "title": "Request", @@ -51,14 +47,10 @@ "properties": { "jsonrpc": { "type": "string", - "enum": [ - "2.0" - ] + "enum": ["2.0"] } }, - "required": [ - "jsonrpc" - ], + "required": ["jsonrpc"], "anyOf": [ { "title": "Request", @@ -96,14 +88,10 @@ "properties": { "jsonrpc": { "type": "string", - "enum": [ - "2.0" - ] + "enum": ["2.0"] } }, - "required": [ - "jsonrpc" - ], + "required": ["jsonrpc"], "anyOf": [ { "title": "Request", @@ -135,14 +123,10 @@ "properties": { "jsonrpc": { "type": "string", - "enum": [ - "2.0" - ] + "enum": ["2.0"] } }, - "required": [ - "jsonrpc" - ], + "required": ["jsonrpc"], "anyOf": [ { "title": "Result", @@ -271,10 +255,7 @@ ] } }, - "required": [ - "id", - "result" - ] + "required": ["id", "result"] }, { "title": "Error", @@ -298,10 +279,7 @@ ] } }, - "required": [ - "id", - "error" - ] + "required": ["id", "error"] } ], "x-docs-ignore": true @@ -318,14 +296,10 @@ "properties": { "jsonrpc": { "type": "string", - "enum": [ - "2.0" - ] + "enum": ["2.0"] } }, - "required": [ - "jsonrpc" - ], + "required": ["jsonrpc"], "anyOf": [ { "title": "Request", @@ -357,14 +331,10 @@ "properties": { "jsonrpc": { "type": "string", - "enum": [ - "2.0" - ] + "enum": ["2.0"] } }, - "required": [ - "jsonrpc" - ], + "required": ["jsonrpc"], "anyOf": [ { "title": "Result", @@ -403,10 +373,7 @@ ] } }, - "required": [ - "id", - "result" - ] + "required": ["id", "result"] }, { "title": "Error", @@ -430,10 +397,7 @@ ] } }, - "required": [ - "id", - "error" - ] + "required": ["id", "error"] } ], "x-docs-ignore": true @@ -490,10 +454,7 @@ ] } }, - "required": [ - "id", - "method" - ], + "required": ["id", "method"], "x-docs-ignore": true }, "RequestId": { @@ -548,19 +509,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "toolCall", - "options" - ], + "required": ["sessionId", "toolCall", "options"], "x-side": "client", "x-method": "session/request_permission" }, @@ -582,10 +536,7 @@ }, "title": { "description": "Human-readable title describing what the tool is doing.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "kind": { @@ -614,10 +565,7 @@ }, "content": { "description": "Content produced by the tool call.", - "type": [ - "array", - "null" - ], + "type": ["array", "null"], "items": { "$ref": "#/$defs/ToolCallContent" }, @@ -626,10 +574,7 @@ }, "locations": { "description": "File locations affected by this tool call.\nEnables \"follow-along\" features in clients.", - "type": [ - "array", - "null" - ], + "type": ["array", "null"], "items": { "$ref": "#/$defs/ToolCallLocation" }, @@ -646,17 +591,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "toolCallId" - ] + "required": ["toolCallId"] }, "ToolCallId": { "description": "Unique identifier for a tool call within a session.", @@ -764,9 +704,7 @@ "const": "content" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/Content" @@ -782,9 +720,7 @@ "const": "diff" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/Diff" @@ -801,9 +737,7 @@ "type": "string" } }, - "required": [ - "type" - ], + "required": ["type"], "not": { "anyOf": [ { @@ -814,9 +748,7 @@ "const": "content" } }, - "required": [ - "type" - ] + "required": ["type"] }, { "type": "object", @@ -826,9 +758,7 @@ "const": "diff" } }, - "required": [ - "type" - ] + "required": ["type"] } ] }, @@ -851,9 +781,7 @@ "const": "text" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/TextContent" @@ -869,9 +797,7 @@ "const": "image" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/ImageContent" @@ -887,9 +813,7 @@ "const": "audio" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/AudioContent" @@ -905,9 +829,7 @@ "const": "resource_link" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/ResourceLink" @@ -923,9 +845,7 @@ "const": "resource" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/EmbeddedResource" @@ -942,9 +862,7 @@ "type": "string" } }, - "required": [ - "type" - ], + "required": ["type"], "not": { "anyOf": [ { @@ -955,9 +873,7 @@ "const": "text" } }, - "required": [ - "type" - ] + "required": ["type"] }, { "type": "object", @@ -967,9 +883,7 @@ "const": "image" } }, - "required": [ - "type" - ] + "required": ["type"] }, { "type": "object", @@ -979,9 +893,7 @@ "const": "audio" } }, - "required": [ - "type" - ] + "required": ["type"] }, { "type": "object", @@ -991,9 +903,7 @@ "const": "resource_link" } }, - "required": [ - "type" - ] + "required": ["type"] }, { "type": "object", @@ -1003,9 +913,7 @@ "const": "resource" } }, - "required": [ - "type" - ] + "required": ["type"] } ] }, @@ -1022,10 +930,7 @@ "properties": { "audience": { "description": "Intended recipients for this content, such as the user or assistant.", - "type": [ - "array", - "null" - ], + "type": ["array", "null"], "items": { "$ref": "#/$defs/Role" }, @@ -1034,27 +939,18 @@ }, "lastModified": { "description": "Timestamp indicating when the underlying resource was last modified.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "priority": { "description": "Relative importance of this content when clients choose what to surface.", - "type": [ - "number", - "null" - ], + "type": ["number", "null"], "format": "double", "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1102,17 +998,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "text" - ] + "required": ["text"] }, "ImageContent": { "description": "An image provided to or from an LLM.", @@ -1140,26 +1031,17 @@ }, "uri": { "description": "URI associated with this resource or media payload.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "data", - "mimeType" - ] + "required": ["data", "mimeType"] }, "AudioContent": { "description": "Audio provided to or from an LLM.", @@ -1187,18 +1069,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "data", - "mimeType" - ] + "required": ["data", "mimeType"] }, "ResourceLink": { "description": "A resource that the server is capable of reading, included in a prompt or tool call result.", @@ -1218,18 +1094,12 @@ }, "description": { "description": "Optional human-readable details shown with this protocol object.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "mimeType": { "description": "MIME type describing the encoded media payload.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "name": { @@ -1238,19 +1108,13 @@ }, "size": { "description": "Optional size of the linked resource in bytes, if known.", - "type": [ - "integer", - "null" - ], + "type": ["integer", "null"], "format": "int64", "x-deserialize-default-on-error": true }, "title": { "description": "Optional display title for end-user UI.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "uri": { @@ -1259,18 +1123,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "name", - "uri" - ] + "required": ["name", "uri"] }, "EmbeddedResourceResource": { "description": "Resource content that can be embedded in a message.", @@ -1301,10 +1159,7 @@ "properties": { "mimeType": { "description": "MIME type describing the encoded media payload.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "text": { @@ -1317,18 +1172,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "text", - "uri" - ] + "required": ["text", "uri"] }, "BlobResourceContents": { "description": "Binary resource contents.", @@ -1340,10 +1189,7 @@ }, "mimeType": { "description": "MIME type describing the encoded media payload.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "uri": { @@ -1352,18 +1198,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "blob", - "uri" - ] + "required": ["blob", "uri"] }, "EmbeddedResource": { "description": "The contents of a resource, embedded into a prompt or tool call result.", @@ -1391,17 +1231,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "resource" - ] + "required": ["resource"] }, "Content": { "description": "Standard content block (text, images, resources).", @@ -1417,17 +1252,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "content" - ] + "required": ["content"] }, "Diff": { "description": "A diff representing file modifications.\n\nShows changes to files in a format suitable for display in the client UI.\n\nSee protocol docs: [Content](https://agentclientprotocol.com/protocol/v2/tool-calls#content)", @@ -1439,10 +1269,7 @@ }, "oldText": { "description": "The original content (None for new files).", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "newText": { @@ -1451,18 +1278,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "path", - "newText" - ] + "required": ["path", "newText"] }, "ToolCallLocation": { "description": "A file location being accessed or modified by a tool.\n\nEnables clients to implement \"follow-along\" features that track\nwhich files the agent is working with in real-time.\n\nSee protocol docs: [Following the Agent](https://agentclientprotocol.com/protocol/v2/tool-calls#following-the-agent)", @@ -1474,27 +1295,19 @@ }, "line": { "description": "Optional line number within the file.", - "type": [ - "integer", - "null" - ], + "type": ["integer", "null"], "format": "uint32", "minimum": 0, "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "path" - ] + "required": ["path"] }, "PermissionOption": { "description": "An option presented to the user when requesting permission.", @@ -1522,19 +1335,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "optionId", - "name", - "kind" - ] + "required": ["optionId", "name", "kind"] }, "PermissionOptionId": { "description": "Unique identifier for a permission option.", @@ -1703,10 +1509,7 @@ ] } }, - "required": [ - "id", - "result" - ] + "required": ["id", "result"] }, { "title": "Error", @@ -1730,10 +1533,7 @@ ] } }, - "required": [ - "id", - "error" - ] + "required": ["id", "error"] } ], "x-docs-ignore": true @@ -1780,18 +1580,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "protocolVersion", - "info" - ], + "required": ["protocolVersion", "info"], "x-side": "agent", "x-method": "initialize" }, @@ -1812,10 +1606,7 @@ }, "title": { "description": "Intended for UI and end-user contexts — optimized to be human-readable\nand easily understood.\n\nIf not provided, the name should be used for display.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "version": { @@ -1824,18 +1615,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "name", - "version" - ] + "required": ["name", "version"] }, "AgentCapabilities": { "description": "Capabilities supported by the agent.\n\nAdvertised during initialization to inform the client about\navailable features and content types.\n\nSee protocol docs: [Agent Capabilities](https://agentclientprotocol.com/protocol/v2/initialization#agent-capabilities)", @@ -1867,10 +1652,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -1978,10 +1760,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2029,10 +1808,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2044,10 +1820,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2059,10 +1832,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2074,10 +1844,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2113,10 +1880,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2128,10 +1892,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2143,10 +1904,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2158,10 +1916,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2173,10 +1928,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2188,10 +1940,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2203,10 +1952,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2218,10 +1964,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2233,10 +1976,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2248,10 +1988,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2269,9 +2006,7 @@ "const": "agent" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/AuthMethodAgent" @@ -2301,27 +2036,17 @@ }, "description": { "description": "Optional description providing more details about this authentication method.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "type", - "id", - "name" - ], + "required": ["type", "id", "name"], "not": { "anyOf": [ { @@ -2332,9 +2057,7 @@ "const": "agent" } }, - "required": [ - "type" - ] + "required": ["type"] } ] }, @@ -2364,26 +2087,17 @@ }, "description": { "description": "Optional description providing more details about this authentication method.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "id", - "name" - ] + "required": ["id", "name"] }, "LoginAuthResponse": { "description": "Response to the `auth/login` method.", @@ -2391,10 +2105,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2408,10 +2119,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2433,10 +2141,7 @@ }, "configOptions": { "description": "Initial session configuration options if supported by the Agent.", - "type": [ - "array", - "null" - ], + "type": ["array", "null"], "items": { "$ref": "#/$defs/SessionConfigOption" }, @@ -2445,17 +2150,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId" - ], + "required": ["sessionId"], "x-side": "agent", "x-method": "session/new" }, @@ -2477,10 +2177,7 @@ }, "description": { "description": "Optional description for the Client to display to the user.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "category": { @@ -2497,18 +2194,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "id", - "name" - ], + "required": ["id", "name"], "anyOf": [ { "description": "Single-value selector (dropdown).", @@ -2519,9 +2210,7 @@ "const": "select" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/SessionConfigSelect" @@ -2538,9 +2227,7 @@ "type": "string" } }, - "required": [ - "type" - ], + "required": ["type"], "not": { "anyOf": [ { @@ -2551,9 +2238,7 @@ "const": "select" } }, - "required": [ - "type" - ] + "required": ["type"] } ] }, @@ -2641,26 +2326,17 @@ }, "description": { "description": "Optional description for this option value.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "value", - "name" - ] + "required": ["value", "name"] }, "SessionConfigSelectGroup": { "description": "A group of possible values for a session configuration option.", @@ -2689,19 +2365,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "group", - "name", - "options" - ] + "required": ["group", "name", "options"] }, "SessionConfigGroupId": { "description": "Unique identifier for a session configuration option value group.", @@ -2728,10 +2397,7 @@ ] } }, - "required": [ - "currentValue", - "options" - ] + "required": ["currentValue", "options"] }, "LoadSessionResponse": { "description": "Response from loading an existing session.", @@ -2739,10 +2405,7 @@ "properties": { "configOptions": { "description": "Initial session configuration options if supported by the Agent.", - "type": [ - "array", - "null" - ], + "type": ["array", "null"], "items": { "$ref": "#/$defs/SessionConfigOption" }, @@ -2751,10 +2414,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2777,25 +2437,17 @@ }, "nextCursor": { "description": "Opaque cursor token. If present, pass this in the next request's cursor parameter\nto fetch the next page. If absent, there are no more results.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessions" - ], + "required": ["sessions"], "x-side": "agent", "x-method": "session/list" }, @@ -2826,34 +2478,22 @@ }, "title": { "description": "Human-readable title for the session", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "updatedAt": { "description": "ISO 8601 timestamp of last activity", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "cwd" - ] + "required": ["sessionId", "cwd"] }, "DeleteSessionResponse": { "description": "Response from deleting a session.", @@ -2861,10 +2501,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2878,10 +2515,7 @@ "properties": { "configOptions": { "description": "Initial session configuration options if supported by the Agent.", - "type": [ - "array", - "null" - ], + "type": ["array", "null"], "items": { "$ref": "#/$defs/SessionConfigOption" }, @@ -2890,10 +2524,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2907,10 +2538,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2933,17 +2561,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "configOptions" - ], + "required": ["configOptions"], "x-side": "agent", "x-method": "session/set_config_option" }, @@ -2953,10 +2576,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -2988,10 +2608,7 @@ "x-deserialize-default-on-error": true } }, - "required": [ - "code", - "message" - ] + "required": ["code", "message"] }, "ErrorCode": { "description": "Predefined error codes for common JSON-RPC and ACP-specific errors.\n\nThese codes follow the JSON-RPC 2.0 specification for standard errors\nand use the reserved range (-32000 to -32099) for protocol-specific errors.", @@ -3093,9 +2710,7 @@ ] } }, - "required": [ - "method" - ], + "required": ["method"], "x-docs-ignore": true }, "UpdateSessionNotification": { @@ -3120,18 +2735,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "update" - ], + "required": ["sessionId", "update"], "x-side": "client", "x-method": "session/update" }, @@ -3147,9 +2756,7 @@ "const": "user_message_chunk" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/ContentChunk" @@ -3165,9 +2772,7 @@ "const": "user_message" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/UserMessage" @@ -3183,9 +2788,7 @@ "const": "agent_message_chunk" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/ContentChunk" @@ -3201,9 +2804,7 @@ "const": "agent_message" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/AgentMessage" @@ -3219,9 +2820,7 @@ "const": "agent_thought_chunk" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/ContentChunk" @@ -3237,9 +2836,7 @@ "const": "agent_thought" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/AgentThought" @@ -3255,9 +2852,7 @@ "const": "state_update" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/StateUpdate" @@ -3273,9 +2868,7 @@ "const": "tool_call_content_chunk" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/ToolCallContentChunk" @@ -3291,9 +2884,7 @@ "const": "tool_call_update" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/ToolCallUpdate" @@ -3309,9 +2900,7 @@ "const": "plan_update" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/PlanUpdate" @@ -3327,9 +2916,7 @@ "const": "available_commands_update" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/AvailableCommandsUpdate" @@ -3345,9 +2932,7 @@ "const": "config_option_update" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/ConfigOptionUpdate" @@ -3363,9 +2948,7 @@ "const": "session_info_update" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/SessionInfoUpdate" @@ -3381,9 +2964,7 @@ "const": "usage_update" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "allOf": [ { "$ref": "#/$defs/UsageUpdate" @@ -3400,9 +2981,7 @@ "type": "string" } }, - "required": [ - "sessionUpdate" - ], + "required": ["sessionUpdate"], "not": { "anyOf": [ { @@ -3413,9 +2992,7 @@ "const": "user_message_chunk" } }, - "required": [ - "sessionUpdate" - ] + "required": ["sessionUpdate"] }, { "type": "object", @@ -3425,9 +3002,7 @@ "const": "user_message" } }, - "required": [ - "sessionUpdate" - ] + "required": ["sessionUpdate"] }, { "type": "object", @@ -3437,9 +3012,7 @@ "const": "agent_message_chunk" } }, - "required": [ - "sessionUpdate" - ] + "required": ["sessionUpdate"] }, { "type": "object", @@ -3449,9 +3022,7 @@ "const": "agent_message" } }, - "required": [ - "sessionUpdate" - ] + "required": ["sessionUpdate"] }, { "type": "object", @@ -3461,9 +3032,7 @@ "const": "agent_thought_chunk" } }, - "required": [ - "sessionUpdate" - ] + "required": ["sessionUpdate"] }, { "type": "object", @@ -3473,9 +3042,7 @@ "const": "agent_thought" } }, - "required": [ - "sessionUpdate" - ] + "required": ["sessionUpdate"] }, { "type": "object", @@ -3485,9 +3052,7 @@ "const": "state_update" } }, - "required": [ - "sessionUpdate" - ] + "required": ["sessionUpdate"] }, { "type": "object", @@ -3497,9 +3062,7 @@ "const": "tool_call_content_chunk" } }, - "required": [ - "sessionUpdate" - ] + "required": ["sessionUpdate"] }, { "type": "object", @@ -3509,9 +3072,7 @@ "const": "tool_call_update" } }, - "required": [ - "sessionUpdate" - ] + "required": ["sessionUpdate"] }, { "type": "object", @@ -3521,9 +3082,7 @@ "const": "plan_update" } }, - "required": [ - "sessionUpdate" - ] + "required": ["sessionUpdate"] }, { "type": "object", @@ -3533,9 +3092,7 @@ "const": "available_commands_update" } }, - "required": [ - "sessionUpdate" - ] + "required": ["sessionUpdate"] }, { "type": "object", @@ -3545,9 +3102,7 @@ "const": "config_option_update" } }, - "required": [ - "sessionUpdate" - ] + "required": ["sessionUpdate"] }, { "type": "object", @@ -3557,9 +3112,7 @@ "const": "session_info_update" } }, - "required": [ - "sessionUpdate" - ] + "required": ["sessionUpdate"] }, { "type": "object", @@ -3569,9 +3122,7 @@ "const": "usage_update" } }, - "required": [ - "sessionUpdate" - ] + "required": ["sessionUpdate"] } ] }, @@ -3608,18 +3159,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "messageId", - "content" - ] + "required": ["messageId", "content"] }, "UserMessage": { "description": "A user message upsert.\n\nOnly [`UserMessage::message_id`] is required. Other fields have patch\nsemantics: omitted fields leave the existing message value unchanged, `null`\nclears or unsets the value, and concrete values replace the previous value.\nFor a new `messageId`, omitted fields use client defaults. `content` is\nreplaced as a whole array; send `[]` or `null` to clear it.\n\nMessage updates and chunks are applied in the order they are received. When\na `user_message` update includes `content`, that array replaces any content\npreviously accumulated for the message, including content from earlier\nchunks. Later chunks with the same `messageId` append to the current\ncontent.", @@ -3635,10 +3180,7 @@ }, "content": { "description": "Complete replacement content for this message.", - "type": [ - "array", - "null" - ], + "type": ["array", "null"], "items": { "$ref": "#/$defs/ContentBlock" }, @@ -3647,17 +3189,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "messageId" - ] + "required": ["messageId"] }, "AgentMessage": { "description": "An agent message upsert.\n\nOnly [`AgentMessage::message_id`] is required. Other fields have patch\nsemantics: omitted fields leave the existing message value unchanged, `null`\nclears or unsets the value, and concrete values replace the previous value.\nFor a new `messageId`, omitted fields use client defaults. `content` is\nreplaced as a whole array; send `[]` or `null` to clear it.\n\nMessage updates and chunks are applied in the order they are received. When\nan `agent_message` update includes `content`, that array replaces any\ncontent previously accumulated for the message, including content from\nearlier chunks. Later chunks with the same `messageId` append to the current\ncontent.", @@ -3673,10 +3210,7 @@ }, "content": { "description": "Complete replacement content for this message.", - "type": [ - "array", - "null" - ], + "type": ["array", "null"], "items": { "$ref": "#/$defs/ContentBlock" }, @@ -3685,17 +3219,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "messageId" - ] + "required": ["messageId"] }, "AgentThought": { "description": "An agent thought or reasoning message upsert.\n\nOnly [`AgentThought::message_id`] is required. Other fields have patch\nsemantics: omitted fields leave the existing thought value unchanged, `null`\nclears or unsets the value, and concrete values replace the previous value.\nFor a new `messageId`, omitted fields use client defaults. `content` is\nreplaced as a whole array; send `[]` or `null` to clear it.\n\nMessage updates and chunks are applied in the order they are received. When\nan `agent_thought` update includes `content`, that array replaces any\ncontent previously accumulated for the thought, including content from\nearlier chunks. Later chunks with the same `messageId` append to the current\ncontent.", @@ -3711,10 +3240,7 @@ }, "content": { "description": "Complete replacement content for this thought message.", - "type": [ - "array", - "null" - ], + "type": ["array", "null"], "items": { "$ref": "#/$defs/ContentBlock" }, @@ -3723,17 +3249,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "messageId" - ] + "required": ["messageId"] }, "RunningStateUpdate": { "description": "The agent is actively processing work in the session.", @@ -3741,10 +3262,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3803,10 +3321,7 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3818,10 +3333,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -3839,9 +3351,7 @@ "const": "running" } }, - "required": [ - "state" - ], + "required": ["state"], "allOf": [ { "$ref": "#/$defs/RunningStateUpdate" @@ -3857,9 +3367,7 @@ "const": "idle" } }, - "required": [ - "state" - ], + "required": ["state"], "allOf": [ { "$ref": "#/$defs/IdleStateUpdate" @@ -3875,9 +3383,7 @@ "const": "requires_action" } }, - "required": [ - "state" - ], + "required": ["state"], "allOf": [ { "$ref": "#/$defs/RequiresActionStateUpdate" @@ -3894,9 +3400,7 @@ "type": "string" } }, - "required": [ - "state" - ], + "required": ["state"], "not": { "anyOf": [ { @@ -3907,9 +3411,7 @@ "const": "running" } }, - "required": [ - "state" - ] + "required": ["state"] }, { "type": "object", @@ -3919,9 +3421,7 @@ "const": "idle" } }, - "required": [ - "state" - ] + "required": ["state"] }, { "type": "object", @@ -3931,9 +3431,7 @@ "const": "requires_action" } }, - "required": [ - "state" - ] + "required": ["state"] } ] }, @@ -3966,18 +3464,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys. This field is optional; omitted or `null` means there is no\nchunk-level metadata.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "toolCallId", - "content" - ] + "required": ["toolCallId", "content"] }, "PlanUpdateContent": { "description": "Updated content for a plan.", @@ -3991,9 +3483,7 @@ "const": "items" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/PlanItems" @@ -4018,10 +3508,7 @@ ] } }, - "required": [ - "type", - "id" - ], + "required": ["type", "id"], "not": { "anyOf": [ { @@ -4032,9 +3519,7 @@ "const": "items" } }, - "required": [ - "type" - ] + "required": ["type"] }, { "type": "object", @@ -4044,9 +3529,7 @@ "const": "file" } }, - "required": [ - "type" - ] + "required": ["type"] }, { "type": "object", @@ -4056,9 +3539,7 @@ "const": "markdown" } }, - "required": [ - "type" - ] + "required": ["type"] } ] }, @@ -4099,19 +3580,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "content", - "priority", - "status" - ] + "required": ["content", "priority", "status"] }, "PlanEntryPriority": { "description": "Priority levels for plan entries.\n\nUsed to indicate the relative importance or urgency of different\ntasks in the execution plan.\nSee protocol docs: [Plan Entries](https://agentclientprotocol.com/protocol/v2/agent-plan#plan-entries)", @@ -4186,18 +3660,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "id", - "entries" - ] + "required": ["id", "entries"] }, "PlanUpdate": { "description": "A content update for a plan identified by ID.", @@ -4213,17 +3681,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "plan" - ] + "required": ["plan"] }, "AvailableCommand": { "description": "Information about a command.", @@ -4251,18 +3714,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "name", - "description" - ] + "required": ["name", "description"] }, "AvailableCommandInput": { "description": "The input specification for a command.", @@ -4286,9 +3743,7 @@ "type": "string" } }, - "required": [ - "type" - ], + "required": ["type"], "additionalProperties": true } ] @@ -4303,22 +3758,15 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "hint" - ], + "required": ["hint"], "not": { "type": "object", - "required": [ - "type" - ] + "required": ["type"] } }, "AvailableCommandsUpdate": { @@ -4336,17 +3784,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "availableCommands" - ] + "required": ["availableCommands"] }, "ConfigOptionUpdate": { "description": "Session configuration options have been updated.", @@ -4363,17 +3806,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "configOptions" - ] + "required": ["configOptions"] }, "SessionInfoUpdate": { "description": "Update to session metadata. All fields are optional to support partial updates.\n\nAgents send this notification to update session information like title or custom metadata.\nThis allows clients to display dynamic session names and track session state changes.", @@ -4381,26 +3819,17 @@ "properties": { "title": { "description": "Human-readable title for the session. Set to null to clear.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "updatedAt": { "description": "ISO 8601 timestamp of last activity. Set to null to clear.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -4421,18 +3850,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "amount", - "currency" - ] + "required": ["amount", "currency"] }, "UsageUpdate": { "description": "Context window and cost update for a session.", @@ -4464,18 +3887,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "used", - "size" - ] + "required": ["used", "size"] }, "ExtNotification": { "description": "Allows the Agent to send an arbitrary notification that is not part of the ACP spec.\nExtension notifications provide a way to send one-way messages for custom functionality\nwhile maintaining protocol compatibility.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)" @@ -4618,10 +4035,7 @@ ] } }, - "required": [ - "id", - "method" - ], + "required": ["id", "method"], "x-docs-ignore": true }, "InitializeRequest": { @@ -4656,18 +4070,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "protocolVersion", - "info" - ], + "required": ["protocolVersion", "info"], "x-side": "agent", "x-method": "initialize" }, @@ -4677,10 +4085,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -4700,17 +4105,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "methodId" - ], + "required": ["methodId"], "x-side": "agent", "x-method": "auth/login" }, @@ -4720,10 +4120,7 @@ "properties": { "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -4759,17 +4156,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "cwd" - ], + "required": ["cwd"], "x-side": "agent", "x-method": "session/new" }, @@ -4785,9 +4177,7 @@ "const": "http" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/McpServerHttp" @@ -4803,9 +4193,7 @@ "const": "stdio" } }, - "required": [ - "type" - ], + "required": ["type"], "allOf": [ { "$ref": "#/$defs/McpServerStdio" @@ -4822,9 +4210,7 @@ "type": "string" } }, - "required": [ - "type" - ], + "required": ["type"], "not": { "anyOf": [ { @@ -4835,9 +4221,7 @@ "const": "http" } }, - "required": [ - "type" - ] + "required": ["type"] }, { "type": "object", @@ -4847,9 +4231,7 @@ "const": "stdio" } }, - "required": [ - "type" - ] + "required": ["type"] } ] }, @@ -4874,18 +4256,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "name", - "value" - ] + "required": ["name", "value"] }, "McpServerHttp": { "description": "HTTP transport configuration for MCP.", @@ -4910,19 +4286,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "name", - "url", - "headers" - ] + "required": ["name", "url", "headers"] }, "EnvVariable": { "description": "An environment variable to set when launching an MCP server.", @@ -4938,18 +4307,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "name", - "value" - ] + "required": ["name", "value"] }, "McpServerStdio": { "description": "Stdio transport configuration for MCP.", @@ -4983,20 +4346,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "name", - "command", - "args", - "env" - ] + "required": ["name", "command", "args", "env"] }, "LoadSessionRequest": { "description": "Request parameters for loading an existing session.\n\nOnly available if the Agent supports the `session.load` capability.\n\nSee protocol docs: [Loading Sessions](https://agentclientprotocol.com/protocol/v2/session-setup#loading-sessions)", @@ -5034,19 +4389,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "cwd", - "mcpServers" - ], + "required": ["sessionId", "cwd", "mcpServers"], "x-side": "agent", "x-method": "session/load" }, @@ -5056,26 +4404,17 @@ "properties": { "cwd": { "description": "Filter sessions by working directory. Must be an absolute path.", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "cursor": { "description": "Opaque cursor token from a previous response's nextCursor field for cursor-based pagination", - "type": [ - "string", - "null" - ], + "type": ["string", "null"], "x-deserialize-default-on-error": true }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } @@ -5097,17 +4436,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId" - ], + "required": ["sessionId"], "x-side": "agent", "x-method": "session/delete" }, @@ -5147,18 +4481,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "cwd" - ], + "required": ["sessionId", "cwd"], "x-side": "agent", "x-method": "session/resume" }, @@ -5176,17 +4504,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId" - ], + "required": ["sessionId"], "x-side": "agent", "x-method": "session/close" }, @@ -5220,19 +4543,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "configId", - "value" - ], + "required": ["sessionId", "configId", "value"], "x-side": "agent", "x-method": "session/set_config_option" }, @@ -5259,18 +4575,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId", - "prompt" - ], + "required": ["sessionId", "prompt"], "x-side": "agent", "x-method": "session/prompt" }, @@ -5314,10 +4624,7 @@ ] } }, - "required": [ - "id", - "result" - ] + "required": ["id", "result"] }, { "title": "Error", @@ -5341,10 +4648,7 @@ ] } }, - "required": [ - "id", - "error" - ] + "required": ["id", "error"] } ], "x-docs-ignore": true @@ -5363,17 +4667,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "outcome" - ], + "required": ["outcome"], "x-side": "client", "x-method": "session/request_permission" }, @@ -5389,9 +4688,7 @@ "const": "cancelled" } }, - "required": [ - "outcome" - ] + "required": ["outcome"] }, { "description": "The user selected one of the provided options.", @@ -5402,9 +4699,7 @@ "const": "selected" } }, - "required": [ - "outcome" - ], + "required": ["outcome"], "allOf": [ { "$ref": "#/$defs/SelectedPermissionOutcome" @@ -5430,17 +4725,12 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "optionId" - ] + "required": ["optionId"] }, "ClientNotification": { "description": "A JSON-RPC notification object.", @@ -5482,9 +4772,7 @@ ] } }, - "required": [ - "method" - ], + "required": ["method"], "x-docs-ignore": true }, "CancelSessionNotification": { @@ -5501,19 +4789,14 @@ }, "_meta": { "description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/extensibility)", - "type": [ - "object", - "null" - ], + "type": ["object", "null"], "x-deserialize-default-on-error": true, "additionalProperties": true } }, - "required": [ - "sessionId" - ], + "required": ["sessionId"], "x-side": "agent", "x-method": "session/cancel" } } -} \ No newline at end of file +} diff --git a/schema/v2/schema.unstable.json b/schema/v2/schema.unstable.json index 3ecaeb6ca..17297c6aa 100644 --- a/schema/v2/schema.unstable.json +++ b/schema/v2/schema.unstable.json @@ -5098,11 +5098,11 @@ "description": "All possible notifications that an agent can send to a client.\n\nThis enum is used internally for routing RPC notifications. You typically won't need\nto use this directly.\n\nNotifications do not expect a response.", "anyOf": [ { - "title": "SessionUpdateNotification", + "title": "UpdateSessionNotification", "description": "Handles session update notifications from the agent.\n\nThis is a notification endpoint (no response expected) that receives\nreal-time updates about session progress, including message updates,\nmessage chunks, tool calls, and execution plans.\n\nNote: Clients SHOULD continue accepting tool call updates even after\nsending a `session/cancel` notification, as the agent may send final\nupdates before reporting an idle `state_update` with the cancelled\nstop reason.\n\nSee protocol docs: [Agent Reports Output](https://agentclientprotocol.com/protocol/v2/draft/prompt-lifecycle#3-agent-reports-output)", "allOf": [ { - "$ref": "#/$defs/SessionUpdateNotification" + "$ref": "#/$defs/UpdateSessionNotification" } ] }, @@ -5144,7 +5144,7 @@ "required": ["method"], "x-docs-ignore": true }, - "SessionUpdateNotification": { + "UpdateSessionNotification": { "description": "Notification containing a session update from the agent.\n\nUsed to stream real-time progress and results during prompt processing.\n\nSee protocol docs: [Agent Reports Output](https://agentclientprotocol.com/protocol/v2/draft/prompt-lifecycle#3-agent-reports-output)", "type": "object", "properties": {