claude-agent-sdk 0.8.1 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b625dde6e1777c93be6e4bcfb6c9565087d798d414a03078f8de4184c39dfa7f
-  data.tar.gz: 30117f8eac89f94aabae5c37fdc12c012ed779a0f1c58062d70e9b727ee5ce3c
+  metadata.gz: 52b6649f2a72ef33e746d168e4016dcc72c1439157fbe5b971edbd55b0a0d404
+  data.tar.gz: a344cc38d96ef7185630c1e1518a5cf6d08a855f40b39092728236d5a48df50d
 SHA512:
-  metadata.gz: 2a36e3ff75415bb4c2f42b27a8280b4828199af2972d20aa5fa4366a24daefd325e5a11c3e39ee9396144561c98e2ea1ddcc94157b80fc7aeef72f58a526e36b
-  data.tar.gz: f0fde6a0779679869bd4d6607f7220ea016c021896a97a421be650e169ef53719d5810cf614613c7cb52b24c19ebbf2f3908f3cc49f07bc5b13aa58f377e1a8b
+  metadata.gz: 18a32d856585a36aa39a9aa586829a305c099cd4686a338e6f1df5310490abb81808821940a6be5d6c830a1fc86cb1cd95dab5ca8e2c5737574e3e91da513f5f
+  data.tar.gz: c6dadb9b32d373e1fac9246b5bafc8456f3779cf0187abceb7bd85ecdd96b823c95c49c751db9bcd4b384ceb34141057b9e48d4540366d1e3d7d951a69e0aa7f

data/CHANGELOG.md

@@ -5,6 +5,27 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.9.0] - 2026-03-12
+
+Port of Python SDK v0.1.48 parity improvements.
+
+### Added
+
+#### Typed Rate Limit Events
+- `RateLimitInfo` class with `status`, `resets_at`, `rate_limit_type`, `utilization`, `overage_status`, `overage_resets_at`, `overage_disabled_reason`, `raw` attributes
+- `RATE_LIMIT_STATUSES` constant (`allowed`, `allowed_warning`, `rejected`)
+- `RATE_LIMIT_TYPES` constant (`five_hour`, `seven_day`, `seven_day_opus`, `seven_day_sonnet`, `overage`)
+- `RateLimitEvent` now has typed `rate_limit_info`, `uuid`, `session_id` attributes (previously raw `data` hash)
+- Backward-compatible `data` accessor on `RateLimitEvent` returns raw hash from `rate_limit_info.raw`
+
+#### MCP Status Output Types
+- `McpClaudeAIProxyServerConfig` type for `claudeai-proxy` servers in MCP status responses
+- `McpSdkServerConfigStatus` type for serializable SDK server config in status responses
+- `McpServerStatus.parse` handles `claudeai-proxy` config type
+
+#### Effort Level
+- `effort` option now supports `"max"` value in addition to `"low"`, `"medium"`, `"high"`
+
 ## [0.8.1] - 2026-03-08
 
 Python SDK parity fixes for one-shot `query()` control protocol and CLI transport.

data/lib/claude_agent_sdk/message_parser.rb

@@ -120,7 +120,23 @@ module ClaudeAgentSDK
     end
 
     def self.parse_rate_limit_event(data)
-      RateLimitEvent.new(data: data)
+      info = data[:rate_limit_info] || {}
+      rate_limit_info = RateLimitInfo.new(
+        status: info[:status],
+        resets_at: info[:resetsAt],
+        rate_limit_type: info[:rateLimitType],
+        utilization: info[:utilization],
+        overage_status: info[:overageStatus],
+        overage_resets_at: info[:overageResetsAt],
+        overage_disabled_reason: info[:overageDisabledReason],
+        raw: info
+      )
+      RateLimitEvent.new(
+        rate_limit_info: rate_limit_info,
+        uuid: data[:uuid],
+        session_id: data[:session_id],
+        raw_data: data
+      )
     end
 
     def self.parse_content_block(block)

data/lib/claude_agent_sdk/subprocess_cli_transport.rb

@@ -75,14 +75,14 @@ module ClaudeAgentSDK
       elsif @options.system_prompt.is_a?(String)
         cmd.concat(['--system-prompt', @options.system_prompt])
       elsif @options.system_prompt.is_a?(SystemPromptPreset)
-        cmd.concat(['--system-prompt-preset', @options.system_prompt.preset]) if @options.system_prompt.preset
+        # Preset activates the default Claude Code system prompt by not passing --system-prompt ""
+        # Only --append-system-prompt is passed if append text is provided
         cmd.concat(['--append-system-prompt', @options.system_prompt.append]) if @options.system_prompt.append
       elsif @options.system_prompt.is_a?(Hash)
         prompt_type = @options.system_prompt[:type] || @options.system_prompt['type']
         if prompt_type == 'preset'
-          preset = @options.system_prompt[:preset] || @options.system_prompt['preset']
           append = @options.system_prompt[:append] || @options.system_prompt['append']
-          cmd.concat(['--system-prompt-preset', preset]) if preset
+          # Preset activates the default Claude Code system prompt by not passing --system-prompt ""
           cmd.concat(['--append-system-prompt', append]) if append
         end
       end
@@ -107,7 +107,7 @@ module ClaudeAgentSDK
       thinking_tokens = resolve_thinking_tokens
       cmd.concat(['--max-thinking-tokens', thinking_tokens.to_s]) unless thinking_tokens.nil?
 
-      # Effort level
+      # Effort level (valid values: low, medium, high, max)
       cmd.concat(['--effort', @options.effort.to_s]) if @options.effort
 
       # Betas option for enabling experimental features

data/lib/claude_agent_sdk/types.rb

@@ -212,12 +212,44 @@ module ClaudeAgentSDK
     end
   end
 
-  # Rate limit event emitted by Claude Code CLI when API rate limits are hit
+  # Type constants for rate limit statuses
+  RATE_LIMIT_STATUSES = %w[allowed allowed_warning rejected].freeze
+
+  # Type constants for rate limit types
+  RATE_LIMIT_TYPES = %w[five_hour seven_day seven_day_opus seven_day_sonnet overage].freeze
+
+  # Rate limit info with typed fields
+  class RateLimitInfo
+    attr_accessor :status, :resets_at, :rate_limit_type, :utilization,
+                  :overage_status, :overage_resets_at, :overage_disabled_reason, :raw
+
+    def initialize(status:, resets_at: nil, rate_limit_type: nil, utilization: nil,
+                   overage_status: nil, overage_resets_at: nil, overage_disabled_reason: nil, raw: {})
+      @status = status
+      @resets_at = resets_at
+      @rate_limit_type = rate_limit_type
+      @utilization = utilization
+      @overage_status = overage_status
+      @overage_resets_at = overage_resets_at
+      @overage_disabled_reason = overage_disabled_reason
+      @raw = raw
+    end
+  end
+
+  # Rate limit event emitted when rate limit info changes
   class RateLimitEvent
-    attr_accessor :data
+    attr_accessor :rate_limit_info, :uuid, :session_id
 
-    def initialize(data:)
-      @data = data
+    def initialize(rate_limit_info:, uuid:, session_id:, raw_data: nil)
+      @rate_limit_info = rate_limit_info
+      @uuid = uuid
+      @session_id = session_id
+      @raw_data = raw_data
+    end
+
+    # Backward-compatible accessor returning the full raw event payload
+    def data
+      @raw_data || {}
     end
   end
 
@@ -753,6 +785,37 @@ module ClaudeAgentSDK
     end
   end
 
+  # Output-only serializable version of McpSdkServerConfig (without live instance)
+  # Returned in MCP status responses
+  class McpSdkServerConfigStatus
+    attr_accessor :type, :name
+
+    def initialize(type: 'sdk', name:)
+      @type = type
+      @name = name
+    end
+
+    def to_h
+      { type: @type, name: @name }
+    end
+  end
+
+  # Claude.ai proxy MCP server config
+  # Output-only type that appears in status responses for servers proxied through Claude.ai
+  class McpClaudeAIProxyServerConfig
+    attr_accessor :type, :url, :id
+
+    def initialize(type: 'claudeai-proxy', url:, id:)
+      @type = type
+      @url = url
+      @id = id
+    end
+
+    def to_h
+      { type: @type, url: @url, id: @id }
+    end
+  end
+
   # Status of a single MCP server connection
   class McpServerStatus
     attr_accessor :name, :status, :server_info, :error, :config, :scope, :tools
@@ -770,17 +833,31 @@ module ClaudeAgentSDK
     def self.parse(data)
       server_info = (McpServerInfo.new(name: data[:serverInfo][:name], version: data[:serverInfo][:version]) if data[:serverInfo])
       tools = data[:tools]&.map { |t| McpToolInfo.parse(t) }
+      config = parse_config(data[:config])
 
       new(
         name: data[:name],
         status: data[:status],
         server_info: server_info,
         error: data[:error],
-        config: data[:config],
+        config: config,
         scope: data[:scope],
         tools: tools
       )
     end
+
+    def self.parse_config(config)
+      return config unless config.is_a?(Hash) && config[:type]
+
+      case config[:type]
+      when 'claudeai-proxy'
+        McpClaudeAIProxyServerConfig.new(url: config[:url], id: config[:id])
+      when 'sdk'
+        McpSdkServerConfigStatus.new(name: config[:name])
+      else
+        config
+      end
+    end
   end
 
   # Response from get_mcp_status containing all server statuses

data/lib/claude_agent_sdk/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ClaudeAgentSDK
-  VERSION = '0.8.1'
+  VERSION = '0.9.0'
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: claude-agent-sdk
 version: !ruby/object:Gem::Version
-  version: 0.8.1
+  version: 0.9.0
 platform: ruby
 authors:
 - Community Contributors
 bindir: bin
 cert_chain: []
-date: 2026-03-07 00:00:00.000000000 Z
+date: 2026-03-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async