anthropic 1.72.0 → 1.74.0

data/rbi/anthropic/models/beta/sessions/beta_managed_agents_stream_session_thread_events.rbi

@@ -320,10 +320,7 @@ module Anthropic
               name: String,
               mcp_server_name: String,
               evaluated_permission:
-                T.any(
-                  Anthropic::Beta::Sessions::BetaManagedAgentsAgentMCPToolUseEvent::EvaluatedPermission::OrSymbol,
-                  Anthropic::Beta::Sessions::BetaManagedAgentsAgentToolUseEvent::EvaluatedPermission::OrSymbol
-                ),
+                Anthropic::Beta::Sessions::BetaManagedAgentsAgentEvaluatedPermission::OrSymbol,
               evaluation:
                 T.any(
                   Anthropic::Beta::Sessions::BetaManagedAgentsAgentToolEvaluationAlwaysAllow::OrHash,
@@ -400,13 +397,13 @@ module Anthropic
             id: nil,
             # Array of content blocks comprising the user message.
             content: nil,
-            # A timestamp in RFC 3339 format
+            # Timestamp when the agent finished processing this message.
             processed_at: nil,
             # If absent, interrupts every non-archived thread in a multiagent session (or the
             # primary alone in a single-agent session). If present, interrupts only the named
             # thread.
             session_thread_id: nil,
-            # UserToolConfirmationResult enum
+            # The confirmation result: 'allow' or 'deny'.
             result: nil,
             # The id of the `agent.tool_use` or `agent.mcp_tool_use` event this result
             # corresponds to, which can be found in the last `session.status_idle`
@@ -429,11 +426,15 @@ module Anthropic
             name: nil,
             # Name of the MCP server providing the tool.
             mcp_server_name: nil,
-            # AgentEvaluatedPermission enum
+            # The evaluated permission policy for this tool invocation.
             evaluated_permission: nil,
-            # Names the resolved permission_policy that produced evaluated_permission, and
-            # under auto carries the judgement. Open union: clients must tolerate unknown
-            # variants.
+            # Which resolved permission_policy produced evaluated_permission: always_allow,
+            # always_ask, or auto (with the server's per-invocation judgement). Absent only
+            # when the server refused the call before any policy applied (for example, the
+            # named tool is not enabled in the session); such a refusal has
+            # evaluated_permission deny. An event recorded before this field existed reads as
+            # the arm its evaluated_permission implies (always_allow for allow, always_ask for
+            # ask).
             evaluation: nil,
             # The id of the `agent.mcp_tool_use` event this result corresponds to.
             mcp_tool_use_id: nil,
@@ -461,23 +462,27 @@ module Anthropic
             explanation: nil,
             # The id of the corresponding `span.outcome_evaluation_start` event.
             outcome_evaluation_start_id: nil,
-            # Token usage for a single model request.
+            # Aggregate token usage for this evaluation cycle. Sums across all grader model
+            # requests within the cycle.
             usage: nil,
             # The id of the corresponding `span.model_request_start` event.
             model_request_start_id: nil,
-            # Token usage for a single model request.
+            # Token usage for this model request.
             model_usage: nil,
             # What the agent should produce. Copied from the input event.
             description: nil,
             # Evaluate-then-revise cycles before giving up. Default 3, max 20.
             max_iterations: nil,
-            # Rubric for grading the quality of an outcome.
+            # How to grade the outcome. File rubrics are currently resolved to their text
+            # content; clients should handle both variants.
             rubric: nil,
-            # Resolved `agent` definition for a `session`. Snapshot of the `agent` at
-            # `session` creation time.
+            # The session's effective agent configuration after the update. Present only when
+            # the update changed `agent` (tools or mcp_servers); when present it is the full
+            # materialised snapshot, not a diff.
             agent: nil,
-            # A hard spend ceiling. The session stops issuing new model requests once the
-            # tracked list cost reaches `max_list_cost`.
+            # The session's budget after the update: the new budget when set or replaced, or
+            # null when the update removed it. Present only when the update changed the
+            # budget.
             budget: nil,
             # The session's full metadata bag after the update. Present when the update set
             # non-empty metadata; absent when metadata was unchanged or cleared to empty.

data/rbi/anthropic/models/beta/sessions/beta_managed_agents_unknown_error.rbi

@@ -17,7 +17,7 @@ module Anthropic
           sig { returns(String) }
           attr_accessor :message
 
-          # What the client should do next in response to this error.
+          # What the client should do next.
           sig do
             returns(
               Anthropic::Beta::Sessions::BetaManagedAgentsUnknownError::RetryStatus::Variants
@@ -51,7 +51,7 @@ module Anthropic
           def self.new(
             # Human-readable error description.
             message:,
-            # What the client should do next in response to this error.
+            # What the client should do next.
             retry_status:,
             type:
           )
@@ -71,7 +71,7 @@ module Anthropic
           def to_hash
           end
 
-          # What the client should do next in response to this error.
+          # What the client should do next.
           module RetryStatus
             extend Anthropic::Internal::Type::Union
 

data/rbi/anthropic/models/beta/sessions/beta_managed_agents_user_custom_tool_result_event.rbi

@@ -62,7 +62,7 @@ module Anthropic
           sig { returns(T.nilable(T::Boolean)) }
           attr_accessor :is_error
 
-          # A timestamp in RFC 3339 format
+          # Timestamp when this result was processed.
           sig { returns(T.nilable(Time)) }
           attr_accessor :processed_at
 
@@ -105,7 +105,7 @@ module Anthropic
             content: nil,
             # Whether the tool execution resulted in an error.
             is_error: nil,
-            # A timestamp in RFC 3339 format
+            # Timestamp when this result was processed.
             processed_at: nil,
             # Set by the server to the subagent thread this result was routed to. Omitted when
             # it was routed to the primary thread.
@@ -269,13 +269,13 @@ module Anthropic
               type:,
               # The text content.
               text: nil,
-              # Union type for image source variants.
+              # The source of the image data.
               source: nil,
               # Additional context about the document for the model.
               context: nil,
               # The title of the document.
               title: nil,
-              # Citation settings for a search result.
+              # Citation settings for this search result.
               citations: nil,
               # Array of text content blocks from the search result.
               content: nil

data/rbi/anthropic/models/beta/sessions/beta_managed_agents_user_custom_tool_result_event_params.rbi

@@ -253,13 +253,13 @@ module Anthropic
               type:,
               # The text content.
               text: nil,
-              # Union type for image source variants.
+              # The source of the image data.
               source: nil,
               # Additional context about the document for the model.
               context: nil,
               # The title of the document.
               title: nil,
-              # Citation settings for a search result.
+              # Citation settings for this search result.
               citations: nil,
               # Array of text content blocks from the search result.
               content: nil

data/rbi/anthropic/models/beta/sessions/beta_managed_agents_user_define_outcome_event.rbi

@@ -30,11 +30,12 @@ module Anthropic
           sig { returns(String) }
           attr_accessor :outcome_id
 
-          # A timestamp in RFC 3339 format
+          # Timestamp when the outcome was accepted.
           sig { returns(Time) }
           attr_accessor :processed_at
 
-          # Rubric for grading the quality of an outcome.
+          # How to grade the outcome. File rubrics are currently resolved to their text
+          # content; clients should handle both variants.
           sig do
             returns(
               Anthropic::Beta::Sessions::BetaManagedAgentsUserDefineOutcomeEvent::Rubric::Variants
@@ -77,9 +78,10 @@ module Anthropic
             # Server-generated `outc_` ID for this outcome. Referenced by
             # `span.outcome_evaluation_*` events and the session's `outcome_evaluations` list.
             outcome_id:,
-            # A timestamp in RFC 3339 format
+            # Timestamp when the outcome was accepted.
             processed_at:,
-            # Rubric for grading the quality of an outcome.
+            # How to grade the outcome. File rubrics are currently resolved to their text
+            # content; clients should handle both variants.
             rubric:,
             type:
           )
@@ -103,7 +105,8 @@ module Anthropic
           def to_hash
           end
 
-          # Rubric for grading the quality of an outcome.
+          # How to grade the outcome. File rubrics are currently resolved to their text
+          # content; clients should handle both variants.
           module Rubric
             extend Anthropic::Internal::Type::Union
 

data/rbi/anthropic/models/beta/sessions/beta_managed_agents_user_define_outcome_event_params.rbi

@@ -17,7 +17,7 @@ module Anthropic
           sig { returns(String) }
           attr_accessor :description
 
-          # Rubric for grading the quality of an outcome.
+          # How to grade the outcome. Text or file reference.
           sig do
             returns(
               T.any(
@@ -57,7 +57,7 @@ module Anthropic
           def self.new(
             # What the agent should produce. This is the task specification.
             description:,
-            # Rubric for grading the quality of an outcome.
+            # How to grade the outcome. Text or file reference.
             rubric:,
             type:,
             # Eval→revision cycles before giving up. Default 3, max 20.
@@ -83,7 +83,7 @@ module Anthropic
           def to_hash
           end
 
-          # Rubric for grading the quality of an outcome.
+          # How to grade the outcome. Text or file reference.
           module Rubric
             extend Anthropic::Internal::Type::Union
 

data/rbi/anthropic/models/beta/sessions/beta_managed_agents_user_interrupt_event.rbi

@@ -24,7 +24,7 @@ module Anthropic
           end
           attr_accessor :type
 
-          # A timestamp in RFC 3339 format
+          # Timestamp when the interrupt was processed.
           sig { returns(T.nilable(Time)) }
           attr_accessor :processed_at
 
@@ -48,7 +48,7 @@ module Anthropic
             # Unique identifier for this event.
             id:,
             type:,
-            # A timestamp in RFC 3339 format
+            # Timestamp when the interrupt was processed.
             processed_at: nil,
             # If absent, interrupts every non-archived thread in a multiagent session (or the
             # primary alone in a single-agent session). If present, interrupts only the named

data/rbi/anthropic/models/beta/sessions/beta_managed_agents_user_message_event.rbi

@@ -34,7 +34,7 @@ module Anthropic
           end
           attr_accessor :type
 
-          # A timestamp in RFC 3339 format
+          # Timestamp when the agent finished processing this message.
           sig { returns(T.nilable(Time)) }
           attr_accessor :processed_at
 
@@ -62,7 +62,7 @@ module Anthropic
             # Array of content blocks comprising the user message.
             content:,
             type:,
-            # A timestamp in RFC 3339 format
+            # Timestamp when the agent finished processing this message.
             processed_at: nil
           )
           end
@@ -183,7 +183,7 @@ module Anthropic
               type:,
               # The text content.
               text: nil,
-              # Union type for image source variants.
+              # The source of the image data.
               source: nil,
               # Additional context about the document for the model.
               context: nil,

data/rbi/anthropic/models/beta/sessions/beta_managed_agents_user_message_event_params.rbi

@@ -177,7 +177,7 @@ module Anthropic
               type:,
               # The text content.
               text: nil,
-              # Union type for image source variants.
+              # The source of the image data.
               source: nil,
               # Additional context about the document for the model.
               context: nil,

data/rbi/anthropic/models/beta/sessions/beta_managed_agents_user_tool_confirmation_event.rbi

@@ -17,7 +17,7 @@ module Anthropic
           sig { returns(String) }
           attr_accessor :id
 
-          # UserToolConfirmationResult enum
+          # The confirmation result: 'allow' or 'deny'.
           sig do
             returns(
               Anthropic::Beta::Sessions::BetaManagedAgentsUserToolConfirmationEvent::Result::TaggedSymbol
@@ -44,7 +44,7 @@ module Anthropic
           sig { returns(T.nilable(String)) }
           attr_accessor :deny_message
 
-          # A timestamp in RFC 3339 format
+          # Timestamp when the confirmation was processed.
           sig { returns(T.nilable(Time)) }
           attr_accessor :processed_at
 
@@ -70,7 +70,7 @@ module Anthropic
           def self.new(
             # Unique identifier for this event.
             id:,
-            # UserToolConfirmationResult enum
+            # The confirmation result: 'allow' or 'deny'.
             result:,
             # The id of the `agent.tool_use` or `agent.mcp_tool_use` event this result
             # corresponds to, which can be found in the last `session.status_idle`
@@ -81,7 +81,7 @@ module Anthropic
             # Optional message providing context for a 'deny' decision. Only allowed when
             # result is 'deny'.
             deny_message: nil,
-            # A timestamp in RFC 3339 format
+            # Timestamp when the confirmation was processed.
             processed_at: nil,
             # Set by the server to the subagent thread this confirmation was routed to.
             # Omitted when it was routed to the primary thread.
@@ -107,7 +107,7 @@ module Anthropic
           def to_hash
           end
 
-          # UserToolConfirmationResult enum
+          # The confirmation result: 'allow' or 'deny'.
           module Result
             extend Anthropic::Internal::Type::Enum
 

data/rbi/anthropic/models/beta/sessions/beta_managed_agents_user_tool_confirmation_event_params.rbi

@@ -13,7 +13,7 @@ module Anthropic
               )
             end
 
-          # UserToolConfirmationResult enum
+          # The confirmation result: 'allow' or 'deny'.
           sig do
             returns(
               Anthropic::Beta::Sessions::BetaManagedAgentsUserToolConfirmationEventParams::Result::OrSymbol
@@ -52,7 +52,7 @@ module Anthropic
             ).returns(T.attached_class)
           end
           def self.new(
-            # UserToolConfirmationResult enum
+            # The confirmation result: 'allow' or 'deny'.
             result:,
             # The id of the `agent.tool_use` or `agent.mcp_tool_use` event this result
             # corresponds to, which can be found in the last `session.status_idle`
@@ -81,7 +81,7 @@ module Anthropic
           def to_hash
           end
 
-          # UserToolConfirmationResult enum
+          # The confirmation result: 'allow' or 'deny'.
           module Result
             extend Anthropic::Internal::Type::Enum
 

data/rbi/anthropic/models/beta/sessions/beta_managed_agents_user_tool_result_event_params.rbi

@@ -255,13 +255,13 @@ module Anthropic
               type:,
               # The text content.
               text: nil,
-              # Union type for image source variants.
+              # The source of the image data.
               source: nil,
               # Additional context about the document for the model.
               context: nil,
               # The title of the document.
               title: nil,
-              # Citation settings for a search result.
+              # Citation settings for this search result.
               citations: nil,
               # Array of text content blocks from the search result.
               content: nil

data/rbi/anthropic/models/beta/sessions/event_list_params.rbi

@@ -51,7 +51,6 @@ module Anthropic
           sig { params(created_at_lte: Time).void }
           attr_writer :created_at_lte
 
-          # Query parameter for limit
           sig { returns(T.nilable(Integer)) }
           attr_reader :limit
 
@@ -85,10 +84,25 @@ module Anthropic
 
           # Filter by event type. Values match the `type` field on returned events (for
           # example, `user.message` or `agent.tool_use`). Omit to return all event types.
-          sig { returns(T.nilable(T::Array[String])) }
+          sig do
+            returns(
+              T.nilable(
+                T::Array[
+                  Anthropic::Beta::Sessions::BetaManagedAgentsSessionEventType::OrSymbol
+                ]
+              )
+            )
+          end
           attr_reader :types
 
-          sig { params(types: T::Array[String]).void }
+          sig do
+            params(
+              types:
+                T::Array[
+                  Anthropic::Beta::Sessions::BetaManagedAgentsSessionEventType::OrSymbol
+                ]
+            ).void
+          end
           attr_writer :types
 
           # Optional header to specify the beta version(s) you want to use.
@@ -108,6 +122,12 @@ module Anthropic
           end
           attr_writer :betas
 
+          # Optional header to select the Workspace for this request. The value is a
+          # Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+          #
+          # Only needed for credentials that can act on more than one Workspace. A
+          # credential that belongs to a specific Workspace may omit it; if sent, it must
+          # match that Workspace.
           sig { returns(T.nilable(String)) }
           attr_reader :workspace_id
 
@@ -125,7 +145,10 @@ module Anthropic
               order:
                 Anthropic::Beta::Sessions::EventListParams::Order::OrSymbol,
               page: String,
-              types: T::Array[String],
+              types:
+                T::Array[
+                  Anthropic::Beta::Sessions::BetaManagedAgentsSessionEventType::OrSymbol
+                ],
               betas:
                 T::Array[T.any(Anthropic::AnthropicBeta::OrSymbol, String)],
               workspace_id: String,
@@ -146,7 +169,6 @@ module Anthropic
             # Return events created at or before this time (inclusive). Compared against the
             # event's `processed_at` value.
             created_at_lte: nil,
-            # Query parameter for limit
             limit: nil,
             # Sort direction for results, ordered by the event's `processed_at`. Defaults to
             # `asc` (chronological).
@@ -158,6 +180,12 @@ module Anthropic
             types: nil,
             # Optional header to specify the beta version(s) you want to use.
             betas: nil,
+            # Optional header to select the Workspace for this request. The value is a
+            # Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+            #
+            # Only needed for credentials that can act on more than one Workspace. A
+            # credential that belongs to a specific Workspace may omit it; if sent, it must
+            # match that Workspace.
             workspace_id: nil,
             request_options: {}
           )
@@ -175,7 +203,10 @@ module Anthropic
                 order:
                   Anthropic::Beta::Sessions::EventListParams::Order::OrSymbol,
                 page: String,
-                types: T::Array[String],
+                types:
+                  T::Array[
+                    Anthropic::Beta::Sessions::BetaManagedAgentsSessionEventType::OrSymbol
+                  ],
                 betas:
                   T::Array[T.any(Anthropic::AnthropicBeta::OrSymbol, String)],
                 workspace_id: String,

data/rbi/anthropic/models/beta/sessions/event_send_params.rbi

@@ -54,6 +54,12 @@ module Anthropic
           end
           attr_writer :betas
 
+          # Optional header to select the Workspace for this request. The value is a
+          # Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+          #
+          # Only needed for credentials that can act on more than one Workspace. A
+          # credential that belongs to a specific Workspace may omit it; if sent, it must
+          # match that Workspace.
           sig { returns(T.nilable(String)) }
           attr_reader :workspace_id
 
@@ -87,6 +93,12 @@ module Anthropic
             events:,
             # Optional header to specify the beta version(s) you want to use.
             betas: nil,
+            # Optional header to select the Workspace for this request. The value is a
+            # Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+            #
+            # Only needed for credentials that can act on more than one Workspace. A
+            # credential that belongs to a specific Workspace may omit it; if sent, it must
+            # match that Workspace.
             workspace_id: nil,
             request_options: {}
           )

data/rbi/anthropic/models/beta/sessions/event_stream_params.rbi

@@ -63,6 +63,12 @@ module Anthropic
           end
           attr_writer :betas
 
+          # Optional header to select the Workspace for this request. The value is a
+          # Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+          #
+          # Only needed for credentials that can act on more than one Workspace. A
+          # credential that belongs to a specific Workspace may omit it; if sent, it must
+          # match that Workspace.
           sig { returns(T.nilable(String)) }
           attr_reader :workspace_id
 
@@ -95,6 +101,12 @@ module Anthropic
             event_deltas: nil,
             # Optional header to specify the beta version(s) you want to use.
             betas: nil,
+            # Optional header to select the Workspace for this request. The value is a
+            # Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+            #
+            # Only needed for credentials that can act on more than one Workspace. A
+            # credential that belongs to a specific Workspace may omit it; if sent, it must
+            # match that Workspace.
             workspace_id: nil,
             request_options: {}
           )

data/rbi/anthropic/models/beta/sessions/resource_add_params.rbi

@@ -36,6 +36,12 @@ module Anthropic
           end
           attr_writer :betas
 
+          # Optional header to select the Workspace for this request. The value is a
+          # Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+          #
+          # Only needed for credentials that can act on more than one Workspace. A
+          # credential that belongs to a specific Workspace may omit it; if sent, it must
+          # match that Workspace.
           sig { returns(T.nilable(String)) }
           attr_reader :workspace_id
 
@@ -55,6 +61,12 @@ module Anthropic
             session_id:,
             # Optional header to specify the beta version(s) you want to use.
             betas: nil,
+            # Optional header to select the Workspace for this request. The value is a
+            # Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+            #
+            # Only needed for credentials that can act on more than one Workspace. A
+            # credential that belongs to a specific Workspace may omit it; if sent, it must
+            # match that Workspace.
             workspace_id: nil,
             request_options: {}
           )

data/rbi/anthropic/models/beta/sessions/resource_delete_params.rbi

@@ -39,6 +39,12 @@ module Anthropic
           end
           attr_writer :betas
 
+          # Optional header to select the Workspace for this request. The value is a
+          # Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+          #
+          # Only needed for credentials that can act on more than one Workspace. A
+          # credential that belongs to a specific Workspace may omit it; if sent, it must
+          # match that Workspace.
           sig { returns(T.nilable(String)) }
           attr_reader :workspace_id
 
@@ -60,6 +66,12 @@ module Anthropic
             resource_id:,
             # Optional header to specify the beta version(s) you want to use.
             betas: nil,
+            # Optional header to select the Workspace for this request. The value is a
+            # Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+            #
+            # Only needed for credentials that can act on more than one Workspace. A
+            # credential that belongs to a specific Workspace may omit it; if sent, it must
+            # match that Workspace.
             workspace_id: nil,
             request_options: {}
           )

data/rbi/anthropic/models/beta/sessions/resource_list_params.rbi

@@ -51,6 +51,12 @@ module Anthropic
           end
           attr_writer :betas
 
+          # Optional header to select the Workspace for this request. The value is a
+          # Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+          #
+          # Only needed for credentials that can act on more than one Workspace. A
+          # credential that belongs to a specific Workspace may omit it; if sent, it must
+          # match that Workspace.
           sig { returns(T.nilable(String)) }
           attr_reader :workspace_id
 
@@ -77,6 +83,12 @@ module Anthropic
             page: nil,
             # Optional header to specify the beta version(s) you want to use.
             betas: nil,
+            # Optional header to select the Workspace for this request. The value is a
+            # Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+            #
+            # Only needed for credentials that can act on more than one Workspace. A
+            # credential that belongs to a specific Workspace may omit it; if sent, it must
+            # match that Workspace.
             workspace_id: nil,
             request_options: {}
           )

data/rbi/anthropic/models/beta/sessions/resource_retrieve_params.rbi

@@ -39,6 +39,12 @@ module Anthropic
           end
           attr_writer :betas
 
+          # Optional header to select the Workspace for this request. The value is a
+          # Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+          #
+          # Only needed for credentials that can act on more than one Workspace. A
+          # credential that belongs to a specific Workspace may omit it; if sent, it must
+          # match that Workspace.
           sig { returns(T.nilable(String)) }
           attr_reader :workspace_id
 
@@ -60,6 +66,12 @@ module Anthropic
             resource_id:,
             # Optional header to specify the beta version(s) you want to use.
             betas: nil,
+            # Optional header to select the Workspace for this request. The value is a
+            # Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+            #
+            # Only needed for credentials that can act on more than one Workspace. A
+            # credential that belongs to a specific Workspace may omit it; if sent, it must
+            # match that Workspace.
             workspace_id: nil,
             request_options: {}
           )

data/rbi/anthropic/models/beta/sessions/resource_retrieve_response.rbi

@@ -113,7 +113,8 @@ module Anthropic
             # The memory store ID (memstore\_...). Must belong to the caller's organization
             # and workspace.
             memory_store_id: nil,
-            # Access mode for an attached memory store.
+            # Access mode for the mounted store. Defaults to `read_write`. `read_only` mounts
+            # the store as a read-only filesystem.
             access: nil,
             # Description of the memory store, snapshotted at attach time. Rendered into the
             # agent's system prompt. Empty string when the store has no description.