@cadenya/cadenya 0.134.0 → 1.0.0

package/src/index.ts

@@ -1,23 +1,36 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+// Generated by redwood. Do not edit by hand.
 
-export { Cadenya as default } from './client';
-
-export { type Uploadable, toFile } from './core/uploads';
-export { APIPromise } from './core/api-promise';
-export { Cadenya, type ClientOptions } from './client';
-export { PagePromise } from './core/pagination';
-export {
-  CadenyaError,
-  APIError,
-  APIConnectionError,
-  APIConnectionTimeoutError,
-  APIUserAbortError,
-  NotFoundError,
-  ConflictError,
-  RateLimitError,
-  BadRequestError,
-  AuthenticationError,
-  InternalServerError,
-  PermissionDeniedError,
-  UnprocessableEntityError,
-} from './core/error';
+export { Cadenya, Cadenya as default } from './client.js';
+export type { ClientOptions } from './client.js';
+export { APIError, APIConnectionError, APIUserAbortError, APIRequestError, APIResponseError, APITimeoutError } from './core/error.js';
+export type { RequestOptions } from './core/http.js';
+export { APIPromise } from './core/http.js';
+export { Page } from './core/pagination.js';
+export { Stream } from './core/sse.js';
+export type { ServerSentEvent } from './core/sse.js';
+export * from './types.js';
+export * from './webhooks.js';
+export { WebhookVerifier, WebhookVerificationError } from './core/webhooks.js';
+export type { WebhookHeaders, WebhookVerifyOptions } from './core/webhooks.js';
+export * from './resources/accounts.js';
+export * from './resources/api-keys.js';
+export * from './resources/workspace-admin.js';
+export * from './resources/profiles.js';
+export * from './resources/workspaces.js';
+export * from './resources/agents.js';
+export * from './resources/agent-schedules.js';
+export * from './resources/agent-variations.js';
+export * from './resources/ai-provider-keys.js';
+export * from './resources/memory-layers.js';
+export * from './resources/memory-entries.js';
+export * from './resources/models.js';
+export * from './resources/objectives.js';
+export * from './resources/tool-search.js';
+export * from './resources/tenants.js';
+export * from './resources/tool-sets.js';
+export * from './resources/tool-set-secrets.js';
+export * from './resources/tools.js';
+export * from './resources/uploads.js';
+export * from './resources/widget-sessions.js';
+export * from './resources/widgets.js';
+export * from './resources/workspace-secrets.js';

package/src/resources/accounts.ts

@@ -0,0 +1,50 @@
+// Generated by redwood. Do not edit by hand.
+
+import { HttpClient, RequestOptions, APIPromise } from '../core/http.js';
+import type { Account, RotateChallengeTokenResponse, RotateWebhookEventsHmacSecretResponse } from '../types.js';
+
+export class Accounts {
+  constructor(private readonly _client: HttpClient) {}
+
+  /**
+   * Retrieves the current account for the token accessing the API
+   * 
+   * @example
+   * ```ts
+   * const account = await client.accounts.retrieve();
+   * ```
+   */
+  retrieve(options?: RequestOptions): APIPromise<Account> {
+    return this._client.requestAPI<Account>(() => {
+      return { method: 'GET', path: `/v1/account` };
+    }, options);
+  }
+
+  /**
+   * Rotates the challenge token for the account
+   * 
+   * @example
+   * ```ts
+   * const rotateChallengeTokenResponse = await client.accounts.rotateChallengeToken();
+   * ```
+   */
+  rotateChallengeToken(options?: RequestOptions): APIPromise<RotateChallengeTokenResponse> {
+    return this._client.requestAPI<RotateChallengeTokenResponse>(() => {
+      return { method: 'POST', path: `/v1/account:rotateChallengeToken` };
+    }, options);
+  }
+
+  /**
+   * Rotates the webhook signing key for the account
+   * 
+   * @example
+   * ```ts
+   * const rotateWebhookEventsHmacSecretResponse = await client.accounts.rotateWebhookSigningKey();
+   * ```
+   */
+  rotateWebhookSigningKey(options?: RequestOptions): APIPromise<RotateWebhookEventsHmacSecretResponse> {
+    return this._client.requestAPI<RotateWebhookEventsHmacSecretResponse>(() => {
+      return { method: 'POST', path: `/v1/account:rotateWebhookSigningKey` };
+    }, options);
+  }
+}

package/src/resources/agent-schedules.ts

@@ -0,0 +1,251 @@
+// Generated by redwood. Do not edit by hand.
+
+import { HttpClient, RequestOptions, APIPromise, pathSegment, snapshotParams } from '../core/http.js';
+import { Page } from '../core/pagination.js';
+import type { AgentSchedule, AgentScheduleSpec, CreateResourceMetadata, ListAgentSchedulesResponse, UpdateResourceMetadata } from '../types.js';
+
+export interface AgentScheduleListParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+  /**
+   * Maximum number of results to return.
+   */
+  limit?: number;
+  /**
+   * Pagination cursor from previous response.
+   */
+  cursor?: string;
+  /**
+   * Filter expression (query param: prefix).
+   */
+  prefix?: string;
+  /**
+   * Free-form search query.
+   */
+  query?: string;
+  /**
+   * Filters by metadata labels. Comma-separated key=value pairs,
+   *  e.g. "env=prod,team=ai". A resource matches only if every pair
+   *  matches exactly (AND semantics).
+   */
+  labels?: string;
+  /**
+   * Sort order for results (asc or desc by creation time).
+   */
+  sortOrder?: string;
+  /**
+   * When true, the `info` field on each returned schedule is populated.
+   *  Requests with this flag count more against your rate limit.
+   */
+  includeInfo?: boolean;
+}
+
+export interface AgentScheduleCreateParams {
+  metadata: CreateResourceMetadata;
+  spec: AgentScheduleSpec;
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface AgentScheduleRetrieveParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface AgentScheduleDeleteParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface AgentScheduleUpdateParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+  metadata?: UpdateResourceMetadata;
+  spec?: AgentScheduleSpec;
+  /**
+   * Fields to update.
+   */
+  updateMask?: string;
+}
+
+export interface AgentScheduleArchiveParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface AgentSchedulePauseParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface AgentScheduleResumeParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export class AgentSchedules {
+  constructor(private readonly _client: HttpClient) {}
+
+  /**
+   * List schedules
+   * 
+   * @example
+   * ```ts
+   * const page = await client.agents.schedules.list('agent_123');
+   * for await (const item of page) {
+   *   // auto-fetches every page
+   * }
+   * ```
+   */
+  async list(agentId: string, params?: AgentScheduleListParams, options?: RequestOptions): Promise<Page<AgentSchedule>> {
+    const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+    if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+    const _base = snapshotParams(params);
+    const response = await this._client.request<ListAgentSchedulesResponse>({ method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/agents/${pathSegment('agentId', agentId)}/schedules`, query: { limit: params?.limit, cursor: params?.cursor, prefix: params?.prefix, query: params?.query, labels: params?.labels, sortOrder: params?.sortOrder, includeInfo: params?.includeInfo } }, options);
+    return new Page(response.items ?? [], response.pagination?.nextCursor, (cursor) => this.list(agentId, { ..._base, cursor: cursor }, options));
+  }
+
+  /**
+   * Create a new schedule
+   * 
+   * @example
+   * ```ts
+   * const agentSchedule = await client.agents.schedules.create('agent_123', { metadata: { name: 'sample' }, spec: { schedule: {  } } });
+   * ```
+   */
+  create(agentId: string, params: AgentScheduleCreateParams, options?: RequestOptions): APIPromise<AgentSchedule> {
+    return this._client.requestAPI<AgentSchedule>(() => {
+      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)}/schedules`, body: { metadata: params.metadata, spec: params.spec } };
+    }, options);
+  }
+
+  /**
+   * Get a schedule by ID
+   * 
+   * @example
+   * ```ts
+   * const agentSchedule = await client.agents.schedules.retrieve('agent_123', '_123');
+   * ```
+   */
+  retrieve(agentId: string, id: string, params?: AgentScheduleRetrieveParams, options?: RequestOptions): APIPromise<AgentSchedule> {
+    return this._client.requestAPI<AgentSchedule>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/agents/${pathSegment('agentId', agentId)}/schedules/${pathSegment('id', id)}` };
+    }, options);
+  }
+
+  /**
+   * Delete a schedule
+   * 
+   * @example
+   * ```ts
+   * await client.agents.schedules.delete('agent_123', '_123');
+   * ```
+   */
+  delete(agentId: string, id: string, params?: AgentScheduleDeleteParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.requestAPI<void>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'DELETE', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/agents/${pathSegment('agentId', agentId)}/schedules/${pathSegment('id', id)}`, void: true };
+    }, options);
+  }
+
+  /**
+   * Update a schedule
+   * 
+   * @example
+   * ```ts
+   * const agentSchedule = await client.agents.schedules.update('agent_123', '_123');
+   * ```
+   */
+  update(agentId: string, id: string, params?: AgentScheduleUpdateParams, options?: RequestOptions): APIPromise<AgentSchedule> {
+    return this._client.requestAPI<AgentSchedule>(() => {
+      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)}/schedules/${pathSegment('id', id)}`, body: { metadata: params?.metadata, spec: params?.spec, updateMask: params?.updateMask } };
+    }, options);
+  }
+
+  /**
+   * Archive a schedule
+   * 
+   * @example
+   * ```ts
+   * const agentSchedule = await client.agents.schedules.archive('agent_123', '_123');
+   * ```
+   */
+  archive(agentId: string, id: string, params?: AgentScheduleArchiveParams, options?: RequestOptions): APIPromise<AgentSchedule> {
+    return this._client.requestAPI<AgentSchedule>(() => {
+      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)}/schedules/${pathSegment('id', id)}:archive` };
+    }, options);
+  }
+
+  /**
+   * Pause a schedule
+   * 
+   * @example
+   * ```ts
+   * const agentSchedule = await client.agents.schedules.pause('agent_123', '_123');
+   * ```
+   */
+  pause(agentId: string, id: string, params?: AgentSchedulePauseParams, options?: RequestOptions): APIPromise<AgentSchedule> {
+    return this._client.requestAPI<AgentSchedule>(() => {
+      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)}/schedules/${pathSegment('id', id)}:pause` };
+    }, options);
+  }
+
+  /**
+   * Resume a schedule
+   * 
+   * @example
+   * ```ts
+   * const agentSchedule = await client.agents.schedules.resume('agent_123', '_123');
+   * ```
+   */
+  resume(agentId: string, id: string, params?: AgentScheduleResumeParams, options?: RequestOptions): APIPromise<AgentSchedule> {
+    return this._client.requestAPI<AgentSchedule>(() => {
+      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)}/schedules/${pathSegment('id', id)}:resume` };
+    }, options);
+  }
+}

package/src/resources/agent-variations.ts

@@ -0,0 +1,312 @@
+// Generated by redwood. Do not edit by hand.
+
+import { HttpClient, RequestOptions, APIPromise, pathSegment, snapshotParams } from '../core/http.js';
+import { Page } from '../core/pagination.js';
+import type { AddAgentVariationAssignmentRequestParam, AgentVariation, AgentVariationSpec, CreateResourceMetadata, ListAgentVariationsResponse, UpdateResourceMetadata, VariationAssignment, VariationMemoryLayerAssignment } from '../types.js';
+import { wireAddAgentVariationAssignmentRequest } from '../types.js';
+
+export interface AgentVariationListParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+  /**
+   * Maximum number of results to return
+   */
+  limit?: number;
+  /**
+   * Pagination cursor from previous response
+   */
+  cursor?: string;
+  /**
+   * Sort order for results (asc or desc by creation time)
+   */
+  sortOrder?: string;
+  /**
+   * When true, the `info` field on each returned variation is populated.
+   *  Requests with this flag count more against your rate limit.
+   */
+  includeInfo?: boolean;
+  /**
+   * 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;
+}
+
+export interface AgentVariationCreateParams {
+  metadata: CreateResourceMetadata;
+  spec: AgentVariationSpec;
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface AgentVariationRetrieveParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface AgentVariationDeleteParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface AgentVariationUpdateParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+  metadata?: UpdateResourceMetadata;
+  spec?: AgentVariationSpec;
+  /**
+   * Fields to update
+   */
+  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 {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface AgentVariationAddMemoryLayerParams {
+  /**
+   * Layer to attach. Accepts the canonical `memlyr_…` form or the `external_id:<value>` form.
+   */
+  memoryLayerId: string;
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+  /**
+   * 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 AgentVariationRemoveMemoryLayerParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface AgentVariationUpdateMemoryLayerParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+  /**
+   * New position. Only field currently updatable on an assignment.
+   */
+  position?: number;
+}
+
+export class AgentVariations {
+  constructor(private readonly _client: HttpClient) {}
+
+  /**
+   * List variations
+   * 
+   * @example
+   * ```ts
+   * const page = await client.agents.variations.list('agent_123');
+   * for await (const item of page) {
+   *   // auto-fetches every page
+   * }
+   * ```
+   */
+  async list(agentId: string, params?: AgentVariationListParams, options?: RequestOptions): Promise<Page<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.");
+    const _base = snapshotParams(params);
+    const response = await this._client.request<ListAgentVariationsResponse>({ method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/agents/${pathSegment('agentId', agentId)}/variations`, query: { limit: params?.limit, cursor: params?.cursor, sortOrder: params?.sortOrder, includeInfo: params?.includeInfo, labels: params?.labels } }, options);
+    return new Page(response.items ?? [], response.pagination?.nextCursor, (cursor) => this.list(agentId, { ..._base, cursor: cursor }, options));
+  }
+
+  /**
+   * Create a new variation
+   * 
+   * @example
+   * ```ts
+   * const agentVariation = await client.agents.variations.create('agent_123', { metadata: { name: 'sample' }, spec: {  } });
+   * ```
+   */
+  create(agentId: string, params: AgentVariationCreateParams, 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: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/agents/${pathSegment('agentId', agentId)}/variations`, body: { metadata: params.metadata, spec: params.spec } };
+    }, options);
+  }
+
+  /**
+   * Get a variation by ID
+   * 
+   * @example
+   * ```ts
+   * const agentVariation = await client.agents.variations.retrieve('agent_123', '_123');
+   * ```
+   */
+  retrieve(agentId: string, id: string, params?: AgentVariationRetrieveParams, 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: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/agents/${pathSegment('agentId', agentId)}/variations/${pathSegment('id', id)}` };
+    }, options);
+  }
+
+  /**
+   * Delete a variation
+   * 
+   * @example
+   * ```ts
+   * await client.agents.variations.delete('agent_123', '_123');
+   * ```
+   */
+  delete(agentId: string, id: string, params?: AgentVariationDeleteParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.requestAPI<void>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'DELETE', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/agents/${pathSegment('agentId', agentId)}/variations/${pathSegment('id', id)}`, void: true };
+    }, options);
+  }
+
+  /**
+   * Update a variation
+   * 
+   * @example
+   * ```ts
+   * const agentVariation = await client.agents.variations.update('agent_123', '_123');
+   * ```
+   */
+  update(agentId: string, id: string, params?: AgentVariationUpdateParams, 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('id', id)}`, body: { metadata: params?.metadata, spec: params?.spec, updateMask: params?.updateMask } };
+    }, options);
+  }
+
+  /**
+   * Add an assignment to a variation
+   * 
+   * @example
+   * ```ts
+   * const variationAssignment = await client.agents.variations.addAssignment('agent_123', 'variation_123', { body: { toolId: 'sample', type: 'toolId' } });
+   * ```
+   */
+  addAssignment(agentId: string, variationId: string, params: AgentVariationAddAssignmentParams, options?: RequestOptions): APIPromise<VariationAssignment> {
+    return this._client.requestAPI<VariationAssignment>(() => {
+      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) };
+    }, options);
+  }
+
+  /**
+   * Remove an assignment from a variation
+   * 
+   * @example
+   * ```ts
+   * await client.agents.variations.removeAssignment('agent_123', 'variation_123', '_123');
+   * ```
+   */
+  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;
+      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 };
+    }, options);
+  }
+
+  /**
+   * Attach a memory layer to a variation
+   * 
+   * @example
+   * ```ts
+   * const variationMemoryLayerAssignment = await client.agents.variations.addMemoryLayer('agent_123', 'variation_123', { memoryLayerId: 'sample' });
+   * ```
+   */
+  addMemoryLayer(agentId: string, variationId: string, params: AgentVariationAddMemoryLayerParams, options?: RequestOptions): APIPromise<VariationMemoryLayerAssignment> {
+    return this._client.requestAPI<VariationMemoryLayerAssignment>(() => {
+      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 } };
+    }, options);
+  }
+
+  /**
+   * Remove a memory layer assignment from a variation
+   * 
+   * @example
+   * ```ts
+   * await client.agents.variations.removeMemoryLayer('agent_123', 'variation_123', '_123');
+   * ```
+   */
+  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;
+      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 };
+    }, options);
+  }
+
+  /**
+   * Update a variation's memory layer assignment
+   * 
+   * @example
+   * ```ts
+   * const variationMemoryLayerAssignment = await client.agents.variations.updateMemoryLayer('agent_123', 'variation_123', '_123');
+   * ```
+   */
+  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;
+      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 } };
+    }, options);
+  }
+}