acp-sdk 0.1.0

data/lib/acp/types/tool_call_update.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+# Generated by bin/types from schema/schema.json. Do not edit.
+
+class ACP::Types::ToolCallUpdate
+  # @dynamic tool_call_id
+  attr_reader :tool_call_id #: String
+
+  # @dynamic kind
+  attr_reader :kind #: String?
+
+  # @dynamic status
+  attr_reader :status #: String?
+
+  # @dynamic title
+  attr_reader :title #: String?
+
+  # @dynamic content
+  attr_reader :content #: Array[ACP::Types::ToolCallContent::t]?
+
+  # @dynamic locations
+  attr_reader :locations #: Array[ACP::Types::ToolCallLocation]?
+
+  # @dynamic raw_input
+  attr_reader :raw_input #: untyped
+
+  # @dynamic raw_output
+  attr_reader :raw_output #: untyped
+
+  # @dynamic meta
+  attr_reader :meta #: Hash[String, untyped]?
+
+  # @rbs tool_call_id: String
+  # @rbs kind: String?
+  # @rbs status: String?
+  # @rbs title: String?
+  # @rbs content: Array[ACP::Types::ToolCallContent::t]?
+  # @rbs locations: Array[ACP::Types::ToolCallLocation]?
+  # @rbs raw_input: untyped
+  # @rbs raw_output: untyped
+  # @rbs meta: Hash[String, untyped]?
+  # @rbs return: void
+  def initialize(
+    tool_call_id:,
+    kind: nil,
+    status: nil,
+    title: nil,
+    content: nil,
+    locations: nil,
+    raw_input: nil,
+    raw_output: nil,
+    meta: nil
+  )
+    @tool_call_id = tool_call_id
+    @kind = kind
+    @status = status
+    @title = title
+    @content = content
+    @locations = locations
+    @raw_input = raw_input
+    @raw_output = raw_output
+    @meta = meta
+    freeze
+  end
+
+  # @rbs hash: Hash[String, untyped]
+  # @rbs return: ACP::Types::ToolCallUpdate
+  def self.from_h(hash)
+    new(
+      tool_call_id: hash.fetch('toolCallId'),
+      kind: hash['kind'],
+      status: hash['status'],
+      title: hash['title'],
+      content: hash['content']&.map { |item| ACP::Types::ToolCallContent.from_h(item) },
+      locations: hash['locations']&.map { |item| ACP::Types::ToolCallLocation.from_h(item) },
+      raw_input: hash['rawInput'],
+      raw_output: hash['rawOutput'],
+      meta: hash['_meta']
+    )
+  end
+
+  # @rbs return: Hash[String, untyped]
+  def to_h
+    {
+      'toolCallId' => tool_call_id,
+      'kind' => kind,
+      'status' => status,
+      'title' => title,
+      'content' => content&.map(&:to_h),
+      'locations' => locations&.map(&:to_h),
+      'rawInput' => raw_input,
+      'rawOutput' => raw_output,
+      '_meta' => meta
+    }.compact
+  end
+end

data/lib/acp/types/tool_kind.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+# Generated by bin/types from schema/schema.json. Do not edit.
+
+module ACP::Types::ToolKind
+  READ = 'read'
+  EDIT = 'edit'
+  DELETE = 'delete'
+  MOVE = 'move'
+  SEARCH = 'search'
+  EXECUTE = 'execute'
+  THINK = 'think'
+  FETCH = 'fetch'
+  SWITCH_MODE = 'switch_mode'
+  OTHER = 'other'
+end

data/lib/acp/types/unstructured_command_input.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+# Generated by bin/types from schema/schema.json. Do not edit.
+
+class ACP::Types::UnstructuredCommandInput
+  # @dynamic hint
+  attr_reader :hint #: String
+
+  # @dynamic meta
+  attr_reader :meta #: Hash[String, untyped]?
+
+  # @rbs hint: String
+  # @rbs meta: Hash[String, untyped]?
+  # @rbs return: void
+  def initialize(hint:, meta: nil)
+    @hint = hint
+    @meta = meta
+    freeze
+  end
+
+  # @rbs hash: Hash[String, untyped]
+  # @rbs return: ACP::Types::UnstructuredCommandInput
+  def self.from_h(hash)
+    new(hint: hash.fetch('hint'), meta: hash['_meta'])
+  end
+
+  # @rbs return: Hash[String, untyped]
+  def to_h
+    { 'hint' => hint, '_meta' => meta }.compact
+  end
+end

data/lib/acp/types/usage_update.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+# Generated by bin/types from schema/schema.json. Do not edit.
+
+class ACP::Types::UsageUpdate
+  # @dynamic used
+  attr_reader :used #: Integer
+
+  # @dynamic size
+  attr_reader :size #: Integer
+
+  # @dynamic cost
+  attr_reader :cost #: ACP::Types::Cost?
+
+  # @dynamic meta
+  attr_reader :meta #: Hash[String, untyped]?
+
+  # @rbs used: Integer
+  # @rbs size: Integer
+  # @rbs cost: ACP::Types::Cost?
+  # @rbs meta: Hash[String, untyped]?
+  # @rbs return: void
+  def initialize(used:, size:, cost: nil, meta: nil)
+    @used = used
+    @size = size
+    @cost = cost
+    @meta = meta
+    freeze
+  end
+
+  # @rbs hash: Hash[String, untyped]
+  # @rbs return: ACP::Types::UsageUpdate
+  def self.from_h(hash)
+    new(
+      used: hash.fetch('used'),
+      size: hash.fetch('size'),
+      cost: hash['cost']&.then { |value| ACP::Types::Cost.from_h(value) },
+      meta: hash['_meta']
+    )
+  end
+
+  # @rbs return: Hash[String, untyped]
+  def to_h
+    { 'used' => used, 'size' => size, 'cost' => cost&.to_h, '_meta' => meta }.compact
+  end
+end

data/lib/acp/types/wait_for_terminal_exit_request.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+# Generated by bin/types from schema/schema.json. Do not edit.
+
+class ACP::Types::WaitForTerminalExitRequest
+  # @dynamic session_id
+  attr_reader :session_id #: String
+
+  # @dynamic terminal_id
+  attr_reader :terminal_id #: String
+
+  # @dynamic meta
+  attr_reader :meta #: Hash[String, untyped]?
+
+  # @rbs session_id: String
+  # @rbs terminal_id: String
+  # @rbs meta: Hash[String, untyped]?
+  # @rbs return: void
+  def initialize(session_id:, terminal_id:, meta: nil)
+    @session_id = session_id
+    @terminal_id = terminal_id
+    @meta = meta
+    freeze
+  end
+
+  # @rbs hash: Hash[String, untyped]
+  # @rbs return: ACP::Types::WaitForTerminalExitRequest
+  def self.from_h(hash)
+    new(session_id: hash.fetch('sessionId'), terminal_id: hash.fetch('terminalId'), meta: hash['_meta'])
+  end
+
+  # @rbs return: Hash[String, untyped]
+  def to_h
+    { 'sessionId' => session_id, 'terminalId' => terminal_id, '_meta' => meta }.compact
+  end
+end

data/lib/acp/types/wait_for_terminal_exit_response.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+# Generated by bin/types from schema/schema.json. Do not edit.
+
+class ACP::Types::WaitForTerminalExitResponse
+  # @dynamic exit_code
+  attr_reader :exit_code #: Integer?
+
+  # @dynamic signal
+  attr_reader :signal #: String?
+
+  # @dynamic meta
+  attr_reader :meta #: Hash[String, untyped]?
+
+  # @rbs exit_code: Integer?
+  # @rbs signal: String?
+  # @rbs meta: Hash[String, untyped]?
+  # @rbs return: void
+  def initialize(exit_code: nil, signal: nil, meta: nil)
+    @exit_code = exit_code
+    @signal = signal
+    @meta = meta
+    freeze
+  end
+
+  # @rbs hash: Hash[String, untyped]
+  # @rbs return: ACP::Types::WaitForTerminalExitResponse
+  def self.from_h(hash)
+    new(exit_code: hash['exitCode'], signal: hash['signal'], meta: hash['_meta'])
+  end
+
+  # @rbs return: Hash[String, untyped]
+  def to_h
+    { 'exitCode' => exit_code, 'signal' => signal, '_meta' => meta }.compact
+  end
+end

data/lib/acp/types/write_text_file_request.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+# Generated by bin/types from schema/schema.json. Do not edit.
+
+class ACP::Types::WriteTextFileRequest
+  # @dynamic session_id
+  attr_reader :session_id #: String
+
+  # @dynamic path
+  attr_reader :path #: String
+
+  # @dynamic content
+  attr_reader :content #: String
+
+  # @dynamic meta
+  attr_reader :meta #: Hash[String, untyped]?
+
+  # @rbs session_id: String
+  # @rbs path: String
+  # @rbs content: String
+  # @rbs meta: Hash[String, untyped]?
+  # @rbs return: void
+  def initialize(session_id:, path:, content:, meta: nil)
+    @session_id = session_id
+    @path = path
+    @content = content
+    @meta = meta
+    freeze
+  end
+
+  # @rbs hash: Hash[String, untyped]
+  # @rbs return: ACP::Types::WriteTextFileRequest
+  def self.from_h(hash)
+    new(
+      session_id: hash.fetch('sessionId'),
+      path: hash.fetch('path'),
+      content: hash.fetch('content'),
+      meta: hash['_meta']
+    )
+  end
+
+  # @rbs return: Hash[String, untyped]
+  def to_h
+    { 'sessionId' => session_id, 'path' => path, 'content' => content, '_meta' => meta }.compact
+  end
+end

data/lib/acp/types/write_text_file_response.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+# Generated by bin/types from schema/schema.json. Do not edit.
+
+class ACP::Types::WriteTextFileResponse
+  # @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::WriteTextFileResponse
+  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/version.rb

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

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

@@ -0,0 +1,29 @@
+# Generated from lib/acp/agent_connection/client.rb with RBS::Inline
+
+class ACP::AgentConnection::Client
+  @peer: ACP::AgentConnection::_Peer
+
+  # @dynamic capabilities, capabilities=
+  attr_accessor capabilities: ACP::Types::ClientCapabilities?
+
+  # @rbs peer: ACP::AgentConnection::_Peer
+  # @rbs return: void
+  def initialize: (peer: ACP::AgentConnection::_Peer) -> void
+
+  # @rbs session_id: String
+  # @rbs update: ACP::Types::SessionUpdate::t
+  # @rbs return: void
+  def update: (String session_id, ACP::Types::SessionUpdate::t update) -> void
+
+  # @rbs session_id: String
+  # @rbs commands: Array[ACP::Types::AvailableCommand]
+  # @rbs return: void
+  def available_commands: (String session_id, Array[ACP::Types::AvailableCommand] commands) -> void
+
+  # Blocks the calling thread until the client answers or the connection
+  # closes.
+  #
+  # @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)
+end

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

@@ -0,0 +1,21 @@
+# 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
+end

data/sig/generated/acp/agent_connection.rbs

@@ -0,0 +1,65 @@
+# 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?
+
+  @capabilities: ACP::Types::AgentCapabilities
+
+  @transport: ACP::AgentConnection::_Transport
+
+  PROTOCOL_VERSION: Integer
+
+  INVALID_PARAMS: ACP::Transport::ResponseError
+
+  OPTIONAL: Array[ACP::AgentConnection::OptionalMethod]
+
+  # @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 &factory: (ACP::AgentConnection::Client) -> ACP::AgentConnection::_Agent
+  # @rbs return: void
+  def initialize: (transport: ACP::AgentConnection::_Transport, capabilities: ACP::Types::AgentCapabilities, ?agent_info: ACP::Types::Implementation?, ?auth_methods: Array[ACP::Types::AuthMethod::t]) { (ACP::AgentConnection::Client) -> ACP::AgentConnection::_Agent } -> void
+
+  # @rbs return: Thread
+  def start: () -> Thread
+
+  private
+
+  # @rbs agent: ACP::AgentConnection::_Agent
+  # @rbs client: ACP::AgentConnection::Client
+  # @rbs return: Hash[String, ^(untyped) -> (ACP::Transport::Result | ACP::Transport::Reply)]
+  def requests: (ACP::AgentConnection::_Agent agent, ACP::AgentConnection::Client client) -> Hash[String, ^(untyped) -> (ACP::Transport::Result | ACP::Transport::Reply)]
+
+  # @rbs agent: ACP::AgentConnection::_Agent
+  # @rbs return: Hash[String, ^(untyped) -> void]
+  def notifications: (ACP::AgentConnection::_Agent agent) -> Hash[String, ^(untyped) -> void]
+
+  # Generated from_h raises on a missing key or a value of the wrong shape.
+  #
+  # @rbs type: ACP::AgentConnection::_Parser
+  # @rbs &handle: (untyped) -> (ACP::Transport::Result | ACP::Transport::Reply)
+  # @rbs return: ^(untyped) -> (ACP::Transport::Result | ACP::Transport::Reply)
+  def route: (ACP::AgentConnection::_Parser type) { (untyped) -> (ACP::Transport::Result | ACP::Transport::Reply) } -> ^(untyped) -> (ACP::Transport::Result | ACP::Transport::Reply)
+
+  # @rbs response: ACP::AgentConnection::_Response | ACP::Transport::ResponseError
+  # @rbs return: ACP::Transport::Result
+  def respond: (ACP::AgentConnection::_Response | ACP::Transport::ResponseError response) -> ACP::Transport::Result
+
+  # @rbs client: ACP::AgentConnection::Client
+  # @rbs request: ACP::Types::InitializeRequest
+  # @rbs return: ACP::Transport::Result
+  def connect: (ACP::AgentConnection::Client client, ACP::Types::InitializeRequest request) -> ACP::Transport::Result
+
+  # session_created runs after the reply because the client must know the
+  # session id before updates for it (e.g. available commands) arrive.
+  #
+  # @rbs agent: ACP::AgentConnection::_Agent
+  # @rbs request: ACP::Types::NewSessionRequest
+  # @rbs return: ACP::Transport::Result | ACP::Transport::Reply
+  def new_session: (ACP::AgentConnection::_Agent agent, ACP::Types::NewSessionRequest request) -> (ACP::Transport::Result | ACP::Transport::Reply)
+end

data/sig/generated/acp/client_connection.rbs

@@ -0,0 +1,82 @@
+# Generated from lib/acp/client_connection.rb with RBS::Inline
+
+class ACP::ClientConnection
+  @streams: Hash[String, Thread::Queue]
+
+  @lock: Thread::Mutex
+
+  @updates: ACP::ClientConnection::_UpdateHandler
+
+  @permission: ACP::ClientConnection::_PermissionHandler
+
+  @transport: ACP::AgentConnection::_Transport
+
+  IGNORE: ^(ACP::Types::SessionNotification) -> void
+
+  # @rbs transport: ACP::AgentConnection::_Transport
+  # @rbs permission: ACP::ClientConnection::_PermissionHandler
+  # @rbs updates: ACP::ClientConnection::_UpdateHandler
+  # @rbs return: void
+  def initialize: (transport: ACP::AgentConnection::_Transport, permission: ACP::ClientConnection::_PermissionHandler, ?updates: ACP::ClientConnection::_UpdateHandler) -> void
+
+  # @rbs return: Thread
+  def start: () -> Thread
+
+  # Ruby reserves initialize for the constructor, so the initialize request is
+  # sent by connect.
+  #
+  # @rbs request: ACP::Types::InitializeRequest
+  # @rbs return: ACP::Types::InitializeResponse | ACP::Transport::ResponseError
+  def connect: (ACP::Types::InitializeRequest request) -> (ACP::Types::InitializeResponse | ACP::Transport::ResponseError)
+
+  # @rbs request: ACP::Types::NewSessionRequest
+  # @rbs return: ACP::Types::NewSessionResponse | ACP::Transport::ResponseError
+  def session_new: (ACP::Types::NewSessionRequest request) -> (ACP::Types::NewSessionResponse | ACP::Transport::ResponseError)
+
+  # @rbs request: ACP::Types::PromptRequest
+  # @rbs &block: (ACP::Types::SessionUpdate::t) -> void
+  # @rbs return: ACP::Types::PromptResponse | ACP::Transport::ResponseError
+  def session_prompt: (ACP::Types::PromptRequest request) { (ACP::Types::SessionUpdate::t) -> void } -> (ACP::Types::PromptResponse | ACP::Transport::ResponseError)
+
+  # @rbs request: ACP::Types::LoadSessionRequest
+  # @rbs &block: (ACP::Types::SessionUpdate::t) -> void
+  # @rbs return: ACP::Types::LoadSessionResponse | ACP::Transport::ResponseError
+  def session_load: (ACP::Types::LoadSessionRequest request) { (ACP::Types::SessionUpdate::t) -> void } -> (ACP::Types::LoadSessionResponse | ACP::Transport::ResponseError)
+
+  # @rbs request: ACP::Types::ListSessionsRequest
+  # @rbs return: ACP::Types::ListSessionsResponse | ACP::Transport::ResponseError
+  def session_list: (ACP::Types::ListSessionsRequest request) -> (ACP::Types::ListSessionsResponse | ACP::Transport::ResponseError)
+
+  # @rbs notification: ACP::Types::CancelNotification
+  # @rbs return: void
+  def session_cancel: (ACP::Types::CancelNotification notification) -> void
+
+  private
+
+  # @rbs type: ACP::AgentConnection::_Parser
+  # @rbs result: ACP::Transport::Result
+  # @rbs return: untyped
+  def parse: (ACP::AgentConnection::_Parser type, ACP::Transport::Result result) -> untyped
+
+  # The request waits on its own thread so the caller's thread can yield each
+  # update as it arrives. The reader thread queues an update before it settles
+  # a reply sent after it, so the queue closes only after the last one.
+  #
+  # @rbs session_id: String
+  # @rbs method: String
+  # @rbs params: Hash[String, untyped]
+  # @rbs &block: (ACP::Types::SessionUpdate::t) -> void
+  # @rbs return: ACP::Transport::Result
+  def stream: (String session_id, String method, Hash[String, untyped] params) { (ACP::Types::SessionUpdate::t) -> void } -> ACP::Transport::Result
+
+  # Pushes under the lock so a stream cannot close its queue between the
+  # lookup and the push.
+  #
+  # @rbs params: untyped
+  # @rbs return: void
+  def dispatch: (untyped params) -> void
+
+  # @rbs params: untyped
+  # @rbs return: ACP::Transport::Result
+  def request_permission: (untyped params) -> ACP::Transport::Result
+end

data/sig/generated/acp/sdk.rbs

@@ -0,0 +1,2 @@
+# Generated from lib/acp/sdk.rb with RBS::Inline
+

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

@@ -0,0 +1,16 @@
+# Generated from lib/acp/transport/reply.rb with RBS::Inline
+
+# A request handler's result plus a callback the transport runs once that
+# result is on the wire, for messages the peer must only see after the reply.
+class ACP::Transport::Reply
+  # @dynamic result
+  attr_reader result: ACP::Transport::Result
+
+  # @dynamic after
+  attr_reader after: ^() -> void
+
+  # @rbs result: ACP::Transport::Result
+  # @rbs after: ^() -> void
+  # @rbs return: void
+  def initialize: (ACP::Transport::Result result, after: ^() -> void) -> void
+end

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

@@ -0,0 +1,21 @@
+# Generated from lib/acp/transport/response_error.rb with RBS::Inline
+
+class ACP::Transport::ResponseError
+  # @dynamic code
+  attr_reader code: Integer
+
+  # @dynamic message
+  attr_reader message: String
+
+  # @dynamic data
+  attr_reader data: untyped
+
+  # @rbs code: Integer
+  # @rbs message: String
+  # @rbs data: untyped
+  # @rbs return: void
+  def initialize: (code: Integer, message: String, ?data: untyped) -> void
+
+  # @rbs return: Hash[String, untyped]
+  def to_h: () -> Hash[String, untyped]
+end

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

@@ -0,0 +1,25 @@
+# Generated from lib/acp/transport/result.rb with RBS::Inline
+
+class ACP::Transport::Result
+  # @dynamic value
+  attr_reader value: untyped
+
+  # @dynamic error
+  attr_reader error: ACP::Transport::ResponseError?
+
+  # @rbs value: untyped
+  # @rbs return: ACP::Transport::Result
+  def self.ok: (untyped value) -> ACP::Transport::Result
+
+  # @rbs error: ACP::Transport::ResponseError
+  # @rbs return: ACP::Transport::Result
+  def self.error: (ACP::Transport::ResponseError error) -> ACP::Transport::Result
+
+  # @rbs value: untyped
+  # @rbs error: ACP::Transport::ResponseError?
+  # @rbs return: void
+  def initialize: (value: untyped, error: ACP::Transport::ResponseError?) -> void
+
+  # @rbs return: bool
+  def ok?: () -> bool
+end