@anthropic-ai/sdk 0.66.0 → 0.67.0

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

@@ -0,0 +1,374 @@
+// 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 { type Uploadable } from '../../../core/uploads';
+import { buildHeaders } from '../../../internal/headers';
+import { RequestOptions } from '../../../internal/request-options';
+import { multipartFormRequestOptions } from '../../../internal/uploads';
+import { path } from '../../../internal/utils/path';
+
+export class Versions extends APIResource {
+  /**
+   * Create Skill Version
+   *
+   * @example
+   * ```ts
+   * const version = await client.beta.skills.versions.create(
+   *   'skill_id',
+   * );
+   * ```
+   */
+  create(
+    skillID: string,
+    params: VersionCreateParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<VersionCreateResponse> {
+    const { betas, ...body } = params ?? {};
+    return this._client.post(
+      path`/v1/skills/${skillID}/versions?beta=true`,
+      multipartFormRequestOptions(
+        {
+          body,
+          ...options,
+          headers: buildHeaders([
+            { 'anthropic-beta': [...(betas ?? []), 'skills-2025-10-02'].toString() },
+            options?.headers,
+          ]),
+        },
+        this._client,
+      ),
+    );
+  }
+
+  /**
+   * Get Skill Version
+   *
+   * @example
+   * ```ts
+   * const version = await client.beta.skills.versions.retrieve(
+   *   'version',
+   *   { skill_id: 'skill_id' },
+   * );
+   * ```
+   */
+  retrieve(
+    version: string,
+    params: VersionRetrieveParams,
+    options?: RequestOptions,
+  ): APIPromise<VersionRetrieveResponse> {
+    const { skill_id, betas } = params;
+    return this._client.get(path`/v1/skills/${skill_id}/versions/${version}?beta=true`, {
+      ...options,
+      headers: buildHeaders([
+        { 'anthropic-beta': [...(betas ?? []), 'skills-2025-10-02'].toString() },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * List Skill Versions
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const versionListResponse of client.beta.skills.versions.list(
+   *   'skill_id',
+   * )) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    skillID: string,
+    params: VersionListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<VersionListResponsesPageCursor, VersionListResponse> {
+    const { betas, ...query } = params ?? {};
+    return this._client.getAPIList(
+      path`/v1/skills/${skillID}/versions?beta=true`,
+      PageCursor<VersionListResponse>,
+      {
+        query,
+        ...options,
+        headers: buildHeaders([
+          { 'anthropic-beta': [...(betas ?? []), 'skills-2025-10-02'].toString() },
+          options?.headers,
+        ]),
+      },
+    );
+  }
+
+  /**
+   * Delete Skill Version
+   *
+   * @example
+   * ```ts
+   * const version = await client.beta.skills.versions.delete(
+   *   'version',
+   *   { skill_id: 'skill_id' },
+   * );
+   * ```
+   */
+  delete(
+    version: string,
+    params: VersionDeleteParams,
+    options?: RequestOptions,
+  ): APIPromise<VersionDeleteResponse> {
+    const { skill_id, betas } = params;
+    return this._client.delete(path`/v1/skills/${skill_id}/versions/${version}?beta=true`, {
+      ...options,
+      headers: buildHeaders([
+        { 'anthropic-beta': [...(betas ?? []), 'skills-2025-10-02'].toString() },
+        options?.headers,
+      ]),
+    });
+  }
+}
+
+export type VersionListResponsesPageCursor = PageCursor<VersionListResponse>;
+
+export interface VersionCreateResponse {
+  /**
+   * Unique identifier for the skill version.
+   *
+   * The format and length of IDs may change over time.
+   */
+  id: string;
+
+  /**
+   * ISO 8601 timestamp of when the skill version was created.
+   */
+  created_at: string;
+
+  /**
+   * Description of the skill version.
+   *
+   * This is extracted from the SKILL.md file in the skill upload.
+   */
+  description: string;
+
+  /**
+   * Directory name of the skill version.
+   *
+   * This is the top-level directory name that was extracted from the uploaded files.
+   */
+  directory: string;
+
+  /**
+   * Human-readable name of the skill version.
+   *
+   * This is extracted from the SKILL.md file in the skill upload.
+   */
+  name: string;
+
+  /**
+   * Identifier for the skill that this version belongs to.
+   */
+  skill_id: string;
+
+  /**
+   * Object type.
+   *
+   * For Skill Versions, this is always `"skill_version"`.
+   */
+  type: string;
+
+  /**
+   * Version identifier for the skill.
+   *
+   * Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
+   */
+  version: string;
+}
+
+export interface VersionRetrieveResponse {
+  /**
+   * Unique identifier for the skill version.
+   *
+   * The format and length of IDs may change over time.
+   */
+  id: string;
+
+  /**
+   * ISO 8601 timestamp of when the skill version was created.
+   */
+  created_at: string;
+
+  /**
+   * Description of the skill version.
+   *
+   * This is extracted from the SKILL.md file in the skill upload.
+   */
+  description: string;
+
+  /**
+   * Directory name of the skill version.
+   *
+   * This is the top-level directory name that was extracted from the uploaded files.
+   */
+  directory: string;
+
+  /**
+   * Human-readable name of the skill version.
+   *
+   * This is extracted from the SKILL.md file in the skill upload.
+   */
+  name: string;
+
+  /**
+   * Identifier for the skill that this version belongs to.
+   */
+  skill_id: string;
+
+  /**
+   * Object type.
+   *
+   * For Skill Versions, this is always `"skill_version"`.
+   */
+  type: string;
+
+  /**
+   * Version identifier for the skill.
+   *
+   * Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
+   */
+  version: string;
+}
+
+export interface VersionListResponse {
+  /**
+   * Unique identifier for the skill version.
+   *
+   * The format and length of IDs may change over time.
+   */
+  id: string;
+
+  /**
+   * ISO 8601 timestamp of when the skill version was created.
+   */
+  created_at: string;
+
+  /**
+   * Description of the skill version.
+   *
+   * This is extracted from the SKILL.md file in the skill upload.
+   */
+  description: string;
+
+  /**
+   * Directory name of the skill version.
+   *
+   * This is the top-level directory name that was extracted from the uploaded files.
+   */
+  directory: string;
+
+  /**
+   * Human-readable name of the skill version.
+   *
+   * This is extracted from the SKILL.md file in the skill upload.
+   */
+  name: string;
+
+  /**
+   * Identifier for the skill that this version belongs to.
+   */
+  skill_id: string;
+
+  /**
+   * Object type.
+   *
+   * For Skill Versions, this is always `"skill_version"`.
+   */
+  type: string;
+
+  /**
+   * Version identifier for the skill.
+   *
+   * Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
+   */
+  version: string;
+}
+
+export interface VersionDeleteResponse {
+  /**
+   * Version identifier for the skill.
+   *
+   * Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
+   */
+  id: string;
+
+  /**
+   * Deleted object type.
+   *
+   * For Skill Versions, this is always `"skill_version_deleted"`.
+   */
+  type: string;
+}
+
+export interface VersionCreateParams {
+  /**
+   * Body param: Files to upload for the skill.
+   *
+   * All files must be in the same top-level directory and must include a SKILL.md
+   * file at the root of that directory.
+   */
+  files?: Array<Uploadable> | null;
+
+  /**
+   * Header param: Optional header to specify the beta version(s) you want to use.
+   */
+  betas?: Array<BetaAPI.AnthropicBeta>;
+}
+
+export interface VersionRetrieveParams {
+  /**
+   * Path param: Unique identifier for the skill.
+   *
+   * The format and length of IDs may change over time.
+   */
+  skill_id: string;
+
+  /**
+   * Header param: Optional header to specify the beta version(s) you want to use.
+   */
+  betas?: Array<BetaAPI.AnthropicBeta>;
+}
+
+export interface VersionListParams extends PageCursorParams {
+  /**
+   * Header param: Optional header to specify the beta version(s) you want to use.
+   */
+  betas?: Array<BetaAPI.AnthropicBeta>;
+}
+
+export interface VersionDeleteParams {
+  /**
+   * Path param: Unique identifier for the skill.
+   *
+   * The format and length of IDs may change over time.
+   */
+  skill_id: string;
+
+  /**
+   * Header param: Optional header to specify the beta version(s) you want to use.
+   */
+  betas?: Array<BetaAPI.AnthropicBeta>;
+}
+
+export declare namespace Versions {
+  export {
+    type VersionCreateResponse as VersionCreateResponse,
+    type VersionRetrieveResponse as VersionRetrieveResponse,
+    type VersionListResponse as VersionListResponse,
+    type VersionDeleteResponse as VersionDeleteResponse,
+    type VersionListResponsesPageCursor as VersionListResponsesPageCursor,
+    type VersionCreateParams as VersionCreateParams,
+    type VersionRetrieveParams as VersionRetrieveParams,
+    type VersionListParams as VersionListParams,
+    type VersionDeleteParams as VersionDeleteParams,
+  };
+}

package/src/resources/beta/skills.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './skills/index';

package/src/resources/completions.ts

@@ -14,10 +14,10 @@ export class Completions extends APIResource {
    * [Legacy] Create a Text Completion.
    *
    * The Text Completions API is a legacy API. We recommend using the
-   * [Messages API](https://docs.anthropic.com/en/api/messages) going forward.
+   * [Messages API](https://docs.claude.com/en/api/messages) going forward.
    *
    * Future models and features will not be compatible with Text Completions. See our
-   * [migration guide](https://docs.anthropic.com/en/api/migrating-from-text-completions-to-messages)
+   * [migration guide](https://docs.claude.com/en/api/migrating-from-text-completions-to-messages)
    * for guidance in migrating from Text Completions to Messages.
    *
    * @example
@@ -120,10 +120,9 @@ export interface CompletionCreateParamsBase {
    * "\n\nHuman: {userQuestion}\n\nAssistant:"
    * ```
    *
-   * See [prompt validation](https://docs.anthropic.com/en/api/prompt-validation) and
-   * our guide to
-   * [prompt design](https://docs.anthropic.com/en/docs/intro-to-prompting) for more
-   * details.
+   * See [prompt validation](https://docs.claude.com/en/api/prompt-validation) and
+   * our guide to [prompt design](https://docs.claude.com/en/docs/intro-to-prompting)
+   * for more details.
    */
   prompt: string;
 
@@ -145,7 +144,7 @@ export interface CompletionCreateParamsBase {
    * Body param: Whether to incrementally stream the response using server-sent
    * events.
    *
-   * See [streaming](https://docs.anthropic.com/en/api/streaming) for details.
+   * See [streaming](https://docs.claude.com/en/api/streaming) for details.
    */
   stream?: boolean;
 
@@ -206,7 +205,7 @@ export interface CompletionCreateParamsNonStreaming extends CompletionCreatePara
    * Body param: Whether to incrementally stream the response using server-sent
    * events.
    *
-   * See [streaming](https://docs.anthropic.com/en/api/streaming) for details.
+   * See [streaming](https://docs.claude.com/en/api/streaming) for details.
    */
   stream?: false;
 }
@@ -216,7 +215,7 @@ export interface CompletionCreateParamsStreaming extends CompletionCreateParamsB
    * Body param: Whether to incrementally stream the response using server-sent
    * events.
    *
-   * See [streaming](https://docs.anthropic.com/en/api/streaming) for details.
+   * See [streaming](https://docs.claude.com/en/api/streaming) for details.
    */
   stream: true;
 }

package/src/resources/messages/messages.ts

@@ -757,14 +757,7 @@ export interface SignatureDelta {
   type: 'signature_delta';
 }
 
-export type StopReason =
-  | 'end_turn'
-  | 'max_tokens'
-  | 'stop_sequence'
-  | 'tool_use'
-  | 'pause_turn'
-  | 'refusal'
-  | 'model_context_window_exceeded';
+export type StopReason = 'end_turn' | 'max_tokens' | 'stop_sequence' | 'tool_use' | 'pause_turn' | 'refusal';
 
 export interface TextBlock {
   /**
@@ -843,7 +836,7 @@ export interface ThinkingConfigEnabled {
    * 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;
@@ -859,7 +852,7 @@ export interface ThinkingConfigEnabled {
  * 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 ThinkingConfigParam = ThinkingConfigEnabled | ThinkingConfigDisabled;
@@ -1320,7 +1313,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;
 
@@ -1382,12 +1375,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.
    */
@@ -1410,7 +1403,7 @@ export interface MessageCreateParamsBase {
    * 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';
 
@@ -1430,8 +1423,7 @@ export interface MessageCreateParamsBase {
   /**
    * 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;
 
@@ -1440,7 +1432,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<TextBlockParam>;
 
@@ -1464,7 +1456,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?: ThinkingConfigParam;
@@ -1485,9 +1477,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:
    *
@@ -1550,7 +1542,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<ToolUnion>;
 
@@ -1588,8 +1580,7 @@ export interface MessageCreateParamsNonStreaming extends MessageCreateParamsBase
   /**
    * 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;
 }
@@ -1598,8 +1589,7 @@ export interface MessageCreateParamsStreaming extends MessageCreateParamsBase {
   /**
    * 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;
 }
@@ -1665,12 +1655,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.
    */
@@ -1688,7 +1678,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<TextBlockParam>;
 
@@ -1700,7 +1690,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?: ThinkingConfigParam;
@@ -1721,9 +1711,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:
    *
@@ -1786,7 +1776,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<MessageCountTokensTool>;
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.66.0'; // x-release-please-version
+export const VERSION = '0.67.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.66.0";
+export declare const VERSION = "0.67.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.66.0";
+export declare const VERSION = "0.67.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.66.0'; // x-release-please-version
+exports.VERSION = '0.67.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.66.0'; // x-release-please-version
+export const VERSION = '0.67.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map