@cadenya/cadenya 0.82.0 → 0.85.0

package/src/resources/objectives/objectives.ts

@@ -5,6 +5,7 @@ import * as ObjectivesAPI from './objectives';
 import * as AccountAPI from '../account';
 import * as Shared from '../shared';
 import * as AgentsAPI from '../agents/agents';
+import * as SchedulesAPI from '../agents/schedules';
 import * as VariationsAPI from '../agents/variations';
 import * as FeedbackAPI from './feedback';
 import {
@@ -89,7 +90,7 @@ export class Objectives extends APIResource {
     options?: RequestOptions,
   ): APIPromise<Objective> {
     const { workspaceId, ...body } = params;
-    return this._client.post(path`/v1/workspaces/${workspaceId}/objectives/${objectiveID}/cancel`, {
+    return this._client.post(path`/v1/workspaces/${workspaceId}/objectives/${objectiveID}:cancel`, {
       body,
       ...options,
     });
@@ -105,7 +106,7 @@ export class Objectives extends APIResource {
     options?: RequestOptions,
   ): APIPromise<ObjectiveCompactResponse> {
     const { workspaceId, ...body } = params;
-    return this._client.post(path`/v1/workspaces/${workspaceId}/objectives/${objectiveID}/compact`, {
+    return this._client.post(path`/v1/workspaces/${workspaceId}/objectives/${objectiveID}:compact`, {
       body,
       ...options,
     });
@@ -120,7 +121,7 @@ export class Objectives extends APIResource {
     options?: RequestOptions,
   ): APIPromise<ObjectiveContinueResponse> {
     const { workspaceId, ...body } = params;
-    return this._client.post(path`/v1/workspaces/${workspaceId}/objectives/${objectiveID}/continue`, {
+    return this._client.post(path`/v1/workspaces/${workspaceId}/objectives/${objectiveID}:continue`, {
       body,
       ...options,
     });
@@ -276,8 +277,23 @@ export interface MemoryReference {
   memoryLayerId?: string;
 }
 
+/**
+ * Objective is the data for an objective. It contains the snapshotted fields for
+ * the selected agent and variation. Secrets are returned only with their names,
+ * and the output definition is copied from the agent's configuration.
+ */
 export interface Objective {
-  data: ObjectiveData;
+  /**
+   * ObjectiveConfigSnapshot is the point-in-time snapshot of the agent, variation,
+   * and (when applicable) schedule that an objective was started with.
+   */
+  configSnapshot: ObjectiveConfigSnapshot;
+
+  /**
+   * The initial message sent to the agent. This becomes the first user message in
+   * the LLM chat history.
+   */
+  initialMessage: string;
 
   /**
    * Metadata for ephemeral operations and activities (e.g., objectives, executions,
@@ -285,7 +301,27 @@ export interface Objective {
    */
   metadata: Shared.OperationMetadata;
 
-  status: ObjectiveStatus;
+  /**
+   * The current lifecycle state of the objective.
+   */
+  state:
+    | 'STATE_UNSPECIFIED'
+    | 'STATE_PENDING'
+    | 'STATE_RUNNING'
+    | 'STATE_WAITING'
+    | 'STATE_FAILED'
+    | 'STATE_CANCELLED'
+    | 'STATE_FINALIZED';
+
+  /**
+   * system_prompt is read-only, derived from the selected variation's prompt
+   */
+  systemPrompt: string;
+
+  /**
+   * Arbitrary data for the objective
+   */
+  data?: { [key: string]: unknown };
 
   /**
    * ObjectiveInfo provides read-only aggregated statistics about an objective's
@@ -294,11 +330,69 @@ export interface Objective {
   info?: ObjectiveInfo;
 
   /**
-   * Read-only list of the last five windows of execution for this objective, ordered
-   * by most recent first. Is only included in singular RPC calls (GetObjective, for
-   * example).
+   * Memory layers/entries to push onto this objective's memory stack on top of the
+   * baseline stack inherited from the selected variation.
+   *
+   * Array order is push order: the first element sits lower in the objective's
+   * contribution to the stack; the LAST element ends up on top of the effective
+   * stack. Entries pinned via memory_entry_id behave as single-entry layers at their
+   * position.
+   *
+   * System-managed layers (e.g., episodic) cannot be referenced here; they attach
+   * themselves automatically based on episodic_key.
+   *
+   * Stack size cap: the TOTAL effective stack (variation's memory layers
+   *
+   * - this field) must not exceed 10 entries. A request that would produce an
+   *   effective stack larger than 10 is rejected with InvalidArgument.
+   */
+  memoryStack?: Array<MemoryReference>;
+
+  /**
+   * The output of the objective, populated when the objective completes. Will match
+   * the schema of output_json_schema or output_json_inferred. This will only be set
+   * if the state of the objective is set to STATE_FINALIZED
+   */
+  output?: { [key: string]: unknown };
+
+  /**
+   * A parent objective means the objective was spawned off using a separate agent to
+   * complete an objective
+   */
+  parentObjectiveId?: string;
+
+  /**
+   * Secrets that can be used in the headers for tool calls using the secret
+   * interpolation format.
+   */
+  secrets?: Array<ObjectiveSecret>;
+
+  /**
+   * Optional human-readable detail about the current state (e.g. a failure reason).
+   */
+  stateMessage?: string;
+}
+
+/**
+ * ObjectiveConfigSnapshot is the point-in-time snapshot of the agent, variation,
+ * and (when applicable) schedule that an objective was started with.
+ */
+export interface ObjectiveConfigSnapshot {
+  /**
+   * Agent resource
+   */
+  agent?: AgentsAPI.Agent;
+
+  /**
+   * AgentSchedule resource — a recurring trigger attached to an agent that creates
+   * objectives on its cadence.
+   */
+  agentSchedule?: SchedulesAPI.AgentSchedule;
+
+  /**
+   * AgentVariation resource
    */
-  lastFiveWindows?: Array<ObjectiveContextWindow>;
+  agentVariation?: VariationsAPI.AgentVariation;
 }
 
 /**
@@ -367,91 +461,6 @@ export interface ObjectiveContextWindowData {
   sequence?: number;
 }
 
-export interface ObjectiveData {
-  /**
-   * Agent resource
-   */
-  agent?: AgentsAPI.Agent;
-
-  /**
-   * Represents a dynamically typed value which can be either null, a number, a
-   * string, a boolean, a recursive struct value, or a list of values.
-   */
-  data?: unknown;
-
-  /**
-   * The initial message sent to the agent. This becomes the first user message in
-   * the LLM chat history.
-   */
-  initialMessage?: string;
-
-  /**
-   * Memory layers/entries to push onto this objective's memory stack on top of the
-   * baseline stack inherited from the selected variation.
-   *
-   * Array order is push order: the first element sits lower in the objective's
-   * contribution to the stack; the LAST element ends up on top of the effective
-   * stack. Entries pinned via memory_entry_id behave as single-entry layers at their
-   * position.
-   *
-   * System-managed layers (e.g., episodic) cannot be referenced here; they attach
-   * themselves automatically based on episodic_key.
-   *
-   * Stack size cap: the TOTAL effective stack (variation's memory layers
-   *
-   * - this field) must not exceed 10 entries. A request that would produce an
-   *   effective stack larger than 10 is rejected with InvalidArgument.
-   */
-  memoryStack?: Array<MemoryReference>;
-
-  /**
-   * The output of the objective, populated when the objective completes. Will match
-   * the schema of output_json_schema or output_json_inferred.
-   */
-  output?: { [key: string]: unknown };
-
-  /**
-   * Snapshot of the agent spec's output_definition at objective creation time. When
-   * present, the objective will run an extraction step after the LLM finishes.
-   */
-  outputDefinition?: { [key: string]: unknown };
-
-  /**
-   * A parent objective means the objective was spawned off using a separate agent to
-   * complete an objective
-   */
-  parentObjectiveId?: string;
-
-  /**
-   * Secrets that can be used in the headers for tool calls using the secret
-   * interpolation format.
-   */
-  secrets?: Array<ObjectiveDataSecret>;
-
-  /**
-   * ID of the AgentSchedule that produced this objective, when applicable. Populated
-   * when the objective is created from a schedule fire; empty when the objective was
-   * created via CreateObjective directly.
-   */
-  sourceScheduleId?: string;
-
-  /**
-   * system_prompt is read-only, derived from the selected variation's prompt
-   */
-  systemPrompt?: string;
-
-  /**
-   * AgentVariation resource
-   */
-  variation?: VariationsAPI.AgentVariation;
-}
-
-export interface ObjectiveDataSecret {
-  name?: string;
-
-  value?: string;
-}
-
 export interface ObjectiveError {
   message?: string;
 
@@ -622,67 +631,66 @@ export interface ObjectiveInfo {
   /**
    * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
    */
-  agent?: Shared.ResourceMetadata;
+  agent: Shared.ResourceMetadata;
 
   /**
    * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
    */
-  agentVariation?: Shared.ResourceMetadata;
+  agentVariation: Shared.ResourceMetadata;
 
   /**
    * A profile identifies a user or non-human principal (such as an API key) at the
    * account level. Profiles are account-scoped and can be granted access to multiple
    * workspaces.
    */
-  createdBy?: AccountAPI.Profile;
+  createdBy: AccountAPI.Profile;
+
+  /**
+   * ID of the objective's current (most recent) context window. Hydrated on demand;
+   * empty when the objective has not yet produced a context window.
+   */
+  currentContextWindowId: string;
 
   /**
    * The effective memory stack at objective creation time, flattened from the
-   * variation's baseline plus ObjectiveData.memory_stack. Order is push order (last
-   * = top). Returned on reads so clients can see exactly what stack the objective is
+   * variation's baseline plus Objective.memory_stack. Order is push order (last =
+   * top). Returned on reads so clients can see exactly what stack the objective is
    * using without having to re-join variation state.
    */
-  effectiveMemoryStack?: Array<MemoryReference>;
+  effectiveMemoryStack: Array<MemoryReference>;
 
   /**
    * Total number of context windows that this objective has generated
    */
-  totalContextWindows?: number;
+  totalContextWindows: number;
 
   /**
    * Total number of events generated during this objective's execution
    */
-  totalEvents?: number;
+  totalEvents: number;
 
   /**
    * Total input tokens consumed across all LLM completions across all context
    * windows
    */
-  totalInputTokens?: number;
+  totalInputTokens: number;
+
+  totalIterations: number;
 
   /**
    * Total output tokens generated across all LLM completions across all context
    * windows
    */
-  totalOutputTokens?: number;
+  totalOutputTokens: number;
 
   /**
    * Total number of tool calls made during execution
    */
-  totalToolCalls?: number;
+  totalToolCalls: number;
 }
 
-export interface ObjectiveStatus {
-  state:
-    | 'STATE_UNSPECIFIED'
-    | 'STATE_PENDING'
-    | 'STATE_RUNNING'
-    | 'STATE_WAITING'
-    | 'STATE_FAILED'
-    | 'STATE_CANCELLED'
-    | 'STATE_FINALIZED';
-
-  message?: string;
+export interface ObjectiveSecret {
+  name?: string;
 }
 
 export interface SubAgentSpawned {
@@ -830,7 +838,37 @@ export interface ObjectiveListEventsResponse {
 export interface ObjectiveCreateParams {
   agentId: string;
 
-  data: ObjectiveData;
+  /**
+   * Arbitrary data for the objective. May be used in liquid templates for prompts
+   * configured on the agent variation
+   */
+  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.
+   */
+  initialMessage?: string;
+
+  /**
+   * Memory layers/entries to push onto this objective's memory stack on top of the
+   * baseline stack inherited from the selected variation.
+   *
+   * Array order is push order: the first element sits lower in the objective's
+   * contribution to the stack; the LAST element ends up on top of the effective
+   * stack. Entries pinned via memory_entry_id behave as single-entry layers at their
+   * position.
+   *
+   * System-managed layers (e.g., episodic) cannot be referenced here; they attach
+   * themselves automatically based on episodic_key.
+   *
+   * Stack size cap: the TOTAL effective stack (variation's memory layers
+   *
+   * - this field) must not exceed 10 entries. A request that would produce an
+   *   effective stack larger than 10 is rejected with InvalidArgument.
+   */
+  memoryStack?: Array<MemoryReference>;
 
   /**
    * CreateOperationMetadata contains the user-provided fields for creating an
@@ -839,6 +877,12 @@ export interface ObjectiveCreateParams {
    */
   metadata?: Shared.CreateOperationMetadata;
 
+  /**
+   * Secrets that can be used in the headers for tool calls using the secret
+   * interpolation format.
+   */
+  secrets?: Array<ObjectiveCreateParams.Secret>;
+
   /**
    * Optional explicit variation selection. Overrides the agent's
    * variation_selection_mode.
@@ -846,6 +890,14 @@ export interface ObjectiveCreateParams {
   variationId?: string;
 }
 
+export namespace ObjectiveCreateParams {
+  export interface Secret {
+    name?: string;
+
+    value?: string;
+  }
+}
+
 export interface ObjectiveRetrieveParams {
   workspaceId: string;
 }
@@ -1004,16 +1056,15 @@ export declare namespace Objectives {
     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,

package/src/resources/objectives/tool-calls.ts

@@ -36,8 +36,8 @@ export class ToolCalls extends APIResource {
     options?: RequestOptions,
   ): APIPromise<ObjectiveToolCall> {
     const { workspaceId, objectiveId, ...body } = params;
-    return this._client.put(
-      path`/v1/workspaces/${workspaceId}/objectives/${objectiveId}/tool_calls/${toolCallID}/approve`,
+    return this._client.post(
+      path`/v1/workspaces/${workspaceId}/objectives/${objectiveId}/tool_calls/${toolCallID}:approve`,
       { body, ...options },
     );
   }
@@ -53,8 +53,8 @@ export class ToolCalls extends APIResource {
     options?: RequestOptions,
   ): APIPromise<ObjectiveToolCall> {
     const { workspaceId, objectiveId, ...body } = params;
-    return this._client.put(
-      path`/v1/workspaces/${workspaceId}/objectives/${objectiveId}/tool_calls/${toolCallID}/deny`,
+    return this._client.post(
+      path`/v1/workspaces/${workspaceId}/objectives/${objectiveId}/tool_calls/${toolCallID}:deny`,
       { body, ...options },
     );
   }
@@ -70,6 +70,13 @@ export type ObjectiveToolCallsCursorPagination = CursorPagination<ObjectiveToolC
 export interface ObjectiveToolCall {
   data: ObjectiveToolCallData;
 
+  executionStatus:
+    | 'TOOL_CALL_EXECUTION_STATUS_UNSPECIFIED'
+    | 'TOOL_CALL_EXECUTION_STATUS_PENDING'
+    | 'TOOL_CALL_EXECUTION_STATUS_RUNNING'
+    | 'TOOL_CALL_EXECUTION_STATUS_COMPLETED'
+    | 'TOOL_CALL_EXECUTION_STATUS_ERRORED';
+
   /**
    * Metadata for ephemeral operations and activities (e.g., objectives, executions,
    * runs)
@@ -86,13 +93,6 @@ export interface ObjectiveToolCall {
     | 'TOOL_CALL_STATUS_APPROVED'
     | 'TOOL_CALL_STATUS_DENIED';
 
-  executionStatus?:
-    | 'TOOL_CALL_EXECUTION_STATUS_UNSPECIFIED'
-    | 'TOOL_CALL_EXECUTION_STATUS_PENDING'
-    | 'TOOL_CALL_EXECUTION_STATUS_RUNNING'
-    | 'TOOL_CALL_EXECUTION_STATUS_COMPLETED'
-    | 'TOOL_CALL_EXECUTION_STATUS_ERRORED';
-
   info?: ObjectiveToolCallInfo;
 }
 

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,
   };
 }