acp-sdk 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b7ee3b18dbb3a538b575c1b3309f93bd84eab3566e4491d39646dde8f0114ff6
-  data.tar.gz: ef1b3bed3a05dea92f076f4ed67e8378a3893d522db9ffe76ad445810b5fb20e
+  metadata.gz: 4fcba010891683b66eaf2fd2ae8bf9ae27e2aeb13b76666cc8c4478dfb7c4e9a
+  data.tar.gz: 5045a772ca2f080a7566ad3556a16087b3d15f4cbd39c3ed0ee5ae4dfe0ab521
 SHA512:
-  metadata.gz: 69232d2be95232917e3f3c25c0eb890cbb2367069378e4ec415765a9606740da333b32631d3430c42fd7b5691b434329ef1ff2f6a0c19433d5149837bf4880d9
-  data.tar.gz: 256d27b3b35c9e6e569fe60098885fa878fa6e7df06ffed8330c58d5b611f198a796df6928a62c6f8c2df01e4628312e5a6408efab669511dc4a402a8ab7b6e8
+  metadata.gz: c1a7eb1a2fc03be127272d8e3a97564c014691d1b582bd317f1da7b7022f250d603a09a811ef1271a9133e2bcf2fa5a6c7cde1f7d7ffe8c08a1f37fa28080d71
+  data.tar.gz: 4d006a52359dfdde15978220b83b9d7b10251b44c73a66c43be7a4259c0646a559b39ee05b09b1010e6b0108a95945751ad2cf0ffea4c6f9f1be041a0d4efbfa

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [0.2.0](https://github.com/bottrall/acp-sdk/compare/v0.1.0...v0.2.0) (2026-09-30)
+
+
+### Features
+
+* authenticate on ACP::AgentConnection ([#23](https://github.com/bottrall/acp-sdk/issues/23)) ([aac2bdd](https://github.com/bottrall/acp-sdk/commit/aac2bddbada2108bad3397d8f2c7bcdd617e8e0f))
+* filesystem methods on ACP::AgentConnection::Client ([#20](https://github.com/bottrall/acp-sdk/issues/20)) ([a15d942](https://github.com/bottrall/acp-sdk/commit/a15d942d1fe48cd7042732f64ea6d94cdd191549)), closes [#10](https://github.com/bottrall/acp-sdk/issues/10)
+* optional session methods on ACP::AgentConnection ([#24](https://github.com/bottrall/acp-sdk/issues/24)) ([952f906](https://github.com/bottrall/acp-sdk/commit/952f906e32bf455bac40effeb3d32fa6dea95904))
+* terminal methods on ACP::AgentConnection::Client ([#22](https://github.com/bottrall/acp-sdk/issues/22)) ([b4108b8](https://github.com/bottrall/acp-sdk/commit/b4108b8570a36d78a2c1231c04f7c1f697848318))
+
 ## 0.1.0 (2026-09-30)
 
 

data/README.md

@@ -1,20 +1,43 @@
 # acp-sdk
 
-A standalone Ruby implementation of the [Agent Client Protocol](https://agentclientprotocol.com) (ACP): the agent side (`ACP::AgentConnection`), for exposing an agent to ACP clients such as Zed and JetBrains, and the client side (`ACP::ClientConnection`), for driving ACP agents from Ruby.
+[![Gem Version](https://badge.fury.io/rb/acp-sdk.svg)](https://rubygems.org/gems/acp-sdk)
 
-Namespace `ACP`. MIT licensed.
+A Ruby SDK for the [Agent Client Protocol](https://agentclientprotocol.com) (ACP). It covers both sides of the protocol:
 
-## Status
+- **Agent side** (`ACP::AgentConnection`): expose your agent to ACP clients such as Zed and JetBrains.
+- **Client side** (`ACP::ClientConnection`): drive ACP agents from Ruby, for an editor integration or for tests.
 
-Intent only. Nothing is published yet; the `acp-sdk` gem name is claimed at the first release.
+Every ACP request, response and notification is a generated Ruby class under `ACP::Types`, and messages travel as JSON-RPC over stdio. The SDK speaks ACP protocol version 1.
 
-This repo exists so that [riffer-rig](https://github.com/bottrall/riffer-rig) can depend on it for its `riffer acp` host. Scope for the first release: JSON-RPC over stdio, `mcpServers` and `available_commands` in, permission requests and filesystem methods out.
+## Installation
+
+Requires Ruby 4.0 or later.
+
+Add the gem to your Gemfile:
+
+```sh
+bundle add acp-sdk
+```
+
+Or install it directly:
+
+```sh
+gem install acp-sdk
+```
+
+Then require it:
+
+```ruby
+require 'acp/sdk'
+```
 
 ## Serving an agent
 
-An agent is a plain Ruby object. `ACP::AgentConnection` answers `initialize` itself, turns each request into its generated `ACP::Types` object, calls the agent, and sends back what it returns. The factory block receives an `ACP::AgentConnection::Client` handle, which the agent keeps for sending session updates and asking permission. [`examples/echo_agent.rb`](examples/echo_agent.rb) is a complete agent; `ruby examples/echo_agent.rb` serves it on stdio.
+An agent is a plain Ruby object. `ACP::AgentConnection` answers `initialize` itself, turns each request into its generated `ACP::Types` object, calls the agent, and sends back what it returns. The factory block receives an `ACP::AgentConnection::Client` handle, which the agent keeps for sending session updates, asking permission, reading and writing files, and running commands in terminals.
 
 ```ruby
+require 'acp/sdk'
+
 connection = ACP::AgentConnection.new(
   transport: ACP::Transport::Stdio.new(input: $stdin, output: $stdout),
   capabilities: ACP::Types::AgentCapabilities.new(load_session: true),
@@ -25,18 +48,25 @@ connection.start.join
 
 The agent's contract:
 
-- It defines `new_session`, `prompt` and `cancel`. `load_session` and `list_sessions` are required only when `capabilities` advertises `load_session` or `session_capabilities.list`; `start` raises `ArgumentError` when one is advertised but missing, and a method that is not advertised is answered with `-32601`. `session_created`, if defined, runs right after the `session/new` reply is sent.
+- It defines `new_session`, `prompt` and `cancel`. `load_session`, `list_sessions`, `resume_session`, `close_session` and `delete_session` are required only when `capabilities` advertises `load_session` or `session_capabilities.list`, `.resume`, `.close` or `.delete`, and `authenticate` only when `auth_methods` is non-empty; `start` raises `ArgumentError` when one is advertised but missing, and a method that is not advertised is answered with `-32601`. `change_session_mode` and `change_session_config_option` are optional, since modes and config options are offered per session rather than in `initialize`; `session/set_mode` and `session/set_config_option` are answered with `-32601` when the agent does not define them. `session_created`, if defined, runs right after the `session/new` reply is sent.
 - Each request method returns its response type or an `ACP::Transport::ResponseError`, which is sent as the error reply. Params that do not match the schema are answered with `-32602` before the agent sees them.
 - `cancel` runs on the transport's reader thread, so it must return quickly: set a flag and let the prompt notice it.
 - After a cancel, the agent must itself end the turn with `stopReason: cancelled`. `ACP::AgentConnection` does not enforce it.
 - `client.capabilities` is `nil` until the client sends `initialize`.
+- `client.read_text_file` and `client.write_text_file` take an `ACP::Types::ReadTextFileRequest` or `ACP::Types::WriteTextFileRequest` and return the response type or an `ACP::Transport::ResponseError`. Unless `client.capabilities` advertises `fs.read_text_file` or `fs.write_text_file`, they return `-32601` without sending anything to the client.
+- `client.create_terminal`, `client.terminal_output`, `client.wait_for_terminal_exit`, `client.kill_terminal` and `client.release_terminal` take the matching `ACP::Types` request (`CreateTerminalRequest`, `TerminalOutputRequest`, `WaitForTerminalExitRequest`, `KillTerminalRequest`, `ReleaseTerminalRequest`) and return its response type or an `ACP::Transport::ResponseError`. Unless `client.capabilities` advertises `terminal`, they return `-32601` without sending anything to the client. The agent must release every terminal it creates.
+
+[`examples/echo_agent.rb`](https://github.com/bottrall/acp-sdk/blob/main/examples/echo_agent.rb) is a complete agent that streams updates, asks permission, handles cancellation, reads and writes files and runs commands through the client (`/read <path>`, `/write <path> <text>` and `/run <command> [args]`, each advertised as a slash command only when the client supports it), and supports `session/load` and `session/list`.
 
 ## Driving an agent
 
-`ACP::ClientConnection` is the other side of the same transport, for editors and for tests that drive an agent. Each method takes the request's generated `ACP::Types` object and returns its response type or the agent's `ACP::Transport::ResponseError`. `connect` sends `initialize`, which Ruby reserves for the constructor.
+`ACP::ClientConnection` is the other side of the same transport. Each method takes the request's generated `ACP::Types` object and returns its response type or the agent's `ACP::Transport::ResponseError`. `connect` sends `initialize`, since Ruby reserves that name for the constructor.
 
 ```ruby
-stdin, stdout, = Open3.popen2('ruby', 'examples/echo_agent.rb')
+require 'acp/sdk'
+require 'open3'
+
+stdin, stdout, = Open3.popen2('my-agent')
 connection = ACP::ClientConnection.new(
   transport: ACP::Transport::Stdio.new(input: stdout, output: stdin),
   permission: ->(request) { ask_the_user(request) },
@@ -54,28 +84,10 @@ end
 - `session_prompt` and `session_load` yield the session's updates on the calling thread as they arrive and return once the agent replies. Updates outside those calls, such as the available commands after `session/new`, go to `updates`, which runs on the reader thread and must return quickly.
 - `permission` answers `session/request_permission` with an `ACP::Types::RequestPermissionResponse` or an `ACP::Transport::ResponseError`. It runs on its own thread, so it may block while the user decides, and `session_cancel` can be sent meanwhile.
 
-## Development
-
-Every project chore is a script in `bin/`. The Rakefile behind them is an implementation detail; you never need to call rake directly.
-
-| Script          | What it does                                                                                   |
-| --------------- | ---------------------------------------------------------------------------------------------- |
-| `bin/setup`     | Install dependencies on a fresh checkout (gems + rbs collection)                               |
-| `bin/test`      | Run the test suite. Pass files and/or Minitest flags: `bin/test test/foo_test.rb -n /pattern/` |
-| `bin/lint`      | Run RuboCop. Arguments are forwarded, e.g. `bin/lint -a`                                       |
-| `bin/typecheck` | Check `lib/acp/types`, the rbs collection lockfile and `sig/generated` are current, then type-check with Steep |
-| `bin/rbs`       | Regenerate `sig/generated` from the inline annotations in `lib/`                               |
-| `bin/types`     | Regenerate `lib/acp/types` from `schema/schema.json`, then `sig/generated`                     |
-| `bin/rbs-watch` | Regenerate `sig/generated` whenever `lib/` changes                                             |
-| `bin/ci`        | Run everything CI runs, serially. Use before pushing                                           |
-| `bin/build`     | Build the gem into `pkg/`; the publish workflow runs this before `gem push`                    |
-
-## Releasing
-
-PR titles are [conventional commits](https://www.conventionalcommits.org/) and are linted in CI: `feat:` bumps the minor version, `fix:` bumps the patch, and `feat!:` marks a breaking change (also a minor bump while we are on 0.x). `chore:`, `docs:`, `ci:`, `refactor:` and `test:` never release. Squash-merging makes the title the commit on `main`.
+## Contributing
 
-[release-please](https://github.com/googleapis/release-please) keeps a release PR open that bumps `lib/acp/version.rb` and writes `CHANGELOG.md`. Merging that PR tags `vX.Y.Z`, creates the GitHub Release and publishes the gem to RubyGems.org through Trusted Publishing; nothing is pushed by hand. The first release is 0.1.0.
+Bug reports and pull requests are welcome on [GitHub](https://github.com/bottrall/acp-sdk). See [CONTRIBUTING.md](CONTRIBUTING.md) for setup and workflow. Everyone interacting in the project is expected to follow the [code of conduct](CODE_OF_CONDUCT.md).
 
-## Maintainer
+## License
 
-- Jake Bottrall - https://github.com/bottrall
+Released under the [MIT License](LICENSE.txt).

data/lib/acp/agent_connection/client.rb

@@ -33,7 +33,73 @@ class ACP::AgentConnection::Client
   # @rbs request: ACP::Types::RequestPermissionRequest
   # @rbs return: ACP::Types::RequestPermissionResponse | ACP::Transport::ResponseError
   def request_permission(request)
-    result = @peer.request('session/request_permission', request.to_h)
-    result.error || ACP::Types::RequestPermissionResponse.from_h(result.value)
+    call('session/request_permission', ACP::Types::RequestPermissionResponse, request)
+  end
+
+  # @rbs request: ACP::Types::ReadTextFileRequest
+  # @rbs return: ACP::Types::ReadTextFileResponse | ACP::Transport::ResponseError
+  def read_text_file(request)
+    return ACP::Transport::Stdio::METHOD_NOT_FOUND unless capabilities&.fs&.read_text_file
+
+    call('fs/read_text_file', ACP::Types::ReadTextFileResponse, request)
+  end
+
+  # @rbs request: ACP::Types::WriteTextFileRequest
+  # @rbs return: ACP::Types::WriteTextFileResponse | ACP::Transport::ResponseError
+  def write_text_file(request)
+    return ACP::Transport::Stdio::METHOD_NOT_FOUND unless capabilities&.fs&.write_text_file
+
+    call('fs/write_text_file', ACP::Types::WriteTextFileResponse, request)
+  end
+
+  # @rbs request: ACP::Types::CreateTerminalRequest
+  # @rbs return: ACP::Types::CreateTerminalResponse | ACP::Transport::ResponseError
+  def create_terminal(request)
+    terminal_call('terminal/create', ACP::Types::CreateTerminalResponse, request)
+  end
+
+  # @rbs request: ACP::Types::TerminalOutputRequest
+  # @rbs return: ACP::Types::TerminalOutputResponse | ACP::Transport::ResponseError
+  def terminal_output(request)
+    terminal_call('terminal/output', ACP::Types::TerminalOutputResponse, request)
+  end
+
+  # @rbs request: ACP::Types::WaitForTerminalExitRequest
+  # @rbs return: ACP::Types::WaitForTerminalExitResponse | ACP::Transport::ResponseError
+  def wait_for_terminal_exit(request)
+    terminal_call('terminal/wait_for_exit', ACP::Types::WaitForTerminalExitResponse, request)
+  end
+
+  # @rbs request: ACP::Types::KillTerminalRequest
+  # @rbs return: ACP::Types::KillTerminalResponse | ACP::Transport::ResponseError
+  def kill_terminal(request)
+    terminal_call('terminal/kill', ACP::Types::KillTerminalResponse, request)
+  end
+
+  # @rbs request: ACP::Types::ReleaseTerminalRequest
+  # @rbs return: ACP::Types::ReleaseTerminalResponse | ACP::Transport::ResponseError
+  def release_terminal(request)
+    terminal_call('terminal/release', ACP::Types::ReleaseTerminalResponse, request)
+  end
+
+  private
+
+  # @rbs rpc_method: String
+  # @rbs type: ACP::AgentConnection::_Parser
+  # @rbs request: ACP::AgentConnection::_Response
+  # @rbs return: untyped
+  def call(rpc_method, type, request)
+    result = @peer.request(rpc_method, request.to_h)
+    result.error || type.from_h(result.value)
+  end
+
+  # @rbs rpc_method: String
+  # @rbs type: ACP::AgentConnection::_Parser
+  # @rbs request: ACP::AgentConnection::_Response
+  # @rbs return: untyped
+  def terminal_call(rpc_method, type, request)
+    return ACP::Transport::Stdio::METHOD_NOT_FOUND unless capabilities&.terminal
+
+    call(rpc_method, type, request)
   end
 end

data/lib/acp/agent_connection/optional_method/authenticate.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module ACP::AgentConnection::OptionalMethod::Authenticate
+  extend self
+
+  # @rbs return: String
+  def rpc_method
+    'authenticate'
+  end
+
+  # @rbs return: Symbol
+  def agent_method
+    :authenticate
+  end
+
+  # @rbs initialize_response: ACP::Types::InitializeResponse
+  # @rbs return: bool
+  def advertised?(initialize_response)
+    initialize_response.auth_methods&.any? || false
+  end
+end

data/lib/acp/agent_connection/optional_method/close_session.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module ACP::AgentConnection::OptionalMethod::CloseSession
+  extend self
+
+  # @rbs return: String
+  def rpc_method
+    'session/close'
+  end
+
+  # @rbs return: Symbol
+  def agent_method
+    :close_session
+  end
+
+  # @rbs initialize_response: ACP::Types::InitializeResponse
+  # @rbs return: bool
+  def advertised?(initialize_response)
+    initialize_response.agent_capabilities&.session_capabilities&.close ? true : false
+  end
+end

data/lib/acp/agent_connection/optional_method/delete_session.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module ACP::AgentConnection::OptionalMethod::DeleteSession
+  extend self
+
+  # @rbs return: String
+  def rpc_method
+    'session/delete'
+  end
+
+  # @rbs return: Symbol
+  def agent_method
+    :delete_session
+  end
+
+  # @rbs initialize_response: ACP::Types::InitializeResponse
+  # @rbs return: bool
+  def advertised?(initialize_response)
+    initialize_response.agent_capabilities&.session_capabilities&.delete ? true : false
+  end
+end

data/lib/acp/agent_connection/optional_method/list_sessions.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module ACP::AgentConnection::OptionalMethod::ListSessions
+  extend self
+
+  # @rbs return: String
+  def rpc_method
+    'session/list'
+  end
+
+  # @rbs return: Symbol
+  def agent_method
+    :list_sessions
+  end
+
+  # @rbs initialize_response: ACP::Types::InitializeResponse
+  # @rbs return: bool
+  def advertised?(initialize_response)
+    initialize_response.agent_capabilities&.session_capabilities&.list ? true : false
+  end
+end

data/lib/acp/agent_connection/optional_method/load_session.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module ACP::AgentConnection::OptionalMethod::LoadSession
+  extend self
+
+  # @rbs return: String
+  def rpc_method
+    'session/load'
+  end
+
+  # @rbs return: Symbol
+  def agent_method
+    :load_session
+  end
+
+  # @rbs initialize_response: ACP::Types::InitializeResponse
+  # @rbs return: bool
+  def advertised?(initialize_response)
+    initialize_response.agent_capabilities&.load_session ? true : false
+  end
+end

data/lib/acp/agent_connection/optional_method/resume_session.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module ACP::AgentConnection::OptionalMethod::ResumeSession
+  extend self
+
+  # @rbs return: String
+  def rpc_method
+    'session/resume'
+  end
+
+  # @rbs return: Symbol
+  def agent_method
+    :resume_session
+  end
+
+  # @rbs initialize_response: ACP::Types::InitializeResponse
+  # @rbs return: bool
+  def advertised?(initialize_response)
+    initialize_response.agent_capabilities&.session_capabilities&.resume ? true : false
+  end
+end

data/lib/acp/agent_connection/optional_method.rb

@@ -1,28 +1,4 @@
 # frozen_string_literal: true
 
-class ACP::AgentConnection::OptionalMethod
-  # @rbs @capability: ^(ACP::Types::AgentCapabilities) -> boolish
-
-  # @dynamic rpc_method
-  attr_reader :rpc_method #: String
-
-  # @dynamic agent_method
-  attr_reader :agent_method #: Symbol
-
-  # @rbs rpc_method: String
-  # @rbs agent_method: Symbol
-  # @rbs &capability: (ACP::Types::AgentCapabilities) -> boolish
-  # @rbs return: void
-  def initialize(rpc_method:, agent_method:, &capability)
-    @rpc_method = rpc_method
-    @agent_method = agent_method
-    @capability = capability
-    freeze
-  end
-
-  # @rbs capabilities: ACP::Types::AgentCapabilities
-  # @rbs return: bool
-  def advertised?(capabilities)
-    @capability.call(capabilities) ? true : false
-  end
+module ACP::AgentConnection::OptionalMethod
 end

data/lib/acp/agent_connection.rb

@@ -2,19 +2,26 @@
 
 class ACP::AgentConnection
   # @rbs @transport: ACP::AgentConnection::_Transport
-  # @rbs @capabilities: ACP::Types::AgentCapabilities
-  # @rbs @agent_info: ACP::Types::Implementation?
-  # @rbs @auth_methods: Array[ACP::Types::AuthMethod::t]
+  # @rbs @initialize_response: ACP::Types::InitializeResponse
   # @rbs @factory: ^(ACP::AgentConnection::Client) -> ACP::AgentConnection::_Agent
 
   PROTOCOL_VERSION = 1 #: Integer
   INVALID_PARAMS = ACP::Transport::ResponseError.new(code: -32_602, message: 'Invalid params') #: ACP::Transport::ResponseError
   OPTIONAL = [
-    ACP::AgentConnection::OptionalMethod.new(rpc_method: 'session/load', agent_method: :load_session, &:load_session),
-    ACP::AgentConnection::OptionalMethod.new(rpc_method: 'session/list', agent_method: :list_sessions) do |capabilities|
-      capabilities.session_capabilities&.list
-    end
-  ].freeze #: Array[ACP::AgentConnection::OptionalMethod]
+    ACP::AgentConnection::OptionalMethod::LoadSession,
+    ACP::AgentConnection::OptionalMethod::ListSessions,
+    ACP::AgentConnection::OptionalMethod::Authenticate,
+    ACP::AgentConnection::OptionalMethod::ResumeSession,
+    ACP::AgentConnection::OptionalMethod::CloseSession,
+    ACP::AgentConnection::OptionalMethod::DeleteSession
+  ].freeze #: Array[ACP::AgentConnection::_OptionalMethod]
+  # The schema has no initialize capability for modes or config options: an
+  # agent offers them per session, in its session responses, so they are
+  # routed whenever the agent defines them.
+  PER_SESSION = {
+    'session/set_mode' => :change_session_mode,
+    'session/set_config_option' => :change_session_config_option
+  }.freeze #: Hash[String, Symbol]
 
   # @rbs transport: ACP::AgentConnection::_Transport
   # @rbs capabilities: ACP::Types::AgentCapabilities
@@ -24,9 +31,12 @@ class ACP::AgentConnection
   # @rbs return: void
   def initialize(transport:, capabilities:, agent_info: nil, auth_methods: [], &factory)
     @transport = transport
-    @capabilities = capabilities
-    @agent_info = agent_info
-    @auth_methods = auth_methods
+    @initialize_response = ACP::Types::InitializeResponse.new(
+      protocol_version: PROTOCOL_VERSION,
+      agent_capabilities: capabilities,
+      auth_methods:,
+      agent_info:
+    )
     @factory = factory
   end
 
@@ -34,11 +44,11 @@ class ACP::AgentConnection
   def start
     client = ACP::AgentConnection::Client.new(peer: @transport)
     agent = @factory.call(client)
-    advertised, unadvertised = OPTIONAL.partition { |method| method.advertised?(@capabilities) }
+    advertised, unadvertised = OPTIONAL.partition { |method| method.advertised?(@initialize_response) }
     missing = advertised.map(&:agent_method).reject { |name| agent.respond_to?(name) }
-    raise ArgumentError, "capabilities advertise methods the agent lacks: #{missing.join(', ')}" unless missing.empty?
+    raise ArgumentError, "initialize advertises methods the agent lacks: #{missing.join(', ')}" unless missing.empty?
 
-    unrouted = unadvertised.map(&:rpc_method)
+    unrouted = unadvertised.map(&:rpc_method) + PER_SESSION.reject { |_, name| agent.respond_to?(name) }.keys
     @transport.start(requests: requests(agent, client).except(*unrouted), notifications: notifications(agent))
   end
 
@@ -48,15 +58,25 @@ class ACP::AgentConnection
   # @rbs client: ACP::AgentConnection::Client
   # @rbs return: Hash[String, ^(untyped) -> (ACP::Transport::Result | ACP::Transport::Reply)]
   def requests(agent, client)
-    # Safe: start drops the load/list handlers the capabilities do not
-    # advertise and checks the agent defines the rest.
-    full = agent #: ACP::AgentConnection::_Agent & ACP::AgentConnection::_LoadSession & ACP::AgentConnection::_ListSessions
+    # Safe: start drops the optional handlers initialize does not advertise
+    # or the agent does not define, and checks the agent defines the rest.
+    full = agent #: ACP::AgentConnection::_FullAgent
     {
       'initialize' => route(ACP::Types::InitializeRequest) { |request| connect(client, request) },
+      'authenticate' => route(ACP::Types::AuthenticateRequest) { |request| respond(full.authenticate(request)) },
       'session/new' => route(ACP::Types::NewSessionRequest) { |request| new_session(agent, request) },
       'session/prompt' => route(ACP::Types::PromptRequest) { |request| respond(agent.prompt(request)) },
       'session/load' => route(ACP::Types::LoadSessionRequest) { |request| respond(full.load_session(request)) },
-      'session/list' => route(ACP::Types::ListSessionsRequest) { |request| respond(full.list_sessions(request)) }
+      'session/list' => route(ACP::Types::ListSessionsRequest) { |request| respond(full.list_sessions(request)) },
+      'session/resume' => route(ACP::Types::ResumeSessionRequest) { |request| respond(full.resume_session(request)) },
+      'session/close' => route(ACP::Types::CloseSessionRequest) { |request| respond(full.close_session(request)) },
+      'session/delete' => route(ACP::Types::DeleteSessionRequest) { |request| respond(full.delete_session(request)) },
+      'session/set_mode' => route(ACP::Types::SetSessionModeRequest) do |request|
+        respond(full.change_session_mode(request))
+      end,
+      'session/set_config_option' => route(ACP::Types::SetSessionConfigOptionRequest) do |request|
+        respond(full.change_session_config_option(request))
+      end
     }
   end
 
@@ -95,14 +115,7 @@ class ACP::AgentConnection
   # @rbs return: ACP::Transport::Result
   def connect(client, request)
     client.capabilities = request.client_capabilities || ACP::Types::ClientCapabilities.new
-    respond(
-      ACP::Types::InitializeResponse.new(
-        protocol_version: PROTOCOL_VERSION,
-        agent_capabilities: @capabilities,
-        auth_methods: @auth_methods,
-        agent_info: @agent_info
-      )
-    )
+    respond(@initialize_response)
   end
 
   # session_created runs after the reply because the client must know the

data/lib/acp/types.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+module ACP::Types
+end

data/lib/acp/version.rb

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

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

@@ -26,4 +26,46 @@ class ACP::AgentConnection::Client
   # @rbs request: ACP::Types::RequestPermissionRequest
   # @rbs return: ACP::Types::RequestPermissionResponse | ACP::Transport::ResponseError
   def request_permission: (ACP::Types::RequestPermissionRequest request) -> (ACP::Types::RequestPermissionResponse | ACP::Transport::ResponseError)
+
+  # @rbs request: ACP::Types::ReadTextFileRequest
+  # @rbs return: ACP::Types::ReadTextFileResponse | ACP::Transport::ResponseError
+  def read_text_file: (ACP::Types::ReadTextFileRequest request) -> (ACP::Types::ReadTextFileResponse | ACP::Transport::ResponseError)
+
+  # @rbs request: ACP::Types::WriteTextFileRequest
+  # @rbs return: ACP::Types::WriteTextFileResponse | ACP::Transport::ResponseError
+  def write_text_file: (ACP::Types::WriteTextFileRequest request) -> (ACP::Types::WriteTextFileResponse | ACP::Transport::ResponseError)
+
+  # @rbs request: ACP::Types::CreateTerminalRequest
+  # @rbs return: ACP::Types::CreateTerminalResponse | ACP::Transport::ResponseError
+  def create_terminal: (ACP::Types::CreateTerminalRequest request) -> (ACP::Types::CreateTerminalResponse | ACP::Transport::ResponseError)
+
+  # @rbs request: ACP::Types::TerminalOutputRequest
+  # @rbs return: ACP::Types::TerminalOutputResponse | ACP::Transport::ResponseError
+  def terminal_output: (ACP::Types::TerminalOutputRequest request) -> (ACP::Types::TerminalOutputResponse | ACP::Transport::ResponseError)
+
+  # @rbs request: ACP::Types::WaitForTerminalExitRequest
+  # @rbs return: ACP::Types::WaitForTerminalExitResponse | ACP::Transport::ResponseError
+  def wait_for_terminal_exit: (ACP::Types::WaitForTerminalExitRequest request) -> (ACP::Types::WaitForTerminalExitResponse | ACP::Transport::ResponseError)
+
+  # @rbs request: ACP::Types::KillTerminalRequest
+  # @rbs return: ACP::Types::KillTerminalResponse | ACP::Transport::ResponseError
+  def kill_terminal: (ACP::Types::KillTerminalRequest request) -> (ACP::Types::KillTerminalResponse | ACP::Transport::ResponseError)
+
+  # @rbs request: ACP::Types::ReleaseTerminalRequest
+  # @rbs return: ACP::Types::ReleaseTerminalResponse | ACP::Transport::ResponseError
+  def release_terminal: (ACP::Types::ReleaseTerminalRequest request) -> (ACP::Types::ReleaseTerminalResponse | ACP::Transport::ResponseError)
+
+  private
+
+  # @rbs rpc_method: String
+  # @rbs type: ACP::AgentConnection::_Parser
+  # @rbs request: ACP::AgentConnection::_Response
+  # @rbs return: untyped
+  def call: (String rpc_method, ACP::AgentConnection::_Parser type, ACP::AgentConnection::_Response request) -> untyped
+
+  # @rbs rpc_method: String
+  # @rbs type: ACP::AgentConnection::_Parser
+  # @rbs request: ACP::AgentConnection::_Response
+  # @rbs return: untyped
+  def terminal_call: (String rpc_method, ACP::AgentConnection::_Parser type, ACP::AgentConnection::_Response request) -> untyped
 end

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

@@ -0,0 +1,13 @@
+# Generated from lib/acp/agent_connection/optional_method/authenticate.rb with RBS::Inline
+
+module ACP::AgentConnection::OptionalMethod::Authenticate
+  # @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/close_session.rbs

@@ -0,0 +1,13 @@
+# Generated from lib/acp/agent_connection/optional_method/close_session.rb with RBS::Inline
+
+module ACP::AgentConnection::OptionalMethod::CloseSession
+  # @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/delete_session.rbs

@@ -0,0 +1,13 @@
+# Generated from lib/acp/agent_connection/optional_method/delete_session.rb with RBS::Inline
+
+module ACP::AgentConnection::OptionalMethod::DeleteSession
+  # @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_sessions.rbs

@@ -0,0 +1,13 @@
+# Generated from lib/acp/agent_connection/optional_method/list_sessions.rb with RBS::Inline
+
+module ACP::AgentConnection::OptionalMethod::ListSessions
+  # @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/load_session.rbs

@@ -0,0 +1,13 @@
+# Generated from lib/acp/agent_connection/optional_method/load_session.rb with RBS::Inline
+
+module ACP::AgentConnection::OptionalMethod::LoadSession
+  # @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/resume_session.rbs

@@ -0,0 +1,13 @@
+# Generated from lib/acp/agent_connection/optional_method/resume_session.rb with RBS::Inline
+
+module ACP::AgentConnection::OptionalMethod::ResumeSession
+  # @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.rbs

@@ -1,21 +1,4 @@
 # Generated from lib/acp/agent_connection/optional_method.rb with RBS::Inline
 
-class ACP::AgentConnection::OptionalMethod
-  @capability: ^(ACP::Types::AgentCapabilities) -> boolish
-
-  # @dynamic rpc_method
-  attr_reader rpc_method: String
-
-  # @dynamic agent_method
-  attr_reader agent_method: Symbol
-
-  # @rbs rpc_method: String
-  # @rbs agent_method: Symbol
-  # @rbs &capability: (ACP::Types::AgentCapabilities) -> boolish
-  # @rbs return: void
-  def initialize: (rpc_method: String, agent_method: Symbol) { (ACP::Types::AgentCapabilities) -> boolish } -> void
-
-  # @rbs capabilities: ACP::Types::AgentCapabilities
-  # @rbs return: bool
-  def advertised?: (ACP::Types::AgentCapabilities capabilities) -> bool
+module ACP::AgentConnection::OptionalMethod
 end

data/sig/generated/acp/agent_connection.rbs

@@ -1,21 +1,22 @@
 # Generated from lib/acp/agent_connection.rb with RBS::Inline
 
 class ACP::AgentConnection
-  @factory: ^(ACP::AgentConnection::Client) -> ACP::AgentConnection::_Agent
-
-  @auth_methods: Array[ACP::Types::AuthMethod::t]
-
-  @agent_info: ACP::Types::Implementation?
+  @transport: ACP::AgentConnection::_Transport
 
-  @capabilities: ACP::Types::AgentCapabilities
+  @initialize_response: ACP::Types::InitializeResponse
 
-  @transport: ACP::AgentConnection::_Transport
+  @factory: ^(ACP::AgentConnection::Client) -> ACP::AgentConnection::_Agent
 
   PROTOCOL_VERSION: Integer
 
   INVALID_PARAMS: ACP::Transport::ResponseError
 
-  OPTIONAL: Array[ACP::AgentConnection::OptionalMethod]
+  OPTIONAL: Array[ACP::AgentConnection::_OptionalMethod]
+
+  # The schema has no initialize capability for modes or config options: an
+  # agent offers them per session, in its session responses, so they are
+  # routed whenever the agent defines them.
+  PER_SESSION: Hash[String, Symbol]
 
   # @rbs transport: ACP::AgentConnection::_Transport
   # @rbs capabilities: ACP::Types::AgentCapabilities

data/sig/generated/acp/types.rbs

@@ -0,0 +1,4 @@
+# Generated from lib/acp/types.rb with RBS::Inline
+
+module ACP::Types
+end

data/sig/manual/acp/agent_connection/optional_method/authenticate.rbs

@@ -0,0 +1,6 @@
+# rbs-inline does not emit `extend self`, so without this reopen the module's
+# methods aren't visible as singleton methods.
+
+module ACP::AgentConnection::OptionalMethod::Authenticate
+  extend ::ACP::AgentConnection::OptionalMethod::Authenticate
+end

data/sig/manual/acp/agent_connection/optional_method/close_session.rbs

@@ -0,0 +1,6 @@
+# rbs-inline does not emit `extend self`, so without this reopen the module's
+# methods aren't visible as singleton methods.
+
+module ACP::AgentConnection::OptionalMethod::CloseSession
+  extend ::ACP::AgentConnection::OptionalMethod::CloseSession
+end

data/sig/manual/acp/agent_connection/optional_method/delete_session.rbs

@@ -0,0 +1,6 @@
+# rbs-inline does not emit `extend self`, so without this reopen the module's
+# methods aren't visible as singleton methods.
+
+module ACP::AgentConnection::OptionalMethod::DeleteSession
+  extend ::ACP::AgentConnection::OptionalMethod::DeleteSession
+end

data/sig/manual/acp/agent_connection/optional_method/list_sessions.rbs

@@ -0,0 +1,6 @@
+# rbs-inline does not emit `extend self`, so without this reopen the module's
+# methods aren't visible as singleton methods.
+
+module ACP::AgentConnection::OptionalMethod::ListSessions
+  extend ::ACP::AgentConnection::OptionalMethod::ListSessions
+end

data/sig/manual/acp/agent_connection/optional_method/load_session.rbs

@@ -0,0 +1,6 @@
+# rbs-inline does not emit `extend self`, so without this reopen the module's
+# methods aren't visible as singleton methods.
+
+module ACP::AgentConnection::OptionalMethod::LoadSession
+  extend ::ACP::AgentConnection::OptionalMethod::LoadSession
+end

data/sig/manual/acp/agent_connection/optional_method/resume_session.rbs

@@ -0,0 +1,6 @@
+# rbs-inline does not emit `extend self`, so without this reopen the module's
+# methods aren't visible as singleton methods.
+
+module ACP::AgentConnection::OptionalMethod::ResumeSession
+  extend ::ACP::AgentConnection::OptionalMethod::ResumeSession
+end

data/sig/manual/acp/agent_connection.rbs

@@ -16,6 +16,48 @@ class ACP::AgentConnection
     def list_sessions: (ACP::Types::ListSessionsRequest) -> (ACP::Types::ListSessionsResponse | ACP::Transport::ResponseError)
   end
 
+  interface _Authenticate
+    def authenticate: (ACP::Types::AuthenticateRequest) -> (ACP::Types::AuthenticateResponse | ACP::Transport::ResponseError)
+  end
+
+  interface _ResumeSession
+    def resume_session: (ACP::Types::ResumeSessionRequest) -> (ACP::Types::ResumeSessionResponse | ACP::Transport::ResponseError)
+  end
+
+  interface _CloseSession
+    def close_session: (ACP::Types::CloseSessionRequest) -> (ACP::Types::CloseSessionResponse | ACP::Transport::ResponseError)
+  end
+
+  interface _DeleteSession
+    def delete_session: (ACP::Types::DeleteSessionRequest) -> (ACP::Types::DeleteSessionResponse | ACP::Transport::ResponseError)
+  end
+
+  interface _ChangeSessionMode
+    def change_session_mode: (ACP::Types::SetSessionModeRequest) -> (ACP::Types::SetSessionModeResponse | ACP::Transport::ResponseError)
+  end
+
+  interface _ChangeSessionConfigOption
+    def change_session_config_option: (ACP::Types::SetSessionConfigOptionRequest) -> (ACP::Types::SetSessionConfigOptionResponse | ACP::Transport::ResponseError)
+  end
+
+  interface _FullAgent
+    include _Agent
+    include _LoadSession
+    include _ListSessions
+    include _Authenticate
+    include _ResumeSession
+    include _CloseSession
+    include _DeleteSession
+    include _ChangeSessionMode
+    include _ChangeSessionConfigOption
+  end
+
+  interface _OptionalMethod
+    def rpc_method: () -> String
+    def agent_method: () -> Symbol
+    def advertised?: (ACP::Types::InitializeResponse) -> bool
+  end
+
   interface _SessionCreated
     def session_created: (ACP::Types::NewSessionResponse) -> void
   end
@@ -25,6 +67,13 @@ class ACP::AgentConnection
     def update: (String session_id, ACP::Types::SessionUpdate::t update) -> void
     def available_commands: (String session_id, Array[ACP::Types::AvailableCommand] commands) -> void
     def request_permission: (ACP::Types::RequestPermissionRequest) -> (ACP::Types::RequestPermissionResponse | ACP::Transport::ResponseError)
+    def read_text_file: (ACP::Types::ReadTextFileRequest) -> (ACP::Types::ReadTextFileResponse | ACP::Transport::ResponseError)
+    def write_text_file: (ACP::Types::WriteTextFileRequest) -> (ACP::Types::WriteTextFileResponse | ACP::Transport::ResponseError)
+    def create_terminal: (ACP::Types::CreateTerminalRequest) -> (ACP::Types::CreateTerminalResponse | ACP::Transport::ResponseError)
+    def terminal_output: (ACP::Types::TerminalOutputRequest) -> (ACP::Types::TerminalOutputResponse | ACP::Transport::ResponseError)
+    def wait_for_terminal_exit: (ACP::Types::WaitForTerminalExitRequest) -> (ACP::Types::WaitForTerminalExitResponse | ACP::Transport::ResponseError)
+    def kill_terminal: (ACP::Types::KillTerminalRequest) -> (ACP::Types::KillTerminalResponse | ACP::Transport::ResponseError)
+    def release_terminal: (ACP::Types::ReleaseTerminalRequest) -> (ACP::Types::ReleaseTerminalResponse | ACP::Transport::ResponseError)
     def capabilities: () -> ACP::Types::ClientCapabilities?
   end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: acp-sdk
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Jake Bottrall
@@ -23,8 +23,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.8'
-description: An Agent Client Protocol (ACP) server for exposing agents and a client
-  for driving them.
 email:
 - jakebottrall@gmail.com
 executables: []
@@ -37,6 +35,12 @@ files:
 - lib/acp/agent_connection.rb
 - lib/acp/agent_connection/client.rb
 - lib/acp/agent_connection/optional_method.rb
+- lib/acp/agent_connection/optional_method/authenticate.rb
+- lib/acp/agent_connection/optional_method/close_session.rb
+- lib/acp/agent_connection/optional_method/delete_session.rb
+- lib/acp/agent_connection/optional_method/list_sessions.rb
+- lib/acp/agent_connection/optional_method/load_session.rb
+- lib/acp/agent_connection/optional_method/resume_session.rb
 - lib/acp/client_connection.rb
 - lib/acp/sdk.rb
 - lib/acp/transport.rb
@@ -44,6 +48,7 @@ files:
 - lib/acp/transport/response_error.rb
 - lib/acp/transport/result.rb
 - lib/acp/transport/stdio.rb
+- lib/acp/types.rb
 - lib/acp/types/agent_auth_capabilities.rb
 - lib/acp/types/agent_capabilities.rb
 - lib/acp/types/annotations.rb
@@ -243,6 +248,12 @@ files:
 - sig/generated/acp/agent_connection.rbs
 - sig/generated/acp/agent_connection/client.rbs
 - sig/generated/acp/agent_connection/optional_method.rbs
+- sig/generated/acp/agent_connection/optional_method/authenticate.rbs
+- sig/generated/acp/agent_connection/optional_method/close_session.rbs
+- sig/generated/acp/agent_connection/optional_method/delete_session.rbs
+- sig/generated/acp/agent_connection/optional_method/list_sessions.rbs
+- sig/generated/acp/agent_connection/optional_method/load_session.rbs
+- sig/generated/acp/agent_connection/optional_method/resume_session.rbs
 - sig/generated/acp/client_connection.rbs
 - sig/generated/acp/sdk.rbs
 - sig/generated/acp/transport.rbs
@@ -250,6 +261,7 @@ files:
 - sig/generated/acp/transport/response_error.rbs
 - sig/generated/acp/transport/result.rbs
 - sig/generated/acp/transport/stdio.rbs
+- sig/generated/acp/types.rbs
 - sig/generated/acp/types/agent_auth_capabilities.rbs
 - sig/generated/acp/types/agent_capabilities.rbs
 - sig/generated/acp/types/annotations.rbs
@@ -447,9 +459,14 @@ files:
 - sig/generated/acp/types/write_text_file_response.rbs
 - sig/generated/acp/version.rbs
 - sig/manual/acp/agent_connection.rbs
+- sig/manual/acp/agent_connection/optional_method/authenticate.rbs
+- sig/manual/acp/agent_connection/optional_method/close_session.rbs
+- sig/manual/acp/agent_connection/optional_method/delete_session.rbs
+- sig/manual/acp/agent_connection/optional_method/list_sessions.rbs
+- sig/manual/acp/agent_connection/optional_method/load_session.rbs
+- sig/manual/acp/agent_connection/optional_method/resume_session.rbs
 - sig/manual/acp/client_connection.rbs
 - sig/manual/acp/transport/stdio.rbs
-- sig/manual/acp/types.rbs
 homepage: https://github.com/bottrall/acp-sdk
 licenses:
 - MIT

data/sig/manual/acp/types.rbs

@@ -1,2 +0,0 @@
-module ACP::Types
-end