@cadenya/cadenya 0.124.0 → 0.125.0

package/resources/objectives/objectives.d.ts

@@ -10,7 +10,7 @@ import { Feedback, FeedbackCreateParams, FeedbackListParams, ObjectiveFeedback,
 import * as TasksAPI from "./tasks.js";
 import { ObjectiveTask, ObjectiveTaskData, ObjectiveTasksCursorPagination, TaskListParams, TaskRetrieveParams, Tasks } from "./tasks.js";
 import * as ToolCallsAPI from "./tool-calls.js";
-import { ObjectiveToolCall, ObjectiveToolCallData, ObjectiveToolCallInfo, ObjectiveToolCallResult, ObjectiveToolCallResultAudioBlock, ObjectiveToolCallResultContentBlock, ObjectiveToolCallResultImageBlock, ObjectiveToolCallResultTextBlock, ObjectiveToolCallWithResult, ObjectiveToolCallsCursorPagination, ResolvedSecret, SetToolCallContentRequestAudioBlock, SetToolCallContentRequestContentBlock, SetToolCallContentRequestImageBlock, SetToolCallContentRequestTextBlock, ToolCallApproveParams, ToolCallDenyParams, ToolCallListParams, ToolCallRetrieveParams, ToolCallSetContentParams, ToolCalls } from "./tool-calls.js";
+import { ObjectiveToolCall, ObjectiveToolCallData, ObjectiveToolCallInfo, ObjectiveToolCallResult, ObjectiveToolCallResultAudioBlock, ObjectiveToolCallResultContentBlock, ObjectiveToolCallResultContentBlockAudio, ObjectiveToolCallResultContentBlockImage, ObjectiveToolCallResultContentBlockText, ObjectiveToolCallResultImageBlock, ObjectiveToolCallResultTextBlock, ObjectiveToolCallWithResult, ObjectiveToolCallsCursorPagination, ResolvedSecret, SetToolCallContentRequestAudioBlock, SetToolCallContentRequestContentBlock, SetToolCallContentRequestContentBlockAudio, SetToolCallContentRequestContentBlockImage, SetToolCallContentRequestContentBlockText, SetToolCallContentRequestImageBlock, SetToolCallContentRequestTextBlock, ToolCallApproveParams, ToolCallDenyParams, ToolCallListParams, ToolCallRetrieveParams, ToolCallSetContentParams, ToolCalls } from "./tool-calls.js";
 import * as ToolsAPI from "./tools.js";
 import { ObjectiveTool, ObjectiveToolsCursorPagination, ToolListParams, Tools } from "./tools.js";
 import * as ToolSetsToolsAPI from "../tool-sets/tools.js";
@@ -25,50 +25,143 @@ export declare class Objectives extends APIResource {
     feedback: FeedbackAPI.Feedback;
     /**
      * Creates a new objective in the workspace
+     *
+     * @example
+     * ```ts
+     * const objective = await client.objectives.create({
+     *   workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q',
+     *   agentId: 'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
+     *   systemPromptData: { foo: 'bar' },
+     * });
+     * ```
      */
-    create(workspaceID: string, body: ObjectiveCreateParams, options?: RequestOptions): APIPromise<Objective>;
+    create(params: ObjectiveCreateParams, options?: RequestOptions): APIPromise<Objective>;
     /**
      * Retrieves an objective by ID from the workspace
+     *
+     * @example
+     * ```ts
+     * const objective = await client.objectives.retrieve(
+     *   'obj_01HXKD2E5NQM3T9AYWCFQAZGFV',
+     *   { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
+     * );
+     * ```
      */
-    retrieve(id: string, params: ObjectiveRetrieveParams, options?: RequestOptions): APIPromise<Objective>;
+    retrieve(id: string, params?: ObjectiveRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<Objective>;
     /**
      * Lists all objectives in the workspace
-     */
-    list(workspaceID: string, query?: ObjectiveListParams | null | undefined, options?: RequestOptions): PagePromise<ObjectivesCursorPagination, Objective>;
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const objective of client.objectives.list({
+     *   workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q',
+     * })) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(params?: ObjectiveListParams | null | undefined, options?: RequestOptions): PagePromise<ObjectivesCursorPagination, Objective>;
     /**
      * Cancels a running or pending objective. The objective's state will be set to
      * STATE_CANCELLED.
+     *
+     * @example
+     * ```ts
+     * const objective = await client.objectives.cancel(
+     *   'obj_01HXKD2E5NQM3T9AYWCFQAZGFV',
+     *   { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
+     * );
+     * ```
      */
     cancel(objectiveID: string, params: ObjectiveCancelParams, options?: RequestOptions): APIPromise<Objective>;
     /**
      * Triggers compaction on a running objective. Optionally override the variation's
      * compaction config.
+     *
+     * @example
+     * ```ts
+     * const response = await client.objectives.compact(
+     *   'obj_01HXKD2E5NQM3T9AYWCFQAZGFV',
+     *   { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
+     * );
+     * ```
      */
     compact(objectiveID: string, params: ObjectiveCompactParams, options?: RequestOptions): APIPromise<ObjectiveCompactResponse>;
     /**
      * Continues an objective that has completed
+     *
+     * @example
+     * ```ts
+     * const objectiveEvent = await client.objectives.continue(
+     *   'obj_01HXKD2E5NQM3T9AYWCFQAZGFV',
+     *   {
+     *     workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q',
+     *     message: 'message',
+     *   },
+     * );
+     * ```
      */
     continue(objectiveID: string, params: ObjectiveContinueParams, options?: RequestOptions): APIPromise<ObjectiveEvent>;
     /**
      * Read-only list of the last five windows of execution for this objective, ordered
      * by most recent first
-     */
-    listContextWindows(objectiveID: string, params: ObjectiveListContextWindowsParams, options?: RequestOptions): PagePromise<ObjectiveContextWindowsCursorPagination, ObjectiveContextWindow>;
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const objectiveContextWindow of client.objectives.listContextWindows(
+     *   'obj_01HXKD2E5NQM3T9AYWCFQAZGFV',
+     *   { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    listContextWindows(objectiveID: string, params?: ObjectiveListContextWindowsParams | null | undefined, options?: RequestOptions): PagePromise<ObjectiveContextWindowsCursorPagination, ObjectiveContextWindow>;
     /**
      * Lists all events for an objective
-     */
-    listEvents(objectiveID: string, params: ObjectiveListEventsParams, options?: RequestOptions): PagePromise<ObjectiveEventsCursorPagination, ObjectiveEvent>;
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const objectiveEvent of client.objectives.listEvents(
+     *   'obj_01HXKD2E5NQM3T9AYWCFQAZGFV',
+     *   { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    listEvents(objectiveID: string, params?: ObjectiveListEventsParams | null | undefined, options?: RequestOptions): PagePromise<ObjectiveEventsCursorPagination, ObjectiveEvent>;
     /**
      * Returns the context-usage breakdown measured for the objective's most recent
      * iteration: character lengths per context component (system prompt, memory
      * appendices, tool definitions, messages by role) alongside the iteration's input
      * token counts.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.objectives.retrieveDiagnostics(
+     *     'obj_01HXKD2E5NQM3T9AYWCFQAZGFV',
+     *     { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
+     *   );
+     * ```
      */
-    retrieveDiagnostics(objectiveID: string, params: ObjectiveRetrieveDiagnosticsParams, options?: RequestOptions): APIPromise<ObjectiveRetrieveDiagnosticsResponse>;
+    retrieveDiagnostics(objectiveID: string, params?: ObjectiveRetrieveDiagnosticsParams | null | undefined, options?: RequestOptions): APIPromise<ObjectiveRetrieveDiagnosticsResponse>;
     /**
      * Streams events for an objective in real-time using server-sent events (SSE)
-     */
-    streamEvents(objectiveID: string, params: ObjectiveStreamEventsParams, options?: RequestOptions): APIPromise<Stream<ObjectiveEvent>>;
+     *
+     * @example
+     * ```ts
+     * const objectiveEvent = await client.objectives.streamEvents(
+     *   'obj_01HXKD2E5NQM3T9AYWCFQAZGFV',
+     *   { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
+     * );
+     * ```
+     */
+    streamEvents(objectiveID: string, params?: ObjectiveStreamEventsParams | undefined, options?: RequestOptions): APIPromise<Stream<ObjectiveEvent>>;
 }
 export type ObjectivesCursorPagination = CursorPagination<Objective>;
 export type ObjectiveContextWindowsCursorPagination = CursorPagination<ObjectiveContextWindow>;
@@ -94,19 +187,27 @@ export interface AssistantToolCall {
  * user-defined tool (IE: MCP, HTTP), another Agent (useful to separate context),
  * or a Cadenya Tool (one Cadenya provides).
  */
-export interface CallableTool {
+export type CallableTool = CallableToolTool | CallableToolAgent | CallableToolCadenyaProvidedTool;
+export interface CallableToolAgent {
     /**
      * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
      */
-    agent?: Shared.ResourceMetadata;
+    agent: Shared.ResourceMetadata;
+    type: 'agent';
+}
+export interface CallableToolCadenyaProvidedTool {
     /**
      * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
      */
-    cadenyaProvidedTool?: Shared.ResourceMetadata;
+    cadenyaProvidedTool: Shared.ResourceMetadata;
+    type: 'cadenyaProvidedTool';
+}
+export interface CallableToolTool {
     /**
      * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
      */
-    tool?: Shared.ResourceMetadata;
+    tool: Shared.ResourceMetadata;
+    type: 'tool';
 }
 /**
  * ContextLengths is the measured character length of each distinct component of an
@@ -205,6 +306,7 @@ export interface MemoryRead {
  * form (external_id:my-custom-id). The same applies to memory_entry_id when set.
  */
 export interface MemoryReference {
+    memoryLayerId: string;
     /**
      * When set, inserts only this entry from memory_layer_id into the cascade —
      * behaves as a single-entry layer (only this key resolves at this position). The
@@ -212,7 +314,6 @@ export interface MemoryReference {
      * InvalidArgument.
      */
     memoryEntryId?: string;
-    memoryLayerId?: string;
 }
 /**
  * Objective is the data for an objective. It contains the snapshotted fields for
@@ -312,7 +413,7 @@ export declare namespace Objective {
          * The caller-supplied episodic key. Objectives created with the same key (for the
          * same agent) share one episodic memory layer.
          */
-        key?: string;
+        key: string;
         /**
          * The episodic memory layer resolved (created or reused) for this objective's key.
          * Populated by the system at objective creation.
@@ -437,57 +538,21 @@ export interface ObjectiveEvent {
     contextWindowId?: string;
     info?: ObjectiveEventInfo;
 }
-export interface ObjectiveEventData {
-    assistantMessage?: AssistantMessage;
+export type ObjectiveEventData = ObjectiveEventDataUserMessage | ObjectiveEventDataToolApprovalRequested | ObjectiveEventDataToolApproved | ObjectiveEventDataToolDenied | ObjectiveEventDataToolCalled | ObjectiveEventDataError | ObjectiveEventDataAssistantMessage | ObjectiveEventDataToolResult | ObjectiveEventDataToolError | ObjectiveEventDataContextWindowCompacted | ObjectiveEventDataMemoryRead | ObjectiveEventDataCancelled | ObjectiveEventDataSubAgentSpawned | ObjectiveEventDataSubAgentUpdated | ObjectiveEventDataFinalized | ObjectiveEventDataNotice | ObjectiveEventDataTimedOut;
+export interface ObjectiveEventDataAssistantMessage {
+    assistantMessage: AssistantMessage;
+    type: 'assistantMessage';
+}
+export interface ObjectiveEventDataCancelled {
     /**
      * ObjectiveCancelled is the terminal event written when an objective is cancelled.
      * After this event, the objective is super-terminal: no further iterations,
      * compaction, or continuation are permitted.
      */
-    cancelled?: ObjectiveEventData.Cancelled;
-    contextWindowCompacted?: ContextWindowCompacted;
-    error?: ObjectiveError;
-    /**
-     * ObjectiveFinalized is the terminal event written when an objective is finalized.
-     * After this event, the objective is super-terminal: no further iterations,
-     * compaction, or continuation are permitted.
-     */
-    finalized?: ObjectiveEventData.Finalized;
-    /**
-     * MemoryRead is emitted each time the agent resolves a key against the memory
-     * cascade and loads an entry. Lookups that miss (key not found in any layer) do
-     * not emit this event.
-     */
-    memoryRead?: MemoryRead;
-    /**
-     * Notice is a non-terminal diagnostic emitted by the runtime when something
-     * noteworthy but non-fatal happens during an objective — for example a
-     * just-in-time tool set failing to load, or a previously loaded tool being dropped
-     * because it was archived. Notices carry no structured payload; they exist to make
-     * the objective timeline self-explanatory.
-     */
-    notice?: ObjectiveEventData.Notice;
-    subAgentSpawned?: SubAgentSpawned;
-    subAgentUpdated?: SubAgentUpdated;
-    /**
-     * ObjectiveTimedOut is the terminal event written when an objective is finalized
-     * by the inactivity sweep because it saw no activity (no user messages, no LLM
-     * calls) within its variation's inactivity timeout — or the system-wide 24 hour
-     * maximum when no timeout is configured. The objective produces no output. After
-     * this event, the objective is super-terminal: no further iterations, compaction,
-     * or continuation are permitted.
-     */
-    timedOut?: ObjectiveEventData.TimedOut;
-    toolApprovalRequested?: ToolApprovalRequested;
-    toolApproved?: ToolApproved;
-    toolCalled?: ToolCalled;
-    toolDenied?: ToolDenied;
-    toolError?: ToolError;
-    toolResult?: ToolResult;
-    type?: string;
-    userMessage?: UserMessage;
+    cancelled: ObjectiveEventDataCancelled.Cancelled;
+    type: 'cancelled';
 }
-export declare namespace ObjectiveEventData {
+export declare namespace ObjectiveEventDataCancelled {
     /**
      * ObjectiveCancelled is the terminal event written when an objective is cancelled.
      * After this event, the objective is super-terminal: no further iterations,
@@ -501,6 +566,25 @@ export declare namespace ObjectiveEventData {
          */
         message?: string;
     }
+}
+export interface ObjectiveEventDataContextWindowCompacted {
+    contextWindowCompacted: ContextWindowCompacted;
+    type: 'contextWindowCompacted';
+}
+export interface ObjectiveEventDataError {
+    error: ObjectiveError;
+    type: 'error';
+}
+export interface ObjectiveEventDataFinalized {
+    /**
+     * ObjectiveFinalized is the terminal event written when an objective is finalized.
+     * After this event, the objective is super-terminal: no further iterations,
+     * compaction, or continuation are permitted.
+     */
+    finalized: ObjectiveEventDataFinalized.Finalized;
+    type: 'finalized';
+}
+export declare namespace ObjectiveEventDataFinalized {
     /**
      * ObjectiveFinalized is the terminal event written when an objective is finalized.
      * After this event, the objective is super-terminal: no further iterations,
@@ -514,6 +598,28 @@ export declare namespace ObjectiveEventData {
          */
         output?: unknown;
     }
+}
+export interface ObjectiveEventDataMemoryRead {
+    /**
+     * MemoryRead is emitted each time the agent resolves a key against the memory
+     * cascade and loads an entry. Lookups that miss (key not found in any layer) do
+     * not emit this event.
+     */
+    memoryRead: MemoryRead;
+    type: 'memoryRead';
+}
+export interface ObjectiveEventDataNotice {
+    /**
+     * Notice is a non-terminal diagnostic emitted by the runtime when something
+     * noteworthy but non-fatal happens during an objective — for example a
+     * just-in-time tool set failing to load, or a previously loaded tool being dropped
+     * because it was archived. Notices carry no structured payload; they exist to make
+     * the objective timeline self-explanatory.
+     */
+    notice: ObjectiveEventDataNotice.Notice;
+    type: 'notice';
+}
+export declare namespace ObjectiveEventDataNotice {
     /**
      * Notice is a non-terminal diagnostic emitted by the runtime when something
      * noteworthy but non-fatal happens during an objective — for example a
@@ -534,6 +640,28 @@ export declare namespace ObjectiveEventData {
          */
         message?: string;
     }
+}
+export interface ObjectiveEventDataSubAgentSpawned {
+    subAgentSpawned: SubAgentSpawned;
+    type: 'subAgentSpawned';
+}
+export interface ObjectiveEventDataSubAgentUpdated {
+    subAgentUpdated: SubAgentUpdated;
+    type: 'subAgentUpdated';
+}
+export interface ObjectiveEventDataTimedOut {
+    /**
+     * ObjectiveTimedOut is the terminal event written when an objective is finalized
+     * by the inactivity sweep because it saw no activity (no user messages, no LLM
+     * calls) within its variation's inactivity timeout — or the system-wide 24 hour
+     * maximum when no timeout is configured. The objective produces no output. After
+     * this event, the objective is super-terminal: no further iterations, compaction,
+     * or continuation are permitted.
+     */
+    timedOut: ObjectiveEventDataTimedOut.TimedOut;
+    type: 'timedOut';
+}
+export declare namespace ObjectiveEventDataTimedOut {
     /**
      * ObjectiveTimedOut is the terminal event written when an objective is finalized
      * by the inactivity sweep because it saw no activity (no user messages, no LLM
@@ -550,6 +678,34 @@ export declare namespace ObjectiveEventData {
         message?: string;
     }
 }
+export interface ObjectiveEventDataToolApprovalRequested {
+    toolApprovalRequested: ToolApprovalRequested;
+    type: 'toolApprovalRequested';
+}
+export interface ObjectiveEventDataToolApproved {
+    toolApproved: ToolApproved;
+    type: 'toolApproved';
+}
+export interface ObjectiveEventDataToolCalled {
+    toolCalled: ToolCalled;
+    type: 'toolCalled';
+}
+export interface ObjectiveEventDataToolDenied {
+    toolDenied: ToolDenied;
+    type: 'toolDenied';
+}
+export interface ObjectiveEventDataToolError {
+    toolError: ToolError;
+    type: 'toolError';
+}
+export interface ObjectiveEventDataToolResult {
+    toolResult: ToolResult;
+    type: 'toolResult';
+}
+export interface ObjectiveEventDataUserMessage {
+    type: 'userMessage';
+    userMessage: UserMessage;
+}
 export interface ObjectiveEventInfo {
     /**
      * A profile identifies a user or non-human principal (such as an API key) at the
@@ -787,29 +943,36 @@ export interface ObjectiveRetrieveDiagnosticsResponse {
     diagnostics: ObjectiveDiagnostics;
 }
 export interface ObjectiveCreateParams {
+    /**
+     * Path param
+     */
+    workspaceId?: string;
+    /**
+     * Body param
+     */
     agentId: string;
     /**
-     * Arbitrary data rendered into the selected variation's system_prompt_template
-     * (liquid) to produce the objective's system prompt. If the agent has a
-     * system_prompt_data_schema, this must satisfy it.
+     * Body param: Arbitrary data rendered into the selected variation's
+     * system_prompt_template (liquid) to produce the objective's system prompt. If the
+     * agent has a system_prompt_data_schema, this must satisfy it.
      */
     systemPromptData: {
         [key: string]: unknown;
     };
     /**
-     * Episodic is used to configure the episodic memory for the objective
+     * Body param: Episodic is used to configure the episodic memory for the objective
      */
     episodicMemory?: ObjectiveCreateParams.EpisodicMemory;
     /**
-     * Optional explicit first user message for the LLM chat history. When not set, the
-     * selected variation's first_user_message_template is rendered with
+     * Body param: Optional explicit first user message for the LLM chat history. When
+     * not set, the selected variation's first_user_message_template is rendered with
      * first_user_message_data instead. If neither this field nor a
      * first_user_message_template is present, the request is rejected with
      * InvalidArgument.
      */
     firstUserMessage?: string;
     /**
-     * Arbitrary data rendered into the selected variation's
+     * Body param: Arbitrary data rendered into the selected variation's
      * first_user_message_template (liquid) to produce the first user message. Separate
      * from `system_prompt_data`, which renders the system prompt template.
      */
@@ -817,8 +980,9 @@ export interface ObjectiveCreateParams {
         [key: string]: unknown;
     };
     /**
-     * Memory layers/entries layered over the baseline cascade inherited from the
-     * selected variation — element-level rules over inherited styles, in CSS terms.
+     * Body param: Memory layers/entries layered over the baseline cascade inherited
+     * from the selected variation — element-level rules over inherited styles, in CSS
+     * terms.
      *
      * Array order is resolution order: EARLIER elements are more specific and are
      * consulted first. Entries pinned via memory_entry_id behave as single-entry
@@ -833,18 +997,18 @@ export interface ObjectiveCreateParams {
      */
     memoryCascade?: Array<MemoryReference>;
     /**
-     * CreateOperationMetadata contains the user-provided fields for creating an
-     * operation. Read-only fields (id, account_id, workspace_id, created_at,
-     * profile_id) are excluded since they are set by the server.
+     * Body param: CreateOperationMetadata contains the user-provided fields for
+     * creating an operation. Read-only fields (id, account_id, workspace_id,
+     * created_at, profile_id) are excluded since they are set by the server.
      */
     metadata?: Shared.CreateOperationMetadata;
     /**
-     * Secrets that can be used in the headers for tool calls using the secret
-     * interpolation format.
+     * Body param: 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
+     * Body param: Optional explicit variation selection. Overrides the agent's
      * variation_selection_mode.
      */
     variationId?: string;
@@ -858,7 +1022,7 @@ export declare namespace ObjectiveCreateParams {
          * The caller-supplied episodic key. Objectives created with the same key (for the
          * same agent) share one episodic memory layer.
          */
-        key?: string;
+        key: string;
     }
     interface Secret {
         name?: string;
@@ -866,39 +1030,46 @@ export declare namespace ObjectiveCreateParams {
     }
 }
 export interface ObjectiveRetrieveParams {
-    workspaceId: string;
+    workspaceId?: string;
 }
 export interface ObjectiveListParams extends CursorPaginationParams {
     /**
-     * Agent ID for filtering
+     * Path param
+     */
+    workspaceId?: string;
+    /**
+     * Query param: Agent ID for filtering
      */
     agentId?: string;
     /**
-     * Filter to objectives produced by a specific AgentSchedule. Accepts canonical
-     * as\_… form or external_id:<value> form.
+     * Query param: Filter to objectives produced by a specific AgentSchedule. Accepts
+     * canonical as\_… form or external_id:<value> form.
      */
     agentScheduleId?: string;
     /**
-     * When set to true you may use more of your alloted API rate-limit
+     * Query param: When set to true you may use more of your alloted API rate-limit
      */
     includeInfo?: boolean;
     /**
-     * Filters by metadata labels. Comma-separated key=value pairs, e.g.
+     * Query param: Filters by metadata labels. Comma-separated key=value pairs, e.g.
      * "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
      * semantics).
      */
     labels?: string;
     /**
-     * Optional filters
+     * Query param: Optional filters
      */
     parentObjectiveId?: string;
+    /**
+     * Query param
+     */
     profileId?: string;
     /**
-     * Sort order for results (asc or desc by creation time)
+     * Query param: Sort order for results (asc or desc by creation time)
      */
     sortOrder?: string;
     /**
-     * Filter by state
+     * Query param: Filter by state
      */
     state?: 'STATE_UNSPECIFIED' | 'STATE_PENDING' | 'STATE_RUNNING' | 'STATE_WAITING' | 'STATE_FAILED' | 'STATE_CANCELLED' | 'STATE_FINALIZED' | 'STATE_TIMED_OUT';
 }
@@ -906,7 +1077,7 @@ export interface ObjectiveCancelParams {
     /**
      * Path param
      */
-    workspaceId: string;
+    workspaceId?: string;
     /**
      * Body param: Optional reason for cancellation
      */
@@ -916,7 +1087,7 @@ export interface ObjectiveCompactParams {
     /**
      * Path param
      */
-    workspaceId: string;
+    workspaceId?: string;
     /**
      * Body param: CompactionConfig defines how context window compaction behaves for
      * objectives using this variation.
@@ -927,23 +1098,23 @@ export interface ObjectiveContinueParams {
     /**
      * Path param
      */
-    workspaceId: string;
+    workspaceId?: string;
+    /**
+     * Body param: The message to continue an objective that has completed (or you are
+     * enqueing)
+     */
+    message: string;
     /**
      * Body param: When set to true, the message will be enqueued for when the agent
      * loop is available to process it.
      */
     enqueue?: boolean;
-    /**
-     * Body param: The message to continue an objective that has completed (or you are
-     * enqueing)
-     */
-    message?: string;
 }
 export interface ObjectiveListContextWindowsParams extends CursorPaginationParams {
     /**
      * Path param
      */
-    workspaceId: string;
+    workspaceId?: string;
     /**
      * Query param: When set to true you may use more of your alloted API rate-limit
      */
@@ -959,7 +1130,7 @@ export interface ObjectiveListEventsParams extends CursorPaginationParams {
     /**
      * Path param
      */
-    workspaceId: string;
+    workspaceId?: string;
     /**
      * Query param: When set to true you may use more of your alloted API rate-limit
      */
@@ -984,15 +1155,15 @@ export interface ObjectiveListEventsParams extends CursorPaginationParams {
     windowId?: string;
 }
 export interface ObjectiveRetrieveDiagnosticsParams {
-    workspaceId: string;
+    workspaceId?: string;
 }
 export interface ObjectiveStreamEventsParams {
-    workspaceId: string;
+    workspaceId?: string;
 }
 export declare namespace Objectives {
-    export { type AssistantMessage as AssistantMessage, type AssistantToolCall as AssistantToolCall, type CallableTool as CallableTool, type ContextLengths as ContextLengths, type ContextWindowCompacted as ContextWindowCompacted, 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 ObjectiveDiagnostics as ObjectiveDiagnostics, type ObjectiveError as ObjectiveError, type ObjectiveEvent as ObjectiveEvent, type ObjectiveEventData as ObjectiveEventData, type ObjectiveEventInfo as ObjectiveEventInfo, type ObjectiveEventWebhookData as ObjectiveEventWebhookData, type ObjectiveInfo as ObjectiveInfo, type ObjectiveSecret as ObjectiveSecret, type SubAgentSpawned as SubAgentSpawned, type SubAgentUpdated as SubAgentUpdated, type ToolApprovalRequested as ToolApprovalRequested, type ToolApproved as ToolApproved, type ToolCalled as ToolCalled, type ToolDenied as ToolDenied, type ToolError as ToolError, type ToolResult as ToolResult, type UserMessage as UserMessage, type ObjectiveCompactResponse as ObjectiveCompactResponse, type ObjectiveRetrieveDiagnosticsResponse as ObjectiveRetrieveDiagnosticsResponse, type ObjectivesCursorPagination as ObjectivesCursorPagination, type ObjectiveContextWindowsCursorPagination as ObjectiveContextWindowsCursorPagination, type ObjectiveEventsCursorPagination as ObjectiveEventsCursorPagination, type ObjectiveCreateParams as ObjectiveCreateParams, type ObjectiveRetrieveParams as ObjectiveRetrieveParams, type ObjectiveListParams as ObjectiveListParams, type ObjectiveCancelParams as ObjectiveCancelParams, type ObjectiveCompactParams as ObjectiveCompactParams, type ObjectiveContinueParams as ObjectiveContinueParams, type ObjectiveListContextWindowsParams as ObjectiveListContextWindowsParams, type ObjectiveListEventsParams as ObjectiveListEventsParams, type ObjectiveRetrieveDiagnosticsParams as ObjectiveRetrieveDiagnosticsParams, type ObjectiveStreamEventsParams as ObjectiveStreamEventsParams, };
+    export { type AssistantMessage as AssistantMessage, type AssistantToolCall as AssistantToolCall, type CallableTool as CallableTool, type CallableToolAgent as CallableToolAgent, type CallableToolCadenyaProvidedTool as CallableToolCadenyaProvidedTool, type CallableToolTool as CallableToolTool, type ContextLengths as ContextLengths, type ContextWindowCompacted as ContextWindowCompacted, 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 ObjectiveDiagnostics as ObjectiveDiagnostics, type ObjectiveError as ObjectiveError, type ObjectiveEvent as ObjectiveEvent, type ObjectiveEventData as ObjectiveEventData, type ObjectiveEventDataAssistantMessage as ObjectiveEventDataAssistantMessage, type ObjectiveEventDataCancelled as ObjectiveEventDataCancelled, type ObjectiveEventDataContextWindowCompacted as ObjectiveEventDataContextWindowCompacted, type ObjectiveEventDataError as ObjectiveEventDataError, type ObjectiveEventDataFinalized as ObjectiveEventDataFinalized, type ObjectiveEventDataMemoryRead as ObjectiveEventDataMemoryRead, type ObjectiveEventDataNotice as ObjectiveEventDataNotice, type ObjectiveEventDataSubAgentSpawned as ObjectiveEventDataSubAgentSpawned, type ObjectiveEventDataSubAgentUpdated as ObjectiveEventDataSubAgentUpdated, type ObjectiveEventDataTimedOut as ObjectiveEventDataTimedOut, type ObjectiveEventDataToolApprovalRequested as ObjectiveEventDataToolApprovalRequested, type ObjectiveEventDataToolApproved as ObjectiveEventDataToolApproved, type ObjectiveEventDataToolCalled as ObjectiveEventDataToolCalled, type ObjectiveEventDataToolDenied as ObjectiveEventDataToolDenied, type ObjectiveEventDataToolError as ObjectiveEventDataToolError, type ObjectiveEventDataToolResult as ObjectiveEventDataToolResult, type ObjectiveEventDataUserMessage as ObjectiveEventDataUserMessage, type ObjectiveEventInfo as ObjectiveEventInfo, type ObjectiveEventWebhookData as ObjectiveEventWebhookData, type ObjectiveInfo as ObjectiveInfo, type ObjectiveSecret as ObjectiveSecret, type SubAgentSpawned as SubAgentSpawned, type SubAgentUpdated as SubAgentUpdated, type ToolApprovalRequested as ToolApprovalRequested, type ToolApproved as ToolApproved, type ToolCalled as ToolCalled, type ToolDenied as ToolDenied, type ToolError as ToolError, type ToolResult as ToolResult, type UserMessage as UserMessage, type ObjectiveCompactResponse as ObjectiveCompactResponse, type ObjectiveRetrieveDiagnosticsResponse as ObjectiveRetrieveDiagnosticsResponse, type ObjectivesCursorPagination as ObjectivesCursorPagination, type ObjectiveContextWindowsCursorPagination as ObjectiveContextWindowsCursorPagination, type ObjectiveEventsCursorPagination as ObjectiveEventsCursorPagination, type ObjectiveCreateParams as ObjectiveCreateParams, type ObjectiveRetrieveParams as ObjectiveRetrieveParams, type ObjectiveListParams as ObjectiveListParams, type ObjectiveCancelParams as ObjectiveCancelParams, type ObjectiveCompactParams as ObjectiveCompactParams, type ObjectiveContinueParams as ObjectiveContinueParams, type ObjectiveListContextWindowsParams as ObjectiveListContextWindowsParams, type ObjectiveListEventsParams as ObjectiveListEventsParams, type ObjectiveRetrieveDiagnosticsParams as ObjectiveRetrieveDiagnosticsParams, type ObjectiveStreamEventsParams as ObjectiveStreamEventsParams, };
     export { Tools as Tools, type ObjectiveTool as ObjectiveTool, type ObjectiveToolsCursorPagination as ObjectiveToolsCursorPagination, type ToolListParams as ToolListParams, };
-    export { ToolCalls as ToolCalls, type ObjectiveToolCall as ObjectiveToolCall, type ObjectiveToolCallData as ObjectiveToolCallData, type ObjectiveToolCallInfo as ObjectiveToolCallInfo, type ObjectiveToolCallResult as ObjectiveToolCallResult, type ObjectiveToolCallResultAudioBlock as ObjectiveToolCallResultAudioBlock, type ObjectiveToolCallResultContentBlock as ObjectiveToolCallResultContentBlock, type ObjectiveToolCallResultImageBlock as ObjectiveToolCallResultImageBlock, type ObjectiveToolCallResultTextBlock as ObjectiveToolCallResultTextBlock, type ObjectiveToolCallWithResult as ObjectiveToolCallWithResult, type ResolvedSecret as ResolvedSecret, type SetToolCallContentRequestAudioBlock as SetToolCallContentRequestAudioBlock, type SetToolCallContentRequestContentBlock as SetToolCallContentRequestContentBlock, type SetToolCallContentRequestImageBlock as SetToolCallContentRequestImageBlock, type SetToolCallContentRequestTextBlock as SetToolCallContentRequestTextBlock, type ObjectiveToolCallsCursorPagination as ObjectiveToolCallsCursorPagination, type ToolCallRetrieveParams as ToolCallRetrieveParams, type ToolCallListParams as ToolCallListParams, type ToolCallApproveParams as ToolCallApproveParams, type ToolCallDenyParams as ToolCallDenyParams, type ToolCallSetContentParams as ToolCallSetContentParams, };
+    export { ToolCalls as ToolCalls, type ObjectiveToolCall as ObjectiveToolCall, type ObjectiveToolCallData as ObjectiveToolCallData, type ObjectiveToolCallInfo as ObjectiveToolCallInfo, type ObjectiveToolCallResult as ObjectiveToolCallResult, type ObjectiveToolCallResultAudioBlock as ObjectiveToolCallResultAudioBlock, type ObjectiveToolCallResultContentBlock as ObjectiveToolCallResultContentBlock, type ObjectiveToolCallResultContentBlockAudio as ObjectiveToolCallResultContentBlockAudio, type ObjectiveToolCallResultContentBlockImage as ObjectiveToolCallResultContentBlockImage, type ObjectiveToolCallResultContentBlockText as ObjectiveToolCallResultContentBlockText, type ObjectiveToolCallResultImageBlock as ObjectiveToolCallResultImageBlock, type ObjectiveToolCallResultTextBlock as ObjectiveToolCallResultTextBlock, type ObjectiveToolCallWithResult as ObjectiveToolCallWithResult, type ResolvedSecret as ResolvedSecret, type SetToolCallContentRequestAudioBlock as SetToolCallContentRequestAudioBlock, type SetToolCallContentRequestContentBlock as SetToolCallContentRequestContentBlock, type SetToolCallContentRequestContentBlockAudio as SetToolCallContentRequestContentBlockAudio, type SetToolCallContentRequestContentBlockImage as SetToolCallContentRequestContentBlockImage, type SetToolCallContentRequestContentBlockText as SetToolCallContentRequestContentBlockText, type SetToolCallContentRequestImageBlock as SetToolCallContentRequestImageBlock, type SetToolCallContentRequestTextBlock as SetToolCallContentRequestTextBlock, type ObjectiveToolCallsCursorPagination as ObjectiveToolCallsCursorPagination, type ToolCallRetrieveParams as ToolCallRetrieveParams, type ToolCallListParams as ToolCallListParams, type ToolCallApproveParams as ToolCallApproveParams, type ToolCallDenyParams as ToolCallDenyParams, type ToolCallSetContentParams as ToolCallSetContentParams, };
     export { Tasks as Tasks, type ObjectiveTask as ObjectiveTask, type ObjectiveTaskData as ObjectiveTaskData, type ObjectiveTasksCursorPagination as ObjectiveTasksCursorPagination, type TaskRetrieveParams as TaskRetrieveParams, type TaskListParams as TaskListParams, };
     export { Feedback as Feedback, type ObjectiveFeedback as ObjectiveFeedback, type ObjectiveFeedbackData as ObjectiveFeedbackData, type ObjectiveFeedbackInfo as ObjectiveFeedbackInfo, type ObjectiveFeedbacksCursorPagination as ObjectiveFeedbacksCursorPagination, type FeedbackCreateParams as FeedbackCreateParams, type FeedbackListParams as FeedbackListParams, };
 }