@ainative/cody-sdk 0.1.0

package/resources/beta/skills/versions.js

@@ -0,0 +1,100 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Versions = void 0;
+const resource_1 = require("../../../core/resource.js");
+const pagination_1 = require("../../../core/pagination.js");
+const headers_1 = require("../../../internal/headers.js");
+const uploads_1 = require("../../../internal/uploads.js");
+const path_1 = require("../../../internal/utils/path.js");
+class Versions extends resource_1.APIResource {
+    /**
+     * Create Skill Version
+     *
+     * @example
+     * ```ts
+     * const version = await client.beta.skills.versions.create(
+     *   'skill_id',
+     * );
+     * ```
+     */
+    create(skillID, params = {}, options) {
+        const { betas, ...body } = params ?? {};
+        return this._client.post((0, path_1.path) `/v1/skills/${skillID}/versions?beta=true`, (0, uploads_1.multipartFormRequestOptions)({
+            body,
+            ...options,
+            headers: (0, headers_1.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, params, options) {
+        const { skill_id, betas } = params;
+        return this._client.get((0, path_1.path) `/v1/skills/${skill_id}/versions/${version}?beta=true`, {
+            ...options,
+            headers: (0, headers_1.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, params = {}, options) {
+        const { betas, ...query } = params ?? {};
+        return this._client.getAPIList((0, path_1.path) `/v1/skills/${skillID}/versions?beta=true`, (pagination_1.PageCursor), {
+            query,
+            ...options,
+            headers: (0, headers_1.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, params, options) {
+        const { skill_id, betas } = params;
+        return this._client.delete((0, path_1.path) `/v1/skills/${skill_id}/versions/${version}?beta=true`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'anthropic-beta': [...(betas ?? []), 'skills-2025-10-02'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+}
+exports.Versions = Versions;
+//# sourceMappingURL=versions.js.map

package/resources/beta/skills/versions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.js","sourceRoot":"","sources":["../../../src/resources/beta/skills/versions.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAqD;AAGrD,4DAA0F;AAE1F,0DAAyD;AAEzD,0DAAwE;AACxE,0DAAoD;AAEpD,MAAa,QAAS,SAAQ,sBAAW;IACvC;;;;;;;;;OASG;IACH,MAAM,CACJ,OAAe,EACf,SAAiD,EAAE,EACnD,OAAwB;QAExB,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACxC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CACtB,IAAA,WAAI,EAAA,cAAc,OAAO,qBAAqB,EAC9C,IAAA,qCAA2B,EACzB;YACE,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC;gBACpB,EAAE,gBAAgB,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,mBAAmB,CAAC,CAAC,QAAQ,EAAE,EAAE;gBACxE,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,EACD,IAAI,CAAC,OAAO,CACb,CACF,CAAC;IACJ,CAAC;IAED;;;;;;;;;;OAUG;IACH,QAAQ,CACN,OAAe,EACf,MAA6B,EAC7B,OAAwB;QAExB,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;QACnC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,cAAc,QAAQ,aAAa,OAAO,YAAY,EAAE;YAClF,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC;gBACpB,EAAE,gBAAgB,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,mBAAmB,CAAC,CAAC,QAAQ,EAAE,EAAE;gBACxE,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,IAAI,CACF,OAAe,EACf,SAA+C,EAAE,EACjD,OAAwB;QAExB,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAC5B,IAAA,WAAI,EAAA,cAAc,OAAO,qBAAqB,EAC9C,CAAA,uBAA+B,CAAA,EAC/B;YACE,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC;gBACpB,EAAE,gBAAgB,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,mBAAmB,CAAC,CAAC,QAAQ,EAAE,EAAE;gBACxE,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CACF,CAAC;IACJ,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CACJ,OAAe,EACf,MAA2B,EAC3B,OAAwB;QAExB,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;QACnC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,cAAc,QAAQ,aAAa,OAAO,YAAY,EAAE;YACrF,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC;gBACpB,EAAE,gBAAgB,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,mBAAmB,CAAC,CAAC,QAAQ,EAAE,EAAE;gBACxE,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;CACF;AArHD,4BAqHC"}

package/resources/beta/skills/versions.mjs

@@ -0,0 +1,96 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../../core/resource.mjs";
+import { PageCursor } from "../../../core/pagination.mjs";
+import { buildHeaders } from "../../../internal/headers.mjs";
+import { multipartFormRequestOptions } from "../../../internal/uploads.mjs";
+import { path } from "../../../internal/utils/path.mjs";
+export class Versions extends APIResource {
+    /**
+     * Create Skill Version
+     *
+     * @example
+     * ```ts
+     * const version = await client.beta.skills.versions.create(
+     *   'skill_id',
+     * );
+     * ```
+     */
+    create(skillID, params = {}, options) {
+        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, params, options) {
+        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, params = {}, options) {
+        const { betas, ...query } = params ?? {};
+        return this._client.getAPIList(path `/v1/skills/${skillID}/versions?beta=true`, (PageCursor), {
+            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, params, options) {
+        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,
+            ]),
+        });
+    }
+}
+//# sourceMappingURL=versions.mjs.map

package/resources/beta/skills/versions.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.mjs","sourceRoot":"","sources":["../../../src/resources/beta/skills/versions.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAGf,EAAE,UAAU,EAAsC;OAElD,EAAE,YAAY,EAAE;OAEhB,EAAE,2BAA2B,EAAE;OAC/B,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;OASG;IACH,MAAM,CACJ,OAAe,EACf,SAAiD,EAAE,EACnD,OAAwB;QAExB,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACxC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CACtB,IAAI,CAAA,cAAc,OAAO,qBAAqB,EAC9C,2BAA2B,CACzB;YACE,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,gBAAgB,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,mBAAmB,CAAC,CAAC,QAAQ,EAAE,EAAE;gBACxE,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,EACD,IAAI,CAAC,OAAO,CACb,CACF,CAAC;IACJ,CAAC;IAED;;;;;;;;;;OAUG;IACH,QAAQ,CACN,OAAe,EACf,MAA6B,EAC7B,OAAwB;QAExB,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;QACnC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,cAAc,QAAQ,aAAa,OAAO,YAAY,EAAE;YAClF,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,gBAAgB,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,mBAAmB,CAAC,CAAC,QAAQ,EAAE,EAAE;gBACxE,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,IAAI,CACF,OAAe,EACf,SAA+C,EAAE,EACjD,OAAwB;QAExB,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAC5B,IAAI,CAAA,cAAc,OAAO,qBAAqB,EAC9C,CAAA,UAA+B,CAAA,EAC/B;YACE,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,gBAAgB,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,mBAAmB,CAAC,CAAC,QAAQ,EAAE,EAAE;gBACxE,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CACF,CAAC;IACJ,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CACJ,OAAe,EACf,MAA2B,EAC3B,OAAwB;QAExB,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;QACnC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,cAAc,QAAQ,aAAa,OAAO,YAAY,EAAE;YACrF,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,gBAAgB,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,mBAAmB,CAAC,CAAC,QAAQ,EAAE,EAAE;gBACxE,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;CACF"}

package/resources/beta/skills.d.mts

@@ -0,0 +1,2 @@
+export * from "./skills/index.mjs";
+//# sourceMappingURL=skills.d.mts.map

package/resources/beta/skills.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.mts","sourceRoot":"","sources":["../../src/resources/beta/skills.ts"],"names":[],"mappings":""}

package/resources/beta/skills.d.ts

@@ -0,0 +1,2 @@
+export * from "./skills/index.js";
+//# sourceMappingURL=skills.d.ts.map

package/resources/beta/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/resources/beta/skills.ts"],"names":[],"mappings":""}

package/resources/beta/skills.js

@@ -0,0 +1,6 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("../../internal/tslib.js");
+tslib_1.__exportStar(require("./skills/index.js"), exports);
+//# sourceMappingURL=skills.js.map

package/resources/beta/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/resources/beta/skills.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,4DAA+B"}

package/resources/beta/skills.mjs

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export * from "./skills/index.mjs";
+//# sourceMappingURL=skills.mjs.map

package/resources/beta/skills.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.mjs","sourceRoot":"","sources":["../../src/resources/beta/skills.ts"],"names":[],"mappings":"AAAA,sFAAsF"}

package/resources/beta.d.mts

@@ -0,0 +1,2 @@
+export * from "./beta/index.mjs";
+//# sourceMappingURL=beta.d.mts.map

package/resources/beta.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"beta.d.mts","sourceRoot":"","sources":["../src/resources/beta.ts"],"names":[],"mappings":""}

package/resources/beta.d.ts

@@ -0,0 +1,2 @@
+export * from "./beta/index.js";
+//# sourceMappingURL=beta.d.ts.map

package/resources/beta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"beta.d.ts","sourceRoot":"","sources":["../src/resources/beta.ts"],"names":[],"mappings":""}

package/resources/beta.js

@@ -0,0 +1,6 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("../internal/tslib.js");
+tslib_1.__exportStar(require("./beta/index.js"), exports);
+//# sourceMappingURL=beta.js.map

package/resources/beta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"beta.js","sourceRoot":"","sources":["../src/resources/beta.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,0DAA6B"}

package/resources/beta.mjs

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export * from "./beta/index.mjs";
+//# sourceMappingURL=beta.mjs.map

package/resources/beta.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"beta.mjs","sourceRoot":"","sources":["../src/resources/beta.ts"],"names":[],"mappings":"AAAA,sFAAsF"}

package/resources/completions.d.mts

@@ -0,0 +1,182 @@
+import { APIResource } from "../core/resource.mjs";
+import * as CompletionsAPI from "./completions.mjs";
+import * as BetaAPI from "./beta/beta.mjs";
+import * as MessagesAPI from "./messages/messages.mjs";
+import { APIPromise } from "../core/api-promise.mjs";
+import { Stream } from "../core/streaming.mjs";
+import { RequestOptions } from "../internal/request-options.mjs";
+export declare 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.claude.com/en/api/messages) going forward.
+     *
+     * Future models and features will not be compatible with Text Completions. See our
+     * [migration guide](https://docs.claude.com/en/api/migrating-from-text-completions-to-messages)
+     * for guidance in migrating from Text Completions to Messages.
+     *
+     * @example
+     * ```ts
+     * const completion = await client.completions.create({
+     *   max_tokens_to_sample: 256,
+     *   model: 'claude-opus-4-6',
+     *   prompt: '\n\nHuman: Hello, world!\n\nAssistant:',
+     * });
+     * ```
+     */
+    create(params: CompletionCreateParamsNonStreaming, options?: RequestOptions): APIPromise<Completion>;
+    create(params: CompletionCreateParamsStreaming, options?: RequestOptions): APIPromise<Stream<Completion>>;
+    create(params: CompletionCreateParamsBase, options?: RequestOptions): APIPromise<Stream<Completion> | Completion>;
+}
+export interface Completion {
+    /**
+     * Unique object identifier.
+     *
+     * The format and length of IDs may change over time.
+     */
+    id: string;
+    /**
+     * The resulting completion up to and excluding the stop sequences.
+     */
+    completion: string;
+    /**
+     * The model that will complete your prompt.\n\nSee
+     * [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+     * details and options.
+     */
+    model: MessagesAPI.Model;
+    /**
+     * The reason that we stopped.
+     *
+     * This may be one the following values:
+     *
+     * - `"stop_sequence"`: we reached a stop sequence — either provided by you via the
+     *   `stop_sequences` parameter, or a stop sequence built into the model
+     * - `"max_tokens"`: we exceeded `max_tokens_to_sample` or the model's maximum
+     */
+    stop_reason: string | null;
+    /**
+     * Object type.
+     *
+     * For Text Completions, this is always `"completion"`.
+     */
+    type: 'completion';
+}
+export type CompletionCreateParams = CompletionCreateParamsNonStreaming | CompletionCreateParamsStreaming;
+export interface CompletionCreateParamsBase {
+    /**
+     * Body param: The maximum number of tokens to generate before stopping.
+     *
+     * Note that our models may stop _before_ reaching this maximum. This parameter
+     * only specifies the absolute maximum number of tokens to generate.
+     */
+    max_tokens_to_sample: number;
+    /**
+     * Body param: The model that will complete your prompt.\n\nSee
+     * [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+     * details and options.
+     */
+    model: MessagesAPI.Model;
+    /**
+     * Body param: The prompt that you want Claude to complete.
+     *
+     * For proper response generation you will need to format your prompt using
+     * alternating `\n\nHuman:` and `\n\nAssistant:` conversational turns. For example:
+     *
+     * ```
+     * "\n\nHuman: {userQuestion}\n\nAssistant:"
+     * ```
+     *
+     * 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;
+    /**
+     * Body param: An object describing metadata about the request.
+     */
+    metadata?: MessagesAPI.Metadata;
+    /**
+     * Body param: Sequences that will cause the model to stop generating.
+     *
+     * Our models stop on `"\n\nHuman:"`, and may include additional built-in stop
+     * sequences in the future. By providing the stop_sequences parameter, you may
+     * include additional strings that will cause the model to stop generating.
+     */
+    stop_sequences?: Array<string>;
+    /**
+     * Body param: Whether to incrementally stream the response using server-sent
+     * events.
+     *
+     * See [streaming](https://docs.claude.com/en/api/streaming) for details.
+     */
+    stream?: boolean;
+    /**
+     * Body param: Amount of randomness injected into the response.
+     *
+     * Defaults to `1.0`. Ranges from `0.0` to `1.0`. Use `temperature` closer to `0.0`
+     * for analytical / multiple choice, and closer to `1.0` for creative and
+     * generative tasks.
+     *
+     * Note that even with `temperature` of `0.0`, the results will not be fully
+     * deterministic.
+     */
+    temperature?: number;
+    /**
+     * Body param: Only sample from the top K options for each subsequent token.
+     *
+     * Used to remove "long tail" low probability responses.
+     * [Learn more technical details here](https://towardsdatascience.com/how-to-sample-from-language-models-682bceb97277).
+     *
+     * Recommended for advanced use cases only. You usually only need to use
+     * `temperature`.
+     */
+    top_k?: number;
+    /**
+     * Body param: Use nucleus sampling.
+     *
+     * In nucleus sampling, we compute the cumulative distribution over all the options
+     * for each subsequent token in decreasing probability order and cut it off once it
+     * reaches a particular probability specified by `top_p`. You should either alter
+     * `temperature` or `top_p`, but not both.
+     *
+     * Recommended for advanced use cases only. You usually only need to use
+     * `temperature`.
+     */
+    top_p?: number;
+    /**
+     * Header param: Optional header to specify the beta version(s) you want to use.
+     */
+    betas?: Array<BetaAPI.AnthropicBeta>;
+}
+export declare namespace CompletionCreateParams {
+    /**
+     * @deprecated use `Anthropic.Messages.Metadata` instead
+     */
+    type Metadata = MessagesAPI.Metadata;
+    type CompletionCreateParamsNonStreaming = CompletionsAPI.CompletionCreateParamsNonStreaming;
+    type CompletionCreateParamsStreaming = CompletionsAPI.CompletionCreateParamsStreaming;
+}
+export interface CompletionCreateParamsNonStreaming extends CompletionCreateParamsBase {
+    /**
+     * Body param: Whether to incrementally stream the response using server-sent
+     * events.
+     *
+     * See [streaming](https://docs.claude.com/en/api/streaming) for details.
+     */
+    stream?: false;
+}
+export interface CompletionCreateParamsStreaming extends CompletionCreateParamsBase {
+    /**
+     * Body param: Whether to incrementally stream the response using server-sent
+     * events.
+     *
+     * See [streaming](https://docs.claude.com/en/api/streaming) for details.
+     */
+    stream: true;
+}
+export declare namespace Completions {
+    export { type Completion as Completion, type CompletionCreateParams as CompletionCreateParams, type CompletionCreateParamsNonStreaming as CompletionCreateParamsNonStreaming, type CompletionCreateParamsStreaming as CompletionCreateParamsStreaming, };
+}
+//# sourceMappingURL=completions.d.mts.map

package/resources/completions.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completions.d.mts","sourceRoot":"","sources":["../src/resources/completions.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,cAAc;OACnB,KAAK,OAAO;OACZ,KAAK,WAAW;OAChB,EAAE,UAAU,EAAE;OACd,EAAE,MAAM,EAAE;OAEV,EAAE,cAAc,EAAE;AAEzB,qBAAa,WAAY,SAAQ,WAAW;IAC1C;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,MAAM,EAAE,kCAAkC,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,UAAU,CAAC;IACpG,MAAM,CAAC,MAAM,EAAE,+BAA+B,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACzG,MAAM,CACJ,MAAM,EAAE,0BAA0B,EAClC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC;CAiB/C;AAED,MAAM,WAAW,UAAU;IACzB;;;;OAIG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC;IAEzB;;;;;;;;OAQG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B;;;;OAIG;IACH,IAAI,EAAE,YAAY,CAAC;CACpB;AAED,MAAM,MAAM,sBAAsB,GAAG,kCAAkC,GAAG,+BAA+B,CAAC;AAE1G,MAAM,WAAW,0BAA0B;IACzC;;;;;OAKG;IACH,oBAAoB,EAAE,MAAM,CAAC;IAE7B;;;;OAIG;IACH,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC;IAEzB;;;;;;;;;;;;;OAaG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC;IAEhC;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE/B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;;;;;;;OASG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;;;;;;OAUG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;CACtC;AAED,yBAAiB,sBAAsB,CAAC;IACtC;;OAEG;IACH,KAAY,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC;IAE5C,KAAY,kCAAkC,GAAG,cAAc,CAAC,kCAAkC,CAAC;IACnG,KAAY,+BAA+B,GAAG,cAAc,CAAC,+BAA+B,CAAC;CAC9F;AAED,MAAM,WAAW,kCAAmC,SAAQ,0BAA0B;IACpF;;;;;OAKG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC;CAChB;AAED,MAAM,WAAW,+BAAgC,SAAQ,0BAA0B;IACjF;;;;;OAKG;IACH,MAAM,EAAE,IAAI,CAAC;CACd;AAED,MAAM,CAAC,OAAO,WAAW,WAAW,CAAC;IACnC,OAAO,EACL,KAAK,UAAU,IAAI,UAAU,EAC7B,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,kCAAkC,IAAI,kCAAkC,EAC7E,KAAK,+BAA+B,IAAI,+BAA+B,GACxE,CAAC;CACH"}

package/resources/completions.d.ts

@@ -0,0 +1,182 @@
+import { APIResource } from "../core/resource.js";
+import * as CompletionsAPI from "./completions.js";
+import * as BetaAPI from "./beta/beta.js";
+import * as MessagesAPI from "./messages/messages.js";
+import { APIPromise } from "../core/api-promise.js";
+import { Stream } from "../core/streaming.js";
+import { RequestOptions } from "../internal/request-options.js";
+export declare 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.claude.com/en/api/messages) going forward.
+     *
+     * Future models and features will not be compatible with Text Completions. See our
+     * [migration guide](https://docs.claude.com/en/api/migrating-from-text-completions-to-messages)
+     * for guidance in migrating from Text Completions to Messages.
+     *
+     * @example
+     * ```ts
+     * const completion = await client.completions.create({
+     *   max_tokens_to_sample: 256,
+     *   model: 'claude-opus-4-6',
+     *   prompt: '\n\nHuman: Hello, world!\n\nAssistant:',
+     * });
+     * ```
+     */
+    create(params: CompletionCreateParamsNonStreaming, options?: RequestOptions): APIPromise<Completion>;
+    create(params: CompletionCreateParamsStreaming, options?: RequestOptions): APIPromise<Stream<Completion>>;
+    create(params: CompletionCreateParamsBase, options?: RequestOptions): APIPromise<Stream<Completion> | Completion>;
+}
+export interface Completion {
+    /**
+     * Unique object identifier.
+     *
+     * The format and length of IDs may change over time.
+     */
+    id: string;
+    /**
+     * The resulting completion up to and excluding the stop sequences.
+     */
+    completion: string;
+    /**
+     * The model that will complete your prompt.\n\nSee
+     * [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+     * details and options.
+     */
+    model: MessagesAPI.Model;
+    /**
+     * The reason that we stopped.
+     *
+     * This may be one the following values:
+     *
+     * - `"stop_sequence"`: we reached a stop sequence — either provided by you via the
+     *   `stop_sequences` parameter, or a stop sequence built into the model
+     * - `"max_tokens"`: we exceeded `max_tokens_to_sample` or the model's maximum
+     */
+    stop_reason: string | null;
+    /**
+     * Object type.
+     *
+     * For Text Completions, this is always `"completion"`.
+     */
+    type: 'completion';
+}
+export type CompletionCreateParams = CompletionCreateParamsNonStreaming | CompletionCreateParamsStreaming;
+export interface CompletionCreateParamsBase {
+    /**
+     * Body param: The maximum number of tokens to generate before stopping.
+     *
+     * Note that our models may stop _before_ reaching this maximum. This parameter
+     * only specifies the absolute maximum number of tokens to generate.
+     */
+    max_tokens_to_sample: number;
+    /**
+     * Body param: The model that will complete your prompt.\n\nSee
+     * [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+     * details and options.
+     */
+    model: MessagesAPI.Model;
+    /**
+     * Body param: The prompt that you want Claude to complete.
+     *
+     * For proper response generation you will need to format your prompt using
+     * alternating `\n\nHuman:` and `\n\nAssistant:` conversational turns. For example:
+     *
+     * ```
+     * "\n\nHuman: {userQuestion}\n\nAssistant:"
+     * ```
+     *
+     * 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;
+    /**
+     * Body param: An object describing metadata about the request.
+     */
+    metadata?: MessagesAPI.Metadata;
+    /**
+     * Body param: Sequences that will cause the model to stop generating.
+     *
+     * Our models stop on `"\n\nHuman:"`, and may include additional built-in stop
+     * sequences in the future. By providing the stop_sequences parameter, you may
+     * include additional strings that will cause the model to stop generating.
+     */
+    stop_sequences?: Array<string>;
+    /**
+     * Body param: Whether to incrementally stream the response using server-sent
+     * events.
+     *
+     * See [streaming](https://docs.claude.com/en/api/streaming) for details.
+     */
+    stream?: boolean;
+    /**
+     * Body param: Amount of randomness injected into the response.
+     *
+     * Defaults to `1.0`. Ranges from `0.0` to `1.0`. Use `temperature` closer to `0.0`
+     * for analytical / multiple choice, and closer to `1.0` for creative and
+     * generative tasks.
+     *
+     * Note that even with `temperature` of `0.0`, the results will not be fully
+     * deterministic.
+     */
+    temperature?: number;
+    /**
+     * Body param: Only sample from the top K options for each subsequent token.
+     *
+     * Used to remove "long tail" low probability responses.
+     * [Learn more technical details here](https://towardsdatascience.com/how-to-sample-from-language-models-682bceb97277).
+     *
+     * Recommended for advanced use cases only. You usually only need to use
+     * `temperature`.
+     */
+    top_k?: number;
+    /**
+     * Body param: Use nucleus sampling.
+     *
+     * In nucleus sampling, we compute the cumulative distribution over all the options
+     * for each subsequent token in decreasing probability order and cut it off once it
+     * reaches a particular probability specified by `top_p`. You should either alter
+     * `temperature` or `top_p`, but not both.
+     *
+     * Recommended for advanced use cases only. You usually only need to use
+     * `temperature`.
+     */
+    top_p?: number;
+    /**
+     * Header param: Optional header to specify the beta version(s) you want to use.
+     */
+    betas?: Array<BetaAPI.AnthropicBeta>;
+}
+export declare namespace CompletionCreateParams {
+    /**
+     * @deprecated use `Anthropic.Messages.Metadata` instead
+     */
+    type Metadata = MessagesAPI.Metadata;
+    type CompletionCreateParamsNonStreaming = CompletionsAPI.CompletionCreateParamsNonStreaming;
+    type CompletionCreateParamsStreaming = CompletionsAPI.CompletionCreateParamsStreaming;
+}
+export interface CompletionCreateParamsNonStreaming extends CompletionCreateParamsBase {
+    /**
+     * Body param: Whether to incrementally stream the response using server-sent
+     * events.
+     *
+     * See [streaming](https://docs.claude.com/en/api/streaming) for details.
+     */
+    stream?: false;
+}
+export interface CompletionCreateParamsStreaming extends CompletionCreateParamsBase {
+    /**
+     * Body param: Whether to incrementally stream the response using server-sent
+     * events.
+     *
+     * See [streaming](https://docs.claude.com/en/api/streaming) for details.
+     */
+    stream: true;
+}
+export declare namespace Completions {
+    export { type Completion as Completion, type CompletionCreateParams as CompletionCreateParams, type CompletionCreateParamsNonStreaming as CompletionCreateParamsNonStreaming, type CompletionCreateParamsStreaming as CompletionCreateParamsStreaming, };
+}
+//# sourceMappingURL=completions.d.ts.map

package/resources/completions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completions.d.ts","sourceRoot":"","sources":["../src/resources/completions.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,cAAc;OACnB,KAAK,OAAO;OACZ,KAAK,WAAW;OAChB,EAAE,UAAU,EAAE;OACd,EAAE,MAAM,EAAE;OAEV,EAAE,cAAc,EAAE;AAEzB,qBAAa,WAAY,SAAQ,WAAW;IAC1C;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,MAAM,EAAE,kCAAkC,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,UAAU,CAAC;IACpG,MAAM,CAAC,MAAM,EAAE,+BAA+B,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACzG,MAAM,CACJ,MAAM,EAAE,0BAA0B,EAClC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC;CAiB/C;AAED,MAAM,WAAW,UAAU;IACzB;;;;OAIG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC;IAEzB;;;;;;;;OAQG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B;;;;OAIG;IACH,IAAI,EAAE,YAAY,CAAC;CACpB;AAED,MAAM,MAAM,sBAAsB,GAAG,kCAAkC,GAAG,+BAA+B,CAAC;AAE1G,MAAM,WAAW,0BAA0B;IACzC;;;;;OAKG;IACH,oBAAoB,EAAE,MAAM,CAAC;IAE7B;;;;OAIG;IACH,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC;IAEzB;;;;;;;;;;;;;OAaG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC;IAEhC;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE/B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;;;;;;;OASG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;;;;;;OAUG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;CACtC;AAED,yBAAiB,sBAAsB,CAAC;IACtC;;OAEG;IACH,KAAY,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC;IAE5C,KAAY,kCAAkC,GAAG,cAAc,CAAC,kCAAkC,CAAC;IACnG,KAAY,+BAA+B,GAAG,cAAc,CAAC,+BAA+B,CAAC;CAC9F;AAED,MAAM,WAAW,kCAAmC,SAAQ,0BAA0B;IACpF;;;;;OAKG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC;CAChB;AAED,MAAM,WAAW,+BAAgC,SAAQ,0BAA0B;IACjF;;;;;OAKG;IACH,MAAM,EAAE,IAAI,CAAC;CACd;AAED,MAAM,CAAC,OAAO,WAAW,WAAW,CAAC;IACnC,OAAO,EACL,KAAK,UAAU,IAAI,UAAU,EAC7B,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,kCAAkC,IAAI,kCAAkC,EAC7E,KAAK,+BAA+B,IAAI,+BAA+B,GACxE,CAAC;CACH"}