@ainative/cody-sdk 0.1.0

package/src/resources/beta/messages.ts

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

package/src/resources/beta/models.ts

@@ -0,0 +1,284 @@
+// 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 { Page, type PageParams, PagePromise } from '../../core/pagination';
+import { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Models extends APIResource {
+  /**
+   * Get a specific model.
+   *
+   * The Models API response can be used to determine information about a specific
+   * model or resolve a model alias to a model ID.
+   *
+   * @example
+   * ```ts
+   * const betaModelInfo = await client.beta.models.retrieve(
+   *   'model_id',
+   * );
+   * ```
+   */
+  retrieve(
+    modelID: string,
+    params: ModelRetrieveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<BetaModelInfo> {
+    const { betas } = params ?? {};
+    return this._client.get(path`/v1/models/${modelID}?beta=true`, {
+      ...options,
+      headers: buildHeaders([
+        { ...(betas?.toString() != null ? { 'anthropic-beta': betas?.toString() } : undefined) },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * List available models.
+   *
+   * The Models API response can be used to determine which models are available for
+   * use in the API. More recently released models are listed first.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const betaModelInfo of client.beta.models.list()) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    params: ModelListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<BetaModelInfosPage, BetaModelInfo> {
+    const { betas, ...query } = params ?? {};
+    return this._client.getAPIList('/v1/models?beta=true', Page<BetaModelInfo>, {
+      query,
+      ...options,
+      headers: buildHeaders([
+        { ...(betas?.toString() != null ? { 'anthropic-beta': betas?.toString() } : undefined) },
+        options?.headers,
+      ]),
+    });
+  }
+}
+
+export type BetaModelInfosPage = Page<BetaModelInfo>;
+
+/**
+ * Indicates whether a capability is supported.
+ */
+export interface BetaCapabilitySupport {
+  /**
+   * Whether this capability is supported by the model.
+   */
+  supported: boolean;
+}
+
+/**
+ * Context management capability details.
+ */
+export interface BetaContextManagementCapability {
+  /**
+   * Indicates whether a capability is supported.
+   */
+  clear_thinking_20251015: BetaCapabilitySupport | null;
+
+  /**
+   * Indicates whether a capability is supported.
+   */
+  clear_tool_uses_20250919: BetaCapabilitySupport | null;
+
+  /**
+   * Indicates whether a capability is supported.
+   */
+  compact_20260112: BetaCapabilitySupport | null;
+
+  /**
+   * Whether this capability is supported by the model.
+   */
+  supported: boolean;
+}
+
+/**
+ * Effort (reasoning_effort) capability details.
+ */
+export interface BetaEffortCapability {
+  /**
+   * Whether the model supports high effort level.
+   */
+  high: BetaCapabilitySupport;
+
+  /**
+   * Whether the model supports low effort level.
+   */
+  low: BetaCapabilitySupport;
+
+  /**
+   * Whether the model supports max effort level.
+   */
+  max: BetaCapabilitySupport;
+
+  /**
+   * Whether the model supports medium effort level.
+   */
+  medium: BetaCapabilitySupport;
+
+  /**
+   * Whether this capability is supported by the model.
+   */
+  supported: boolean;
+}
+
+/**
+ * Model capability information.
+ */
+export interface BetaModelCapabilities {
+  /**
+   * Whether the model supports the Batch API.
+   */
+  batch: BetaCapabilitySupport;
+
+  /**
+   * Whether the model supports citation generation.
+   */
+  citations: BetaCapabilitySupport;
+
+  /**
+   * Whether the model supports code execution tools.
+   */
+  code_execution: BetaCapabilitySupport;
+
+  /**
+   * Context management support and available strategies.
+   */
+  context_management: BetaContextManagementCapability;
+
+  /**
+   * Effort (reasoning_effort) support and available levels.
+   */
+  effort: BetaEffortCapability;
+
+  /**
+   * Whether the model accepts image content blocks.
+   */
+  image_input: BetaCapabilitySupport;
+
+  /**
+   * Whether the model accepts PDF content blocks.
+   */
+  pdf_input: BetaCapabilitySupport;
+
+  /**
+   * Whether the model supports structured output / JSON mode / strict tool schemas.
+   */
+  structured_outputs: BetaCapabilitySupport;
+
+  /**
+   * Thinking capability and supported type configurations.
+   */
+  thinking: BetaThinkingCapability;
+}
+
+export interface BetaModelInfo {
+  /**
+   * Unique model identifier.
+   */
+  id: string;
+
+  /**
+   * Model capability information.
+   */
+  capabilities: BetaModelCapabilities | null;
+
+  /**
+   * RFC 3339 datetime string representing the time at which the model was released.
+   * May be set to an epoch value if the release date is unknown.
+   */
+  created_at: string;
+
+  /**
+   * A human-readable name for the model.
+   */
+  display_name: string;
+
+  /**
+   * Maximum input context window size in tokens for this model.
+   */
+  max_input_tokens: number | null;
+
+  /**
+   * Maximum value for the `max_tokens` parameter when using this model.
+   */
+  max_tokens: number | null;
+
+  /**
+   * Object type.
+   *
+   * For Models, this is always `"model"`.
+   */
+  type: 'model';
+}
+
+/**
+ * Thinking capability details.
+ */
+export interface BetaThinkingCapability {
+  /**
+   * Whether this capability is supported by the model.
+   */
+  supported: boolean;
+
+  /**
+   * Supported thinking type configurations.
+   */
+  types: BetaThinkingTypes;
+}
+
+/**
+ * Supported thinking type configurations.
+ */
+export interface BetaThinkingTypes {
+  /**
+   * Whether the model supports thinking with type 'adaptive' (auto).
+   */
+  adaptive: BetaCapabilitySupport;
+
+  /**
+   * Whether the model supports thinking with type 'enabled'.
+   */
+  enabled: BetaCapabilitySupport;
+}
+
+export interface ModelRetrieveParams {
+  /**
+   * Optional header to specify the beta version(s) you want to use.
+   */
+  betas?: Array<BetaAPI.AnthropicBeta>;
+}
+
+export interface ModelListParams extends PageParams {
+  /**
+   * Header param: Optional header to specify the beta version(s) you want to use.
+   */
+  betas?: Array<BetaAPI.AnthropicBeta>;
+}
+
+export declare namespace Models {
+  export {
+    type BetaCapabilitySupport as BetaCapabilitySupport,
+    type BetaContextManagementCapability as BetaContextManagementCapability,
+    type BetaEffortCapability as BetaEffortCapability,
+    type BetaModelCapabilities as BetaModelCapabilities,
+    type BetaModelInfo as BetaModelInfo,
+    type BetaThinkingCapability as BetaThinkingCapability,
+    type BetaThinkingTypes as BetaThinkingTypes,
+    type BetaModelInfosPage as BetaModelInfosPage,
+    type ModelRetrieveParams as ModelRetrieveParams,
+    type ModelListParams as ModelListParams,
+  };
+}

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';

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

@@ -0,0 +1,384 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as BetaAPI from '../beta';
+import * as VersionsAPI from './versions';
+import {
+  VersionCreateParams,
+  VersionCreateResponse,
+  VersionDeleteParams,
+  VersionDeleteResponse,
+  VersionListParams,
+  VersionListResponse,
+  VersionListResponsesPageCursor,
+  VersionRetrieveParams,
+  VersionRetrieveResponse,
+  Versions,
+} from './versions';
+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 Skills extends APIResource {
+  versions: VersionsAPI.Versions = new VersionsAPI.Versions(this._client);
+
+  /**
+   * Create Skill
+   *
+   * @example
+   * ```ts
+   * const skill = await client.beta.skills.create();
+   * ```
+   */
+  create(
+    params: SkillCreateParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<SkillCreateResponse> {
+    const { betas, ...body } = params ?? {};
+    return this._client.post(
+      '/v1/skills?beta=true',
+      multipartFormRequestOptions(
+        {
+          body,
+          ...options,
+          headers: buildHeaders([
+            { 'anthropic-beta': [...(betas ?? []), 'skills-2025-10-02'].toString() },
+            options?.headers,
+          ]),
+        },
+        this._client,
+        false,
+      ),
+    );
+  }
+
+  /**
+   * Get Skill
+   *
+   * @example
+   * ```ts
+   * const skill = await client.beta.skills.retrieve('skill_id');
+   * ```
+   */
+  retrieve(
+    skillID: string,
+    params: SkillRetrieveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<SkillRetrieveResponse> {
+    const { betas } = params ?? {};
+    return this._client.get(path`/v1/skills/${skillID}?beta=true`, {
+      ...options,
+      headers: buildHeaders([
+        { 'anthropic-beta': [...(betas ?? []), 'skills-2025-10-02'].toString() },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * List Skills
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const skillListResponse of client.beta.skills.list()) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    params: SkillListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<SkillListResponsesPageCursor, SkillListResponse> {
+    const { betas, ...query } = params ?? {};
+    return this._client.getAPIList('/v1/skills?beta=true', PageCursor<SkillListResponse>, {
+      query,
+      ...options,
+      headers: buildHeaders([
+        { 'anthropic-beta': [...(betas ?? []), 'skills-2025-10-02'].toString() },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Delete Skill
+   *
+   * @example
+   * ```ts
+   * const skill = await client.beta.skills.delete('skill_id');
+   * ```
+   */
+  delete(
+    skillID: string,
+    params: SkillDeleteParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<SkillDeleteResponse> {
+    const { betas } = params ?? {};
+    return this._client.delete(path`/v1/skills/${skillID}?beta=true`, {
+      ...options,
+      headers: buildHeaders([
+        { 'anthropic-beta': [...(betas ?? []), 'skills-2025-10-02'].toString() },
+        options?.headers,
+      ]),
+    });
+  }
+}
+
+export type SkillListResponsesPageCursor = PageCursor<SkillListResponse>;
+
+export interface SkillCreateResponse {
+  /**
+   * Unique identifier for the skill.
+   *
+   * The format and length of IDs may change over time.
+   */
+  id: string;
+
+  /**
+   * ISO 8601 timestamp of when the skill was created.
+   */
+  created_at: string;
+
+  /**
+   * Display title for the skill.
+   *
+   * This is a human-readable label that is not included in the prompt sent to the
+   * model.
+   */
+  display_title: string | null;
+
+  /**
+   * The latest version identifier for the skill.
+   *
+   * This represents the most recent version of the skill that has been created.
+   */
+  latest_version: string | null;
+
+  /**
+   * Source of the skill.
+   *
+   * This may be one of the following values:
+   *
+   * - `"custom"`: the skill was created by a user
+   * - `"anthropic"`: the skill was created by Anthropic
+   */
+  source: string;
+
+  /**
+   * Object type.
+   *
+   * For Skills, this is always `"skill"`.
+   */
+  type: string;
+
+  /**
+   * ISO 8601 timestamp of when the skill was last updated.
+   */
+  updated_at: string;
+}
+
+export interface SkillRetrieveResponse {
+  /**
+   * Unique identifier for the skill.
+   *
+   * The format and length of IDs may change over time.
+   */
+  id: string;
+
+  /**
+   * ISO 8601 timestamp of when the skill was created.
+   */
+  created_at: string;
+
+  /**
+   * Display title for the skill.
+   *
+   * This is a human-readable label that is not included in the prompt sent to the
+   * model.
+   */
+  display_title: string | null;
+
+  /**
+   * The latest version identifier for the skill.
+   *
+   * This represents the most recent version of the skill that has been created.
+   */
+  latest_version: string | null;
+
+  /**
+   * Source of the skill.
+   *
+   * This may be one of the following values:
+   *
+   * - `"custom"`: the skill was created by a user
+   * - `"anthropic"`: the skill was created by Anthropic
+   */
+  source: string;
+
+  /**
+   * Object type.
+   *
+   * For Skills, this is always `"skill"`.
+   */
+  type: string;
+
+  /**
+   * ISO 8601 timestamp of when the skill was last updated.
+   */
+  updated_at: string;
+}
+
+export interface SkillListResponse {
+  /**
+   * Unique identifier for the skill.
+   *
+   * The format and length of IDs may change over time.
+   */
+  id: string;
+
+  /**
+   * ISO 8601 timestamp of when the skill was created.
+   */
+  created_at: string;
+
+  /**
+   * Display title for the skill.
+   *
+   * This is a human-readable label that is not included in the prompt sent to the
+   * model.
+   */
+  display_title: string | null;
+
+  /**
+   * The latest version identifier for the skill.
+   *
+   * This represents the most recent version of the skill that has been created.
+   */
+  latest_version: string | null;
+
+  /**
+   * Source of the skill.
+   *
+   * This may be one of the following values:
+   *
+   * - `"custom"`: the skill was created by a user
+   * - `"anthropic"`: the skill was created by Anthropic
+   */
+  source: string;
+
+  /**
+   * Object type.
+   *
+   * For Skills, this is always `"skill"`.
+   */
+  type: string;
+
+  /**
+   * ISO 8601 timestamp of when the skill was last updated.
+   */
+  updated_at: string;
+}
+
+export interface SkillDeleteResponse {
+  /**
+   * Unique identifier for the skill.
+   *
+   * The format and length of IDs may change over time.
+   */
+  id: string;
+
+  /**
+   * Deleted object type.
+   *
+   * For Skills, this is always `"skill_deleted"`.
+   */
+  type: string;
+}
+
+export interface SkillCreateParams {
+  /**
+   * Body param: Display title for the skill.
+   *
+   * This is a human-readable label that is not included in the prompt sent to the
+   * model.
+   */
+  display_title?: string | null;
+
+  /**
+   * 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 SkillRetrieveParams {
+  /**
+   * Optional header to specify the beta version(s) you want to use.
+   */
+  betas?: Array<BetaAPI.AnthropicBeta>;
+}
+
+export interface SkillListParams extends PageCursorParams {
+  /**
+   * Query param: Filter skills by source.
+   *
+   * If provided, only skills from the specified source will be returned:
+   *
+   * - `"custom"`: only return user-created skills
+   * - `"anthropic"`: only return Anthropic-created skills
+   */
+  source?: string | null;
+
+  /**
+   * Header param: Optional header to specify the beta version(s) you want to use.
+   */
+  betas?: Array<BetaAPI.AnthropicBeta>;
+}
+
+export interface SkillDeleteParams {
+  /**
+   * Optional header to specify the beta version(s) you want to use.
+   */
+  betas?: Array<BetaAPI.AnthropicBeta>;
+}
+
+Skills.Versions = Versions;
+
+export declare namespace Skills {
+  export {
+    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,
+  };
+
+  export {
+    Versions as Versions,
+    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,
+  };
+}