claude_agent 0.7.2 → 0.7.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a975c8190094b78c316e158db7bc1ba0a6bcde1d64ff1e92ada4787e13a9c756
-  data.tar.gz: 7ee6a218923b9734f524f95b372711d6f2b31bcb941b9364b381f210104b2726
+  metadata.gz: d2d8740456b8efad6aadef1d23c3979de66aac32836f40d87db7f9d5766505fb
+  data.tar.gz: aaed4a958504810589552f424094edf52d86732f81780d5525208dab297cb964
 SHA512:
-  metadata.gz: 0f75560464b82fa334a168c8dc46241608a3effd288e4537dc44fbb5182df6c1006e87c60dca19a3473813816c6709c868f842c934acb3fc29dd3852ec29fd71
-  data.tar.gz: 9b004ea2c7c510efe51801bf9d6170a21896a4d3593ea9566f9683c40e9edf60a76eaf81d1426970cfe1313df7f3176486529b7caaa5c29ccaf96fed86456df3
+  metadata.gz: a4b3f2d325aad7faa519896e90016a9518ad8285a45dd315936712f0e10548cb2fec0ba77efb191b86aeb265a2bdb43ecb9bb49115efe097092a2fe5a0d250cb
+  data.tar.gz: f98723ebf5568c280ac6ea69b767da4d1065760a9eeee1d3ad990191d3553ddbf8deb3ee6cca36a1cd08fe0c8e82125026ec4ba95c158abe36406b8ec173fead

data/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.7.3] - 2026-02-06
+
+### Added
+- `session_id` option for custom conversation UUIDs (`--session-id` CLI flag)
+- `TeammateIdle` hook event with `TeammateIdleInput` (TypeScript SDK v0.2.33 parity)
+- `TaskCompleted` hook event with `TaskCompletedInput` (TypeScript SDK v0.2.33 parity)
+
+### Changed
+- Updated SPEC.md to reflect full TypeScript SDK v0.2.34 parity
+
 ## [0.7.2] - 2026-02-05
 
 ### 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.32 (npm package)
-- Python SDK: v0.1.30 from GitHub (commit 451f2f4)
+- TypeScript SDK: v0.2.34 (npm package)
+- Python SDK: v0.1.31 from GitHub (commit 4b19642)
 - Ruby SDK: This repository
 
-**Last Updated:** 2026-02-05
+**Last Updated:** 2026-02-06
 
 ---
 
@@ -50,6 +50,7 @@ Configuration options for SDK queries and clients.
 | `maxThinkingTokens`               |     ✅      |   ✅    |  ✅   | Max thinking tokens                                          |
 | `continue`                        |     ✅      |   ✅    |  ✅   | Continue most recent conversation                            |
 | `resume`                          |     ✅      |   ✅    |  ✅   | Resume session by ID                                         |
+| `sessionId`                       |     ✅      |   ❌    |  ✅   | Custom UUID for conversations (v0.2.33)                      |
 | `resumeSessionAt`                 |     ✅      |   ❌    |  ✅   | Resume to specific message UUID                              |
 | `forkSession`                     |     ✅      |   ✅    |  ✅   | Fork on resume                                               |
 | `persistSession`                  |     ✅      |   ❌    |  ✅   | Whether to persist to disk                                   |
@@ -230,15 +231,15 @@ Bidirectional control protocol for SDK-CLI communication.
 
 ### Return Types
 
-| Type                  | TypeScript | Python | Ruby | Notes                  |
-|-----------------------|:----------:|:------:|:----:|------------------------|
-| `SlashCommand`        |     ✅      |   ❌    |  ✅   | Available command info |
-| `ModelInfo`           |     ✅      |   ❌    |  ✅   | Model information      |
-| `McpServerStatus`     |     ✅      |   ❌    |  ✅   | MCP server status      |
-| `AccountInfo`         |     ✅      |   ❌    |  ✅   | Account information    |
-| `InitializationResult`|     ✅      |   ❌    |  ✅   | Full init response     |
-| `McpSetServersResult` |     ✅      |   ❌    |  ✅   | Set servers result     |
-| `RewindFilesResult`   |     ✅      |   ✅    |  ✅   | Rewind result          |
+| Type                   | TypeScript | Python | Ruby | Notes                  |
+|------------------------|:----------:|:------:|:----:|------------------------|
+| `SlashCommand`         |     ✅      |   ❌    |  ✅   | Available command info |
+| `ModelInfo`            |     ✅      |   ❌    |  ✅   | Model information      |
+| `McpServerStatus`      |     ✅      |   ❌    |  ✅   | MCP server status      |
+| `AccountInfo`          |     ✅      |   ❌    |  ✅   | Account information    |
+| `InitializationResult` |     ✅      |   ❌    |  ✅   | Full init response     |
+| `McpSetServersResult`  |     ✅      |   ❌    |  ✅   | Set servers result     |
+| `RewindFilesResult`    |     ✅      |   ✅    |  ✅   | Rewind result          |
 
 ---
 
@@ -263,6 +264,8 @@ Event hooks for intercepting and modifying SDK behavior.
 | `PreCompact`         |     ✅      |   ✅    |  ✅   | Before compaction         |
 | `PermissionRequest`  |     ✅      |   ✅    |  ✅   | Permission requested      |
 | `Setup`              |     ✅      |   ❌    |  ✅   | Initial setup/maintenance |
+| `TeammateIdle`       |     ✅      |   ❌    |  ✅   | Teammate idle (v0.2.33)   |
+| `TaskCompleted`      |     ✅      |   ❌    |  ✅   | Task completed (v0.2.33)  |
 
 ### Hook Input Types
 
@@ -281,6 +284,8 @@ Event hooks for intercepting and modifying SDK behavior.
 | `PreCompactHookInput`         |     ✅      |   ✅    |  ✅   |
 | `PermissionRequestHookInput`  |     ✅      |   ✅    |  ✅   |
 | `SetupHookInput`              |     ✅      |   ❌    |  ✅   |
+| `TeammateIdleHookInput`       |     ✅      |   ❌    |  ✅   |
+| `TaskCompletedHookInput`      |     ✅      |   ❌    |  ✅   |
 
 ### Hook Output Types
 
@@ -668,16 +673,16 @@ Public API surface for SDK clients.
 - Full source available
 - Has `Transport` abstract class and several query control methods
 - Query supports: `interrupt()`, `set_permission_mode()`, `set_model()`, `rewind_files()`, `stream_input()`, `close()`, `get_mcp_status()`
-- Client supports: `interrupt()`, `set_permission_mode()`, `set_model()`, `rewind_files()`, `get_mcp_status()`
-- Missing hooks: SessionStart, SessionEnd, Setup
+- Client supports: `interrupt()`, `set_permission_mode()`, `set_model()`, `rewind_files()`, `get_mcp_status()`, `get_server_info()`
+- Missing hooks: SessionStart, SessionEnd, Setup, TeammateIdle, TaskCompleted
 - Missing permission modes: `delegate`, `dontAsk`
-- Missing options: `allowDangerouslySkipPermissions`, `persistSession`, `resumeSessionAt`, `strictMcpConfig`, `init`/`initOnly`/`maintenance`, `debug`/`debugFile`
+- Missing options: `allowDangerouslySkipPermissions`, `persistSession`, `resumeSessionAt`, `sessionId`, `strictMcpConfig`, `init`/`initOnly`/`maintenance`, `debug`/`debugFile`
 - `ToolPermissionContext` missing `blockedPath`, `decisionReason`, `toolUseID`, `agentID`
-- Now has `additionalContext` in `PreToolUseHookSpecificOutput` (added in v0.1.30)
-- Now has `create_sdk_mcp_server`, `tool()` helper, and MCP tool annotations (added in v0.1.30)
+- Has `additionalContext` in `PreToolUseHookSpecificOutput` (added in v0.1.30)
+- Has `create_sdk_mcp_server`, `tool()` helper, and MCP tool annotations (added in v0.1.30/v0.1.31)
 
 ### Ruby SDK (This Repository)
-- Full TypeScript SDK v0.2.32 feature parity
+- Full TypeScript SDK v0.2.34 feature parity (v0.2.34 contains no new SDK features beyond a Claude Code version bump)
 - 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/hooks.rb

@@ -16,6 +16,8 @@ module ClaudeAgent
     PreCompact
     PermissionRequest
     Setup
+    TeammateIdle
+    TaskCompleted
   ].freeze
 
   # Matcher configuration for hooks
@@ -259,4 +261,42 @@ module ClaudeAgent
       trigger == "maintenance"
     end
   end
+
+  # Input for TeammateIdle hook (TypeScript SDK v0.2.33 parity)
+  #
+  # Fired when a teammate becomes idle.
+  #
+  class TeammateIdleInput < BaseHookInput
+    attr_reader :teammate_name, :team_name
+
+    # @param teammate_name [String] Name of the idle teammate
+    # @param team_name [String] Name of the team
+    def initialize(teammate_name:, team_name:, **kwargs)
+      super(hook_event_name: "TeammateIdle", **kwargs)
+      @teammate_name = teammate_name
+      @team_name = team_name
+    end
+  end
+
+  # Input for TaskCompleted hook (TypeScript SDK v0.2.33 parity)
+  #
+  # Fired when a task completes.
+  #
+  class TaskCompletedInput < BaseHookInput
+    attr_reader :task_id, :task_subject, :task_description, :teammate_name, :team_name
+
+    # @param task_id [String] ID of the completed task
+    # @param task_subject [String] Subject of the completed task
+    # @param task_description [String, nil] Description of the completed task
+    # @param teammate_name [String, nil] Name of the teammate that completed the task
+    # @param team_name [String, nil] Name of the team
+    def initialize(task_id:, task_subject:, task_description: nil, teammate_name: nil, team_name: nil, **kwargs)
+      super(hook_event_name: "TaskCompleted", **kwargs)
+      @task_id = task_id
+      @task_subject = task_subject
+      @task_description = task_description
+      @teammate_name = teammate_name
+      @team_name = team_name
+    end
+  end
 end

data/lib/claude_agent/options.rb

@@ -52,7 +52,7 @@ module ClaudeAgent
       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
+      continue_conversation resume fork_session resume_session_at session_id
       max_turns max_budget_usd max_thinking_tokens
       strict_mcp_config mcp_servers hooks
       settings sandbox cwd add_dirs env user agent
@@ -179,6 +179,7 @@ module ClaudeAgent
         args.push("--resume", resume) if resume
         args.push("--fork-session") if fork_session
         args.push("--resume-session-at", resume_session_at) if resume_session_at
+        args.push("--session-id", session_id) if session_id
       end
     end
 
@@ -287,6 +288,10 @@ module ClaudeAgent
         raise ConfigurationError, "max_budget_usd must be a positive number"
       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
+
       setup_options = [ init, init_only, maintenance ].count { |opt| opt }
       if setup_options > 1
         raise ConfigurationError, "Only one of init, init_only, or maintenance can be set at a time"

data/lib/claude_agent/version.rb

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

data/sig/claude_agent.rbs

@@ -265,6 +265,7 @@ module ClaudeAgent
     attr_accessor resume: String?
     attr_accessor fork_session: bool
     attr_accessor resume_session_at: String?
+    attr_accessor session_id: String?
     attr_accessor persist_session: bool
 
     # Limits & budget
@@ -768,6 +769,31 @@ module ClaudeAgent
     def initialize: (tool_name: String, tool_input: Hash[String, untyped], ?permission_suggestions: untyped, **untyped) -> void
   end
 
+  class SetupInput < BaseHookInput
+    attr_reader trigger: String
+
+    def initialize: (trigger: String, **untyped) -> void
+    def init?: () -> bool
+    def maintenance?: () -> bool
+  end
+
+  class TeammateIdleInput < BaseHookInput
+    attr_reader teammate_name: String
+    attr_reader team_name: String
+
+    def initialize: (teammate_name: String, team_name: String, **untyped) -> void
+  end
+
+  class TaskCompletedInput < BaseHookInput
+    attr_reader task_id: String
+    attr_reader task_subject: String
+    attr_reader task_description: String?
+    attr_reader teammate_name: String?
+    attr_reader team_name: String?
+
+    def initialize: (task_id: String, task_subject: String, ?task_description: String?, ?teammate_name: String?, ?team_name: String?, **untyped) -> void
+  end
+
   # Permission types
   type permission_result = PermissionResultAllow | PermissionResultDeny
 

metadata

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