@ainative/cody-sdk 0.1.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/beta.ts

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

package/src/resources/completions.ts

@@ -0,0 +1,230 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import * as CompletionsAPI from './completions';
+import * as BetaAPI from './beta/beta';
+import * as MessagesAPI from './messages/messages';
+import { APIPromise } from '../core/api-promise';
+import { Stream } from '../core/streaming';
+import { buildHeaders } from '../internal/headers';
+import { RequestOptions } from '../internal/request-options';
+
+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.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>;
+  create(
+    params: CompletionCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<Completion> | APIPromise<Stream<Completion>> {
+    const { betas, ...body } = params;
+    return this._client.post('/v1/complete', {
+      body,
+      timeout: (this._client as any)._options.timeout ?? 600000,
+      ...options,
+      headers: buildHeaders([
+        { ...(betas?.toString() != null ? { 'anthropic-beta': betas?.toString() } : undefined) },
+        options?.headers,
+      ]),
+      stream: params.stream ?? false,
+    }) as APIPromise<Completion> | APIPromise<Stream<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 namespace CompletionCreateParams {
+  /**
+   * @deprecated use `Anthropic.Messages.Metadata` instead
+   */
+  export type Metadata = MessagesAPI.Metadata;
+
+  export type CompletionCreateParamsNonStreaming = CompletionsAPI.CompletionCreateParamsNonStreaming;
+  export 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,
+  };
+}