@anthropic-ai/sdk 0.65.0 → 0.67.0

package/src/resources/beta/beta.ts

@@ -59,6 +59,7 @@ import {
   BetaCodeExecutionToolResultErrorCode,
   BetaCodeExecutionToolResultErrorParam,
   BetaContainer,
+  BetaContainerParams,
   BetaContainerUploadBlock,
   BetaContainerUploadBlockParam,
   BetaContentBlock,
@@ -111,6 +112,8 @@ import {
   BetaServerToolUseBlock,
   BetaServerToolUseBlockParam,
   BetaSignatureDelta,
+  BetaSkill,
+  BetaSkillParams,
   BetaStopReason,
   BetaTextBlock,
   BetaTextBlockParam,
@@ -181,11 +184,25 @@ import {
   MessageCreateParamsStreaming,
   Messages,
 } from './messages/messages';
+import * as SkillsAPI from './skills/skills';
+import {
+  SkillCreateParams,
+  SkillCreateResponse,
+  SkillDeleteParams,
+  SkillDeleteResponse,
+  SkillListParams,
+  SkillListResponse,
+  SkillListResponsesPageCursor,
+  SkillRetrieveParams,
+  SkillRetrieveResponse,
+  Skills,
+} from './skills/skills';
 
 export class Beta extends APIResource {
   models: ModelsAPI.Models = new ModelsAPI.Models(this._client);
   messages: MessagesAPI.Messages = new MessagesAPI.Messages(this._client);
   files: FilesAPI.Files = new FilesAPI.Files(this._client);
+  skills: SkillsAPI.Skills = new SkillsAPI.Skills(this._client);
 }
 
 export type AnthropicBeta =
@@ -204,7 +221,10 @@ export type AnthropicBeta =
   | 'interleaved-thinking-2025-05-14'
   | 'code-execution-2025-05-22'
   | 'extended-cache-ttl-2025-04-11'
-  | 'context-1m-2025-08-07';
+  | 'context-1m-2025-08-07'
+  | 'context-management-2025-06-27'
+  | 'model-context-window-exceeded-2025-08-26'
+  | 'skills-2025-10-02';
 
 export interface BetaAPIError {
   message: string;
@@ -282,6 +302,7 @@ export interface BetaRateLimitError {
 Beta.Models = Models;
 Beta.Messages = Messages;
 Beta.Files = Files;
+Beta.Skills = Skills;
 
 export declare namespace Beta {
   export {
@@ -350,6 +371,7 @@ export declare namespace Beta {
     type BetaCodeExecutionToolResultErrorCode as BetaCodeExecutionToolResultErrorCode,
     type BetaCodeExecutionToolResultErrorParam as BetaCodeExecutionToolResultErrorParam,
     type BetaContainer as BetaContainer,
+    type BetaContainerParams as BetaContainerParams,
     type BetaContainerUploadBlock as BetaContainerUploadBlock,
     type BetaContainerUploadBlockParam as BetaContainerUploadBlockParam,
     type BetaContentBlock as BetaContentBlock,
@@ -402,6 +424,8 @@ 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 BetaTextBlock as BetaTextBlock,
     type BetaTextBlockParam as BetaTextBlockParam,
@@ -484,4 +508,17 @@ export declare namespace Beta {
     type FileRetrieveMetadataParams as FileRetrieveMetadataParams,
     type FileUploadParams as FileUploadParams,
   };
+
+  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 SkillCreateParams as SkillCreateParams,
+    type SkillRetrieveParams as SkillRetrieveParams,
+    type SkillListParams as SkillListParams,
+    type SkillDeleteParams as SkillDeleteParams,
+  };
 }

package/src/resources/beta/index.ts

@@ -69,6 +69,7 @@ export {
   type BetaCodeExecutionToolResultErrorCode,
   type BetaCodeExecutionToolResultErrorParam,
   type BetaContainer,
+  type BetaContainerParams,
   type BetaContainerUploadBlock,
   type BetaContainerUploadBlockParam,
   type BetaContentBlock,
@@ -121,6 +122,8 @@ export {
   type BetaServerToolUseBlock,
   type BetaServerToolUseBlockParam,
   type BetaSignatureDelta,
+  type BetaSkill,
+  type BetaSkillParams,
   type BetaStopReason,
   type BetaTextBlock,
   type BetaTextBlockParam,
@@ -198,3 +201,15 @@ export {
   type ModelListParams,
   type BetaModelInfosPage,
 } from './models';
+export {
+  Skills,
+  type SkillCreateResponse,
+  type SkillRetrieveResponse,
+  type SkillListResponse,
+  type SkillDeleteResponse,
+  type SkillCreateParams,
+  type SkillRetrieveParams,
+  type SkillListParams,
+  type SkillDeleteParams,
+  type SkillListResponsesPageCursor,
+} from './skills/index';

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

@@ -62,6 +62,7 @@ export {
   type BetaCodeExecutionToolResultErrorCode,
   type BetaCodeExecutionToolResultErrorParam,
   type BetaContainer,
+  type BetaContainerParams,
   type BetaContainerUploadBlock,
   type BetaContainerUploadBlockParam,
   type BetaContentBlock,
@@ -114,6 +115,8 @@ export {
   type BetaServerToolUseBlock,
   type BetaServerToolUseBlockParam,
   type BetaSignatureDelta,
+  type BetaSkill,
+  type BetaSkillParams,
   type BetaStopReason,
   type BetaTextBlock,
   type BetaTextBlockParam,

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

@@ -489,9 +489,6 @@ export interface BetaClearToolUses20250919Edit {
   trigger?: BetaInputTokensTrigger | BetaToolUsesTrigger;
 }
 
-/**
- * Results for clear_tool_uses_20250919 edit.
- */
 export interface BetaClearToolUses20250919EditResponse {
   /**
    * Number of input tokens cleared by this edit.
@@ -638,6 +635,26 @@ export interface BetaContainer {
    * The time at which the container will expire.
    */
   expires_at: string;
+
+  /**
+   * Skills loaded in the container
+   */
+  skills: Array<BetaSkill> | null;
+}
+
+/**
+ * Container parameters with skills to be loaded.
+ */
+export interface BetaContainerParams {
+  /**
+   * Container id
+   */
+  id?: string | null;
+
+  /**
+   * List of skills to load in the container
+   */
+  skills?: Array<BetaSkillParams> | null;
 }
 
 /**
@@ -712,9 +729,6 @@ export interface BetaContentBlockSource {
 
 export type BetaContentBlockSourceContent = BetaTextBlockParam | BetaImageBlockParam;
 
-/**
- * Configuration for context management operations.
- */
 export interface BetaContextManagementConfig {
   /**
    * List of context management edits to apply
@@ -722,9 +736,6 @@ export interface BetaContextManagementConfig {
   edits?: Array<BetaClearToolUses20250919Edit>;
 }
 
-/**
- * Information about context management operations applied during the request.
- */
 export interface BetaContextManagementResponse {
   /**
    * List of context management edits that were applied.
@@ -1026,7 +1037,9 @@ export interface BetaMessage {
   content: Array<BetaContentBlock>;
 
   /**
-   * Information about context management operations applied during the request.
+   * Context management response.
+   *
+   * Information about context management strategies applied during the request.
    */
   context_management: BetaContextManagementResponse | null;
 
@@ -1210,7 +1223,7 @@ export interface BetaRawContentBlockStopEvent {
 
 export interface BetaRawMessageDeltaEvent {
   /**
-   * Information about context management operations applied during the request.
+   * Information about context management strategies applied during the request
    */
   context_management: BetaContextManagementResponse | null;
 
@@ -1397,6 +1410,46 @@ export interface BetaSignatureDelta {
   type: 'signature_delta';
 }
 
+/**
+ * A skill that was loaded in a container (response model).
+ */
+export interface BetaSkill {
+  /**
+   * Skill ID
+   */
+  skill_id: string;
+
+  /**
+   * Type of skill - either 'anthropic' (built-in) or 'custom' (user-defined)
+   */
+  type: 'anthropic' | 'custom';
+
+  /**
+   * Skill version or 'latest' for most recent version
+   */
+  version: string;
+}
+
+/**
+ * Specification for a skill to be loaded in a container (request model).
+ */
+export interface BetaSkillParams {
+  /**
+   * Skill ID
+   */
+  skill_id: string;
+
+  /**
+   * Type of skill - either 'anthropic' (built-in) or 'custom' (user-defined)
+   */
+  type: 'anthropic' | 'custom';
+
+  /**
+   * Skill version or 'latest' for most recent version
+   */
+  version?: string;
+}
+
 export type BetaStopReason =
   | 'end_turn'
   | 'max_tokens'
@@ -1606,7 +1659,7 @@ export interface BetaThinkingConfigEnabled {
    * Must be ≥1024 and less than `max_tokens`.
    *
    * See
-   * [extended thinking](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking)
+   * [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
    * for details.
    */
   budget_tokens: number;
@@ -1622,7 +1675,7 @@ export interface BetaThinkingConfigEnabled {
  * tokens and counts towards your `max_tokens` limit.
  *
  * See
- * [extended thinking](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking)
+ * [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
  * for details.
  */
 export type BetaThinkingConfigParam = BetaThinkingConfigEnabled | BetaThinkingConfigDisabled;
@@ -2309,7 +2362,7 @@ export interface MessageCreateParamsBase {
    * only specifies the absolute maximum number of tokens to generate.
    *
    * Different models have different maximum values for this parameter. See
-   * [models](https://docs.anthropic.com/en/docs/models-overview) for details.
+   * [models](https://docs.claude.com/en/docs/models-overview) for details.
    */
   max_tokens: number;
 
@@ -2371,12 +2424,12 @@ export interface MessageCreateParamsBase {
    * { "role": "user", "content": [{ "type": "text", "text": "Hello, Claude" }] }
    * ```
    *
-   * See [input examples](https://docs.anthropic.com/en/api/messages-examples).
+   * See [input examples](https://docs.claude.com/en/api/messages-examples).
    *
    * Note that if you want to include a
-   * [system prompt](https://docs.anthropic.com/en/docs/system-prompts), you can use
-   * the top-level `system` parameter — there is no `"system"` role for input
-   * messages in the Messages API.
+   * [system prompt](https://docs.claude.com/en/docs/system-prompts), you can use the
+   * top-level `system` parameter — there is no `"system"` role for input messages in
+   * the Messages API.
    *
    * There is a limit of 100,000 messages in a single request.
    */
@@ -2392,10 +2445,13 @@ export interface MessageCreateParamsBase {
   /**
    * Body param: Container identifier for reuse across requests.
    */
-  container?: string | null;
+  container?: BetaContainerParams | string | null;
 
   /**
-   * Body param: Configuration for context management operations.
+   * Body param: Context management configuration.
+   *
+   * This allows you to control how Claude manages context across multiple requests,
+   * such as whether to clear function results or not.
    */
   context_management?: BetaContextManagementConfig | null;
 
@@ -2414,7 +2470,7 @@ export interface MessageCreateParamsBase {
    * standard capacity for this request.
    *
    * Anthropic offers different levels of service for your API requests. See
-   * [service-tiers](https://docs.anthropic.com/en/api/service-tiers) for details.
+   * [service-tiers](https://docs.claude.com/en/api/service-tiers) for details.
    */
   service_tier?: 'auto' | 'standard_only';
 
@@ -2435,8 +2491,7 @@ export interface MessageCreateParamsBase {
    * Body param: Whether to incrementally stream the response using server-sent
    * events.
    *
-   * See [streaming](https://docs.anthropic.com/en/api/messages-streaming) for
-   * details.
+   * See [streaming](https://docs.claude.com/en/api/messages-streaming) for details.
    */
   stream?: boolean;
 
@@ -2445,7 +2500,7 @@ export interface MessageCreateParamsBase {
    *
    * A system prompt is a way of providing context and instructions to Claude, such
    * as specifying a particular goal or role. See our
-   * [guide to system prompts](https://docs.anthropic.com/en/docs/system-prompts).
+   * [guide to system prompts](https://docs.claude.com/en/docs/system-prompts).
    */
   system?: string | Array<BetaTextBlockParam>;
 
@@ -2469,7 +2524,7 @@ export interface MessageCreateParamsBase {
    * tokens and counts towards your `max_tokens` limit.
    *
    * See
-   * [extended thinking](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking)
+   * [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
    * for details.
    */
   thinking?: BetaThinkingConfigParam;
@@ -2490,9 +2545,9 @@ export interface MessageCreateParamsBase {
    *
    * There are two types of tools: **client tools** and **server tools**. The
    * behavior described below applies to client tools. For
-   * [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+   * [server tools](https://docs.claude.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
    * see their individual documentation as each has its own behavior (e.g., the
-   * [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+   * [web search tool](https://docs.claude.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
    *
    * Each tool definition includes:
    *
@@ -2555,7 +2610,7 @@ export interface MessageCreateParamsBase {
    * functions, or more generally whenever you want the model to produce a particular
    * JSON structure of output.
    *
-   * See our [guide](https://docs.anthropic.com/en/docs/tool-use) for more details.
+   * See our [guide](https://docs.claude.com/en/docs/tool-use) for more details.
    */
   tools?: Array<BetaToolUnion>;
 
@@ -2599,8 +2654,7 @@ export interface MessageCreateParamsNonStreaming extends MessageCreateParamsBase
    * Body param: Whether to incrementally stream the response using server-sent
    * events.
    *
-   * See [streaming](https://docs.anthropic.com/en/api/messages-streaming) for
-   * details.
+   * See [streaming](https://docs.claude.com/en/api/messages-streaming) for details.
    */
   stream?: false;
 }
@@ -2610,8 +2664,7 @@ export interface MessageCreateParamsStreaming extends MessageCreateParamsBase {
    * Body param: Whether to incrementally stream the response using server-sent
    * events.
    *
-   * See [streaming](https://docs.anthropic.com/en/api/messages-streaming) for
-   * details.
+   * See [streaming](https://docs.claude.com/en/api/messages-streaming) for details.
    */
   stream: true;
 }
@@ -2675,12 +2728,12 @@ export interface MessageCountTokensParams {
    * { "role": "user", "content": [{ "type": "text", "text": "Hello, Claude" }] }
    * ```
    *
-   * See [input examples](https://docs.anthropic.com/en/api/messages-examples).
+   * See [input examples](https://docs.claude.com/en/api/messages-examples).
    *
    * Note that if you want to include a
-   * [system prompt](https://docs.anthropic.com/en/docs/system-prompts), you can use
-   * the top-level `system` parameter — there is no `"system"` role for input
-   * messages in the Messages API.
+   * [system prompt](https://docs.claude.com/en/docs/system-prompts), you can use the
+   * top-level `system` parameter — there is no `"system"` role for input messages in
+   * the Messages API.
    *
    * There is a limit of 100,000 messages in a single request.
    */
@@ -2694,7 +2747,10 @@ export interface MessageCountTokensParams {
   model: MessagesAPI.Model;
 
   /**
-   * Body param: Configuration for context management operations.
+   * Body param: Context management configuration.
+   *
+   * This allows you to control how Claude manages context across multiple requests,
+   * such as whether to clear function results or not.
    */
   context_management?: BetaContextManagementConfig | null;
 
@@ -2708,7 +2764,7 @@ export interface MessageCountTokensParams {
    *
    * A system prompt is a way of providing context and instructions to Claude, such
    * as specifying a particular goal or role. See our
-   * [guide to system prompts](https://docs.anthropic.com/en/docs/system-prompts).
+   * [guide to system prompts](https://docs.claude.com/en/docs/system-prompts).
    */
   system?: string | Array<BetaTextBlockParam>;
 
@@ -2720,7 +2776,7 @@ export interface MessageCountTokensParams {
    * tokens and counts towards your `max_tokens` limit.
    *
    * See
-   * [extended thinking](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking)
+   * [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
    * for details.
    */
   thinking?: BetaThinkingConfigParam;
@@ -2741,9 +2797,9 @@ export interface MessageCountTokensParams {
    *
    * There are two types of tools: **client tools** and **server tools**. The
    * behavior described below applies to client tools. For
-   * [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+   * [server tools](https://docs.claude.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
    * see their individual documentation as each has its own behavior (e.g., the
-   * [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+   * [web search tool](https://docs.claude.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
    *
    * Each tool definition includes:
    *
@@ -2806,7 +2862,7 @@ export interface MessageCountTokensParams {
    * functions, or more generally whenever you want the model to produce a particular
    * JSON structure of output.
    *
-   * See our [guide](https://docs.anthropic.com/en/docs/tool-use) for more details.
+   * See our [guide](https://docs.claude.com/en/docs/tool-use) for more details.
    */
   tools?: Array<
     | BetaTool
@@ -2880,6 +2936,7 @@ export declare namespace Messages {
     type BetaCodeExecutionToolResultErrorCode as BetaCodeExecutionToolResultErrorCode,
     type BetaCodeExecutionToolResultErrorParam as BetaCodeExecutionToolResultErrorParam,
     type BetaContainer as BetaContainer,
+    type BetaContainerParams as BetaContainerParams,
     type BetaContainerUploadBlock as BetaContainerUploadBlock,
     type BetaContainerUploadBlockParam as BetaContainerUploadBlockParam,
     type BetaContentBlock as BetaContentBlock,
@@ -2932,6 +2989,8 @@ export declare namespace Messages {
     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 BetaTextBlock as BetaTextBlock,
     type BetaTextBlockParam as BetaTextBlockParam,

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

@@ -0,0 +1,26 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Skills,
+  type SkillCreateResponse,
+  type SkillRetrieveResponse,
+  type SkillListResponse,
+  type SkillDeleteResponse,
+  type SkillCreateParams,
+  type SkillRetrieveParams,
+  type SkillListParams,
+  type SkillDeleteParams,
+  type SkillListResponsesPageCursor,
+} from './skills';
+export {
+  Versions,
+  type VersionCreateResponse,
+  type VersionRetrieveResponse,
+  type VersionListResponse,
+  type VersionDeleteResponse,
+  type VersionCreateParams,
+  type VersionRetrieveParams,
+  type VersionListParams,
+  type VersionDeleteParams,
+  type VersionListResponsesPageCursor,
+} from './versions';