@anthropic-ai/sdk 0.102.0 → 0.104.0

package/src/resources/beta/index.ts

@@ -63,6 +63,78 @@ export {
   type BetaPermissionError,
   type BetaRateLimitError,
 } from './beta';
+export {
+  DeploymentRuns,
+  type BetaManagedAgentsAgentArchivedRunError,
+  type BetaManagedAgentsDeploymentRun,
+  type BetaManagedAgentsEnvironmentArchivedRunError,
+  type BetaManagedAgentsEnvironmentNotFoundRunError,
+  type BetaManagedAgentsFileNotFoundRunError,
+  type BetaManagedAgentsManualTriggerContext,
+  type BetaManagedAgentsMCPEgressBlockedRunError,
+  type BetaManagedAgentsMemoryStoreArchivedRunError,
+  type BetaManagedAgentsOrganizationDisabledRunError,
+  type BetaManagedAgentsScheduleTriggerContext,
+  type BetaManagedAgentsSelfHostedResourcesUnsupportedRunError,
+  type BetaManagedAgentsSessionCreationRejectedRunError,
+  type BetaManagedAgentsSessionRateLimitedRunError,
+  type BetaManagedAgentsSessionResourceNotFoundRunError,
+  type BetaManagedAgentsSkillNotFoundRunError,
+  type BetaManagedAgentsTriggerContext,
+  type BetaManagedAgentsTriggerType,
+  type BetaManagedAgentsUnknownRunError,
+  type BetaManagedAgentsVaultArchivedRunError,
+  type BetaManagedAgentsVaultNotFoundRunError,
+  type BetaManagedAgentsWorkspaceArchivedRunError,
+  type DeploymentRunRetrieveParams,
+  type DeploymentRunListParams,
+  type BetaManagedAgentsDeploymentRunsPageCursor,
+} from './deployment-runs';
+export {
+  Deployments,
+  type BetaManagedAgentsAgentArchivedDeploymentPausedReasonError,
+  type BetaManagedAgentsCronSchedule,
+  type BetaManagedAgentsCronScheduleParams,
+  type BetaManagedAgentsDeployment,
+  type BetaManagedAgentsDeploymentInitialEvent,
+  type BetaManagedAgentsDeploymentInitialEventParams,
+  type BetaManagedAgentsDeploymentPausedReason,
+  type BetaManagedAgentsDeploymentPausedReasonError,
+  type BetaManagedAgentsDeploymentStatus,
+  type BetaManagedAgentsDeploymentSystemMessageEvent,
+  type BetaManagedAgentsDeploymentUserDefineOutcomeEvent,
+  type BetaManagedAgentsDeploymentUserMessageEvent,
+  type BetaManagedAgentsEnvironmentArchivedDeploymentPausedReasonError,
+  type BetaManagedAgentsEnvironmentNotFoundDeploymentPausedReasonError,
+  type BetaManagedAgentsErrorDeploymentPausedReason,
+  type BetaManagedAgentsFileNotFoundDeploymentPausedReasonError,
+  type BetaManagedAgentsFileResourceConfig,
+  type BetaManagedAgentsGitHubRepositoryResourceConfig,
+  type BetaManagedAgentsManualDeploymentPausedReason,
+  type BetaManagedAgentsMCPEgressBlockedDeploymentPausedReasonError,
+  type BetaManagedAgentsMemoryStoreArchivedDeploymentPausedReasonError,
+  type BetaManagedAgentsMemoryStoreResourceConfig,
+  type BetaManagedAgentsOrganizationDisabledDeploymentPausedReasonError,
+  type BetaManagedAgentsSchedule,
+  type BetaManagedAgentsScheduleParams,
+  type BetaManagedAgentsSelfHostedResourcesUnsupportedDeploymentPausedReasonError,
+  type BetaManagedAgentsSessionResourceConfig,
+  type BetaManagedAgentsSessionResourceNotFoundDeploymentPausedReasonError,
+  type BetaManagedAgentsSkillNotFoundDeploymentPausedReasonError,
+  type BetaManagedAgentsUnknownDeploymentPausedReasonError,
+  type BetaManagedAgentsVaultArchivedDeploymentPausedReasonError,
+  type BetaManagedAgentsVaultNotFoundDeploymentPausedReasonError,
+  type BetaManagedAgentsWorkspaceArchivedDeploymentPausedReasonError,
+  type DeploymentCreateParams,
+  type DeploymentRetrieveParams,
+  type DeploymentUpdateParams,
+  type DeploymentListParams,
+  type DeploymentArchiveParams,
+  type DeploymentPauseParams,
+  type DeploymentRunParams,
+  type DeploymentUnpauseParams,
+  type BetaManagedAgentsDeploymentsPageCursor,
+} from './deployments';
 export {
   Environments,
   type BetaCloudConfig,
@@ -192,6 +264,12 @@ export {
   type BetaDocumentBlock,
   type BetaEncryptedCodeExecutionResultBlock,
   type BetaEncryptedCodeExecutionResultBlockParam,
+  type BetaFallbackBlock,
+  type BetaFallbackBlockParam,
+  type BetaFallbackInfo,
+  type BetaFallbackInfoParam,
+  type BetaFallbackMessageIterationUsage,
+  type BetaFallbackParam,
   type BetaFileDocumentSource,
   type BetaFileImageSource,
   type BetaImageBlockParam,
@@ -370,6 +448,8 @@ export {
   type BetaManagedAgentsSessionStats,
   type BetaManagedAgentsSessionUpdatedEvent,
   type BetaManagedAgentsSessionUsage,
+  type BetaManagedAgentsSystemContentBlock,
+  type BetaManagedAgentsSystemMessageEvent,
   type BetaManagedAgentsUserToolResultEvent,
   type SessionCreateParams,
   type SessionRetrieveParams,

package/src/resources/beta/messages/batches.ts

@@ -570,6 +570,36 @@ export namespace BatchCreateParams {
        */
       diagnostics?: BetaMessagesAPI.BetaDiagnosticsParam | null;
 
+      /**
+       * The `fallback_credit_token` from a prior refusal's `stop_details`.
+       *
+       * When a preceding request was refused and returned a `fallback_credit_token`,
+       * pass that code here on the retry to have the retry's cache-creation tokens for
+       * the prefix that was warm on the refused model billed at the cache-read rate.
+       * Must be redeemed by the same organization and workspace, with the same request
+       * body (optionally extended by one appended `assistant` message whose content is
+       * the partial text — with any trailing whitespace stripped from the final text
+       * block — and paired server-tool blocks streamed before the refusal; the
+       * appended-assistant form is not available for requests with `output_format` set
+       * or forced `tool_choice`), on an eligible fallback model, on the same platform,
+       * and within 5 minutes of the refusal; a mismatch is a 400. A token minted
+       * mid-server-tool-loop whose partial content was continuable may only be redeemed
+       * with the appended-assistant form — if an exact-body retry is rejected with a 400
+       * saying the token must be redeemed by continuing the partial response, retry with
+       * the appended-assistant form instead.
+       *
+       * When the appended-assistant form is used on a model that otherwise disallows
+       * assistant-turn prefill, this token also authorizes that one prefill.
+       */
+      fallback_credit_token?: string | null;
+
+      /**
+       * Opt-in server-side retry on one or more substitute models when the requested
+       * model declines for policy reasons. Tried in order: if the first entry also
+       * declines, the second is tried, and so on.
+       */
+      fallbacks?: Array<BetaMessagesAPI.BetaFallbackParam> | null;
+
       /**
        * Specifies the geographic region for inference processing. If not specified, the
        * workspace's `default_inference_geo` is used.

package/src/resources/beta/messages/index.ts

@@ -103,6 +103,12 @@ export {
   type BetaDocumentBlock,
   type BetaEncryptedCodeExecutionResultBlock,
   type BetaEncryptedCodeExecutionResultBlockParam,
+  type BetaFallbackBlock,
+  type BetaFallbackBlockParam,
+  type BetaFallbackInfo,
+  type BetaFallbackInfoParam,
+  type BetaFallbackMessageIterationUsage,
+  type BetaFallbackParam,
   type BetaFileDocumentSource,
   type BetaFileImageSource,
   type BetaImageBlockParam,

package/src/resources/beta/messages/messages.ts

@@ -60,8 +60,15 @@ const DEPRECATED_MODELS: {
   'claude-2.0': 'July 21st, 2025',
   'claude-3-7-sonnet-latest': 'February 19th, 2026',
   'claude-3-7-sonnet-20250219': 'February 19th, 2026',
+  'claude-3-5-haiku-latest': 'February 19th, 2026',
+  'claude-3-5-haiku-20241022': 'February 19th, 2026',
+  'claude-opus-4-0': 'June 15th, 2026',
+  'claude-opus-4-20250514': 'June 15th, 2026',
+  'claude-sonnet-4-0': 'June 15th, 2026',
+  'claude-sonnet-4-20250514': 'June 15th, 2026',
   'claude-opus-4-1': 'August 5th, 2026',
   'claude-opus-4-1-20250805': 'August 5th, 2026',
+  'claude-mythos-preview': 'June 30th, 2026',
 };
 
 const MODELS_TO_WARN_WITH_THINKING_ENABLED: Model[] = ['claude-mythos-preview', 'claude-opus-4-6'];
@@ -1356,7 +1363,8 @@ export type BetaContentBlock =
   | BetaMCPToolUseBlock
   | BetaMCPToolResultBlock
   | BetaContainerUploadBlock
-  | BetaCompactionBlock;
+  | BetaCompactionBlock
+  | BetaFallbackBlock;
 
 /**
  * Regular text content.
@@ -1382,7 +1390,8 @@ export type BetaContentBlockParam =
   | BetaRequestMCPToolResultBlockParam
   | BetaContainerUploadBlockParam
   | BetaCompactionBlockParam
-  | BetaMidConversationSystemBlockParam;
+  | BetaMidConversationSystemBlockParam
+  | BetaFallbackBlockParam;
 
 export interface BetaContentBlockSource {
   content: string | Array<BetaContentBlockSourceContent>;
@@ -1502,6 +1511,170 @@ export interface BetaEncryptedCodeExecutionResultBlockParam {
   type: 'encrypted_code_execution_result';
 }
 
+/**
+ * Marks the point in `content` where one model's output gives way to the next.
+ *
+ * One block appears per hop where a preceding model actually ran this turn and
+ * declined. A turn routed directly by the sticky decision has no such boundary and
+ * carries no block — the signal for whether a fallback model served the response
+ * is the presence of a `fallback_message` entry in `usage.iterations`, not this
+ * block.
+ *
+ * The block is treated like a server-tool content block for streaming: it arrives
+ * via the standard `content_block_start` / `content_block_stop` pair and carries
+ * no deltas.
+ */
+export interface BetaFallbackBlock {
+  /**
+   * The model whose output ends at this point — the model that declined at this hop.
+   * When the declining hop is the requested model, its `model` echoes the top-level
+   * `model` string the caller sent (alias or canonical); when the declining hop is a
+   * fallback model, its `model` is that model's canonical id.
+   */
+  from: BetaFallbackInfo;
+
+  /**
+   * The fallback model producing the content that follows this block. Its `model` is
+   * always the canonical id.
+   */
+  to: BetaFallbackInfo;
+
+  type: 'fallback';
+}
+
+/**
+ * A `fallback` block echoed back from a prior response.
+ *
+ * Accepted in `messages[].content` and never rendered into the prompt, not
+ * validated against the request's `fallbacks` chain or top-level `model`, and
+ * stripped before the sticky-routing cache key is computed.
+ *
+ * Callers should echo the assistant turn verbatim — block included. The block's
+ * position is load-bearing for thinking verification: the thinking runs on either
+ * side of a fallback hop carry independently-rooted verification hash chains, and
+ * this block is the only record of where one chain ends and the next begins. When
+ * thinking runs flank the boundary, omitting the block merges the runs into one
+ * contiguous span whose hashes cannot verify (the request is rejected), and moving
+ * it into the middle of a single run splits that run's chain and is likewise
+ * rejected; between non-thinking blocks the block's placement has no verification
+ * effect.
+ */
+export interface BetaFallbackBlockParam {
+  /**
+   * Identifies one hop of a fallback transition.
+   */
+  from: BetaFallbackInfoParam;
+
+  /**
+   * Identifies one hop of a fallback transition.
+   */
+  to: BetaFallbackInfoParam;
+
+  type: 'fallback';
+}
+
+/**
+ * Identifies one hop of a fallback transition.
+ */
+export interface BetaFallbackInfo {
+  /**
+   * The model that will complete your prompt.
+   *
+   * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+   * details and options.
+   */
+  model: MessagesAPI.Model;
+}
+
+/**
+ * Identifies one hop of a fallback transition.
+ */
+export interface BetaFallbackInfoParam {
+  /**
+   * The model that will complete your prompt.
+   *
+   * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+   * details and options.
+   */
+  model: MessagesAPI.Model;
+}
+
+/**
+ * Token usage for the fallback-model attempt of a server-side fallback request.
+ *
+ * Produced in place of a `message` entry for whichever hop served the response. A
+ * declined hop produces the existing `message` entry. Whether a fallback model
+ * served the response is signalled by the presence of this entry in
+ * `usage.iterations`.
+ */
+export interface BetaFallbackMessageIterationUsage {
+  /**
+   * Breakdown of cached tokens by TTL
+   */
+  cache_creation: BetaCacheCreation | null;
+
+  /**
+   * The number of input tokens used to create the cache entry.
+   */
+  cache_creation_input_tokens: number;
+
+  /**
+   * The number of input tokens read from the cache.
+   */
+  cache_read_input_tokens: number;
+
+  /**
+   * The number of input tokens which were used.
+   */
+  input_tokens: number;
+
+  /**
+   * The model that will complete your prompt.
+   *
+   * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+   * details and options.
+   */
+  model: MessagesAPI.Model;
+
+  /**
+   * The number of output tokens which were used.
+   */
+  output_tokens: number;
+
+  /**
+   * Usage for the fallback-model attempt that served the response
+   */
+  type: 'fallback_message';
+}
+
+/**
+ * One entry in the `fallbacks` chain on a `/v1/messages` request.
+ *
+ * `model` is required. The four override fields (`max_tokens`, `thinking`,
+ * `output_config`, and `speed`) replace the corresponding top-level field for this
+ * attempt only and are validated as if the request were made to `model`. Any other
+ * key is rejected at parse time.
+ */
+export interface BetaFallbackParam {
+  /**
+   * The model that will complete your prompt.
+   *
+   * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+   * details and options.
+   */
+  model: MessagesAPI.Model;
+
+  max_tokens?: number | null;
+
+  output_config?: BetaOutputConfig | null;
+
+  speed?: 'standard' | 'fast' | null;
+
+  thinking?: BetaThinkingConfigEnabled | BetaThinkingConfigDisabled | BetaThinkingConfigAdaptive | null;
+
+  [k: string]: unknown;
+}
+
 export interface BetaFileDocumentSource {
   file_id: string;
 
@@ -1554,7 +1727,10 @@ export interface BetaInputTokensTrigger {
  * - Understand token accumulation across server-side tool use loops
  */
 export type BetaIterationsUsage = Array<
-  BetaMessageIterationUsage | BetaCompactionIterationUsage | BetaAdvisorMessageIterationUsage
+  | BetaMessageIterationUsage
+  | BetaCompactionIterationUsage
+  | BetaAdvisorMessageIterationUsage
+  | BetaFallbackMessageIterationUsage
 >;
 
 export interface BetaJSONOutputFormat {
@@ -2018,6 +2194,14 @@ export interface BetaMessageIterationUsage {
    */
   input_tokens: number;
 
+  /**
+   * The model that will complete your prompt.
+   *
+   * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+   * details and options.
+   */
+  model: MessagesAPI.Model;
+
   /**
    * The number of output tokens which were used.
    */
@@ -2156,7 +2340,8 @@ export interface BetaRawContentBlockStartEvent {
     | BetaMCPToolUseBlock
     | BetaMCPToolResultBlock
     | BetaContainerUploadBlock
-    | BetaCompactionBlock;
+    | BetaCompactionBlock
+    | BetaFallbackBlock;
 
   index: number;
 
@@ -2257,7 +2442,7 @@ export interface BetaRefusalStopDetails {
    *
    * `null` when the refusal doesn't map to a named category.
    */
-  category: 'cyber' | 'bio' | null;
+  category: 'cyber' | 'bio' | 'reasoning_extraction' | null;
 
   /**
    * Human-readable explanation of the refusal.
@@ -2267,6 +2452,59 @@ export interface BetaRefusalStopDetails {
    */
   explanation: string | null;
 
+  /**
+   * Opaque code that refunds the cache-miss cost when retrying this refused request
+   * on the fallback model. Pass it as `fallback_credit_token` on the retry request.
+   * Expires 5 minutes after the refusal.
+   *
+   * The retry is sent either with the same request body (`system`, `messages`,
+   * `tools`, and other render-shaping fields), or with the same body plus one
+   * appended `assistant` message whose content is the partial text (with any
+   * trailing whitespace stripped from the final text block) and paired server-tool
+   * blocks from this refusal — which also authorizes that appended turn as an
+   * assistant-prefill continuation on models that otherwise disallow prefill. A
+   * token minted mid-server-tool-loop whose partial content was continuable may only
+   * be redeemed the second way — if a same-body retry is rejected with a 400 saying
+   * the token must be redeemed by continuing the partial response, retry the second
+   * way instead. Either way: same workspace, same platform; a mismatch is a 400.
+   * Resending a token for an already-warm prefix is permitted but yields no
+   * additional credit.
+   *
+   * `null` when the refused model isn't eligible for a fallback credit.
+   */
+  fallback_credit_token: string | null;
+
+  /**
+   * Whether the accompanying `fallback_credit_token` may be redeemed with the
+   * appended-assistant retry form. Only set when `fallback_credit_token` is present.
+   *
+   * `true`: retry by resending the same request body plus one appended `assistant`
+   * message whose content is this response's `content` with any trailing whitespace
+   * stripped from the final text block and unpaired `tool_use` blocks omitted (the
+   * same appended-turn shape described on `fallback_credit_token`), with the token
+   * attached. `false`: retry by resending the original request body unchanged, with
+   * the token attached — the appended-assistant form is not available for this
+   * refusal (no continuable partial content, or the request uses `output_format` or
+   * a `tool_choice` that forces tool use). One exception: when the request used
+   * `output_format` or a forced `tool_choice` and the refusal arrived after server
+   * tools (including MCP connector tools) had already executed, the token may not be
+   * redeemable by either retry form; if the exact-body retry is then rejected with a
+   * 400 saying the token must be redeemed by continuing the partial response,
+   * discard the token and retry without it.
+   *
+   * Advisory: if an appended-assistant retry is rejected with a 400 despite `true`,
+   * fall back to resending the original request body with the token.
+   */
+  fallback_has_prefill_claim: boolean | null;
+
+  /**
+   * The server's suggested retry target for this refusal. Populated when a fallback
+   * attempt could not be made (the fallback model's rate limit was exhausted, or it
+   * was overloaded); names the fallback model the caller can retry directly. Null
+   * otherwise.
+   */
+  recommended_model: string | null;
+
   type: 'refusal';
 }
 
@@ -4150,6 +4388,36 @@ export interface MessageCreateParamsBase {
    */
   diagnostics?: BetaDiagnosticsParam | null;
 
+  /**
+   * Body param: The `fallback_credit_token` from a prior refusal's `stop_details`.
+   *
+   * When a preceding request was refused and returned a `fallback_credit_token`,
+   * pass that code here on the retry to have the retry's cache-creation tokens for
+   * the prefix that was warm on the refused model billed at the cache-read rate.
+   * Must be redeemed by the same organization and workspace, with the same request
+   * body (optionally extended by one appended `assistant` message whose content is
+   * the partial text — with any trailing whitespace stripped from the final text
+   * block — and paired server-tool blocks streamed before the refusal; the
+   * appended-assistant form is not available for requests with `output_format` set
+   * or forced `tool_choice`), on an eligible fallback model, on the same platform,
+   * and within 5 minutes of the refusal; a mismatch is a 400. A token minted
+   * mid-server-tool-loop whose partial content was continuable may only be redeemed
+   * with the appended-assistant form — if an exact-body retry is rejected with a 400
+   * saying the token must be redeemed by continuing the partial response, retry with
+   * the appended-assistant form instead.
+   *
+   * When the appended-assistant form is used on a model that otherwise disallows
+   * assistant-turn prefill, this token also authorizes that one prefill.
+   */
+  fallback_credit_token?: string | null;
+
+  /**
+   * Body param: Opt-in server-side retry on one or more substitute models when the
+   * requested model declines for policy reasons. Tried in order: if the first entry
+   * also declines, the second is tried, and so on.
+   */
+  fallbacks?: Array<BetaFallbackParam> | null;
+
   /**
    * Body param: Specifies the geographic region for inference processing. If not
    * specified, the workspace's `default_inference_geo` is used.
@@ -4728,6 +4996,12 @@ export declare namespace Messages {
     type BetaDocumentBlock as BetaDocumentBlock,
     type BetaEncryptedCodeExecutionResultBlock as BetaEncryptedCodeExecutionResultBlock,
     type BetaEncryptedCodeExecutionResultBlockParam as BetaEncryptedCodeExecutionResultBlockParam,
+    type BetaFallbackBlock as BetaFallbackBlock,
+    type BetaFallbackBlockParam as BetaFallbackBlockParam,
+    type BetaFallbackInfo as BetaFallbackInfo,
+    type BetaFallbackInfoParam as BetaFallbackInfoParam,
+    type BetaFallbackMessageIterationUsage as BetaFallbackMessageIterationUsage,
+    type BetaFallbackParam as BetaFallbackParam,
     type BetaFileDocumentSource as BetaFileDocumentSource,
     type BetaFileImageSource as BetaFileImageSource,
     type BetaImageBlockParam as BetaImageBlockParam,

package/src/resources/beta/models.ts

@@ -195,6 +195,13 @@ export interface BetaModelInfo {
    */
   id: string;
 
+  /**
+   * Model IDs this model accepts as `fallbacks[i].model` on the Messages API. An
+   * empty list means the `fallbacks` parameter is not supported for this model as
+   * primary.
+   */
+  allowed_fallback_models: Array<string> | null;
+
   /**
    * Model capability information.
    */

package/src/resources/beta/sessions/events.ts

@@ -518,6 +518,37 @@ export interface BetaManagedAgentsBillingError {
   type: 'billing_error';
 }
 
+/**
+ * An `environment_variable` credential's `auth.networking.allowed_hosts` includes
+ * a host the environment's network policy does not permit.
+ */
+export interface BetaManagedAgentsCredentialHostUnreachableError {
+  /**
+   * ID of the affected credential.
+   */
+  credential_id: string;
+
+  /**
+   * Human-readable error description.
+   */
+  message: string;
+
+  /**
+   * What the client should do next in response to this error.
+   */
+  retry_status:
+    | BetaManagedAgentsRetryStatusRetrying
+    | BetaManagedAgentsRetryStatusExhausted
+    | BetaManagedAgentsRetryStatusTerminal;
+
+  type: 'credential_host_unreachable_error';
+
+  /**
+   * ID of the vault containing the affected credential.
+   */
+  vault_id: string;
+}
+
 /**
  * Document content, either specified directly as base64 data, as text, or as a
  * reference via a URL.
@@ -554,7 +585,8 @@ export type BetaManagedAgentsEventParams =
   | BetaManagedAgentsUserToolConfirmationEventParams
   | BetaManagedAgentsUserCustomToolResultEventParams
   | BetaManagedAgentsUserDefineOutcomeEventParams
-  | BetaManagedAgentsUserToolResultEventParams;
+  | BetaManagedAgentsUserToolResultEventParams
+  | BetaManagedAgentsSystemMessageEventParams;
 
 /**
  * Document referenced by file ID.
@@ -835,6 +867,7 @@ export interface BetaManagedAgentsSendSessionEvents {
     | BetaManagedAgentsUserCustomToolResultEvent
     | BetaManagedAgentsUserDefineOutcomeEvent
     | SessionsAPI.BetaManagedAgentsUserToolResultEvent
+    | SessionsAPI.BetaManagedAgentsSystemMessageEvent
   >;
 }
 
@@ -884,7 +917,8 @@ export interface BetaManagedAgentsSessionErrorEvent {
     | BetaManagedAgentsModelRequestFailedError
     | BetaManagedAgentsMCPConnectionFailedError
     | BetaManagedAgentsMCPAuthenticationFailedError
-    | BetaManagedAgentsBillingError;
+    | BetaManagedAgentsBillingError
+    | BetaManagedAgentsCredentialHostUnreachableError;
 
   /**
    * A timestamp in RFC 3339 format
@@ -930,7 +964,8 @@ export type BetaManagedAgentsSessionEvent =
   | BetaManagedAgentsSessionThreadStatusTerminatedEvent
   | SessionsAPI.BetaManagedAgentsUserToolResultEvent
   | BetaManagedAgentsSessionThreadStatusRescheduledEvent
-  | SessionsAPI.BetaManagedAgentsSessionUpdatedEvent;
+  | SessionsAPI.BetaManagedAgentsSessionUpdatedEvent
+  | SessionsAPI.BetaManagedAgentsSystemMessageEvent;
 
 /**
  * The agent is idle waiting on one or more blocking user-input events (tool
@@ -1415,7 +1450,25 @@ export type BetaManagedAgentsStreamSessionEvents =
   | BetaManagedAgentsSessionThreadStatusTerminatedEvent
   | SessionsAPI.BetaManagedAgentsUserToolResultEvent
   | BetaManagedAgentsSessionThreadStatusRescheduledEvent
-  | SessionsAPI.BetaManagedAgentsSessionUpdatedEvent;
+  | SessionsAPI.BetaManagedAgentsSessionUpdatedEvent
+  | SessionsAPI.BetaManagedAgentsSystemMessageEvent;
+
+/**
+ * Privileged context for the accompanying turn and all subsequent turns, appended
+ * to the session's system context as a `role: "system"` turn rather than replacing
+ * the top-level system prompt. At most one per request: it must be the final event
+ * and immediately follow the `user.message`, `user.tool_result`, or
+ * `user.custom_tool_result` it accompanies. Only supported on models that accept
+ * mid-conversation system messages.
+ */
+export interface BetaManagedAgentsSystemMessageEventParams {
+  /**
+   * System content blocks to append. Text-only.
+   */
+  content: Array<SessionsAPI.BetaManagedAgentsSystemContentBlock>;
+
+  type: 'system.message';
+}
 
 /**
  * Regular text content.
@@ -1891,6 +1944,7 @@ export declare namespace Events {
     type BetaManagedAgentsBase64DocumentSource as BetaManagedAgentsBase64DocumentSource,
     type BetaManagedAgentsBase64ImageSource as BetaManagedAgentsBase64ImageSource,
     type BetaManagedAgentsBillingError as BetaManagedAgentsBillingError,
+    type BetaManagedAgentsCredentialHostUnreachableError as BetaManagedAgentsCredentialHostUnreachableError,
     type BetaManagedAgentsDocumentBlock as BetaManagedAgentsDocumentBlock,
     type BetaManagedAgentsEventParams as BetaManagedAgentsEventParams,
     type BetaManagedAgentsFileDocumentSource as BetaManagedAgentsFileDocumentSource,
@@ -1933,6 +1987,7 @@ export declare namespace Events {
     type BetaManagedAgentsSpanOutcomeEvaluationOngoingEvent as BetaManagedAgentsSpanOutcomeEvaluationOngoingEvent,
     type BetaManagedAgentsSpanOutcomeEvaluationStartEvent as BetaManagedAgentsSpanOutcomeEvaluationStartEvent,
     type BetaManagedAgentsStreamSessionEvents as BetaManagedAgentsStreamSessionEvents,
+    type BetaManagedAgentsSystemMessageEventParams as BetaManagedAgentsSystemMessageEventParams,
     type BetaManagedAgentsTextBlock as BetaManagedAgentsTextBlock,
     type BetaManagedAgentsTextRubric as BetaManagedAgentsTextRubric,
     type BetaManagedAgentsTextRubricParams as BetaManagedAgentsTextRubricParams,

package/src/resources/beta/sessions/index.ts

@@ -15,6 +15,7 @@ export {
   type BetaManagedAgentsBase64DocumentSource,
   type BetaManagedAgentsBase64ImageSource,
   type BetaManagedAgentsBillingError,
+  type BetaManagedAgentsCredentialHostUnreachableError,
   type BetaManagedAgentsDocumentBlock,
   type BetaManagedAgentsEventParams,
   type BetaManagedAgentsFileDocumentSource,
@@ -57,6 +58,7 @@ export {
   type BetaManagedAgentsSpanOutcomeEvaluationOngoingEvent,
   type BetaManagedAgentsSpanOutcomeEvaluationStartEvent,
   type BetaManagedAgentsStreamSessionEvents,
+  type BetaManagedAgentsSystemMessageEventParams,
   type BetaManagedAgentsTextBlock,
   type BetaManagedAgentsTextRubric,
   type BetaManagedAgentsTextRubricParams,
@@ -116,6 +118,8 @@ export {
   type BetaManagedAgentsSessionStats,
   type BetaManagedAgentsSessionUpdatedEvent,
   type BetaManagedAgentsSessionUsage,
+  type BetaManagedAgentsSystemContentBlock,
+  type BetaManagedAgentsSystemMessageEvent,
   type BetaManagedAgentsUserToolResultEvent,
   type SessionCreateParams,
   type SessionRetrieveParams,