claude_agent 0.7.4 → 0.7.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3d8b88e03dcf883a968958f700a7dd765fbdae8553934b45e967594ad81f9bba
-  data.tar.gz: fd16c0e625ed0df2c548c39378e167af73a21c2fa6d7b61cacc351d9cbde78d2
+  metadata.gz: 7243ce9755ad2adeca4eee580a6011ba3a35f51f1bfe7d00a2df1f4b5313bc52
+  data.tar.gz: 9331f577e970716bd9c3573eaa44e6e96b8ef5c3f3798673d4ff20eef0ca23f3
 SHA512:
-  metadata.gz: e4c7ba1adad712135d2934405b758324f2477e71b7914769deb07ba07fe4a025ca11f2c04a0ec46e3d2fe6954cf02288097ef914eb62c7874aca229aa4cd9c6c
-  data.tar.gz: c608d6c49ffb80c0c0aa96a4dca2f042f280060a73f473e271b1b0d099a368239fedf3194264f82f825fc5d8d76dfa4986c44563929f3a83f09773af96f84654
+  metadata.gz: b452df3dde194a5c092f2c1cae97c5b51fea119dce3aa8fe6bfadd2607ceb27e5d1fc9ded9206ed49f92db309acb6714e7fa38365150a373ea0fb3c77c5baa66
+  data.tar.gz: b2016921e13e9a3c811d126f78ea545b121bc8480ecb064c23b55807a444d3db361f42e205128302d4c303de598bf5d30754fcf3169cfedaeeb2e4dfc550ca22

data/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.7.5] - 2026-02-10
+
+### Added
+- `thinking` option for controlling extended thinking mode (`{ type: "adaptive" }`, `{ type: "enabled", budgetTokens: N }`, `{ type: "disabled" }`)
+- `effort` option for response effort level (`"low"`, `"medium"`, `"high"`, `"max"`)
+- `max_output_tokens` assistant message error type
+
 ## [0.7.4] - 2026-02-07
 
 ### Added

data/SPEC.md

@@ -3,11 +3,11 @@
 This document provides a comprehensive specification of the Claude Agent SDK, comparing feature parity across the official TypeScript and Python SDKs with this Ruby implementation.
 
 **Reference Versions:**
-- TypeScript SDK: v0.2.34 (npm package)
-- Python SDK: v0.1.31 from GitHub (commit 4b19642)
+- TypeScript SDK: v0.2.38 (npm package)
+- Python SDK: v0.1.34 from GitHub (commit a969042)
 - Ruby SDK: This repository
 
-**Last Updated:** 2026-02-07
+**Last Updated:** 2026-02-09
 
 ---
 
@@ -47,7 +47,9 @@ Configuration options for SDK queries and clients.
 | `permissionPromptToolName`        |     ✅      |   ✅    |  ✅   | MCP tool for permission prompts                              |
 | `maxTurns`                        |     ✅      |   ✅    |  ✅   | Max conversation turns                                       |
 | `maxBudgetUsd`                    |     ✅      |   ✅    |  ✅   | Max USD budget                                               |
-| `maxThinkingTokens`               |     ✅      |   ✅    |  ✅   | Max thinking tokens                                          |
+| `thinking`                        |     ✅      |   ❌    |  ✅   | Thinking mode config (adaptive/enabled/disabled) (v0.2.35+)  |
+| `effort`                          |     ✅      |   ❌    |  ✅   | Response effort level (low/medium/high/max) (v0.2.35+)       |
+| `maxThinkingTokens`               |     ✅      |   ✅    |  ✅   | Max thinking tokens (deprecated in TS, use `thinking`)       |
 | `continue`                        |     ✅      |   ✅    |  ✅   | Continue most recent conversation                            |
 | `resume`                          |     ✅      |   ✅    |  ✅   | Resume session by ID                                         |
 | `sessionId`                       |     ✅      |   ❌    |  ✅   | Custom UUID for conversations (v0.2.33)                      |
@@ -595,6 +597,7 @@ Error types and hierarchy.
 | `invalid_request`       |     ✅      |   ✅    |  ✅   |
 | `server_error`          |     ✅      |   ✅    |  ✅   |
 | `unknown`               |     ✅      |   ✅    |  ✅   |
+| `max_output_tokens`     |     ✅      |   ❌    |  ✅   |
 
 ---
 
@@ -674,12 +677,12 @@ Public API surface for SDK clients.
 - Partial control protocol: query and client support interrupt, setPermissionMode, setModel, rewindFiles, mcpStatus
 - Missing hooks: SessionStart, SessionEnd, Setup, TeammateIdle, TaskCompleted
 - Missing permission modes: `delegate`, `dontAsk`
-- Missing options: `allowDangerouslySkipPermissions`, `persistSession`, `resumeSessionAt`, `sessionId`, `strictMcpConfig`, `init`/`initOnly`/`maintenance`, `debug`/`debugFile`
+- Missing options: `thinking`, `effort`, `allowDangerouslySkipPermissions`, `persistSession`, `resumeSessionAt`, `sessionId`, `strictMcpConfig`, `init`/`initOnly`/`maintenance`, `debug`/`debugFile`
 - `ToolPermissionContext` missing `blockedPath`, `decisionReason`, `toolUseID`, `agentID`, `description`
 - Has SDK MCP server support with `tool()` helper and annotations
 
 ### Ruby SDK (This Repository)
-- Full TypeScript SDK v0.2.34 feature parity (v0.2.34 contains no new SDK features beyond a Claude Code version bump)
+- Feature parity with TypeScript SDK v0.2.38
 - Ruby-idiomatic patterns (Data.define, snake_case)
 - Complete control protocol, hook, and V2 Session API support
 - Dedicated Client class for multi-turn conversations

data/lib/claude_agent/options.rb

@@ -47,13 +47,16 @@ module ClaudeAgent
     }.freeze
 
     # All configurable attributes
+    # Valid effort levels for the effort option
+    EFFORT_LEVELS = %w[low medium high max].freeze
+
     ATTRIBUTES = %i[
       tools allowed_tools disallowed_tools
       system_prompt append_system_prompt
       model fallback_model
       permission_mode permission_prompt_tool_name can_use_tool allow_dangerously_skip_permissions
       continue_conversation resume fork_session resume_session_at session_id
-      max_turns max_budget_usd max_thinking_tokens
+      max_turns max_budget_usd thinking effort max_thinking_tokens
       strict_mcp_config mcp_servers hooks
       settings sandbox cwd add_dirs env user agent
       cli_path extra_args agents setting_sources plugins
@@ -194,11 +197,29 @@ module ClaudeAgent
       [].tap do |args|
         args.push("--max-turns", max_turns.to_s) if max_turns
         args.push("--max-budget-usd", max_budget_usd.to_s) if max_budget_usd
-        args.push("--max-thinking-tokens", max_thinking_tokens.to_s) if max_thinking_tokens
+        args.concat(thinking_args)
+        args.push("--max-thinking-tokens", max_thinking_tokens.to_s) if !thinking && max_thinking_tokens
+        args.push("--effort", effort) if effort
         args.push("--strict-mcp-config") if strict_mcp_config
       end
     end
 
+    def thinking_args
+      return [] unless thinking.is_a?(Hash)
+
+      type = thinking[:type] || thinking["type"]
+      case type
+      when "disabled"
+        [ "--max-thinking-tokens", "0" ]
+      when "enabled"
+        budget = thinking[:budgetTokens] || thinking[:budget_tokens] ||
+                 thinking["budgetTokens"] || thinking["budget_tokens"]
+        budget ? [ "--max-thinking-tokens", budget.to_s ] : []
+      else # "adaptive" or unrecognized — omit flag, let CLI use default
+        []
+      end
+    end
+
     def mcp_args
       [].tap do |args|
         if mcp_servers.is_a?(Hash) && mcp_servers.any?
@@ -301,6 +322,20 @@ module ClaudeAgent
         raise ConfigurationError, "max_budget_usd must be a positive number"
       end
 
+      if thinking
+        unless thinking.is_a?(Hash)
+          raise ConfigurationError, "thinking must be a Hash with :type key (e.g., { type: 'adaptive' })"
+        end
+        type = thinking[:type] || thinking["type"]
+        unless %w[adaptive enabled disabled].include?(type)
+          raise ConfigurationError, "thinking[:type] must be one of: adaptive, enabled, disabled"
+        end
+      end
+
+      if effort && !EFFORT_LEVELS.include?(effort)
+        raise ConfigurationError, "Invalid effort: #{effort}. Must be one of: #{EFFORT_LEVELS.join(", ")}"
+      end
+
       if session_id && (continue_conversation || resume) && !fork_session
         raise ConfigurationError, "session_id cannot be used with continue or resume unless fork_session is also set"
       end

data/lib/claude_agent/types.rb

@@ -10,6 +10,7 @@ module ClaudeAgent
     invalid_request
     server_error
     unknown
+    max_output_tokens
   ].freeze
 
   # API key source types (TypeScript SDK parity)

data/lib/claude_agent/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ClaudeAgent
-  VERSION = "0.7.4"
+  VERSION = "0.7.5"
 end

data/sig/claude_agent.rbs

@@ -262,6 +262,7 @@ module ClaudeAgent
     # Constants
     DEFAULTS: Hash[Symbol, untyped]
     ATTRIBUTES: Array[Symbol]
+    EFFORT_LEVELS: Array[String]
 
     # Tool configuration
     attr_accessor tools: (Array[String] | String)?
@@ -293,6 +294,8 @@ module ClaudeAgent
     # Limits & budget
     attr_accessor max_turns: Integer?
     attr_accessor max_budget_usd: Float?
+    attr_accessor thinking: Hash[Symbol | String, untyped]?
+    attr_accessor effort: String?
     attr_accessor max_thinking_tokens: Integer?
 
     # Strict validation

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: claude_agent
 version: !ruby/object:Gem::Version
-  version: 0.7.4
+  version: 0.7.5
 platform: ruby
 authors:
 - Thomas Carr