@cadenya/cadenya 0.134.0 → 1.0.0

package/src/resources/models.ts

@@ -1,236 +1,80 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+// Generated by redwood. Do not edit by hand.
 
-import { APIResource } from '../core/resource';
-import * as AIProviderKeysAPI from './ai-provider-keys';
-import * as Shared from './shared';
-import { APIPromise } from '../core/api-promise';
-import { CursorPagination, type CursorPaginationParams, PagePromise } from '../core/pagination';
-import { RequestOptions } from '../internal/request-options';
-import { path } from '../internal/utils/path';
+import { HttpClient, RequestOptions, APIPromise, pathSegment, snapshotParams } from '../core/http.js';
+import { Page } from '../core/pagination.js';
+import type { ListModelsResponse, Model, ModelServiceListModelsState, SwapModelOnVariationsRequest_ModelSwap } from '../types.js';
 
-/**
- * Manage LLM models available to a workspace. Models represent provider and
- *  family pairs (e.g., "anthropic/claude-sonnet-4.6"). Workspaces are seeded
- *  with the supported models and you can enable or disable each one.
- */
-export class Models extends APIResource {
+export interface ModelListParams {
   /**
-   * Retrieves a model by ID from the workspace
-   */
-  retrieve(
-    id: string,
-    params: ModelRetrieveParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<Model> {
-    const { workspaceId = this._client.workspaceID } = params ?? {};
-    return this._client.get(path`/v1/workspaces/${workspaceId}/models/${id}`, options);
-  }
-
-  /**
-   * Lists all models in the workspace
-   */
-  list(
-    params: ModelListParams | null | undefined = {},
-    options?: RequestOptions,
-  ): PagePromise<ModelsCursorPagination, Model> {
-    const { workspaceId = this._client.workspaceID, ...query } = params ?? {};
-    return this._client.getAPIList(path`/v1/workspaces/${workspaceId}/models`, CursorPagination<Model>, {
-      query,
-      ...options,
-    });
-  }
-
-  /**
-   * Transitions a model to STATE_DISABLED. Fails while agent variations are still
-   * provisioned on the model; use :swapModelOnVariations to move them first.
-   */
-  disable(id: string, params: ModelDisableParams, options?: RequestOptions): APIPromise<Model> {
-    const { workspaceId = this._client.workspaceID, ...body } = params;
-    return this._client.post(path`/v1/workspaces/${workspaceId}/models/${id}:disable`, { body, ...options });
-  }
-
-  /**
-   * Transitions a model to STATE_ENABLED, making it available for agent variations
-   * in the workspace
-   */
-  enable(id: string, params: ModelEnableParams, options?: RequestOptions): APIPromise<Model> {
-    const { workspaceId = this._client.workspaceID, ...body } = params;
-    return this._client.post(path`/v1/workspaces/${workspaceId}/models/${id}:enable`, { body, ...options });
-  }
-
-  /**
-   * Reassigns agent variations from one model to another in bulk. Runs
-   * asynchronously and returns immediately.
-   */
-  swap(params: ModelSwapParams | null | undefined = {}, options?: RequestOptions): APIPromise<unknown> {
-    const { workspaceId = this._client.workspaceID, ...body } = params ?? {};
-    return this._client.post(path`/v1/workspaces/${workspaceId}/models:swapModelOnVariations`, {
-      body,
-      ...options,
-    });
-  }
-}
-
-export type ModelsCursorPagination = CursorPagination<Model>;
-
-export interface Model {
-  /**
-   * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
-   */
-  metadata: Shared.ResourceMetadata;
-
-  /**
-   * Model specification
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
    */
-  spec: ModelSpec;
-
+  workspaceId?: string;
   /**
-   * Whether the model is usable in this workspace. Output only. Use the :enable and
-   * :disable actions to transition.
+   * Maximum number of results to return
    */
-  state: 'STATE_UNSPECIFIED' | 'STATE_ENABLED' | 'STATE_DISABLED';
-
+  limit?: number;
   /**
-   * ModelInfo carries server-derived, read-only details about a model.
+   * Pagination cursor from previous response
    */
-  info?: Model.Info;
-}
-
-export namespace Model {
+  cursor?: string;
   /**
-   * ModelInfo carries server-derived, read-only details about a model.
+   * Filter by a prefix of the model's display name, external id, or id
+   *  (case-insensitive). A model's external id is the form used in
+   *  modelConfig.modelId, so a caller holding that can narrow the list by it.
    */
-  export interface Info {
-    /**
-     * Number of agent variations currently provisioned on this model. Useful for
-     * previewing how many variations a swap would affect.
-     */
-    agentVariationCount?: number;
-
-    /**
-     * AIProviderKey is a credential for an AI provider, scoped to a workspace. Most
-     * keys are customer-provided (BYOK); Cadenya also provisions promotional keys (see
-     * AIProviderKeyInfo.is_promotional), which cannot be modified or deleted by
-     * account administrators. The secret value is never returned in responses.
-     */
-    aiProviderKey?: AIProviderKeysAPI.AIProviderKey;
-
-    /**
-     * Represents the last time this model was used in an agent objective
-     */
-    lastUsedAt?: string;
-  }
-}
-
-export interface ModelSpec {
+  prefix?: string;
   /**
-   * The model family (e.g., "claude-sonnet-4.6", "gpt-5.4", "gemini-2.5-flash")
+   * Free-form search query
    */
-  family: string;
-
+  query?: string;
   /**
-   * The model provider (e.g., "anthropic", "openai", "google")
+   * Filter by model state
    */
-  provider: string;
-
+  state?: ModelServiceListModelsState;
   /**
-   * Cost per million input tokens in cents (e.g., 300 = $3.00)
+   * Filter to models provisioned on a specific AI provider key. Accepts the
+   *  key's id or an "external_id:"-prefixed slug.
    */
-  inputPricePerMillionTokens?: string;
-
+  aiProviderKeyId?: string;
   /**
-   * Maximum number of input tokens the model supports
+   * Filter models to only ones assigned to an active agent variation/agent.
+   *  Draft agents count as assigned; archived agents do not. Assignment does not
+   *  imply recent traffic — see ModelInfo.last_used_at for that.
    */
-  maxInputTokens?: number;
-
+  isAssigned?: boolean;
   /**
-   * Maximum number of output tokens the model can generate
+   * Filters by metadata labels. Comma-separated key=value pairs,
+   *  e.g. "env=prod,team=ai". A resource matches only if every pair
+   *  matches exactly (AND semantics).
    */
-  maxOutputTokens?: number;
-
+  labels?: string;
   /**
-   * Cost per million output tokens in cents (e.g., 1500 = $15.00)
+   * Sort order for results (asc or desc by creation time)
    */
-  outputPricePerMillionTokens?: string;
-
+  sortOrder?: string;
   /**
-   * The model's reasoning capability. Catalog data used to decide whether thinking
-   * is requested for objective iterations on this model.
+   * When true, populate each item's info (e.g. the AI provider), at the cost of
+   *  extra lookups.
    */
-  reasoning?: 'REASONING_UNSPECIFIED' | 'REASONING_NONE' | 'REASONING_ADAPTIVE' | 'REASONING_BUDGET';
+  includeInfo?: boolean;
 }
 
-/**
- * Swap model on variations response. Empty: the work runs asynchronously, so no
- * counts are returned (a large data set would make the call slow).
- */
-export type ModelSwapResponse = unknown;
-
 export interface ModelRetrieveParams {
   /**
    * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
    */
   workspaceId?: string;
 }
 
-export interface ModelListParams extends CursorPaginationParams {
-  /**
-   * Path param: Workspace ID.
-   */
-  workspaceId?: string;
-
-  /**
-   * Query param: Filter to models provisioned on a specific AI provider key. Accepts
-   * the key's id or an "external_id:"-prefixed slug.
-   */
-  aiProviderKeyId?: string;
-
-  /**
-   * Query param: When true, populate each item's info (e.g. the AI provider), at the
-   * cost of extra lookups.
-   */
-  includeInfo?: boolean;
-
-  /**
-   * Query param: Filter models to only ones assigned to an active agent
-   * variation/agent. Draft agents count as assigned; archived agents do not.
-   * Assignment does not imply recent traffic — see ModelInfo.last_used_at for that.
-   */
-  isAssigned?: boolean;
-
-  /**
-   * Query param: Filters by metadata labels. Comma-separated key=value pairs, e.g.
-   * "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
-   * semantics).
-   */
-  labels?: string;
-
-  /**
-   * Query param: Filter by a prefix of the model's display name, external id, or id
-   * (case-insensitive). A model's external id is the form used in
-   * modelConfig.modelId, so a caller holding that can narrow the list by it.
-   */
-  prefix?: string;
-
-  /**
-   * Query param: Free-form search query
-   */
-  query?: string;
-
-  /**
-   * Query param: Sort order for results (asc or desc by creation time)
-   */
-  sortOrder?: string;
-
-  /**
-   * Query param: Filter by model state
-   */
-  state?: 'STATE_UNSPECIFIED' | 'STATE_ENABLED' | 'STATE_DISABLED';
-}
-
 export interface ModelDisableParams {
   /**
    * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
    */
   workspaceId?: string;
 }
@@ -238,51 +82,108 @@ export interface ModelDisableParams {
 export interface ModelEnableParams {
   /**
    * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
    */
   workspaceId?: string;
 }
 
-export interface ModelSwapParams {
+export interface ModelSwapOnVariationsParams {
   /**
-   * Path param: Workspace ID.
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
    */
   workspaceId?: string;
-
   /**
-   * Body param: The swaps to perform.
+   * The swaps to perform.
    */
-  modelSwaps?: Array<ModelSwapParams.ModelSwap>;
+  modelSwaps?: Array<SwapModelOnVariationsRequest_ModelSwap>;
 }
 
-export namespace ModelSwapParams {
-  export interface ModelSwap {
-    /**
-     * The model variations are currently on. Accepts an id or "external_id:" slug.
-     */
-    currentModelId?: string;
+export class Models {
+  constructor(private readonly _client: HttpClient) {}
+
+  /**
+   * List models
+   * 
+   * @example
+   * ```ts
+   * const page = await client.models.list();
+   * for await (const item of page) {
+   *   // auto-fetches every page
+   * }
+   * ```
+   */
+  async list(params?: ModelListParams, options?: RequestOptions): Promise<Page<Model>> {
+    const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+    if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+    const _base = snapshotParams(params);
+    const response = await this._client.request<ListModelsResponse>({ method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/models`, query: { limit: params?.limit, cursor: params?.cursor, prefix: params?.prefix, query: params?.query, state: params?.state, aiProviderKeyId: params?.aiProviderKeyId, isAssigned: params?.isAssigned, labels: params?.labels, sortOrder: params?.sortOrder, includeInfo: params?.includeInfo } }, options);
+    return new Page(response.items ?? [], response.pagination?.nextCursor, (cursor) => this.list({ ..._base, cursor: cursor }, options));
+  }
 
-    /**
-     * Whether to disable the current model after the swap.
-     */
-    disableCurrentAfterSwap?: boolean;
+  /**
+   * Get a model by ID
+   * 
+   * @example
+   * ```ts
+   * const model = await client.models.retrieve('_123');
+   * ```
+   */
+  retrieve(id: string, params?: ModelRetrieveParams, options?: RequestOptions): APIPromise<Model> {
+    return this._client.requestAPI<Model>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/models/${pathSegment('id', id)}` };
+    }, options);
+  }
 
-    /**
-     * The model to move variations to. Accepts an id or "external_id:" slug.
-     */
-    nextModelId?: string;
+  /**
+   * Disable a model
+   * 
+   * @example
+   * ```ts
+   * const model = await client.models.disable('_123');
+   * ```
+   */
+  disable(id: string, params?: ModelDisableParams, options?: RequestOptions): APIPromise<Model> {
+    return this._client.requestAPI<Model>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/models/${pathSegment('id', id)}:disable` };
+    }, options);
+  }
+
+  /**
+   * Enable a model
+   * 
+   * @example
+   * ```ts
+   * const model = await client.models.enable('_123');
+   * ```
+   */
+  enable(id: string, params?: ModelEnableParams, options?: RequestOptions): APIPromise<Model> {
+    return this._client.requestAPI<Model>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/models/${pathSegment('id', id)}:enable` };
+    }, options);
   }
-}
 
-export declare namespace Models {
-  export {
-    type Model as Model,
-    type ModelSpec as ModelSpec,
-    type ModelSwapResponse as ModelSwapResponse,
-    type ModelsCursorPagination as ModelsCursorPagination,
-    type ModelRetrieveParams as ModelRetrieveParams,
-    type ModelListParams as ModelListParams,
-    type ModelDisableParams as ModelDisableParams,
-    type ModelEnableParams as ModelEnableParams,
-    type ModelSwapParams as ModelSwapParams,
-  };
+  /**
+   * Swap models on agent variations
+   * 
+   * @example
+   * ```ts
+   * await client.models.swapOnVariations();
+   * ```
+   */
+  swapOnVariations(params?: ModelSwapOnVariationsParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.requestAPI<void>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/models:swapModelOnVariations`, body: { modelSwaps: params?.modelSwaps }, void: true };
+    }, options);
+  }
 }