acp-sdk 0.8.0 → 0.10.0

data/lib/acp/types/unstable/unknown_state_update.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+# Generated by bin/types from schema/schema.unstable.json. Do not edit.
+# Unstable: not part of the ACP spec, may change or disappear at any point.
+
+class ACP::Types::Unstable::UnknownStateUpdate
+  # @dynamic meta
+  attr_reader :meta #: Hash[String, untyped]?
+
+  # @rbs meta: Hash[String, untyped]?
+  # @rbs return: void
+  def initialize(meta: nil)
+    @meta = meta
+    freeze
+  end
+
+  # @rbs hash: Hash[String, untyped]
+  # @rbs return: ACP::Types::Unstable::UnknownStateUpdate
+  def self.from_h(hash)
+    new(meta: hash['_meta'])
+  end
+
+  # @rbs return: Hash[String, untyped]
+  def to_h
+    { '_meta' => meta }.compact
+  end
+end

data/lib/acp/types/unstable/usage.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+# Generated by bin/types from schema/schema.unstable.json. Do not edit.
+# Unstable: not part of the ACP spec, may change or disappear at any point.
+
+class ACP::Types::Unstable::Usage
+  # @dynamic total_tokens
+  attr_reader :total_tokens #: Integer
+
+  # @dynamic input_tokens
+  attr_reader :input_tokens #: Integer
+
+  # @dynamic output_tokens
+  attr_reader :output_tokens #: Integer
+
+  # @dynamic thought_tokens
+  attr_reader :thought_tokens #: Integer?
+
+  # @dynamic cached_read_tokens
+  attr_reader :cached_read_tokens #: Integer?
+
+  # @dynamic cached_write_tokens
+  attr_reader :cached_write_tokens #: Integer?
+
+  # @dynamic meta
+  attr_reader :meta #: Hash[String, untyped]?
+
+  # @rbs total_tokens: Integer
+  # @rbs input_tokens: Integer
+  # @rbs output_tokens: Integer
+  # @rbs thought_tokens: Integer?
+  # @rbs cached_read_tokens: Integer?
+  # @rbs cached_write_tokens: Integer?
+  # @rbs meta: Hash[String, untyped]?
+  # @rbs return: void
+  def initialize(
+    total_tokens:,
+    input_tokens:,
+    output_tokens:,
+    thought_tokens: nil,
+    cached_read_tokens: nil,
+    cached_write_tokens: nil,
+    meta: nil
+  )
+    @total_tokens = total_tokens
+    @input_tokens = input_tokens
+    @output_tokens = output_tokens
+    @thought_tokens = thought_tokens
+    @cached_read_tokens = cached_read_tokens
+    @cached_write_tokens = cached_write_tokens
+    @meta = meta
+    freeze
+  end
+
+  # @rbs hash: Hash[String, untyped]
+  # @rbs return: ACP::Types::Unstable::Usage
+  def self.from_h(hash)
+    new(
+      total_tokens: ACP::Types::Check.integer(ACP::Types::Check.key(hash, 'totalTokens'), 'totalTokens', min: 0),
+      input_tokens: ACP::Types::Check.integer(ACP::Types::Check.key(hash, 'inputTokens'), 'inputTokens', min: 0),
+      output_tokens: ACP::Types::Check.integer(ACP::Types::Check.key(hash, 'outputTokens'), 'outputTokens', min: 0),
+      thought_tokens: ACP::Types::Check.integer(hash['thoughtTokens'], 'thoughtTokens', min: 0, allow_nil: true),
+      cached_read_tokens: ACP::Types::Check.integer(
+        hash['cachedReadTokens'],
+        'cachedReadTokens',
+        min: 0,
+        allow_nil: true
+      ),
+      cached_write_tokens: ACP::Types::Check.integer(
+        hash['cachedWriteTokens'],
+        'cachedWriteTokens',
+        min: 0,
+        allow_nil: true
+      ),
+      meta: hash['_meta']
+    )
+  end
+
+  # @rbs return: Hash[String, untyped]
+  def to_h
+    {
+      'totalTokens' => total_tokens,
+      'inputTokens' => input_tokens,
+      'outputTokens' => output_tokens,
+      'thoughtTokens' => thought_tokens,
+      'cachedReadTokens' => cached_read_tokens,
+      'cachedWriteTokens' => cached_write_tokens,
+      '_meta' => meta
+    }.compact
+  end
+end

data/lib/acp/types/unstable/workspace_folder.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+# Generated by bin/types from schema/schema.unstable.json. Do not edit.
+# Unstable: not part of the ACP spec, may change or disappear at any point.
+
+class ACP::Types::Unstable::WorkspaceFolder
+  # @dynamic uri
+  attr_reader :uri #: String
+
+  # @dynamic name
+  attr_reader :name #: String
+
+  # @dynamic meta
+  attr_reader :meta #: Hash[String, untyped]?
+
+  # @rbs uri: String
+  # @rbs name: String
+  # @rbs meta: Hash[String, untyped]?
+  # @rbs return: void
+  def initialize(uri:, name:, meta: nil)
+    @uri = uri
+    @name = name
+    @meta = meta
+    freeze
+  end
+
+  # @rbs hash: Hash[String, untyped]
+  # @rbs return: ACP::Types::Unstable::WorkspaceFolder
+  def self.from_h(hash)
+    new(
+      uri: ACP::Types::Check.string(ACP::Types::Check.key(hash, 'uri'), 'uri'),
+      name: ACP::Types::Check.string(ACP::Types::Check.key(hash, 'name'), 'name'),
+      meta: hash['_meta']
+    )
+  end
+
+  # @rbs return: Hash[String, untyped]
+  def to_h
+    { 'uri' => uri, 'name' => name, '_meta' => meta }.compact
+  end
+end

data/lib/acp/types/unstable.rb

@@ -0,0 +1,155 @@
+# frozen_string_literal: true
+
+# Generated by bin/types from schema/schema.unstable.json. Do not edit.
+#
+# Callers opt into the unstable types with `require 'acp/types/unstable'`.
+# Zeitwerk ignores lib/acp/types/unstable, so referencing
+# ACP::Types::Unstable without this require raises NameError.
+# These types are not part of the ACP spec and may change or disappear at
+# any point; the stable ACP::Types namespace is unaffected.
+
+module ACP::Types::Unstable
+end
+
+require_relative 'unstable/accept_nes_notification'
+require_relative 'unstable/agent_capabilities'
+require_relative 'unstable/client_capabilities'
+require_relative 'unstable/client_nes_capabilities'
+require_relative 'unstable/client_session_capabilities'
+require_relative 'unstable/close_nes_request'
+require_relative 'unstable/close_nes_response'
+require_relative 'unstable/compaction_status'
+require_relative 'unstable/compaction_summary_chunk'
+require_relative 'unstable/compaction_update'
+require_relative 'unstable/did_change_document_notification'
+require_relative 'unstable/did_close_document_notification'
+require_relative 'unstable/did_focus_document_notification'
+require_relative 'unstable/did_open_document_notification'
+require_relative 'unstable/did_save_document_notification'
+require_relative 'unstable/disable_provider_request'
+require_relative 'unstable/disable_provider_response'
+require_relative 'unstable/fork_session_request'
+require_relative 'unstable/fork_session_response'
+require_relative 'unstable/idle_state_update'
+require_relative 'unstable/initialize_response'
+require_relative 'unstable/list_providers_request'
+require_relative 'unstable/list_providers_response'
+require_relative 'unstable/llm_protocol'
+require_relative 'unstable/mcp_capabilities'
+require_relative 'unstable/mcp_error'
+require_relative 'unstable/mcp_server'
+require_relative 'unstable/mcp_server/acp'
+require_relative 'unstable/mcp_server/http'
+require_relative 'unstable/mcp_server/sse'
+require_relative 'unstable/mcp_server_acp'
+require_relative 'unstable/message_mcp_notification'
+require_relative 'unstable/message_mcp_request'
+require_relative 'unstable/message_mcp_response'
+require_relative 'unstable/message_mcp_response/error'
+require_relative 'unstable/message_mcp_response/result'
+require_relative 'unstable/nes_capabilities'
+require_relative 'unstable/nes_context_capabilities'
+require_relative 'unstable/nes_diagnostic'
+require_relative 'unstable/nes_diagnostic_severity'
+require_relative 'unstable/nes_diagnostics_capabilities'
+require_relative 'unstable/nes_document_did_change_capabilities'
+require_relative 'unstable/nes_document_did_close_capabilities'
+require_relative 'unstable/nes_document_did_focus_capabilities'
+require_relative 'unstable/nes_document_did_open_capabilities'
+require_relative 'unstable/nes_document_did_save_capabilities'
+require_relative 'unstable/nes_document_event_capabilities'
+require_relative 'unstable/nes_edit_history_capabilities'
+require_relative 'unstable/nes_edit_history_entry'
+require_relative 'unstable/nes_edit_suggestion'
+require_relative 'unstable/nes_event_capabilities'
+require_relative 'unstable/nes_excerpt'
+require_relative 'unstable/nes_jump_capabilities'
+require_relative 'unstable/nes_jump_suggestion'
+require_relative 'unstable/nes_open_file'
+require_relative 'unstable/nes_open_files_capabilities'
+require_relative 'unstable/nes_recent_file'
+require_relative 'unstable/nes_recent_files_capabilities'
+require_relative 'unstable/nes_reject_reason'
+require_relative 'unstable/nes_related_snippet'
+require_relative 'unstable/nes_related_snippets_capabilities'
+require_relative 'unstable/nes_rename_capabilities'
+require_relative 'unstable/nes_rename_suggestion'
+require_relative 'unstable/nes_repository'
+require_relative 'unstable/nes_search_and_replace_capabilities'
+require_relative 'unstable/nes_search_and_replace_suggestion'
+require_relative 'unstable/nes_suggest_context'
+require_relative 'unstable/nes_suggestion'
+require_relative 'unstable/nes_suggestion/edit'
+require_relative 'unstable/nes_suggestion/jump'
+require_relative 'unstable/nes_suggestion/rename'
+require_relative 'unstable/nes_suggestion/searchandreplace'
+require_relative 'unstable/nes_text_edit'
+require_relative 'unstable/nes_trigger_kind'
+require_relative 'unstable/nes_user_action'
+require_relative 'unstable/nes_user_actions_capabilities'
+require_relative 'unstable/notice'
+require_relative 'unstable/notice_severity'
+require_relative 'unstable/plan_capabilities'
+require_relative 'unstable/plan_file'
+require_relative 'unstable/plan_items'
+require_relative 'unstable/plan_markdown'
+require_relative 'unstable/plan_removed'
+require_relative 'unstable/plan_update'
+require_relative 'unstable/plan_update_content'
+require_relative 'unstable/plan_update_content/file'
+require_relative 'unstable/plan_update_content/items'
+require_relative 'unstable/plan_update_content/markdown'
+require_relative 'unstable/position'
+require_relative 'unstable/position_encoding_kind'
+require_relative 'unstable/prompt_response'
+require_relative 'unstable/provider_current_config'
+require_relative 'unstable/provider_info'
+require_relative 'unstable/providers_capabilities'
+require_relative 'unstable/range'
+require_relative 'unstable/reject_nes_notification'
+require_relative 'unstable/requires_action_state_update'
+require_relative 'unstable/running_state_update'
+require_relative 'unstable/session_cancel_capabilities'
+require_relative 'unstable/session_capabilities'
+require_relative 'unstable/session_fork_capabilities'
+require_relative 'unstable/session_message'
+require_relative 'unstable/session_message_chunk'
+require_relative 'unstable/session_update'
+require_relative 'unstable/session_update/agent_message_chunk'
+require_relative 'unstable/session_update/agent_thought_chunk'
+require_relative 'unstable/session_update/available_commands_update'
+require_relative 'unstable/session_update/compaction_summary_chunk'
+require_relative 'unstable/session_update/compaction_update'
+require_relative 'unstable/session_update/config_option_update'
+require_relative 'unstable/session_update/current_mode_update'
+require_relative 'unstable/session_update/notice'
+require_relative 'unstable/session_update/plan'
+require_relative 'unstable/session_update/plan_removed'
+require_relative 'unstable/session_update/plan_update'
+require_relative 'unstable/session_update/session_info_update'
+require_relative 'unstable/session_update/session_message'
+require_relative 'unstable/session_update/session_message_chunk'
+require_relative 'unstable/session_update/subagent_update'
+require_relative 'unstable/session_update/tool_call'
+require_relative 'unstable/session_update/tool_call_update'
+require_relative 'unstable/session_update/usage_update'
+require_relative 'unstable/session_update/user_message_chunk'
+require_relative 'unstable/set_provider_request'
+require_relative 'unstable/set_provider_response'
+require_relative 'unstable/start_nes_request'
+require_relative 'unstable/start_nes_response'
+require_relative 'unstable/state_update'
+require_relative 'unstable/state_update/idle'
+require_relative 'unstable/state_update/requires_action'
+require_relative 'unstable/state_update/running'
+require_relative 'unstable/state_update/unknown'
+require_relative 'unstable/subagent_capabilities'
+require_relative 'unstable/subagent_session_capabilities'
+require_relative 'unstable/subagent_update'
+require_relative 'unstable/suggest_nes_request'
+require_relative 'unstable/suggest_nes_response'
+require_relative 'unstable/text_document_content_change_event'
+require_relative 'unstable/text_document_sync_kind'
+require_relative 'unstable/unknown_state_update'
+require_relative 'unstable/usage'
+require_relative 'unstable/workspace_folder'

data/lib/acp/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ACP
-  VERSION = '0.8.0'
+  VERSION = '0.10.0'
 end

data/sig/generated/acp/agent_connection/client.rbs

@@ -1,14 +1,17 @@
 # Generated from lib/acp/agent_connection/client.rb with RBS::Inline
 
 class ACP::AgentConnection::Client
+  @mcp_advertised: bool
+
   @peer: ACP::AgentConnection::_Peer
 
   # @dynamic capabilities, capabilities=
   attr_accessor capabilities: ACP::Types::ClientCapabilities?
 
   # @rbs peer: ACP::AgentConnection::_Peer
+  # @rbs mcp_advertised: bool
   # @rbs return: void
-  def initialize: (peer: ACP::AgentConnection::_Peer) -> void
+  def initialize: (peer: ACP::AgentConnection::_Peer, ?mcp_advertised: bool) -> void
 
   # @rbs session_id: String
   # @rbs update: ACP::Types::SessionUpdate::t
@@ -27,6 +30,14 @@ class ACP::AgentConnection::Client
   # @rbs return: ACP::Types::RequestPermissionResponse | ACP::RequestError
   def request_permission: (ACP::Types::RequestPermissionRequest request) -> (ACP::Types::RequestPermissionResponse | ACP::RequestError)
 
+  # @rbs return: void
+  def cancel_requests: () -> void
+
+  # Always false off a handler thread.
+  #
+  # @rbs return: bool
+  def cancelled?: () -> bool
+
   # @rbs request: ACP::Types::ReadTextFileRequest
   # @rbs return: ACP::Types::ReadTextFileResponse | ACP::RequestError
   def read_text_file: (ACP::Types::ReadTextFileRequest request) -> (ACP::Types::ReadTextFileResponse | ACP::RequestError)
@@ -63,6 +74,14 @@ class ACP::AgentConnection::Client
   # @rbs return: void
   def complete_elicitation: (ACP::Types::CompleteElicitationNotification notification) -> void
 
+  # Sends one inner MCP operation to the client's declared ACP MCP server. The
+  # reply's result may be null, and a reply matching neither carrier branch
+  # comes back as the raw hash.
+  #
+  # @rbs request: ACP::Types::Unstable::MessageMcpRequest
+  # @rbs return: (ACP::Types::Unstable::MessageMcpResponse::t | ACP::RequestError)
+  def mcp_message: (ACP::Types::Unstable::MessageMcpRequest request) -> (ACP::Types::Unstable::MessageMcpResponse::t | ACP::RequestError)
+
   # Sends an extension request, keyed by its raw `_`-prefixed wire name, and
   # returns the client's reply as-is: extension methods have no schema to
   # parse the result into.

data/sig/generated/acp/agent_connection/optional_method/disable_provider.rbs

@@ -0,0 +1,13 @@
+# Generated from lib/acp/agent_connection/optional_method/disable_provider.rb with RBS::Inline
+
+module ACP::AgentConnection::OptionalMethod::DisableProvider
+  # @rbs return: String
+  def rpc_method: () -> String
+
+  # @rbs return: Symbol
+  def agent_method: () -> Symbol
+
+  # @rbs initialize_response: ACP::Types::InitializeResponse
+  # @rbs return: bool
+  def advertised?: (ACP::Types::InitializeResponse initialize_response) -> bool
+end

data/sig/generated/acp/agent_connection/optional_method/fork_session.rbs

@@ -0,0 +1,13 @@
+# Generated from lib/acp/agent_connection/optional_method/fork_session.rb with RBS::Inline
+
+module ACP::AgentConnection::OptionalMethod::ForkSession
+  # @rbs return: String
+  def rpc_method: () -> String
+
+  # @rbs return: Symbol
+  def agent_method: () -> Symbol
+
+  # @rbs initialize_response: ACP::Types::InitializeResponse
+  # @rbs return: bool
+  def advertised?: (ACP::Types::InitializeResponse initialize_response) -> bool
+end

data/sig/generated/acp/agent_connection/optional_method/list_providers.rbs

@@ -0,0 +1,13 @@
+# Generated from lib/acp/agent_connection/optional_method/list_providers.rb with RBS::Inline
+
+module ACP::AgentConnection::OptionalMethod::ListProviders
+  # @rbs return: String
+  def rpc_method: () -> String
+
+  # @rbs return: Symbol
+  def agent_method: () -> Symbol
+
+  # @rbs initialize_response: ACP::Types::InitializeResponse
+  # @rbs return: bool
+  def advertised?: (ACP::Types::InitializeResponse initialize_response) -> bool
+end

data/sig/generated/acp/agent_connection/optional_method/set_provider.rbs

@@ -0,0 +1,13 @@
+# Generated from lib/acp/agent_connection/optional_method/set_provider.rb with RBS::Inline
+
+module ACP::AgentConnection::OptionalMethod::SetProvider
+  # @rbs return: String
+  def rpc_method: () -> String
+
+  # @rbs return: Symbol
+  def agent_method: () -> Symbol
+
+  # @rbs initialize_response: ACP::Types::InitializeResponse
+  # @rbs return: bool
+  def advertised?: (ACP::Types::InitializeResponse initialize_response) -> bool
+end

data/sig/generated/acp/agent_connection.rbs

@@ -47,6 +47,21 @@ class ACP::AgentConnection
   # @rbs return: Hash[String, ^(untyped) -> (ACP::AgentConnection::_Response | ACP::RequestError | ACP::Transport::Reply)]
   def requests: (ACP::AgentConnection::_Agent agent, ACP::AgentConnection::Client client) -> Hash[String, ^(untyped) -> (ACP::AgentConnection::_Response | ACP::RequestError | ACP::Transport::Reply)]
 
+  # The unstable request types are referenced while the hash is built, so
+  # without the guard start would raise NameError even for an agent that never
+  # advertises fork or providers.
+  #
+  # @rbs full: ACP::AgentConnection::_FullAgent
+  # @rbs return: Hash[String, ^(untyped) -> (ACP::AgentConnection::_Response | ACP::RequestError | ACP::Transport::Reply)]
+  def unstable_requests: (ACP::AgentConnection::_FullAgent full) -> Hash[String, ^(untyped) -> (ACP::AgentConnection::_Response | ACP::RequestError | ACP::Transport::Reply)]
+
+  # ForkSession's and the provider methods' advertised? reference the unstable
+  # types, so they can only be probed when the caller opted in with
+  # `require 'acp/types/unstable'`.
+  #
+  # @rbs return: Array[ACP::AgentConnection::_OptionalMethod]
+  def optional_methods: () -> Array[ACP::AgentConnection::_OptionalMethod]
+
   # @rbs agent: ACP::AgentConnection::_Agent
   # @rbs return: Hash[String, ^(untyped) -> void]
   def notifications: (ACP::AgentConnection::_Agent agent) -> Hash[String, ^(untyped) -> void]
@@ -58,6 +73,20 @@ class ACP::AgentConnection
   # @rbs return: void
   def cancel: (ACP::AgentConnection::_Agent agent, untyped params) -> void
 
+  # The unstable gates reference the unstable types, so they can only be
+  # probed when the caller opted in with `require 'acp/types/unstable'`; the
+  # stable McpCapabilities has no acp field at all.
+  #
+  # @rbs return: bool
+  def mcp_acp_advertised?: () -> bool
+
+  # A notification has no reply to carry a parse failure.
+  #
+  # @rbs agent: ACP::AgentConnection::_Agent
+  # @rbs params: untyped
+  # @rbs return: void
+  def mcp_message_notification: (ACP::AgentConnection::_Agent agent, untyped params) -> void
+
   # Generated from_h raises on a missing key or a value of the wrong shape.
   #
   # @rbs type: ACP::AgentConnection::_Parser

data/sig/generated/acp/client_connection.rbs

@@ -25,6 +25,10 @@ class ACP::ClientConnection
 
   @updates: ACP::ClientConnection::_UpdateHandler
 
+  @mcp_message: (^(ACP::Types::Unstable::MessageMcpRequest) -> (ACP::Types::Unstable::MessageMcpResponse::t | ACP::RequestError))?
+
+  @mcp_advertised: bool?
+
   @fs_capabilities: ACP::Types::FileSystemCapabilities?
 
   @terminal: bool?
@@ -65,11 +69,13 @@ class ACP::ClientConnection
   #   (ACP::Types::CreateElicitationResponse | ACP::RequestError))?
   # @rbs complete_elicitation: (^(ACP::Types::CompleteElicitationNotification) -> void)?
   # @rbs updates: ACP::ClientConnection::_UpdateHandler
+  # @rbs mcp_message: (^(ACP::Types::Unstable::MessageMcpRequest) ->
+  #   (ACP::Types::Unstable::MessageMcpResponse::t | ACP::RequestError))?
   # @rbs extension_requests: Hash[String, ^(untyped) -> untyped]
   # @rbs extension_notifications: Hash[String, ^(untyped) -> void]
   # @rbs logger: ACP::Transport::_Logger
   # @rbs return: void
-  def initialize: (transport: ACP::AgentConnection::_Transport, permission: ACP::ClientConnection::_PermissionHandler, ?read_text_file: (^(ACP::Types::ReadTextFileRequest) -> (ACP::Types::ReadTextFileResponse | ACP::RequestError))?, ?write_text_file: (^(ACP::Types::WriteTextFileRequest) -> (ACP::Types::WriteTextFileResponse | ACP::RequestError))?, ?create_terminal: (^(ACP::Types::CreateTerminalRequest) -> (ACP::Types::CreateTerminalResponse | ACP::RequestError))?, ?terminal_output: (^(ACP::Types::TerminalOutputRequest) -> (ACP::Types::TerminalOutputResponse | ACP::RequestError))?, ?wait_for_terminal_exit: (^(ACP::Types::WaitForTerminalExitRequest) -> (ACP::Types::WaitForTerminalExitResponse | ACP::RequestError))?, ?kill_terminal: (^(ACP::Types::KillTerminalRequest) -> (ACP::Types::KillTerminalResponse | ACP::RequestError))?, ?release_terminal: (^(ACP::Types::ReleaseTerminalRequest) -> (ACP::Types::ReleaseTerminalResponse | ACP::RequestError))?, ?elicitation: (^(ACP::Types::CreateElicitationRequest) -> (ACP::Types::CreateElicitationResponse | ACP::RequestError))?, ?complete_elicitation: (^(ACP::Types::CompleteElicitationNotification) -> void)?, ?updates: ACP::ClientConnection::_UpdateHandler, ?extension_requests: Hash[String, ^(untyped) -> untyped], ?extension_notifications: Hash[String, ^(untyped) -> void], ?logger: ACP::Transport::_Logger) -> void
+  def initialize: (transport: ACP::AgentConnection::_Transport, permission: ACP::ClientConnection::_PermissionHandler, ?read_text_file: (^(ACP::Types::ReadTextFileRequest) -> (ACP::Types::ReadTextFileResponse | ACP::RequestError))?, ?write_text_file: (^(ACP::Types::WriteTextFileRequest) -> (ACP::Types::WriteTextFileResponse | ACP::RequestError))?, ?create_terminal: (^(ACP::Types::CreateTerminalRequest) -> (ACP::Types::CreateTerminalResponse | ACP::RequestError))?, ?terminal_output: (^(ACP::Types::TerminalOutputRequest) -> (ACP::Types::TerminalOutputResponse | ACP::RequestError))?, ?wait_for_terminal_exit: (^(ACP::Types::WaitForTerminalExitRequest) -> (ACP::Types::WaitForTerminalExitResponse | ACP::RequestError))?, ?kill_terminal: (^(ACP::Types::KillTerminalRequest) -> (ACP::Types::KillTerminalResponse | ACP::RequestError))?, ?release_terminal: (^(ACP::Types::ReleaseTerminalRequest) -> (ACP::Types::ReleaseTerminalResponse | ACP::RequestError))?, ?elicitation: (^(ACP::Types::CreateElicitationRequest) -> (ACP::Types::CreateElicitationResponse | ACP::RequestError))?, ?complete_elicitation: (^(ACP::Types::CompleteElicitationNotification) -> void)?, ?updates: ACP::ClientConnection::_UpdateHandler, ?mcp_message: (^(ACP::Types::Unstable::MessageMcpRequest) -> (ACP::Types::Unstable::MessageMcpResponse::t | ACP::RequestError))?, ?extension_requests: Hash[String, ^(untyped) -> untyped], ?extension_notifications: Hash[String, ^(untyped) -> void], ?logger: ACP::Transport::_Logger) -> void
 
   # @rbs return: Thread
   def start: () -> Thread
@@ -114,6 +120,22 @@ class ACP::ClientConnection
   # @rbs return: ACP::Types::DeleteSessionResponse | ACP::RequestError
   def session_delete: (ACP::Types::DeleteSessionRequest request) -> (ACP::Types::DeleteSessionResponse | ACP::RequestError)
 
+  # @rbs request: ACP::Types::Unstable::ForkSessionRequest
+  # @rbs return: (ACP::Types::Unstable::ForkSessionResponse | ACP::RequestError)
+  def session_fork: (ACP::Types::Unstable::ForkSessionRequest request) -> (ACP::Types::Unstable::ForkSessionResponse | ACP::RequestError)
+
+  # @rbs request: ACP::Types::Unstable::ListProvidersRequest
+  # @rbs return: (ACP::Types::Unstable::ListProvidersResponse | ACP::RequestError)
+  def providers_list: (ACP::Types::Unstable::ListProvidersRequest request) -> (ACP::Types::Unstable::ListProvidersResponse | ACP::RequestError)
+
+  # @rbs request: ACP::Types::Unstable::SetProviderRequest
+  # @rbs return: (ACP::Types::Unstable::SetProviderResponse | ACP::RequestError)
+  def providers_set: (ACP::Types::Unstable::SetProviderRequest request) -> (ACP::Types::Unstable::SetProviderResponse | ACP::RequestError)
+
+  # @rbs request: ACP::Types::Unstable::DisableProviderRequest
+  # @rbs return: (ACP::Types::Unstable::DisableProviderResponse | ACP::RequestError)
+  def providers_disable: (ACP::Types::Unstable::DisableProviderRequest request) -> (ACP::Types::Unstable::DisableProviderResponse | ACP::RequestError)
+
   # The spec requires a pending session/request_permission to be answered with
   # the cancelled outcome once the turn is cancelled, so every queue registered
   # for the session gets one before this returns. The notification goes first
@@ -151,13 +173,40 @@ class ACP::ClientConnection
   # @rbs return: (Hash[String, untyped] | ACP::RequestError)
   def ext_request: (String method, ?untyped params) -> (Hash[String, untyped] | ACP::RequestError)
 
+  # Always false off a handler thread.
+  #
+  # @rbs return: bool
+  def cancelled?: () -> bool
+
   # @rbs method: String
   # @rbs params: untyped
   # @rbs return: void
   def ext_notify: (String method, ?untyped params) -> void
 
+  # Unlike the mcp/message serve route, this send is not gated: a notification
+  # has no reply to carry a refusal, and the agent drops what it did not
+  # advertise.
+  #
+  # @rbs notification: ACP::Types::Unstable::MessageMcpNotification
+  # @rbs return: void
+  def mcp_message_notification: (ACP::Types::Unstable::MessageMcpNotification notification) -> void
+
   private
 
+  # The route is only registered when a handler serves it, but the agent's
+  # advertisement is only known after connect, so an unadvertised request
+  # still reaches the route and is refused there.
+  #
+  # @rbs return: Hash[String, ACP::Transport::Stdio::_Handler]
+  def mcp_requests: () -> Hash[String, ACP::Transport::Stdio::_Handler]
+
+  # The stable McpCapabilities has no acp field, so the gate re-reads the raw
+  # initialize reply with the unstable types when they are opted into.
+  #
+  # @rbs result: (Hash[String, untyped] | ACP::RequestError)
+  # @rbs return: bool
+  def agent_mcp_advertised?: (Hash[String, untyped] | ACP::RequestError result) -> bool
+
   # @rbs type: ACP::AgentConnection::_Parser
   # @rbs result: (Hash[String, untyped] | ACP::RequestError)
   # @rbs return: untyped
@@ -237,6 +286,13 @@ class ACP::ClientConnection
   # @rbs return: (ACP::Types::ReleaseTerminalResponse | ACP::RequestError)
   def release_terminal: (untyped params) -> (ACP::Types::ReleaseTerminalResponse | ACP::RequestError)
 
+  # The route is registered at start, before connect records the agent's
+  # advertisement, so an unadvertised request answers -32601 until then.
+  #
+  # @rbs params: untyped
+  # @rbs return: (ACP::Types::Unstable::MessageMcpResponse::t | ACP::RequestError)
+  def mcp_message: (untyped params) -> (ACP::Types::Unstable::MessageMcpResponse::t | ACP::RequestError)
+
   # The routes are registered at start, before connect records the advertised
   # capabilities, so a request for an unadvertised mode answers -32602.
   #

data/sig/generated/acp/request_error.rbs

@@ -70,6 +70,14 @@ class ACP::RequestError
   # @rbs return: ACP::RequestError
   def self.unadvertised_mode: (String mode) -> ACP::RequestError
 
+  # unadvertised names a capability of the client's, this one a capability of
+  # the agent's: the same method-not-found code, with a message naming which
+  # side's advertisement is missing.
+  #
+  # @rbs capability: String
+  # @rbs return: ACP::RequestError
+  def self.unadvertised_agent: (String capability) -> ACP::RequestError
+
   # @rbs return: ACP::RequestError
   def self.internal_error: () -> ACP::RequestError
 

data/sig/generated/acp/transport/cancellation.rbs

@@ -0,0 +1,32 @@
+# Generated from lib/acp/transport/cancellation.rb with RBS::Inline
+
+# Whether the peer cancelled one request. The transport creates one per served
+# request, marks it when the peer's $/cancel_request arrives, and hands it to
+# the serving thread, whose handler can observe it and end the request early.
+class ACP::Transport::Cancellation
+  KEY: Symbol
+
+  # Connections read this to expose the serving state to their handlers and
+  # write it to carry serving identity onto a thread they spawn; nil off a
+  # serve thread.
+  #
+  # @rbs return: ACP::Transport::Cancellation?
+  def self.current: () -> ACP::Transport::Cancellation?
+
+  # @rbs cancellation: ACP::Transport::Cancellation?
+  # @rbs return: void
+  def self.current=: (ACP::Transport::Cancellation? cancellation) -> void
+
+  @lock: Thread::Mutex
+
+  @cancelled: bool
+
+  # @rbs return: void
+  def initialize: () -> void
+
+  # @rbs return: void
+  def cancel: () -> void
+
+  # @rbs return: bool
+  def cancelled?: () -> bool
+end