@cadenya/cadenya 0.81.0 → 0.84.0

package/src/resources/ai-provider-keys.ts

@@ -0,0 +1,216 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import * as Shared from './shared';
+import { APIPromise } from '../core/api-promise';
+import { CursorPagination, type CursorPaginationParams, PagePromise } from '../core/pagination';
+import { buildHeaders } from '../internal/headers';
+import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
+
+export class AIProviderKeys extends APIResource {
+  /**
+   * Creates a new customer-provided AI provider key in the workspace
+   */
+  create(
+    workspaceID: string,
+    body: AIProviderKeyCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<AIProviderKey> {
+    return this._client.post(path`/v1/workspaces/${workspaceID}/ai_provider_keys`, { body, ...options });
+  }
+
+  /**
+   * Retrieves an AI provider key by ID from the workspace
+   */
+  retrieve(
+    id: string,
+    params: AIProviderKeyRetrieveParams,
+    options?: RequestOptions,
+  ): APIPromise<AIProviderKey> {
+    const { workspaceId } = params;
+    return this._client.get(path`/v1/workspaces/${workspaceId}/ai_provider_keys/${id}`, options);
+  }
+
+  /**
+   * Updates an AI provider key's name or key value in the workspace
+   */
+  update(id: string, params: AIProviderKeyUpdateParams, options?: RequestOptions): APIPromise<AIProviderKey> {
+    const { workspaceId, ...body } = params;
+    return this._client.patch(path`/v1/workspaces/${workspaceId}/ai_provider_keys/${id}`, {
+      body,
+      ...options,
+    });
+  }
+
+  /**
+   * Lists all customer-provided AI provider keys in the workspace
+   */
+  list(
+    workspaceID: string,
+    query: AIProviderKeyListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<AIProviderKeysCursorPagination, AIProviderKey> {
+    return this._client.getAPIList(
+      path`/v1/workspaces/${workspaceID}/ai_provider_keys`,
+      CursorPagination<AIProviderKey>,
+      { query, ...options },
+    );
+  }
+
+  /**
+   * Deletes an AI provider key from the workspace
+   */
+  delete(id: string, params: AIProviderKeyDeleteParams, options?: RequestOptions): APIPromise<void> {
+    const { workspaceId } = params;
+    return this._client.delete(path`/v1/workspaces/${workspaceId}/ai_provider_keys/${id}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+export type AIProviderKeysCursorPagination = CursorPagination<AIProviderKey>;
+
+/**
+ * AIProviderKey is a customer-provided (BYOK) credential for an AI provider,
+ * scoped to a workspace. The secret value is never returned in responses.
+ */
+export interface AIProviderKey {
+  /**
+   * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+   */
+  metadata: Shared.ResourceMetadata;
+
+  spec: AIProviderKeySpec;
+
+  /**
+   * AIProviderKeyInfo carries server-derived, read-only details about a key, for AI
+   * provider management UIs.
+   */
+  info?: AIProviderKey.Info;
+}
+
+export namespace AIProviderKey {
+  /**
+   * AIProviderKeyInfo carries server-derived, read-only details about a key, for AI
+   * provider management UIs.
+   */
+  export interface Info {
+    /**
+     * Number of disabled models provisioned on this key.
+     */
+    disabledModelCount?: number;
+
+    /**
+     * Number of enabled models provisioned on this key.
+     */
+    enabledModelCount?: number;
+  }
+}
+
+export interface AIProviderKeySpec {
+  /**
+   * The provider credential. Accepted on create/update; never populated in responses
+   * (the server returns an empty value to avoid leaking it).
+   */
+  apiKey?: string;
+
+  /**
+   * OpenRouterConfig holds OpenRouter-specific settings. Empty for now; it exists as
+   * the oneof seam so provider-specific options (region, base URL, etc.) can be
+   * added later without restructuring the spec.
+   */
+  openrouter?: unknown;
+
+  /**
+   * The AI provider this key authenticates against.
+   */
+  provider?: 'AI_PROVIDER_UNSPECIFIED' | 'AI_PROVIDER_OPENROUTER';
+}
+
+export interface AIProviderKeyCreateParams {
+  /**
+   * CreateResourceMetadata contains the user-provided fields for creating a
+   * workspace-scoped resource. Read-only fields (id, account_id, workspace_id,
+   * profile_id, created_at) are excluded since they are set by the server.
+   */
+  metadata: Shared.CreateResourceMetadata;
+
+  spec: AIProviderKeySpec;
+}
+
+export interface AIProviderKeyRetrieveParams {
+  /**
+   * The workspace the key belongs to.
+   */
+  workspaceId: string;
+}
+
+export interface AIProviderKeyUpdateParams {
+  /**
+   * Path param: The workspace the key belongs to.
+   */
+  workspaceId: string;
+
+  /**
+   * Body param: UpdateResourceMetadata contains the user-provided fields for
+   * updating a workspace-scoped resource. Read-only fields (id, account_id,
+   * workspace_id, profile_id, created_at) are excluded since they are set by the
+   * server.
+   */
+  metadata?: Shared.UpdateResourceMetadata;
+
+  /**
+   * Body param
+   */
+  spec?: AIProviderKeySpec;
+
+  /**
+   * Body param: Fields to update.
+   */
+  updateMask?: string;
+}
+
+export interface AIProviderKeyListParams extends CursorPaginationParams {
+  /**
+   * When true, populate each item's info (model counts), at the cost of extra
+   * lookups.
+   */
+  includeInfo?: boolean;
+
+  /**
+   * Filter expression (query param: prefix)
+   */
+  prefix?: string;
+
+  /**
+   * Free-form search query
+   */
+  query?: string;
+
+  /**
+   * Sort order for results (asc or desc by creation time)
+   */
+  sortOrder?: string;
+}
+
+export interface AIProviderKeyDeleteParams {
+  /**
+   * The workspace the key belongs to.
+   */
+  workspaceId: string;
+}
+
+export declare namespace AIProviderKeys {
+  export {
+    type AIProviderKey as AIProviderKey,
+    type AIProviderKeySpec as AIProviderKeySpec,
+    type AIProviderKeysCursorPagination as AIProviderKeysCursorPagination,
+    type AIProviderKeyCreateParams as AIProviderKeyCreateParams,
+    type AIProviderKeyRetrieveParams as AIProviderKeyRetrieveParams,
+    type AIProviderKeyUpdateParams as AIProviderKeyUpdateParams,
+    type AIProviderKeyListParams as AIProviderKeyListParams,
+    type AIProviderKeyDeleteParams as AIProviderKeyDeleteParams,
+  };
+}

package/src/resources/index.ts

@@ -1,6 +1,17 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 export * from './shared';
+export {
+  AIProviderKeys,
+  type AIProviderKey,
+  type AIProviderKeySpec,
+  type AIProviderKeyCreateParams,
+  type AIProviderKeyRetrieveParams,
+  type AIProviderKeyUpdateParams,
+  type AIProviderKeyListParams,
+  type AIProviderKeyDeleteParams,
+  type AIProviderKeysCursorPagination,
+} from './ai-provider-keys';
 export {
   APIKeys,
   type APIKey,
@@ -19,6 +30,7 @@ export {
   type Profile,
   type ProfileSpec,
   type RotateWebhookSigningKeyResponse,
+  type ProfilesCursorPagination,
 } from './account';
 export {
   Agents,
@@ -69,9 +81,11 @@ export {
   Models,
   type Model,
   type ModelSpec,
+  type ModelSwapResponse,
   type ModelRetrieveParams,
   type ModelListParams,
   type ModelSetStatusParams,
+  type ModelSwapParams,
   type ModelsCursorPagination,
 } from './models';
 export {
@@ -83,16 +97,15 @@ export {
   type MemoryRead,
   type MemoryReference,
   type Objective,
+  type ObjectiveConfigSnapshot,
   type ObjectiveContextWindow,
   type ObjectiveContextWindowData,
-  type ObjectiveData,
-  type ObjectiveDataSecret,
   type ObjectiveError,
   type ObjectiveEventData,
   type ObjectiveEventInfo,
   type ObjectiveEventWebhookData,
   type ObjectiveInfo,
-  type ObjectiveStatus,
+  type ObjectiveSecret,
   type SubAgentSpawned,
   type SubAgentUpdated,
   type ToolApprovalRequested,
@@ -164,6 +177,7 @@ export {
   WorkspaceAdmin,
   type WorkspaceMember,
   type WorkspaceAdminCreateParams,
+  type WorkspaceAdminUpdateParams,
   type WorkspaceAdminListParams,
   type WorkspaceMembersCursorPagination,
 } from './workspace-admin/workspace-admin';

package/src/resources/models.ts

@@ -42,6 +42,17 @@ export class Models extends APIResource {
     const { workspaceId, ...body } = params;
     return this._client.put(path`/v1/workspaces/${workspaceId}/models/${id}/status`, { body, ...options });
   }
+
+  /**
+   * Reassigns agent variations from one model to another in bulk. Runs
+   * asynchronously and returns immediately.
+   */
+  swap(workspaceID: string, body: ModelSwapParams, options?: RequestOptions): APIPromise<unknown> {
+    return this._client.post(path`/v1/workspaces/${workspaceID}/models:swapModelOnVariations`, {
+      body,
+      ...options,
+    });
+  }
 }
 
 export type ModelsCursorPagination = CursorPagination<Model>;
@@ -56,6 +67,34 @@ export interface Model {
    * Model specification
    */
   spec: ModelSpec;
+
+  /**
+   * ModelInfo carries server-derived, read-only details about a model.
+   */
+  info?: Model.Info;
+}
+
+export namespace Model {
+  /**
+   * ModelInfo carries server-derived, read-only details about a model.
+   */
+  export interface Info {
+    /**
+     * Number of agent variations currently provisioned on this model. Useful for
+     * previewing how many variations a swap would affect.
+     */
+    agentVariationCount?: number;
+
+    /**
+     * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+     */
+    aiProviderKey?: Shared.ResourceMetadata;
+
+    /**
+     * The AI provider this model routes through (via its provider key).
+     */
+    provider?: 'AI_PROVIDER_UNSPECIFIED' | 'AI_PROVIDER_OPENROUTER';
+  }
 }
 
 export interface ModelSpec {
@@ -95,6 +134,12 @@ export interface ModelSpec {
   status?: 'MODEL_STATUS_UNSPECIFIED' | 'MODEL_STATUS_ENABLED' | 'MODEL_STATUS_DISABLED';
 }
 
+/**
+ * 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.
@@ -103,11 +148,23 @@ export interface ModelRetrieveParams {
 }
 
 export interface ModelListParams extends CursorPaginationParams {
+  /**
+   * Filter to models provisioned on a specific AI provider key. Accepts the key's id
+   * or an "external_id:"-prefixed slug.
+   */
+  aiProviderKeyId?: string;
+
   /**
    * Filter by bundle_key — return only resources owned by this bundle.
    */
   bundleKey?: string;
 
+  /**
+   * When true, populate each item's info (e.g. the AI provider), at the cost of
+   * extra lookups.
+   */
+  includeInfo?: boolean;
+
   /**
    * Filter by name prefix
    */
@@ -141,13 +198,36 @@ export interface ModelSetStatusParams {
   status?: 'MODEL_STATUS_UNSPECIFIED' | 'MODEL_STATUS_ENABLED' | 'MODEL_STATUS_DISABLED';
 }
 
+export interface ModelSwapParams {
+  /**
+   * The swaps to perform.
+   */
+  modelSwaps?: Array<ModelSwapParams.ModelSwap>;
+}
+
+export namespace ModelSwapParams {
+  export interface ModelSwap {
+    /**
+     * The model variations are currently on. Accepts an id or "external_id:" slug.
+     */
+    currentModelId?: string;
+
+    /**
+     * The model to move variations to. Accepts an id or "external_id:" slug.
+     */
+    nextModelId?: string;
+  }
+}
+
 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 ModelSetStatusParams as ModelSetStatusParams,
+    type ModelSwapParams as ModelSwapParams,
   };
 }

package/src/resources/objectives/index.ts

@@ -18,16 +18,15 @@ export {
   type MemoryRead,
   type MemoryReference,
   type Objective,
+  type ObjectiveConfigSnapshot,
   type ObjectiveContextWindow,
   type ObjectiveContextWindowData,
-  type ObjectiveData,
-  type ObjectiveDataSecret,
   type ObjectiveError,
   type ObjectiveEventData,
   type ObjectiveEventInfo,
   type ObjectiveEventWebhookData,
   type ObjectiveInfo,
-  type ObjectiveStatus,
+  type ObjectiveSecret,
   type SubAgentSpawned,
   type SubAgentUpdated,
   type ToolApprovalRequested,