@cadenya/cadenya 1.5.0 → 1.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cadenya/cadenya",
-  "version": "1.5.0",
+  "version": "1.7.0",
   "description": "The official TypeScript SDK for the Cadenya API",
   "license": "Apache-2.0",
   "type": "module",

package/src/client.ts

@@ -8,6 +8,7 @@ import { ApiKeys } from './resources/api-keys.js';
 import { WorkspaceAdmin } from './resources/workspace-admin.js';
 import { Profiles } from './resources/profiles.js';
 import { Workspaces } from './resources/workspaces.js';
+import { AgentPools } from './resources/agent-pools.js';
 import { Agents } from './resources/agents.js';
 import { AiProviderKeys } from './resources/ai-provider-keys.js';
 import { Models } from './resources/models.js';
@@ -55,6 +56,7 @@ export class Cadenya {
   readonly workspaceAdmin: WorkspaceAdmin;
   readonly profiles: Profiles;
   readonly workspaces: Workspaces;
+  readonly agentPools: AgentPools;
   readonly agents: Agents;
   readonly aiProviderKeys: AiProviderKeys;
   readonly models: Models;
@@ -85,7 +87,7 @@ export class Cadenya {
       authHeader: () => ({ Authorization: `Bearer ${apiKey}` }),
       maxRetries: options.maxRetries ?? 0,
       timeout: options.timeout,
-      defaultHeaders: { ...nodeUserAgent('cadenya-typescript/1.5.0 (api 1.0)'), ...options.defaultHeaders },
+      defaultHeaders: { ...nodeUserAgent('cadenya-typescript/1.6.0 (api 1.0)'), ...options.defaultHeaders },
       fetch: options.fetch,
       logger: options.logger,
       logLevel: options.logLevel,
@@ -97,6 +99,7 @@ export class Cadenya {
     this.workspaceAdmin = new WorkspaceAdmin(this._client);
     this.profiles = new Profiles(this._client);
     this.workspaces = new Workspaces(this._client);
+    this.agentPools = new AgentPools(this._client);
     this.agents = new Agents(this._client);
     this.aiProviderKeys = new AiProviderKeys(this._client);
     this.models = new Models(this._client);

package/src/index.ts

@@ -17,6 +17,7 @@ export * from './resources/api-keys.js';
 export * from './resources/workspace-admin.js';
 export * from './resources/profiles.js';
 export * from './resources/workspaces.js';
+export * from './resources/agent-pools.js';
 export * from './resources/agents.js';
 export * from './resources/agent-schedules.js';
 export * from './resources/agent-variations.js';

package/src/resources/agent-pools.ts

@@ -0,0 +1,287 @@
+// Generated by redwood. Do not edit by hand.
+
+import { HttpClient, RequestOptions, APIPromise, pathSegment, snapshotParams } from '../core/http.js';
+import { Page } from '../core/pagination.js';
+import type { AgentPool, AgentPoolServiceListAgentPoolsState, AgentPoolSpec, AgentPoolUpdateSpec, CreateResourceMetadata, ListAgentPoolsResponse, UpdateResourceMetadata } from '../types.js';
+
+export interface AgentPoolListParams {
+  /**
+   * Workspace ID.
+   * 
+   * 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 expression (query param: prefix)
+   */
+  prefix?: string;
+  /**
+   * Free-form search query
+   */
+  query?: string;
+  /**
+   * Filter by lifecycle state. Unspecified returns active and inactive pools;
+   *  explicitly select ARCHIVED to list archived pools.
+   */
+  state?: AgentPoolServiceListAgentPoolsState;
+  /**
+   * 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;
+  /**
+   * Sort order for results (asc or desc by creation time)
+   */
+  sortOrder?: string;
+  /**
+   * When true, the `info` field on each returned agent pool is populated. Requests
+   *  with this flag count more against your rate limit.
+   */
+  includeInfo?: boolean;
+}
+
+export interface AgentPoolCreateParams {
+  metadata: CreateResourceMetadata;
+  spec: AgentPoolSpec;
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface AgentPoolRetrieveParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface AgentPoolDeleteParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface AgentPoolUpdateParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+  metadata?: UpdateResourceMetadata;
+  spec?: AgentPoolUpdateSpec;
+  /**
+   * Fields to update. Only metadata and spec are mutable; top-level state and info
+   *  paths are invalid. spec.assignments replaces the entire membership list.
+   *  A spec mask replaces the full spec; * replaces all mutable fields.
+   *  Without a mask, infer paths from non-empty fields. Empty or omitted
+   *  membership then leaves the existing list unchanged. Element/index paths
+   *  are invalid. Validate the merged pool atomically: an empty description
+   *  or membership (including an explicitly masked empty list) is invalid.
+   */
+  updateMask?: string;
+}
+
+export interface AgentPoolActivateParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface AgentPoolArchiveParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface AgentPoolDeactivateParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface AgentPoolUnarchiveParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export class AgentPools {
+  constructor(private readonly _client: HttpClient) {}
+
+  /**
+   * List agent pools
+   * 
+   * @example
+   * ```ts
+   * const page = await client.agentPools.list();
+   * for await (const item of page) {
+   *   // auto-fetches every page
+   * }
+   * ```
+   */
+  async list(params?: AgentPoolListParams, options?: RequestOptions): Promise<Page<AgentPool>> {
+    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<ListAgentPoolsResponse>({ method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/agent_pools`, query: { limit: params?.limit, cursor: params?.cursor, prefix: params?.prefix, query: params?.query, state: params?.state, labels: params?.labels, sortOrder: params?.sortOrder, includeInfo: params?.includeInfo } }, options);
+    return new Page(response.items ?? [], response.pagination?.nextCursor, (cursor) => this.list({ ..._base, cursor: cursor }, options));
+  }
+
+  /**
+   * Create a new agent pool
+   * 
+   * @example
+   * ```ts
+   * const agentPool = await client.agentPools.create({ metadata: { name: 'sample' }, spec: { assignments: [{ agentId: 'sample' }], description: 'sample' } });
+   * ```
+   */
+  create(params: AgentPoolCreateParams, options?: RequestOptions): APIPromise<AgentPool> {
+    return this._client.requestAPI<AgentPool>(() => {
+      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)}/agent_pools`, body: { metadata: params.metadata, spec: params.spec } };
+    }, options);
+  }
+
+  /**
+   * Get an agent pool by ID
+   * 
+   * @example
+   * ```ts
+   * const agentPool = await client.agentPools.retrieve('_123');
+   * ```
+   */
+  retrieve(id: string, params?: AgentPoolRetrieveParams, options?: RequestOptions): APIPromise<AgentPool> {
+    return this._client.requestAPI<AgentPool>(() => {
+      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)}/agent_pools/${pathSegment('id', id)}` };
+    }, options);
+  }
+
+  /**
+   * Delete an agent pool
+   * 
+   * @example
+   * ```ts
+   * await client.agentPools.delete('_123');
+   * ```
+   */
+  delete(id: string, params?: AgentPoolDeleteParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.requestAPI<void>(() => {
+      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: 'DELETE', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/agent_pools/${pathSegment('id', id)}`, void: true };
+    }, options);
+  }
+
+  /**
+   * Update an agent pool
+   * 
+   * @example
+   * ```ts
+   * const agentPool = await client.agentPools.update('_123');
+   * ```
+   */
+  update(id: string, params?: AgentPoolUpdateParams, options?: RequestOptions): APIPromise<AgentPool> {
+    return this._client.requestAPI<AgentPool>(() => {
+      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: 'PATCH', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/agent_pools/${pathSegment('id', id)}`, body: { metadata: params?.metadata, spec: params?.spec, updateMask: params?.updateMask } };
+    }, options);
+  }
+
+  /**
+   * Activate an agent pool
+   * 
+   * @example
+   * ```ts
+   * const agentPool = await client.agentPools.activate('_123');
+   * ```
+   */
+  activate(id: string, params?: AgentPoolActivateParams, options?: RequestOptions): APIPromise<AgentPool> {
+    return this._client.requestAPI<AgentPool>(() => {
+      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)}/agent_pools/${pathSegment('id', id)}:activate` };
+    }, options);
+  }
+
+  /**
+   * Archive an agent pool
+   * 
+   * @example
+   * ```ts
+   * const agentPool = await client.agentPools.archive('_123');
+   * ```
+   */
+  archive(id: string, params?: AgentPoolArchiveParams, options?: RequestOptions): APIPromise<AgentPool> {
+    return this._client.requestAPI<AgentPool>(() => {
+      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)}/agent_pools/${pathSegment('id', id)}:archive` };
+    }, options);
+  }
+
+  /**
+   * Deactivate an agent pool
+   * 
+   * @example
+   * ```ts
+   * const agentPool = await client.agentPools.deactivate('_123');
+   * ```
+   */
+  deactivate(id: string, params?: AgentPoolDeactivateParams, options?: RequestOptions): APIPromise<AgentPool> {
+    return this._client.requestAPI<AgentPool>(() => {
+      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)}/agent_pools/${pathSegment('id', id)}:deactivate` };
+    }, options);
+  }
+
+  /**
+   * Unarchive an agent pool
+   * 
+   * @example
+   * ```ts
+   * const agentPool = await client.agentPools.unarchive('_123');
+   * ```
+   */
+  unarchive(id: string, params?: AgentPoolUnarchiveParams, options?: RequestOptions): APIPromise<AgentPool> {
+    return this._client.requestAPI<AgentPool>(() => {
+      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)}/agent_pools/${pathSegment('id', id)}:unarchive` };
+    }, options);
+  }
+}

package/src/resources/objectives.ts

@@ -3,7 +3,7 @@
 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, ListObjectiveToolCallsResponse, ListObjectiveToolsResponse, ListObjectivesResponse, MemoryReference, Objective, ObjectiveContextWindow, ObjectiveEpisodicConfigParam, ObjectiveEvent, ObjectiveFeedback, ObjectiveFeedbackData, ObjectiveServiceListObjectiveToolCallsExecutionStatus, ObjectiveServiceListObjectiveToolCallsStatus, ObjectiveServiceListObjectivesState, ObjectiveTool, ObjectiveToolCall, ObjectiveToolCallWithResult, SetToolCallContentRequest_ContentBlock, SubjectAssertion, TenantAssertion } from '../types.js';
+import type { AgentVariationSpec_CompactionConfig, ContinueObjectiveResponse, CreateAndStreamObjectiveRequest_Metadata, CreateAndStreamObjectiveResponse, CreateObjectiveRequest_Secret, CreateOperationMetadata, GetObjectiveDiagnosticsResponse, ListObjectiveContextWindowsResponse, ListObjectiveEventsResponse, ListObjectiveFeedbackResponse, ListObjectiveQueuedActionsResponse, ListObjectiveToolCallsResponse, ListObjectiveToolsResponse, ListObjectivesResponse, MemoryReference, Objective, ObjectiveContextWindow, ObjectiveEpisodicConfigParam, ObjectiveEvent, ObjectiveFeedback, ObjectiveFeedbackData, ObjectiveQueuedAction, ObjectiveServiceListObjectiveQueuedActionsState, ObjectiveServiceListObjectiveToolCallsExecutionStatus, ObjectiveServiceListObjectiveToolCallsStatus, ObjectiveServiceListObjectivesState, ObjectiveTool, ObjectiveToolCall, ObjectiveToolCallWithResult, SetToolCallContentRequest_ContentBlock, SubjectAssertion, TenantAssertion } from '../types.js';
 import { wireObjectiveEpisodicConfig } from '../types.js';
 
 export interface ObjectiveListParams {
@@ -75,12 +75,6 @@ export interface ObjectiveListParams {
 
 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.
    */
@@ -90,6 +84,12 @@ export interface ObjectiveCreateParams {
    */
   variationId?: string;
   metadata?: CreateOperationMetadata;
+  /**
+   * 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>;
   /**
    * Optional explicit first user message for the LLM chat history. When not set,
    *  the selected variation's first_user_message_template is rendered with
@@ -267,6 +267,36 @@ export interface ObjectiveCreateFeedbackParams {
   workspaceId?: string;
 }
 
+export interface ObjectiveListQueuedActionsParams {
+  /**
+   * 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;
+  /**
+   * Only return actions in this state. When unset, actions in every state are returned.
+   */
+  state?: ObjectiveServiceListObjectiveQueuedActionsState;
+}
+
+export interface ObjectiveRemoveQueuedActionParams {
+  /**
+   * The ID of the queued action to remove.
+   */
+  queuedActionId: string;
+  /**
+   * 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.
@@ -379,7 +409,7 @@ export interface ObjectiveCompactParams {
 
 export interface ObjectiveContinueParams {
   /**
-   * The message to continue an objective that has completed (or you are enqueing)
+   * The user message to send to the objective.
    */
   message: string;
   /**
@@ -387,11 +417,108 @@ export interface ObjectiveContinueParams {
    */
   workspaceId?: string;
   /**
-   * When set to true, the message will be enqueued for when the agent loop is available to process it.
+   * When false, the objective must be waiting and the message is sent immediately.
+   *  When true, a waiting objective still receives the message immediately; an
+   *  objective whose agent loop is busy queues it instead, and the agent picks it
+   *  up before its next assistant turn. Queued messages can be listed and removed
+   *  until then.
    */
   enqueue?: boolean;
 }
 
+export interface ObjectiveInterruptParams {
+  /**
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface ObjectiveCreateAndStreamParams {
+  agentId: string;
+  /**
+   * Required here, though Create objective leaves it optional: the external
+   *  ID inside it is the idempotency key that makes a retry of this request
+   *  resume the objective instead of starting another.
+   */
+  metadata: CreateAndStreamObjectiveRequest_Metadata;
+  /**
+   * 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;
+  /**
+   * 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>;
+  /**
+   * 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 removed from the tool schema the LLM sees, and its value is always
+   *  overwritten server-side with the pinned value — the model cannot choose
+   *  a different value for it. By default a pinned key applies to every tool
+   *  with a top-level parameter of the same name; a tool set's overlays
+   *  (ToolSetSpec.overlays) can bind pinned keys to nested paths, differently
+   *  named parameters, or a subset of tools.
+   */
+  pinnedParameters?: Record<string, string>;
+}
+
 export class Objectives {
   constructor(private readonly _client: HttpClient) {}
 
@@ -419,7 +546,7 @@ export class Objectives {
    * 
    * @example
    * ```ts
-   * const objective = await client.objectives.create({ agentId: 'sample', systemPromptData: {  } });
+   * const objective = await client.objectives.create({ agentId: 'sample' });
    * ```
    */
   create(params: ObjectiveCreateParams, options?: RequestOptions): APIPromise<Objective> {
@@ -554,6 +681,41 @@ export class Objectives {
     }, options);
   }
 
+  /**
+   * List objective queued actions
+   * 
+   * @example
+   * ```ts
+   * const page = await client.objectives.listQueuedActions('objective_123');
+   * for await (const item of page) {
+   *   // auto-fetches every page
+   * }
+   * ```
+   */
+  async listQueuedActions(objectiveId: string, params?: ObjectiveListQueuedActionsParams, options?: RequestOptions): Promise<Page<ObjectiveQueuedAction>> {
+    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<ListObjectiveQueuedActionsResponse>({ method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/objectives/${pathSegment('objectiveId', objectiveId)}/queued_actions`, query: { limit: params?.limit, cursor: params?.cursor, state: params?.state } }, options);
+    return new Page(response.items ?? [], response.pagination?.nextCursor, (cursor) => this.listQueuedActions(objectiveId, { ..._base, cursor: cursor }, options));
+  }
+
+  /**
+   * Remove a queued action
+   * 
+   * @example
+   * ```ts
+   * const objectiveQueuedAction = await client.objectives.removeQueuedAction('objective_123', { queuedActionId: 'queued_action_123' });
+   * ```
+   */
+  removeQueuedAction(objectiveId: string, params: ObjectiveRemoveQueuedActionParams, options?: RequestOptions): APIPromise<ObjectiveQueuedAction> {
+    return this._client.requestAPI<ObjectiveQueuedAction>(() => {
+      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)}/queued_actions/${pathSegment('queuedActionId', params.queuedActionId)}:remove` };
+    }, options);
+  }
+
   /**
    * List objective tool calls
    * 
@@ -677,11 +839,11 @@ export class Objectives {
    * 
    * @example
    * ```ts
-   * const compactObjectiveResponse = await client.objectives.compact('objective_123');
+   * const objectiveQueuedAction = await client.objectives.compact('objective_123');
    * ```
    */
-  compact(objectiveId: string, params?: ObjectiveCompactParams, options?: RequestOptions): APIPromise<CompactObjectiveResponse> {
-    return this._client.requestAPI<CompactObjectiveResponse>(() => {
+  compact(objectiveId: string, params?: ObjectiveCompactParams, options?: RequestOptions): APIPromise<ObjectiveQueuedAction> {
+    return this._client.requestAPI<ObjectiveQueuedAction>(() => {
       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 } };
@@ -693,14 +855,49 @@ export class Objectives {
    * 
    * @example
    * ```ts
-   * const objectiveEvent = await client.objectives.continue('objective_123', { message: 'sample' });
+   * const continueObjectiveResponse = await client.objectives.continue('objective_123', { message: 'sample' });
    * ```
    */
-  continue(objectiveId: string, params: ObjectiveContinueParams, options?: RequestOptions): APIPromise<ObjectiveEvent> {
-    return this._client.requestAPI<ObjectiveEvent>(() => {
+  continue(objectiveId: string, params: ObjectiveContinueParams, options?: RequestOptions): APIPromise<ContinueObjectiveResponse> {
+    return this._client.requestAPI<ContinueObjectiveResponse>(() => {
       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);
   }
+
+  /**
+   * Interrupt an objective
+   * 
+   * @example
+   * ```ts
+   * const objectiveEvent = await client.objectives.interrupt('objective_123');
+   * ```
+   */
+  interrupt(objectiveId: string, params?: ObjectiveInterruptParams, 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)}:interrupt` };
+    }, options);
+  }
+
+  /**
+   * Create an objective and stream its events
+   * 
+   * @example
+   * ```ts
+   * const stream = await client.objectives.createAndStream({ agentId: 'sample', metadata: { externalId: 'sample' } });
+   * for await (const event of stream) {
+   *   // typed event payloads; housekeeping frames are skipped
+   * }
+   * ```
+   */
+  async createAndStream(params: ObjectiveCreateAndStreamParams, options?: RequestOptions): Promise<Stream<CreateAndStreamObjectiveResponse>> {
+    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: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/objectives:stream`, 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 }, stream: true };
+    const response = await this._client.rawRequest(_spec, options);
+    return new Stream<CreateAndStreamObjectiveResponse>(response, options?.signal, options?.lastEventId, ['ping', 'open'], options?.reconnect === false ? undefined : (lastEventId, signal) => this._client.rawRequest(_spec, { ...options, lastEventId, signal }));
+  }
 }

package/src/resources/profiles.ts

@@ -1,7 +1,7 @@
 // Generated by redwood. Do not edit by hand.
 
 import { HttpClient, RequestOptions, APIPromise } from '../core/http.js';
-import type { Profile } from '../types.js';
+import type { WhoamiResponse } from '../types.js';
 
 export class Profiles {
   constructor(private readonly _client: HttpClient) {}
@@ -11,11 +11,11 @@ export class Profiles {
    * 
    * @example
    * ```ts
-   * const profile = await client.profiles.whoami();
+   * const whoamiResponse = await client.profiles.whoami();
    * ```
    */
-  whoami(options?: RequestOptions): APIPromise<Profile> {
-    return this._client.requestAPI<Profile>(() => {
+  whoami(options?: RequestOptions): APIPromise<WhoamiResponse> {
+    return this._client.requestAPI<WhoamiResponse>(() => {
       return { method: 'GET', path: `/v1/whoami` };
     }, options);
   }