@cadenya/cadenya 1.1.0 → 1.2.0

package/dist/webhooks.d.ts

@@ -78,7 +78,13 @@ export type ObjectiveEventMemoryReadWebhookEvent = ObjectiveEventWebhookData & {
 export type ObjectiveEventReasoningWebhookEvent = ObjectiveEventWebhookData & {
     type: 'objective_event.reasoning';
 };
-export type UnwrapWebhookEvent = ObjectiveEventUserMessageWebhookEvent | ObjectiveEventAssistantMessageWebhookEvent | ObjectiveEventToolResultWebhookEvent | ObjectiveEventToolApprovalRequestedWebhookEvent | ObjectiveEventToolCalledWebhookEvent | ObjectiveEventToolApprovedWebhookEvent | ObjectiveEventToolDeniedWebhookEvent | ObjectiveEventToolErrorWebhookEvent | ObjectiveEventSubAgentSpawnedWebhookEvent | ObjectiveEventSubAgentUpdatedWebhookEvent | ObjectiveEventErrorWebhookEvent | ObjectiveEventMemoryReadWebhookEvent | ObjectiveEventReasoningWebhookEvent;
+/**
+ * Objective state changed event
+ */
+export type ObjectiveEventStateChangedWebhookEvent = ObjectiveEventWebhookData & {
+    type: 'objective_event.state_changed';
+};
+export type UnwrapWebhookEvent = ObjectiveEventUserMessageWebhookEvent | ObjectiveEventAssistantMessageWebhookEvent | ObjectiveEventToolResultWebhookEvent | ObjectiveEventToolApprovalRequestedWebhookEvent | ObjectiveEventToolCalledWebhookEvent | ObjectiveEventToolApprovedWebhookEvent | ObjectiveEventToolDeniedWebhookEvent | ObjectiveEventToolErrorWebhookEvent | ObjectiveEventSubAgentSpawnedWebhookEvent | ObjectiveEventSubAgentUpdatedWebhookEvent | ObjectiveEventErrorWebhookEvent | ObjectiveEventMemoryReadWebhookEvent | ObjectiveEventReasoningWebhookEvent | ObjectiveEventStateChangedWebhookEvent;
 export declare class Webhooks {
     private readonly secret;
     constructor(secret: string | undefined);

package/dist/webhooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../src/webhooks.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,cAAc,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC3F,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,qCAAqC,GAAG,yBAAyB,GAAG;IAAE,IAAI,EAAE,8BAA8B,CAAA;CAAE,CAAC;AAEzH;;GAEG;AACH,MAAM,MAAM,0CAA0C,GAAG,yBAAyB,GAAG;IAAE,IAAI,EAAE,mCAAmC,CAAA;CAAE,CAAC;AAEnI;;GAEG;AACH,MAAM,MAAM,oCAAoC,GAAG,yBAAyB,GAAG;IAAE,IAAI,EAAE,6BAA6B,CAAA;CAAE,CAAC;AAEvH;;GAEG;AACH,MAAM,MAAM,+CAA+C,GAAG,yBAAyB,GAAG;IAAE,IAAI,EAAE,yCAAyC,CAAA;CAAE,CAAC;AAE9I;;GAEG;AACH,MAAM,MAAM,oCAAoC,GAAG,yBAAyB,GAAG;IAAE,IAAI,EAAE,6BAA6B,CAAA;CAAE,CAAC;AAEvH;;GAEG;AACH,MAAM,MAAM,sCAAsC,GAAG,yBAAyB,GAAG;IAAE,IAAI,EAAE,+BAA+B,CAAA;CAAE,CAAC;AAE3H;;GAEG;AACH,MAAM,MAAM,oCAAoC,GAAG,yBAAyB,GAAG;IAAE,IAAI,EAAE,6BAA6B,CAAA;CAAE,CAAC;AAEvH;;GAEG;AACH,MAAM,MAAM,mCAAmC,GAAG,yBAAyB,GAAG;IAAE,IAAI,EAAE,4BAA4B,CAAA;CAAE,CAAC;AAErH;;GAEG;AACH,MAAM,MAAM,yCAAyC,GAAG,yBAAyB,GAAG;IAAE,IAAI,EAAE,mCAAmC,CAAA;CAAE,CAAC;AAElI;;GAEG;AACH,MAAM,MAAM,yCAAyC,GAAG,yBAAyB,GAAG;IAAE,IAAI,EAAE,mCAAmC,CAAA;CAAE,CAAC;AAElI;;GAEG;AACH,MAAM,MAAM,+BAA+B,GAAG,yBAAyB,GAAG;IAAE,IAAI,EAAE,uBAAuB,CAAA;CAAE,CAAC;AAE5G;;GAEG;AACH,MAAM,MAAM,oCAAoC,GAAG,yBAAyB,GAAG;IAAE,IAAI,EAAE,6BAA6B,CAAA;CAAE,CAAC;AAEvH;;GAEG;AACH,MAAM,MAAM,mCAAmC,GAAG,yBAAyB,GAAG;IAAE,IAAI,EAAE,2BAA2B,CAAA;CAAE,CAAC;AAEpH,MAAM,MAAM,kBAAkB,GAC1B,qCAAqC,GACrC,0CAA0C,GAC1C,oCAAoC,GACpC,+CAA+C,GAC/C,oCAAoC,GACpC,sCAAsC,GACtC,oCAAoC,GACpC,mCAAmC,GACnC,yCAAyC,GACzC,yCAAyC,GACzC,+BAA+B,GAC/B,oCAAoC,GACpC,mCAAmC,CAAC;AAExC,qBAAa,QAAQ;IACP,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM,GAAG,SAAS;IAEvD;;;OAGG;IACG,MAAM,CACV,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,oBAAoB,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GACnD,OAAO,CAAC,kBAAkB,CAAC;CAU/B"}
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../src/webhooks.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,cAAc,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC3F,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,qCAAqC,GAAG,yBAAyB,GAAG;IAAE,IAAI,EAAE,8BAA8B,CAAA;CAAE,CAAC;AAEzH;;GAEG;AACH,MAAM,MAAM,0CAA0C,GAAG,yBAAyB,GAAG;IAAE,IAAI,EAAE,mCAAmC,CAAA;CAAE,CAAC;AAEnI;;GAEG;AACH,MAAM,MAAM,oCAAoC,GAAG,yBAAyB,GAAG;IAAE,IAAI,EAAE,6BAA6B,CAAA;CAAE,CAAC;AAEvH;;GAEG;AACH,MAAM,MAAM,+CAA+C,GAAG,yBAAyB,GAAG;IAAE,IAAI,EAAE,yCAAyC,CAAA;CAAE,CAAC;AAE9I;;GAEG;AACH,MAAM,MAAM,oCAAoC,GAAG,yBAAyB,GAAG;IAAE,IAAI,EAAE,6BAA6B,CAAA;CAAE,CAAC;AAEvH;;GAEG;AACH,MAAM,MAAM,sCAAsC,GAAG,yBAAyB,GAAG;IAAE,IAAI,EAAE,+BAA+B,CAAA;CAAE,CAAC;AAE3H;;GAEG;AACH,MAAM,MAAM,oCAAoC,GAAG,yBAAyB,GAAG;IAAE,IAAI,EAAE,6BAA6B,CAAA;CAAE,CAAC;AAEvH;;GAEG;AACH,MAAM,MAAM,mCAAmC,GAAG,yBAAyB,GAAG;IAAE,IAAI,EAAE,4BAA4B,CAAA;CAAE,CAAC;AAErH;;GAEG;AACH,MAAM,MAAM,yCAAyC,GAAG,yBAAyB,GAAG;IAAE,IAAI,EAAE,mCAAmC,CAAA;CAAE,CAAC;AAElI;;GAEG;AACH,MAAM,MAAM,yCAAyC,GAAG,yBAAyB,GAAG;IAAE,IAAI,EAAE,mCAAmC,CAAA;CAAE,CAAC;AAElI;;GAEG;AACH,MAAM,MAAM,+BAA+B,GAAG,yBAAyB,GAAG;IAAE,IAAI,EAAE,uBAAuB,CAAA;CAAE,CAAC;AAE5G;;GAEG;AACH,MAAM,MAAM,oCAAoC,GAAG,yBAAyB,GAAG;IAAE,IAAI,EAAE,6BAA6B,CAAA;CAAE,CAAC;AAEvH;;GAEG;AACH,MAAM,MAAM,mCAAmC,GAAG,yBAAyB,GAAG;IAAE,IAAI,EAAE,2BAA2B,CAAA;CAAE,CAAC;AAEpH;;GAEG;AACH,MAAM,MAAM,sCAAsC,GAAG,yBAAyB,GAAG;IAAE,IAAI,EAAE,+BAA+B,CAAA;CAAE,CAAC;AAE3H,MAAM,MAAM,kBAAkB,GAC1B,qCAAqC,GACrC,0CAA0C,GAC1C,oCAAoC,GACpC,+CAA+C,GAC/C,oCAAoC,GACpC,sCAAsC,GACtC,oCAAoC,GACpC,mCAAmC,GACnC,yCAAyC,GACzC,yCAAyC,GACzC,+BAA+B,GAC/B,oCAAoC,GACpC,mCAAmC,GACnC,sCAAsC,CAAC;AAE3C,qBAAa,QAAQ;IACP,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM,GAAG,SAAS;IAEvD;;;OAGG;IACG,MAAM,CACV,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,oBAAoB,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GACnD,OAAO,CAAC,kBAAkB,CAAC;CAU/B"}

package/dist/webhooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../src/webhooks.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAE7C,OAAO,EAAE,eAAe,EAAwC,MAAM,oBAAoB,CAAC;AAmF3F,MAAM,OAAO,QAAQ;IACU;IAA7B,YAA6B,MAA0B;QAA1B,WAAM,GAAN,MAAM,CAAoB;IAAG,CAAC;IAE3D;;;OAGG;IACH,KAAK,CAAC,MAAM,CACV,OAAe,EACf,OAAuB,EACvB,OAAoD;QAEpD,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC;QACxD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CACb,2IAA2I,CAC5I,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAuB,CAAC;IACnD,CAAC;CACF","sourcesContent":["// Generated by redwood. Do not edit by hand.\n\nimport { WebhookVerifier, WebhookHeaders, WebhookVerifyOptions } from './core/webhooks.js';\nimport type { ObjectiveEventWebhookData } from './types.js';\n\n/**\n * Objective user message event\n */\nexport type ObjectiveEventUserMessageWebhookEvent = ObjectiveEventWebhookData & { type: 'objective_event.user_message' };\n\n/**\n * Objective assistant message event\n */\nexport type ObjectiveEventAssistantMessageWebhookEvent = ObjectiveEventWebhookData & { type: 'objective_event.assistant_message' };\n\n/**\n * Objective tool result event\n */\nexport type ObjectiveEventToolResultWebhookEvent = ObjectiveEventWebhookData & { type: 'objective_event.tool_result' };\n\n/**\n * Objective tool approval requested event\n */\nexport type ObjectiveEventToolApprovalRequestedWebhookEvent = ObjectiveEventWebhookData & { type: 'objective_event.tool_approval_requested' };\n\n/**\n * Objective tool called event\n */\nexport type ObjectiveEventToolCalledWebhookEvent = ObjectiveEventWebhookData & { type: 'objective_event.tool_called' };\n\n/**\n * Objective tool approved event\n */\nexport type ObjectiveEventToolApprovedWebhookEvent = ObjectiveEventWebhookData & { type: 'objective_event.tool_approved' };\n\n/**\n * Objective tool denied event\n */\nexport type ObjectiveEventToolDeniedWebhookEvent = ObjectiveEventWebhookData & { type: 'objective_event.tool_denied' };\n\n/**\n * Objective tool error event\n */\nexport type ObjectiveEventToolErrorWebhookEvent = ObjectiveEventWebhookData & { type: 'objective_event.tool_error' };\n\n/**\n * Objective sub-agent spawned event\n */\nexport type ObjectiveEventSubAgentSpawnedWebhookEvent = ObjectiveEventWebhookData & { type: 'objective_event.sub_agent_spawned' };\n\n/**\n * Objective sub-agent updated event\n */\nexport type ObjectiveEventSubAgentUpdatedWebhookEvent = ObjectiveEventWebhookData & { type: 'objective_event.sub_agent_updated' };\n\n/**\n * Objective error event\n */\nexport type ObjectiveEventErrorWebhookEvent = ObjectiveEventWebhookData & { type: 'objective_event.error' };\n\n/**\n * Objective memory read event\n */\nexport type ObjectiveEventMemoryReadWebhookEvent = ObjectiveEventWebhookData & { type: 'objective_event.memory_read' };\n\n/**\n * Objective reasoning event\n */\nexport type ObjectiveEventReasoningWebhookEvent = ObjectiveEventWebhookData & { type: 'objective_event.reasoning' };\n\nexport type UnwrapWebhookEvent =\n  | ObjectiveEventUserMessageWebhookEvent\n  | ObjectiveEventAssistantMessageWebhookEvent\n  | ObjectiveEventToolResultWebhookEvent\n  | ObjectiveEventToolApprovalRequestedWebhookEvent\n  | ObjectiveEventToolCalledWebhookEvent\n  | ObjectiveEventToolApprovedWebhookEvent\n  | ObjectiveEventToolDeniedWebhookEvent\n  | ObjectiveEventToolErrorWebhookEvent\n  | ObjectiveEventSubAgentSpawnedWebhookEvent\n  | ObjectiveEventSubAgentUpdatedWebhookEvent\n  | ObjectiveEventErrorWebhookEvent\n  | ObjectiveEventMemoryReadWebhookEvent\n  | ObjectiveEventReasoningWebhookEvent;\n\nexport class Webhooks {\n  constructor(private readonly secret: string | undefined) {}\n\n  /**\n   * Verify a Standard Webhooks delivery (webhook-id / webhook-timestamp /\n   * webhook-signature headers) and return its typed payload.\n   */\n  async unwrap(\n    payload: string,\n    headers: WebhookHeaders,\n    options?: WebhookVerifyOptions & { secret?: string },\n  ): Promise<UnwrapWebhookEvent> {\n    const secret = (options?.secret ?? this.secret)?.trim();\n    if (!secret) {\n      throw new Error(\n        \"Missing webhook secret. Pass { secret }, construct the client with webhookSecret, or set the CADENYA_WEBHOOK_SECRET environment variable.\",\n      );\n    }\n    await new WebhookVerifier(secret).verify(payload, headers, options);\n    return JSON.parse(payload) as UnwrapWebhookEvent;\n  }\n}\n"]}
+{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../src/webhooks.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAE7C,OAAO,EAAE,eAAe,EAAwC,MAAM,oBAAoB,CAAC;AAyF3F,MAAM,OAAO,QAAQ;IACU;IAA7B,YAA6B,MAA0B;QAA1B,WAAM,GAAN,MAAM,CAAoB;IAAG,CAAC;IAE3D;;;OAGG;IACH,KAAK,CAAC,MAAM,CACV,OAAe,EACf,OAAuB,EACvB,OAAoD;QAEpD,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC;QACxD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CACb,2IAA2I,CAC5I,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAuB,CAAC;IACnD,CAAC;CACF","sourcesContent":["// Generated by redwood. Do not edit by hand.\n\nimport { WebhookVerifier, WebhookHeaders, WebhookVerifyOptions } from './core/webhooks.js';\nimport type { ObjectiveEventWebhookData } from './types.js';\n\n/**\n * Objective user message event\n */\nexport type ObjectiveEventUserMessageWebhookEvent = ObjectiveEventWebhookData & { type: 'objective_event.user_message' };\n\n/**\n * Objective assistant message event\n */\nexport type ObjectiveEventAssistantMessageWebhookEvent = ObjectiveEventWebhookData & { type: 'objective_event.assistant_message' };\n\n/**\n * Objective tool result event\n */\nexport type ObjectiveEventToolResultWebhookEvent = ObjectiveEventWebhookData & { type: 'objective_event.tool_result' };\n\n/**\n * Objective tool approval requested event\n */\nexport type ObjectiveEventToolApprovalRequestedWebhookEvent = ObjectiveEventWebhookData & { type: 'objective_event.tool_approval_requested' };\n\n/**\n * Objective tool called event\n */\nexport type ObjectiveEventToolCalledWebhookEvent = ObjectiveEventWebhookData & { type: 'objective_event.tool_called' };\n\n/**\n * Objective tool approved event\n */\nexport type ObjectiveEventToolApprovedWebhookEvent = ObjectiveEventWebhookData & { type: 'objective_event.tool_approved' };\n\n/**\n * Objective tool denied event\n */\nexport type ObjectiveEventToolDeniedWebhookEvent = ObjectiveEventWebhookData & { type: 'objective_event.tool_denied' };\n\n/**\n * Objective tool error event\n */\nexport type ObjectiveEventToolErrorWebhookEvent = ObjectiveEventWebhookData & { type: 'objective_event.tool_error' };\n\n/**\n * Objective sub-agent spawned event\n */\nexport type ObjectiveEventSubAgentSpawnedWebhookEvent = ObjectiveEventWebhookData & { type: 'objective_event.sub_agent_spawned' };\n\n/**\n * Objective sub-agent updated event\n */\nexport type ObjectiveEventSubAgentUpdatedWebhookEvent = ObjectiveEventWebhookData & { type: 'objective_event.sub_agent_updated' };\n\n/**\n * Objective error event\n */\nexport type ObjectiveEventErrorWebhookEvent = ObjectiveEventWebhookData & { type: 'objective_event.error' };\n\n/**\n * Objective memory read event\n */\nexport type ObjectiveEventMemoryReadWebhookEvent = ObjectiveEventWebhookData & { type: 'objective_event.memory_read' };\n\n/**\n * Objective reasoning event\n */\nexport type ObjectiveEventReasoningWebhookEvent = ObjectiveEventWebhookData & { type: 'objective_event.reasoning' };\n\n/**\n * Objective state changed event\n */\nexport type ObjectiveEventStateChangedWebhookEvent = ObjectiveEventWebhookData & { type: 'objective_event.state_changed' };\n\nexport type UnwrapWebhookEvent =\n  | ObjectiveEventUserMessageWebhookEvent\n  | ObjectiveEventAssistantMessageWebhookEvent\n  | ObjectiveEventToolResultWebhookEvent\n  | ObjectiveEventToolApprovalRequestedWebhookEvent\n  | ObjectiveEventToolCalledWebhookEvent\n  | ObjectiveEventToolApprovedWebhookEvent\n  | ObjectiveEventToolDeniedWebhookEvent\n  | ObjectiveEventToolErrorWebhookEvent\n  | ObjectiveEventSubAgentSpawnedWebhookEvent\n  | ObjectiveEventSubAgentUpdatedWebhookEvent\n  | ObjectiveEventErrorWebhookEvent\n  | ObjectiveEventMemoryReadWebhookEvent\n  | ObjectiveEventReasoningWebhookEvent\n  | ObjectiveEventStateChangedWebhookEvent;\n\nexport class Webhooks {\n  constructor(private readonly secret: string | undefined) {}\n\n  /**\n   * Verify a Standard Webhooks delivery (webhook-id / webhook-timestamp /\n   * webhook-signature headers) and return its typed payload.\n   */\n  async unwrap(\n    payload: string,\n    headers: WebhookHeaders,\n    options?: WebhookVerifyOptions & { secret?: string },\n  ): Promise<UnwrapWebhookEvent> {\n    const secret = (options?.secret ?? this.secret)?.trim();\n    if (!secret) {\n      throw new Error(\n        \"Missing webhook secret. Pass { secret }, construct the client with webhookSecret, or set the CADENYA_WEBHOOK_SECRET environment variable.\",\n      );\n    }\n    await new WebhookVerifier(secret).verify(payload, headers, options);\n    return JSON.parse(payload) as UnwrapWebhookEvent;\n  }\n}\n"]}

package/package.json

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

package/src/client.ts

@@ -85,7 +85,7 @@ export class Cadenya {
       authHeader: () => ({ Authorization: `Bearer ${apiKey}` }),
       maxRetries: options.maxRetries ?? 0,
       timeout: options.timeout,
-      defaultHeaders: { 'User-Agent': 'cadenya-typescript/1.0.2 (api 1.0)', ...options.defaultHeaders },
+      defaultHeaders: { 'User-Agent': 'cadenya-typescript/1.2.0 (api 1.0)', ...options.defaultHeaders },
       fetch: options.fetch,
       logger: options.logger,
       logLevel: options.logLevel,

package/src/resources/agent-variations.ts

@@ -2,8 +2,8 @@
 
 import { HttpClient, RequestOptions, APIPromise, pathSegment, snapshotParams } from '../core/http.js';
 import { Page } from '../core/pagination.js';
-import type { AddAgentVariationAssignmentRequestParam, AgentVariation, AgentVariationSpec, CreateResourceMetadata, ListAgentVariationsResponse, UpdateResourceMetadata, VariationAssignment, VariationMemoryLayerAssignment } from '../types.js';
-import { wireAddAgentVariationAssignmentRequest } from '../types.js';
+import type { AddAgentVariationAssignmentRequestParam, AgentVariation, AgentVariationSpec, CreateResourceMetadata, ListAgentVariationsResponse, RemoveAgentVariationAssignmentRequestParam, UpdateResourceMetadata } from '../types.js';
+import { wireAddAgentVariationAssignmentRequest, wireRemoveAgentVariationAssignmentRequest } from '../types.js';
 
 export interface AgentVariationListParams {
   /**
@@ -76,32 +76,25 @@ export interface AgentVariationUpdateParams {
   metadata?: UpdateResourceMetadata;
   spec?: AgentVariationSpec;
   /**
-   * Fields to update
+   * Fields to update. Assignment lists are replaced as a whole, never merged.
+   *  Select spec.assignments or spec.memory_layer_assignments to replace/clear
+   *  one list. Selecting spec replaces the entire spec (including omitted lists);
+   *  * replaces all mutable fields. Element/index paths are not supported.
+   *  Without a mask, infer paths from non-empty fields: non-empty assignment
+   *  lists replace existing lists, while omitted/empty lists remain unchanged.
+   *  To clear a list, explicitly include its path in the mask.
    */
   updateMask?: string;
 }
 
-export interface AgentVariationAddAssignmentParams {
-  /**
-   * The request body, sent as-is.
-   */
-  body: AddAgentVariationAssignmentRequestParam;
-  /**
-   * Workspace ID.
-   * 
-   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
-   */
-  workspaceId?: string;
-}
-
-export interface AgentVariationRemoveAssignmentParams {
+export type AgentVariationAddAssignmentParams = AddAgentVariationAssignmentRequestParam & {
   /**
    * Workspace ID.
    * 
    * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
    */
   workspaceId?: string;
-}
+};
 
 export interface AgentVariationAddMemoryLayerParams {
   /**
@@ -122,26 +115,43 @@ export interface AgentVariationAddMemoryLayerParams {
   position?: number;
 }
 
-export interface AgentVariationRemoveMemoryLayerParams {
+export type AgentVariationRemoveAssignmentParams = RemoveAgentVariationAssignmentRequestParam & {
   /**
    * Workspace ID.
    * 
    * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
    */
   workspaceId?: string;
-}
+};
 
-export interface AgentVariationUpdateMemoryLayerParams {
+export interface AgentVariationRemoveMemoryLayerParams {
+  /**
+   * Layer to detach. Accepts memlyr_… or external_id:<value>.
+   */
+  memoryLayerId: string;
   /**
    * Workspace ID.
    * 
    * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
    */
   workspaceId?: string;
+}
+
+export interface AgentVariationUpdateMemoryLayerParams {
+  /**
+   * Layer to reposition. Accepts memlyr_… or external_id:<value>.
+   */
+  memoryLayerId: string;
   /**
    * New position. Only field currently updatable on an assignment.
    */
-  position?: number;
+  position: number;
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
 }
 
 export class AgentVariations {
@@ -235,46 +245,48 @@ export class AgentVariations {
    * 
    * @example
    * ```ts
-   * const variationAssignment = await client.agents.variations.addAssignment('agent_123', 'variation_123', { body: { toolId: 'sample', type: 'toolId' } });
+   * const agentVariation = await client.agents.variations.addAssignment('agent_123', 'variation_123', { toolId: 'sample', type: 'toolId' });
    * ```
    */
-  addAssignment(agentId: string, variationId: string, params: AgentVariationAddAssignmentParams, options?: RequestOptions): APIPromise<VariationAssignment> {
-    return this._client.requestAPI<VariationAssignment>(() => {
+  addAssignment(agentId: string, variationId: string, params: AgentVariationAddAssignmentParams, options?: RequestOptions): APIPromise<AgentVariation> {
+    return this._client.requestAPI<AgentVariation>(() => {
+      const { workspaceId: _bodyParam0, ..._body } = params;
       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)}/agents/${pathSegment('agentId', agentId)}/variations/${pathSegment('variationId', variationId)}/assignments`, body: wireAddAgentVariationAssignmentRequest(params.body) };
+      return { method: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/agents/${pathSegment('agentId', agentId)}/variations/${pathSegment('variationId', variationId)}:addAssignment`, body: wireAddAgentVariationAssignmentRequest(_body) };
     }, options);
   }
 
   /**
-   * Remove an assignment from a variation
+   * Attach a memory layer to a variation
    * 
    * @example
    * ```ts
-   * await client.agents.variations.removeAssignment('agent_123', 'variation_123', '_123');
+   * const agentVariation = await client.agents.variations.addMemoryLayer('agent_123', 'variation_123', { memoryLayerId: 'sample' });
    * ```
    */
-  removeAssignment(agentId: string, variationId: string, id: string, params?: AgentVariationRemoveAssignmentParams, options?: RequestOptions): APIPromise<void> {
-    return this._client.requestAPI<void>(() => {
-      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+  addMemoryLayer(agentId: string, variationId: string, params: AgentVariationAddMemoryLayerParams, options?: RequestOptions): APIPromise<AgentVariation> {
+    return this._client.requestAPI<AgentVariation>(() => {
+      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)}/agents/${pathSegment('agentId', agentId)}/variations/${pathSegment('variationId', variationId)}/assignments/${pathSegment('id', id)}`, void: true };
+      return { method: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/agents/${pathSegment('agentId', agentId)}/variations/${pathSegment('variationId', variationId)}:addMemoryLayer`, body: { memoryLayerId: params.memoryLayerId, position: params.position } };
     }, options);
   }
 
   /**
-   * Attach a memory layer to a variation
+   * Remove an assignment from a variation
    * 
    * @example
    * ```ts
-   * const variationMemoryLayerAssignment = await client.agents.variations.addMemoryLayer('agent_123', 'variation_123', { memoryLayerId: 'sample' });
+   * const agentVariation = await client.agents.variations.removeAssignment('agent_123', 'variation_123', { toolId: 'sample', type: 'toolId' });
    * ```
    */
-  addMemoryLayer(agentId: string, variationId: string, params: AgentVariationAddMemoryLayerParams, options?: RequestOptions): APIPromise<VariationMemoryLayerAssignment> {
-    return this._client.requestAPI<VariationMemoryLayerAssignment>(() => {
+  removeAssignment(agentId: string, variationId: string, params: AgentVariationRemoveAssignmentParams, options?: RequestOptions): APIPromise<AgentVariation> {
+    return this._client.requestAPI<AgentVariation>(() => {
+      const { workspaceId: _bodyParam0, ..._body } = params;
       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)}/agents/${pathSegment('agentId', agentId)}/variations/${pathSegment('variationId', variationId)}/memory_layer_assignments`, body: { memoryLayerId: params.memoryLayerId, position: params.position } };
+      return { method: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/agents/${pathSegment('agentId', agentId)}/variations/${pathSegment('variationId', variationId)}:removeAssignment`, body: wireRemoveAgentVariationAssignmentRequest(_body) };
     }, options);
   }
 
@@ -283,14 +295,14 @@ export class AgentVariations {
    * 
    * @example
    * ```ts
-   * await client.agents.variations.removeMemoryLayer('agent_123', 'variation_123', '_123');
+   * const agentVariation = await client.agents.variations.removeMemoryLayer('agent_123', 'variation_123', { memoryLayerId: 'sample' });
    * ```
    */
-  removeMemoryLayer(agentId: string, variationId: string, id: string, params?: AgentVariationRemoveMemoryLayerParams, options?: RequestOptions): APIPromise<void> {
-    return this._client.requestAPI<void>(() => {
-      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+  removeMemoryLayer(agentId: string, variationId: string, params: AgentVariationRemoveMemoryLayerParams, options?: RequestOptions): APIPromise<AgentVariation> {
+    return this._client.requestAPI<AgentVariation>(() => {
+      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)}/agents/${pathSegment('agentId', agentId)}/variations/${pathSegment('variationId', variationId)}/memory_layer_assignments/${pathSegment('id', id)}`, void: true };
+      return { method: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/agents/${pathSegment('agentId', agentId)}/variations/${pathSegment('variationId', variationId)}:removeMemoryLayer`, body: { memoryLayerId: params.memoryLayerId } };
     }, options);
   }
 
@@ -299,14 +311,14 @@ export class AgentVariations {
    * 
    * @example
    * ```ts
-   * const variationMemoryLayerAssignment = await client.agents.variations.updateMemoryLayer('agent_123', 'variation_123', '_123');
+   * const agentVariation = await client.agents.variations.updateMemoryLayer('agent_123', 'variation_123', { memoryLayerId: 'sample', position: 1 });
    * ```
    */
-  updateMemoryLayer(agentId: string, variationId: string, id: string, params?: AgentVariationUpdateMemoryLayerParams, options?: RequestOptions): APIPromise<VariationMemoryLayerAssignment> {
-    return this._client.requestAPI<VariationMemoryLayerAssignment>(() => {
-      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+  updateMemoryLayer(agentId: string, variationId: string, params: AgentVariationUpdateMemoryLayerParams, options?: RequestOptions): APIPromise<AgentVariation> {
+    return this._client.requestAPI<AgentVariation>(() => {
+      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)}/agents/${pathSegment('agentId', agentId)}/variations/${pathSegment('variationId', variationId)}/memory_layer_assignments/${pathSegment('id', id)}`, body: { position: params?.position } };
+      return { method: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/agents/${pathSegment('agentId', agentId)}/variations/${pathSegment('variationId', variationId)}:updateMemoryLayer`, body: { memoryLayerId: params.memoryLayerId, position: params.position } };
     }, options);
   }
 }

package/src/resources/agents.ts

@@ -65,7 +65,9 @@ export interface AgentCreateParams {
    */
   workspaceId?: string;
   /**
-   * Optional default variation to add to the agent on create
+   * Optional default variation to add to the agent on create. Its spec accepts
+   *  assignments and memory_layer_assignments using the same atomic validation
+   *  as CreateAgentVariation. Failure rejects the entire agent creation.
    */
   defaultVariation?: CreateAgentVariationRequestParam;
 }

package/src/resources/tool-search.ts

@@ -21,7 +21,7 @@ export class ToolSearch {
    * 
    * @example
    * ```ts
-   * const searchToolsOrToolSetsResponse = await client.toolSearch.searchOrSets({ query: 'query_123' });
+   * const searchToolsOrToolSetsResponse = await client.toolSearch.searchOrSets({ query: 'sample' });
    * ```
    */
   searchOrSets(params: ToolSearchSearchOrSetsParams, options?: RequestOptions): APIPromise<SearchToolsOrToolSetsResponse> {