@cadenya/cadenya 0.88.0 → 0.89.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.89.0 (2026-06-11)
+
+Full Changelog: [v0.88.0...v0.89.0](https://github.com/cadenya/cadenya-typescript/compare/v0.88.0...v0.89.0)
+
+### Features
+
+* **api:** api update ([2df53ee](https://github.com/cadenya/cadenya-typescript/commit/2df53ee16abb63fd8a6c322e62990cdbe7286f98))
+
 ## 0.88.0 (2026-06-11)
 
 Full Changelog: [v0.87.0...v0.88.0](https://github.com/cadenya/cadenya-typescript/compare/v0.87.0...v0.88.0)

package/client.d.mts

@@ -206,7 +206,7 @@ export declare class Cadenya {
     objectives: API.Objectives;
     /**
      * Manage memory layers and their entries. Layers are named containers that can
-     *  be composed into an objective's memory stack; entries are the keyed values
+     *  be composed into an objective's memory cascade; entries are the keyed values
      *  within a layer. System-managed layers (e.g., episodic layers created by the
      *  runtime) cannot be mutated through this API.
      */

package/client.d.ts

@@ -206,7 +206,7 @@ export declare class Cadenya {
     objectives: API.Objectives;
     /**
      * Manage memory layers and their entries. Layers are named containers that can
-     *  be composed into an objective's memory stack; entries are the keyed values
+     *  be composed into an objective's memory cascade; entries are the keyed values
      *  within a layer. System-managed layers (e.g., episodic layers created by the
      *  runtime) cannot be mutated through this API.
      */

package/client.js

@@ -70,7 +70,7 @@ class Cadenya {
         this.objectives = new API.Objectives(this);
         /**
          * Manage memory layers and their entries. Layers are named containers that can
-         *  be composed into an objective's memory stack; entries are the keyed values
+         *  be composed into an objective's memory cascade; entries are the keyed values
          *  within a layer. System-managed layers (e.g., episodic layers created by the
          *  runtime) cannot be mutated through this API.
          */

package/client.mjs

@@ -67,7 +67,7 @@ export class Cadenya {
         this.objectives = new API.Objectives(this);
         /**
          * Manage memory layers and their entries. Layers are named containers that can
-         *  be composed into an objective's memory stack; entries are the keyed values
+         *  be composed into an objective's memory cascade; entries are the keyed values
          *  within a layer. System-managed layers (e.g., episodic layers created by the
          *  runtime) cannot be mutated through this API.
          */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cadenya/cadenya",
-  "version": "0.88.0",
+  "version": "0.89.0",
   "description": "The official TypeScript library for the Cadenya API",
   "author": "Cadenya <support@cadenya.com>",
   "types": "./index.d.ts",

package/resources/agents/variations.d.mts

@@ -35,7 +35,7 @@ export declare class Variations extends APIResource {
     addAssignment(variationID: string, params: VariationAddAssignmentParams, options?: RequestOptions): APIPromise<VariationAssignment>;
     /**
      * Attaches a memory layer to a variation at a given position in the variation's
-     * baseline memory stack.
+     * baseline memory cascade.
      */
     addMemoryLayer(variationID: string, params: VariationAddMemoryLayerParams, options?: RequestOptions): APIPromise<VariationMemoryLayerAssignment>;
     /**
@@ -93,7 +93,8 @@ 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.
+     * ascending `position` (most specific first — resolution order). Capped at 10
+     * entries.
      */
     memoryLayerAssignments?: Array<VariationMemoryLayerAssignment>;
     /**
@@ -302,8 +303,8 @@ export interface VariationAssignment {
 }
 /**
  * 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.
+ * 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.
@@ -324,9 +325,10 @@ export interface VariationMemoryLayerAssignment {
      */
     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
+     * 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.
      */
@@ -457,8 +459,8 @@ export interface VariationAddMemoryLayerParams {
      */
     memoryLayerId?: string;
     /**
-     * Body param: Position in the stack. If omitted, server appends (max existing
-     * position + 1).
+     * 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;
 }

package/resources/agents/variations.d.mts.map

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

package/resources/agents/variations.d.ts

@@ -35,7 +35,7 @@ export declare class Variations extends APIResource {
     addAssignment(variationID: string, params: VariationAddAssignmentParams, options?: RequestOptions): APIPromise<VariationAssignment>;
     /**
      * Attaches a memory layer to a variation at a given position in the variation's
-     * baseline memory stack.
+     * baseline memory cascade.
      */
     addMemoryLayer(variationID: string, params: VariationAddMemoryLayerParams, options?: RequestOptions): APIPromise<VariationMemoryLayerAssignment>;
     /**
@@ -93,7 +93,8 @@ 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.
+     * ascending `position` (most specific first — resolution order). Capped at 10
+     * entries.
      */
     memoryLayerAssignments?: Array<VariationMemoryLayerAssignment>;
     /**
@@ -302,8 +303,8 @@ export interface VariationAssignment {
 }
 /**
  * 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.
+ * 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.
@@ -324,9 +325,10 @@ export interface VariationMemoryLayerAssignment {
      */
     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
+     * 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.
      */
@@ -457,8 +459,8 @@ export interface VariationAddMemoryLayerParams {
      */
     memoryLayerId?: string;
     /**
-     * Body param: Position in the stack. If omitted, server appends (max existing
-     * position + 1).
+     * 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;
 }

package/resources/agents/variations.d.ts.map

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

package/resources/agents/variations.js

@@ -64,7 +64,7 @@ class Variations extends resource_1.APIResource {
     }
     /**
      * Attaches a memory layer to a variation at a given position in the variation's
-     * baseline memory stack.
+     * baseline memory cascade.
      */
     addMemoryLayer(variationID, params, options) {
         const { workspaceId, agentId, ...body } = params;

package/resources/agents/variations.mjs

@@ -61,7 +61,7 @@ export class Variations extends APIResource {
     }
     /**
      * Attaches a memory layer to a variation at a given position in the variation's
-     * baseline memory stack.
+     * baseline memory cascade.
      */
     addMemoryLayer(variationID, params, options) {
         const { workspaceId, agentId, ...body } = params;

package/resources/bulk-workspace-resources/results.d.mts

@@ -254,8 +254,8 @@ export interface BulkWorkspaceApplyResultDataMemoryEntryOutcome {
      * MemoryEntry is a single keyed value within a MemoryLayer. Entries are addressed
      * by their key, which follows the S3 object key safe-character convention (see
      * MemoryEntrySpec.key for the full rule). Keys are unique within a single layer;
-     * the same key may appear in multiple layers, in which case the LIFO stack-walk
-     * determines which one wins for a given objective.
+     * the same key may appear in multiple layers, in which case the cascade walk
+     * determines which one wins for a given objective (most specific layer first).
      *
      * MemoryEntry is the summary shape, returned by ListMemoryEntries. It does not
      * carry the entry body — callers that need the body must fetch the entry
@@ -319,11 +319,11 @@ export interface BulkWorkspaceApplyResultDataMemoryLayerOutcome {
     externalId?: string;
     /**
      * MemoryLayer is a named container of memory entries that can be composed into an
-     * objective's memory stack. Layers are workspace-scoped resources. The layer type
-     * controls how its entries participate in the agent loop — see MemoryLayerType for
-     * details.
+     * objective's memory cascade. Layers are workspace-scoped resources. The layer
+     * type controls how its entries participate in the agent loop — see
+     * MemoryLayerType for details.
      *
-     * See "Memory stack composition" above for how layers compose at lookup time.
+     * See "Memory cascade composition" above for how layers compose at lookup time.
      */
     resource?: MemoryLayersAPI.MemoryLayer;
 }
@@ -559,8 +559,8 @@ export interface BulkWorkspaceApplyResultDataVariationMemoryLayerOutcome {
     error?: BulkWorkspaceApplyResultDataVariationMemoryLayerOutcome.Error;
     /**
      * 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.
+     * 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.

package/resources/bulk-workspace-resources/results.d.ts

@@ -254,8 +254,8 @@ export interface BulkWorkspaceApplyResultDataMemoryEntryOutcome {
      * MemoryEntry is a single keyed value within a MemoryLayer. Entries are addressed
      * by their key, which follows the S3 object key safe-character convention (see
      * MemoryEntrySpec.key for the full rule). Keys are unique within a single layer;
-     * the same key may appear in multiple layers, in which case the LIFO stack-walk
-     * determines which one wins for a given objective.
+     * the same key may appear in multiple layers, in which case the cascade walk
+     * determines which one wins for a given objective (most specific layer first).
      *
      * MemoryEntry is the summary shape, returned by ListMemoryEntries. It does not
      * carry the entry body — callers that need the body must fetch the entry
@@ -319,11 +319,11 @@ export interface BulkWorkspaceApplyResultDataMemoryLayerOutcome {
     externalId?: string;
     /**
      * MemoryLayer is a named container of memory entries that can be composed into an
-     * objective's memory stack. Layers are workspace-scoped resources. The layer type
-     * controls how its entries participate in the agent loop — see MemoryLayerType for
-     * details.
+     * objective's memory cascade. Layers are workspace-scoped resources. The layer
+     * type controls how its entries participate in the agent loop — see
+     * MemoryLayerType for details.
      *
-     * See "Memory stack composition" above for how layers compose at lookup time.
+     * See "Memory cascade composition" above for how layers compose at lookup time.
      */
     resource?: MemoryLayersAPI.MemoryLayer;
 }
@@ -559,8 +559,8 @@ export interface BulkWorkspaceApplyResultDataVariationMemoryLayerOutcome {
     error?: BulkWorkspaceApplyResultDataVariationMemoryLayerOutcome.Error;
     /**
      * 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.
+     * 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.

package/resources/memory-layers/entries.d.mts

@@ -6,7 +6,7 @@ import { CursorPagination, type CursorPaginationParams, PagePromise } from "../.
 import { RequestOptions } from "../../internal/request-options.mjs";
 /**
  * Manage memory layers and their entries. Layers are named containers that can
- *  be composed into an objective's memory stack; entries are the keyed values
+ *  be composed into an objective's memory cascade; entries are the keyed values
  *  within a layer. System-managed layers (e.g., episodic layers created by the
  *  runtime) cannot be mutated through this API.
  */
@@ -40,8 +40,8 @@ export type MemoryEntriesCursorPagination = CursorPagination<MemoryEntry>;
  * MemoryEntry is a single keyed value within a MemoryLayer. Entries are addressed
  * by their key, which follows the S3 object key safe-character convention (see
  * MemoryEntrySpec.key for the full rule). Keys are unique within a single layer;
- * the same key may appear in multiple layers, in which case the LIFO stack-walk
- * determines which one wins for a given objective.
+ * the same key may appear in multiple layers, in which case the cascade walk
+ * determines which one wins for a given objective (most specific layer first).
  *
  * MemoryEntry is the summary shape, returned by ListMemoryEntries. It does not
  * carry the entry body — callers that need the body must fetch the entry

package/resources/memory-layers/entries.d.ts

@@ -6,7 +6,7 @@ import { CursorPagination, type CursorPaginationParams, PagePromise } from "../.
 import { RequestOptions } from "../../internal/request-options.js";
 /**
  * Manage memory layers and their entries. Layers are named containers that can
- *  be composed into an objective's memory stack; entries are the keyed values
+ *  be composed into an objective's memory cascade; entries are the keyed values
  *  within a layer. System-managed layers (e.g., episodic layers created by the
  *  runtime) cannot be mutated through this API.
  */
@@ -40,8 +40,8 @@ export type MemoryEntriesCursorPagination = CursorPagination<MemoryEntry>;
  * MemoryEntry is a single keyed value within a MemoryLayer. Entries are addressed
  * by their key, which follows the S3 object key safe-character convention (see
  * MemoryEntrySpec.key for the full rule). Keys are unique within a single layer;
- * the same key may appear in multiple layers, in which case the LIFO stack-walk
- * determines which one wins for a given objective.
+ * the same key may appear in multiple layers, in which case the cascade walk
+ * determines which one wins for a given objective (most specific layer first).
  *
  * MemoryEntry is the summary shape, returned by ListMemoryEntries. It does not
  * carry the entry body — callers that need the body must fetch the entry

package/resources/memory-layers/entries.js

@@ -8,7 +8,7 @@ const headers_1 = require("../../internal/headers.js");
 const path_1 = require("../../internal/utils/path.js");
 /**
  * Manage memory layers and their entries. Layers are named containers that can
- *  be composed into an objective's memory stack; entries are the keyed values
+ *  be composed into an objective's memory cascade; entries are the keyed values
  *  within a layer. System-managed layers (e.g., episodic layers created by the
  *  runtime) cannot be mutated through this API.
  */

package/resources/memory-layers/entries.mjs

@@ -5,7 +5,7 @@ import { buildHeaders } from "../../internal/headers.mjs";
 import { path } from "../../internal/utils/path.mjs";
 /**
  * Manage memory layers and their entries. Layers are named containers that can
- *  be composed into an objective's memory stack; entries are the keyed values
+ *  be composed into an objective's memory cascade; entries are the keyed values
  *  within a layer. System-managed layers (e.g., episodic layers created by the
  *  runtime) cannot be mutated through this API.
  */

package/resources/memory-layers/memory-layers.d.mts

@@ -8,7 +8,7 @@ import { CursorPagination, type CursorPaginationParams, PagePromise } from "../.
 import { RequestOptions } from "../../internal/request-options.mjs";
 /**
  * Manage memory layers and their entries. Layers are named containers that can
- *  be composed into an objective's memory stack; entries are the keyed values
+ *  be composed into an objective's memory cascade; entries are the keyed values
  *  within a layer. System-managed layers (e.g., episodic layers created by the
  *  runtime) cannot be mutated through this API.
  */
@@ -38,11 +38,11 @@ export declare class MemoryLayers extends APIResource {
 export type MemoryLayersCursorPagination = CursorPagination<MemoryLayer>;
 /**
  * MemoryLayer is a named container of memory entries that can be composed into an
- * objective's memory stack. Layers are workspace-scoped resources. The layer type
- * controls how its entries participate in the agent loop — see MemoryLayerType for
- * details.
+ * objective's memory cascade. Layers are workspace-scoped resources. The layer
+ * type controls how its entries participate in the agent loop — see
+ * MemoryLayerType for details.
  *
- * See "Memory stack composition" above for how layers compose at lookup time.
+ * See "Memory cascade composition" above for how layers compose at lookup time.
  */
 export interface MemoryLayer {
     /**
@@ -94,7 +94,7 @@ export interface MemoryLayerSpec {
     /**
      * Server-set. True for layers managed by the system (e.g., episodic layers created
      * automatically when an objective uses an episodic_key). System-managed layers
-     * cannot be assigned to objective stacks via the API and cannot be mutated by
+     * cannot be assigned to objective cascades via the API and cannot be mutated by
      * clients — their lifecycle is controlled entirely by the runtime.
      */
     systemManaged?: boolean;

package/resources/memory-layers/memory-layers.d.ts

@@ -8,7 +8,7 @@ import { CursorPagination, type CursorPaginationParams, PagePromise } from "../.
 import { RequestOptions } from "../../internal/request-options.js";
 /**
  * Manage memory layers and their entries. Layers are named containers that can
- *  be composed into an objective's memory stack; entries are the keyed values
+ *  be composed into an objective's memory cascade; entries are the keyed values
  *  within a layer. System-managed layers (e.g., episodic layers created by the
  *  runtime) cannot be mutated through this API.
  */
@@ -38,11 +38,11 @@ export declare class MemoryLayers extends APIResource {
 export type MemoryLayersCursorPagination = CursorPagination<MemoryLayer>;
 /**
  * MemoryLayer is a named container of memory entries that can be composed into an
- * objective's memory stack. Layers are workspace-scoped resources. The layer type
- * controls how its entries participate in the agent loop — see MemoryLayerType for
- * details.
+ * objective's memory cascade. Layers are workspace-scoped resources. The layer
+ * type controls how its entries participate in the agent loop — see
+ * MemoryLayerType for details.
  *
- * See "Memory stack composition" above for how layers compose at lookup time.
+ * See "Memory cascade composition" above for how layers compose at lookup time.
  */
 export interface MemoryLayer {
     /**
@@ -94,7 +94,7 @@ export interface MemoryLayerSpec {
     /**
      * Server-set. True for layers managed by the system (e.g., episodic layers created
      * automatically when an objective uses an episodic_key). System-managed layers
-     * cannot be assigned to objective stacks via the API and cannot be mutated by
+     * cannot be assigned to objective cascades via the API and cannot be mutated by
      * clients — their lifecycle is controlled entirely by the runtime.
      */
     systemManaged?: boolean;

package/resources/memory-layers/memory-layers.js

@@ -11,7 +11,7 @@ const headers_1 = require("../../internal/headers.js");
 const path_1 = require("../../internal/utils/path.js");
 /**
  * Manage memory layers and their entries. Layers are named containers that can
- *  be composed into an objective's memory stack; entries are the keyed values
+ *  be composed into an objective's memory cascade; entries are the keyed values
  *  within a layer. System-managed layers (e.g., episodic layers created by the
  *  runtime) cannot be mutated through this API.
  */

package/resources/memory-layers/memory-layers.mjs

@@ -7,7 +7,7 @@ import { buildHeaders } from "../../internal/headers.mjs";
 import { path } from "../../internal/utils/path.mjs";
 /**
  * Manage memory layers and their entries. Layers are named containers that can
- *  be composed into an objective's memory stack; entries are the keyed values
+ *  be composed into an objective's memory cascade; entries are the keyed values
  *  within a layer. System-managed layers (e.g., episodic layers created by the
  *  runtime) cannot be mutated through this API.
  */

package/resources/objectives/objectives.d.mts

@@ -115,8 +115,8 @@ export interface ContextWindowCompacted {
 }
 /**
  * MemoryRead is emitted each time the agent resolves a key against the memory
- * stack and loads an entry. Lookups that miss (key not found in any layer) do not
- * emit this event.
+ * cascade and loads an entry. Lookups that miss (key not found in any layer) do
+ * not emit this event.
  */
 export interface MemoryRead {
     /**
@@ -138,7 +138,7 @@ export interface MemoryRead {
 }
 /**
  * MemoryReference identifies a memory layer or a specific entry within one, for
- * composition into a memory stack. Used on objectives (where entry pinning is
+ * composition into a memory cascade. Used on objectives (where entry pinning is
  * permitted).
  *
  * memory*layer_id accepts both the canonical form (memlyr*…) and the external-id
@@ -146,9 +146,10 @@ export interface MemoryRead {
  */
 export interface MemoryReference {
     /**
-     * When set, pushes only this entry from memory_layer_id onto the stack — behaves
-     * as a single-entry layer (only this key resolves at this position). The entry
-     * must belong to memory_layer_id; mismatches are rejected with InvalidArgument.
+     * When set, inserts only this entry from memory_layer_id into the cascade —
+     * behaves as a single-entry layer (only this key resolves at this position). The
+     * entry must belong to memory_layer_id; mismatches are rejected with
+     * InvalidArgument.
      */
     memoryEntryId?: string;
     memoryLayerId?: string;
@@ -198,23 +199,21 @@ export interface Objective {
      */
     info?: ObjectiveInfo;
     /**
-     * Memory layers/entries to push onto this objective's memory stack on top of the
-     * baseline stack inherited from the selected variation.
+     * Memory layers/entries layered over the baseline cascade inherited from the
+     * selected variation — element-level rules over inherited styles, in CSS terms.
      *
-     * Array order is push order: the first element sits lower in the objective's
-     * contribution to the stack; the LAST element ends up on top of the effective
-     * stack. Entries pinned via memory_entry_id behave as single-entry layers at their
-     * position.
+     * Array order is resolution order: EARLIER elements are more specific and are
+     * consulted first. Entries pinned via memory_entry_id behave as single-entry
+     * layers at their position.
      *
      * System-managed layers (e.g., episodic) cannot be referenced here; they attach
-     * themselves automatically based on episodic_key.
-     *
-     * Stack size cap: the TOTAL effective stack (variation's memory layers
+     * themselves automatically based on the episodic key.
      *
-     * - this field) must not exceed 10 entries. A request that would produce an
-     *   effective stack larger than 10 is rejected with InvalidArgument.
+     * Size cap: the TOTAL effective cascade (this field + the variation's memory layer
+     * assignments) must not exceed 10 entries. A request that would produce a larger
+     * cascade is rejected with InvalidArgument.
      */
-    memoryStack?: Array<MemoryReference>;
+    memoryCascade?: Array<MemoryReference>;
     /**
      * The output of the objective, populated when the objective completes. Will match
      * the schema of output_json_schema or output_json_inferred. This will only be set
@@ -358,8 +357,8 @@ export interface ObjectiveEventData {
     finalized?: ObjectiveEventData.Finalized;
     /**
      * MemoryRead is emitted each time the agent resolves a key against the memory
-     * stack and loads an entry. Lookups that miss (key not found in any layer) do not
-     * emit this event.
+     * cascade and loads an entry. Lookups that miss (key not found in any layer) do
+     * not emit this event.
      */
     memoryRead?: MemoryRead;
     subAgentSpawned?: SubAgentSpawned;
@@ -490,12 +489,14 @@ export interface ObjectiveInfo {
      */
     currentContextWindowId: string;
     /**
-     * The effective memory stack at objective creation time, flattened from the
-     * variation's baseline plus Objective.memory_stack. Order is push order (last =
-     * top). Returned on reads so clients can see exactly what stack the objective is
-     * using without having to re-join variation state.
+     * The effective memory cascade at objective creation time: the episodic layer
+     * (when present), then Objective.memory_cascade, then the variation's baseline
+     * layers by ascending position. Order is resolution order — index 0 is the most
+     * specific and is consulted first; the first layer containing a key wins. Returned
+     * on reads so clients can see exactly what the objective resolves against without
+     * re-joining variation state.
      */
-    effectiveMemoryStack: Array<MemoryReference>;
+    effectiveMemoryCascade: Array<MemoryReference>;
     /**
      * Total number of context windows that this objective has generated
      */
@@ -661,23 +662,21 @@ export interface ObjectiveCreateParams {
      */
     initialMessage?: string;
     /**
-     * Memory layers/entries to push onto this objective's memory stack on top of the
-     * baseline stack inherited from the selected variation.
+     * Memory layers/entries layered over the baseline cascade inherited from the
+     * selected variation — element-level rules over inherited styles, in CSS terms.
      *
-     * Array order is push order: the first element sits lower in the objective's
-     * contribution to the stack; the LAST element ends up on top of the effective
-     * stack. Entries pinned via memory_entry_id behave as single-entry layers at their
-     * position.
+     * Array order is resolution order: EARLIER elements are more specific and are
+     * consulted first. Entries pinned via memory_entry_id behave as single-entry
+     * layers at their position.
      *
      * System-managed layers (e.g., episodic) cannot be referenced here; they attach
-     * themselves automatically based on episodic_key.
-     *
-     * Stack size cap: the TOTAL effective stack (variation's memory layers
+     * themselves automatically based on the episodic key.
      *
-     * - this field) must not exceed 10 entries. A request that would produce an
-     *   effective stack larger than 10 is rejected with InvalidArgument.
+     * Size cap: the TOTAL effective cascade (this field + the variation's memory layer
+     * assignments) must not exceed 10 entries. A request that would produce a larger
+     * cascade is rejected with InvalidArgument.
      */
-    memoryStack?: Array<MemoryReference>;
+    memoryCascade?: Array<MemoryReference>;
     /**
      * CreateOperationMetadata contains the user-provided fields for creating an
      * operation. Read-only fields (id, account_id, workspace_id, created_at,