@cadenya/cadenya 0.84.0 → 0.86.0

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;
 
@@ -142,12 +186,6 @@ export interface AgentScheduleInfo {
  * AgentScheduleSpec is the user-provided configuration for a schedule.
  */
 export interface AgentScheduleSpec {
-  /**
-   * The initial message passed to CreateObjective on each fire. Becomes the first
-   * user message in the objective's chat history.
-   */
-  initialMessage: string;
-
   /**
    * Schedule defines WHEN the schedule fires. Temporal-style structured form: a list
    * of calendar rules (wall-clock) and/or interval rules (duration), OR'd together.
@@ -161,19 +199,24 @@ export interface AgentScheduleSpec {
    */
   data?: unknown;
 
+  /**
+   * Optional initial message passed to CreateObjective on each fire. Becomes the
+   * first user message in the objective's chat history. When unset, the fired
+   * objective defers to the selected variation's user_message_template.
+   */
+  initialMessage?: string;
+
   /**
    * What to do when the previous run is still in flight. Defaults to SKIP.
    */
   overlapPolicy?: 'OVERLAP_POLICY_UNSPECIFIED' | 'OVERLAP_POLICY_ALLOW' | 'OVERLAP_POLICY_SKIP';
 
   /**
-   * Lifecycle. Defaults to ACTIVE on create when unspecified.
+   * Optional data rendered into the variation's user_message_template when each
+   * fired objective is created. Separate from `data`, which renders the system
+   * prompt template.
    */
-  status?:
-    | 'AGENT_SCHEDULE_STATUS_UNSPECIFIED'
-    | 'AGENT_SCHEDULE_STATUS_ACTIVE'
-    | 'AGENT_SCHEDULE_STATUS_PAUSED'
-    | 'AGENT_SCHEDULE_STATUS_ARCHIVED';
+  userData?: unknown;
 
   /**
    * Optional explicit variation. When unset, the agent's variation_selection_mode
@@ -364,6 +407,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 +461,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,
   };
 }

package/src/resources/agents/variations.ts

@@ -291,9 +291,19 @@ export interface AgentVariationSpec {
   progressiveDiscovery?: AgentVariationSpecProgressiveDiscovery;
 
   /**
-   * The system prompt for this variation
+   * Liquid template for the system prompt of objectives using this variation.
+   * Rendered with CreateObjectiveRequest.data into Objective.system_prompt.
    */
-  prompt?: string;
+  systemPromptTemplate?: string;
+
+  /**
+   * Liquid template for the initial user message of objectives using this variation.
+   * Rendered with CreateObjectiveRequest.user_data and becomes the first user
+   * message in the LLM chat history. CreateObjectiveRequest.initial_message, when
+   * set, overrides the rendered result. If neither this template nor initial_message
+   * is present, objective creation is rejected with InvalidArgument.
+   */
+  userMessageTemplate?: string;
 
   /**
    * Weight for weighted random selection (>= 0). P(v) = v.weight / sum(all_weights).

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

@@ -20,6 +20,7 @@ export {
   type APIKeyCreateParams,
   type APIKeyUpdateParams,
   type APIKeyListParams,
+  type APIKeyRotateParams,
   type APIKeysCursorPagination,
 } from './api-keys/api-keys';
 export {
@@ -43,6 +44,10 @@ export {
   type AgentUpdateParams,
   type AgentListParams,
   type AgentDeleteParams,
+  type AgentArchiveParams,
+  type AgentPublishParams,
+  type AgentUnarchiveParams,
+  type AgentUnpublishParams,
   type AgentsCursorPagination,
 } from './agents/agents';
 export {
@@ -84,7 +89,8 @@ export {
   type ModelSwapResponse,
   type ModelRetrieveParams,
   type ModelListParams,
-  type ModelSetStatusParams,
+  type ModelDisableParams,
+  type ModelEnableParams,
   type ModelSwapParams,
   type ModelsCursorPagination,
 } from './models';
@@ -159,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';

package/src/resources/models.ts

@@ -36,11 +36,21 @@ 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 });
   }
 
   /**
@@ -68,6 +78,12 @@ export interface Model {
    */
   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.
    */
@@ -127,11 +143,6 @@ 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';
 }
 
 /**
@@ -181,21 +192,23 @@ 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 {
@@ -227,7 +240,8 @@ export declare namespace Models {
     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/objectives.ts

@@ -371,6 +371,11 @@ export interface Objective {
    * Optional human-readable detail about the current state (e.g. a failure reason).
    */
   stateMessage?: string;
+
+  /**
+   * Arbitrary data used to render the variation's user_message_template
+   */
+  userData?: { [key: string]: unknown };
 }
 
 /**
@@ -845,9 +850,11 @@ export interface ObjectiveCreateParams {
   data: { [key: string]: unknown };
 
   /**
-   * Optional override for initial message sent to the agent. This becomes the first
-   * user message in the LLM chat history. The agent variation is used to set this if
-   * not present.
+   * Optional override for the initial message sent to the agent. This becomes the
+   * first user message in the LLM chat history. When not set, the selected
+   * variation's user_message_template is rendered with user_data instead. If neither
+   * this field nor a user_message_template is present, the request is rejected with
+   * InvalidArgument.
    */
   initialMessage?: string;
 
@@ -883,6 +890,13 @@ export interface ObjectiveCreateParams {
    */
   secrets?: Array<ObjectiveCreateParams.Secret>;
 
+  /**
+   * Arbitrary data rendered into the selected variation's user_message_template
+   * (liquid) to produce the initial user message. Separate from `data`, which
+   * renders the system prompt template.
+   */
+  userData?: { [key: string]: unknown };
+
   /**
    * Optional explicit variation selection. Overrides the agent's
    * variation_selection_mode.

package/src/resources/shared.ts

@@ -197,6 +197,11 @@ export interface ResourceMetadata {
    * {"environment": "production", "team": "platform", "version": "v2"}
    */
   labels?: { [key: string]: string };
+
+  /**
+   * Timestamp when this resource was last updated
+   */
+  updatedAt?: string;
 }
 
 /**

package/src/resources/tool-sets/index.ts

@@ -24,8 +24,10 @@ export {
   type ToolSetUpdateParams,
   type ToolSetListParams,
   type ToolSetDeleteParams,
+  type ToolSetArchiveParams,
   type ToolSetGetOpenAPISpecParams,
   type ToolSetListEventsParams,
+  type ToolSetUnarchiveParams,
   type ToolSetsCursorPagination,
   type ToolSetEventsCursorPagination,
 } from './tool-sets';
@@ -43,5 +45,7 @@ export {
   type ToolUpdateParams,
   type ToolListParams,
   type ToolDeleteParams,
+  type ToolOmitParams,
+  type ToolRestoreParams,
   type ToolsCursorPagination,
 } from './tools';

package/src/resources/tool-sets/tool-sets.ts

@@ -13,6 +13,8 @@ import {
   ToolDeleteParams,
   ToolInfo,
   ToolListParams,
+  ToolOmitParams,
+  ToolRestoreParams,
   ToolRetrieveParams,
   ToolSpec,
   ToolSpecConfig,
@@ -56,7 +58,7 @@ export class ToolSets extends APIResource {
    */
   update(id: string, params: ToolSetUpdateParams, options?: RequestOptions): APIPromise<ToolSet> {
     const { workspaceId, ...body } = params;
-    return this._client.put(path`/v1/workspaces/${workspaceId}/tool_sets/${id}`, { body, ...options });
+    return this._client.patch(path`/v1/workspaces/${workspaceId}/tool_sets/${id}`, { body, ...options });
   }
 
   /**
@@ -84,6 +86,21 @@ export class ToolSets extends APIResource {
     });
   }
 
+  /**
+   * Transitions a tool set to STATE_ARCHIVED. Syncing stops, the tool set is hidden
+   * from list results, its tools are no longer offered to objectives, and new
+   * variation assignments are rejected. Existing assignments are retained, and
+   * history is preserved — unlike delete, archiving works while the tool set is
+   * still assigned to agent variations.
+   */
+  archive(id: string, params: ToolSetArchiveParams, options?: RequestOptions): APIPromise<ToolSet> {
+    const { workspaceId, ...body } = params;
+    return this._client.post(path`/v1/workspaces/${workspaceId}/tool_sets/${id}:archive`, {
+      body,
+      ...options,
+    });
+  }
+
   /**
    * Retrieves the current OpenAPI specification JSON that has been consumed by the
    * tool set. Only applicable to tool sets using the OpenAPI adapter.
@@ -112,6 +129,19 @@ export class ToolSets extends APIResource {
       { query, ...options },
     );
   }
+
+  /**
+   * Transitions an archived tool set back to STATE_ACTIVE. Managed tool sets resume
+   * syncing on their next cycle and their tools become available to objectives
+   * again.
+   */
+  unarchive(id: string, params: ToolSetUnarchiveParams, options?: RequestOptions): APIPromise<ToolSet> {
+    const { workspaceId, ...body } = params;
+    return this._client.post(path`/v1/workspaces/${workspaceId}/tool_sets/${id}:unarchive`, {
+      body,
+      ...options,
+    });
+  }
 }
 
 export type ToolSetsCursorPagination = CursorPagination<ToolSet>;
@@ -222,6 +252,13 @@ export interface ToolSet {
 
   spec: ToolSetSpec;
 
+  /**
+   * The current lifecycle state of the tool set. Output only. Tool sets are created
+   * STATE_ACTIVE; use the :archive and :unarchive actions to transition between
+   * states.
+   */
+  state: 'STATE_UNSPECIFIED' | 'STATE_ACTIVE' | 'STATE_ARCHIVED';
+
   /**
    * Tool set information
    */
@@ -470,6 +507,12 @@ export interface ToolSetListParams extends CursorPaginationParams {
    * Sort order for results (asc or desc by creation time)
    */
   sortOrder?: string;
+
+  /**
+   * Filter by tool set lifecycle state. Defaults to STATE_ACTIVE when unspecified;
+   * pass STATE_ARCHIVED to list archived tool sets.
+   */
+  state?: 'STATE_UNSPECIFIED' | 'STATE_ACTIVE' | 'STATE_ARCHIVED';
 }
 
 export interface ToolSetDeleteParams {
@@ -479,6 +522,13 @@ export interface ToolSetDeleteParams {
   workspaceId: string;
 }
 
+export interface ToolSetArchiveParams {
+  /**
+   * Workspace ID.
+   */
+  workspaceId: string;
+}
+
 export interface ToolSetGetOpenAPISpecParams {
   /**
    * Workspace ID.
@@ -503,6 +553,13 @@ export interface ToolSetListEventsParams extends CursorPaginationParams {
   sortOrder?: string;
 }
 
+export interface ToolSetUnarchiveParams {
+  /**
+   * Workspace ID.
+   */
+  workspaceId: string;
+}
+
 ToolSets.Tools = Tools;
 
 export declare namespace ToolSets {
@@ -531,8 +588,10 @@ export declare namespace ToolSets {
     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 {
@@ -550,5 +609,7 @@ export declare namespace ToolSets {
     type ToolUpdateParams as ToolUpdateParams,
     type ToolListParams as ToolListParams,
     type ToolDeleteParams as ToolDeleteParams,
+    type ToolOmitParams as ToolOmitParams,
+    type ToolRestoreParams as ToolRestoreParams,
   };
 }