claude_agent 0.7.12 → 0.7.13

data/sig/claude_agent.rbs

@@ -131,8 +131,10 @@ module ClaudeAgent
     attr_reader supports_effort: bool?
     attr_reader supported_effort_levels: Array[String]?
     attr_reader supports_adaptive_thinking: bool?
+    attr_reader supports_fast_mode: bool?
+    attr_reader supports_auto_mode: bool?
 
-    def initialize: (value: String, ?display_name: String?, ?description: String?, ?supports_effort: bool?, ?supported_effort_levels: Array[String]?, ?supports_adaptive_thinking: bool?) -> void
+    def initialize: (value: String, ?display_name: String?, ?description: String?, ?supports_effort: bool?, ?supported_effort_levels: Array[String]?, ?supports_adaptive_thinking: bool?, ?supports_fast_mode: bool?, ?supports_auto_mode: bool?) -> void
   end
 
   class McpServerStatus
@@ -165,14 +167,24 @@ module ClaudeAgent
     def initialize: (?email: String?, ?organization: String?, ?subscription_type: String?, ?token_source: String?, ?api_key_source: String?) -> void
   end
 
+  class AgentInfo
+    attr_reader name: String
+    attr_reader description: String?
+    attr_reader model: String?
+
+    def initialize: (name: String, ?description: String?, ?model: String?) -> void
+  end
+
   class InitializationResult
     attr_reader commands: Array[SlashCommand]
     attr_reader output_style: String?
     attr_reader available_output_styles: Array[String]
     attr_reader models: Array[ModelInfo]
     attr_reader account: AccountInfo?
+    attr_reader agents: Array[AgentInfo]
+    attr_reader fast_mode_state: String?
 
-    def initialize: (?commands: Array[SlashCommand], ?output_style: String?, ?available_output_styles: Array[String], ?models: Array[ModelInfo], ?account: AccountInfo?) -> void
+    def initialize: (?commands: Array[SlashCommand], ?output_style: String?, ?available_output_styles: Array[String], ?models: Array[ModelInfo], ?account: AccountInfo?, ?agents: Array[AgentInfo], ?fast_mode_state: String?) -> void
   end
 
   class ModelUsage
@@ -226,8 +238,10 @@ module ClaudeAgent
     attr_reader first_prompt: String?
     attr_reader git_branch: String?
     attr_reader cwd: String?
+    attr_reader tag: String?
+    attr_reader created_at: Integer?
 
-    def initialize: (session_id: String, summary: String, last_modified: Integer, file_size: Integer, ?custom_title: String?, ?first_prompt: String?, ?git_branch: String?, ?cwd: String?) -> void
+    def initialize: (session_id: String, summary: String, last_modified: Integer, file_size: Integer, ?custom_title: String?, ?first_prompt: String?, ?git_branch: String?, ?cwd: String?, ?tag: String?, ?created_at: Integer?) -> void
   end
 
   # Session transcript message returned by get_session_messages (TypeScript SDK v0.2.59 parity)
@@ -302,10 +316,11 @@ module ClaudeAgent
     attr_reader network: SandboxNetworkConfig?
     attr_reader ignore_violations: SandboxIgnoreViolations?
     attr_reader enable_weaker_nested_sandbox: bool
+    attr_reader enable_weaker_network_isolation: bool
     attr_reader ripgrep: SandboxRipgrepConfig?
     attr_reader filesystem: SandboxFilesystemConfig?
 
-    def initialize: (?enabled: bool, ?auto_allow_bash_if_sandboxed: bool, ?excluded_commands: Array[String], ?allow_unsandboxed_commands: bool, ?network: SandboxNetworkConfig?, ?ignore_violations: SandboxIgnoreViolations?, ?enable_weaker_nested_sandbox: bool, ?ripgrep: SandboxRipgrepConfig?, ?filesystem: SandboxFilesystemConfig?) -> void
+    def initialize: (?enabled: bool, ?auto_allow_bash_if_sandboxed: bool, ?excluded_commands: Array[String], ?allow_unsandboxed_commands: bool, ?network: SandboxNetworkConfig?, ?ignore_violations: SandboxIgnoreViolations?, ?enable_weaker_nested_sandbox: bool, ?enable_weaker_network_isolation: bool, ?ripgrep: SandboxRipgrepConfig?, ?filesystem: SandboxFilesystemConfig?) -> void
     def to_h: () -> Hash[Symbol, untyped]
   end
 
@@ -323,6 +338,11 @@ module ClaudeAgent
 
   # Options for configuring Claude Code CLI
   class Options
+    module Serializer
+    end
+
+    include Serializer
+
     # Constants
     DEFAULTS: Hash[Symbol, untyped]
     ATTRIBUTES: Array[Symbol]
@@ -345,6 +365,7 @@ module ClaudeAgent
     attr_accessor permission_mode: String?
     attr_accessor permission_prompt_tool_name: String?
     attr_accessor can_use_tool: (^(String, Hash[String, untyped], untyped) -> permission_result)?
+    attr_accessor on_elicitation: (^(Hash[Symbol, untyped], ?signal: AbortSignal?) -> Hash[Symbol, untyped]?)?
     attr_accessor allow_dangerously_skip_permissions: bool
     attr_accessor permission_queue: bool?
 
@@ -388,6 +409,7 @@ module ClaudeAgent
     # Advanced features
     attr_accessor agents: Hash[String, untyped]?
     attr_accessor setting_sources: Array[String]?
+    attr_accessor settings: (String | Hash[String, untyped])?
     attr_accessor plugins: Array[String | Hash[Symbol, String]]
 
     # Output & streaming
@@ -406,6 +428,8 @@ module ClaudeAgent
     attr_accessor stderr_callback: (^(String) -> void)?
     attr_accessor debug: bool
     attr_accessor debug_file: String?
+    attr_accessor tool_config: Hash[Symbol, untyped]?
+    attr_accessor agent_progress_summaries: bool?
 
     # Logging
     attr_accessor logger: Logger?
@@ -517,6 +541,27 @@ module ClaudeAgent
 
   CONTENT_BLOCK_TYPES: Array[Class]
 
+  # Elicitation complete message (TypeScript SDK v0.2.63 parity)
+  class ElicitationCompleteMessage
+    attr_reader uuid: String
+    attr_reader session_id: String
+    attr_reader mcp_server_name: String
+    attr_reader elicitation_id: String
+
+    def initialize: (?uuid: String, ?session_id: String, ?mcp_server_name: String, ?elicitation_id: String) -> void
+    def type: () -> :elicitation_complete
+  end
+
+  # Local command output message (TypeScript SDK v0.2.63 parity)
+  class LocalCommandOutputMessage
+    attr_reader uuid: String
+    attr_reader session_id: String
+    attr_reader content: String
+
+    def initialize: (?uuid: String, ?session_id: String, ?content: String) -> void
+    def type: () -> :local_command_output
+  end
+
   class GenericMessage
     attr_reader message_type: String?
     attr_reader raw: Hash[Symbol, untyped]
@@ -528,7 +573,7 @@ module ClaudeAgent
   end
 
   # Message types
-  type message = UserMessage | UserMessageReplay | AssistantMessage | SystemMessage | ResultMessage | StreamEvent | CompactBoundaryMessage | StatusMessage | ToolProgressMessage | HookResponseMessage | AuthStatusMessage | TaskNotificationMessage | HookStartedMessage | HookProgressMessage | ToolUseSummaryMessage | FilesPersistedEvent | TaskStartedMessage | TaskProgressMessage | RateLimitEvent | PromptSuggestionMessage | GenericMessage
+  type message = UserMessage | UserMessageReplay | AssistantMessage | SystemMessage | ResultMessage | StreamEvent | CompactBoundaryMessage | StatusMessage | ToolProgressMessage | HookResponseMessage | AuthStatusMessage | TaskNotificationMessage | HookStartedMessage | HookProgressMessage | ToolUseSummaryMessage | FilesPersistedEvent | TaskStartedMessage | TaskProgressMessage | RateLimitEvent | PromptSuggestionMessage | ElicitationCompleteMessage | LocalCommandOutputMessage | GenericMessage
 
   MESSAGE_TYPES: Array[Class]
 
@@ -600,6 +645,7 @@ module ClaudeAgent
     attr_reader permission_denials: Array[SDKPermissionDenial]?
     attr_reader model_usage: Hash[String, untyped]?
     attr_reader stop_reason: String?
+    attr_reader fast_mode_state: String?
 
     def initialize: (
       subtype: String,
@@ -616,7 +662,8 @@ module ClaudeAgent
       ?errors: Array[String]?,
       ?permission_denials: Array[SDKPermissionDenial]?,
       ?model_usage: Hash[String, untyped]?,
-      ?stop_reason: String?
+      ?stop_reason: String?,
+      ?fast_mode_state: String?
     ) -> void
 
     def type: () -> :result
@@ -771,7 +818,7 @@ module ClaudeAgent
     def type: () -> :files_persisted
   end
 
-  # Task started message (TypeScript SDK v0.2.45 parity)
+  # Task started message (TypeScript SDK v0.2.75 parity)
   class TaskStartedMessage
     attr_reader uuid: String
     attr_reader session_id: String
@@ -779,12 +826,13 @@ module ClaudeAgent
     attr_reader tool_use_id: String?
     attr_reader description: String?
     attr_reader task_type: String?
+    attr_reader prompt: String?
 
-    def initialize: (uuid: String, session_id: String, task_id: String, ?tool_use_id: String?, ?description: String?, ?task_type: String?) -> void
+    def initialize: (uuid: String, session_id: String, task_id: String, ?tool_use_id: String?, ?description: String?, ?task_type: String?, ?prompt: String?) -> void
     def type: () -> :task_started
   end
 
-  # Task progress message (TypeScript SDK v0.2.51 parity)
+  # Task progress message (TypeScript SDK v0.2.75 parity)
   class TaskProgressMessage
     attr_reader uuid: String
     attr_reader session_id: String
@@ -793,8 +841,9 @@ module ClaudeAgent
     attr_reader description: String
     attr_reader usage: Hash[String, untyped]?
     attr_reader last_tool_name: String?
+    attr_reader summary: String?
 
-    def initialize: (uuid: String, session_id: String, task_id: String, description: String, ?usage: Hash[String, untyped]?, ?tool_use_id: String?, ?last_tool_name: String?) -> void
+    def initialize: (uuid: String, session_id: String, task_id: String, description: String, ?usage: Hash[String, untyped]?, ?tool_use_id: String?, ?last_tool_name: String?, ?summary: String?) -> void
     def type: () -> :task_progress
   end
 
@@ -852,8 +901,10 @@ module ClaudeAgent
     attr_reader transcript_path: String?
     attr_reader cwd: String?
     attr_reader permission_mode: String?
+    attr_reader agent_id: String?
+    attr_reader agent_type: String?
 
-    def initialize: (hook_event_name: String, ?session_id: String?, ?transcript_path: String?, ?cwd: String?, ?permission_mode: String?, **untyped) -> void
+    def initialize: (hook_event_name: String, ?session_id: String?, ?transcript_path: String?, ?cwd: String?, ?permission_mode: String?, ?agent_id: String?, ?agent_type: String?, **untyped) -> void
 
     def self.define_input: (String event_name, ?required: Array[Symbol], ?optional: Hash[Symbol, untyped], ?constants: Hash[Symbol, untyped]) -> Class
                          | (String event_name, ?required: Array[Symbol], ?optional: Hash[Symbol, untyped], ?constants: Hash[Symbol, untyped]) { () -> void } -> Class
@@ -978,6 +1029,27 @@ module ClaudeAgent
     def initialize: (task_id: String, task_subject: String, ?task_description: String?, ?teammate_name: String?, ?team_name: String?, **untyped) -> void
   end
 
+  class ElicitationInput < BaseHookInput
+    attr_reader mcp_server_name: String
+    attr_reader message: String
+    attr_reader mode: String?
+    attr_reader url: String?
+    attr_reader elicitation_id: String?
+    attr_reader requested_schema: untyped
+
+    def initialize: (mcp_server_name: String, message: String, ?mode: String?, ?url: String?, ?elicitation_id: String?, ?requested_schema: untyped, **untyped) -> void
+  end
+
+  class ElicitationResultInput < BaseHookInput
+    attr_reader mcp_server_name: String
+    attr_reader action: String
+    attr_reader elicitation_id: String?
+    attr_reader mode: String?
+    attr_reader content: untyped
+
+    def initialize: (mcp_server_name: String, action: String, ?elicitation_id: String?, ?mode: String?, ?content: untyped, **untyped) -> void
+  end
+
   class ConfigChangeInput < BaseHookInput
     attr_reader source: String
     attr_reader file_path: String?
@@ -999,6 +1071,20 @@ module ClaudeAgent
     def initialize: (worktree_path: String, **untyped) -> void
   end
 
+  class InstructionsLoadedInput < BaseHookInput
+    attr_reader file_path: String
+    attr_reader memory_type: String
+    attr_reader load_reason: String
+    attr_reader globs: Array[String]?
+    attr_reader trigger_file_path: String?
+    attr_reader parent_file_path: String?
+
+    MEMORY_TYPES: Array[String]
+    LOAD_REASONS: Array[String]
+
+    def initialize: (file_path: String, memory_type: String, load_reason: String, ?globs: Array[String]?, ?trigger_file_path: String?, ?parent_file_path: String?, **untyped) -> void
+  end
+
   # Permission types
   type permission_result = PermissionResultAllow | PermissionResultDeny
 
@@ -1293,8 +1379,11 @@ module ClaudeAgent
   end
 
   # Session discovery
-  def self.list_sessions: (?dir: String?, ?limit: Integer?) -> Array[SessionInfo]
+  def self.list_sessions: (?dir: String?, ?limit: Integer?, ?offset: Integer?, ?include_worktrees: bool) -> Array[SessionInfo]
   def self.get_session_messages: (String session_id, ?dir: String?, ?limit: Integer?, ?offset: Integer?) -> Array[SessionMessage]
+  def self.rename_session: (String session_id, String title, ?dir: String?) -> void
+  def self.tag_session: (String session_id, String? tag, ?dir: String?) -> void
+  def self.get_session_info: (String session_id, ?dir: String?) -> SessionInfo?
 
   # Shared session path infrastructure
   module SessionPaths
@@ -1315,7 +1404,7 @@ module ClaudeAgent
   module ListSessions
     BUFFER_SIZE: Integer
 
-    def self.call: (?dir: String?, ?limit: Integer?) -> Array[SessionInfo]
+    def self.call: (?dir: String?, ?limit: Integer?, ?offset: Integer?) -> Array[SessionInfo]
   end
 
   # GetSessionMessages module (TypeScript SDK v0.2.59 parity)
@@ -1325,12 +1414,30 @@ module ClaudeAgent
     def self.call: (String session_id, ?dir: String?, ?limit: Integer?, ?offset: Integer?) -> Array[SessionMessage]
   end
 
+  # Session mutations module (TypeScript SDK v0.2.75 parity)
+  module SessionMutations
+    UNICODE_SANITIZE_PATTERN: Regexp
+
+    def self.rename_session: (String session_id, String title, ?dir: String?) -> void
+    def self.tag_session: (String session_id, String? tag, ?dir: String?) -> void
+  end
+
+  # Single session lookup (TypeScript SDK v0.2.75 parity)
+  module GetSessionInfo
+    def self.call: (String session_id, ?dir: String?) -> SessionInfo?
+  end
+
   # Convenience methods
   def self.conversation: (**untyped) -> Conversation
   def self.resume_conversation: (String session_id, **untyped) -> Conversation
 
   # Client
   class Client
+    module Commands
+    end
+
+    include Commands
+
     attr_reader options: Options
     attr_reader transport: Transport::Base
     attr_reader server_info: Hash[String, untyped]?
@@ -1403,6 +1510,7 @@ module ClaudeAgent
     def apply_flag_settings: (Hash[String, untyped] settings) -> Hash[String, untyped]
     def supported_commands: () -> Array[SlashCommand]
     def supported_models: () -> Array[ModelInfo]
+    def supported_agents: () -> Array[AgentInfo]
     def mcp_server_status: () -> Array[McpServerStatus]
     def account_info: () -> AccountInfo
     def initialization_result: () -> InitializationResult
@@ -1416,6 +1524,28 @@ module ClaudeAgent
     REQUEST_ID_PREFIX: String
     HOOK_RESPONSE_KEYS: Hash[Symbol, String]
 
+    # Mixin modules that compose the protocol's behavior
+    module Primitives
+    end
+
+    module Lifecycle
+    end
+
+    module Messaging
+    end
+
+    module Commands
+    end
+
+    module RequestHandling
+    end
+
+    include Primitives
+    include Lifecycle
+    include Messaging
+    include Commands
+    include RequestHandling
+
     attr_reader transport: Transport::Base
     attr_reader options: Options
     attr_reader server_info: Hash[String, untyped]?
@@ -1446,6 +1576,7 @@ module ClaudeAgent
     def apply_flag_settings: (Hash[String, untyped] settings) -> Hash[String, untyped]
     def supported_commands: () -> Array[SlashCommand]
     def supported_models: () -> Array[ModelInfo]
+    def supported_agents: () -> Array[AgentInfo]
     def mcp_server_status: () -> Array[McpServerStatus]
     def account_info: () -> AccountInfo
     def initialization_result: () -> InitializationResult

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: claude_agent
 version: !ruby/object:Gem::Version
-  version: 0.7.12
+  version: 0.7.13
 platform: ruby
 authors:
 - Thomas Carr
@@ -44,6 +44,7 @@ files:
 - ".claude/skills/spec/commands/complete.md"
 - ".claude/skills/spec/commands/update.md"
 - ".worktreeinclude"
+- ARCHITECTURE.md
 - CHANGELOG.md
 - CLAUDE.md
 - LICENSE.txt
@@ -53,12 +54,27 @@ files:
 - lib/claude_agent.rb
 - lib/claude_agent/abort_controller.rb
 - lib/claude_agent/client.rb
+- lib/claude_agent/client/commands.rb
 - lib/claude_agent/content_blocks.rb
+- lib/claude_agent/content_blocks/generic_block.rb
+- lib/claude_agent/content_blocks/image_content_block.rb
+- lib/claude_agent/content_blocks/server_tool_result_block.rb
+- lib/claude_agent/content_blocks/server_tool_use_block.rb
+- lib/claude_agent/content_blocks/text_block.rb
+- lib/claude_agent/content_blocks/thinking_block.rb
+- lib/claude_agent/content_blocks/tool_result_block.rb
+- lib/claude_agent/content_blocks/tool_use_block.rb
 - lib/claude_agent/control_protocol.rb
+- lib/claude_agent/control_protocol/commands.rb
+- lib/claude_agent/control_protocol/lifecycle.rb
+- lib/claude_agent/control_protocol/messaging.rb
+- lib/claude_agent/control_protocol/primitives.rb
+- lib/claude_agent/control_protocol/request_handling.rb
 - lib/claude_agent/conversation.rb
 - lib/claude_agent/cumulative_usage.rb
 - lib/claude_agent/errors.rb
 - lib/claude_agent/event_handler.rb
+- lib/claude_agent/get_session_info.rb
 - lib/claude_agent/get_session_messages.rb
 - lib/claude_agent/hooks.rb
 - lib/claude_agent/list_sessions.rb
@@ -68,7 +84,16 @@ files:
 - lib/claude_agent/mcp/tool.rb
 - lib/claude_agent/message_parser.rb
 - lib/claude_agent/messages.rb
+- lib/claude_agent/messages/conversation.rb
+- lib/claude_agent/messages/generic.rb
+- lib/claude_agent/messages/hook_lifecycle.rb
+- lib/claude_agent/messages/result.rb
+- lib/claude_agent/messages/streaming.rb
+- lib/claude_agent/messages/system.rb
+- lib/claude_agent/messages/task_lifecycle.rb
+- lib/claude_agent/messages/tool_lifecycle.rb
 - lib/claude_agent/options.rb
+- lib/claude_agent/options/serializer.rb
 - lib/claude_agent/permission_queue.rb
 - lib/claude_agent/permission_request.rb
 - lib/claude_agent/permissions.rb
@@ -76,6 +101,7 @@ files:
 - lib/claude_agent/sandbox_settings.rb
 - lib/claude_agent/session.rb
 - lib/claude_agent/session_message_relation.rb
+- lib/claude_agent/session_mutations.rb
 - lib/claude_agent/session_paths.rb
 - lib/claude_agent/spawn.rb
 - lib/claude_agent/tool_activity.rb
@@ -84,6 +110,12 @@ files:
 - lib/claude_agent/transport/subprocess.rb
 - lib/claude_agent/turn_result.rb
 - lib/claude_agent/types.rb
+- lib/claude_agent/types/mcp.rb
+- lib/claude_agent/types/models.rb
+- lib/claude_agent/types/operations.rb
+- lib/claude_agent/types/sessions.rb
+- lib/claude_agent/types/tools.rb
+- lib/claude_agent/v2_session.rb
 - lib/claude_agent/version.rb
 - sig/claude_agent.rbs
 - sig/manifest.yaml