@anthropic-ai/sdk 0.110.0 → 0.112.0

package/src/resources/beta/beta.ts

@@ -75,6 +75,27 @@ import {
   DeploymentUpdateParams,
   Deployments,
 } from './deployments';
+import * as DreamsAPI from './dreams';
+import {
+  BetaDream,
+  BetaDreamError,
+  BetaDreamInput,
+  BetaDreamMemoryStoreInput,
+  BetaDreamMemoryStoreOutput,
+  BetaDreamModelConfig,
+  BetaDreamModelConfigParam,
+  BetaDreamOutput,
+  BetaDreamSessionsInput,
+  BetaDreamStatus,
+  BetaDreamUsage,
+  BetaDreamsPageCursor,
+  DreamArchiveParams,
+  DreamCancelParams,
+  DreamCreateParams,
+  DreamListParams,
+  DreamRetrieveParams,
+  Dreams,
+} from './dreams';
 import * as FilesAPI from './files';
 import {
   BetaFileScope,
@@ -525,6 +546,19 @@ import {
   SkillRetrieveResponse,
   Skills,
 } from './skills/skills';
+import * as TunnelsAPI from './tunnels/tunnels';
+import {
+  BetaTunnel,
+  BetaTunnelToken,
+  BetaTunnelsPageCursor,
+  TunnelArchiveParams,
+  TunnelCreateParams,
+  TunnelListParams,
+  TunnelRetrieveParams,
+  TunnelRevealTokenParams,
+  TunnelRotateTokenParams,
+  Tunnels,
+} from './tunnels/tunnels';
 import * as VaultsAPI from './vaults/vaults';
 import {
   BetaManagedAgentsDeletedVault,
@@ -553,6 +587,8 @@ export class Beta extends APIResource {
   skills: SkillsAPI.Skills = new SkillsAPI.Skills(this._client);
   webhooks: WebhooksAPI.Webhooks = new WebhooksAPI.Webhooks(this._client);
   userProfiles: UserProfilesAPI.UserProfiles = new UserProfilesAPI.UserProfiles(this._client);
+  dreams: DreamsAPI.Dreams = new DreamsAPI.Dreams(this._client);
+  tunnels: TunnelsAPI.Tunnels = new TunnelsAPI.Tunnels(this._client);
 }
 
 export type AnthropicBeta =
@@ -582,6 +618,7 @@ export type AnthropicBeta =
   | 'advisor-tool-2026-03-01'
   | 'managed-agents-2026-04-01'
   | 'cache-diagnosis-2026-04-07'
+  | 'dreaming-2026-04-21'
   | 'thinking-token-count-2026-05-13'
   | 'server-side-fallback-2026-06-01'
   | 'fallback-credit-2026-06-01'
@@ -673,6 +710,8 @@ Beta.Files = Files;
 Beta.Skills = Skills;
 Beta.Webhooks = Webhooks;
 Beta.UserProfiles = UserProfiles;
+Beta.Dreams = Dreams;
+Beta.Tunnels = Tunnels;
 
 export declare namespace Beta {
   export {
@@ -1226,4 +1265,38 @@ export declare namespace Beta {
     type UserProfileListParams as UserProfileListParams,
     type UserProfileCreateEnrollmentURLParams as UserProfileCreateEnrollmentURLParams,
   };
+
+  export {
+    Dreams as Dreams,
+    type BetaDream as BetaDream,
+    type BetaDreamError as BetaDreamError,
+    type BetaDreamInput as BetaDreamInput,
+    type BetaDreamMemoryStoreInput as BetaDreamMemoryStoreInput,
+    type BetaDreamMemoryStoreOutput as BetaDreamMemoryStoreOutput,
+    type BetaDreamModelConfig as BetaDreamModelConfig,
+    type BetaDreamModelConfigParam as BetaDreamModelConfigParam,
+    type BetaDreamOutput as BetaDreamOutput,
+    type BetaDreamSessionsInput as BetaDreamSessionsInput,
+    type BetaDreamStatus as BetaDreamStatus,
+    type BetaDreamUsage as BetaDreamUsage,
+    type BetaDreamsPageCursor as BetaDreamsPageCursor,
+    type DreamCreateParams as DreamCreateParams,
+    type DreamRetrieveParams as DreamRetrieveParams,
+    type DreamListParams as DreamListParams,
+    type DreamArchiveParams as DreamArchiveParams,
+    type DreamCancelParams as DreamCancelParams,
+  };
+
+  export {
+    Tunnels as Tunnels,
+    type BetaTunnel as BetaTunnel,
+    type BetaTunnelToken as BetaTunnelToken,
+    type BetaTunnelsPageCursor as BetaTunnelsPageCursor,
+    type TunnelCreateParams as TunnelCreateParams,
+    type TunnelRetrieveParams as TunnelRetrieveParams,
+    type TunnelListParams as TunnelListParams,
+    type TunnelArchiveParams as TunnelArchiveParams,
+    type TunnelRevealTokenParams as TunnelRevealTokenParams,
+    type TunnelRotateTokenParams as TunnelRotateTokenParams,
+  };
 }

package/src/resources/beta/dreams.ts

@@ -0,0 +1,404 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as BetaAPI from './beta';
+import { APIPromise } from '../../core/api-promise';
+import { PageCursor, type PageCursorParams, PagePromise } from '../../core/pagination';
+import { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Dreams extends APIResource {
+  /**
+   * Create a Dream
+   *
+   * @example
+   * ```ts
+   * const betaDream = await client.beta.dreams.create({
+   *   inputs: [{ memory_store_id: 'x', type: 'memory_store' }],
+   *   model: 'string',
+   * });
+   * ```
+   */
+  create(params: DreamCreateParams, options?: RequestOptions): APIPromise<BetaDream> {
+    const { betas, ...body } = params;
+    return this._client.post('/v1/dreams?beta=true', {
+      body,
+      ...options,
+      headers: buildHeaders([
+        { 'anthropic-beta': [...(betas ?? []), 'dreaming-2026-04-21'].toString() },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Get a Dream
+   *
+   * @example
+   * ```ts
+   * const betaDream = await client.beta.dreams.retrieve(
+   *   'dream_id',
+   * );
+   * ```
+   */
+  retrieve(
+    dreamID: string,
+    params: DreamRetrieveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<BetaDream> {
+    const { betas } = params ?? {};
+    return this._client.get(path`/v1/dreams/${dreamID}?beta=true`, {
+      ...options,
+      headers: buildHeaders([
+        { 'anthropic-beta': [...(betas ?? []), 'dreaming-2026-04-21'].toString() },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * List Dreams
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const betaDream of client.beta.dreams.list()) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    params: DreamListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<BetaDreamsPageCursor, BetaDream> {
+    const { betas, ...query } = params ?? {};
+    return this._client.getAPIList('/v1/dreams?beta=true', PageCursor<BetaDream>, {
+      query,
+      ...options,
+      headers: buildHeaders([
+        { 'anthropic-beta': [...(betas ?? []), 'dreaming-2026-04-21'].toString() },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Archive a Dream
+   *
+   * @example
+   * ```ts
+   * const betaDream = await client.beta.dreams.archive(
+   *   'dream_id',
+   * );
+   * ```
+   */
+  archive(
+    dreamID: string,
+    params: DreamArchiveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<BetaDream> {
+    const { betas } = params ?? {};
+    return this._client.post(path`/v1/dreams/${dreamID}/archive?beta=true`, {
+      ...options,
+      headers: buildHeaders([
+        { 'anthropic-beta': [...(betas ?? []), 'dreaming-2026-04-21'].toString() },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Cancel a Dream
+   *
+   * @example
+   * ```ts
+   * const betaDream = await client.beta.dreams.cancel(
+   *   'dream_id',
+   * );
+   * ```
+   */
+  cancel(
+    dreamID: string,
+    params: DreamCancelParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<BetaDream> {
+    const { betas } = params ?? {};
+    return this._client.post(path`/v1/dreams/${dreamID}/cancel?beta=true`, {
+      ...options,
+      headers: buildHeaders([
+        { 'anthropic-beta': [...(betas ?? []), 'dreaming-2026-04-21'].toString() },
+        options?.headers,
+      ]),
+    });
+  }
+}
+
+export type BetaDreamsPageCursor = PageCursor<BetaDream>;
+
+/**
+ * An asynchronous memory-consolidation job that reads a memory store plus a set of
+ * session transcripts and writes consolidated memories into a new output memory
+ * store. The Dreams API is in research preview: the request and response shapes
+ * are volatile and may change without the deprecation period that applies to
+ * generally-available endpoints.
+ */
+export interface BetaDream {
+  id: string;
+
+  /**
+   * A timestamp in RFC 3339 format
+   */
+  archived_at: string | null;
+
+  /**
+   * A timestamp in RFC 3339 format
+   */
+  created_at: string;
+
+  /**
+   * A timestamp in RFC 3339 format
+   */
+  ended_at: string | null;
+
+  /**
+   * Failure detail for a Dream whose `status` is `failed`.
+   */
+  error: BetaDreamError | null;
+
+  inputs: Array<BetaDreamInput>;
+
+  instructions: string | null;
+
+  /**
+   * Model identifier and configuration applied to every pipeline stage. Same wire
+   * shape as the Agents API ModelConfig.
+   */
+  model: BetaDreamModelConfig;
+
+  outputs: Array<BetaDreamOutput>;
+
+  session_id: string | null;
+
+  /**
+   * Lifecycle status of a Dream.
+   */
+  status: BetaDreamStatus;
+
+  type: 'dream';
+
+  /**
+   * Cumulative token usage for the dream across every pipeline stage.
+   */
+  usage: BetaDreamUsage;
+}
+
+/**
+ * Failure detail for a Dream whose `status` is `failed`.
+ */
+export interface BetaDreamError {
+  message: string;
+
+  type: string;
+}
+
+/**
+ * An input memory store the dream reads from. The dream never mutates this store.
+ */
+export type BetaDreamInput = BetaDreamMemoryStoreInput | BetaDreamSessionsInput;
+
+/**
+ * An input memory store the dream reads from. The dream never mutates this store.
+ */
+export interface BetaDreamMemoryStoreInput {
+  memory_store_id: string;
+
+  type: 'memory_store';
+}
+
+/**
+ * An output memory store the dream writes consolidated memories into.
+ */
+export interface BetaDreamMemoryStoreOutput {
+  memory_store_id: string;
+
+  type: 'memory_store';
+}
+
+/**
+ * Model identifier and configuration applied to every pipeline stage. Same wire
+ * shape as the Agents API ModelConfig.
+ */
+export interface BetaDreamModelConfig {
+  /**
+   * Model identifier, e.g. "claude-opus-4-7". 1-256 characters.
+   */
+  id: string;
+
+  /**
+   * Inference speed mode. `fast` provides significantly faster output token
+   * generation at premium pricing. Not all models support `fast`; invalid
+   * combinations are rejected at create time.
+   */
+  speed?: 'standard' | 'fast';
+}
+
+/**
+ * Model identifier and configuration applied to every pipeline stage.
+ */
+export interface BetaDreamModelConfigParam {
+  /**
+   * Model identifier, e.g. "claude-opus-4-7". 1-256 characters.
+   */
+  id: string;
+
+  /**
+   * Inference speed mode. `fast` provides significantly faster output token
+   * generation at premium pricing. Not all models support `fast`; invalid
+   * combinations are rejected at create time.
+   */
+  speed?: 'standard' | 'fast' | null;
+}
+
+/**
+ * An output memory store the dream writes consolidated memories into.
+ */
+export interface BetaDreamOutput {
+  memory_store_id: string;
+
+  type: 'memory_store';
+}
+
+/**
+ * Input session transcripts the dream reads.
+ */
+export interface BetaDreamSessionsInput {
+  session_ids: Array<string>;
+
+  type: 'sessions';
+}
+
+/**
+ * Lifecycle status of a Dream.
+ */
+export type BetaDreamStatus = 'pending' | 'running' | 'completed' | 'failed' | 'canceled';
+
+/**
+ * Cumulative token usage for the dream across every pipeline stage.
+ */
+export interface BetaDreamUsage {
+  /**
+   * Total tokens used to create prompt-cache entries (sum of all TTL tiers).
+   */
+  cache_creation_input_tokens: number;
+
+  /**
+   * Total tokens read from prompt cache.
+   */
+  cache_read_input_tokens: number;
+
+  /**
+   * Total uncached input tokens consumed across every pipeline stage.
+   */
+  input_tokens: number;
+
+  /**
+   * Total output tokens generated across every pipeline stage.
+   */
+  output_tokens: number;
+}
+
+export interface DreamCreateParams {
+  /**
+   * Body param
+   */
+  inputs: Array<BetaDreamInput>;
+
+  /**
+   * Body param: Model identifier and configuration applied to every pipeline stage.
+   */
+  model: string | BetaDreamModelConfigParam;
+
+  /**
+   * Body param
+   */
+  instructions?: string | null;
+
+  /**
+   * Header param: Optional header to specify the beta version(s) you want to use.
+   */
+  betas?: Array<BetaAPI.AnthropicBeta>;
+}
+
+export interface DreamRetrieveParams {
+  /**
+   * Optional header to specify the beta version(s) you want to use.
+   */
+  betas?: Array<BetaAPI.AnthropicBeta>;
+}
+
+export interface DreamListParams extends PageCursorParams {
+  /**
+   * Query param: Return dreams with `created_at` strictly after this timestamp
+   * (exclusive lower bound, RFC 3339). Unset applies no lower bound.
+   */
+  'created_at[gt]'?: string;
+
+  /**
+   * Query param: Return dreams with `created_at` strictly before this timestamp
+   * (exclusive upper bound, RFC 3339). Unset applies no upper bound.
+   */
+  'created_at[lt]'?: string;
+
+  /**
+   * Query param: Query parameter for include_archived
+   */
+  include_archived?: boolean;
+
+  /**
+   * Query param: Filter by lifecycle status. Repeat the parameter to match any of
+   * multiple statuses. Empty applies no status filter.
+   */
+  statuses?: Array<BetaDreamStatus>;
+
+  /**
+   * Header param: Optional header to specify the beta version(s) you want to use.
+   */
+  betas?: Array<BetaAPI.AnthropicBeta>;
+}
+
+export interface DreamArchiveParams {
+  /**
+   * Optional header to specify the beta version(s) you want to use.
+   */
+  betas?: Array<BetaAPI.AnthropicBeta>;
+}
+
+export interface DreamCancelParams {
+  /**
+   * Optional header to specify the beta version(s) you want to use.
+   */
+  betas?: Array<BetaAPI.AnthropicBeta>;
+}
+
+export declare namespace Dreams {
+  export {
+    type BetaDream as BetaDream,
+    type BetaDreamError as BetaDreamError,
+    type BetaDreamInput as BetaDreamInput,
+    type BetaDreamMemoryStoreInput as BetaDreamMemoryStoreInput,
+    type BetaDreamMemoryStoreOutput as BetaDreamMemoryStoreOutput,
+    type BetaDreamModelConfig as BetaDreamModelConfig,
+    type BetaDreamModelConfigParam as BetaDreamModelConfigParam,
+    type BetaDreamOutput as BetaDreamOutput,
+    type BetaDreamSessionsInput as BetaDreamSessionsInput,
+    type BetaDreamStatus as BetaDreamStatus,
+    type BetaDreamUsage as BetaDreamUsage,
+    type BetaDreamsPageCursor as BetaDreamsPageCursor,
+    type DreamCreateParams as DreamCreateParams,
+    type DreamRetrieveParams as DreamRetrieveParams,
+    type DreamListParams as DreamListParams,
+    type DreamArchiveParams as DreamArchiveParams,
+    type DreamCancelParams as DreamCancelParams,
+  };
+}

package/src/resources/beta/index.ts

@@ -135,6 +135,26 @@ export {
   type DeploymentUnpauseParams,
   type BetaManagedAgentsDeploymentsPageCursor,
 } from './deployments';
+export {
+  Dreams,
+  type BetaDream,
+  type BetaDreamError,
+  type BetaDreamInput,
+  type BetaDreamMemoryStoreInput,
+  type BetaDreamMemoryStoreOutput,
+  type BetaDreamModelConfig,
+  type BetaDreamModelConfigParam,
+  type BetaDreamOutput,
+  type BetaDreamSessionsInput,
+  type BetaDreamStatus,
+  type BetaDreamUsage,
+  type DreamCreateParams,
+  type DreamRetrieveParams,
+  type DreamListParams,
+  type DreamArchiveParams,
+  type DreamCancelParams,
+  type BetaDreamsPageCursor,
+} from './dreams';
 export {
   Environments,
   type BetaCloudConfig,
@@ -483,6 +503,18 @@ export {
   type SkillDeleteParams,
   type SkillListResponsesPageCursor,
 } from './skills/index';
+export {
+  Tunnels,
+  type BetaTunnel,
+  type BetaTunnelToken,
+  type TunnelCreateParams,
+  type TunnelRetrieveParams,
+  type TunnelListParams,
+  type TunnelArchiveParams,
+  type TunnelRevealTokenParams,
+  type TunnelRotateTokenParams,
+  type BetaTunnelsPageCursor,
+} from './tunnels/index';
 export {
   UserProfiles,
   type BetaUserProfile,

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

@@ -657,8 +657,9 @@ export namespace BatchCreateParams {
       service_tier?: 'auto' | 'standard_only';
 
       /**
-       * The inference speed mode for this request. `"fast"` enables high
-       * output-tokens-per-second inference.
+       * Inference speed mode. `fast` provides significantly faster output token
+       * generation at premium pricing. Not all models support `fast`; invalid
+       * combinations are rejected at create time.
        */
       speed?: 'standard' | 'fast' | null;
 

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

@@ -1708,10 +1708,10 @@ export interface BetaFallbackMessageIterationUsage {
 /**
  * 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.
+ * `model` is required. The override fields (`max_tokens`, `thinking`,
+ * `output_config`, and `speed`) set the corresponding parameter 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 {
   /**
@@ -1726,6 +1726,11 @@ export interface BetaFallbackParam {
 
   output_config?: BetaOutputConfig | null;
 
+  /**
+   * Inference speed mode. `fast` provides significantly faster output token
+   * generation at premium pricing. Not all models support `fast`; invalid
+   * combinations are rejected at create time.
+   */
   speed?: 'standard' | 'fast' | null;
 
   thinking?: BetaThinkingConfigEnabled | BetaThinkingConfigDisabled | BetaThinkingConfigAdaptive | null;
@@ -3878,7 +3883,9 @@ export interface BetaUsage {
   service_tier: 'standard' | 'priority' | 'batch' | null;
 
   /**
-   * The inference speed mode used for this request.
+   * Inference speed mode. `fast` provides significantly faster output token
+   * generation at premium pricing. Not all models support `fast`; invalid
+   * combinations are rejected at create time.
    */
   speed: 'standard' | 'fast' | null;
 }
@@ -4708,8 +4715,9 @@ export interface MessageCreateParamsBase {
   service_tier?: 'auto' | 'standard_only';
 
   /**
-   * Body param: The inference speed mode for this request. `"fast"` enables high
-   * output-tokens-per-second inference.
+   * Body param: Inference speed mode. `fast` provides significantly faster output
+   * token generation at premium pricing. Not all models support `fast`; invalid
+   * combinations are rejected at create time.
    */
   speed?: 'standard' | 'fast' | null;
 
@@ -5018,8 +5026,9 @@ export interface MessageCountTokensParams {
   output_format?: BetaJSONOutputFormat | null;
 
   /**
-   * Body param: The inference speed mode for this request. `"fast"` enables high
-   * output-tokens-per-second inference.
+   * Body param: Inference speed mode. `fast` provides significantly faster output
+   * token generation at premium pricing. Not all models support `fast`; invalid
+   * combinations are rejected at create time.
    */
   speed?: 'standard' | 'fast' | null;