@cadenya/cadenya 0.82.0 → 0.85.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/api-keys/api-keys.ts

@@ -64,8 +64,8 @@ export class APIKeys extends APIResource {
    * Rotates an API key and returns a new token. All previous tokens for this key are
    * invalidated.
    */
-  rotate(id: string, options?: RequestOptions): APIPromise<APIKey> {
-    return this._client.put(path`/v1/account/api_keys/${id}/rotate`, options);
+  rotate(id: string, body: APIKeyRotateParams, options?: RequestOptions): APIPromise<APIKey> {
+    return this._client.post(path`/v1/account/api_keys/${id}:rotate`, { body, ...options });
   }
 }
 
@@ -260,6 +260,8 @@ export interface APIKeyListParams extends CursorPaginationParams {
   sortOrder?: string;
 }
 
+export interface APIKeyRotateParams {}
+
 APIKeys.Access = Access;
 
 export declare namespace APIKeys {
@@ -271,6 +273,7 @@ export declare namespace APIKeys {
     type APIKeyCreateParams as APIKeyCreateParams,
     type APIKeyUpdateParams as APIKeyUpdateParams,
     type APIKeyListParams as APIKeyListParams,
+    type APIKeyRotateParams as APIKeyRotateParams,
   };
 
   export {

package/src/resources/api-keys/index.ts

@@ -8,6 +8,7 @@ export {
   type APIKeyCreateParams,
   type APIKeyUpdateParams,
   type APIKeyListParams,
+  type APIKeyRotateParams,
   type APIKeysCursorPagination,
 } from './api-keys';
 export { Access, type AccessListParams, type AccessAddParams, type AccessRemoveParams } from './access';

package/src/resources/bulk-workspace-resources/bulk-workspace-resources.ts

@@ -99,6 +99,13 @@ export interface AgentEntry {
    */
   schedules?: { [key: string]: AgentScheduleEntry };
 
+  /**
+   * Desired lifecycle state for the agent. Defaults to STATE_DRAFT when unspecified.
+   * STATE_PUBLISHED publishes the agent once its variations exist; see also
+   * BulkWorkspaceApplyData.automatically_publish_agents.
+   */
+  state?: 'STATE_UNSPECIFIED' | 'STATE_DRAFT' | 'STATE_PUBLISHED' | 'STATE_ARCHIVED';
+
   /**
    * Variations under this agent, keyed by external_id.
    */
@@ -114,6 +121,13 @@ export interface AgentScheduleEntry {
   spec: SchedulesAPI.AgentScheduleSpec;
 
   labels?: { [key: string]: string };
+
+  /**
+   * Desired lifecycle state for the schedule. Defaults to STATE_ACTIVE when
+   * unspecified. Declare STATE_PAUSED to provision a schedule without it firing.
+   * STATE_ARCHIVED is rejected here.
+   */
+  state?: 'STATE_UNSPECIFIED' | 'STATE_ACTIVE' | 'STATE_PAUSED' | 'STATE_ARCHIVED';
 }
 
 export interface AgentVariationEntry {
@@ -172,14 +186,13 @@ export interface BulkWorkspaceApplyData {
   agents?: { [key: string]: AgentEntry };
 
   /**
-   * When true, every agent created or updated by this Apply has its status forced to
-   * AGENT_STATUS_PUBLISHED, regardless of the status declared in the agent's
-   * AgentSpec. Useful when the bundle represents a production configuration and you
-   * want all of its agents live without setting status: AGENT_STATUS_PUBLISHED on
-   * each entry.
+   * When true, every agent created or updated by this Apply has its state forced to
+   * STATE_PUBLISHED, regardless of the state declared on the agent's entry. Useful
+   * when the bundle represents a production configuration and you want all of its
+   * agents live without setting state: STATE_PUBLISHED on each entry.
    *
-   * Default false: each agent's AgentSpec.status controls (which is
-   * AGENT_STATUS_DRAFT on create when unspecified).
+   * Default false: each agent entry's `state` controls (which is STATE_DRAFT on
+   * create when unspecified).
    */
   automaticallyPublishAgents?: boolean;
 
@@ -327,6 +340,12 @@ export interface ToolEntry {
   spec: ToolsAPI.ToolSpec;
 
   labels?: { [key: string]: string };
+
+  /**
+   * Desired lifecycle state for the tool. Defaults to STATE_AVAILABLE when
+   * unspecified. STATE_ARCHIVED is server-managed and is rejected here.
+   */
+  state?: 'STATE_UNSPECIFIED' | 'STATE_AVAILABLE' | 'STATE_OMITTED' | 'STATE_ARCHIVED';
 }
 
 export interface ToolSetEntry {

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,
@@ -9,6 +20,7 @@ export {
   type APIKeyCreateParams,
   type APIKeyUpdateParams,
   type APIKeyListParams,
+  type APIKeyRotateParams,
   type APIKeysCursorPagination,
 } from './api-keys/api-keys';
 export {
@@ -32,6 +44,10 @@ export {
   type AgentUpdateParams,
   type AgentListParams,
   type AgentDeleteParams,
+  type AgentArchiveParams,
+  type AgentPublishParams,
+  type AgentUnarchiveParams,
+  type AgentUnpublishParams,
   type AgentsCursorPagination,
 } from './agents/agents';
 export {
@@ -70,9 +86,12 @@ export {
   Models,
   type Model,
   type ModelSpec,
+  type ModelSwapResponse,
   type ModelRetrieveParams,
   type ModelListParams,
-  type ModelSetStatusParams,
+  type ModelDisableParams,
+  type ModelEnableParams,
+  type ModelSwapParams,
   type ModelsCursorPagination,
 } from './models';
 export {
@@ -84,16 +103,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,
@@ -147,8 +165,10 @@ export {
   type ToolSetUpdateParams,
   type ToolSetListParams,
   type ToolSetDeleteParams,
+  type ToolSetArchiveParams,
   type ToolSetGetOpenAPISpecParams,
   type ToolSetListEventsParams,
+  type ToolSetUnarchiveParams,
   type ToolSetsCursorPagination,
   type ToolSetEventsCursorPagination,
 } from './tool-sets/tool-sets';
@@ -165,6 +185,7 @@ export {
   WorkspaceAdmin,
   type WorkspaceMember,
   type WorkspaceAdminCreateParams,
+  type WorkspaceAdminUpdateParams,
   type WorkspaceAdminListParams,
   type WorkspaceMembersCursorPagination,
 } from './workspace-admin/workspace-admin';

package/src/resources/models.ts

@@ -36,11 +36,32 @@ export class Models extends APIResource {
   }
 
   /**
-   * Enables or disables a model in the workspace
+   * Transitions a model to STATE_DISABLED. Fails while agent variations are still
+   * provisioned on the model; use :swapModelOnVariations to move them first.
    */
-  setStatus(id: string, params: ModelSetStatusParams, options?: RequestOptions): APIPromise<Model> {
+  disable(id: string, params: ModelDisableParams, options?: RequestOptions): APIPromise<Model> {
     const { workspaceId, ...body } = params;
-    return this._client.put(path`/v1/workspaces/${workspaceId}/models/${id}/status`, { body, ...options });
+    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, ...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(workspaceID: string, body: ModelSwapParams, options?: RequestOptions): APIPromise<unknown> {
+    return this._client.post(path`/v1/workspaces/${workspaceID}/models:swapModelOnVariations`, {
+      body,
+      ...options,
+    });
   }
 }
 
@@ -56,6 +77,40 @@ export interface Model {
    * Model specification
    */
   spec: ModelSpec;
+
+  /**
+   * Whether the model is usable in this workspace. Output only. Use the :enable and
+   * :disable actions to transition.
+   */
+  state: 'STATE_UNSPECIFIED' | 'STATE_ENABLED' | 'STATE_DISABLED';
+
+  /**
+   * 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 {
@@ -88,13 +143,14 @@ export interface ModelSpec {
    * The model provider (e.g., "anthropic", "openai", "google")
    */
   provider?: string;
-
-  /**
-   * The status of the model in the workspace
-   */
-  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 +159,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
    */
@@ -124,30 +192,56 @@ export interface ModelListParams extends CursorPaginationParams {
   sortOrder?: string;
 
   /**
-   * Filter by model status
+   * Filter by model state
    */
-  status?: 'MODEL_STATUS_UNSPECIFIED' | 'MODEL_STATUS_ENABLED' | 'MODEL_STATUS_DISABLED';
+  state?: 'STATE_UNSPECIFIED' | 'STATE_ENABLED' | 'STATE_DISABLED';
 }
 
-export interface ModelSetStatusParams {
+export interface ModelDisableParams {
   /**
-   * Path param: Workspace ID.
+   * Workspace ID.
    */
   workspaceId: string;
+}
 
+export interface ModelEnableParams {
   /**
-   * Body param: The new status for the model
+   * Workspace ID.
    */
-  status?: 'MODEL_STATUS_UNSPECIFIED' | 'MODEL_STATUS_ENABLED' | 'MODEL_STATUS_DISABLED';
+  workspaceId: string;
+}
+
+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 ModelDisableParams as ModelDisableParams,
+    type ModelEnableParams as ModelEnableParams,
+    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,