@cadenya/cadenya 0.42.0 → 0.43.0

package/src/resources/{agents/variations.ts → agent-variations.ts}

@@ -1,19 +1,23 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../../core/resource';
-import * as AccountAPI from '../account';
-import * as Shared from '../shared';
-import { APIPromise } from '../../core/api-promise';
-import { CursorPagination, type CursorPaginationParams, PagePromise } from '../../core/pagination';
-import { buildHeaders } from '../../internal/headers';
-import { RequestOptions } from '../../internal/request-options';
-import { path } from '../../internal/utils/path';
+import { APIResource } from '../core/resource';
+import * as AccountAPI from './account';
+import * as Shared from './shared';
+import { APIPromise } from '../core/api-promise';
+import { CursorPagination, type CursorPaginationParams, PagePromise } from '../core/pagination';
+import { buildHeaders } from '../internal/headers';
+import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
 
-export class Variations extends APIResource {
+export class AgentVariations extends APIResource {
   /**
    * Creates a new variation for an agent
    */
-  create(agentID: string, body: VariationCreateParams, options?: RequestOptions): APIPromise<AgentVariation> {
+  create(
+    agentID: string,
+    body: AgentVariationCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<AgentVariation> {
     return this._client.post(path`/v1/agents/${agentID}/variations`, { body, ...options });
   }
 
@@ -22,7 +26,7 @@ export class Variations extends APIResource {
    */
   retrieve(
     id: string,
-    params: VariationRetrieveParams,
+    params: AgentVariationRetrieveParams,
     options?: RequestOptions,
   ): APIPromise<AgentVariation> {
     const { agentId } = params;
@@ -32,7 +36,11 @@ export class Variations extends APIResource {
   /**
    * Updates a variation for an agent
    */
-  update(id: string, params: VariationUpdateParams, options?: RequestOptions): APIPromise<AgentVariation> {
+  update(
+    id: string,
+    params: AgentVariationUpdateParams,
+    options?: RequestOptions,
+  ): APIPromise<AgentVariation> {
     const { agentId, ...body } = params;
     return this._client.patch(path`/v1/agents/${agentId}/variations/${id}`, { body, ...options });
   }
@@ -42,7 +50,7 @@ export class Variations extends APIResource {
    */
   list(
     agentID: string,
-    query: VariationListParams | null | undefined = {},
+    query: AgentVariationListParams | null | undefined = {},
     options?: RequestOptions,
   ): PagePromise<AgentVariationsCursorPagination, AgentVariation> {
     return this._client.getAPIList(path`/v1/agents/${agentID}/variations`, CursorPagination<AgentVariation>, {
@@ -54,13 +62,44 @@ export class Variations extends APIResource {
   /**
    * Deletes a variation from an agent
    */
-  delete(id: string, params: VariationDeleteParams, options?: RequestOptions): APIPromise<void> {
+  delete(id: string, params: AgentVariationDeleteParams, options?: RequestOptions): APIPromise<void> {
     const { agentId } = params;
     return this._client.delete(path`/v1/agents/${agentId}/variations/${id}`, {
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
   }
+
+  /**
+   * Assigns a tool, tool set, or sub-agent to a variation. Exactly one target ID
+   * must be set.
+   */
+  addAssignment(
+    agentVariationID: string,
+    body: AgentVariationAddAssignmentParams,
+    options?: RequestOptions,
+  ): APIPromise<VariationAssignment> {
+    return this._client.post(path`/v1/agent_variations/${agentVariationID}/assignments`, {
+      body,
+      ...options,
+    });
+  }
+
+  /**
+   * Detaches an assignment from a variation, identified by the assignment ID
+   * returned when it was added.
+   */
+  removeAssignment(
+    id: string,
+    params: AgentVariationRemoveAssignmentParams,
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    const { agentVariationId } = params;
+    return this._client.delete(path`/v1/agent_variations/${agentVariationId}/assignments/${id}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
 }
 
 export type AgentVariationsCursorPagination = CursorPagination<AgentVariation>;
@@ -89,6 +128,13 @@ export interface AgentVariation {
  * AgentVariationInfo provides read-only summary information about a variation
  */
 export interface AgentVariationInfo {
+  /**
+   * All tools, tool sets, and sub-agents assigned to this variation. Populated on
+   * reads so clients can render a variation's full assignment list without calling
+   * the add/remove endpoints just to enumerate.
+   */
+  assignments?: Array<VariationAssignment>;
+
   /**
    * Profile represents a human user at the account level. Profiles are
    * account-scoped resources that can be associated with multiple workspaces through
@@ -132,11 +178,6 @@ export interface AgentVariationInfo {
  * AgentVariationSpec defines the operational configuration for a variation
  */
 export interface AgentVariationSpec {
-  /**
-   * Tools assigned to this variation
-   */
-  agentTools?: Array<AgentVariationSpecAgentTool>;
-
   /**
    * CompactionConfig defines how context window compaction behaves for objectives
    * using this variation.
@@ -192,29 +233,6 @@ export interface AgentVariationSpec {
   weight?: number;
 }
 
-export interface AgentVariationSpecAgentTool {
-  agentId?: string;
-
-  /**
-   * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
-   */
-  agentMetadata?: Shared.ResourceMetadata;
-
-  toolId?: string;
-
-  /**
-   * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
-   */
-  toolMetadata?: Shared.ResourceMetadata;
-
-  toolSetId?: string;
-
-  /**
-   * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
-   */
-  toolSetMetadata?: Shared.ResourceMetadata;
-}
-
 /**
  * CompactionConfig defines how context window compaction behaves for objectives
  * using this variation.
@@ -297,13 +315,6 @@ export interface CompactionConfigSummarizationStrategy {
    * variable names, and technical decisions."
    */
   instructions?: string;
-
-  /**
-   * Minimum number of recent message turns to always preserve during compaction.
-   * These turns are never summarized, ensuring recent context stays intact. Default:
-   * 4
-   */
-  minPreserveTurns?: number;
 }
 
 /**
@@ -340,7 +351,51 @@ export interface ToolSelectionAutoDiscovery {
   maxTools?: number;
 }
 
-export interface VariationCreateParams {
+/**
+ * VariationAssignment is a read-only reference to a single tool, tool set, or
+ * sub-agent attached to a variation. Clients read the full set of assignments via
+ * `AgentVariationInfo.assignments`; mutations go through the dedicated add/remove
+ * assignment endpoints under /v1/agent_variations/{id}/assignments.
+ *
+ * The `id` identifies the assignment row itself (not the referenced resource) and
+ * is the handle used to remove the assignment. It is returned by the add endpoint
+ * and present on every entry in AgentVariationInfo.assignments.
+ */
+export interface VariationAssignment {
+  id?: string;
+
+  /**
+   * BareMetadata contains the minimal metadata for a resource: the ID and an
+   * optional human-readable name. These are used for reference fields where the full
+   * metadata (account scoping, timestamps, labels, external IDs) is not needed —
+   * e.g., the tool references inside an agent variation spec or the tools assigned
+   * to an objective. Both fields are server-populated; clients provide IDs through
+   * sibling fields rather than by constructing a BareMetadata themselves.
+   */
+  agent?: Shared.BareMetadata;
+
+  /**
+   * BareMetadata contains the minimal metadata for a resource: the ID and an
+   * optional human-readable name. These are used for reference fields where the full
+   * metadata (account scoping, timestamps, labels, external IDs) is not needed —
+   * e.g., the tool references inside an agent variation spec or the tools assigned
+   * to an objective. Both fields are server-populated; clients provide IDs through
+   * sibling fields rather than by constructing a BareMetadata themselves.
+   */
+  tool?: Shared.BareMetadata;
+
+  /**
+   * BareMetadata contains the minimal metadata for a resource: the ID and an
+   * optional human-readable name. These are used for reference fields where the full
+   * metadata (account scoping, timestamps, labels, external IDs) is not needed —
+   * e.g., the tool references inside an agent variation spec or the tools assigned
+   * to an objective. Both fields are server-populated; clients provide IDs through
+   * sibling fields rather than by constructing a BareMetadata themselves.
+   */
+  toolSet?: Shared.BareMetadata;
+}
+
+export interface AgentVariationCreateParams {
   /**
    * CreateResourceMetadata contains the user-provided fields for creating a
    * workspace-scoped resource. Read-only fields (id, account_id, workspace_id,
@@ -354,14 +409,14 @@ export interface VariationCreateParams {
   spec: AgentVariationSpec;
 }
 
-export interface VariationRetrieveParams {
+export interface AgentVariationRetrieveParams {
   /**
    * Agent ID (from path)
    */
   agentId: string;
 }
 
-export interface VariationUpdateParams {
+export interface AgentVariationUpdateParams {
   /**
    * Path param: Agent ID (from path)
    */
@@ -387,7 +442,7 @@ export interface VariationUpdateParams {
   updateMask?: string;
 }
 
-export interface VariationListParams extends CursorPaginationParams {
+export interface AgentVariationListParams extends CursorPaginationParams {
   /**
    * When set to true you may use more of your alloted API rate-limit
    */
@@ -399,19 +454,30 @@ export interface VariationListParams extends CursorPaginationParams {
   sortOrder?: string;
 }
 
-export interface VariationDeleteParams {
+export interface AgentVariationDeleteParams {
   /**
    * Agent ID (from path)
    */
   agentId: string;
 }
 
-export declare namespace Variations {
+export interface AgentVariationAddAssignmentParams {
+  subAgentId?: string;
+
+  toolId?: string;
+
+  toolSetId?: string;
+}
+
+export interface AgentVariationRemoveAssignmentParams {
+  agentVariationId: string;
+}
+
+export declare namespace AgentVariations {
   export {
     type AgentVariation as AgentVariation,
     type AgentVariationInfo as AgentVariationInfo,
     type AgentVariationSpec as AgentVariationSpec,
-    type AgentVariationSpecAgentTool as AgentVariationSpecAgentTool,
     type AgentVariationSpecCompactionConfig as AgentVariationSpecCompactionConfig,
     type AgentVariationSpecConstraints as AgentVariationSpecConstraints,
     type AgentVariationSpecModelConfig as AgentVariationSpecModelConfig,
@@ -420,11 +486,14 @@ export declare namespace Variations {
     type CompactionConfigToolResultClearingStrategy as CompactionConfigToolResultClearingStrategy,
     type ToolSelectionAssignedTools as ToolSelectionAssignedTools,
     type ToolSelectionAutoDiscovery as ToolSelectionAutoDiscovery,
+    type VariationAssignment as VariationAssignment,
     type AgentVariationsCursorPagination as AgentVariationsCursorPagination,
-    type VariationCreateParams as VariationCreateParams,
-    type VariationRetrieveParams as VariationRetrieveParams,
-    type VariationUpdateParams as VariationUpdateParams,
-    type VariationListParams as VariationListParams,
-    type VariationDeleteParams as VariationDeleteParams,
+    type AgentVariationCreateParams as AgentVariationCreateParams,
+    type AgentVariationRetrieveParams as AgentVariationRetrieveParams,
+    type AgentVariationUpdateParams as AgentVariationUpdateParams,
+    type AgentVariationListParams as AgentVariationListParams,
+    type AgentVariationDeleteParams as AgentVariationDeleteParams,
+    type AgentVariationAddAssignmentParams as AgentVariationAddAssignmentParams,
+    type AgentVariationRemoveAssignmentParams as AgentVariationRemoveAssignmentParams,
   };
 }

package/src/resources/agents/agents.ts

@@ -2,29 +2,8 @@
 
 import { APIResource } from '../../core/resource';
 import * as AccountAPI from '../account';
+import * as AgentVariationsAPI from '../agent-variations';
 import * as Shared from '../shared';
-import * as VariationsAPI from './variations';
-import {
-  AgentVariation,
-  AgentVariationInfo,
-  AgentVariationSpec,
-  AgentVariationSpecAgentTool,
-  AgentVariationSpecCompactionConfig,
-  AgentVariationSpecConstraints,
-  AgentVariationSpecModelConfig,
-  AgentVariationSpecToolSelection,
-  AgentVariationsCursorPagination,
-  CompactionConfigSummarizationStrategy,
-  CompactionConfigToolResultClearingStrategy,
-  ToolSelectionAssignedTools,
-  ToolSelectionAutoDiscovery,
-  VariationCreateParams,
-  VariationDeleteParams,
-  VariationListParams,
-  VariationRetrieveParams,
-  VariationUpdateParams,
-  Variations,
-} from './variations';
 import * as WebhookDeliveriesAPI from './webhook-deliveries';
 import {
   WebhookDeliveries,
@@ -48,7 +27,6 @@ import { path } from '../../internal/utils/path';
  *  Scope: Workspace-level operations
  */
 export class Agents extends APIResource {
-  variations: VariationsAPI.Variations = new VariationsAPI.Variations(this._client);
   webhookDeliveries: WebhookDeliveriesAPI.WebhookDeliveries = new WebhookDeliveriesAPI.WebhookDeliveries(
     this._client,
   );
@@ -160,13 +138,6 @@ export interface AgentSpec {
    */
   description?: string;
 
-  /**
-   * The generated secret that will sign all webhooks that are sent to your
-   * configured Webhook URL. Formatted as "wh_asdf1234" per the
-   * https://www.standardwebhooks.com/ format.
-   */
-  webhookEventsHmacSecret?: string;
-
   /**
    * The URL that Cadenya will send events for any objective assigned to the agent.
    */
@@ -213,7 +184,7 @@ export namespace AgentCreateParams {
     /**
      * AgentVariationSpec defines the operational configuration for a variation
      */
-    spec: VariationsAPI.AgentVariationSpec;
+    spec: AgentVariationsAPI.AgentVariationSpec;
   }
 }
 
@@ -253,7 +224,6 @@ export interface AgentListParams extends CursorPaginationParams {
   sortOrder?: string;
 }
 
-Agents.Variations = Variations;
 Agents.WebhookDeliveries = WebhookDeliveries;
 
 export declare namespace Agents {
@@ -268,28 +238,6 @@ export declare namespace Agents {
     type AgentListParams as AgentListParams,
   };
 
-  export {
-    Variations as Variations,
-    type AgentVariation as AgentVariation,
-    type AgentVariationInfo as AgentVariationInfo,
-    type AgentVariationSpec as AgentVariationSpec,
-    type AgentVariationSpecAgentTool as AgentVariationSpecAgentTool,
-    type AgentVariationSpecCompactionConfig as AgentVariationSpecCompactionConfig,
-    type AgentVariationSpecConstraints as AgentVariationSpecConstraints,
-    type AgentVariationSpecModelConfig as AgentVariationSpecModelConfig,
-    type AgentVariationSpecToolSelection as AgentVariationSpecToolSelection,
-    type CompactionConfigSummarizationStrategy as CompactionConfigSummarizationStrategy,
-    type CompactionConfigToolResultClearingStrategy as CompactionConfigToolResultClearingStrategy,
-    type ToolSelectionAssignedTools as ToolSelectionAssignedTools,
-    type ToolSelectionAutoDiscovery as ToolSelectionAutoDiscovery,
-    type AgentVariationsCursorPagination as AgentVariationsCursorPagination,
-    type VariationCreateParams as VariationCreateParams,
-    type VariationRetrieveParams as VariationRetrieveParams,
-    type VariationUpdateParams as VariationUpdateParams,
-    type VariationListParams as VariationListParams,
-    type VariationDeleteParams as VariationDeleteParams,
-  };
-
   export {
     WebhookDeliveries as WebhookDeliveries,
     type WebhookDelivery as WebhookDelivery,

package/src/resources/agents/index.ts

@@ -11,27 +11,6 @@ export {
   type AgentListParams,
   type AgentsCursorPagination,
 } from './agents';
-export {
-  Variations,
-  type AgentVariation,
-  type AgentVariationInfo,
-  type AgentVariationSpec,
-  type AgentVariationSpecAgentTool,
-  type AgentVariationSpecCompactionConfig,
-  type AgentVariationSpecConstraints,
-  type AgentVariationSpecModelConfig,
-  type AgentVariationSpecToolSelection,
-  type CompactionConfigSummarizationStrategy,
-  type CompactionConfigToolResultClearingStrategy,
-  type ToolSelectionAssignedTools,
-  type ToolSelectionAutoDiscovery,
-  type VariationCreateParams,
-  type VariationRetrieveParams,
-  type VariationUpdateParams,
-  type VariationListParams,
-  type VariationDeleteParams,
-  type AgentVariationsCursorPagination,
-} from './variations';
 export {
   WebhookDeliveries,
   type WebhookDelivery,

package/src/resources/index.ts

@@ -11,7 +11,37 @@ export {
   type APIKeyListParams,
   type APIKeysCursorPagination,
 } from './api-keys';
-export { AccountResource, type Account, type AccountSpec, type Profile, type ProfileSpec } from './account';
+export {
+  AccountResource,
+  type Account,
+  type AccountSpec,
+  type Profile,
+  type ProfileSpec,
+  type RotateWebhookSigningKeyResponse,
+} from './account';
+export {
+  AgentVariations,
+  type AgentVariation,
+  type AgentVariationInfo,
+  type AgentVariationSpec,
+  type AgentVariationSpecCompactionConfig,
+  type AgentVariationSpecConstraints,
+  type AgentVariationSpecModelConfig,
+  type AgentVariationSpecToolSelection,
+  type CompactionConfigSummarizationStrategy,
+  type CompactionConfigToolResultClearingStrategy,
+  type ToolSelectionAssignedTools,
+  type ToolSelectionAutoDiscovery,
+  type VariationAssignment,
+  type AgentVariationCreateParams,
+  type AgentVariationRetrieveParams,
+  type AgentVariationUpdateParams,
+  type AgentVariationListParams,
+  type AgentVariationDeleteParams,
+  type AgentVariationAddAssignmentParams,
+  type AgentVariationRemoveAssignmentParams,
+  type AgentVariationsCursorPagination,
+} from './agent-variations';
 export {
   Agents,
   type Agent,
@@ -96,6 +126,7 @@ export {
   type ToolSetsCursorPagination,
   type ToolSetEventsCursorPagination,
 } from './tool-sets/tool-sets';
+export { Webhooks, type UnsafeUnwrapWebhookEvent, type UnwrapWebhookEvent } from './webhooks';
 export {
   WorkspaceSecrets,
   type WorkspaceSecret,

package/src/resources/objectives/feedback.ts

@@ -48,12 +48,12 @@ export interface ObjectiveFeedback {
   data: ObjectiveFeedbackData;
 
   /**
-   * BareMetadata contains the minimal metadata for a resource, including the ID.
-   * These are used sparingly in Cadenya for resources where the full metadata is not
-   * needed. You will come across them in list responses and other places where the
-   * full metadata is not required like listing the tools that were assigned to an
-   * objective. Because these types records are commonly created by other processes
-   * in Cadenya, they do not have things like external IDs, labels, or names.
+   * BareMetadata contains the minimal metadata for a resource: the ID and an
+   * optional human-readable name. These are used for reference fields where the full
+   * metadata (account scoping, timestamps, labels, external IDs) is not needed —
+   * e.g., the tool references inside an agent variation spec or the tools assigned
+   * to an objective. Both fields are server-populated; clients provide IDs through
+   * sibling fields rather than by constructing a BareMetadata themselves.
    */
   metadata: Shared.BareMetadata;
 

package/src/resources/objectives/objectives.ts

@@ -3,9 +3,9 @@
 import { APIResource } from '../../core/resource';
 import * as ObjectivesAPI from './objectives';
 import * as AccountAPI from '../account';
+import * as AgentVariationsAPI from '../agent-variations';
 import * as Shared from '../shared';
 import * as AgentsAPI from '../agents/agents';
-import * as VariationsAPI from '../agents/variations';
 import * as FeedbackAPI from './feedback';
 import {
   Feedback,
@@ -336,7 +336,7 @@ export interface ObjectiveData {
   /**
    * AgentVariation resource
    */
-  variation?: VariationsAPI.AgentVariation;
+  variation?: AgentVariationsAPI.AgentVariation;
 }
 
 export interface ObjectiveDataSecret {
@@ -681,7 +681,7 @@ export interface ObjectiveCompactParams {
    * CompactionConfig defines how context window compaction behaves for objectives
    * using this variation.
    */
-  compactionConfig?: VariationsAPI.AgentVariationSpecCompactionConfig;
+  compactionConfig?: AgentVariationsAPI.AgentVariationSpecCompactionConfig;
 }
 
 export interface ObjectiveContinueParams {

package/src/resources/objectives/tasks.ts

@@ -42,12 +42,12 @@ export interface ObjectiveTask {
   data: ObjectiveTaskData;
 
   /**
-   * BareMetadata contains the minimal metadata for a resource, including the ID.
-   * These are used sparingly in Cadenya for resources where the full metadata is not
-   * needed. You will come across them in list responses and other places where the
-   * full metadata is not required like listing the tools that were assigned to an
-   * objective. Because these types records are commonly created by other processes
-   * in Cadenya, they do not have things like external IDs, labels, or names.
+   * BareMetadata contains the minimal metadata for a resource: the ID and an
+   * optional human-readable name. These are used for reference fields where the full
+   * metadata (account scoping, timestamps, labels, external IDs) is not needed —
+   * e.g., the tool references inside an agent variation spec or the tools assigned
+   * to an objective. Both fields are server-populated; clients provide IDs through
+   * sibling fields rather than by constructing a BareMetadata themselves.
    */
   metadata: Shared.BareMetadata;
 }

package/src/resources/objectives/tools.ts

@@ -31,12 +31,12 @@ export type ObjectiveToolsCursorPagination = CursorPagination<ObjectiveTool>;
  */
 export interface ObjectiveTool {
   /**
-   * BareMetadata contains the minimal metadata for a resource, including the ID.
-   * These are used sparingly in Cadenya for resources where the full metadata is not
-   * needed. You will come across them in list responses and other places where the
-   * full metadata is not required like listing the tools that were assigned to an
-   * objective. Because these types records are commonly created by other processes
-   * in Cadenya, they do not have things like external IDs, labels, or names.
+   * BareMetadata contains the minimal metadata for a resource: the ID and an
+   * optional human-readable name. These are used for reference fields where the full
+   * metadata (account scoping, timestamps, labels, external IDs) is not needed —
+   * e.g., the tool references inside an agent variation spec or the tools assigned
+   * to an objective. Both fields are server-populated; clients provide IDs through
+   * sibling fields rather than by constructing a BareMetadata themselves.
    */
   metadata: Shared.BareMetadata;
 

package/src/resources/shared.ts

@@ -36,15 +36,22 @@ export interface AccountResourceMetadata {
 }
 
 /**
- * BareMetadata contains the minimal metadata for a resource, including the ID.
- * These are used sparingly in Cadenya for resources where the full metadata is not
- * needed. You will come across them in list responses and other places where the
- * full metadata is not required like listing the tools that were assigned to an
- * objective. Because these types records are commonly created by other processes
- * in Cadenya, they do not have things like external IDs, labels, or names.
+ * BareMetadata contains the minimal metadata for a resource: the ID and an
+ * optional human-readable name. These are used for reference fields where the full
+ * metadata (account scoping, timestamps, labels, external IDs) is not needed —
+ * e.g., the tool references inside an agent variation spec or the tools assigned
+ * to an objective. Both fields are server-populated; clients provide IDs through
+ * sibling fields rather than by constructing a BareMetadata themselves.
  */
 export interface BareMetadata {
-  id: string;
+  id?: string;
+
+  /**
+   * Human-readable name of the referenced resource, populated by the server on reads
+   * for convenience. Absent on references to resources that do not have a name
+   * (e.g., objective tasks).
+   */
+  name?: string;
 }
 
 /**