@cadenya/cadenya 0.134.0 → 1.0.0

package/src/resources/objectives.ts

@@ -1,3 +1,764 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+// Generated by redwood. Do not edit by hand.
 
-export * from './objectives/index';
+import { HttpClient, RequestOptions, RequestSpec, APIPromise, pathSegment, snapshotParams } from '../core/http.js';
+import { Page } from '../core/pagination.js';
+import { Stream } from '../core/sse.js';
+import type { AgentVariationSpec_CompactionConfig, CompactObjectiveResponse, CreateObjectiveRequest_Secret, CreateOperationMetadata, GetObjectiveDiagnosticsResponse, ListObjectiveContextWindowsResponse, ListObjectiveEventsResponse, ListObjectiveFeedbackResponse, ListObjectiveTasksResponse, ListObjectiveToolCallsResponse, ListObjectiveToolsResponse, ListObjectivesResponse, MemoryReference, Objective, ObjectiveContextWindow, ObjectiveEpisodicConfigParam, ObjectiveEvent, ObjectiveFeedback, ObjectiveFeedbackData, ObjectiveServiceListObjectiveToolCallsExecutionStatus, ObjectiveServiceListObjectiveToolCallsStatus, ObjectiveServiceListObjectivesState, ObjectiveTask, ObjectiveTool, ObjectiveToolCall, ObjectiveToolCallWithResult, SetToolCallContentRequest_ContentBlock, SubjectAssertion, TenantAssertion } from '../types.js';
+import { wireObjectiveEpisodicConfig } from '../types.js';
+
+export interface ObjectiveListParams {
+  /**
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+  /**
+   * Maximum number of results to return
+   */
+  limit?: number;
+  /**
+   * Pagination cursor from previous response
+   */
+  cursor?: string;
+  /**
+   * Agent ID for filtering
+   */
+  agentId?: string;
+  /**
+   * Optional filters
+   */
+  parentObjectiveId?: string;
+  /**
+   * Filter by state
+   */
+  state?: ObjectiveServiceListObjectivesState;
+  profileId?: string;
+  /**
+   * Sort order for results (asc or desc by creation time)
+   */
+  sortOrder?: string;
+  /**
+   * When set to true you may use more of your alloted API rate-limit
+   */
+  includeInfo?: boolean;
+  /**
+   * Filter to objectives produced by a specific AgentSchedule. Accepts
+   *  canonical as_… form or external_id:<value> form.
+   */
+  agentScheduleId?: string;
+  /**
+   * 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;
+  /**
+   * Filter to objectives associated with a tenant. Accepts the canonical
+   *  `tenant_…` form or the `external_id:<value>` form.
+   */
+  tenantId?: string;
+  /**
+   * Filter to objectives associated with a subject. Accepts the canonical
+   *  `subj_…` form or the `external_id:<value>` form; the external_id form is
+   *  scoped within a tenant and requires `tenant_id` to also be set.
+   */
+  subjectId?: string;
+  /**
+   * Filter to objectives whose conversation ran through a widget. Accepts
+   *  the canonical `wgt_…` form or the `external_id:<value>` form.
+   */
+  widgetId?: string;
+  /**
+   * Filter to objectives created by a specific widget session.
+   */
+  widgetSessionId?: string;
+}
+
+export interface ObjectiveCreateParams {
+  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.
+   */
+  systemPromptData: Record<string, unknown>;
+  /**
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+  /**
+   * Optional explicit variation selection. Overrides the agent's variation_selection_mode.
+   */
+  variationId?: string;
+  metadata?: CreateOperationMetadata;
+  /**
+   * 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;
+  /**
+   * Secrets that can be used in the headers for tool calls using the secret interpolation format.
+   */
+  secrets?: Array<CreateObjectiveRequest_Secret>;
+  /**
+   * 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 layers at their position.
+   * 
+   *  System-managed layers (e.g., episodic) cannot be referenced here;
+   *  they attach themselves automatically based on the episodic key.
+   * 
+   *  Size cap: the TOTAL effective cascade (this field + the variation's
+   *  memory layer assignments) must not exceed 10 entries. A request
+   *  that would produce a larger cascade is rejected with
+   *  InvalidArgument.
+   */
+  memoryCascade?: Array<MemoryReference>;
+  /**
+   * 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.
+   */
+  firstUserMessageData?: Record<string, unknown>;
+  /**
+   * If the agent variation that is selected has episodic memory enabled, then this key is used to create/update a memory layer
+   *  specific to the episodic memory. The layer may have a TTL configured by the variation.
+   */
+  episodicMemory?: ObjectiveEpisodicConfigParam;
+  /**
+   * Optional tenant assertion — the customer's org/company identifier for the
+   *  end user this objective serves. Upserts the tenant record in the
+   *  workspace and associates the objective with it.
+   */
+  tenant?: TenantAssertion;
+  /**
+   * Optional subject assertion — the person within the tenant this objective
+   *  serves. Requires `tenant`; a subject asserted without a tenant is
+   *  rejected with InvalidArgument.
+   */
+  subject?: SubjectAssertion;
+  /**
+   * Parameters forced onto this objective's tool calls. A pinned parameter
+   *  is an overlay on a tool's JSON schema: the parameter is removed from
+   *  what the LLM sees, and its value is always overwritten server-side with
+   *  the pinned value — the model cannot choose a different value for it.
+   */
+  pinnedParameters?: Record<string, string>;
+}
+
+export interface ObjectiveRetrieveParams {
+  /**
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface ObjectiveListContextWindowsParams {
+  /**
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+  /**
+   * Maximum number of results to return
+   */
+  limit?: number;
+  /**
+   * Pagination cursor from previous response
+   */
+  cursor?: string;
+  /**
+   * 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. "env=prod,team=ai". A resource matches only if every pair
+   *  matches exactly (AND semantics).
+   */
+  labels?: string;
+}
+
+export interface ObjectiveRetrieveDiagnosticsParams {
+  /**
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface ObjectiveListEventsParams {
+  /**
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+  /**
+   * Maximum number of results to return
+   */
+  limit?: number;
+  /**
+   * Pagination cursor from previous response
+   */
+  cursor?: string;
+  /**
+   * Sort order for results (asc or desc by creation time)
+   */
+  sortOrder?: string;
+  /**
+   * When set to true you may use more of your alloted API rate-limit
+   */
+  includeInfo?: boolean;
+  /**
+   * Optional context window ID to filter events by
+   */
+  windowId?: string;
+  /**
+   * Optional string to fetch events since an ID
+   */
+  sinceEventId?: string;
+  /**
+   * 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;
+}
+
+export interface ObjectiveStreamEventsParams {
+  /**
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface ObjectiveListFeedbackParams {
+  /**
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+  /**
+   * Maximum number of results to return
+   */
+  limit?: number;
+  /**
+   * Pagination cursor from previous response
+   */
+  cursor?: string;
+  /**
+   * 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;
+}
+
+export interface ObjectiveCreateFeedbackParams {
+  metadata: CreateOperationMetadata;
+  data: ObjectiveFeedbackData;
+  /**
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface ObjectiveListTasksParams {
+  /**
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+  /**
+   * Maximum number of results to return
+   */
+  limit?: number;
+  /**
+   * Pagination cursor from previous response
+   */
+  cursor?: string;
+  /**
+   * Sort order for results
+   */
+  sortOrder?: string;
+}
+
+export interface ObjectiveRetrieveTaskParams {
+  /**
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface ObjectiveListToolCallsParams {
+  /**
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+  /**
+   * Maximum number of results to return
+   */
+  limit?: number;
+  /**
+   * Pagination cursor from previous response
+   */
+  cursor?: string;
+  /**
+   * Filter by tool call status
+   */
+  status?: ObjectiveServiceListObjectiveToolCallsStatus;
+  /**
+   * When set to true you may use more of your alloted API rate-limit
+   */
+  includeInfo?: boolean;
+  /**
+   * Filter by tool call execution status. Useful for reverse-harness
+   *  polling of bare tool calls waiting for externally supplied content
+   *  (TOOL_CALL_EXECUTION_STATUS_WAITING_FOR_CONTENT).
+   */
+  executionStatus?: ObjectiveServiceListObjectiveToolCallsExecutionStatus;
+  /**
+   * 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;
+}
+
+export interface ObjectiveRetrieveToolCallParams {
+  /**
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface ObjectiveApproveToolCallParams {
+  /**
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface ObjectiveDenyToolCallParams {
+  /**
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+  /**
+   * A memo to associate to the tool call denial. Use a memo to steer the LLM to a different decision or usage of the tool.
+   */
+  memo?: string;
+}
+
+export interface ObjectiveSetToolCallContentParams {
+  /**
+   * The content to set on the tool call. Mirrors
+   *  ObjectiveToolCallResult.ContentBlock but writable: media blocks carry
+   *  raw data on input where the result-side carries a signed url on output.
+   */
+  content: Array<SetToolCallContentRequest_ContentBlock>;
+  /**
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface ObjectiveListToolsParams {
+  /**
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+  /**
+   * Maximum number of results to return
+   */
+  limit?: number;
+  /**
+   * Pagination cursor from previous response
+   */
+  cursor?: string;
+}
+
+export interface ObjectiveCancelParams {
+  /**
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+  /**
+   * Optional reason for cancellation
+   */
+  reason?: string;
+}
+
+export interface ObjectiveCompactParams {
+  /**
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+  /**
+   * Optional compaction config override. When not set, uses the variation's compaction_config.
+   */
+  compactionConfig?: AgentVariationSpec_CompactionConfig;
+}
+
+export interface ObjectiveContinueParams {
+  /**
+   * The message to continue an objective that has completed (or you are enqueing)
+   */
+  message: string;
+  /**
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+  /**
+   * When set to true, the message will be enqueued for when the agent loop is available to process it.
+   */
+  enqueue?: boolean;
+}
+
+export class Objectives {
+  constructor(private readonly _client: HttpClient) {}
+
+  /**
+   * List objectives
+   * 
+   * @example
+   * ```ts
+   * const page = await client.objectives.list();
+   * for await (const item of page) {
+   *   // auto-fetches every page
+   * }
+   * ```
+   */
+  async list(params?: ObjectiveListParams, options?: RequestOptions): Promise<Page<Objective>> {
+    const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+    if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+    const _base = snapshotParams(params);
+    const response = await this._client.request<ListObjectivesResponse>({ method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/objectives`, query: { limit: params?.limit, cursor: params?.cursor, agentId: params?.agentId, parentObjectiveId: params?.parentObjectiveId, state: params?.state, profileId: params?.profileId, sortOrder: params?.sortOrder, includeInfo: params?.includeInfo, agentScheduleId: params?.agentScheduleId, labels: params?.labels, tenantId: params?.tenantId, subjectId: params?.subjectId, widgetId: params?.widgetId, widgetSessionId: params?.widgetSessionId } }, options);
+    return new Page(response.items ?? [], response.pagination?.nextCursor, (cursor) => this.list({ ..._base, cursor: cursor }, options));
+  }
+
+  /**
+   * Create a new objective
+   * 
+   * @example
+   * ```ts
+   * const objective = await client.objectives.create({ agentId: 'sample', systemPromptData: {  } });
+   * ```
+   */
+  create(params: ObjectiveCreateParams, options?: RequestOptions): APIPromise<Objective> {
+    return this._client.requestAPI<Objective>(() => {
+      const workspaceId = String(params.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/objectives`, body: { agentId: params.agentId, variationId: params.variationId, metadata: params.metadata, systemPromptData: params.systemPromptData, firstUserMessage: params.firstUserMessage, secrets: params.secrets, memoryCascade: params.memoryCascade, firstUserMessageData: params.firstUserMessageData, episodicMemory: wireObjectiveEpisodicConfig(params.episodicMemory), tenant: params.tenant, subject: params.subject, pinnedParameters: params.pinnedParameters } };
+    }, options);
+  }
+
+  /**
+   * Get an objective by ID
+   * 
+   * @example
+   * ```ts
+   * const objective = await client.objectives.retrieve('_123');
+   * ```
+   */
+  retrieve(id: string, params?: ObjectiveRetrieveParams, options?: RequestOptions): APIPromise<Objective> {
+    return this._client.requestAPI<Objective>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/objectives/${pathSegment('id', id)}` };
+    }, options);
+  }
+
+  /**
+   * List objective context windows
+   * 
+   * @example
+   * ```ts
+   * const page = await client.objectives.listContextWindows('objective_123');
+   * for await (const item of page) {
+   *   // auto-fetches every page
+   * }
+   * ```
+   */
+  async listContextWindows(objectiveId: string, params?: ObjectiveListContextWindowsParams, options?: RequestOptions): Promise<Page<ObjectiveContextWindow>> {
+    const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+    if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+    const _base = snapshotParams(params);
+    const response = await this._client.request<ListObjectiveContextWindowsResponse>({ method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/objectives/${pathSegment('objectiveId', objectiveId)}/context_windows`, query: { limit: params?.limit, cursor: params?.cursor, includeInfo: params?.includeInfo, labels: params?.labels } }, options);
+    return new Page(response.items ?? [], response.pagination?.nextCursor, (cursor) => this.listContextWindows(objectiveId, { ..._base, cursor: cursor }, options));
+  }
+
+  /**
+   * Get objective context diagnostics
+   * 
+   * @example
+   * ```ts
+   * const getObjectiveDiagnosticsResponse = await client.objectives.retrieveDiagnostics('objective_123');
+   * ```
+   */
+  retrieveDiagnostics(objectiveId: string, params?: ObjectiveRetrieveDiagnosticsParams, options?: RequestOptions): APIPromise<GetObjectiveDiagnosticsResponse> {
+    return this._client.requestAPI<GetObjectiveDiagnosticsResponse>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/objectives/${pathSegment('objectiveId', objectiveId)}/diagnostics` };
+    }, options);
+  }
+
+  /**
+   * List objective events
+   * 
+   * @example
+   * ```ts
+   * const page = await client.objectives.listEvents('objective_123');
+   * for await (const item of page) {
+   *   // auto-fetches every page
+   * }
+   * ```
+   */
+  async listEvents(objectiveId: string, params?: ObjectiveListEventsParams, options?: RequestOptions): Promise<Page<ObjectiveEvent>> {
+    const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+    if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+    const _base = snapshotParams(params);
+    const response = await this._client.request<ListObjectiveEventsResponse>({ method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/objectives/${pathSegment('objectiveId', objectiveId)}/events`, query: { limit: params?.limit, cursor: params?.cursor, sortOrder: params?.sortOrder, includeInfo: params?.includeInfo, windowId: params?.windowId, sinceEventId: params?.sinceEventId, labels: params?.labels } }, options);
+    return new Page(response.items ?? [], response.pagination?.nextCursor, (cursor) => this.listEvents(objectiveId, { ..._base, cursor: cursor }, options));
+  }
+
+  /**
+   * Stream objective events
+   * 
+   * @example
+   * ```ts
+   * const stream = await client.objectives.streamEvents('objective_123');
+   * for await (const event of stream) {
+   *   // typed event payloads; housekeeping frames are skipped
+   * }
+   * ```
+   */
+  async streamEvents(objectiveId: string, params?: ObjectiveStreamEventsParams, options?: RequestOptions): Promise<Stream<ObjectiveEvent>> {
+    const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+    if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+    const _spec: RequestSpec = { method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/objectives/${pathSegment('objectiveId', objectiveId)}/events:stream`, stream: true };
+    const response = await this._client.rawRequest(_spec, options);
+    return new Stream<ObjectiveEvent>(response, options?.signal, options?.lastEventId, ['ping', 'open'], options?.reconnect === false ? undefined : (lastEventId, signal) => this._client.rawRequest(_spec, { ...options, lastEventId, signal }));
+  }
+
+  /**
+   * List feedback for an objective
+   * 
+   * @example
+   * ```ts
+   * const page = await client.objectives.listFeedback('objective_123');
+   * for await (const item of page) {
+   *   // auto-fetches every page
+   * }
+   * ```
+   */
+  async listFeedback(objectiveId: string, params?: ObjectiveListFeedbackParams, options?: RequestOptions): Promise<Page<ObjectiveFeedback>> {
+    const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+    if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+    const _base = snapshotParams(params);
+    const response = await this._client.request<ListObjectiveFeedbackResponse>({ method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/objectives/${pathSegment('objectiveId', objectiveId)}/feedback`, query: { limit: params?.limit, cursor: params?.cursor, labels: params?.labels } }, options);
+    return new Page(response.items ?? [], response.pagination?.nextCursor, (cursor) => this.listFeedback(objectiveId, { ..._base, cursor: cursor }, options));
+  }
+
+  /**
+   * Submit feedback for an objective
+   * 
+   * @example
+   * ```ts
+   * const objectiveFeedback = await client.objectives.createFeedback('objective_123', { metadata: {  }, data: {  } });
+   * ```
+   */
+  createFeedback(objectiveId: string, params: ObjectiveCreateFeedbackParams, options?: RequestOptions): APIPromise<ObjectiveFeedback> {
+    return this._client.requestAPI<ObjectiveFeedback>(() => {
+      const workspaceId = String(params.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/objectives/${pathSegment('objectiveId', objectiveId)}/feedback`, body: { metadata: params.metadata, data: params.data } };
+    }, options);
+  }
+
+  /**
+   * List objective tasks
+   * 
+   * @example
+   * ```ts
+   * const page = await client.objectives.listTasks('objective_123');
+   * for await (const item of page) {
+   *   // auto-fetches every page
+   * }
+   * ```
+   */
+  async listTasks(objectiveId: string, params?: ObjectiveListTasksParams, options?: RequestOptions): Promise<Page<ObjectiveTask>> {
+    const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+    if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+    const _base = snapshotParams(params);
+    const response = await this._client.request<ListObjectiveTasksResponse>({ method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/objectives/${pathSegment('objectiveId', objectiveId)}/tasks`, query: { limit: params?.limit, cursor: params?.cursor, sortOrder: params?.sortOrder } }, options);
+    return new Page(response.items ?? [], response.pagination?.nextCursor, (cursor) => this.listTasks(objectiveId, { ..._base, cursor: cursor }, options));
+  }
+
+  /**
+   * Get an objective task by ID
+   * 
+   * @example
+   * ```ts
+   * const objectiveTask = await client.objectives.retrieveTask('objective_123', '_123');
+   * ```
+   */
+  retrieveTask(objectiveId: string, id: string, params?: ObjectiveRetrieveTaskParams, options?: RequestOptions): APIPromise<ObjectiveTask> {
+    return this._client.requestAPI<ObjectiveTask>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/objectives/${pathSegment('objectiveId', objectiveId)}/tasks/${pathSegment('id', id)}` };
+    }, options);
+  }
+
+  /**
+   * List objective tool calls
+   * 
+   * @example
+   * ```ts
+   * const page = await client.objectives.listToolCalls('objective_123');
+   * for await (const item of page) {
+   *   // auto-fetches every page
+   * }
+   * ```
+   */
+  async listToolCalls(objectiveId: string, params?: ObjectiveListToolCallsParams, options?: RequestOptions): Promise<Page<ObjectiveToolCall>> {
+    const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+    if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+    const _base = snapshotParams(params);
+    const response = await this._client.request<ListObjectiveToolCallsResponse>({ method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/objectives/${pathSegment('objectiveId', objectiveId)}/tool_calls`, query: { limit: params?.limit, cursor: params?.cursor, status: params?.status, includeInfo: params?.includeInfo, executionStatus: params?.executionStatus, labels: params?.labels } }, options);
+    return new Page(response.items ?? [], response.pagination?.nextCursor, (cursor) => this.listToolCalls(objectiveId, { ..._base, cursor: cursor }, options));
+  }
+
+  /**
+   * Get an objective tool call by ID
+   * 
+   * @example
+   * ```ts
+   * const objectiveToolCallWithResult = await client.objectives.retrieveToolCall('objective_123', 'tool_call_123');
+   * ```
+   */
+  retrieveToolCall(objectiveId: string, toolCallId: string, params?: ObjectiveRetrieveToolCallParams, options?: RequestOptions): APIPromise<ObjectiveToolCallWithResult> {
+    return this._client.requestAPI<ObjectiveToolCallWithResult>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/objectives/${pathSegment('objectiveId', objectiveId)}/tool_calls/${pathSegment('toolCallId', toolCallId)}` };
+    }, options);
+  }
+
+  /**
+   * Approve a tool call
+   * 
+   * @example
+   * ```ts
+   * const objectiveToolCall = await client.objectives.approveToolCall('objective_123', 'tool_call_123');
+   * ```
+   */
+  approveToolCall(objectiveId: string, toolCallId: string, params?: ObjectiveApproveToolCallParams, options?: RequestOptions): APIPromise<ObjectiveToolCall> {
+    return this._client.requestAPI<ObjectiveToolCall>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/objectives/${pathSegment('objectiveId', objectiveId)}/tool_calls/${pathSegment('toolCallId', toolCallId)}:approve` };
+    }, options);
+  }
+
+  /**
+   * Deny a tool call
+   * 
+   * @example
+   * ```ts
+   * const objectiveToolCall = await client.objectives.denyToolCall('objective_123', 'tool_call_123');
+   * ```
+   */
+  denyToolCall(objectiveId: string, toolCallId: string, params?: ObjectiveDenyToolCallParams, options?: RequestOptions): APIPromise<ObjectiveToolCall> {
+    return this._client.requestAPI<ObjectiveToolCall>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/objectives/${pathSegment('objectiveId', objectiveId)}/tool_calls/${pathSegment('toolCallId', toolCallId)}:deny`, body: { memo: params?.memo } };
+    }, options);
+  }
+
+  /**
+   * Set a bare tool call's content
+   * 
+   * @example
+   * ```ts
+   * const objectiveToolCall = await client.objectives.setToolCallContent('objective_123', 'tool_call_123', { content: [{ text: { text: 'sample' }, type: 'text' }] });
+   * ```
+   */
+  setToolCallContent(objectiveId: string, toolCallId: string, params: ObjectiveSetToolCallContentParams, options?: RequestOptions): APIPromise<ObjectiveToolCall> {
+    return this._client.requestAPI<ObjectiveToolCall>(() => {
+      const workspaceId = String(params.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/objectives/${pathSegment('objectiveId', objectiveId)}/tool_calls/${pathSegment('toolCallId', toolCallId)}:setContent`, body: { content: params.content } };
+    }, options);
+  }
+
+  /**
+   * List objective tools
+   * 
+   * @example
+   * ```ts
+   * const page = await client.objectives.listTools('objective_123');
+   * for await (const item of page) {
+   *   // auto-fetches every page
+   * }
+   * ```
+   */
+  async listTools(objectiveId: string, params?: ObjectiveListToolsParams, options?: RequestOptions): Promise<Page<ObjectiveTool>> {
+    const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+    if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+    const _base = snapshotParams(params);
+    const response = await this._client.request<ListObjectiveToolsResponse>({ method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/objectives/${pathSegment('objectiveId', objectiveId)}/tools`, query: { limit: params?.limit, cursor: params?.cursor } }, options);
+    return new Page(response.items ?? [], response.pagination?.nextCursor, (cursor) => this.listTools(objectiveId, { ..._base, cursor: cursor }, options));
+  }
+
+  /**
+   * Cancel an objective
+   * 
+   * @example
+   * ```ts
+   * const objective = await client.objectives.cancel('objective_123');
+   * ```
+   */
+  cancel(objectiveId: string, params?: ObjectiveCancelParams, options?: RequestOptions): APIPromise<Objective> {
+    return this._client.requestAPI<Objective>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/objectives/${pathSegment('objectiveId', objectiveId)}:cancel`, body: { reason: params?.reason } };
+    }, options);
+  }
+
+  /**
+   * Compact an objective
+   * 
+   * @example
+   * ```ts
+   * const compactObjectiveResponse = await client.objectives.compact('objective_123');
+   * ```
+   */
+  compact(objectiveId: string, params?: ObjectiveCompactParams, options?: RequestOptions): APIPromise<CompactObjectiveResponse> {
+    return this._client.requestAPI<CompactObjectiveResponse>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/objectives/${pathSegment('objectiveId', objectiveId)}:compact`, body: { compactionConfig: params?.compactionConfig } };
+    }, options);
+  }
+
+  /**
+   * Continue an objective
+   * 
+   * @example
+   * ```ts
+   * const objectiveEvent = await client.objectives.continue('objective_123', { message: 'sample' });
+   * ```
+   */
+  continue(objectiveId: string, params: ObjectiveContinueParams, options?: RequestOptions): APIPromise<ObjectiveEvent> {
+    return this._client.requestAPI<ObjectiveEvent>(() => {
+      const workspaceId = String(params.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/objectives/${pathSegment('objectiveId', objectiveId)}:continue`, body: { message: params.message, enqueue: params.enqueue } };
+    }, options);
+  }
+}