claude-agent-sdk 0.32.0 → 0.33.0

data/lib/claude_agent_sdk.rb

@@ -302,6 +302,15 @@ module ClaudeAgentSDK
     Sessions.list_subagents(session_id: session_id, directory: directory)
   end
 
+  # Read a subagent's optional metadata (not live status) from local disk.
+  # @param session_id [String] The parent session UUID
+  # @param agent_id [String] The subagent ID, without the agent- prefix
+  # @param directory [String, nil] Project directory to search in
+  # @return [Hash{String => Object}, nil] CLI metadata, or nil if unavailable
+  def self.get_subagent_metadata(session_id:, agent_id:, directory: nil)
+    Sessions.get_subagent_metadata(session_id: session_id, agent_id: agent_id, directory: directory)
+  end
+
   # Read a subagent's conversation messages from local disk
   # @param session_id [String] The session UUID
   # @param agent_id [String] The subagent ID (without the agent- prefix)
@@ -394,6 +403,13 @@ module ClaudeAgentSDK
     Sessions.list_subagents_from_store(session_store: session_store, session_id: session_id, directory: directory)
   end
 
+  # Read the latest subagent metadata from a SessionStore, without its synthetic type marker.
+  # @return [Hash{String => Object}, nil]
+  def self.get_subagent_metadata_from_store(session_store:, session_id:, agent_id:, directory: nil)
+    Sessions.get_subagent_metadata_from_store(session_store: session_store, session_id: session_id,
+                                              agent_id: agent_id, directory: directory)
+  end
+
   # Read a subagent's conversation messages from a SessionStore.
   # @return [Array<SessionMessage>]
   def self.get_subagent_messages_from_store(session_store:, session_id:, agent_id:, directory: nil, limit: nil,
@@ -572,6 +588,7 @@ module ClaudeAgentSDK
           system_prompt_snapshot: ClaudeAgentSDK.extract_system_prompt_snapshot(configured_options.system_prompt),
           skills: configured_options.skills,
           forward_subagent_text: configured_options.forward_subagent_text?,
+          agent_progress_summaries: configured_options.agent_progress_summaries,
           callback_scheduling: callback_scheduling,
           callback_wrapper: callback_wrapper
         )
@@ -969,6 +986,31 @@ module ClaudeAgentSDK
       @query_handler.stop_task(task_id)
     end
 
+    # Background in-flight foreground tasks (Bash commands and subagents) — the
+    # control-request equivalent of pressing Ctrl+B in the terminal. Each
+    # blocking tool call returns a "running in the background" tool_result and
+    # the turn continues; the task keeps running and emits a
+    # TaskNotificationMessage when it settles.
+    #
+    # The targeted form reports its outcome: `{ backgrounded: true }`, or
+    # `{ backgrounded: false }` — a definitive miss (no matching foreground
+    # task), so do not wait for an event after it. The all-tasks form returns
+    # `{}` and says nothing about whether any task existed. Observe
+    # TaskUpdatedMessage#is_backgrounded / BackgroundTasksChangedMessage for the
+    # lifecycle state that follows.
+    #
+    # @param tool_use_id [String, nil] The id of the tool_use block that spawned
+    #   the task — NOT a task_id or agent_id. nil is the explicit all-tasks form.
+    #   Never substitute nil or '' for a per-task id you do not have yet
+    #   (TaskStartedMessage#tool_use_id is optional on the wire)
+    # @return [Hash] `{ backgrounded: true/false }` when tool_use_id was given,
+    #   `{}` otherwise
+    # @raise [ArgumentError] if tool_use_id is neither nil nor a non-empty String
+    def background_tasks(tool_use_id: nil)
+      raise CLIConnectionError, 'Not connected. Call connect() first' unless @connected
+      @query_handler.background_tasks(tool_use_id: tool_use_id)
+    end
+
     # Rewind files to a previous checkpoint (v0.1.15+)
     # Restores file state to what it was at the given user message
     # Requires enable_file_checkpointing to be true in options
@@ -1102,6 +1144,7 @@ module ClaudeAgentSDK
         system_prompt_snapshot: system_prompt_snapshot,
         skills: configured_options.skills,
         forward_subagent_text: configured_options.forward_subagent_text?,
+        agent_progress_summaries: configured_options.agent_progress_summaries,
         callback_scheduling: @callback_scheduling,
         callback_wrapper: @callback_wrapper
       )

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: claude-agent-sdk
 version: !ruby/object:Gem::Version
-  version: 0.32.0
+  version: 0.33.0
 platform: ruby
 authors:
 - Community Contributors
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-17 00:00:00.000000000 Z
+date: 2026-09-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async
@@ -119,9 +119,11 @@ files:
 - docs/observability.md
 - docs/rails.md
 - docs/sessions.md
+- docs/subagents.md
 - docs/types.md
 - lib/claude-agent-sdk.rb
 - lib/claude_agent_sdk.rb
+- lib/claude_agent_sdk/cancellation_signal.rb
 - lib/claude_agent_sdk/cli_installer.rb
 - lib/claude_agent_sdk/command_builder.rb
 - lib/claude_agent_sdk/configuration.rb