claude_agent 0.7.4 → 0.7.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3d8b88e03dcf883a968958f700a7dd765fbdae8553934b45e967594ad81f9bba
-  data.tar.gz: fd16c0e625ed0df2c548c39378e167af73a21c2fa6d7b61cacc351d9cbde78d2
+  metadata.gz: 461539691af2ef7a8824d3d5976a7d9741e7e41cbd1bf7d5c07fa13f7909894b
+  data.tar.gz: 7c56823efe8f18b0502c652e5cf3e214ed81a6a057322e871dabb4b4d19fbbc2
 SHA512:
-  metadata.gz: e4c7ba1adad712135d2934405b758324f2477e71b7914769deb07ba07fe4a025ca11f2c04a0ec46e3d2fe6954cf02288097ef914eb62c7874aca229aa4cd9c6c
-  data.tar.gz: c608d6c49ffb80c0c0aa96a4dca2f042f280060a73f473e271b1b0d099a368239fedf3194264f82f825fc5d8d76dfa4986c44563929f3a83f09773af96f84654
+  metadata.gz: 84a3b38295cab7f4d28969a73573b97028d0fd26d61e65520fc6375804e67128ea7f08678cb094a6763fffb7a837248d9f6a06e1616985af9615957d10b4d6a2
+  data.tar.gz: 423cda325548a65dd32780582efdcefb352c2d83b6c852d362564d0391d7287b20ab4fb9ec2aa39c0348069d451da773e95c29e34a74766b3c52434afc261563

data/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.7.6] - 2026-02-13
+
+### Added
+- `stop_task` control request and `Client#stop_task` method for stopping running background tasks (TypeScript SDK parity)
+
+## [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.42 (npm package)
+- Python SDK: v0.1.36 from GitHub (commit 4d74748)
 - Ruby SDK: This repository
 
-**Last Updated:** 2026-02-07
+**Last Updated:** 2026-02-13
 
 ---
 
@@ -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)                      |
@@ -225,6 +227,7 @@ Bidirectional control protocol for SDK-CLI communication.
 | `mcp_status`              |     ✅      |   ✅    |  ✅   | Get MCP server status             |
 | `mcp_reconnect`           |     ✅      |   ❌    |  ✅   | Reconnect to MCP server           |
 | `mcp_toggle`              |     ✅      |   ❌    |  ✅   | Enable/disable MCP server         |
+| `stop_task`               |     ✅      |   ❌    |  ✅   | Stop a running background task    |
 | `supported_commands`      |     ✅      |   ❌    |  ✅   | Get available slash commands      |
 | `supported_models`        |     ✅      |   ❌    |  ✅   | Get available models              |
 | `account_info`            |     ✅      |   ❌    |  ✅   | Get account information           |
@@ -595,6 +598,7 @@ Error types and hierarchy.
 | `invalid_request`       |     ✅      |   ✅    |  ✅   |
 | `server_error`          |     ✅      |   ✅    |  ✅   |
 | `unknown`               |     ✅      |   ✅    |  ✅   |
+| `max_output_tokens`     |     ✅      |   ❌    |  ✅   |
 
 ---
 
@@ -625,6 +629,7 @@ Public API surface for SDK clients.
 | `setMcpServers()`        |     ✅      |   ❌    |  ✅   | Dynamic MCP servers    |
 | `reconnectMcpServer()`   |     ✅      |   ❌    |  ✅   | Reconnect MCP server   |
 | `toggleMcpServer()`      |     ✅      |   ❌    |  ✅   | Enable/disable MCP     |
+| `stopTask()`             |     ✅      |   ❌    |  ✅   | Stop running task      |
 | `streamInput()`          |     ✅      |   ✅    |  ✅   | Stream user input      |
 | `initializationResult()` |     ✅      |   ❌    |  ✅   | Full init response     |
 | `close()`                |     ✅      |   ✅    |  ✅   | Close query/session    |
@@ -677,9 +682,10 @@ Public API surface for SDK clients.
 - Missing options: `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
+- Added `thinking` config and `effort` option in v0.1.36
 
 ### 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)
+- Full feature parity with TypeScript SDK v0.2.42
 - 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/client.rb

@@ -281,6 +281,23 @@ module ClaudeAgent
       @protocol.initialization_result
     end
 
+    # Stop a running background task (TypeScript SDK parity)
+    #
+    # Sends a stop signal to a running task. A task_notification message
+    # with status 'stopped' will be emitted when the task stops.
+    #
+    # @param task_id [String] The task ID from task_notification events
+    # @return [void]
+    #
+    # @example
+    #   client.stop_task("task-123")
+    #
+    def stop_task(task_id)
+      require_connection!
+
+      @protocol.stop_task(task_id)
+    end
+
     # Dynamically set MCP servers for this session (TypeScript SDK parity)
     #
     # This replaces the current set of dynamically-added MCP servers.

data/lib/claude_agent/control_protocol.rb

@@ -443,6 +443,21 @@ module ClaudeAgent
       send_control_request(subtype: "mcp_toggle", serverName: server_name, enabled: enabled)
     end
 
+    # Stop a running background task (TypeScript SDK parity)
+    #
+    # Sends a stop signal to a running task. A task_notification message
+    # with status 'stopped' will be emitted when the task stops.
+    #
+    # @param task_id [String] The task ID from task_notification events
+    # @return [void]
+    #
+    # @example
+    #   protocol.stop_task("task-123")
+    #
+    def stop_task(task_id)
+      send_control_request(subtype: "stop_task", task_id: task_id)
+    end
+
     # Dynamically set MCP servers for this session (TypeScript SDK parity)
     #
     # This replaces the current set of dynamically-added MCP servers.

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.6"
 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
@@ -907,6 +910,7 @@ module ClaudeAgent
     def set_mcp_servers: (Hash[String, untyped] servers) -> McpSetServersResult
     def mcp_reconnect: (String server_name) -> Hash[String, untyped]
     def mcp_toggle: (String server_name, enabled: bool) -> Hash[String, untyped]
+    def stop_task: (String task_id) -> Hash[String, untyped]
     def supported_commands: () -> Array[SlashCommand]
     def supported_models: () -> Array[ModelInfo]
     def mcp_server_status: () -> Array[McpServerStatus]
@@ -943,6 +947,7 @@ module ClaudeAgent
     def set_mcp_servers: (Hash[String, untyped] servers) -> McpSetServersResult
     def mcp_reconnect: (String server_name) -> Hash[String, untyped]
     def mcp_toggle: (String server_name, enabled: bool) -> Hash[String, untyped]
+    def stop_task: (String task_id) -> Hash[String, untyped]
     def supported_commands: () -> Array[SlashCommand]
     def supported_models: () -> Array[ModelInfo]
     def mcp_server_status: () -> Array[McpServerStatus]

metadata

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