phronomy 0.27.0 → 0.29.0

data/sig/phronomy/multi_agent.rbs

@@ -19,6 +19,9 @@ module Phronomy
     end
 
     class Orchestrator < ::Phronomy::Agent::Base
+      attr_reader coordination_store: Store?
+      def self.create: (?coordination_store: Store?, **Object options) ?{ (Object) -> void } -> instance
+      def self.load: (String agent_id, persistence: Agent::Store, coordination_store: Store, **Object options) ?{ (Object) -> void } -> instance
       def self.subagent: (Symbol | String name, singleton(::Phronomy::Agent::Base) agent_class, ?on_error: Symbol, ?inherit_knowledge: bool) -> untyped
       def self.registered_subagents: () -> Hash[Symbol | String, untyped]
       def resume: (String execution_id, ?config: Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
@@ -28,7 +31,7 @@ module Phronomy
 
     class TeamCoordinator
       attr_reader team_id: String
-      attr_reader persistence: ::Phronomy::Persistence
+      attr_reader persistence: Store
       def self.team_definition: (?id: String?, ?version: Integer?) -> Hash[Symbol, String | Integer]
       def self.coordinator_model: (?String? value) -> String?
       def self.coordinator_instructions: (?String? value) -> String?
@@ -36,9 +39,9 @@ module Phronomy
       def self.pool: (size: Integer, agent: singleton(::Phronomy::Agent::Base), ?on_error: Symbol) -> untyped
       def self.schedule: () { (Array[untyped]) -> untyped } -> untyped
       def self.aggregate: () { (Array[Hash[Symbol, untyped]]) -> untyped } -> untyped
-      def self.new: (?team_id: String, ?persistence: ::Phronomy::Persistence?, ?metadata: Hash[String, untyped], ?on_event: ^(untyped) -> untyped) -> instance
+      def self.new: (?team_id: String, ?persistence: Store?, ?metadata: Hash[String, untyped], ?on_event: ^(untyped) -> untyped) -> instance
       def self.create: (**untyped options) -> instance
-      def self.load: (String team_id, persistence: ::Phronomy::Persistence, ?on_event: ^(untyped) -> untyped) -> instance
+      def self.load: (String team_id, persistence: Store, ?on_event: ^(untyped) -> untyped) -> instance
       def self.get: (String team_id) -> instance?
       def invoke: (untyped input, ?config: Hash[Symbol, untyped]) -> untyped
       def stream: (untyped input, ?config: Hash[Symbol, untyped]) ?{ (Hash[Symbol, untyped]) -> untyped } -> untyped

data/sig/phronomy/persistence/errors.rbs

@@ -0,0 +1,18 @@
+module Phronomy
+  class Persistence
+    class TransactionError < Error
+    end
+    class Error < Phronomy::Error
+    end
+    class ConflictError < Error
+    end
+    class StateConflictError < ConflictError
+    end
+    class NotFoundError < Error
+    end
+    class SerializationError < Error
+    end
+    class UnsupportedBackendError < Error
+    end
+  end
+end

data/sig/phronomy/persistence/migration.rbs

@@ -0,0 +1,13 @@
+module Phronomy
+  class Persistence
+    module Migration
+      module InitialFormatMigration
+        def self.agent_root: (Hash[untyped, untyped] hash) -> Storage::DurableRecord
+        def self.agent_execution: (Hash[untyped, untyped] hash) -> Storage::DurableRecord
+        def self.journal_record: (Hash[untyped, untyped] hash) -> Storage::DurableRecord
+        def self.workflow_state: (workflow_instance_id: String, revision: Integer, snapshot: Hash[untyped, untyped]) -> Storage::DurableRecord
+        def self.llm_input_manifest: (Hash[untyped, untyped] hash) -> Hash[String, untyped]
+      end
+    end
+  end
+end

data/sig/phronomy/persistence/transaction.rbs

@@ -0,0 +1,19 @@
+module Phronomy
+  class Persistence
+    interface _Participant[T]
+      def new: (Storage::View view) -> T
+    end
+
+    class Transaction
+      def initialize: (Persistence persistence, Storage::View view, ?parent: Transaction?) -> void
+      def participate: [T, R] (persistence: Persistence, adapter: _Participant[T]) { (T) -> R } -> R
+      def outermost?: () -> bool
+      def committed?: () -> bool
+      def validate!: () -> bool
+      def close!: () -> bool
+      def confirm!: () -> bool
+    end
+
+    def atomic: [R] () { (Transaction) -> R } -> R
+  end
+end

data/sig/phronomy/persistence.rbs

@@ -1,105 +1,7 @@
 module Phronomy
-  # Runtime/domain-facing repository interfaces.
-  interface _AgentRepository
-    def create: (untyped root) -> untyped
-    def load: (String agent_id) -> untyped
-    def save: (String agent_id, expected_revision: Integer, root: untyped) -> untyped
-    def delete: (String agent_id) -> untyped
-  end
-
-  interface _JournalRepository
-    def append: (String agent_id, expected_position: Integer, records: Array[untyped]) -> Array[untyped]
-    def read: (String agent_id, ?after: Integer?, ?limit: Integer?) -> Array[untyped]
-    def head: (String agent_id) -> Integer
-    def delete: (String agent_id) -> untyped
-  end
-
-  interface _ExecutionRepository
-    def create_active: (untyped execution) -> untyped
-    def load: (String execution_id) -> untyped
-    def save: (String execution_id, expected_revision: Integer, execution: untyped) -> untyped
-    def list_active: (String agent_id) -> Array[untyped]
-    def list: (String agent_id, ?after: String?, ?limit: Integer) -> Array[untyped]
-    def delete: (String execution_id) -> untyped
-    def delete_for_agent: (String agent_id) -> untyped
-    def assert_idle!: (String agent_id) -> untyped
-  end
-
-  interface _WorkflowStateRepository
-    def load: (String workflow_instance_id) -> Hash[untyped, untyped]?
-    def save: (String workflow_instance_id, expected_revision: Integer?, snapshot: Hash[untyped, untyped]) -> Integer
-    def delete: (String workflow_instance_id, expected_revision: Integer) -> untyped
-  end
-
-  # Backend-side record repository interfaces. DurableRecord is the opaque data
-  # carrier. Identity/revision/index metadata is passed separately so backends do
-  # not need to interpret DurableRecord#payload.
-  interface _HandoffStateRepository
-    def load: (String main_agent_id) -> untyped
-    def save: (String main_agent_id, expected_revision: Integer?, state: untyped) -> untyped
-    def delete: (String main_agent_id, expected_revision: Integer) -> untyped
-  end
-
-  interface _TeamRepository
-    def create: (untyped root) -> untyped
-    def load: (String team_id) -> untyped
-    def save: (String team_id, expected_revision: Integer, root: untyped) -> untyped
-    def delete: (String team_id) -> untyped
-  end
-
-  interface _TeamExecutionRepository
-    def create_active: (untyped execution) -> untyped
-    def load: (String team_execution_id) -> untyped
-    def save: (String team_execution_id, expected_revision: Integer, execution: untyped) -> untyped
-    def list_active: (String team_id) -> Array[untyped]
-    def list: (String team_id, ?after: String?, ?limit: Integer) -> Array[untyped]
-    def delete: (String team_execution_id) -> untyped
-    def delete_for_team: (String team_id) -> untyped
-    def assert_idle!: (String team_id) -> untyped
-  end
-
-  interface _PersistenceTransactionView
-    def contents: () -> _ContentRepository
-    def agents: () -> _AgentRepository
-    def journals: () -> _JournalRepository
-    def executions: () -> _ExecutionRepository
-    def workflow_states: () -> _WorkflowStateRepository
-    def handoff_states: () -> _HandoffStateRepository
-    def teams: () -> _TeamRepository
-    def team_executions: () -> _TeamExecutionRepository
-    def assert_agent_watermark!: (agent_id: String, agent_revision: Integer, journal_position: Integer) -> true
-  end
-
   class Persistence
-    module Migration
-      module InitialFormatMigration
-        def self.agent_root: (Hash[untyped, untyped] hash) -> Storage::DurableRecord
-        def self.agent_execution: (Hash[untyped, untyped] hash) -> Storage::DurableRecord
-        def self.journal_record: (Hash[untyped, untyped] hash) -> Storage::DurableRecord
-        def self.workflow_state: (workflow_instance_id: String, revision: Integer, snapshot: Hash[untyped, untyped]) -> Storage::DurableRecord
-        def self.llm_input_manifest: (Hash[untyped, untyped] hash) -> Hash[String, untyped]
-      end
-    end
-
-    attr_reader contents: _ContentRepository
-    attr_reader agents: _AgentRepository
-    attr_reader journals: _JournalRepository
-    attr_reader executions: _ExecutionRepository
-    attr_reader workflow_states: _WorkflowStateRepository
-    attr_reader handoff_states: _HandoffStateRepository
-    attr_reader teams: _TeamRepository
-    attr_reader team_executions: _TeamExecutionRepository
-    def handoff_result: (String execution_id, ?main_agent_id: String?) -> Hash[Symbol, untyped]
-    def execution_result: (String execution_id) -> Hash[Symbol, untyped]
-    def list_executions: (String agent_id, ?after: String?, ?limit: Integer) -> Array[untyped]
-    def team_execution_result: (String team_execution_id) -> Hash[Symbol, untyped]
-    def list_team_executions: (String team_id, ?after: String?, ?limit: Integer) -> Array[untyped]
-
     attr_reader backend: _StorageBackend
     def initialize: (backend: _StorageBackend) -> void
-    def self.in_memory: () -> Persistence
-    def capabilities: () -> Hash[Symbol, bool]
-    def transaction: () { (_PersistenceTransactionView) -> untyped } -> untyped
-    def assert_agent_watermark!: (agent_id: String, agent_revision: Integer, journal_position: Integer) -> true
+    def bind: [T] (_Participant[T] adapter) -> T
   end
 end

data/sig/phronomy/persistence_composition.rbs

@@ -0,0 +1,19 @@
+module Phronomy
+  module PersistenceComposition
+    class Stores < Data
+      attr_reader coordinator: ::Phronomy::Persistence
+      attr_reader agent: Agent::Store
+      attr_reader multi_agent: MultiAgent::Store
+      attr_reader workflow: _WorkflowStateRepository
+      def self.new: (coordinator: ::Phronomy::Persistence, agent: Agent::Store, multi_agent: MultiAgent::Store, workflow: _WorkflowStateRepository) -> instance
+    end
+
+    class Unit4Migration
+      def self.convert: (Hash[String, json_value] snapshot, quiescent: bool) -> Hash[String, json_value]
+    end
+
+    def self.agent: (?backend: _StorageBackend?) -> Agent::Store
+    def self.build: (backend: _StorageBackend) -> Stores
+    def self.in_memory: () -> Stores
+  end
+end

data/sig/phronomy/runtime_composition/configuration.rbs

@@ -0,0 +1,36 @@
+module Phronomy
+  class ConfigurationError < Error
+  end
+
+  class HandoffError < Error
+  end
+
+  class CancellationError < Error
+  end
+
+  class EventLoopReentrancyError < Error
+  end
+
+  class AgentAlreadyExistsError < Error
+  end
+
+  class AgentPurgedError < Error
+  end
+
+  class PoolShutdownError < Error
+  end
+
+  class BackpressureError < Error
+  end
+
+  class Configuration
+    attr_accessor agent_store: Agent::Store?
+    attr_accessor multi_agent_store: MultiAgent::Store?
+    attr_accessor workflow_store: _WorkflowStateRepository?
+    attr_accessor llm_adapter: LLMAdapter::Base
+    attr_accessor before_llm_input: Agent::_BeforeLLMInputHook?
+  end
+
+  def self.configuration: () -> Configuration
+  def self.configure: () { (Configuration) -> void } -> void
+end

data/sig/phronomy/storage/async/async_client.rbs

@@ -0,0 +1,8 @@
+module Phronomy
+  module Storage
+    class AsyncClient
+      def initialize: (backend: _StorageBackend, ?pool: untyped) -> void
+      def transaction_async: [T] (?cancellation_token: Concurrency::CancellationToken?, ?timeout: Numeric?) { (View) -> T } -> TaskResult[T]
+    end
+  end
+end

data/sig/phronomy/storage/backends/in_memory.rbs

@@ -0,0 +1,9 @@
+module Phronomy
+  module Storage
+    module Backends
+      class InMemory < Backend
+        def initialize: (?resources: Array[Resource]) -> void
+      end
+    end
+  end
+end

data/sig/phronomy/{storage.rbs → storage/contracts.rbs}

@@ -1,18 +1,8 @@
 module Phronomy
-  interface _ContentRepository
-    def put: (String bytes, canonicalization_version: untyped) -> String
-    def fetch: (String content_id) -> String
-    def exist?: (String content_id) -> bool
-    def put_text: (String text) -> String
-    def put_json: (untyped value) -> String
-    def fetch_text: (String content_id) -> String
-    def fetch_json: (String content_id) -> untyped
-    def fetch_many: (Array[String] content_ids) -> Hash[String, String]
-  end
-
   interface _StorageBackend
     def view: () -> Storage::View
     def capabilities: () -> Hash[Symbol, bool | Integer]
+    def transaction_open?: () -> bool
     def transaction: [T] () { (Storage::View) -> T } -> T
   end
 
@@ -26,11 +16,11 @@ module Phronomy
     class UniqueConstraintError < ConflictError
       attr_reader resource: String
       attr_reader constraint: Symbol
-      def initialize: (resource: Resource, constraint: Symbol) -> void
+      def initialize: (resource: Resource, constraint: Symbol, ?code: String?) -> void
     end
     class ConditionFailedError < ConflictError
       attr_reader condition: condition
-      def initialize: (condition) -> void
+      def initialize: (condition, ?code: String?) -> void
     end
     class BlobConflictError < ConflictError
     end
@@ -163,12 +153,8 @@ module Phronomy
       def initialize: (resources: Array[Resource]) -> void
       def self.validate_capabilities!: (_StorageBackend backend) -> void
       def capabilities: () -> Hash[Symbol, bool | Integer]
+      def transaction_open?: () -> bool
       def transaction: [T] () { (View) -> T } -> T
     end
-    module Backends
-      class InMemory < Backend
-        def initialize: (?resources: Array[Resource]) -> void
-      end
-    end
   end
 end

data/sig/phronomy/tool.rbs

@@ -1,6 +1,25 @@
 module Phronomy
   module Tool
+    module Operation
+      def self.call_async: (tool: Base, args: Hash[untyped, untyped], ?cancellation_token: Concurrency::CancellationToken?, ?config: Hash[untyped, untyped], ?submitter: _ExecutionSubmitter, ?on_full: Symbol) -> _CompletionHandle[untyped]
+      def self.with_result_transform: (singleton(Base) tool_class) { (untyped, String, Hash[untyped, untyped]) -> untyped } -> singleton(Base)
+    end
+    class Schema
+      def initialize: (?untyped schema) ?{ () -> untyped } -> void
+      def json_schema: () -> Hash[String, untyped]
+      def validate: (Hash[String | Symbol, untyped] arguments, ?coerce: bool) -> [Hash[Symbol, untyped]?, String?]
+    end
+    class CallRequest
+      attr_reader id: String
+      attr_reader name: String
+      attr_reader arguments: Hash[String, json_value]
+      attr_reader metadata: Hash[String, json_value]
+      def initialize: (id: String, name: String, arguments: Hash[String | Symbol, untyped], ?metadata: Hash[String | Symbol, untyped]) -> void
+      def self.from_h: (Hash[String | Symbol, untyped] value) -> CallRequest
+      def to_h: () -> Hash[String, untyped]
+    end
     class Base
+      def self.parameter: (String | Symbol name, ?type: String | Symbol, ?description: String?, ?required: bool) -> untyped
       def self.tool_name: (?untyped value) -> String?
       def self.description: (?String text) -> String?
       def self.desc: (?String text) -> String?
@@ -23,26 +42,51 @@ module Phronomy
       def self.redact_params: (*untyped names) -> Array[Symbol]
       def self.max_result_size: (?untyped value) -> untyped
 
+      def description: () -> String?
       def name: () -> String
       def parameters_schema: () -> untyped
       def parameters: () -> Hash[untyped, untyped]
       def provider_options: () -> Hash[untyped, untyped]
       def provider_params: () -> Hash[untyped, untyped]
       def params_schema: () -> untyped
+      def validate_arguments: (Hash[String | Symbol, untyped]? args) -> [Hash[Symbol, untyped]?, String?]
       def call: (Hash[untyped, untyped] args, ?cancellation_token: Concurrency::CancellationToken?) -> untyped
       def call_async: (Hash[untyped, untyped] args, ?cancellation_token: Concurrency::CancellationToken?, ?config: Hash[untyped, untyped]) -> TaskResult[untyped]
       def requires_approval?: () -> untyped
       def tool_origin: () -> Symbol
       def approval_metadata: () -> Hash[untyped, untyped]
       def execute: (**untyped args) -> untyped
+
+      private
+
+      def call_async_operation: (Hash[untyped, untyped]? args, cancellation_token: Concurrency::CancellationToken?, operation_name: String) { (Hash[Symbol, untyped]) -> _CompletionHandle[untyped] } -> _CompletionHandle[untyped]
+      def async_error_value: (Exception error) -> untyped
     end
   end
 
-  module Agent
-    module Context
-      module Capability
-        class Base = ::Phronomy::Tool::Base
+end
+
+module Phronomy
+  module Tool
+    interface _AuthorizationRequest
+      def origin: () -> Symbol
+      def with: (?facts: Hash[untyped, untyped], ?default_decision: Symbol?) -> _AuthorizationRequest
+    end
+
+    module Authorization
+      class Decision
+        attr_reader decision: Symbol
+        attr_reader facts: Hash[untyped, untyped]
+        attr_reader reason: String?
       end
+      def self.call: (request: _AuthorizationRequest, arguments: Hash[untyped, untyped], context: Hash[untyped, untyped], ?facts: (^(Hash[untyped, untyped], Hash[untyped, untyped]) -> Hash[untyped, untyped]?)?, ?requirement: bool? | (^(_AuthorizationRequest) -> bool?), ?policy: (^(_AuthorizationRequest) -> Symbol)?) -> Decision
+    end
+
+    class DefinitionSet
+      attr_reader runtime_tools: Array[untyped]
+      attr_reader definitions: Array[Hash[String, untyped]]
+      def self.build: (tools: Array[untyped], ?runtime_tools: Array[untyped]) -> DefinitionSet
+      def select_definitions: (Array[Hash[String, untyped]] expected_definitions) -> DefinitionSet
     end
   end
 end

data/sig/phronomy/tracing/observation.rbs

@@ -0,0 +1,7 @@
+module Phronomy
+  module Tracing
+    module Observation
+      def self.trace: [A] (String name, ?input: untyped, **untyped meta) { (untyped span) -> [A, LLMAdapter::TokenUsage?] } -> A
+    end
+  end
+end

data/sig/phronomy/vector_store/async/async_client.rbs

@@ -0,0 +1,13 @@
+module Phronomy
+  module VectorStore
+    class AsyncClient
+      # pool is an optional internal execution-pool injection; ordinary callers omit it.
+      def initialize: (backend: Base, ?pool: untyped) -> void
+      def add_async: (id: String, embedding: Array[Float], ?metadata: Hash[untyped, untyped], ?cancellation_token: Concurrency::CancellationToken?, ?timeout: Numeric?) -> TaskResult[untyped]
+      def search_async: (query_embedding: Array[Float], ?k: Integer, ?cancellation_token: Concurrency::CancellationToken?, ?timeout: Numeric?) -> TaskResult[Array[Hash[Symbol, untyped]]]
+      def remove_async: (id: String, ?cancellation_token: Concurrency::CancellationToken?, ?timeout: Numeric?) -> TaskResult[untyped]
+      def clear_async: (?cancellation_token: Concurrency::CancellationToken?, ?timeout: Numeric?) -> TaskResult[untyped]
+    end
+
+  end
+end

data/sig/phronomy/vector_store/base.rbs

@@ -0,0 +1,23 @@
+module Phronomy
+  module VectorStore
+    class InvalidResultError < Phronomy::Error
+    end
+
+    class Base
+      def add: (id: String, embedding: Array[Numeric], ?metadata: Hash[untyped, untyped], ?cancellation_token: _CancellationSignal?) -> self
+      def search: (query_embedding: Array[Numeric], ?k: Integer | String, ?cancellation_token: _CancellationSignal?) -> Array[Hash[Symbol, untyped]]
+      def remove: (id: String) -> self
+      def clear: () -> self
+      def size: () -> Integer
+
+      # Protected extension SPI at runtime; RBS has no protected visibility.
+      private
+      def embedding_dimension: () -> Integer?
+      def perform_add: (id: String, embedding: Array[Float], metadata: Hash[untyped, untyped], cancellation_token: _CancellationSignal?) -> untyped
+      def perform_search: (query_embedding: Array[Float], k: Integer, cancellation_token: _CancellationSignal?) -> Array[Hash[Symbol, untyped]]
+      def perform_remove: (id: String) -> untyped
+      def perform_clear: () -> untyped
+      def perform_size: () -> Integer
+    end
+  end
+end

data/sig/phronomy/workflow/execution/workflow_execution_environment.rbs

@@ -0,0 +1,15 @@
+module Phronomy
+  # Private connection selected by composition, not a public application API.
+  class WorkflowExecutionEnvironment
+    def self.install_provider: (^() -> WorkflowExecutionEnvironment provider) -> untyped
+    def self.current: () -> WorkflowExecutionEnvironment
+    def registry: () -> untyped
+    def existing_registry: () -> untyped
+    def executing?: () -> bool
+    def submit: [V] (**untyped options) { () -> V } -> TaskResult[V]
+    def compile_transitions: (**untyped definition) -> untyped
+    def build_session: (**untyped options) -> untyped
+    def register_session: (untyped session, completion: TaskResult[untyped]) -> untyped
+    def subscribe_cancellation: (Concurrency::CancellationToken token) { () -> void } -> untyped
+  end
+end

data/sig/phronomy/workflow/runtime_binding/workflow_terminal_policy.rbs

@@ -0,0 +1,7 @@
+module Phronomy
+  class WorkflowTerminalPolicy
+    def start: (terminal_type: Symbol, context: untyped, event_sink: _FSMEventSink) -> untyped
+    def handles?: (Event event) -> bool
+    def decision_for: (Event event) -> TerminalDecision
+  end
+end

data/sig/phronomy/workflow/store.rbs

@@ -0,0 +1,8 @@
+module Phronomy
+  interface _WorkflowStateRepository
+    def load: (String workflow_instance_id) -> Hash[untyped, untyped]?
+    def save: (String workflow_instance_id, expected_revision: Integer?, snapshot: Hash[untyped, untyped]) -> Integer
+    def delete: (String workflow_instance_id, expected_revision: Integer) -> untyped
+  end
+
+end

data/sig/phronomy/workflow.rbs

@@ -1,4 +1,7 @@
 module Phronomy
+  class WorkflowTaskResumeError < Error
+    def initialize: (?String message, ?code: String?) -> void
+  end
   module WorkflowContext
     def phase: () -> Symbol
     def halted?: () -> bool
@@ -8,7 +11,7 @@ module Phronomy
   end
 
   class Workflow
-    def self.define: (Class context_class, ?persistence: Persistence?) { () -> void } -> Workflow
+    def self.define: (Class context_class, ?persistence: _WorkflowStateRepository?) { () -> void } -> Workflow
 
     def invoke: (untyped input, ?config: Hash[untyped, untyped], ?invocation_context: untyped) -> untyped
     def invoke_async: (untyped input, ?config: Hash[untyped, untyped], ?invocation_context: untyped) -> TaskResult[untyped]
@@ -20,6 +23,7 @@ module Phronomy
     class Builder
       def initial: (Symbol state_name) -> untyped
       def state: (Symbol name, ?action: untyped) -> untyped
+      def task_state: (Symbol name, start: ^(untyped) -> TaskResult[untyped], apply: ^(untyped, untyped) -> untyped) -> void
       def entry: (Symbol name, untyped callable) -> untyped
       def exit: (Symbol name, untyped callable) -> untyped
       def wait_state: (Symbol name) -> untyped

data/sig/phronomy.rbs

@@ -2,61 +2,16 @@ module Phronomy
   VERSION: String
 
   class Error < StandardError
+    attr_reader code: String?
+    def initialize: (?untyped message, ?code: String?) -> void
+    def self.diagnostic: (Exception) -> Hash[String, untyped]
+    def self.from_diagnostic: (Hash[untyped, untyped], ?remaining: Integer) -> Error
   end
 
   class ParseError < Error
   end
 
-  class RecursionLimitError < Error
-  end
-
   class ToolError < Error
   end
 
-  class TimeoutError < Error
-  end
-
-  class ConfigurationError < Error
-  end
-
-  class HandoffError < Error
-  end
-
-  class TransportError < Error
-  end
-
-  class RateLimitError < TransportError
-  end
-
-  class AuthenticationError < TransportError
-  end
-
-  class ContextLengthError < Error
-  end
-
-  class CancellationError < Error
-  end
-
-  class EventLoopReentrancyError < Error
-  end
-
-  class AgentAlreadyExistsError < Error
-  end
-
-  class AgentPurgedError < Error
-  end
-
-  class PoolShutdownError < Error
-  end
-
-  class BackpressureError < Error
-  end
-
-  class Configuration
-    attr_accessor llm_adapter: LLMAdapter::Base
-    attr_accessor before_llm_input: Agent::_BeforeLLMInputHook?
-  end
-
-  def self.configuration: () -> Configuration
-  def self.configure: () { (Configuration) -> void } -> void
 end