@cadenya/cadenya 0.82.0 → 0.85.0

package/src/client.ts

@@ -28,12 +28,26 @@ import {
   ProfileSpec,
   RotateWebhookSigningKeyResponse,
 } from './resources/account';
+import {
+  AIProviderKey,
+  AIProviderKeyCreateParams,
+  AIProviderKeyDeleteParams,
+  AIProviderKeyListParams,
+  AIProviderKeyRetrieveParams,
+  AIProviderKeySpec,
+  AIProviderKeyUpdateParams,
+  AIProviderKeys,
+  AIProviderKeysCursorPagination,
+} from './resources/ai-provider-keys';
 import {
   Model,
+  ModelDisableParams,
+  ModelEnableParams,
   ModelListParams,
   ModelRetrieveParams,
-  ModelSetStatusParams,
   ModelSpec,
+  ModelSwapParams,
+  ModelSwapResponse,
   Models,
   ModelsCursorPagination,
 } from './resources/models';
@@ -72,12 +86,16 @@ import {
 } from './resources/workspaces';
 import {
   Agent,
+  AgentArchiveParams,
   AgentCreateParams,
   AgentDeleteParams,
   AgentInfo,
   AgentListParams,
+  AgentPublishParams,
   AgentRetrieveParams,
   AgentSpec,
+  AgentUnarchiveParams,
+  AgentUnpublishParams,
   AgentUpdateParams,
   Agents,
   AgentsCursorPagination,
@@ -88,6 +106,7 @@ import {
   APIKeyCreateParams,
   APIKeyInfo,
   APIKeyListParams,
+  APIKeyRotateParams,
   APIKeySpec,
   APIKeyUpdateParams,
   APIKeys,
@@ -136,14 +155,13 @@ import {
   ObjectiveCancelParams,
   ObjectiveCompactParams,
   ObjectiveCompactResponse,
+  ObjectiveConfigSnapshot,
   ObjectiveContextWindow,
   ObjectiveContextWindowData,
   ObjectiveContextWindowsCursorPagination,
   ObjectiveContinueParams,
   ObjectiveContinueResponse,
   ObjectiveCreateParams,
-  ObjectiveData,
-  ObjectiveDataSecret,
   ObjectiveError,
   ObjectiveEventData,
   ObjectiveEventInfo,
@@ -155,7 +173,7 @@ import {
   ObjectiveListEventsResponsesCursorPagination,
   ObjectiveListParams,
   ObjectiveRetrieveParams,
-  ObjectiveStatus,
+  ObjectiveSecret,
   Objectives,
   ObjectivesCursorPagination,
   SubAgentSpawned,
@@ -181,6 +199,7 @@ import {
   ToolSetAdapterHTTP,
   ToolSetAdapterMcp,
   ToolSetAdapterOpenAPI,
+  ToolSetArchiveParams,
   ToolSetCreateParams,
   ToolSetDeleteParams,
   ToolSetEvent,
@@ -193,6 +212,7 @@ import {
   ToolSetListParams,
   ToolSetRetrieveParams,
   ToolSetSpec,
+  ToolSetUnarchiveParams,
   ToolSetUpdateParams,
   ToolSets,
   ToolSetsCursorPagination,
@@ -201,6 +221,7 @@ import {
   WorkspaceAdmin,
   WorkspaceAdminCreateParams,
   WorkspaceAdminListParams,
+  WorkspaceAdminUpdateParams,
   WorkspaceMember,
 } from './resources/workspace-admin/workspace-admin';
 import { type Fetch } from './internal/builtin-types';
@@ -947,6 +968,7 @@ export class Cadenya {
 
   static toFile = Uploads.toFile;
 
+  aiProviderKeys: API.AIProviderKeys = new API.AIProviderKeys(this);
   /**
    * Manage the authenticated account. Accounts are the top-level organizational
    *  unit and contain one or more workspaces.
@@ -1018,6 +1040,7 @@ export class Cadenya {
   bulkWorkspaceResources: API.BulkWorkspaceResources = new API.BulkWorkspaceResources(this);
 }
 
+Cadenya.AIProviderKeys = AIProviderKeys;
 Cadenya.AccountResource = AccountResource;
 Cadenya.Agents = Agents;
 Cadenya.Objectives = Objectives;
@@ -1042,6 +1065,18 @@ export declare namespace Cadenya {
     type CursorPaginationResponse as CursorPaginationResponse,
   };
 
+  export {
+    AIProviderKeys as AIProviderKeys,
+    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,
+  };
+
   export {
     AccountResource as AccountResource,
     type Account as Account,
@@ -1064,6 +1099,10 @@ export declare namespace Cadenya {
     type AgentUpdateParams as AgentUpdateParams,
     type AgentListParams as AgentListParams,
     type AgentDeleteParams as AgentDeleteParams,
+    type AgentArchiveParams as AgentArchiveParams,
+    type AgentPublishParams as AgentPublishParams,
+    type AgentUnarchiveParams as AgentUnarchiveParams,
+    type AgentUnpublishParams as AgentUnpublishParams,
   };
 
   export {
@@ -1075,16 +1114,15 @@ export declare namespace Cadenya {
     type MemoryRead as MemoryRead,
     type MemoryReference as MemoryReference,
     type Objective as Objective,
+    type ObjectiveConfigSnapshot as ObjectiveConfigSnapshot,
     type ObjectiveContextWindow as ObjectiveContextWindow,
     type ObjectiveContextWindowData as ObjectiveContextWindowData,
-    type ObjectiveData as ObjectiveData,
-    type ObjectiveDataSecret as ObjectiveDataSecret,
     type ObjectiveError as ObjectiveError,
     type ObjectiveEventData as ObjectiveEventData,
     type ObjectiveEventInfo as ObjectiveEventInfo,
     type ObjectiveEventWebhookData as ObjectiveEventWebhookData,
     type ObjectiveInfo as ObjectiveInfo,
-    type ObjectiveStatus as ObjectiveStatus,
+    type ObjectiveSecret as ObjectiveSecret,
     type SubAgentSpawned as SubAgentSpawned,
     type SubAgentUpdated as SubAgentUpdated,
     type ToolApprovalRequested as ToolApprovalRequested,
@@ -1136,10 +1174,13 @@ export declare namespace Cadenya {
     Models as Models,
     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,
   };
 
   export {
@@ -1174,8 +1215,10 @@ export declare namespace Cadenya {
     type ToolSetUpdateParams as ToolSetUpdateParams,
     type ToolSetListParams as ToolSetListParams,
     type ToolSetDeleteParams as ToolSetDeleteParams,
+    type ToolSetArchiveParams as ToolSetArchiveParams,
     type ToolSetGetOpenAPISpecParams as ToolSetGetOpenAPISpecParams,
     type ToolSetListEventsParams as ToolSetListEventsParams,
+    type ToolSetUnarchiveParams as ToolSetUnarchiveParams,
   };
 
   export {
@@ -1187,6 +1230,7 @@ export declare namespace Cadenya {
     type APIKeyCreateParams as APIKeyCreateParams,
     type APIKeyUpdateParams as APIKeyUpdateParams,
     type APIKeyListParams as APIKeyListParams,
+    type APIKeyRotateParams as APIKeyRotateParams,
   };
 
   export {
@@ -1214,6 +1258,7 @@ export declare namespace Cadenya {
     WorkspaceAdmin as WorkspaceAdmin,
     type WorkspaceMember as WorkspaceMember,
     type WorkspaceAdminCreateParams as WorkspaceAdminCreateParams,
+    type WorkspaceAdminUpdateParams as WorkspaceAdminUpdateParams,
     type WorkspaceAdminListParams as WorkspaceAdminListParams,
   };
 

package/src/resources/account.ts

@@ -25,7 +25,7 @@ export class AccountResource extends APIResource {
    * Rotates the webhook signing key for the account. Returns only the new key.
    */
   rotateWebhookSigningKey(options?: RequestOptions): APIPromise<RotateWebhookSigningKeyResponse> {
-    return this._client.post('/v1/account/rotate_webhook_signing_key', options);
+    return this._client.post('/v1/account:rotateWebhookSigningKey', options);
   }
 }
 
@@ -110,7 +110,7 @@ export interface ProfileSpec {
   /**
    * Whether this profile represents a human user, an API key, or a system principal.
    */
-  type: 'PROFILE_TYPE_USER' | 'PROFILE_TYPE_API_KEY' | 'PROFILE_TYPE_SYSTEM';
+  type: 'PROFILE_TYPE_UNSPECIFIED' | 'PROFILE_TYPE_USER' | 'PROFILE_TYPE_API_KEY' | 'PROFILE_TYPE_SYSTEM';
 
   /**
    * Email address of the profile. Required and unique within an account for user

package/src/resources/agents/agents.ts

@@ -12,12 +12,15 @@ import {
   AgentScheduleSpec,
   AgentScheduleSpecSchedule,
   AgentSchedulesCursorPagination,
+  ScheduleArchiveParams,
   ScheduleCalendar,
   ScheduleCreateParams,
   ScheduleDeleteParams,
   ScheduleInterval,
   ScheduleListParams,
+  SchedulePauseParams,
   ScheduleRange,
+  ScheduleResumeParams,
   ScheduleRetrieveParams,
   ScheduleUpdateParams,
   Schedules,
@@ -120,6 +123,48 @@ export class Agents extends APIResource {
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
   }
+
+  /**
+   * Transitions an agent to STATE_ARCHIVED. Archived agents are hidden from list
+   * results and cannot be used for objectives; active schedules are paused.
+   */
+  archive(id: string, params: AgentArchiveParams, options?: RequestOptions): APIPromise<Agent> {
+    const { workspaceId, ...body } = params;
+    return this._client.post(path`/v1/workspaces/${workspaceId}/agents/${id}:archive`, { body, ...options });
+  }
+
+  /**
+   * Transitions an agent to STATE_PUBLISHED, making it available for objectives. The
+   * agent must have at least one variation.
+   */
+  publish(id: string, params: AgentPublishParams, options?: RequestOptions): APIPromise<Agent> {
+    const { workspaceId, ...body } = params;
+    return this._client.post(path`/v1/workspaces/${workspaceId}/agents/${id}:publish`, { body, ...options });
+  }
+
+  /**
+   * Transitions an archived agent back to STATE_DRAFT. Publish the agent again to
+   * make it available for objectives.
+   */
+  unarchive(id: string, params: AgentUnarchiveParams, options?: RequestOptions): APIPromise<Agent> {
+    const { workspaceId, ...body } = params;
+    return this._client.post(path`/v1/workspaces/${workspaceId}/agents/${id}:unarchive`, {
+      body,
+      ...options,
+    });
+  }
+
+  /**
+   * Transitions a published agent back to STATE_DRAFT. Active schedules for the
+   * agent are paused until it is published again.
+   */
+  unpublish(id: string, params: AgentUnpublishParams, options?: RequestOptions): APIPromise<Agent> {
+    const { workspaceId, ...body } = params;
+    return this._client.post(path`/v1/workspaces/${workspaceId}/agents/${id}:unpublish`, {
+      body,
+      ...options,
+    });
+  }
 }
 
 export type AgentsCursorPagination = CursorPagination<Agent>;
@@ -138,6 +183,13 @@ export interface Agent {
    */
   spec: AgentSpec;
 
+  /**
+   * The current lifecycle state of the agent. Output only. Agents are created in
+   * STATE_DRAFT; use the :publish, :unpublish, :archive, and :unarchive actions to
+   * transition between states.
+   */
+  state: 'STATE_UNSPECIFIED' | 'STATE_DRAFT' | 'STATE_PUBLISHED' | 'STATE_ARCHIVED';
+
   /**
    * AgentInfo contains simple information about an agent for display or quick
    * reference
@@ -164,15 +216,6 @@ export interface AgentInfo {
  * Agent specification (user-provided configuration)
  */
 export interface AgentSpec {
-  /**
-   * Status of the agent
-   */
-  status:
-    | 'AGENT_STATUS_UNSPECIFIED'
-    | 'AGENT_STATUS_DRAFT'
-    | 'AGENT_STATUS_PUBLISHED'
-    | 'AGENT_STATUS_ARCHIVED';
-
   /**
    * Controls how variations are automatically selected when creating objectives
    * Defaults to RANDOM when unspecified
@@ -314,13 +357,9 @@ export interface AgentListParams extends CursorPaginationParams {
   sortOrder?: string;
 
   /**
-   * Filter by agent publication status
+   * Filter by agent lifecycle state
    */
-  status?:
-    | 'AGENT_STATUS_UNSPECIFIED'
-    | 'AGENT_STATUS_DRAFT'
-    | 'AGENT_STATUS_PUBLISHED'
-    | 'AGENT_STATUS_ARCHIVED';
+  state?: 'STATE_UNSPECIFIED' | 'STATE_DRAFT' | 'STATE_PUBLISHED' | 'STATE_ARCHIVED';
 
   /**
    * Filter by variation selection mode
@@ -338,6 +377,34 @@ export interface AgentDeleteParams {
   workspaceId: string;
 }
 
+export interface AgentArchiveParams {
+  /**
+   * Workspace ID.
+   */
+  workspaceId: string;
+}
+
+export interface AgentPublishParams {
+  /**
+   * Workspace ID.
+   */
+  workspaceId: string;
+}
+
+export interface AgentUnarchiveParams {
+  /**
+   * Workspace ID.
+   */
+  workspaceId: string;
+}
+
+export interface AgentUnpublishParams {
+  /**
+   * Workspace ID.
+   */
+  workspaceId: string;
+}
+
 Agents.Feedback = Feedback;
 Agents.WebhookDeliveries = WebhookDeliveries;
 Agents.Variations = Variations;
@@ -355,6 +422,10 @@ export declare namespace Agents {
     type AgentUpdateParams as AgentUpdateParams,
     type AgentListParams as AgentListParams,
     type AgentDeleteParams as AgentDeleteParams,
+    type AgentArchiveParams as AgentArchiveParams,
+    type AgentPublishParams as AgentPublishParams,
+    type AgentUnarchiveParams as AgentUnarchiveParams,
+    type AgentUnpublishParams as AgentUnpublishParams,
   };
 
   export { Feedback as Feedback, type FeedbackListParams as FeedbackListParams };
@@ -408,5 +479,8 @@ export declare namespace Agents {
     type ScheduleUpdateParams as ScheduleUpdateParams,
     type ScheduleListParams as ScheduleListParams,
     type ScheduleDeleteParams as ScheduleDeleteParams,
+    type ScheduleArchiveParams as ScheduleArchiveParams,
+    type SchedulePauseParams as SchedulePauseParams,
+    type ScheduleResumeParams as ScheduleResumeParams,
   };
 }

package/src/resources/agents/index.ts

@@ -11,6 +11,10 @@ export {
   type AgentUpdateParams,
   type AgentListParams,
   type AgentDeleteParams,
+  type AgentArchiveParams,
+  type AgentPublishParams,
+  type AgentUnarchiveParams,
+  type AgentUnpublishParams,
   type AgentsCursorPagination,
 } from './agents';
 export { Feedback, type FeedbackListParams } from './feedback';
@@ -28,6 +32,9 @@ export {
   type ScheduleUpdateParams,
   type ScheduleListParams,
   type ScheduleDeleteParams,
+  type ScheduleArchiveParams,
+  type SchedulePauseParams,
+  type ScheduleResumeParams,
   type AgentSchedulesCursorPagination,
 } from './schedules';
 export {

package/src/resources/agents/schedules.ts

@@ -70,6 +70,43 @@ export class Schedules extends APIResource {
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
   }
+
+  /**
+   * Transitions a schedule to STATE_ARCHIVED and removes its underlying timer.
+   * Archiving is terminal: archived schedules never fire and cannot be reactivated;
+   * create a new schedule instead.
+   */
+  archive(id: string, params: ScheduleArchiveParams, options?: RequestOptions): APIPromise<AgentSchedule> {
+    const { workspaceId, agentId, ...body } = params;
+    return this._client.post(path`/v1/workspaces/${workspaceId}/agents/${agentId}/schedules/${id}:archive`, {
+      body,
+      ...options,
+    });
+  }
+
+  /**
+   * Transitions a schedule to STATE_PAUSED. Paused schedules retain history but do
+   * not fire.
+   */
+  pause(id: string, params: SchedulePauseParams, options?: RequestOptions): APIPromise<AgentSchedule> {
+    const { workspaceId, agentId, ...body } = params;
+    return this._client.post(path`/v1/workspaces/${workspaceId}/agents/${agentId}/schedules/${id}:pause`, {
+      body,
+      ...options,
+    });
+  }
+
+  /**
+   * Transitions a paused schedule back to STATE_ACTIVE so it fires on its cadence
+   * again. Archived schedules cannot be resumed.
+   */
+  resume(id: string, params: ScheduleResumeParams, options?: RequestOptions): APIPromise<AgentSchedule> {
+    const { workspaceId, agentId, ...body } = params;
+    return this._client.post(path`/v1/workspaces/${workspaceId}/agents/${agentId}/schedules/${id}:resume`, {
+      body,
+      ...options,
+    });
+  }
 }
 
 export type AgentSchedulesCursorPagination = CursorPagination<AgentSchedule>;
@@ -89,6 +126,13 @@ export interface AgentSchedule {
    */
   spec: AgentScheduleSpec;
 
+  /**
+   * The current lifecycle state of the schedule. Output only. Schedules are created
+   * STATE_ACTIVE; use the :pause, :resume, and :archive actions to transition
+   * between states.
+   */
+  state: 'STATE_UNSPECIFIED' | 'STATE_ACTIVE' | 'STATE_PAUSED' | 'STATE_ARCHIVED';
+
   /**
    * AgentScheduleInfo provides read-only runtime data about a schedule.
    */
@@ -128,7 +172,7 @@ export interface AgentScheduleInfo {
 
   /**
    * When the schedule will next fire. Computed from the spec; absent when the
-   * schedule is PAUSED/ARCHIVED or has no future fire times.
+   * schedule is STATE_PAUSED/STATE_ARCHIVED or has no future fire times.
    */
   nextFireAt?: string;
 
@@ -166,15 +210,6 @@ export interface AgentScheduleSpec {
    */
   overlapPolicy?: 'OVERLAP_POLICY_UNSPECIFIED' | 'OVERLAP_POLICY_ALLOW' | 'OVERLAP_POLICY_SKIP';
 
-  /**
-   * Lifecycle. Defaults to ACTIVE on create when unspecified.
-   */
-  status?:
-    | 'AGENT_SCHEDULE_STATUS_UNSPECIFIED'
-    | 'AGENT_SCHEDULE_STATUS_ACTIVE'
-    | 'AGENT_SCHEDULE_STATUS_PAUSED'
-    | 'AGENT_SCHEDULE_STATUS_ARCHIVED';
-
   /**
    * Optional explicit variation. When unset, the agent's variation_selection_mode
    * chooses per fire.
@@ -364,6 +399,45 @@ export interface ScheduleDeleteParams {
   agentId: string;
 }
 
+export interface ScheduleArchiveParams {
+  /**
+   * Workspace ID.
+   */
+  workspaceId: string;
+
+  /**
+   * Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>`
+   * form.
+   */
+  agentId: string;
+}
+
+export interface SchedulePauseParams {
+  /**
+   * Workspace ID.
+   */
+  workspaceId: string;
+
+  /**
+   * Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>`
+   * form.
+   */
+  agentId: string;
+}
+
+export interface ScheduleResumeParams {
+  /**
+   * Workspace ID.
+   */
+  workspaceId: string;
+
+  /**
+   * Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>`
+   * form.
+   */
+  agentId: string;
+}
+
 export declare namespace Schedules {
   export {
     type AgentSchedule as AgentSchedule,
@@ -379,5 +453,8 @@ export declare namespace Schedules {
     type ScheduleUpdateParams as ScheduleUpdateParams,
     type ScheduleListParams as ScheduleListParams,
     type ScheduleDeleteParams as ScheduleDeleteParams,
+    type ScheduleArchiveParams as ScheduleArchiveParams,
+    type SchedulePauseParams as SchedulePauseParams,
+    type ScheduleResumeParams as ScheduleResumeParams,
   };
 }