@anthropic-ai/sdk 0.121.0 → 0.123.0

package/src/lib/middleware.ts

@@ -38,16 +38,17 @@ const DEFAULT_BETAS: readonly AnthropicBeta[] = ['fallback-credit-2026-07-01'];
  * Remove `fallback` blocks replayed in history. They only parse under the
  * server-side fallback beta, which belongs to the caller-owned server-side
  * `fallbacks` feature — this middleware never sends it, so a request
- * replaying them would 400. An assistant turn left empty is dropped whole.
+ * replaying them would 400. A turn the strip leaves empty is dropped whole;
+ * a turn that was already empty is kept — it may carry other payload (e.g. a
+ * directive-only system message's `output_config`).
  */
 function stripFallbackBlocks(body: MessageCreateParams): MessageCreateParams {
-  const messages = body.messages
-    .map((message) =>
-      Array.isArray(message.content) ?
-        { ...message, content: message.content.filter((block) => block.type !== 'fallback') }
-      : message,
-    )
-    .filter((message) => !Array.isArray(message.content) || message.content.length > 0);
+  const messages = body.messages.flatMap((message) => {
+    if (!Array.isArray(message.content)) return [message];
+    const content = message.content.filter((block) => block.type !== 'fallback');
+    if (content.length === message.content.length) return [message];
+    return content.length > 0 ? [{ ...message, content }] : [];
+  });
   return { ...body, messages };
 }
 
@@ -453,6 +454,9 @@ async function* splicedEvents(
   // The refusal whose token is currently in flight — surfaced verbatim (with a
   // recommended_model added) if every fallback request fails and we degrade.
   let refusalDetails = a.refused.stopDetails;
+  // That refused hop's suppressed message_start `input_transformations`, which
+  // ride on the surfaced refusal delta (none for A: its start reached the client).
+  let refusalInputTransformations = a.refused.inputTransformations;
 
   // One `message` entry per refused hop, in order — A first. Failed hops are
   // skipped (no usage came back); the serving hop is appended as
@@ -559,6 +563,9 @@ async function* splicedEvents(
           stop_details: stopDetails,
         },
         usage: (lastUsage ?? {}) as BetaMessageDeltaUsage,
+        ...(refusalInputTransformations !== undefined && {
+          input_transformations: refusalInputTransformations,
+        }),
       });
       yield emit<BetaRawMessageStopEvent>('message_stop', { type: 'message_stop' });
       return;
@@ -580,6 +587,7 @@ async function* splicedEvents(
     // continues.
     token = b.refused.token;
     refusalDetails = b.refused.stopDetails;
+    refusalInputTransformations = b.refused.inputTransformations;
     base = continuation;
     partial = b.refused.hasPrefillClaim ? toPrefillBlocks(b.blocks) : [];
     iterations.push(toIterationUsage('message', model, b.refused.usage));
@@ -598,6 +606,12 @@ interface HopOutcome {
     usage: BetaMessageDeltaUsage;
     /** The refusal's stop_details verbatim, surfaced if the whole chain degrades. */
     stopDetails: BetaRefusalStopDetails;
+    /**
+     * A spliced hop's suppressed message_start `input_transformations`, forwarded
+     * on the surfaced refusal delta if the whole chain degrades; `undefined` for
+     * stream A (its start reached the client) or when the start had none.
+     */
+    inputTransformations: BetaMessage['input_transformations'] | undefined;
   } | null;
   /** The hop's serving model, from its message_start. */
   model: string | undefined;
@@ -615,7 +629,8 @@ interface HopOutcome {
  * spliced hop (`splice` set) has its message_start suppressed (the client
  * already saw A's), its block indices shifted by `indexBase`, and its
  * terminal message_delta's usage rewritten to the `usage.iterations`
- * chain shape.
+ * chain shape, with the suppressed message_start's `input_transformations`
+ * forwarded onto it.
  *
  * A refusal that can be chained — it carries a `fallback_credit_token` and a
  * fallback entry remains — ends the hop early: open blocks are closed, the
@@ -638,6 +653,10 @@ async function* consumeHop(args: {
   const tracker = new BlockTracker(indexBase);
   let model: string | undefined;
   let startUsage: BetaUsage | null = null;
+  // A spliced hop's message_start is suppressed, so its `input_transformations`
+  // must ride on the re-emitted terminal message_delta — the way a server-side
+  // fallback reports the serving model's list.
+  let startInputTransformations: BetaMessage['input_transformations'];
 
   for await (const sse of Stream.rawEvents(response, controller)) {
     const p = safeJSON(sse.data) as BetaRawMessageStreamEvent | undefined;
@@ -645,6 +664,7 @@ async function* consumeHop(args: {
       case 'message_start': {
         model = p.message.model;
         startUsage = p.message.usage;
+        if ('input_transformations' in p.message) startInputTransformations = p.message.input_transformations;
         if (splice) continue;
         break;
       }
@@ -687,6 +707,7 @@ async function* consumeHop(args: {
                 hasPrefillClaim: details.fallback_has_prefill_claim === true,
                 usage,
                 stopDetails: details,
+                inputTransformations: splice ? startInputTransformations : undefined,
               },
               model,
               blocks: tracker.contentBlocks(),
@@ -721,6 +742,9 @@ async function* consumeHop(args: {
             toIterationUsage('fallback_message', splice.model, usage),
           ];
           p.usage = usage;
+          if (!('input_transformations' in p) && startInputTransformations !== undefined) {
+            p.input_transformations = startInputTransformations;
+          }
           yield emit('message_delta', p);
           continue;
         }

package/src/lib/sessions/accumulate.ts

@@ -1,5 +1,4 @@
 import { AnthropicError } from '../../core/error';
-import { checkNever } from '../../internal/utils/values';
 import type {
   BetaManagedAgentsAgentMessageEvent,
   BetaManagedAgentsStreamSessionEvents,
@@ -19,10 +18,11 @@ export type AccumulatedEvent = BetaManagedAgentsAgentMessageEvent;
  *   fragment as a fresh content entry; an existing index returns a copy with
  *   that entry appended to. An unrecognised fragment type on an existing
  *   index passes the entry through unchanged — deltas are best-effort and the
- *   buffered final event is canonical — but is a compile-time error via the
- *   exhaustiveness guard, matching `MessageStream#accumulateMessage`.
+ *   buffered final event is canonical.
  * - `agent.message` is the buffered final event: a copy of it is returned,
  *   replacing whatever the preview had accumulated.
+ * - Every other event type returns `accumulated` unchanged, so new event types
+ *   added to the stream union need no change here.
  */
 export function accumulateManagedAgentsEvent<T extends AccumulatedEvent>(
   accumulated: AccumulatedEvent | undefined,
@@ -72,57 +72,17 @@ export function accumulateManagedAgentsEvent(
       }
 
       let updated = existing;
-      switch (fragment.type) {
-        case 'text':
-          if (existing.type === 'text') {
-            updated = { ...existing, text: existing.text + fragment.text };
-          }
-          break;
-        default:
-          checkNever(fragment.type);
+      if (fragment.type === 'text' && existing.type === 'text') {
+        updated = { ...existing, text: existing.text + fragment.text };
       }
 
       const content = accumulated.content.slice();
       content[idx] = updated;
       return { ...accumulated, content };
     }
-    case 'user.message':
-    case 'user.interrupt':
-    case 'user.tool_confirmation':
-    case 'user.tool_result':
-    case 'user.custom_tool_result':
-    case 'user.define_outcome':
-    case 'agent.thinking':
-    case 'agent.tool_use':
-    case 'agent.tool_result':
-    case 'agent.custom_tool_use':
-    case 'agent.mcp_tool_use':
-    case 'agent.mcp_tool_result':
-    case 'agent.thread_message_received':
-    case 'agent.thread_message_sent':
-    case 'agent.thread_context_compacted':
-    case 'session.error':
-    case 'session.updated':
-    case 'session.deleted':
-    case 'session.usage':
-    case 'session.status_running':
-    case 'session.status_idle':
-    case 'session.status_rescheduled':
-    case 'session.status_terminated':
-    case 'session.thread_created':
-    case 'session.thread_status_running':
-    case 'session.thread_status_idle':
-    case 'session.thread_status_rescheduled':
-    case 'session.thread_status_terminated':
-    case 'span.model_request_start':
-    case 'span.model_request_end':
-    case 'span.outcome_evaluation_start':
-    case 'span.outcome_evaluation_ongoing':
-    case 'span.outcome_evaluation_end':
-    case 'system.message':
-      return accumulated;
+
     default:
-      checkNever(event);
+      // Any other event, including types newer than this SDK, leaves the snapshot unchanged.
       return accumulated;
   }
 }

package/src/resources/beta/agents/agents.ts

@@ -862,6 +862,7 @@ export interface BetaManagedAgentsMCPToolsetParams {
  * details and options.
  */
 export type BetaManagedAgentsModel =
+  | 'claude-fable-5-1'
   | 'claude-sonnet-5'
   | 'claude-fable-5'
   | 'claude-opus-5'

package/src/resources/beta/beta.ts

@@ -88,10 +88,12 @@ import {
   BetaDreamSessionsInput,
   BetaDreamStatus,
   BetaDreamUsage,
+  BetaDreamingError,
   BetaDreamsPageCursor,
   BetaOutputBehavior,
   BetaOutputBehaviorCreateNew,
   BetaOutputBehaviorUpdateExisting,
+  BetaTargetStoreHeldError,
   DreamArchiveParams,
   DreamCancelParams,
   DreamCreateParams,
@@ -103,7 +105,7 @@ import * as FilesAPI from './files';
 import {
   BetaDeletedFile,
   BetaFileMetadata,
-  BetaFileMetadataPage,
+  BetaFileMetadataPageCursor,
   BetaFileScope,
   FileDeleteParams,
   FileDownloadParams,
@@ -427,6 +429,7 @@ import {
   BetaComputerZoomConfig,
   BetaContainer,
   BetaContainerParams,
+  BetaContainerSkill,
   BetaContainerUploadBlock,
   BetaContainerUploadBlockParam,
   BetaContentBlock,
@@ -507,9 +510,9 @@ import {
   BetaServerToolUseBlock,
   BetaServerToolUseBlockParam,
   BetaSignatureDelta,
-  BetaSkill,
   BetaSkillParams,
   BetaStopReason,
+  BetaSystemMessageOutputConfig,
   BetaTextBlock,
   BetaTextBlockParam,
   BetaTextCitation,
@@ -526,12 +529,15 @@ import {
   BetaTextEditorCodeExecutionViewResultBlock,
   BetaTextEditorCodeExecutionViewResultBlockParam,
   BetaThinkingBlock,
+  BetaThinkingBlockBinding,
   BetaThinkingBlockParam,
   BetaThinkingConfigAdaptive,
   BetaThinkingConfigDisabled,
   BetaThinkingConfigEnabled,
   BetaThinkingConfigParam,
   BetaThinkingDelta,
+  BetaThinkingDroppedInputTransformation,
+  BetaThinkingPrefixMismatchBehavior,
   BetaThinkingTurns,
   BetaTokenTaskBudget,
   BetaTool,
@@ -644,15 +650,14 @@ import {
 } from './sessions/sessions';
 import * as SkillsAPI from './skills/skills';
 import {
+  BetaDeletedSkill,
+  BetaSkill,
+  BetaSkillSource,
+  BetaSkillsPageCursor,
   SkillCreateParams,
-  SkillCreateResponse,
   SkillDeleteParams,
-  SkillDeleteResponse,
   SkillListParams,
-  SkillListResponse,
-  SkillListResponsesPageCursor,
   SkillRetrieveParams,
-  SkillRetrieveResponse,
   Skills,
 } from './skills/skills';
 import * as TunnelsAPI from './tunnels/tunnels';
@@ -743,7 +748,10 @@ export type AnthropicBeta =
   | 'structured-outputs-2025-11-13'
   | 'task-budgets-2026-03-13'
   | 'thinking-display-updates-2026-08-18'
-  | 'ce-user-management-2026-07-13';
+  | 'ce-user-management-2026-07-13'
+  | 'mid-conversation-output-config-2026-07-01'
+  | 'thinking-binding-controls-2026-08-01'
+  | 'mid-conversation-system-clear-at-2026-08-21';
 
 export interface BetaAPIError {
   message: string;
@@ -1017,6 +1025,7 @@ export declare namespace Beta {
     type BetaComputerZoomConfig as BetaComputerZoomConfig,
     type BetaContainer as BetaContainer,
     type BetaContainerParams as BetaContainerParams,
+    type BetaContainerSkill as BetaContainerSkill,
     type BetaContainerUploadBlock as BetaContainerUploadBlock,
     type BetaContainerUploadBlockParam as BetaContainerUploadBlockParam,
     type BetaContentBlock as BetaContentBlock,
@@ -1099,9 +1108,9 @@ export declare namespace Beta {
     type BetaServerToolUseBlock as BetaServerToolUseBlock,
     type BetaServerToolUseBlockParam as BetaServerToolUseBlockParam,
     type BetaSignatureDelta as BetaSignatureDelta,
-    type BetaSkill as BetaSkill,
     type BetaSkillParams as BetaSkillParams,
     type BetaStopReason as BetaStopReason,
+    type BetaSystemMessageOutputConfig as BetaSystemMessageOutputConfig,
     type BetaTextBlock as BetaTextBlock,
     type BetaTextBlockParam as BetaTextBlockParam,
     type BetaTextCitation as BetaTextCitation,
@@ -1118,12 +1127,15 @@ export declare namespace Beta {
     type BetaTextEditorCodeExecutionViewResultBlock as BetaTextEditorCodeExecutionViewResultBlock,
     type BetaTextEditorCodeExecutionViewResultBlockParam as BetaTextEditorCodeExecutionViewResultBlockParam,
     type BetaThinkingBlock as BetaThinkingBlock,
+    type BetaThinkingBlockBinding as BetaThinkingBlockBinding,
     type BetaThinkingBlockParam as BetaThinkingBlockParam,
     type BetaThinkingConfigAdaptive as BetaThinkingConfigAdaptive,
     type BetaThinkingConfigDisabled as BetaThinkingConfigDisabled,
     type BetaThinkingConfigEnabled as BetaThinkingConfigEnabled,
     type BetaThinkingConfigParam as BetaThinkingConfigParam,
     type BetaThinkingDelta as BetaThinkingDelta,
+    type BetaThinkingDroppedInputTransformation as BetaThinkingDroppedInputTransformation,
+    type BetaThinkingPrefixMismatchBehavior as BetaThinkingPrefixMismatchBehavior,
     type BetaThinkingTurns as BetaThinkingTurns,
     type BetaTokenTaskBudget as BetaTokenTaskBudget,
     type BetaTool as BetaTool,
@@ -1430,7 +1442,7 @@ export declare namespace Beta {
     type BetaDeletedFile as BetaDeletedFile,
     type BetaFileMetadata as BetaFileMetadata,
     type BetaFileScope as BetaFileScope,
-    type BetaFileMetadataPage as BetaFileMetadataPage,
+    type BetaFileMetadataPageCursor as BetaFileMetadataPageCursor,
     type FileListParams as FileListParams,
     type FileDeleteParams as FileDeleteParams,
     type FileDownloadParams as FileDownloadParams,
@@ -1440,11 +1452,10 @@ export declare namespace Beta {
 
   export {
     Skills as Skills,
-    type SkillCreateResponse as SkillCreateResponse,
-    type SkillRetrieveResponse as SkillRetrieveResponse,
-    type SkillListResponse as SkillListResponse,
-    type SkillDeleteResponse as SkillDeleteResponse,
-    type SkillListResponsesPageCursor as SkillListResponsesPageCursor,
+    type BetaDeletedSkill as BetaDeletedSkill,
+    type BetaSkill as BetaSkill,
+    type BetaSkillSource as BetaSkillSource,
+    type BetaSkillsPageCursor as BetaSkillsPageCursor,
     type SkillCreateParams as SkillCreateParams,
     type SkillRetrieveParams as SkillRetrieveParams,
     type SkillListParams as SkillListParams,
@@ -1528,9 +1539,11 @@ export declare namespace Beta {
     type BetaDreamSessionsInput as BetaDreamSessionsInput,
     type BetaDreamStatus as BetaDreamStatus,
     type BetaDreamUsage as BetaDreamUsage,
+    type BetaDreamingError as BetaDreamingError,
     type BetaOutputBehavior as BetaOutputBehavior,
     type BetaOutputBehaviorCreateNew as BetaOutputBehaviorCreateNew,
     type BetaOutputBehaviorUpdateExisting as BetaOutputBehaviorUpdateExisting,
+    type BetaTargetStoreHeldError as BetaTargetStoreHeldError,
     type BetaDreamsPageCursor as BetaDreamsPageCursor,
     type DreamCreateParams as DreamCreateParams,
     type DreamRetrieveParams as DreamRetrieveParams,

package/src/resources/beta/deployment-runs.ts

@@ -130,8 +130,8 @@ export interface BetaManagedAgentsDeploymentRun {
     | null;
 
   /**
-   * Populated on success. Null on creation failure. Exactly one of session_id or
-   * error is non-null.
+   * Populated on success. Null on creation failure. Exactly one of `session_id` or
+   * `error` is non-null.
    */
   session_id: string | null;
 
@@ -389,14 +389,14 @@ export interface DeploymentRunListParams extends PageCursorParams {
 
   /**
    * Query param: Filter to a specific deployment. Omit to list across all
-   * deployments in the workspace. Filtering by a non-existent deployment_id returns
-   * 200 with empty data.
+   * deployments in the workspace. Filtering by a non-existent `deployment_id`
+   * returns 200 with empty data.
    */
   deployment_id?: string;
 
   /**
-   * Query param: Filter: true for runs with non-null error, false for runs with
-   * non-null session_id. Omit for all.
+   * Query param: Filter: true for runs with non-null `error`, false for runs with
+   * non-null `session_id`. Omit for all.
    */
   has_error?: boolean;
 

package/src/resources/beta/deployments.ts

@@ -909,8 +909,9 @@ export interface DeploymentListParams extends PageCursorParams {
   include_archived?: boolean;
 
   /**
-   * Query param: Filter by status: active or paused. Omit for both. To include
-   * archived deployments, use include_archived instead; the two cannot be combined.
+   * Query param: Filter by status: `active` or `paused`. Omit for both. To include
+   * archived deployments, use `include_archived` instead; the two cannot be
+   * combined.
    */
   status?: BetaManagedAgentsDeploymentStatus;
 

package/src/resources/beta/dreams.ts

@@ -320,6 +320,27 @@ export interface BetaDreamUsage {
   output_tokens: number;
 }
 
+/**
+ * The `output_behavior.memory_store_id` target is still held by a prior
+ * `{type: "update_existing"}` dream — one that is `pending` or `running`, or was
+ * canceled with its final writes still landing. Rarely the named dream has just
+ * finished (`completed`/`failed`) and its execution is still closing; an immediate
+ * retry then almost always succeeds. The message names the holding dream when the
+ * server can identify it (rarely omitted); poll it to a terminal state or cancel
+ * it, then retry. Carried with `x-should-retry: false`.
+ */
+export type BetaDreamingError =
+  | BetaAPI.BetaInvalidRequestError
+  | BetaAPI.BetaAuthenticationError
+  | BetaAPI.BetaBillingError
+  | BetaAPI.BetaPermissionError
+  | BetaAPI.BetaNotFoundError
+  | BetaAPI.BetaRateLimitError
+  | BetaAPI.BetaGatewayTimeoutError
+  | BetaAPI.BetaAPIError
+  | BetaAPI.BetaOverloadedError
+  | BetaTargetStoreHeldError;
+
 /**
  * The default destination: the job creates a new output memory store as a clone of
  * the memory_store input and writes the consolidated memories into it. The input
@@ -347,6 +368,25 @@ export interface BetaOutputBehaviorUpdateExisting {
   type: 'update_existing';
 }
 
+/**
+ * The `output_behavior.memory_store_id` target is still held by a prior
+ * `{type: "update_existing"}` dream — one that is `pending` or `running`, or was
+ * canceled with its final writes still landing. Rarely the named dream has just
+ * finished (`completed`/`failed`) and its execution is still closing; an immediate
+ * retry then almost always succeeds. The message names the holding dream when the
+ * server can identify it (rarely omitted); poll it to a terminal state or cancel
+ * it, then retry. Carried with `x-should-retry: false`.
+ */
+export interface BetaTargetStoreHeldError {
+  type: 'conflict_error';
+
+  /**
+   * Human-readable description of the conflict, naming the dream that holds the
+   * target store when the server can identify it.
+   */
+  message?: string;
+}
+
 export interface DreamCreateParams {
   /**
    * Body param
@@ -440,9 +480,11 @@ export declare namespace Dreams {
     type BetaDreamSessionsInput as BetaDreamSessionsInput,
     type BetaDreamStatus as BetaDreamStatus,
     type BetaDreamUsage as BetaDreamUsage,
+    type BetaDreamingError as BetaDreamingError,
     type BetaOutputBehavior as BetaOutputBehavior,
     type BetaOutputBehaviorCreateNew as BetaOutputBehaviorCreateNew,
     type BetaOutputBehaviorUpdateExisting as BetaOutputBehaviorUpdateExisting,
+    type BetaTargetStoreHeldError as BetaTargetStoreHeldError,
     type BetaDreamsPageCursor as BetaDreamsPageCursor,
     type DreamCreateParams as DreamCreateParams,
     type DreamRetrieveParams as DreamRetrieveParams,

package/src/resources/beta/files.ts

@@ -3,7 +3,7 @@
 import { APIResource } from '../../core/resource';
 import * as BetaAPI from './beta';
 import { APIPromise } from '../../core/api-promise';
-import { Page, type PageParams, PagePromise } from '../../core/pagination';
+import { PageCursor, type PageCursorParams, PagePromise } from '../../core/pagination';
 import { type Uploadable } from '../../core/uploads';
 import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
@@ -26,13 +26,13 @@ export class Files extends APIResource {
   list(
     params: FileListParams | null | undefined = {},
     options?: RequestOptions,
-  ): PagePromise<BetaFileMetadataPage, BetaFileMetadata> {
+  ): PagePromise<BetaFileMetadataPageCursor, BetaFileMetadata> {
     const { betas, ...query } = params ?? {};
-    return this._client.getAPIList('/v1/files?beta=true', Page<BetaFileMetadata>, {
+    return this._client.getAPIList('/v1/files?beta=true', PageCursor<BetaFileMetadata>, {
       query,
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'files-api-2025-04-14'].toString() },
+        { ...(betas?.toString() != null ? { 'anthropic-beta': betas?.toString() } : undefined) },
         options?.headers,
       ]),
     });
@@ -57,7 +57,7 @@ export class Files extends APIResource {
     return this._client.delete(path`/v1/files/${fileID}?beta=true`, {
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'files-api-2025-04-14'].toString() },
+        { ...(betas?.toString() != null ? { 'anthropic-beta': betas?.toString() } : undefined) },
         options?.headers,
       ]),
     });
@@ -86,8 +86,8 @@ export class Files extends APIResource {
       ...options,
       headers: buildHeaders([
         {
-          'anthropic-beta': [...(betas ?? []), 'files-api-2025-04-14'].toString(),
           Accept: 'application/binary',
+          ...(betas?.toString() != null ? { 'anthropic-beta': betas?.toString() } : undefined),
         },
         options?.headers,
       ]),
@@ -113,7 +113,7 @@ export class Files extends APIResource {
     return this._client.get(path`/v1/files/${fileID}?beta=true`, {
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'files-api-2025-04-14'].toString() },
+        { ...(betas?.toString() != null ? { 'anthropic-beta': betas?.toString() } : undefined) },
         options?.headers,
       ]),
     });
@@ -139,7 +139,7 @@ export class Files extends APIResource {
           body,
           ...options,
           headers: buildHeaders([
-            { 'anthropic-beta': [...(betas ?? []), 'files-api-2025-04-14'].toString() },
+            { ...(betas?.toString() != null ? { 'anthropic-beta': betas?.toString() } : undefined) },
             stainlessHelperHeaderFromFile(body.file),
             options?.headers,
           ]),
@@ -150,7 +150,7 @@ export class Files extends APIResource {
   }
 }
 
-export type BetaFileMetadataPage = Page<BetaFileMetadata>;
+export type BetaFileMetadataPageCursor = PageCursor<BetaFileMetadata>;
 
 export interface BetaDeletedFile {
   /**
@@ -206,6 +206,13 @@ export interface BetaFileMetadata {
    */
   downloadable?: boolean;
 
+  /**
+   * RFC 3339 datetime string representing when the file will expire and become
+   * unavailable for download. Null if the file does not expire. For files uploaded
+   * with `expires_in_seconds`, this is the upload time plus that value.
+   */
+  expires_at?: string | null;
+
   /**
    * The scope of this file, indicating the context in which it was created (e.g., a
    * session).
@@ -225,7 +232,16 @@ export interface BetaFileScope {
   type: 'session';
 }
 
-export interface FileListParams extends PageParams {
+export interface FileListParams extends PageCursorParams {
+  /**
+   * Query param: Restrict the result set to Files whose `id` is in this list. At
+   * most 100 entries (after de-duplication). Mutually exclusive with `page` and
+   * `limit`. When supplied, the response is always a single page (`next_page` is
+   * null). IDs that do not resolve to a visible File — including deleted Files — are
+   * silently omitted.
+   */
+  ids?: Array<string> | null;
+
   /**
    * Query param: Filter by scope ID. Only returns files associated with the
    * specified scope (e.g., a session ID).
@@ -265,6 +281,13 @@ export interface FileUploadParams {
    */
   file: Uploadable;
 
+  /**
+   * Body param: Seconds from upload until the file expires and its bytes become
+   * permanently unavailable. Must be between 3600 (one hour) and 7776000 (ninety
+   * days).
+   */
+  expires_in_seconds?: number;
+
   /**
    * Header param: Optional header to specify the beta version(s) you want to use.
    */
@@ -276,7 +299,7 @@ export declare namespace Files {
     type BetaDeletedFile as BetaDeletedFile,
     type BetaFileMetadata as BetaFileMetadata,
     type BetaFileScope as BetaFileScope,
-    type BetaFileMetadataPage as BetaFileMetadataPage,
+    type BetaFileMetadataPageCursor as BetaFileMetadataPageCursor,
     type FileListParams as FileListParams,
     type FileDeleteParams as FileDeleteParams,
     type FileDownloadParams as FileDownloadParams,

package/src/resources/beta/index.ts

@@ -173,9 +173,11 @@ export {
   type BetaDreamSessionsInput,
   type BetaDreamStatus,
   type BetaDreamUsage,
+  type BetaDreamingError,
   type BetaOutputBehavior,
   type BetaOutputBehaviorCreateNew,
   type BetaOutputBehaviorUpdateExisting,
+  type BetaTargetStoreHeldError,
   type DreamCreateParams,
   type DreamRetrieveParams,
   type DreamListParams,
@@ -214,7 +216,7 @@ export {
   type FileDownloadParams,
   type FileRetrieveMetadataParams,
   type FileUploadParams,
-  type BetaFileMetadataPage,
+  type BetaFileMetadataPageCursor,
 } from './files';
 export {
   MemoryStores,
@@ -357,6 +359,7 @@ export {
   type BetaComputerZoomConfig,
   type BetaContainer,
   type BetaContainerParams,
+  type BetaContainerSkill,
   type BetaContainerUploadBlock,
   type BetaContainerUploadBlockParam,
   type BetaContentBlock,
@@ -440,9 +443,9 @@ export {
   type BetaServerToolUseBlock,
   type BetaServerToolUseBlockParam,
   type BetaSignatureDelta,
-  type BetaSkill,
   type BetaSkillParams,
   type BetaStopReason,
+  type BetaSystemMessageOutputConfig,
   type BetaTextBlock,
   type BetaTextBlockParam,
   type BetaTextCitation,
@@ -459,12 +462,15 @@ export {
   type BetaTextEditorCodeExecutionViewResultBlock,
   type BetaTextEditorCodeExecutionViewResultBlockParam,
   type BetaThinkingBlock,
+  type BetaThinkingBlockBinding,
   type BetaThinkingBlockParam,
   type BetaThinkingConfigAdaptive,
   type BetaThinkingConfigDisabled,
   type BetaThinkingConfigEnabled,
   type BetaThinkingConfigParam,
   type BetaThinkingDelta,
+  type BetaThinkingDroppedInputTransformation,
+  type BetaThinkingPrefixMismatchBehavior,
   type BetaThinkingTurns,
   type BetaTokenTaskBudget,
   type BetaTool,
@@ -595,15 +601,14 @@ export {
 } from './sessions/index';
 export {
   Skills,
-  type SkillCreateResponse,
-  type SkillRetrieveResponse,
-  type SkillListResponse,
-  type SkillDeleteResponse,
+  type BetaDeletedSkill,
+  type BetaSkill,
+  type BetaSkillSource,
   type SkillCreateParams,
   type SkillRetrieveParams,
   type SkillListParams,
   type SkillDeleteParams,
-  type SkillListResponsesPageCursor,
+  type BetaSkillsPageCursor,
 } from './skills/index';
 export {
   Tunnels,