@cadenya/cadenya 0.41.0 → 0.43.0

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

@@ -1,30 +1,40 @@
-import { APIResource } from "../../core/resource.js";
-import * as AccountAPI from "../account.js";
-import * as Shared from "../shared.js";
-import { APIPromise } from "../../core/api-promise.js";
-import { CursorPagination, type CursorPaginationParams, PagePromise } from "../../core/pagination.js";
-import { RequestOptions } from "../../internal/request-options.js";
-export declare class Variations extends APIResource {
+import { APIResource } from "../core/resource.mjs";
+import * as AccountAPI from "./account.mjs";
+import * as Shared from "./shared.mjs";
+import { APIPromise } from "../core/api-promise.mjs";
+import { CursorPagination, type CursorPaginationParams, PagePromise } from "../core/pagination.mjs";
+import { RequestOptions } from "../internal/request-options.mjs";
+export declare 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>;
     /**
      * Retrieves a variation by ID from an agent
      */
-    retrieve(id: string, params: VariationRetrieveParams, options?: RequestOptions): APIPromise<AgentVariation>;
+    retrieve(id: string, params: AgentVariationRetrieveParams, options?: RequestOptions): APIPromise<AgentVariation>;
     /**
      * Updates a variation for an agent
      */
-    update(id: string, params: VariationUpdateParams, options?: RequestOptions): APIPromise<AgentVariation>;
+    update(id: string, params: AgentVariationUpdateParams, options?: RequestOptions): APIPromise<AgentVariation>;
     /**
      * Lists all variations for an agent
      */
-    list(agentID: string, query?: VariationListParams | null | undefined, options?: RequestOptions): PagePromise<AgentVariationsCursorPagination, AgentVariation>;
+    list(agentID: string, query?: AgentVariationListParams | null | undefined, options?: RequestOptions): PagePromise<AgentVariationsCursorPagination, AgentVariation>;
     /**
      * Deletes a variation from an agent
      */
-    delete(id: string, params: VariationDeleteParams, options?: RequestOptions): APIPromise<void>;
+    delete(id: string, params: AgentVariationDeleteParams, options?: RequestOptions): APIPromise<void>;
+    /**
+     * 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>;
+    /**
+     * 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>;
 }
 export type AgentVariationsCursorPagination = CursorPagination<AgentVariation>;
 /**
@@ -48,6 +58,12 @@ 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
@@ -85,14 +101,10 @@ export interface AgentVariationInfo {
  */
 export interface AgentVariationSpec {
     /**
-     * Documents assigned to this variation. Can include individual documents or entire
-     * document namespaces (which include all documents in the namespace).
-     */
-    agentDocuments?: Array<AgentVariationSpecAgentDocument>;
-    /**
-     * Tools assigned to this variation
+     * CompactionConfig defines how context window compaction behaves for objectives
+     * using this variation.
      */
-    agentTools?: Array<AgentVariationSpecAgentTool>;
+    compactionConfig?: AgentVariationSpecCompactionConfig;
     /**
      * Execution constraints
      */
@@ -134,34 +146,26 @@ export interface AgentVariationSpec {
      */
     weight?: number;
 }
-export interface AgentVariationSpecAgentDocument {
-    documentId?: string;
-    /**
-     * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
-     */
-    documentMetadata?: Shared.ResourceMetadata;
-    documentNamespaceId?: string;
+/**
+ * CompactionConfig defines how context window compaction behaves for objectives
+ * using this variation.
+ */
+export interface AgentVariationSpecCompactionConfig {
     /**
-     * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+     * SummarizationStrategy configures LLM-powered summarization of older conversation
+     * turns.
      */
-    documentNamespaceMetadata?: Shared.ResourceMetadata;
-}
-export interface AgentVariationSpecAgentTool {
-    agentId?: string;
+    summarization?: CompactionConfigSummarizationStrategy;
     /**
-     * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+     * ToolResultClearingStrategy configures clearing of older tool result content.
      */
-    agentMetadata?: Shared.ResourceMetadata;
-    toolId?: string;
+    toolResultClearing?: CompactionConfigToolResultClearingStrategy;
     /**
-     * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+     * Trigger threshold as a percentage of the model's context window (0.0 to 1.0).
+     * When input tokens reach this percentage of the model's limit, compaction
+     * triggers. Default: 0.75 (75%)
      */
-    toolMetadata?: Shared.ResourceMetadata;
-    toolSetId?: string;
-    /**
-     * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
-     */
-    toolSetMetadata?: Shared.ResourceMetadata;
+    triggerThreshold?: number;
 }
 export interface AgentVariationSpecConstraints {
     /**
@@ -204,6 +208,29 @@ export interface AgentVariationSpecToolSelection {
      */
     autoDiscovery?: ToolSelectionAutoDiscovery;
 }
+/**
+ * SummarizationStrategy configures LLM-powered summarization of older conversation
+ * turns.
+ */
+export interface CompactionConfigSummarizationStrategy {
+    /**
+     * Custom instructions that guide what the summarizer preserves. Replaces the
+     * default summarization prompt entirely. Example: "Preserve all code snippets,
+     * variable names, and technical decisions."
+     */
+    instructions?: string;
+}
+/**
+ * ToolResultClearingStrategy configures clearing of older tool result content.
+ */
+export interface CompactionConfigToolResultClearingStrategy {
+    /**
+     * Number of most recent tool call results to keep intact. Older tool results have
+     * their content replaced with "[result cleared]" while preserving the assistant
+     * tool call message (function name, arguments). Default: 2
+     */
+    preserveRecentResults?: number;
+}
 /**
  * AssignedTools is used to indicate that the agent should only use the tools/tool
  * sets that are explicitly assigned to it. Allow discovery is used when the agent
@@ -223,7 +250,47 @@ export interface ToolSelectionAutoDiscovery {
     hints?: Array<string>;
     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,
@@ -235,13 +302,13 @@ 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)
      */
@@ -263,7 +330,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
      */
@@ -273,13 +340,21 @@ export interface VariationListParams extends CursorPaginationParams {
      */
     sortOrder?: string;
 }
-export interface VariationDeleteParams {
+export interface AgentVariationDeleteParams {
     /**
      * Agent ID (from path)
      */
     agentId: string;
 }
-export declare namespace Variations {
-    export { type AgentVariation as AgentVariation, type AgentVariationInfo as AgentVariationInfo, type AgentVariationSpec as AgentVariationSpec, type AgentVariationSpecAgentDocument as AgentVariationSpecAgentDocument, type AgentVariationSpecAgentTool as AgentVariationSpecAgentTool, type AgentVariationSpecConstraints as AgentVariationSpecConstraints, type AgentVariationSpecModelConfig as AgentVariationSpecModelConfig, type AgentVariationSpecToolSelection as AgentVariationSpecToolSelection, 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 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 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 VariationAssignment as VariationAssignment, type AgentVariationsCursorPagination as AgentVariationsCursorPagination, 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, };
 }
-//# sourceMappingURL=variations.d.ts.map
+//# sourceMappingURL=agent-variations.d.mts.map

package/resources/agent-variations.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-variations.d.mts","sourceRoot":"","sources":["../src/resources/agent-variations.ts"],"names":[],"mappings":"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"}

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

@@ -1,30 +1,40 @@
-import { APIResource } from "../../core/resource.mjs";
-import * as AccountAPI from "../account.mjs";
-import * as Shared from "../shared.mjs";
-import { APIPromise } from "../../core/api-promise.mjs";
-import { CursorPagination, type CursorPaginationParams, PagePromise } from "../../core/pagination.mjs";
-import { RequestOptions } from "../../internal/request-options.mjs";
-export declare class Variations extends APIResource {
+import { APIResource } from "../core/resource.js";
+import * as AccountAPI from "./account.js";
+import * as Shared from "./shared.js";
+import { APIPromise } from "../core/api-promise.js";
+import { CursorPagination, type CursorPaginationParams, PagePromise } from "../core/pagination.js";
+import { RequestOptions } from "../internal/request-options.js";
+export declare 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>;
     /**
      * Retrieves a variation by ID from an agent
      */
-    retrieve(id: string, params: VariationRetrieveParams, options?: RequestOptions): APIPromise<AgentVariation>;
+    retrieve(id: string, params: AgentVariationRetrieveParams, options?: RequestOptions): APIPromise<AgentVariation>;
     /**
      * Updates a variation for an agent
      */
-    update(id: string, params: VariationUpdateParams, options?: RequestOptions): APIPromise<AgentVariation>;
+    update(id: string, params: AgentVariationUpdateParams, options?: RequestOptions): APIPromise<AgentVariation>;
     /**
      * Lists all variations for an agent
      */
-    list(agentID: string, query?: VariationListParams | null | undefined, options?: RequestOptions): PagePromise<AgentVariationsCursorPagination, AgentVariation>;
+    list(agentID: string, query?: AgentVariationListParams | null | undefined, options?: RequestOptions): PagePromise<AgentVariationsCursorPagination, AgentVariation>;
     /**
      * Deletes a variation from an agent
      */
-    delete(id: string, params: VariationDeleteParams, options?: RequestOptions): APIPromise<void>;
+    delete(id: string, params: AgentVariationDeleteParams, options?: RequestOptions): APIPromise<void>;
+    /**
+     * 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>;
+    /**
+     * 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>;
 }
 export type AgentVariationsCursorPagination = CursorPagination<AgentVariation>;
 /**
@@ -48,6 +58,12 @@ 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
@@ -85,14 +101,10 @@ export interface AgentVariationInfo {
  */
 export interface AgentVariationSpec {
     /**
-     * Documents assigned to this variation. Can include individual documents or entire
-     * document namespaces (which include all documents in the namespace).
-     */
-    agentDocuments?: Array<AgentVariationSpecAgentDocument>;
-    /**
-     * Tools assigned to this variation
+     * CompactionConfig defines how context window compaction behaves for objectives
+     * using this variation.
      */
-    agentTools?: Array<AgentVariationSpecAgentTool>;
+    compactionConfig?: AgentVariationSpecCompactionConfig;
     /**
      * Execution constraints
      */
@@ -134,34 +146,26 @@ export interface AgentVariationSpec {
      */
     weight?: number;
 }
-export interface AgentVariationSpecAgentDocument {
-    documentId?: string;
-    /**
-     * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
-     */
-    documentMetadata?: Shared.ResourceMetadata;
-    documentNamespaceId?: string;
+/**
+ * CompactionConfig defines how context window compaction behaves for objectives
+ * using this variation.
+ */
+export interface AgentVariationSpecCompactionConfig {
     /**
-     * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+     * SummarizationStrategy configures LLM-powered summarization of older conversation
+     * turns.
      */
-    documentNamespaceMetadata?: Shared.ResourceMetadata;
-}
-export interface AgentVariationSpecAgentTool {
-    agentId?: string;
+    summarization?: CompactionConfigSummarizationStrategy;
     /**
-     * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+     * ToolResultClearingStrategy configures clearing of older tool result content.
      */
-    agentMetadata?: Shared.ResourceMetadata;
-    toolId?: string;
+    toolResultClearing?: CompactionConfigToolResultClearingStrategy;
     /**
-     * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+     * Trigger threshold as a percentage of the model's context window (0.0 to 1.0).
+     * When input tokens reach this percentage of the model's limit, compaction
+     * triggers. Default: 0.75 (75%)
      */
-    toolMetadata?: Shared.ResourceMetadata;
-    toolSetId?: string;
-    /**
-     * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
-     */
-    toolSetMetadata?: Shared.ResourceMetadata;
+    triggerThreshold?: number;
 }
 export interface AgentVariationSpecConstraints {
     /**
@@ -204,6 +208,29 @@ export interface AgentVariationSpecToolSelection {
      */
     autoDiscovery?: ToolSelectionAutoDiscovery;
 }
+/**
+ * SummarizationStrategy configures LLM-powered summarization of older conversation
+ * turns.
+ */
+export interface CompactionConfigSummarizationStrategy {
+    /**
+     * Custom instructions that guide what the summarizer preserves. Replaces the
+     * default summarization prompt entirely. Example: "Preserve all code snippets,
+     * variable names, and technical decisions."
+     */
+    instructions?: string;
+}
+/**
+ * ToolResultClearingStrategy configures clearing of older tool result content.
+ */
+export interface CompactionConfigToolResultClearingStrategy {
+    /**
+     * Number of most recent tool call results to keep intact. Older tool results have
+     * their content replaced with "[result cleared]" while preserving the assistant
+     * tool call message (function name, arguments). Default: 2
+     */
+    preserveRecentResults?: number;
+}
 /**
  * AssignedTools is used to indicate that the agent should only use the tools/tool
  * sets that are explicitly assigned to it. Allow discovery is used when the agent
@@ -223,7 +250,47 @@ export interface ToolSelectionAutoDiscovery {
     hints?: Array<string>;
     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,
@@ -235,13 +302,13 @@ 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)
      */
@@ -263,7 +330,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
      */
@@ -273,13 +340,21 @@ export interface VariationListParams extends CursorPaginationParams {
      */
     sortOrder?: string;
 }
-export interface VariationDeleteParams {
+export interface AgentVariationDeleteParams {
     /**
      * Agent ID (from path)
      */
     agentId: string;
 }
-export declare namespace Variations {
-    export { type AgentVariation as AgentVariation, type AgentVariationInfo as AgentVariationInfo, type AgentVariationSpec as AgentVariationSpec, type AgentVariationSpecAgentDocument as AgentVariationSpecAgentDocument, type AgentVariationSpecAgentTool as AgentVariationSpecAgentTool, type AgentVariationSpecConstraints as AgentVariationSpecConstraints, type AgentVariationSpecModelConfig as AgentVariationSpecModelConfig, type AgentVariationSpecToolSelection as AgentVariationSpecToolSelection, 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 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 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 VariationAssignment as VariationAssignment, type AgentVariationsCursorPagination as AgentVariationsCursorPagination, 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, };
 }
-//# sourceMappingURL=variations.d.mts.map
+//# sourceMappingURL=agent-variations.d.ts.map

package/resources/agent-variations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-variations.d.ts","sourceRoot":"","sources":["../src/resources/agent-variations.ts"],"names":[],"mappings":"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"}

package/resources/{agents/variations.js → agent-variations.js}

@@ -1,12 +1,12 @@
 "use strict";
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Variations = void 0;
-const resource_1 = require("../../core/resource.js");
-const pagination_1 = require("../../core/pagination.js");
-const headers_1 = require("../../internal/headers.js");
-const path_1 = require("../../internal/utils/path.js");
-class Variations extends resource_1.APIResource {
+exports.AgentVariations = void 0;
+const resource_1 = require("../core/resource.js");
+const pagination_1 = require("../core/pagination.js");
+const headers_1 = require("../internal/headers.js");
+const path_1 = require("../internal/utils/path.js");
+class AgentVariations extends resource_1.APIResource {
     /**
      * Creates a new variation for an agent
      */
@@ -46,6 +46,27 @@ class Variations extends resource_1.APIResource {
             headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
         });
     }
+    /**
+     * Assigns a tool, tool set, or sub-agent to a variation. Exactly one target ID
+     * must be set.
+     */
+    addAssignment(agentVariationID, body, options) {
+        return this._client.post((0, path_1.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, params, options) {
+        const { agentVariationId } = params;
+        return this._client.delete((0, path_1.path) `/v1/agent_variations/${agentVariationId}/assignments/${id}`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
 }
-exports.Variations = Variations;
-//# sourceMappingURL=variations.js.map
+exports.AgentVariations = AgentVariations;
+//# sourceMappingURL=agent-variations.js.map

package/resources/agent-variations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-variations.js","sourceRoot":"","sources":["../src/resources/agent-variations.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C,sDAAgG;AAChG,oDAAmD;AAEnD,oDAA8C;AAE9C,MAAa,eAAgB,SAAQ,sBAAW;IAC9C;;OAEG;IACH,MAAM,CACJ,OAAe,EACf,IAAgC,EAChC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,cAAc,OAAO,aAAa,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;OAEG;IACH,QAAQ,CACN,EAAU,EACV,MAAoC,EACpC,OAAwB;QAExB,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,cAAc,OAAO,eAAe,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACjF,CAAC;IAED;;OAEG;IACH,MAAM,CACJ,EAAU,EACV,MAAkC,EAClC,OAAwB;QAExB,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,cAAc,OAAO,eAAe,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChG,CAAC;IAED;;OAEG;IACH,IAAI,CACF,OAAe,EACf,QAAqD,EAAE,EACvD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAA,WAAI,EAAA,cAAc,OAAO,aAAa,EAAE,CAAA,6BAAgC,CAAA,EAAE;YACvG,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,EAAU,EAAE,MAAkC,EAAE,OAAwB;QAC7E,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,cAAc,OAAO,eAAe,EAAE,EAAE,EAAE;YACvE,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,aAAa,CACX,gBAAwB,EACxB,IAAuC,EACvC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,wBAAwB,gBAAgB,cAAc,EAAE;YACnF,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,gBAAgB,CACd,EAAU,EACV,MAA4C,EAC5C,OAAwB;QAExB,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAAC;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,wBAAwB,gBAAgB,gBAAgB,EAAE,EAAE,EAAE;YAC3F,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF;AA3FD,0CA2FC"}

package/resources/{agents/variations.mjs → agent-variations.mjs}

@@ -1,9 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-import { APIResource } from "../../core/resource.mjs";
-import { CursorPagination } from "../../core/pagination.mjs";
-import { buildHeaders } from "../../internal/headers.mjs";
-import { path } from "../../internal/utils/path.mjs";
-export class Variations extends APIResource {
+import { APIResource } from "../core/resource.mjs";
+import { CursorPagination } from "../core/pagination.mjs";
+import { buildHeaders } from "../internal/headers.mjs";
+import { path } from "../internal/utils/path.mjs";
+export class AgentVariations extends APIResource {
     /**
      * Creates a new variation for an agent
      */
@@ -43,5 +43,26 @@ export class Variations extends APIResource {
             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, body, options) {
+        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, params, options) {
+        const { agentVariationId } = params;
+        return this._client.delete(path `/v1/agent_variations/${agentVariationId}/assignments/${id}`, {
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
 }
-//# sourceMappingURL=variations.mjs.map
+//# sourceMappingURL=agent-variations.mjs.map