claude-agent-sdk 1.0.0 → 1.2.0

data/sig/claude_agent_sdk/types/options.rbs

@@ -48,7 +48,7 @@ module ClaudeAgentSDK
                       ?permission_prompt_tool_name: String?,
                       ?cwd: (String | Pathname)?,
                       ?cli_path: (String | Pathname)?,
-                      ?settings: (String | Hash[Symbol | String, untyped])?,
+                      ?settings: (String | Pathname | Hash[Symbol | String, untyped])?,
                       ?add_dirs: Array[String | Pathname]?,
                       ?env: Hash[String | Symbol, String?]?,
                       ?extra_args: Hash[String | Symbol, untyped]?,
@@ -68,7 +68,7 @@ module ClaudeAgentSDK
                       ?plugins: Array[SdkPluginConfig | Hash[Symbol | String, untyped]]?,
                       ?debug_stderr: (_Puts | String)?,
                       ?betas: Array[String]?,
-                      ?tools: (Array[String] | ToolsPreset | Hash[Symbol | String, untyped])?,
+                      ?tools: (Array[String] | ToolsPreset | Hash[Symbol | String, untyped] | String)?,
                       ?sandbox: (SandboxSettings | Hash[Symbol | String, untyped] | bool)?,
                       ?thinking: thinking_config?,
                       ?effort: (String | Symbol | Integer)?,
@@ -85,6 +85,7 @@ module ClaudeAgentSDK
                       ?include_hook_events: bool?,
                       ?strict_mcp_config: bool?,
                       ?forward_subagent_text: bool?,
+                      ?verbatim_prompts: bool?,
                       ?agent_progress_summaries: bool?,
                       ?callback_scheduling: (:thread | :inline | "thread" | "inline")?,
                       ?callback_wrapper: _CallbackWrapper?
@@ -132,8 +133,9 @@ module ClaudeAgentSDK
 
     attr_accessor cli_path: (String | Pathname)?
 
-    # A settings JSON String, a path to a settings file, or a Hash.
-    attr_accessor settings: (String | Hash[Symbol | String, untyped])?
+    # A settings JSON String, a path to a settings file (a String or a
+    # Pathname), or a Hash.
+    attr_accessor settings: (String | Pathname | Hash[Symbol | String, untyped])?
 
     attr_accessor add_dirs: Array[String | Pathname]?
 
@@ -184,10 +186,13 @@ module ClaudeAgentSDK
     # Entries of SDK_BETAS.
     attr_accessor betas: Array[String]?
 
-    # The base tool set: tool names, or a preset.
-    attr_accessor tools: (Array[String] | ToolsPreset | Hash[Symbol | String, untyped])?
+    # The base tool set: tool names (an Array, or the CLI's comma-separated
+    # String such as "Read,Grep"), or a preset.
+    attr_accessor tools: (Array[String] | ToolsPreset | Hash[Symbol | String, untyped] | String)?
 
-    # true / false are forwarded as-is (a bare toggle).
+    # true / false are forwarded as-is (a bare toggle). A Hash may spell the
+    # fields of SandboxSettings, and of its network / filesystem, in
+    # snake_case or in the CLI's camelCase (see SandboxSettings).
     attr_accessor sandbox: (SandboxSettings | Hash[Symbol | String, untyped] | bool)?
 
     attr_accessor thinking: thinking_config?
@@ -264,6 +269,14 @@ module ClaudeAgentSDK
 
     def forward_subagent_text?: () -> bool
 
+    # Mark every outgoing user message client_composed, so the CLI delivers
+    # it as written (false by default).
+    attr_reader verbatim_prompts: bool?
+
+    def verbatim_prompts=: (untyped value) -> bool?
+
+    def verbatim_prompts?: () -> bool
+
     # Request model-generated progress summaries for subagent tasks (nil:
     # unset, not sent).
     attr_reader agent_progress_summaries: bool?

data/sig/claude_agent_sdk/types/permissions.rbs

@@ -41,7 +41,8 @@ module ClaudeAgentSDK
 
     attr_accessor directories: Array[String]?
 
-    # One of PERMISSION_UPDATE_DESTINATIONS.
+    # One of PERMISSION_UPDATE_DESTINATIONS. When nil, #to_h sends "session"
+    # (unless type is nil too).
     attr_accessor destination: String?
 
     attr_reader rules: Array[PermissionRuleValue]?
@@ -49,7 +50,8 @@ module ClaudeAgentSDK
     # Hash entries (camelCase or snake_case keys) become PermissionRuleValue.
     def rules=: (Array[PermissionRuleValue | Hash[Symbol | String, untyped]]? value) -> Array[PermissionRuleValue | Hash[Symbol | String, untyped]]?
 
-    # The wire form (camelCase keys).
+    # The wire form (camelCase keys). A rule without content has no
+    # ruleContent key.
     def to_h: () -> Hash[Symbol, untyped]
   end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: claude-agent-sdk
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.2.0
 platform: ruby
 authors:
 - ya-luotao
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-23 00:00:00.000000000 Z
+date: 2026-10-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async
@@ -54,14 +54,14 @@ dependencies:
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '2.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '2.0'
 - !ruby/object:Gem::Dependency
@@ -118,6 +118,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".yardopts"
 - CHANGELOG.md
 - LICENSE
 - README.md
@@ -129,6 +130,7 @@ files:
 - docs/hooks-and-permissions.md
 - docs/mcp-servers.md
 - docs/observability.md
+- docs/options.md
 - docs/rails.md
 - docs/sessions.md
 - docs/subagents.md