cadenya 0.12.0 → 0.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cc33022d12e62f8273e8a7aa25cc2f020c231e6ce29f66775f9b144747d5658f
-  data.tar.gz: 619df9b5f16e896b922e1f8a1fa312f175a869154eb78a54c29a641e20f09b6b
+  metadata.gz: 9d745ee46b5834e75465c12e027582ba88c12d3ec89e31546dba9fbb952a52ae
+  data.tar.gz: 14109f1c53873b94aac6562a48669211f8845299f19ec8d10ff89968f2f5e862
 SHA512:
-  metadata.gz: 67d08c0901b15069f74e1a8a071876d9ac7c2871f5d73c2986c28ce4b6c01fe564a3385e6bd932f018a6392094d10e3d0a860f9bcd199435cc4fb99beb3a52d4
-  data.tar.gz: e6bd7a52e5e2a517108f7eeb6a3902c4662ed72c4158e06da10fc0862fc9292191d479ede3e87662a6104d9a680fe62d9e05d51be0f3b15ed9015907780415f4
+  metadata.gz: 0ee1346f5e40ac85863bfe7ea5181159a810e92a1f68c0f83e357887caa589c711aa167a03061483b82ef8d2856c7497466817b09794379fb47b3cf534be5786
+  data.tar.gz: 36de46a6cd4079c7f527c33c71126c54c6f74db804452e2ba90838b4bfa6a0fc03e65654b8360944653f38d05bc7da357d2f86383284f058cc74b3e490f5b90e

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.13.0 (2026-06-11)
+
+Full Changelog: [v0.12.0...v0.13.0](https://github.com/cadenya/cadenya-ruby/compare/v0.12.0...v0.13.0)
+
+### Features
+
+* **api:** api update ([9a5ddd6](https://github.com/cadenya/cadenya-ruby/commit/9a5ddd6a2e2628aa7a73894216112b252ca8b0ba))
+
 ## 0.12.0 (2026-06-10)
 
 Full Changelog: [v0.11.0...v0.12.0](https://github.com/cadenya/cadenya-ruby/compare/v0.11.0...v0.12.0)

data/README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "cadenya", "~> 0.12.0"
+gem "cadenya", "~> 0.13.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/cadenya/models/agent_spec.rb

@@ -18,6 +18,24 @@ module Cadenya
       #   @return [String, nil]
       optional :description, String
 
+      # @!attribute enable_episodic_memory
+      #   Enable episodic memory for objectives created for this agent. When true,
+      #   objective creation requires an episodic_memory key and the system finds or
+      #   creates a memory layer for that (agent, key) pair, letting the agent store and
+      #   retrieve memories across objectives that share the key. Memory is agent-level so
+      #   all variations of the agent share the same layers.
+      #
+      #   @return [Boolean, nil]
+      optional :enable_episodic_memory, Cadenya::Internal::Type::Boolean, api_name: :enableEpisodicMemory
+
+      # @!attribute episodic_memory_ttl
+      #   How long episodic memories should be retained. Each new objective slides the
+      #   layer's expiry forward by this duration, and stored entries expire this long
+      #   after they are written. If not set, episodic memories are retained indefinitely.
+      #
+      #   @return [Integer, nil]
+      optional :episodic_memory_ttl, Integer, api_name: :episodicMemoryTtl
+
       # @!attribute input_data_schema
       #   InputDataSchema is used for enforcing a data input when objectives are created.
       #   This is valuable when using liquid formatting in agent variation prompts. Input
@@ -47,7 +65,7 @@ module Cadenya
       #   @return [String, nil]
       optional :webhook_events_url, String, api_name: :webhookEventsUrl
 
-      # @!method initialize(variation_selection_mode:, description: nil, input_data_schema: nil, output_definition: nil, webhook_events_url: nil)
+      # @!method initialize(variation_selection_mode:, description: nil, enable_episodic_memory: nil, episodic_memory_ttl: nil, input_data_schema: nil, output_definition: nil, webhook_events_url: nil)
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::AgentSpec} for more details.
       #
@@ -57,6 +75,10 @@ module Cadenya
       #
       #   @param description [String] Description of the agent's purpose
       #
+      #   @param enable_episodic_memory [Boolean] Enable episodic memory for objectives created for this agent.
+      #
+      #   @param episodic_memory_ttl [Integer] How long episodic memories should be retained.
+      #
       #   @param input_data_schema [Hash{Symbol=>Object}] InputDataSchema is used for enforcing a data input when objectives are created.
       #
       #   @param output_definition [Hash{Symbol=>Object}] Optional output definition for objectives created for this agent.

data/lib/cadenya/models/agents/agent_variation_spec.rb

@@ -25,23 +25,6 @@ module Cadenya
         #   @return [String, nil]
         optional :description, String
 
-        # @!attribute enable_episodic_memory
-        #   Enable episodic memory for objectives using this variation. When true, the
-        #   system automatically creates a document namespace for each objective using the
-        #   objective's episodic_key as the external_id, allowing the agent to store and
-        #   retrieve documents specific to that episode.
-        #
-        #   @return [Boolean, nil]
-        optional :enable_episodic_memory, Cadenya::Internal::Type::Boolean, api_name: :enableEpisodicMemory
-
-        # @!attribute episodic_memory_ttl
-        #   How long episodic memories should be retained. After this duration, episodic
-        #   document namespaces can be automatically cleaned up. If not set, episodic
-        #   memories are retained indefinitely.
-        #
-        #   @return [Integer, nil]
-        optional :episodic_memory_ttl, Integer, api_name: :episodicMemoryTtl
-
         # @!attribute model_config
         #   ModelConfig defines the model configuration for a variation
         #
@@ -86,7 +69,7 @@ module Cadenya
         #   @return [Integer, nil]
         optional :weight, Integer
 
-        # @!method initialize(compaction_config: nil, constraints: nil, description: nil, enable_episodic_memory: nil, episodic_memory_ttl: nil, model_config: nil, progressive_discovery: nil, system_prompt_template: nil, user_message_template: nil, weight: nil)
+        # @!method initialize(compaction_config: nil, constraints: nil, description: nil, model_config: nil, progressive_discovery: nil, system_prompt_template: nil, user_message_template: nil, weight: nil)
         #   Some parameter documentations has been truncated, see
         #   {Cadenya::Models::Agents::AgentVariationSpec} for more details.
         #
@@ -98,10 +81,6 @@ module Cadenya
         #
         #   @param description [String] Human-readable description of what this variation does or when it should be used
         #
-        #   @param enable_episodic_memory [Boolean] Enable episodic memory for objectives using this variation.
-        #
-        #   @param episodic_memory_ttl [Integer] How long episodic memories should be retained.
-        #
         #   @param model_config [Cadenya::Models::Agents::AgentVariationSpecModelConfig] ModelConfig defines the model configuration for a variation
         #
         #   @param progressive_discovery [Cadenya::Models::Agents::AgentVariationSpecProgressiveDiscovery] ProgressiveDiscovery is used to indicate that the agent should automatically dis

data/lib/cadenya/models/memory_layer_list_params.rb

@@ -12,6 +12,12 @@ module Cadenya
       #   @return [String]
       required :workspace_id, String
 
+      # @!attribute agent_id
+      #   Filter to episodic layers belonging to this agent.
+      #
+      #   @return [String, nil]
+      optional :agent_id, String
+
       # @!attribute bundle_key
       #   Filter by bundle_key — return only resources owned by this bundle.
       #
@@ -24,6 +30,14 @@ module Cadenya
       #   @return [String, nil]
       optional :cursor, String
 
+      # @!attribute episodic_key_prefix
+      #   Filter to episodic layers whose episodic key starts with this prefix (e.g.
+      #   "customer/" matches "customer/42" and "customer/43"). Useful for namespaced
+      #   keys, similar to a redis key scan.
+      #
+      #   @return [String, nil]
+      optional :episodic_key_prefix, String
+
       # @!attribute include_info
       #   When set to true you may use more of your alloted API rate-limit
       #
@@ -60,13 +74,20 @@ module Cadenya
       #   @return [Symbol, Cadenya::Models::MemoryLayerListParams::Type, nil]
       optional :type, enum: -> { Cadenya::MemoryLayerListParams::Type }
 
-      # @!method initialize(workspace_id:, bundle_key: nil, cursor: nil, include_info: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, type: nil, request_options: {})
+      # @!method initialize(workspace_id:, agent_id: nil, bundle_key: nil, cursor: nil, episodic_key_prefix: nil, include_info: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, type: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::MemoryLayerListParams} for more details.
+      #
       #   @param workspace_id [String]
       #
+      #   @param agent_id [String] Filter to episodic layers belonging to this agent.
+      #
       #   @param bundle_key [String] Filter by bundle_key — return only resources owned by this bundle.
       #
       #   @param cursor [String] Pagination cursor from previous response
       #
+      #   @param episodic_key_prefix [String] Filter to episodic layers whose episodic key starts with this prefix
+      #
       #   @param include_info [Boolean] When set to true you may use more of your alloted API rate-limit
       #
       #   @param limit [Integer] Maximum number of results to return

data/lib/cadenya/models/memory_layer_spec.rb

@@ -16,6 +16,20 @@ module Cadenya
       optional :description, String
 
       response_only do
+        # @!attribute agent_id
+        #   Server-set on episodic layers: the agent this layer belongs to. Unset for
+        #   non-episodic layers.
+        #
+        #   @return [String, nil]
+        optional :agent_id, String, api_name: :agentId
+
+        # @!attribute episodic_key
+        #   Server-set on episodic layers: the caller-supplied episodic key the layer was
+        #   created for. Unset for non-episodic layers.
+        #
+        #   @return [String, nil]
+        optional :episodic_key, String, api_name: :episodicKey
+
         # @!attribute expires_at
         #   For layers with a finite lifetime (e.g., episodic), the time at which the layer
         #   becomes eligible for cleanup. Set by the system; unset for persistent layers.
@@ -33,14 +47,18 @@ module Cadenya
         optional :system_managed, Cadenya::Internal::Type::Boolean, api_name: :systemManaged
       end
 
-      # @!method initialize(type:, description: nil, expires_at: nil, system_managed: nil)
+      # @!method initialize(type:, agent_id: nil, description: nil, episodic_key: nil, expires_at: nil, system_managed: nil)
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::MemoryLayerSpec} for more details.
       #
       #   @param type [Symbol, Cadenya::Models::MemoryLayerSpec::Type]
       #
+      #   @param agent_id [String] Server-set on episodic layers: the agent this layer belongs to. Unset for
+      #
       #   @param description [String] Human-readable description of the layer's purpose. Encouraged for
       #
+      #   @param episodic_key [String] Server-set on episodic layers: the caller-supplied episodic key the layer
+      #
       #   @param expires_at [Time] For layers with a finite lifetime (e.g., episodic), the time at which the
       #
       #   @param system_managed [Boolean] Server-set. True for layers managed by the system (e.g., episodic layers

data/lib/cadenya/models/objective.rb

@@ -18,6 +18,12 @@ module Cadenya
       #   @return [Cadenya::Models::OperationMetadata]
       required :metadata, -> { Cadenya::OperationMetadata }
 
+      # @!attribute episodic_memory
+      #   Episodic is used to configure the episodic memory for the objective
+      #
+      #   @return [Cadenya::Models::Objective::EpisodicMemory, nil]
+      optional :episodic_memory, -> { Cadenya::Objective::EpisodicMemory }, api_name: :episodicMemory
+
       # @!attribute memory_stack
       #   Memory layers/entries to push onto this objective's memory stack on top of the
       #   baseline stack inherited from the selected variation.
@@ -110,7 +116,7 @@ module Cadenya
                  api_name: :userData
       end
 
-      # @!method initialize(config_snapshot:, initial_message:, metadata:, state:, system_prompt:, data: nil, info: nil, memory_stack: nil, output: nil, parent_objective_id: nil, secrets: nil, state_message: nil, user_data: nil)
+      # @!method initialize(config_snapshot:, initial_message:, metadata:, state:, system_prompt:, data: nil, episodic_memory: nil, info: nil, memory_stack: nil, output: nil, parent_objective_id: nil, secrets: nil, state_message: nil, user_data: nil)
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::Objective} for more details.
       #
@@ -130,6 +136,8 @@ module Cadenya
       #
       #   @param data [Hash{Symbol=>Object}] Arbitrary data for the objective
       #
+      #   @param episodic_memory [Cadenya::Models::Objective::EpisodicMemory] Episodic is used to configure the episodic memory for the objective
+      #
       #   @param info [Cadenya::Models::ObjectiveInfo] ObjectiveInfo provides read-only aggregated statistics about an objective's exec
       #
       #   @param memory_stack [Array<Cadenya::Models::MemoryReference>] Memory layers/entries to push onto this objective's memory stack on
@@ -161,6 +169,35 @@ module Cadenya
         # @!method self.values
         #   @return [Array<Symbol>]
       end
+
+      # @see Cadenya::Models::Objective#episodic_memory
+      class EpisodicMemory < Cadenya::Internal::Type::BaseModel
+        # @!attribute key
+        #   The caller-supplied episodic key. Objectives created with the same key (for the
+        #   same agent) share one episodic memory layer.
+        #
+        #   @return [String, nil]
+        optional :key, String
+
+        response_only do
+          # @!attribute memory_layer_id
+          #   The episodic memory layer resolved (created or reused) for this objective's key.
+          #   Populated by the system at objective creation.
+          #
+          #   @return [String, nil]
+          optional :memory_layer_id, String, api_name: :memoryLayerId
+        end
+
+        # @!method initialize(key: nil, memory_layer_id: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::Objective::EpisodicMemory} for more details.
+        #
+        #   Episodic is used to configure the episodic memory for the objective
+        #
+        #   @param key [String] The caller-supplied episodic key. Objectives created with the same key
+        #
+        #   @param memory_layer_id [String] The episodic memory layer resolved (created or reused) for this
+      end
     end
   end
 end

data/lib/cadenya/models/objective_create_params.rb

@@ -24,6 +24,14 @@ module Cadenya
       #   @return [Hash{Symbol=>Object}]
       required :data, Cadenya::Internal::Type::HashOf[Cadenya::Internal::Type::Unknown]
 
+      # @!attribute episodic_memory
+      #   Episodic is used to configure the episodic memory for the objective
+      #
+      #   @return [Cadenya::Models::ObjectiveCreateParams::EpisodicMemory, nil]
+      optional :episodic_memory,
+               -> { Cadenya::ObjectiveCreateParams::EpisodicMemory },
+               api_name: :episodicMemory
+
       # @!attribute initial_message
       #   Optional override for the initial message sent to the agent. This becomes the
       #   first user message in the LLM chat history. When not set, the selected
@@ -88,7 +96,7 @@ module Cadenya
       #   @return [String, nil]
       optional :variation_id, String, api_name: :variationId
 
-      # @!method initialize(workspace_id:, agent_id:, data:, initial_message: nil, memory_stack: nil, metadata: nil, secrets: nil, user_data: nil, variation_id: nil, request_options: {})
+      # @!method initialize(workspace_id:, agent_id:, data:, episodic_memory: nil, initial_message: nil, memory_stack: nil, metadata: nil, secrets: nil, user_data: nil, variation_id: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::ObjectiveCreateParams} for more details.
       #
@@ -98,6 +106,8 @@ module Cadenya
       #
       #   @param data [Hash{Symbol=>Object}] Arbitrary data for the objective. May be used in liquid templates for prompts co
       #
+      #   @param episodic_memory [Cadenya::Models::ObjectiveCreateParams::EpisodicMemory] Episodic is used to configure the episodic memory for the objective
+      #
       #   @param initial_message [String] Optional override for the initial message sent to the agent. This becomes the fi
       #
       #   @param memory_stack [Array<Cadenya::Models::MemoryReference>] Memory layers/entries to push onto this objective's memory stack on
@@ -112,6 +122,23 @@ module Cadenya
       #
       #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
 
+      class EpisodicMemory < Cadenya::Internal::Type::BaseModel
+        # @!attribute key
+        #   The caller-supplied episodic key. Objectives created with the same key (for the
+        #   same agent) share one episodic memory layer.
+        #
+        #   @return [String, nil]
+        optional :key, String
+
+        # @!method initialize(key: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::ObjectiveCreateParams::EpisodicMemory} for more details.
+        #
+        #   Episodic is used to configure the episodic memory for the objective
+        #
+        #   @param key [String] The caller-supplied episodic key. Objectives created with the same key
+      end
+
       class Secret < Cadenya::Internal::Type::BaseModel
         # @!attribute name
         #

data/lib/cadenya/resources/memory_layers.rb

@@ -108,16 +108,23 @@ module Cadenya
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Cadenya::Models::MemoryLayerListParams} for more details.
+      #
       # Lists all memory layers in the workspace
       #
-      # @overload list(workspace_id, bundle_key: nil, cursor: nil, include_info: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, type: nil, request_options: {})
+      # @overload list(workspace_id, agent_id: nil, bundle_key: nil, cursor: nil, episodic_key_prefix: nil, include_info: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, type: nil, request_options: {})
       #
       # @param workspace_id [String]
       #
+      # @param agent_id [String] Filter to episodic layers belonging to this agent.
+      #
       # @param bundle_key [String] Filter by bundle_key — return only resources owned by this bundle.
       #
       # @param cursor [String] Pagination cursor from previous response
       #
+      # @param episodic_key_prefix [String] Filter to episodic layers whose episodic key starts with this prefix
+      #
       # @param include_info [Boolean] When set to true you may use more of your alloted API rate-limit
       #
       # @param limit [Integer] Maximum number of results to return
@@ -142,7 +149,9 @@ module Cadenya
           method: :get,
           path: ["v1/workspaces/%1$s/memory_layers", workspace_id],
           query: query.transform_keys(
+            agent_id: "agentId",
             bundle_key: "bundleKey",
+            episodic_key_prefix: "episodicKeyPrefix",
             include_info: "includeInfo",
             sort_order: "sortOrder"
           ),

data/lib/cadenya/resources/objectives.rb

@@ -20,7 +20,7 @@ module Cadenya
       #
       # Creates a new objective in the workspace
       #
-      # @overload create(workspace_id, agent_id:, data:, initial_message: nil, memory_stack: nil, metadata: nil, secrets: nil, user_data: nil, variation_id: nil, request_options: {})
+      # @overload create(workspace_id, agent_id:, data:, episodic_memory: nil, initial_message: nil, memory_stack: nil, metadata: nil, secrets: nil, user_data: nil, variation_id: nil, request_options: {})
       #
       # @param workspace_id [String]
       #
@@ -28,6 +28,8 @@ module Cadenya
       #
       # @param data [Hash{Symbol=>Object}] Arbitrary data for the objective. May be used in liquid templates for prompts co
       #
+      # @param episodic_memory [Cadenya::Models::ObjectiveCreateParams::EpisodicMemory] Episodic is used to configure the episodic memory for the objective
+      #
       # @param initial_message [String] Optional override for the initial message sent to the agent. This becomes the fi
       #
       # @param memory_stack [Array<Cadenya::Models::MemoryReference>] Memory layers/entries to push onto this objective's memory stack on

data/lib/cadenya/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Cadenya
-  VERSION = "0.12.0"
+  VERSION = "0.13.0"
 end

data/rbi/cadenya/models/agent_spec.rbi

@@ -18,6 +18,26 @@ module Cadenya
       sig { params(description: String).void }
       attr_writer :description
 
+      # Enable episodic memory for objectives created for this agent. When true,
+      # objective creation requires an episodic_memory key and the system finds or
+      # creates a memory layer for that (agent, key) pair, letting the agent store and
+      # retrieve memories across objectives that share the key. Memory is agent-level so
+      # all variations of the agent share the same layers.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :enable_episodic_memory
+
+      sig { params(enable_episodic_memory: T::Boolean).void }
+      attr_writer :enable_episodic_memory
+
+      # How long episodic memories should be retained. Each new objective slides the
+      # layer's expiry forward by this duration, and stored entries expire this long
+      # after they are written. If not set, episodic memories are retained indefinitely.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :episodic_memory_ttl
+
+      sig { params(episodic_memory_ttl: Integer).void }
+      attr_writer :episodic_memory_ttl
+
       # InputDataSchema is used for enforcing a data input when objectives are created.
       # This is valuable when using liquid formatting in agent variation prompts. Input
       # data schema is also valuable when using an agent as a sub-agent, as the schema
@@ -52,6 +72,8 @@ module Cadenya
           variation_selection_mode:
             Cadenya::AgentSpec::VariationSelectionMode::OrSymbol,
           description: String,
+          enable_episodic_memory: T::Boolean,
+          episodic_memory_ttl: Integer,
           input_data_schema: T::Hash[Symbol, T.anything],
           output_definition: T::Hash[Symbol, T.anything],
           webhook_events_url: String
@@ -63,6 +85,16 @@ module Cadenya
         variation_selection_mode:,
         # Description of the agent's purpose
         description: nil,
+        # Enable episodic memory for objectives created for this agent. When true,
+        # objective creation requires an episodic_memory key and the system finds or
+        # creates a memory layer for that (agent, key) pair, letting the agent store and
+        # retrieve memories across objectives that share the key. Memory is agent-level so
+        # all variations of the agent share the same layers.
+        enable_episodic_memory: nil,
+        # How long episodic memories should be retained. Each new objective slides the
+        # layer's expiry forward by this duration, and stored entries expire this long
+        # after they are written. If not set, episodic memories are retained indefinitely.
+        episodic_memory_ttl: nil,
         # InputDataSchema is used for enforcing a data input when objectives are created.
         # This is valuable when using liquid formatting in agent variation prompts. Input
         # data schema is also valuable when using an agent as a sub-agent, as the schema
@@ -85,6 +117,8 @@ module Cadenya
             variation_selection_mode:
               Cadenya::AgentSpec::VariationSelectionMode::OrSymbol,
             description: String,
+            enable_episodic_memory: T::Boolean,
+            episodic_memory_ttl: Integer,
             input_data_schema: T::Hash[Symbol, T.anything],
             output_definition: T::Hash[Symbol, T.anything],
             webhook_events_url: String

data/rbi/cadenya/models/agents/agent_variation_spec.rbi

@@ -51,25 +51,6 @@ module Cadenya
         sig { params(description: String).void }
         attr_writer :description
 
-        # Enable episodic memory for objectives using this variation. When true, the
-        # system automatically creates a document namespace for each objective using the
-        # objective's episodic_key as the external_id, allowing the agent to store and
-        # retrieve documents specific to that episode.
-        sig { returns(T.nilable(T::Boolean)) }
-        attr_reader :enable_episodic_memory
-
-        sig { params(enable_episodic_memory: T::Boolean).void }
-        attr_writer :enable_episodic_memory
-
-        # How long episodic memories should be retained. After this duration, episodic
-        # document namespaces can be automatically cleaned up. If not set, episodic
-        # memories are retained indefinitely.
-        sig { returns(T.nilable(Integer)) }
-        attr_reader :episodic_memory_ttl
-
-        sig { params(episodic_memory_ttl: Integer).void }
-        attr_writer :episodic_memory_ttl
-
         # ModelConfig defines the model configuration for a variation
         sig do
           returns(T.nilable(Cadenya::Agents::AgentVariationSpecModelConfig))
@@ -139,8 +120,6 @@ module Cadenya
               Cadenya::Agents::AgentVariationSpecCompactionConfig::OrHash,
             constraints: Cadenya::Agents::AgentVariationSpecConstraints::OrHash,
             description: String,
-            enable_episodic_memory: T::Boolean,
-            episodic_memory_ttl: Integer,
             model_config:
               Cadenya::Agents::AgentVariationSpecModelConfig::OrHash,
             progressive_discovery:
@@ -158,15 +137,6 @@ module Cadenya
           constraints: nil,
           # Human-readable description of what this variation does or when it should be used
           description: nil,
-          # Enable episodic memory for objectives using this variation. When true, the
-          # system automatically creates a document namespace for each objective using the
-          # objective's episodic_key as the external_id, allowing the agent to store and
-          # retrieve documents specific to that episode.
-          enable_episodic_memory: nil,
-          # How long episodic memories should be retained. After this duration, episodic
-          # document namespaces can be automatically cleaned up. If not set, episodic
-          # memories are retained indefinitely.
-          episodic_memory_ttl: nil,
           # ModelConfig defines the model configuration for a variation
           model_config: nil,
           # ProgressiveDiscovery is used to indicate that the agent should automatically
@@ -199,8 +169,6 @@ module Cadenya
                 Cadenya::Agents::AgentVariationSpecCompactionConfig,
               constraints: Cadenya::Agents::AgentVariationSpecConstraints,
               description: String,
-              enable_episodic_memory: T::Boolean,
-              episodic_memory_ttl: Integer,
               model_config: Cadenya::Agents::AgentVariationSpecModelConfig,
               progressive_discovery:
                 Cadenya::Agents::AgentVariationSpecProgressiveDiscovery,

data/rbi/cadenya/models/memory_layer_list_params.rbi

@@ -14,6 +14,13 @@ module Cadenya
       sig { returns(String) }
       attr_accessor :workspace_id
 
+      # Filter to episodic layers belonging to this agent.
+      sig { returns(T.nilable(String)) }
+      attr_reader :agent_id
+
+      sig { params(agent_id: String).void }
+      attr_writer :agent_id
+
       # Filter by bundle_key — return only resources owned by this bundle.
       sig { returns(T.nilable(String)) }
       attr_reader :bundle_key
@@ -28,6 +35,15 @@ module Cadenya
       sig { params(cursor: String).void }
       attr_writer :cursor
 
+      # Filter to episodic layers whose episodic key starts with this prefix (e.g.
+      # "customer/" matches "customer/42" and "customer/43"). Useful for namespaced
+      # keys, similar to a redis key scan.
+      sig { returns(T.nilable(String)) }
+      attr_reader :episodic_key_prefix
+
+      sig { params(episodic_key_prefix: String).void }
+      attr_writer :episodic_key_prefix
+
       # When set to true you may use more of your alloted API rate-limit
       sig { returns(T.nilable(T::Boolean)) }
       attr_reader :include_info
@@ -73,8 +89,10 @@ module Cadenya
       sig do
         params(
           workspace_id: String,
+          agent_id: String,
           bundle_key: String,
           cursor: String,
+          episodic_key_prefix: String,
           include_info: T::Boolean,
           limit: Integer,
           prefix: String,
@@ -86,10 +104,16 @@ module Cadenya
       end
       def self.new(
         workspace_id:,
+        # Filter to episodic layers belonging to this agent.
+        agent_id: nil,
         # Filter by bundle_key — return only resources owned by this bundle.
         bundle_key: nil,
         # Pagination cursor from previous response
         cursor: nil,
+        # Filter to episodic layers whose episodic key starts with this prefix (e.g.
+        # "customer/" matches "customer/42" and "customer/43"). Useful for namespaced
+        # keys, similar to a redis key scan.
+        episodic_key_prefix: nil,
         # When set to true you may use more of your alloted API rate-limit
         include_info: nil,
         # Maximum number of results to return
@@ -110,8 +134,10 @@ module Cadenya
         override.returns(
           {
             workspace_id: String,
+            agent_id: String,
             bundle_key: String,
             cursor: String,
+            episodic_key_prefix: String,
             include_info: T::Boolean,
             limit: Integer,
             prefix: String,

data/rbi/cadenya/models/memory_layer_spec.rbi

@@ -19,6 +19,22 @@ module Cadenya
       sig { params(description: String).void }
       attr_writer :description
 
+      # Server-set on episodic layers: the agent this layer belongs to. Unset for
+      # non-episodic layers.
+      sig { returns(T.nilable(String)) }
+      attr_reader :agent_id
+
+      sig { params(agent_id: String).void }
+      attr_writer :agent_id
+
+      # Server-set on episodic layers: the caller-supplied episodic key the layer was
+      # created for. Unset for non-episodic layers.
+      sig { returns(T.nilable(String)) }
+      attr_reader :episodic_key
+
+      sig { params(episodic_key: String).void }
+      attr_writer :episodic_key
+
       # For layers with a finite lifetime (e.g., episodic), the time at which the layer
       # becomes eligible for cleanup. Set by the system; unset for persistent layers.
       sig { returns(T.nilable(Time)) }
@@ -40,16 +56,24 @@ module Cadenya
       sig do
         params(
           type: Cadenya::MemoryLayerSpec::Type::OrSymbol,
+          agent_id: String,
           description: String,
+          episodic_key: String,
           expires_at: Time,
           system_managed: T::Boolean
         ).returns(T.attached_class)
       end
       def self.new(
         type:,
+        # Server-set on episodic layers: the agent this layer belongs to. Unset for
+        # non-episodic layers.
+        agent_id: nil,
         # Human-readable description of the layer's purpose. Encouraged for user-created
         # layers; system-managed layers may have a generated description.
         description: nil,
+        # Server-set on episodic layers: the caller-supplied episodic key the layer was
+        # created for. Unset for non-episodic layers.
+        episodic_key: nil,
         # For layers with a finite lifetime (e.g., episodic), the time at which the layer
         # becomes eligible for cleanup. Set by the system; unset for persistent layers.
         expires_at: nil,
@@ -65,7 +89,9 @@ module Cadenya
         override.returns(
           {
             type: Cadenya::MemoryLayerSpec::Type::OrSymbol,
+            agent_id: String,
             description: String,
+            episodic_key: String,
             expires_at: Time,
             system_managed: T::Boolean
           }

data/rbi/cadenya/models/objective.rbi

@@ -19,6 +19,15 @@ module Cadenya
       sig { params(metadata: Cadenya::OperationMetadata::OrHash).void }
       attr_writer :metadata
 
+      # Episodic is used to configure the episodic memory for the objective
+      sig { returns(T.nilable(Cadenya::Objective::EpisodicMemory)) }
+      attr_reader :episodic_memory
+
+      sig do
+        params(episodic_memory: Cadenya::Objective::EpisodicMemory::OrHash).void
+      end
+      attr_writer :episodic_memory
+
       # Memory layers/entries to push onto this objective's memory stack on top of the
       # baseline stack inherited from the selected variation.
       #
@@ -125,6 +134,7 @@ module Cadenya
           state: Cadenya::Objective::State::OrSymbol,
           system_prompt: String,
           data: T::Hash[Symbol, T.anything],
+          episodic_memory: Cadenya::Objective::EpisodicMemory::OrHash,
           info: Cadenya::ObjectiveInfo::OrHash,
           memory_stack: T::Array[Cadenya::MemoryReference::OrHash],
           output: T::Hash[Symbol, T.anything],
@@ -150,6 +160,8 @@ module Cadenya
         system_prompt:,
         # Arbitrary data for the objective
         data: nil,
+        # Episodic is used to configure the episodic memory for the objective
+        episodic_memory: nil,
         # ObjectiveInfo provides read-only aggregated statistics about an objective's
         # execution
         info: nil,
@@ -195,6 +207,7 @@ module Cadenya
             state: Cadenya::Objective::State::TaggedSymbol,
             system_prompt: String,
             data: T::Hash[Symbol, T.anything],
+            episodic_memory: Cadenya::Objective::EpisodicMemory,
             info: Cadenya::ObjectiveInfo,
             memory_stack: T::Array[Cadenya::MemoryReference],
             output: T::Hash[Symbol, T.anything],
@@ -236,6 +249,50 @@ module Cadenya
         def self.values
         end
       end
+
+      class EpisodicMemory < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::Objective::EpisodicMemory,
+              Cadenya::Internal::AnyHash
+            )
+          end
+
+        # The caller-supplied episodic key. Objectives created with the same key (for the
+        # same agent) share one episodic memory layer.
+        sig { returns(T.nilable(String)) }
+        attr_reader :key
+
+        sig { params(key: String).void }
+        attr_writer :key
+
+        # The episodic memory layer resolved (created or reused) for this objective's key.
+        # Populated by the system at objective creation.
+        sig { returns(T.nilable(String)) }
+        attr_reader :memory_layer_id
+
+        sig { params(memory_layer_id: String).void }
+        attr_writer :memory_layer_id
+
+        # Episodic is used to configure the episodic memory for the objective
+        sig do
+          params(key: String, memory_layer_id: String).returns(T.attached_class)
+        end
+        def self.new(
+          # The caller-supplied episodic key. Objectives created with the same key (for the
+          # same agent) share one episodic memory layer.
+          key: nil,
+          # The episodic memory layer resolved (created or reused) for this objective's key.
+          # Populated by the system at objective creation.
+          memory_layer_id: nil
+        )
+        end
+
+        sig { override.returns({ key: String, memory_layer_id: String }) }
+        def to_hash
+        end
+      end
     end
   end
 end

data/rbi/cadenya/models/objective_create_params.rbi

@@ -22,6 +22,18 @@ module Cadenya
       sig { returns(T::Hash[Symbol, T.anything]) }
       attr_accessor :data
 
+      # Episodic is used to configure the episodic memory for the objective
+      sig { returns(T.nilable(Cadenya::ObjectiveCreateParams::EpisodicMemory)) }
+      attr_reader :episodic_memory
+
+      sig do
+        params(
+          episodic_memory:
+            Cadenya::ObjectiveCreateParams::EpisodicMemory::OrHash
+        ).void
+      end
+      attr_writer :episodic_memory
+
       # Optional override for the initial message sent to the agent. This becomes the
       # first user message in the LLM chat history. When not set, the selected
       # variation's user_message_template is rendered with user_data instead. If neither
@@ -101,6 +113,8 @@ module Cadenya
           workspace_id: String,
           agent_id: String,
           data: T::Hash[Symbol, T.anything],
+          episodic_memory:
+            Cadenya::ObjectiveCreateParams::EpisodicMemory::OrHash,
           initial_message: String,
           memory_stack: T::Array[Cadenya::MemoryReference::OrHash],
           metadata: Cadenya::CreateOperationMetadata::OrHash,
@@ -116,6 +130,8 @@ module Cadenya
         # Arbitrary data for the objective. May be used in liquid templates for prompts
         # configured on the agent variation
         data:,
+        # Episodic is used to configure the episodic memory for the objective
+        episodic_memory: nil,
         # Optional override for the initial message sent to the agent. This becomes the
         # first user message in the LLM chat history. When not set, the selected
         # variation's user_message_template is rendered with user_data instead. If neither
@@ -162,6 +178,7 @@ module Cadenya
             workspace_id: String,
             agent_id: String,
             data: T::Hash[Symbol, T.anything],
+            episodic_memory: Cadenya::ObjectiveCreateParams::EpisodicMemory,
             initial_message: String,
             memory_stack: T::Array[Cadenya::MemoryReference],
             metadata: Cadenya::CreateOperationMetadata,
@@ -175,6 +192,37 @@ module Cadenya
       def to_hash
       end
 
+      class EpisodicMemory < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::ObjectiveCreateParams::EpisodicMemory,
+              Cadenya::Internal::AnyHash
+            )
+          end
+
+        # The caller-supplied episodic key. Objectives created with the same key (for the
+        # same agent) share one episodic memory layer.
+        sig { returns(T.nilable(String)) }
+        attr_reader :key
+
+        sig { params(key: String).void }
+        attr_writer :key
+
+        # Episodic is used to configure the episodic memory for the objective
+        sig { params(key: String).returns(T.attached_class) }
+        def self.new(
+          # The caller-supplied episodic key. Objectives created with the same key (for the
+          # same agent) share one episodic memory layer.
+          key: nil
+        )
+        end
+
+        sig { override.returns({ key: String, memory_layer_id: String }) }
+        def to_hash
+        end
+      end
+
       class Secret < Cadenya::Internal::Type::BaseModel
         OrHash =
           T.type_alias do

data/rbi/cadenya/resources/memory_layers.rbi

@@ -84,8 +84,10 @@ module Cadenya
       sig do
         params(
           workspace_id: String,
+          agent_id: String,
           bundle_key: String,
           cursor: String,
+          episodic_key_prefix: String,
           include_info: T::Boolean,
           limit: Integer,
           prefix: String,
@@ -97,10 +99,16 @@ module Cadenya
       end
       def list(
         workspace_id,
+        # Filter to episodic layers belonging to this agent.
+        agent_id: nil,
         # Filter by bundle_key — return only resources owned by this bundle.
         bundle_key: nil,
         # Pagination cursor from previous response
         cursor: nil,
+        # Filter to episodic layers whose episodic key starts with this prefix (e.g.
+        # "customer/" matches "customer/42" and "customer/43"). Useful for namespaced
+        # keys, similar to a redis key scan.
+        episodic_key_prefix: nil,
         # When set to true you may use more of your alloted API rate-limit
         include_info: nil,
         # Maximum number of results to return

data/rbi/cadenya/resources/objectives.rbi

@@ -21,6 +21,8 @@ module Cadenya
           workspace_id: String,
           agent_id: String,
           data: T::Hash[Symbol, T.anything],
+          episodic_memory:
+            Cadenya::ObjectiveCreateParams::EpisodicMemory::OrHash,
           initial_message: String,
           memory_stack: T::Array[Cadenya::MemoryReference::OrHash],
           metadata: Cadenya::CreateOperationMetadata::OrHash,
@@ -36,6 +38,8 @@ module Cadenya
         # Arbitrary data for the objective. May be used in liquid templates for prompts
         # configured on the agent variation
         data:,
+        # Episodic is used to configure the episodic memory for the objective
+        episodic_memory: nil,
         # Optional override for the initial message sent to the agent. This becomes the
         # first user message in the LLM chat history. When not set, the selected
         # variation's user_message_template is rendered with user_data instead. If neither

data/sig/cadenya/models/agent_spec.rbs

@@ -4,6 +4,8 @@ module Cadenya
       {
         variation_selection_mode: Cadenya::Models::AgentSpec::variation_selection_mode,
         description: String,
+        enable_episodic_memory: bool,
+        episodic_memory_ttl: Integer,
         input_data_schema: ::Hash[Symbol, top],
         output_definition: ::Hash[Symbol, top],
         webhook_events_url: String
@@ -16,6 +18,14 @@ module Cadenya
 
       def description=: (String) -> String
 
+      attr_reader enable_episodic_memory: bool?
+
+      def enable_episodic_memory=: (bool) -> bool
+
+      attr_reader episodic_memory_ttl: Integer?
+
+      def episodic_memory_ttl=: (Integer) -> Integer
+
       attr_reader input_data_schema: ::Hash[Symbol, top]?
 
       def input_data_schema=: (::Hash[Symbol, top]) -> ::Hash[Symbol, top]
@@ -31,6 +41,8 @@ module Cadenya
       def initialize: (
         variation_selection_mode: Cadenya::Models::AgentSpec::variation_selection_mode,
         ?description: String,
+        ?enable_episodic_memory: bool,
+        ?episodic_memory_ttl: Integer,
         ?input_data_schema: ::Hash[Symbol, top],
         ?output_definition: ::Hash[Symbol, top],
         ?webhook_events_url: String
@@ -39,6 +51,8 @@ module Cadenya
       def to_hash: -> {
         variation_selection_mode: Cadenya::Models::AgentSpec::variation_selection_mode,
         description: String,
+        enable_episodic_memory: bool,
+        episodic_memory_ttl: Integer,
         input_data_schema: ::Hash[Symbol, top],
         output_definition: ::Hash[Symbol, top],
         webhook_events_url: String

data/sig/cadenya/models/agents/agent_variation_spec.rbs

@@ -8,8 +8,6 @@ module Cadenya
           compaction_config: Cadenya::Agents::AgentVariationSpecCompactionConfig,
           constraints: Cadenya::Agents::AgentVariationSpecConstraints,
           description: String,
-          enable_episodic_memory: bool,
-          episodic_memory_ttl: Integer,
           model_config: Cadenya::Agents::AgentVariationSpecModelConfig,
           progressive_discovery: Cadenya::Agents::AgentVariationSpecProgressiveDiscovery,
           system_prompt_template: String,
@@ -34,14 +32,6 @@ module Cadenya
 
         def description=: (String) -> String
 
-        attr_reader enable_episodic_memory: bool?
-
-        def enable_episodic_memory=: (bool) -> bool
-
-        attr_reader episodic_memory_ttl: Integer?
-
-        def episodic_memory_ttl=: (Integer) -> Integer
-
         attr_reader model_config: Cadenya::Agents::AgentVariationSpecModelConfig?
 
         def model_config=: (
@@ -70,8 +60,6 @@ module Cadenya
           ?compaction_config: Cadenya::Agents::AgentVariationSpecCompactionConfig,
           ?constraints: Cadenya::Agents::AgentVariationSpecConstraints,
           ?description: String,
-          ?enable_episodic_memory: bool,
-          ?episodic_memory_ttl: Integer,
           ?model_config: Cadenya::Agents::AgentVariationSpecModelConfig,
           ?progressive_discovery: Cadenya::Agents::AgentVariationSpecProgressiveDiscovery,
           ?system_prompt_template: String,
@@ -83,8 +71,6 @@ module Cadenya
           compaction_config: Cadenya::Agents::AgentVariationSpecCompactionConfig,
           constraints: Cadenya::Agents::AgentVariationSpecConstraints,
           description: String,
-          enable_episodic_memory: bool,
-          episodic_memory_ttl: Integer,
           model_config: Cadenya::Agents::AgentVariationSpecModelConfig,
           progressive_discovery: Cadenya::Agents::AgentVariationSpecProgressiveDiscovery,
           system_prompt_template: String,

data/sig/cadenya/models/memory_layer_list_params.rbs

@@ -3,8 +3,10 @@ module Cadenya
     type memory_layer_list_params =
       {
         workspace_id: String,
+        agent_id: String,
         bundle_key: String,
         cursor: String,
+        episodic_key_prefix: String,
         include_info: bool,
         limit: Integer,
         prefix: String,
@@ -20,6 +22,10 @@ module Cadenya
 
       attr_accessor workspace_id: String
 
+      attr_reader agent_id: String?
+
+      def agent_id=: (String) -> String
+
       attr_reader bundle_key: String?
 
       def bundle_key=: (String) -> String
@@ -28,6 +34,10 @@ module Cadenya
 
       def cursor=: (String) -> String
 
+      attr_reader episodic_key_prefix: String?
+
+      def episodic_key_prefix=: (String) -> String
+
       attr_reader include_info: bool?
 
       def include_info=: (bool) -> bool
@@ -56,8 +66,10 @@ module Cadenya
 
       def initialize: (
         workspace_id: String,
+        ?agent_id: String,
         ?bundle_key: String,
         ?cursor: String,
+        ?episodic_key_prefix: String,
         ?include_info: bool,
         ?limit: Integer,
         ?prefix: String,
@@ -69,8 +81,10 @@ module Cadenya
 
       def to_hash: -> {
         workspace_id: String,
+        agent_id: String,
         bundle_key: String,
         cursor: String,
+        episodic_key_prefix: String,
         include_info: bool,
         limit: Integer,
         prefix: String,

data/sig/cadenya/models/memory_layer_spec.rbs

@@ -3,7 +3,9 @@ module Cadenya
     type memory_layer_spec =
       {
         type: Cadenya::Models::MemoryLayerSpec::type_,
+        agent_id: String,
         description: String,
+        episodic_key: String,
         expires_at: Time,
         system_managed: bool
       }
@@ -15,6 +17,14 @@ module Cadenya
 
       def description=: (String) -> String
 
+      attr_reader agent_id: String?
+
+      def agent_id=: (String) -> String
+
+      attr_reader episodic_key: String?
+
+      def episodic_key=: (String) -> String
+
       attr_reader expires_at: Time?
 
       def expires_at=: (Time) -> Time
@@ -25,14 +35,18 @@ module Cadenya
 
       def initialize: (
         type: Cadenya::Models::MemoryLayerSpec::type_,
+        ?agent_id: String,
         ?description: String,
+        ?episodic_key: String,
         ?expires_at: Time,
         ?system_managed: bool
       ) -> void
 
       def to_hash: -> {
         type: Cadenya::Models::MemoryLayerSpec::type_,
+        agent_id: String,
         description: String,
+        episodic_key: String,
         expires_at: Time,
         system_managed: bool
       }

data/sig/cadenya/models/objective.rbs

@@ -8,6 +8,7 @@ module Cadenya
         state: Cadenya::Models::Objective::state,
         system_prompt: String,
         data: ::Hash[Symbol, top],
+        episodic_memory: Cadenya::Objective::EpisodicMemory,
         info: Cadenya::ObjectiveInfo,
         memory_stack: ::Array[Cadenya::MemoryReference],
         output: ::Hash[Symbol, top],
@@ -22,6 +23,12 @@ module Cadenya
 
       attr_accessor metadata: Cadenya::OperationMetadata
 
+      attr_reader episodic_memory: Cadenya::Objective::EpisodicMemory?
+
+      def episodic_memory=: (
+        Cadenya::Objective::EpisodicMemory
+      ) -> Cadenya::Objective::EpisodicMemory
+
       attr_reader memory_stack: ::Array[Cadenya::MemoryReference]?
 
       def memory_stack=: (
@@ -71,6 +78,7 @@ module Cadenya
         state: Cadenya::Models::Objective::state,
         system_prompt: String,
         ?data: ::Hash[Symbol, top],
+        ?episodic_memory: Cadenya::Objective::EpisodicMemory,
         ?info: Cadenya::ObjectiveInfo,
         ?memory_stack: ::Array[Cadenya::MemoryReference],
         ?output: ::Hash[Symbol, top],
@@ -87,6 +95,7 @@ module Cadenya
         state: Cadenya::Models::Objective::state,
         system_prompt: String,
         data: ::Hash[Symbol, top],
+        episodic_memory: Cadenya::Objective::EpisodicMemory,
         info: Cadenya::ObjectiveInfo,
         memory_stack: ::Array[Cadenya::MemoryReference],
         output: ::Hash[Symbol, top],
@@ -118,6 +127,22 @@ module Cadenya
 
         def self?.values: -> ::Array[Cadenya::Models::Objective::state]
       end
+
+      type episodic_memory = { key: String, memory_layer_id: String }
+
+      class EpisodicMemory < Cadenya::Internal::Type::BaseModel
+        attr_reader key: String?
+
+        def key=: (String) -> String
+
+        attr_reader memory_layer_id: String?
+
+        def memory_layer_id=: (String) -> String
+
+        def initialize: (?key: String, ?memory_layer_id: String) -> void
+
+        def to_hash: -> { key: String, memory_layer_id: String }
+      end
     end
   end
 end

data/sig/cadenya/models/objective_create_params.rbs

@@ -5,6 +5,7 @@ module Cadenya
         workspace_id: String,
         agent_id: String,
         data: ::Hash[Symbol, top],
+        episodic_memory: Cadenya::ObjectiveCreateParams::EpisodicMemory,
         initial_message: String,
         memory_stack: ::Array[Cadenya::MemoryReference],
         metadata: Cadenya::CreateOperationMetadata,
@@ -24,6 +25,12 @@ module Cadenya
 
       attr_accessor data: ::Hash[Symbol, top]
 
+      attr_reader episodic_memory: Cadenya::ObjectiveCreateParams::EpisodicMemory?
+
+      def episodic_memory=: (
+        Cadenya::ObjectiveCreateParams::EpisodicMemory
+      ) -> Cadenya::ObjectiveCreateParams::EpisodicMemory
+
       attr_reader initial_message: String?
 
       def initial_message=: (String) -> String
@@ -58,6 +65,7 @@ module Cadenya
         workspace_id: String,
         agent_id: String,
         data: ::Hash[Symbol, top],
+        ?episodic_memory: Cadenya::ObjectiveCreateParams::EpisodicMemory,
         ?initial_message: String,
         ?memory_stack: ::Array[Cadenya::MemoryReference],
         ?metadata: Cadenya::CreateOperationMetadata,
@@ -71,6 +79,7 @@ module Cadenya
         workspace_id: String,
         agent_id: String,
         data: ::Hash[Symbol, top],
+        episodic_memory: Cadenya::ObjectiveCreateParams::EpisodicMemory,
         initial_message: String,
         memory_stack: ::Array[Cadenya::MemoryReference],
         metadata: Cadenya::CreateOperationMetadata,
@@ -80,6 +89,18 @@ module Cadenya
         request_options: Cadenya::RequestOptions
       }
 
+      type episodic_memory = { key: String, memory_layer_id: String }
+
+      class EpisodicMemory < Cadenya::Internal::Type::BaseModel
+        attr_reader key: String?
+
+        def key=: (String) -> String
+
+        def initialize: (?key: String) -> void
+
+        def to_hash: -> { key: String, memory_layer_id: String }
+      end
+
       type secret = { name: String, value: String }
 
       class Secret < Cadenya::Internal::Type::BaseModel

data/sig/cadenya/resources/memory_layers.rbs

@@ -27,8 +27,10 @@ module Cadenya
 
       def list: (
         String workspace_id,
+        ?agent_id: String,
         ?bundle_key: String,
         ?cursor: String,
+        ?episodic_key_prefix: String,
         ?include_info: bool,
         ?limit: Integer,
         ?prefix: String,

data/sig/cadenya/resources/objectives.rbs

@@ -13,6 +13,7 @@ module Cadenya
         String workspace_id,
         agent_id: String,
         data: ::Hash[Symbol, top],
+        ?episodic_memory: Cadenya::ObjectiveCreateParams::EpisodicMemory,
         ?initial_message: String,
         ?memory_stack: ::Array[Cadenya::MemoryReference],
         ?metadata: Cadenya::CreateOperationMetadata,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cadenya
 version: !ruby/object:Gem::Version
-  version: 0.12.0
+  version: 0.13.0
 platform: ruby
 authors:
 - Cadenya
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-10 00:00:00.000000000 Z
+date: 2026-06-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi