@cadenya/cadenya 0.44.0 → 0.46.0

package/src/client.ts

@@ -30,17 +30,20 @@ import {
 import {
   AgentVariation,
   AgentVariationAddAssignmentParams,
+  AgentVariationAddMemoryLayerParams,
   AgentVariationCreateParams,
   AgentVariationDeleteParams,
   AgentVariationInfo,
   AgentVariationListParams,
   AgentVariationRemoveAssignmentParams,
+  AgentVariationRemoveMemoryLayerParams,
   AgentVariationRetrieveParams,
   AgentVariationSpec,
   AgentVariationSpecCompactionConfig,
   AgentVariationSpecConstraints,
   AgentVariationSpecModelConfig,
   AgentVariationSpecToolSelection,
+  AgentVariationUpdateMemoryLayerParams,
   AgentVariationUpdateParams,
   AgentVariations,
   AgentVariationsCursorPagination,
@@ -49,6 +52,7 @@ import {
   ToolSelectionAssignedTools,
   ToolSelectionAutoDiscovery,
   VariationAssignment,
+  VariationMemoryLayerAssignment,
 } from './resources/agent-variations';
 import {
   APIKey,
@@ -73,6 +77,13 @@ import {
   SearchSearchToolsOrToolSetsParams,
   SearchSearchToolsOrToolSetsResponse,
 } from './resources/search';
+import {
+  Upload,
+  UploadCreateParams,
+  UploadInfo,
+  UploadSpec,
+  Uploads as UploadsAPIUploads,
+} from './resources/uploads';
 import { UnsafeUnwrapWebhookEvent, UnwrapWebhookEvent, Webhooks } from './resources/webhooks';
 import {
   WorkspaceSecret,
@@ -102,11 +113,23 @@ import {
   AgentsCursorPagination,
   Page,
 } from './resources/agents/agents';
+import {
+  MemoryLayer,
+  MemoryLayerCreateParams,
+  MemoryLayerInfo,
+  MemoryLayerListParams,
+  MemoryLayerSpec,
+  MemoryLayerUpdateParams,
+  MemoryLayers,
+  MemoryLayersCursorPagination,
+} from './resources/memory-layers/memory-layers';
 import {
   AssistantMessage,
   AssistantToolCall,
   CallableTool,
   ContextWindowCompacted,
+  MemoryRead,
+  MemoryReference,
   Objective,
   ObjectiveCancelParams,
   ObjectiveCompactParams,
@@ -917,6 +940,29 @@ export class Cadenya {
   agents: API.Agents = new API.Agents(this);
   agentVariations: API.AgentVariations = new API.AgentVariations(this);
   objectives: API.Objectives = new API.Objectives(this);
+  /**
+   * MemoryService manages memory layers and their entries at the WORKSPACE level.
+   *  Layers are named containers that can be composed into an objective's memory
+   *  stack; entries are the keyed values within a layer.
+   *
+   *  All operations are implicitly scoped to the workspace determined by the JWT
+   *  token. System-managed layers (e.g., episodic layers created by the runtime)
+   *  cannot be mutated through this API.
+   *
+   *  Authentication: Bearer token (JWT)
+   *  Scope: Workspace-level operations
+   */
+  memoryLayers: API.MemoryLayers = new API.MemoryLayers(this);
+  /**
+   * UploadService issues short-lived presigned URLs for direct client-to-object-
+   *  storage uploads at the WORKSPACE level. Created uploads can be referenced by
+   *  id when creating or updating resources that accept binary content (e.g.,
+   *  MemoryEntry).
+   *
+   *  Authentication: Bearer token (JWT)
+   *  Scope: Workspace-level operations
+   */
+  uploads: API.Uploads = new API.Uploads(this);
   /**
    * ModelService manages LLM models at the WORKSPACE level.
    *  Models represent available LLM providers and families (e.g., "anthropic/claude-sonnet-4.6").
@@ -965,6 +1011,8 @@ Cadenya.AccountResource = AccountResource;
 Cadenya.Agents = Agents;
 Cadenya.AgentVariations = AgentVariations;
 Cadenya.Objectives = Objectives;
+Cadenya.MemoryLayers = MemoryLayers;
+Cadenya.Uploads = UploadsAPIUploads;
 Cadenya.Models = Models;
 Cadenya.Search = Search;
 Cadenya.ToolSets = ToolSets;
@@ -1017,6 +1065,7 @@ export declare namespace Cadenya {
     type ToolSelectionAssignedTools as ToolSelectionAssignedTools,
     type ToolSelectionAutoDiscovery as ToolSelectionAutoDiscovery,
     type VariationAssignment as VariationAssignment,
+    type VariationMemoryLayerAssignment as VariationMemoryLayerAssignment,
     type AgentVariationsCursorPagination as AgentVariationsCursorPagination,
     type AgentVariationCreateParams as AgentVariationCreateParams,
     type AgentVariationRetrieveParams as AgentVariationRetrieveParams,
@@ -1024,7 +1073,10 @@ export declare namespace Cadenya {
     type AgentVariationListParams as AgentVariationListParams,
     type AgentVariationDeleteParams as AgentVariationDeleteParams,
     type AgentVariationAddAssignmentParams as AgentVariationAddAssignmentParams,
+    type AgentVariationAddMemoryLayerParams as AgentVariationAddMemoryLayerParams,
     type AgentVariationRemoveAssignmentParams as AgentVariationRemoveAssignmentParams,
+    type AgentVariationRemoveMemoryLayerParams as AgentVariationRemoveMemoryLayerParams,
+    type AgentVariationUpdateMemoryLayerParams as AgentVariationUpdateMemoryLayerParams,
   };
 
   export {
@@ -1033,6 +1085,8 @@ export declare namespace Cadenya {
     type AssistantToolCall as AssistantToolCall,
     type CallableTool as CallableTool,
     type ContextWindowCompacted as ContextWindowCompacted,
+    type MemoryRead as MemoryRead,
+    type MemoryReference as MemoryReference,
     type Objective as Objective,
     type ObjectiveContextWindow as ObjectiveContextWindow,
     type ObjectiveContextWindowData as ObjectiveContextWindowData,
@@ -1067,6 +1121,25 @@ export declare namespace Cadenya {
     type ObjectiveListEventsParams as ObjectiveListEventsParams,
   };
 
+  export {
+    MemoryLayers as MemoryLayers,
+    type MemoryLayer as MemoryLayer,
+    type MemoryLayerInfo as MemoryLayerInfo,
+    type MemoryLayerSpec as MemoryLayerSpec,
+    type MemoryLayersCursorPagination as MemoryLayersCursorPagination,
+    type MemoryLayerCreateParams as MemoryLayerCreateParams,
+    type MemoryLayerUpdateParams as MemoryLayerUpdateParams,
+    type MemoryLayerListParams as MemoryLayerListParams,
+  };
+
+  export {
+    UploadsAPIUploads as Uploads,
+    type Upload as Upload,
+    type UploadInfo as UploadInfo,
+    type UploadSpec as UploadSpec,
+    type UploadCreateParams as UploadCreateParams,
+  };
+
   export {
     Models as Models,
     type Model as Model,

package/src/resources/agent-variations.ts

@@ -85,6 +85,21 @@ export class AgentVariations extends APIResource {
     });
   }
 
+  /**
+   * Attaches a memory layer to a variation at a given position in the variation's
+   * baseline memory stack.
+   */
+  addMemoryLayer(
+    agentVariationID: string,
+    body: AgentVariationAddMemoryLayerParams,
+    options?: RequestOptions,
+  ): APIPromise<VariationMemoryLayerAssignment> {
+    return this._client.post(path`/v1/agent_variations/${agentVariationID}/memory_layers`, {
+      body,
+      ...options,
+    });
+  }
+
   /**
    * Detaches an assignment from a variation, identified by the assignment ID
    * returned when it was added.
@@ -100,6 +115,37 @@ export class AgentVariations extends APIResource {
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
   }
+
+  /**
+   * Detaches a memory layer assignment from a variation, identified by the
+   * assignment id.
+   */
+  removeMemoryLayer(
+    id: string,
+    params: AgentVariationRemoveMemoryLayerParams,
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    const { agentVariationId } = params;
+    return this._client.delete(path`/v1/agent_variations/${agentVariationId}/memory_layers/${id}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Updates the position of a memory layer assignment on a variation.
+   */
+  updateMemoryLayer(
+    id: string,
+    params: AgentVariationUpdateMemoryLayerParams,
+    options?: RequestOptions,
+  ): APIPromise<VariationMemoryLayerAssignment> {
+    const { agentVariationId, ...body } = params;
+    return this._client.patch(path`/v1/agent_variations/${agentVariationId}/memory_layers/${id}`, {
+      body,
+      ...options,
+    });
+  }
 }
 
 export type AgentVariationsCursorPagination = CursorPagination<AgentVariation>;
@@ -147,6 +193,17 @@ export interface AgentVariationInfo {
    */
   feedbackCount?: number;
 
+  /**
+   * Read-only list of memory layer assignments for this variation, returned in
+   * ascending `position` (bottom → top). 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)
    */
@@ -395,6 +452,41 @@ export interface VariationAssignment {
   toolSet?: Shared.BareMetadata;
 }
 
+/**
+ * VariationMemoryLayerAssignment attaches a single MemoryLayer to a variation at a
+ * given position in the variation's baseline memory stack. 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 stack. Lower values sit lower; the
+   * highest-position assignment is on top of the variation's baseline. 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 AgentVariationCreateParams {
   /**
    * CreateResourceMetadata contains the user-provided fields for creating a
@@ -469,10 +561,38 @@ export interface AgentVariationAddAssignmentParams {
   toolSetId?: string;
 }
 
+export interface AgentVariationAddMemoryLayerParams {
+  /**
+   * Layer to attach. Accepts memlyr\_… or external_id:… form.
+   */
+  memoryLayerId?: string;
+
+  /**
+   * Position in the stack. If omitted, server appends (max existing position + 1).
+   */
+  position?: number;
+}
+
 export interface AgentVariationRemoveAssignmentParams {
   agentVariationId: string;
 }
 
+export interface AgentVariationRemoveMemoryLayerParams {
+  agentVariationId: string;
+}
+
+export interface AgentVariationUpdateMemoryLayerParams {
+  /**
+   * Path param
+   */
+  agentVariationId: string;
+
+  /**
+   * Body param: New position. Only field currently updatable on an assignment.
+   */
+  position?: number;
+}
+
 export declare namespace AgentVariations {
   export {
     type AgentVariation as AgentVariation,
@@ -487,6 +607,7 @@ export declare namespace AgentVariations {
     type ToolSelectionAssignedTools as ToolSelectionAssignedTools,
     type ToolSelectionAutoDiscovery as ToolSelectionAutoDiscovery,
     type VariationAssignment as VariationAssignment,
+    type VariationMemoryLayerAssignment as VariationMemoryLayerAssignment,
     type AgentVariationsCursorPagination as AgentVariationsCursorPagination,
     type AgentVariationCreateParams as AgentVariationCreateParams,
     type AgentVariationRetrieveParams as AgentVariationRetrieveParams,
@@ -494,6 +615,9 @@ export declare namespace AgentVariations {
     type AgentVariationListParams as AgentVariationListParams,
     type AgentVariationDeleteParams as AgentVariationDeleteParams,
     type AgentVariationAddAssignmentParams as AgentVariationAddAssignmentParams,
+    type AgentVariationAddMemoryLayerParams as AgentVariationAddMemoryLayerParams,
     type AgentVariationRemoveAssignmentParams as AgentVariationRemoveAssignmentParams,
+    type AgentVariationRemoveMemoryLayerParams as AgentVariationRemoveMemoryLayerParams,
+    type AgentVariationUpdateMemoryLayerParams as AgentVariationUpdateMemoryLayerParams,
   };
 }

package/src/resources/agents/webhook-deliveries.ts

@@ -69,7 +69,8 @@ export interface WebhookDeliveryData {
     | 'OBJECTIVE_EVENT_TYPE_ASSISTANT_MESSAGE'
     | 'OBJECTIVE_EVENT_TYPE_TOOL_RESULT'
     | 'OBJECTIVE_EVENT_TYPE_TOOL_ERROR'
-    | 'OBJECTIVE_EVENT_TYPE_CONTEXT_WINDOW_COMPACTED';
+    | 'OBJECTIVE_EVENT_TYPE_CONTEXT_WINDOW_COMPACTED'
+    | 'OBJECTIVE_EVENT_TYPE_MEMORY_READ';
 
   /**
    * Response details (no response_body to avoid storing large payloads)
@@ -127,7 +128,8 @@ export interface WebhookDeliveryListParams extends CursorPaginationParams {
     | 'OBJECTIVE_EVENT_TYPE_ASSISTANT_MESSAGE'
     | 'OBJECTIVE_EVENT_TYPE_TOOL_RESULT'
     | 'OBJECTIVE_EVENT_TYPE_TOOL_ERROR'
-    | 'OBJECTIVE_EVENT_TYPE_CONTEXT_WINDOW_COMPACTED';
+    | 'OBJECTIVE_EVENT_TYPE_CONTEXT_WINDOW_COMPACTED'
+    | 'OBJECTIVE_EVENT_TYPE_MEMORY_READ';
 
   /**
    * Optional filter by objective ID

package/src/resources/index.ts

@@ -33,13 +33,17 @@ export {
   type ToolSelectionAssignedTools,
   type ToolSelectionAutoDiscovery,
   type VariationAssignment,
+  type VariationMemoryLayerAssignment,
   type AgentVariationCreateParams,
   type AgentVariationRetrieveParams,
   type AgentVariationUpdateParams,
   type AgentVariationListParams,
   type AgentVariationDeleteParams,
   type AgentVariationAddAssignmentParams,
+  type AgentVariationAddMemoryLayerParams,
   type AgentVariationRemoveAssignmentParams,
+  type AgentVariationRemoveMemoryLayerParams,
+  type AgentVariationUpdateMemoryLayerParams,
   type AgentVariationsCursorPagination,
 } from './agent-variations';
 export {
@@ -53,6 +57,16 @@ export {
   type AgentListParams,
   type AgentsCursorPagination,
 } from './agents/agents';
+export {
+  MemoryLayers,
+  type MemoryLayer,
+  type MemoryLayerInfo,
+  type MemoryLayerSpec,
+  type MemoryLayerCreateParams,
+  type MemoryLayerUpdateParams,
+  type MemoryLayerListParams,
+  type MemoryLayersCursorPagination,
+} from './memory-layers/memory-layers';
 export {
   Models,
   type Model,
@@ -67,6 +81,8 @@ export {
   type AssistantToolCall,
   type CallableTool,
   type ContextWindowCompacted,
+  type MemoryRead,
+  type MemoryReference,
   type Objective,
   type ObjectiveContextWindow,
   type ObjectiveContextWindowData,
@@ -126,6 +142,7 @@ export {
   type ToolSetsCursorPagination,
   type ToolSetEventsCursorPagination,
 } from './tool-sets/tool-sets';
+export { Uploads, type Upload, type UploadInfo, type UploadSpec, type UploadCreateParams } from './uploads';
 export { Webhooks, type UnsafeUnwrapWebhookEvent, type UnwrapWebhookEvent } from './webhooks';
 export {
   WorkspaceSecrets,