@cadenya/cadenya 0.135.0 → 1.0.0

package/src/resources/agents/variations.ts

@@ -1,981 +0,0 @@
-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';
-
-/**
- * Manage variations of an agent and their tool, sub-agent, and memory layer assignments.
- */
-export class Variations extends APIResource {
-  /**
-   * Creates a new variation for an agent
-   *
-   * @example
-   * ```ts
-   * const agentVariation =
-   *   await client.agents.variations.create(
-   *     'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
-   *     {
-   *       workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q',
-   *       metadata: { name: 'name' },
-   *       spec: {},
-   *     },
-   *   );
-   * ```
-   */
-  create(
-    agentID: string,
-    params: VariationCreateParams,
-    options?: RequestOptions,
-  ): APIPromise<AgentVariation> {
-    const { workspaceId = this._client.workspaceID, ...body } = params;
-    return this._client.post(path`/v1/workspaces/${workspaceId}/agents/${agentID}/variations`, {
-      body,
-      ...options,
-    });
-  }
-
-  /**
-   * Retrieves a variation by ID from an agent
-   *
-   * @example
-   * ```ts
-   * const agentVariation =
-   *   await client.agents.variations.retrieve(
-   *     'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
-   *     'agentvar_01HXKD2E5NQM3T9AYWCF32BSPP',
-   *     { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
-   *   );
-   * ```
-   */
-  retrieve(
-    agentID: string,
-    id: string,
-    params: VariationRetrieveParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<AgentVariation> {
-    const { workspaceId = this._client.workspaceID } = params ?? {};
-    return this._client.get(path`/v1/workspaces/${workspaceId}/agents/${agentID}/variations/${id}`, options);
-  }
-
-  /**
-   * Updates a variation for an agent
-   *
-   * @example
-   * ```ts
-   * const agentVariation =
-   *   await client.agents.variations.update(
-   *     'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
-   *     'agentvar_01HXKD2E5NQM3T9AYWCF32BSPP',
-   *     { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
-   *   );
-   * ```
-   */
-  update(
-    agentID: string,
-    id: string,
-    params: VariationUpdateParams,
-    options?: RequestOptions,
-  ): APIPromise<AgentVariation> {
-    const { workspaceId = this._client.workspaceID, ...body } = params;
-    return this._client.patch(path`/v1/workspaces/${workspaceId}/agents/${agentID}/variations/${id}`, {
-      body,
-      ...options,
-    });
-  }
-
-  /**
-   * Lists all variations for an agent
-   *
-   * @example
-   * ```ts
-   * // Automatically fetches more pages as needed.
-   * for await (const agentVariation of client.agents.variations.list(
-   *   'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
-   *   { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
-   * )) {
-   *   // ...
-   * }
-   * ```
-   */
-  list(
-    agentID: string,
-    params: VariationListParams | null | undefined = {},
-    options?: RequestOptions,
-  ): PagePromise<AgentVariationsCursorPagination, AgentVariation> {
-    const { workspaceId = this._client.workspaceID, ...query } = params ?? {};
-    return this._client.getAPIList(
-      path`/v1/workspaces/${workspaceId}/agents/${agentID}/variations`,
-      CursorPagination<AgentVariation>,
-      { query, ...options },
-    );
-  }
-
-  /**
-   * Deletes a variation from an agent
-   *
-   * @example
-   * ```ts
-   * await client.agents.variations.delete(
-   *   'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
-   *   'agentvar_01HXKD2E5NQM3T9AYWCF32BSPP',
-   *   { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
-   * );
-   * ```
-   */
-  delete(
-    agentID: string,
-    id: string,
-    params: VariationDeleteParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<void> {
-    const { workspaceId = this._client.workspaceID } = params ?? {};
-    return this._client.delete(path`/v1/workspaces/${workspaceId}/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.
-   *
-   * @example
-   * ```ts
-   * const variationAssignment =
-   *   await client.agents.variations.addAssignment(
-   *     'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
-   *     'agentvar_01HXKD2E5NQM3T9AYWCF32BSPP',
-   *     {
-   *       workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q',
-   *       toolId: 'tool_01HXKD2E5NQM3T9AYWCFWVYY9K',
-   *       type: 'toolId',
-   *     },
-   *   );
-   * ```
-   */
-  addAssignment(
-    agentID: string,
-    variationID: string,
-    params: VariationAddAssignmentParams,
-    options?: RequestOptions,
-  ): APIPromise<VariationAssignment> {
-    const { workspaceId = this._client.workspaceID, ...body } = params;
-    return this._client.post(
-      path`/v1/workspaces/${workspaceId}/agents/${agentID}/variations/${variationID}/assignments`,
-      { body, ...options },
-    );
-  }
-
-  /**
-   * Attaches a memory layer to a variation at a given position in the variation's
-   * baseline memory cascade.
-   *
-   * @example
-   * ```ts
-   * const variationMemoryLayerAssignment =
-   *   await client.agents.variations.addMemoryLayer(
-   *     'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
-   *     'agentvar_01HXKD2E5NQM3T9AYWCF32BSPP',
-   *     {
-   *       workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q',
-   *       memoryLayerId: 'memlyr_01HXKD2E5NQM3T9AYWCFFFBMJH',
-   *     },
-   *   );
-   * ```
-   */
-  addMemoryLayer(
-    agentID: string,
-    variationID: string,
-    params: VariationAddMemoryLayerParams,
-    options?: RequestOptions,
-  ): APIPromise<VariationMemoryLayerAssignment> {
-    const { workspaceId = this._client.workspaceID, ...body } = params;
-    return this._client.post(
-      path`/v1/workspaces/${workspaceId}/agents/${agentID}/variations/${variationID}/memory_layer_assignments`,
-      { body, ...options },
-    );
-  }
-
-  /**
-   * Detaches an assignment from a variation, identified by the assignment ID
-   * returned when it was added.
-   *
-   * @example
-   * ```ts
-   * await client.agents.variations.removeAssignment(
-   *   'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
-   *   'agentvar_01HXKD2E5NQM3T9AYWCF32BSPP',
-   *   'avt_01HXKD2E5NQM3T9AYWCFJE6K89',
-   *   { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
-   * );
-   * ```
-   */
-  removeAssignment(
-    agentID: string,
-    variationID: string,
-    id: string,
-    params: VariationRemoveAssignmentParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<void> {
-    const { workspaceId = this._client.workspaceID } = params ?? {};
-    return this._client.delete(
-      path`/v1/workspaces/${workspaceId}/agents/${agentID}/variations/${variationID}/assignments/${id}`,
-      { ...options, headers: buildHeaders([{ Accept: '*/*' }, options?.headers]) },
-    );
-  }
-
-  /**
-   * Detaches a memory layer assignment from a variation, identified by the
-   * assignment id.
-   *
-   * @example
-   * ```ts
-   * await client.agents.variations.removeMemoryLayer(
-   *   'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
-   *   'agentvar_01HXKD2E5NQM3T9AYWCF32BSPP',
-   *   'avml_01HXKD2E5NQM3T9AYWCFX8AF59',
-   *   { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
-   * );
-   * ```
-   */
-  removeMemoryLayer(
-    agentID: string,
-    variationID: string,
-    id: string,
-    params: VariationRemoveMemoryLayerParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<void> {
-    const { workspaceId = this._client.workspaceID } = params ?? {};
-    return this._client.delete(
-      path`/v1/workspaces/${workspaceId}/agents/${agentID}/variations/${variationID}/memory_layer_assignments/${id}`,
-      { ...options, headers: buildHeaders([{ Accept: '*/*' }, options?.headers]) },
-    );
-  }
-
-  /**
-   * Updates the position of a memory layer assignment on a variation.
-   *
-   * @example
-   * ```ts
-   * const variationMemoryLayerAssignment =
-   *   await client.agents.variations.updateMemoryLayer(
-   *     'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
-   *     'agentvar_01HXKD2E5NQM3T9AYWCF32BSPP',
-   *     'avml_01HXKD2E5NQM3T9AYWCFX8AF59',
-   *     { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
-   *   );
-   * ```
-   */
-  updateMemoryLayer(
-    agentID: string,
-    variationID: string,
-    id: string,
-    params: VariationUpdateMemoryLayerParams,
-    options?: RequestOptions,
-  ): APIPromise<VariationMemoryLayerAssignment> {
-    const { workspaceId = this._client.workspaceID, ...body } = params;
-    return this._client.patch(
-      path`/v1/workspaces/${workspaceId}/agents/${agentID}/variations/${variationID}/memory_layer_assignments/${id}`,
-      { body, ...options },
-    );
-  }
-}
-
-export type AgentVariationsCursorPagination = CursorPagination<AgentVariation>;
-
-export interface AddAgentVariationAssignmentRequestSubAgentID {
-  subAgentId: string;
-
-  type: 'subAgentId';
-
-  /**
-   * Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>`
-   * form.
-   */
-  agentId?: string;
-
-  /**
-   * Variation ID. Accepts the canonical `agentvar_…` form or the
-   * `external_id:<value>` form.
-   */
-  variationId?: string;
-
-  /**
-   * Workspace ID.
-   */
-  workspaceId?: string;
-}
-
-export interface AddAgentVariationAssignmentRequestToolID {
-  toolId: string;
-
-  type: 'toolId';
-
-  /**
-   * Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>`
-   * form.
-   */
-  agentId?: string;
-
-  /**
-   * Variation ID. Accepts the canonical `agentvar_…` form or the
-   * `external_id:<value>` form.
-   */
-  variationId?: string;
-
-  /**
-   * Workspace ID.
-   */
-  workspaceId?: string;
-}
-
-export interface AddAgentVariationAssignmentRequestToolSetID {
-  toolSetId: string;
-
-  type: 'toolSetId';
-
-  /**
-   * Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>`
-   * form.
-   */
-  agentId?: string;
-
-  /**
-   * Variation ID. Accepts the canonical `agentvar_…` form or the
-   * `external_id:<value>` form.
-   */
-  variationId?: string;
-
-  /**
-   * Workspace ID.
-   */
-  workspaceId?: string;
-}
-
-/**
- * AgentVariation resource
- */
-export interface AgentVariation {
-  /**
-   * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
-   */
-  metadata: Shared.ResourceMetadata;
-
-  /**
-   * AgentVariationSpec defines the operational configuration for a variation
-   */
-  spec: AgentVariationSpec;
-
-  /**
-   * AgentVariationInfo provides read-only summary information about a variation
-   */
-  info?: AgentVariationInfo;
-}
-
-/**
- * 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>;
-
-  /**
-   * A profile identifies a user or non-human principal (such as an API key) at the
-   * account level. Profiles are account-scoped and can be granted access to multiple
-   * workspaces.
-   */
-  createdBy?: AccountAPI.Profile;
-
-  /**
-   * Total number of objective feedbacks received for this variation
-   */
-  feedbackCount?: number;
-
-  /**
-   * Read-only list of memory layer assignments for this variation, returned in
-   * ascending `position` (most specific first — resolution order). Capped at 10
-   * entries.
-   */
-  memoryLayerAssignments?: Array<VariationMemoryLayerAssignment>;
-
-  /**
-   * Count of memory layer assignments.
-   */
-  memoryLayerCount?: number;
-
-  /**
-   * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
-   */
-  model?: Shared.ResourceMetadata;
-
-  /**
-   * Thompson Sampling score: posterior mean of Beta(ts_alpha, ts_beta). Range [0, 1]
-   * where 0.5 = neutral, >0.5 = positive, <0.5 = negative.
-   */
-  score?: number;
-
-  /**
-   * Number of sub-agents assigned to this variation
-   */
-  subAgentCount?: number;
-
-  /**
-   * Number of individual tools assigned to this variation
-   */
-  toolCount?: number;
-
-  /**
-   * Number of tool sets assigned to this variation
-   */
-  toolSetCount?: number;
-}
-
-/**
- * AgentVariationSpec defines the operational configuration for a variation
- */
-export interface AgentVariationSpec {
-  /**
-   * CompactionConfig defines how context window compaction behaves for objectives
-   * using this variation.
-   */
-  compactionConfig?: AgentVariationSpecCompactionConfig;
-
-  /**
-   * Execution constraints
-   */
-  constraints?: AgentVariationSpecConstraints;
-
-  /**
-   * Human-readable description of what this variation does or when it should be used
-   */
-  description?: string;
-
-  /**
-   * Liquid template for the first user message of objectives using this variation.
-   * Rendered with CreateObjectiveRequest.first_user_message_data into
-   * Objective.first_user_message, the first user message in the LLM chat history.
-   * CreateObjectiveRequest.first_user_message, when set, overrides the rendered
-   * result. If neither this template nor first_user_message is present, objective
-   * creation is rejected with InvalidArgument.
-   */
-  firstUserMessageTemplate?: string;
-
-  /**
-   * ModelConfig defines the model configuration for a variation.
-   *
-   * Every knob besides model_id is honored only when the assigned model's
-   * spec.capabilities lists the matching capability.
-   */
-  modelConfig?: AgentVariationSpecModelConfig;
-
-  /**
-   * ProgressiveDiscovery is used to indicate that the agent should automatically
-   * discover tools that are not explicitly assigned to it. Max tools is the maximum
-   * number of tools that can be discovered per search. Hints are optional hints for
-   * tool search. These are used in conjunction with the context-aware tool search
-   * and can help select the best tools for the task.
-   */
-  progressiveDiscovery?: AgentVariationSpecProgressiveDiscovery;
-
-  /**
-   * Liquid template for the system prompt of objectives using this variation.
-   * Rendered with CreateObjectiveRequest.system_prompt_data into
-   * Objective.system_prompt.
-   */
-  systemPromptTemplate?: string;
-}
-
-/**
- * CompactionConfig defines how context window compaction behaves for objectives
- * using this variation.
- */
-export interface AgentVariationSpecCompactionConfig {
-  /**
-   * SummarizationStrategy configures LLM-powered summarization of older conversation
-   * turns.
-   */
-  summarization?: CompactionConfigSummarizationStrategy;
-
-  /**
-   * ToolResultClearingStrategy configures clearing of older tool result content.
-   */
-  toolResultClearing?: CompactionConfigToolResultClearingStrategy;
-
-  /**
-   * 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%)
-   */
-  triggerThreshold?: number;
-}
-
-export interface AgentVariationSpecConstraints {
-  /**
-   * How long an objective may sit with no activity (no user messages, no LLM calls)
-   * before it is finalized as timed out. Between 1 minute and 24 hours, expressed as
-   * a duration string in seconds (e.g. "7200s"). When not set, objectives are still
-   * swept at the system-wide 24 hour maximum — every objective eventually reaches a
-   * terminal state.
-   *
-   * Note: no gnostic integer hint here on purpose. The Envoy gRPC-JSON transcoder
-   * only accepts the canonical protobuf JSON form for Durations — a "<seconds>s"
-   * string — so the SDKs must type this as a string (like AgentScheduleSpec.every),
-   * not an integer.
-   */
-  inactivityTimeout?: string;
-
-  /**
-   * The maximum number of sub-objectives that can be created. 0 means no limit.
-   */
-  maxSubObjectives?: number;
-
-  /**
-   * The maximum number of tool calls that can be made. 0 means no limit.
-   */
-  maxToolCalls?: number;
-}
-
-/**
- * ModelConfig defines the model configuration for a variation.
- *
- * Every knob besides model_id is honored only when the assigned model's
- * spec.capabilities lists the matching capability.
- */
-export interface AgentVariationSpecModelConfig {
-  /**
-   * The model identifier in family/model format (e.g., "claude/opus-4.6",
-   * "claude/sonnet-4.5")
-   */
-  modelId: string;
-
-  /**
-   * Prompt/token caching. Requires the model's "caching" capability.
-   * Presence-tracked tri-state: unset means the default — caching is ON whenever
-   * the model has the capability; false opts this variation out; true is an
-   * explicit opt-in (equivalent to unset).
-   */
-  cachingEnabled?: boolean;
-
-  /**
-   * Cap on output tokens per LLM call. Must not exceed the model's
-   * spec.max_output_tokens. Requires the model's "maxOutputTokens" capability.
-   */
-  maxOutputTokens?: number;
-
-  /**
-   * Reasoning effort. Requires the model's "reasoning" capability.
-   */
-  reasoningEffort?:
-    | 'REASONING_EFFORT_UNSPECIFIED'
-    | 'REASONING_EFFORT_NONE'
-    | 'REASONING_EFFORT_LOW'
-    | 'REASONING_EFFORT_MEDIUM'
-    | 'REASONING_EFFORT_HIGH';
-
-  /**
-   * Sequences that stop generation when produced. Empty means none. No count cap
-   * here — providers impose their own limits (surfaced as the "stopSequences"
-   * capability's `limit` on the model spec), and it is the caller's responsibility
-   * to stay within the selected model's limit. Requires the model's "stopSequences"
-   * capability.
-   */
-  stopSequences?: Array<string>;
-
-  /**
-   * Sampling temperature for model inference (0.0 to 1.0) Lower values produce more
-   * deterministic outputs, higher values increase randomness. Presence-tracked so a
-   * deliberate 0.0 (fully deterministic) is distinguishable from unset.
-   */
-  temperature?: number;
-
-  /**
-   * Only sample from the top_k most likely tokens. Requires the model's "topK"
-   * capability.
-   */
-  topK?: number;
-
-  /**
-   * Nucleus sampling: only tokens comprising the top_p probability mass are
-   * considered. Requires the model's "topP" capability.
-   */
-  topP?: number;
-}
-
-/**
- * ProgressiveDiscovery is used to indicate that the agent should automatically
- * discover tools that are not explicitly assigned to it. Max tools is the maximum
- * number of tools that can be discovered per search. Hints are optional hints for
- * tool search. These are used in conjunction with the context-aware tool search
- * and can help select the best tools for the task.
- */
-export interface AgentVariationSpecProgressiveDiscovery {
-  /**
-   * Free-text guidance appended to the discoverable-tools appendix in the system
-   * prompt. Hints steer the model's choice of tool names; they do not filter or rank
-   * anything, because tool_search matches names exactly rather than searching.
-   */
-  hints?: Array<string>;
-
-  /**
-   * The most tool names tool_search will load in a single call. Requesting more than
-   * this returns an error telling the model to retry in smaller batches -- it is a
-   * per-call batch limit, not a ceiling on how many tools an objective may end up
-   * with.
-   */
-  maxTools?: number;
-}
-
-/**
- * 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;
-}
-
-/**
- * A read-only reference to a single tool, tool set, or sub-agent attached to a
- * variation. Read the full set of assignments via
- * `AgentVariationInfo.assignments`; mutations go through the dedicated add/remove
- * assignment endpoints.
- *
- * The `id` identifies the assignment 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 type VariationAssignment =
-  | VariationAssignmentTool
-  | VariationAssignmentToolSet
-  | VariationAssignmentAgent;
-
-export interface VariationAssignmentAgent {
-  /**
-   * 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;
-
-  type: 'agent';
-
-  id?: string;
-}
-
-export interface VariationAssignmentTool {
-  /**
-   * 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;
-
-  type: 'tool';
-
-  id?: string;
-}
-
-export interface VariationAssignmentToolSet {
-  /**
-   * 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;
-
-  type: 'toolSet';
-
-  id?: string;
-}
-
-/**
- * VariationMemoryLayerAssignment attaches a single MemoryLayer to a variation at a
- * given position in the variation's baseline memory cascade. A variation has at
- * most one assignment per memory_layer_id.
- *
- * Variations only support whole-layer attachments — entry pinning is an
- * objective-level capability.
- */
-export interface VariationMemoryLayerAssignment {
-  /**
-   * Assignment row id — handle for removing the assignment. Distinct from the
-   * referenced memory layer's id.
-   */
-  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.
-   */
-  memoryLayer?: Shared.BareMetadata;
-
-  /**
-   * Position in the variation's baseline cascade. Position is specificity,
-   * CSS-style: a LOWER position is more specific and is consulted first; the
-   * highest-position assignment is the most general fallback. Gaps are fine — only
-   * relative position matters. Positions must be unique within a variation; a
-   * request that would collide with an existing assignment's position is rejected
-   * with InvalidArgument.
-   */
-  position?: number;
-}
-
-export interface VariationCreateParams {
-  /**
-   * Path param: Workspace ID.
-   */
-  workspaceId?: string;
-
-  /**
-   * Body param: CreateResourceMetadata contains the user-provided fields for
-   * creating a workspace-scoped resource. Read-only fields (id, account_id,
-   * workspace_id, profile_id, created_at) are excluded since they are set by the
-   * server.
-   */
-  metadata: Shared.CreateResourceMetadata;
-
-  /**
-   * Body param: AgentVariationSpec defines the operational configuration for a
-   * variation
-   */
-  spec: AgentVariationSpec;
-}
-
-export interface VariationRetrieveParams {
-  /**
-   * Workspace ID.
-   */
-  workspaceId?: string;
-}
-
-export interface VariationUpdateParams {
-  /**
-   * Path param: Workspace ID.
-   */
-  workspaceId?: string;
-
-  /**
-   * Body param: UpdateResourceMetadata contains the user-provided fields for
-   * updating a workspace-scoped resource. Read-only fields (id, account_id,
-   * workspace_id, profile_id, created_at) are excluded since they are set by the
-   * server.
-   */
-  metadata?: Shared.UpdateResourceMetadata;
-
-  /**
-   * Body param: AgentVariationSpec defines the operational configuration for a
-   * variation
-   */
-  spec?: AgentVariationSpec;
-
-  /**
-   * Body param: Fields to update
-   */
-  updateMask?: string;
-}
-
-export interface VariationListParams extends CursorPaginationParams {
-  /**
-   * Path param: Workspace ID.
-   */
-  workspaceId?: string;
-
-  /**
-   * Query param: When true, the `info` field on each returned variation is
-   * populated. Requests with this flag count more against your rate limit.
-   */
-  includeInfo?: boolean;
-
-  /**
-   * Query param: 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;
-
-  /**
-   * Query param: Sort order for results (asc or desc by creation time)
-   */
-  sortOrder?: string;
-}
-
-export interface VariationDeleteParams {
-  /**
-   * Workspace ID.
-   */
-  workspaceId?: string;
-}
-
-export type VariationAddAssignmentParams =
-  | VariationAddAssignmentParams.AddAgentVariationAssignmentRequestToolID
-  | VariationAddAssignmentParams.AddAgentVariationAssignmentRequestToolSetID
-  | VariationAddAssignmentParams.AddAgentVariationAssignmentRequestSubAgentID;
-
-export declare namespace VariationAddAssignmentParams {
-  export interface AddAgentVariationAssignmentRequestToolID {
-    /**
-     * Path param: Workspace ID.
-     */
-    workspaceId?: string;
-
-    /**
-     * Body param
-     */
-    toolId: string;
-
-    /**
-     * Body param
-     */
-    type: 'toolId';
-  }
-
-  export interface AddAgentVariationAssignmentRequestToolSetID {
-    /**
-     * Path param: Workspace ID.
-     */
-    workspaceId?: string;
-
-    /**
-     * Body param
-     */
-    toolSetId: string;
-
-    /**
-     * Body param
-     */
-    type: 'toolSetId';
-  }
-
-  export interface AddAgentVariationAssignmentRequestSubAgentID {
-    /**
-     * Path param: Workspace ID.
-     */
-    workspaceId?: string;
-
-    /**
-     * Body param
-     */
-    subAgentId: string;
-
-    /**
-     * Body param
-     */
-    type: 'subAgentId';
-  }
-}
-
-export interface VariationAddMemoryLayerParams {
-  /**
-   * Path param: Workspace ID.
-   */
-  workspaceId?: string;
-
-  /**
-   * Body param: Layer to attach. Accepts the canonical `memlyr_…` form or the
-   * `external_id:<value>` form.
-   */
-  memoryLayerId: string;
-
-  /**
-   * Body param: Position in the baseline cascade (lower = more specific). If
-   * omitted, the server appends at the most general end (max existing position + 1).
-   */
-  position?: number;
-}
-
-export interface VariationRemoveAssignmentParams {
-  /**
-   * Workspace ID.
-   */
-  workspaceId?: string;
-}
-
-export interface VariationRemoveMemoryLayerParams {
-  /**
-   * Workspace ID.
-   */
-  workspaceId?: string;
-}
-
-export interface VariationUpdateMemoryLayerParams {
-  /**
-   * Path param: Workspace ID.
-   */
-  workspaceId?: string;
-
-  /**
-   * Body param: New position. Only field currently updatable on an assignment.
-   */
-  position?: number;
-}
-
-export declare namespace Variations {
-  export {
-    type AddAgentVariationAssignmentRequestSubAgentID as AddAgentVariationAssignmentRequestSubAgentID,
-    type AddAgentVariationAssignmentRequestToolID as AddAgentVariationAssignmentRequestToolID,
-    type AddAgentVariationAssignmentRequestToolSetID as AddAgentVariationAssignmentRequestToolSetID,
-    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 AgentVariationSpecProgressiveDiscovery as AgentVariationSpecProgressiveDiscovery,
-    type CompactionConfigSummarizationStrategy as CompactionConfigSummarizationStrategy,
-    type CompactionConfigToolResultClearingStrategy as CompactionConfigToolResultClearingStrategy,
-    type VariationAssignment as VariationAssignment,
-    type VariationAssignmentAgent as VariationAssignmentAgent,
-    type VariationAssignmentTool as VariationAssignmentTool,
-    type VariationAssignmentToolSet as VariationAssignmentToolSet,
-    type VariationMemoryLayerAssignment as VariationMemoryLayerAssignment,
-    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 VariationAddAssignmentParams as VariationAddAssignmentParams,
-    type VariationAddMemoryLayerParams as VariationAddMemoryLayerParams,
-    type VariationRemoveAssignmentParams as VariationRemoveAssignmentParams,
-    type VariationRemoveMemoryLayerParams as VariationRemoveMemoryLayerParams,
-    type VariationUpdateMemoryLayerParams as VariationUpdateMemoryLayerParams,
-  };
-}