@mastra/memory 1.41.0-alpha.1 → 1.41.0-alpha.2

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-memory
 description: Documentation for @mastra/memory. Use when working with @mastra/memory APIs, configuration, or implementation.
 metadata:
   package: "@mastra/memory"
-  version: "1.41.0-alpha.1"
+  version: "1.41.0-alpha.2"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,209 +1,209 @@
 {
-  "version": "1.41.0-alpha.1",
+  "version": "1.41.0-alpha.2",
   "package": "@mastra/memory",
   "exports": {
     "d": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "U": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "g": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "W": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "G": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "K": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "q": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "J": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "M": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "u": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "l": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "j": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "D": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "N": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "P": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "_": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "v": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "F": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "I": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "Y": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "c": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "L": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "B": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "R": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "V": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "y": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "z": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "b": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "x": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "f": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "H": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "S": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "A": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "C": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "w": {
       "types": "dist/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "t": {
       "types": "dist/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "n": {
       "types": "dist/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "k": {
       "types": "dist/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "r": {
       "types": "dist/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "T": {
       "types": "dist/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "E": {
       "types": "dist/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "p": {
       "types": "dist/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "m": {
       "types": "dist/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "i": {
       "types": "dist/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "h": {
       "types": "dist/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "O": {
       "types": "dist/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "a": {
       "types": "dist/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "o": {
       "types": "dist/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     },
     "s": {
       "types": "dist/index.d.ts",
-      "implementation": "dist/src-CBYx0iwC.js"
+      "implementation": "dist/src-Det56QOD.js"
     }
   },
   "modules": {
     "processors": {
       "index": "dist/processors/index.js",
       "chunks": [
-        "src-CBYx0iwC.js"
+        "src-Det56QOD.js"
       ]
     }
   }

package/dist/docs/references/docs-harness-background-tasks.md

@@ -6,7 +6,7 @@
 
 **Added in:** `@mastra/core@1.29.0`
 
-Background tasks let an agent dispatch a long-running tool call without blocking the agentic loop. The tool returns an immediate acknowledgement while the LLM continues responding. The task then runs to completion in the background. When it finishes, its result is written to memory and if you use `stream()` with the [`untilIdle`](https://mastra.ai/reference/streaming/agents/stream) option the agent is re-invoked automatically so the result is processed in the same call.
+Background tasks let an agent dispatch a long-running tool call without blocking the agentic loop. The tool returns an immediate acknowledgement while the LLM continues responding. The task then runs to completion in the background. When it finishes, its result is written to memory and the agent runs a follow-up turn to report it. With the [`untilIdle`](https://mastra.ai/reference/streaming/agents/stream) option, that turn streams on the same call; otherwise the agent is notified on the thread, as described in [Report a result after the stream ends](#report-a-result-after-the-stream-ends).
 
 ## When to use background tasks
 
@@ -187,6 +187,50 @@ export const mastra = new Mastra({
 })
 ```
 
+### Report a result after the stream ends
+
+When a deferred task finishes and no `untilIdle` stream is open for its thread, Mastra sends the agent a `notification` signal with the tag `background-task`. The signal names the tool call and task, and tells the agent the result is now on the tool call. It doesn't copy the result into the prompt. This covers a `stream()` call without `untilIdle`, a client that disconnected, and a task resumed after it [suspended](#suspending-and-resuming).
+
+- If the thread is idle, the signal wakes the agent, which runs a turn on the thread to report the outcome.
+- If a run is already active on the thread, including the run that dispatched the task, the signal is delivered to that run's next model request. If that run ends without making another request, the signal runs as its own turn.
+- If an `untilIdle` stream is open for the thread, no signal is sent, because that stream runs its own follow-up turn.
+- If the caller cancelled or aborted the `untilIdle` stream that was waiting for the task, no signal is sent either: stopping the stream means the caller doesn't want a reply for that work. A task that suspended and is answered later isn't covered by this, because the stream stopped waiting for it when it suspended.
+
+A run that a signal starts on an idle thread, such as a message sent with `agent.sendSignal()`, stays open until the tasks it dispatched finish, and reports them itself. To end woken runs after their own turn instead, set the temporary `wokenRunsEndAfterTurn` option. Their tasks then report back with this signal when they finish:
+
+```typescript
+import { Mastra } from '@mastra/core'
+
+export const mastra = new Mastra({
+  backgroundTasks: {
+    enabled: true,
+    wokenRunsEndAfterTurn: true,
+  },
+})
+```
+
+A signal's own `ifIdle.streamOptions.untilIdle` takes precedence over the option in both directions. In the next major release, ending after the turn becomes the only behavior and `wokenRunsEndAfterTurn` is removed. To keep a woken run open after that, pass `untilIdle: true` in `ifIdle.streamOptions`. Agent controller sessions and channels already pass it.
+
+If you combine `wokenRunsEndAfterTurn` with `notifyAgentOnFinish: false`, nothing reports the tasks of a woken run, so your app has to send the completion itself.
+
+If your app sends its own completion signal, for example from `onTaskComplete`, set `notifyAgentOnFinish: false` on the Mastra `backgroundTasks` config so the agent isn't told twice:
+
+```typescript
+import { Mastra } from '@mastra/core'
+
+export const mastra = new Mastra({
+  backgroundTasks: {
+    enabled: true,
+    notifyAgentOnFinish: false,
+    onTaskComplete: async task => {
+      // Send your own notification to task.threadId
+    },
+  },
+})
+```
+
+The signal needs memory with a thread and resource. A task dispatched without them only writes its result to the task record. Awaited tasks don't send the signal, because the run that dispatched them waits for the result.
+
 ### Aggregate properties
 
 `stream()` with `untilIdle` returns a `MastraModelOutput` that looks like the one from a regular `stream()` call, but `fullStream` alone spans the initial turn and any auto-continuations. Aggregate properties (`text`, `toolCalls`, `toolResults`, `finishReason`, `messageList`, `getFullOutput()`) still resolve against the **first turn's** internal buffer. If you need an aggregate view across continuations, consume `fullStream` yourself and accumulate.
@@ -292,6 +336,31 @@ await mastra.backgroundTaskManager?.resume(taskId, {
 })
 ```
 
+On the resumed run, `context.agent.suspendPayload` holds the `data` the tool suspended with. Use it to tell which request an answer belongs to without encoding that in `resumeData`.
+
+### Answer a suspended task from a client
+
+While an agent's background tool call is suspended, the assistant message that holds the call records the open request under `metadata.suspendedTools[toolCallId]`. The entry carries `toolName`, `args`, `suspendPayload`, `taskId`, `runId`, and `suspendedAt`, so a chat that reloads the thread can still show the request. The entry is removed when the task resumes or is cancelled.
+
+The entry is written by the process that dispatched the tool call, the same process that writes the task's result into the thread. A task that a worker picks up after a restart has no such process, so neither the open request nor the result reaches the thread.
+
+To answer the request over HTTP, call `POST /api/background-tasks/:backgroundTaskId/resume` with the answer in `resumeData`. The [client SDK](https://mastra.ai/reference/client-js/mastra-client) wraps the route as `resumeBackgroundTask()`:
+
+```typescript
+import { MastraClient } from '@mastra/client-js'
+
+const client = new MastraClient({ baseUrl: 'http://localhost:4111' })
+
+const task = await client.getBackgroundTask(taskId)
+await client.resumeBackgroundTask(
+  taskId,
+  { reviewer: 'alice@example.com' },
+  { suspendedAt: task.suspendedAt },
+)
+```
+
+Pass the `suspendedAt` you read from the task or the `suspendedTools` entry. When the task has resumed or suspended again since, the server returns `409 Conflict` instead of delivering a stale answer. The route also returns `409` when the task isn't suspended or no concurrency slot is free, and `404` when the task doesn't exist or belongs to another resource. Calling it requires the `background-tasks:execute` permission.
+
 ### Resume when no slot is free
 
 By default, `resume()` throws `Concurrency limit reached` when every concurrency slot is in use. Pass `{ onNoSlot: 'queue' }` to queue the resume instead:
@@ -307,7 +376,7 @@ The queue lives in the memory of the process that called `resume()`. If that pro
 
 ### What happens to the agent loop
 
-When a task suspends mid-`stream()` with `untilIdle`, the wrapper treats it as terminal for the current iteration and closes. Once the resume payload is available, call `agent.resumeStream(resumeData, { runId, toolCallId, memory, untilIdle: true })` to continue immediately. The resumed background task completes and adds its result to the message list before the agent runs a follow-up turn on the same SSE connection. To drive the resume out of band, call `mastra.backgroundTaskManager.resume(taskId, resumeData)` directly. Its result is still written into the thread for the next user turn.
+When a task suspends mid-`stream()` with `untilIdle`, the wrapper treats it as terminal for the current iteration and closes. Once the resume payload is available, call `agent.resumeStream(resumeData, { runId, toolCallId, memory, untilIdle: true })` to continue immediately. The resumed background task completes and adds its result to the message list before the agent runs a follow-up turn on the same SSE connection. To drive the resume out of band, call `mastra.backgroundTaskManager.resume(taskId, resumeData)` directly, or use the [resume route](#answer-a-suspended-task-from-a-client). When the task finishes, its result is written into the thread and the agent [wakes to report it](#report-a-result-after-the-stream-ends).
 
 ### Re-registering the executor on resume
 

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_src = require("./src-GDwZ0vzw.cjs");
+const require_src = require("./src-CaVDupkI.cjs");
 let _mastra_core_processors = require("@mastra/core/processors");
 exports.AUTO_MODEL_BY_PROVIDER = require_src.AUTO_MODEL_BY_PROVIDER;
 exports.Extractor = require_src.Extractor;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { embedMany } from './_types/@internal_ai-sdk-v4/dist/index.js';
+import { embedMany } from './_types/@internal_ai-sdk-v4@0.0.94/dist/index.js';
 import type { MastraDBMessage } from '@mastra/core/agent';
 import type { Mastra } from '@mastra/core/mastra';
 import { MastraMemory } from '@mastra/core/memory';

package/dist/index.js

@@ -1 +1 @@
-export { d as AUTO_MODEL_BY_PROVIDER, U as Extractor, w as KnowledgeSemanticIndexCoordinator, t as Memory, n as MessageHistory, g as ModelByInputTokens, k as SUMMARIZE_THREAD_DEFAULTS, r as SemanticRecall, T as StaleKnowledgeSemanticIndexError, E as Subconscious, p as WORKING_MEMORY_STATE_ID, m as WORKING_MEMORY_STATE_PROCESSOR_ID, i as WorkingMemory, D as WorkingMemoryExtractor, h as WorkingMemoryStateProcessor, O as deepMergeWorkingMemory, a as extractWorkingMemoryContent, o as extractWorkingMemoryTags, c as getObservationsAsOf, s as removeWorkingMemoryTags, f as resolveAutoModelId, A as summarizeConversation } from "./src-CBYx0iwC.js";
+export { d as AUTO_MODEL_BY_PROVIDER, U as Extractor, w as KnowledgeSemanticIndexCoordinator, t as Memory, n as MessageHistory, g as ModelByInputTokens, k as SUMMARIZE_THREAD_DEFAULTS, r as SemanticRecall, T as StaleKnowledgeSemanticIndexError, E as Subconscious, p as WORKING_MEMORY_STATE_ID, m as WORKING_MEMORY_STATE_PROCESSOR_ID, i as WorkingMemory, D as WorkingMemoryExtractor, h as WorkingMemoryStateProcessor, O as deepMergeWorkingMemory, a as extractWorkingMemoryContent, o as extractWorkingMemoryTags, c as getObservationsAsOf, s as removeWorkingMemoryTags, f as resolveAutoModelId, A as summarizeConversation } from "./src-Det56QOD.js";

package/dist/processors/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_src = require("../src-GDwZ0vzw.cjs");
+const require_src = require("../src-CaVDupkI.cjs");
 exports.AUTO_MODEL_BY_PROVIDER = require_src.AUTO_MODEL_BY_PROVIDER;
 exports.Extractor = require_src.Extractor;
 exports.ModelByInputTokens = require_src.ModelByInputTokens;

package/dist/processors/index.js

@@ -1 +1 @@
-export { d as AUTO_MODEL_BY_PROVIDER, U as Extractor, g as ModelByInputTokens, W as OBSERVATIONAL_MEMORY_DEFAULTS, G as OBSERVATION_CONTEXT_INSTRUCTIONS, K as OBSERVATION_CONTEXT_PROMPT, q as OBSERVATION_CONTEXT_PROMPT_THREAD, J as OBSERVATION_CONTINUATION_HINT, M as OBSERVER_SYSTEM_PROMPT, u as ObservationalMemory, l as ObservationalMemoryProcessor, j as TokenCounter, D as WorkingMemoryExtractor, N as buildObserverPrompt, P as buildObserverSystemPrompt, _ as combineObservationGroupRanges, v as deriveObservationGroupProvenance, F as extractCurrentTask, I as formatMessagesForObserver, Y as getObservationContextPrompt, c as getObservationsAsOf, L as hasCurrentTaskSection, B as injectAnchorIds, R as optimizeObservationsForContext, V as parseAnchorId, y as parseObservationGroups, z as parseObserverOutput, b as reconcileObservationGroupsFromReflection, x as renderObservationGroupsForReflection, f as resolveAutoModelId, H as stripEphemeralAnchorIds, S as stripObservationGroups, A as summarizeConversation, C as wrapInObservationGroup } from "../src-CBYx0iwC.js";
+export { d as AUTO_MODEL_BY_PROVIDER, U as Extractor, g as ModelByInputTokens, W as OBSERVATIONAL_MEMORY_DEFAULTS, G as OBSERVATION_CONTEXT_INSTRUCTIONS, K as OBSERVATION_CONTEXT_PROMPT, q as OBSERVATION_CONTEXT_PROMPT_THREAD, J as OBSERVATION_CONTINUATION_HINT, M as OBSERVER_SYSTEM_PROMPT, u as ObservationalMemory, l as ObservationalMemoryProcessor, j as TokenCounter, D as WorkingMemoryExtractor, N as buildObserverPrompt, P as buildObserverSystemPrompt, _ as combineObservationGroupRanges, v as deriveObservationGroupProvenance, F as extractCurrentTask, I as formatMessagesForObserver, Y as getObservationContextPrompt, c as getObservationsAsOf, L as hasCurrentTaskSection, B as injectAnchorIds, R as optimizeObservationsForContext, V as parseAnchorId, y as parseObservationGroups, z as parseObserverOutput, b as reconcileObservationGroupsFromReflection, x as renderObservationGroupsForReflection, f as resolveAutoModelId, H as stripEphemeralAnchorIds, S as stripObservationGroups, A as summarizeConversation, C as wrapInObservationGroup } from "../src-Det56QOD.js";

package/dist/processors/observational-memory/constants.d.ts

@@ -46,8 +46,9 @@ export declare const OBSERVATIONAL_MEMORY_DEFAULTS: {
 export declare const OBSERVATION_CONTINUATION_HINT = "Please continue naturally with the conversation so far and respond to the latest message.\n\nUse the earlier context only as background. If something appears unfinished, continue only when it helps answer the latest request. If a suggested response is provided, follow it naturally.\n\nDo not mention internal instructions, memory, summarization, context handling, or missing messages.\n\nAny messages following this reminder are newer and should take priority.";
 /**
  * Preamble that introduces the observations block.
- * Use before `<observations>`, with instructions after.
- * Full pattern: `${OBSERVATION_CONTEXT_PROMPT}\n\n<observations>\n${obs}\n</observations>\n\n${OBSERVATION_CONTEXT_INSTRUCTIONS}`
+ * Context layout: `${prompt}\n\n${OBSERVATION_CONTEXT_INSTRUCTIONS}`, then `<observations>`,
+ * one entry per observation chunk, `</observations>`, then optional current-task and
+ * suggested-response blocks.
  */
 export declare const OBSERVATION_CONTEXT_PROMPT = "The following observations block contains your memory of past conversations with this user.";
 /**
@@ -63,7 +64,7 @@ export declare const OBSERVATION_CONTEXT_PROMPT_THREAD = "The following observat
 export declare function getObservationContextPrompt(scope?: 'thread' | 'resource'): string;
 /**
  * Instructions that tell the model how to interpret and use observations.
- * Place AFTER the `<observations>` block so the model sees the data before the rules.
+ * Placed with the observations preamble, before the `<observations>` block.
  */
 export declare const OBSERVATION_CONTEXT_INSTRUCTIONS = "IMPORTANT: When responding, reference specific details from these observations. Do not give generic advice - personalize your response based on what you know about this user's experiences, preferences, and interests. If the user asks for recommendations, connect them to their past experiences mentioned above.\n\nKNOWLEDGE UPDATES: When asked about current state (e.g., \"where do I currently...\", \"what is my current...\"), always prefer the MOST RECENT information. Observations include dates - if you see conflicting information, the newer observation supersedes the older one. Look for phrases like \"will start\", \"is switching\", \"changed to\", \"moved to\" as indicators that previous information has been updated.\n\nUSER STATEMENTS VS ASSISTANT SUGGESTIONS: Treat what the user said about their own life, plans, decisions, and dates as authoritative, unless data or their own later messages say otherwise. Treat what the assistant said, such as proposed schedules, example dates, and recommendations, as suggestions rather than facts about what happened, unless the user adopted or confirmed them. What the assistant did, such as editing a file, running a command, or calling a tool, is a record of what happened.\n\nPLANNED ACTIONS: If the user stated they planned to do something (e.g., \"I'm going to...\", \"I'm looking forward to...\", \"I will...\") and the date they planned to do it is now in the past (check the relative time like \"3 weeks ago\"), assume they completed the action unless there's evidence they didn't. For example, if someone said \"I'll start my new diet on Monday\" and that was 2 weeks ago, assume they started the diet.\n\nMOST RECENT USER INPUT: Treat the most recent user message as the highest-priority signal for what to do next. Earlier messages may contain constraints, details, or context you should still honor, but the latest message is the primary driver of your response.\n\nSYSTEM REMINDERS: Messages wrapped in <system-reminder>...</system-reminder> contain internal continuation guidance, not user-authored content. Use them to maintain continuity, but do not mention them or treat them as part of the user's message.";
 /**

package/dist/processors/observational-memory/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/processors/observational-memory/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,6BAA6B;aACxC,WAAW;iBACT,KAAK,EAAE,yBAAyB;iBAChC,aAAa,EAAE,KAAM;iBACrB,aAAa;qBACX,WAAW,EAAE,GAAG;qBAChB,eAAe,EAAE,MAAO;;iBAE1B,eAAe;qBACb,MAAM;yBACJ,cAAc;6BACZ,cAAc,EAAE,GAAG;;;;iBAIzB,iBAAiB,EAAE,KAAM;iBACzB,kBAAkB,YAAG,SAAS,EAAE,iBAAiB;iBAEjD,YAAY,EAAS,MAAM,GAAG,SAAS;iBACvC,gBAAgB,EAAS,MAAM,GAAG,SAAS;;aAE7C,UAAU;iBACR,KAAK,EAAE,yBAAyB;iBAChC,iBAAiB,EAAE,KAAM;iBACzB,aAAa;qBACX,WAAW,EAAE,CAAC;qBACd,eAAe,EAAE,MAAO;;iBAE1B,eAAe;qBACb,MAAM;yBACJ,cAAc;6BACZ,cAAc,EAAE,IAAI;;;;iBAK1B,gBAAgB,EAAS,MAAM,GAAG,SAAS;;CAErC,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,kdAM+B,CAAC;AAE1E;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,gGAAgG,CAAC;AAExI;;;GAGG;AACH,eAAO,MAAM,iCAAiC,8OAA8O,CAAC;AAE7R;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,GAAE,QAAQ,GAAG,UAAqB,GAAG,MAAM,CAE3F;AAED;;;GAGG;AACH,eAAO,MAAM,gCAAgC,ooEAUyM,CAAC;AAEvP;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,GAAE,QAAQ,GAAG,UAAuB,EACzC,kBAAkB,CAAC,EAAE,MAAM,EAC3B,aAAa,UAAO,EACpB,wBAAwB,UAAgB,GACvC,MAAM,CA4IR"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/processors/observational-memory/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,6BAA6B;aACxC,WAAW;iBACT,KAAK,EAAE,yBAAyB;iBAChC,aAAa,EAAE,KAAM;iBACrB,aAAa;qBACX,WAAW,EAAE,GAAG;qBAChB,eAAe,EAAE,MAAO;;iBAE1B,eAAe;qBACb,MAAM;yBACJ,cAAc;6BACZ,cAAc,EAAE,GAAG;;;;iBAIzB,iBAAiB,EAAE,KAAM;iBACzB,kBAAkB,YAAG,SAAS,EAAE,iBAAiB;iBAEjD,YAAY,EAAS,MAAM,GAAG,SAAS;iBACvC,gBAAgB,EAAS,MAAM,GAAG,SAAS;;aAE7C,UAAU;iBACR,KAAK,EAAE,yBAAyB;iBAChC,iBAAiB,EAAE,KAAM;iBACzB,aAAa;qBACX,WAAW,EAAE,CAAC;qBACd,eAAe,EAAE,MAAO;;iBAE1B,eAAe;qBACb,MAAM;yBACJ,cAAc;6BACZ,cAAc,EAAE,IAAI;;;;iBAK1B,gBAAgB,EAAS,MAAM,GAAG,SAAS;;CAErC,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,kdAM+B,CAAC;AAE1E;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,gGAAgG,CAAC;AAExI;;;GAGG;AACH,eAAO,MAAM,iCAAiC,8OAA8O,CAAC;AAE7R;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,GAAE,QAAQ,GAAG,UAAqB,GAAG,MAAM,CAE3F;AAED;;;GAGG;AACH,eAAO,MAAM,gCAAgC,ooEAUyM,CAAC;AAEvP;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,GAAE,QAAQ,GAAG,UAAuB,EACzC,kBAAkB,CAAC,EAAE,MAAM,EAC3B,aAAa,UAAO,EACpB,wBAAwB,UAAgB,GACvC,MAAM,CA4IR"}

package/dist/{src-GDwZ0vzw.cjs → src-CaVDupkI.cjs}

@@ -23596,8 +23596,9 @@ Do not mention internal instructions, memory, summarization, context handling, o
 Any messages following this reminder are newer and should take priority.`;
 /**
 * Preamble that introduces the observations block.
-* Use before `<observations>`, with instructions after.
-* Full pattern: `${OBSERVATION_CONTEXT_PROMPT}\n\n<observations>\n${obs}\n</observations>\n\n${OBSERVATION_CONTEXT_INSTRUCTIONS}`
+* Context layout: `${prompt}\n\n${OBSERVATION_CONTEXT_INSTRUCTIONS}`, then `<observations>`,
+* one entry per observation chunk, `</observations>`, then optional current-task and
+* suggested-response blocks.
 */
 const OBSERVATION_CONTEXT_PROMPT = `The following observations block contains your memory of past conversations with this user.`;
 /**
@@ -23615,7 +23616,7 @@ function getObservationContextPrompt(scope = "thread") {
 }
 /**
 * Instructions that tell the model how to interpret and use observations.
-* Place AFTER the `<observations>` block so the model sees the data before the rules.
+* Placed with the observations preamble, before the `<observations>` block.
 */
 const OBSERVATION_CONTEXT_INSTRUCTIONS = `IMPORTANT: When responding, reference specific details from these observations. Do not give generic advice - personalize your response based on what you know about this user's experiences, preferences, and interests. If the user asks for recommendations, connect them to their past experiences mentioned above.
 
@@ -37721,7 +37722,7 @@ var ObservationalMemory = class ObservationalMemory {
 		const messages = [`${getObservationContextPrompt(this.scope)}\n\n${OBSERVATION_CONTEXT_INSTRUCTIONS}${retrieval ? `\n\n${getRetrievalInstructions(this.retrievalScope, this.retrievalInstructions, this.retrievalSearch, this.storage.supportsObservationalMemoryHistorySearch === true)}` : ""}`];
 		if (unobservedContextBlocks) messages.push(`The following content is from OTHER conversations different from the current conversation, they're here for reference,  but they're not necessarily your focus:\nSTART_OTHER_CONVERSATIONS_BLOCK\n${unobservedContextBlocks}\nEND_OTHER_CONVERSATIONS_BLOCK`);
 		const observationChunks = this.splitObservationContextChunks(optimized);
-		if (observationChunks.length > 0) messages.push("<observations>", ...observationChunks);
+		if (observationChunks.length > 0) messages.push("<observations>", ...observationChunks, "</observations>");
 		if (currentTask) messages.push(`<current-task>\n${currentTask}\n</current-task>`);
 		if (suggestedResponse) messages.push(`<suggested-response>\n${suggestedResponse}\n</suggested-response>`);
 		messages.push(...buildExtractedValueContextSections([...this.observationConfig.extractors, ...this.reflectionConfig.extractors], extractedValues));
@@ -42725,4 +42726,4 @@ Object.defineProperty(exports, "wrapInObservationGroup", {
 	}
 });
 
-//# sourceMappingURL=src-GDwZ0vzw.cjs.map
+//# sourceMappingURL=src-CaVDupkI.cjs.map