@mastra/memory 0.0.0-error-handler-fix-20251020202607 → 0.0.0-esbuild-bundle-worker-20260807182016

package/dist/processors/index.cjs

@@ -1,165 +1,32 @@
-'use strict';
-
-var memory = require('@mastra/core/memory');
-var lite = require('js-tiktoken/lite');
-var o200k_base = require('js-tiktoken/ranks/o200k_base');
-
-function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
-
-var o200k_base__default = /*#__PURE__*/_interopDefault(o200k_base);
-
-// src/processors/token-limiter.ts
-var TokenLimiter = class extends memory.MemoryProcessor {
-  encoder;
-  maxTokens;
-  // Token overheads per OpenAI's documentation
-  // See: https://cookbook.openai.com/examples/how_to_count_tokens_with_tiktoken#6-counting-tokens-for-chat-completions-api-calls
-  // Every message follows <|start|>{role/name}\n{content}<|end|>
-  TOKENS_PER_MESSAGE = 3.8;
-  // tokens added for each message (start & end tokens)
-  TOKENS_PER_CONVERSATION = 24;
-  // fixed overhead for the conversation
-  /**
-   * Create a token limiter for messages.
-   * @param options Either a number (token limit) or a configuration object
-   */
-  constructor(options) {
-    super({
-      name: "TokenLimiter"
-    });
-    if (typeof options === "number") {
-      this.maxTokens = options;
-      this.encoder = new lite.Tiktoken(o200k_base__default.default);
-    } else {
-      this.maxTokens = options.limit;
-      this.encoder = new lite.Tiktoken(options.encoding || o200k_base__default.default);
-    }
-  }
-  process(messages, { systemMessage, memorySystemMessage, newMessages } = {}) {
-    let totalTokens = 0;
-    totalTokens += this.TOKENS_PER_CONVERSATION;
-    if (systemMessage) {
-      totalTokens += this.countTokens(systemMessage);
-      totalTokens += this.TOKENS_PER_MESSAGE;
-    }
-    if (memorySystemMessage) {
-      totalTokens += this.countTokens(memorySystemMessage);
-      totalTokens += this.TOKENS_PER_MESSAGE;
-    }
-    const allMessages = [...messages, ...newMessages || []];
-    const result = [];
-    for (let i = allMessages.length - 1; i >= 0; i--) {
-      const message = allMessages[i];
-      if (!message) continue;
-      const messageTokens = this.countTokens(message);
-      if (totalTokens + messageTokens <= this.maxTokens) {
-        if (i < messages.length) {
-          result.unshift(message);
-        }
-        totalTokens += messageTokens;
-      } else {
-        this.logger.info(
-          `filtering ${allMessages.length - result.length}/${allMessages.length} messages, token limit of ${this.maxTokens} exceeded`
-        );
-        break;
-      }
-    }
-    return result;
-  }
-  countTokens(message) {
-    if (typeof message === `string`) {
-      return this.encoder.encode(message).length;
-    }
-    let tokenString = message.role;
-    let overhead = 0;
-    if (typeof message.content === "string" && message.content) {
-      tokenString += message.content;
-    } else if (Array.isArray(message.content)) {
-      for (const part of message.content) {
-        if (part.type === "text") {
-          tokenString += part.text;
-        } else if (part.type === "tool-call" || part.type === `tool-result`) {
-          if (`args` in part && part.args && part.type === `tool-call`) {
-            tokenString += part.toolName;
-            if (typeof part.args === "string") {
-              tokenString += part.args;
-            } else {
-              tokenString += JSON.stringify(part.args);
-              overhead -= 12;
-            }
-          }
-          if (`result` in part && part.result !== void 0 && part.type === `tool-result`) {
-            if (typeof part.result === "string") {
-              tokenString += part.result;
-            } else {
-              tokenString += JSON.stringify(part.result);
-              overhead -= 12;
-            }
-          }
-        } else {
-          tokenString += JSON.stringify(part);
-        }
-      }
-    }
-    if (typeof message.content === `string` || // if the message included non-tool parts, add our message overhead
-    message.content.some((p) => p.type !== `tool-call` && p.type !== `tool-result`)) {
-      overhead += this.TOKENS_PER_MESSAGE;
-    }
-    return this.encoder.encode(tokenString).length + overhead;
-  }
-};
-var ToolCallFilter = class extends memory.MemoryProcessor {
-  exclude;
-  /**
-   * Create a filter for tool calls and results.
-   * @param options Configuration options
-   * @param options.exclude List of specific tool names to exclude. If not provided, all tool calls are excluded.
-   */
-  constructor(options = {}) {
-    super({ name: "ToolCallFilter" });
-    if (!options || !options.exclude) {
-      this.exclude = "all";
-    } else {
-      this.exclude = Array.isArray(options.exclude) ? options.exclude : [];
-    }
-  }
-  process(messages) {
-    if (this.exclude === "all") {
-      return messages.filter((message) => {
-        if (Array.isArray(message.content)) {
-          return !message.content.some((part) => part.type === "tool-call" || part.type === "tool-result");
-        }
-        return true;
-      });
-    }
-    if (this.exclude.length > 0) {
-      const excludedToolCallIds = /* @__PURE__ */ new Set();
-      return messages.filter((message) => {
-        if (!Array.isArray(message.content)) return true;
-        if (message.role === "assistant") {
-          let shouldExclude = false;
-          for (const part of message.content) {
-            if (part.type === "tool-call" && this.exclude.includes(part.toolName)) {
-              excludedToolCallIds.add(part.toolCallId);
-              shouldExclude = true;
-            }
-          }
-          return !shouldExclude;
-        }
-        if (message.role === "tool") {
-          const shouldExclude = message.content.some(
-            (part) => part.type === "tool-result" && excludedToolCallIds.has(part.toolCallId)
-          );
-          return !shouldExclude;
-        }
-        return true;
-      });
-    }
-    return messages;
-  }
-};
-
-exports.TokenLimiter = TokenLimiter;
-exports.ToolCallFilter = ToolCallFilter;
-//# sourceMappingURL=index.cjs.map
-//# sourceMappingURL=index.cjs.map
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_src = require("../src-DqoifKIy.cjs");
+exports.Extractor = require_src.Extractor;
+exports.ModelByInputTokens = require_src.ModelByInputTokens;
+exports.OBSERVATIONAL_MEMORY_DEFAULTS = require_src.OBSERVATIONAL_MEMORY_DEFAULTS;
+exports.OBSERVATION_CONTEXT_INSTRUCTIONS = require_src.OBSERVATION_CONTEXT_INSTRUCTIONS;
+exports.OBSERVATION_CONTEXT_PROMPT = require_src.OBSERVATION_CONTEXT_PROMPT;
+exports.OBSERVATION_CONTINUATION_HINT = require_src.OBSERVATION_CONTINUATION_HINT;
+exports.OBSERVER_SYSTEM_PROMPT = require_src.OBSERVER_SYSTEM_PROMPT;
+exports.ObservationalMemory = require_src.ObservationalMemory;
+exports.ObservationalMemoryProcessor = require_src.ObservationalMemoryProcessor;
+exports.TokenCounter = require_src.TokenCounter;
+exports.WorkingMemoryExtractor = require_src.WorkingMemoryExtractor;
+exports.buildObserverPrompt = require_src.buildObserverPrompt;
+exports.buildObserverSystemPrompt = require_src.buildObserverSystemPrompt;
+exports.combineObservationGroupRanges = require_src.combineObservationGroupRanges;
+exports.deriveObservationGroupProvenance = require_src.deriveObservationGroupProvenance;
+exports.extractCurrentTask = require_src.extractCurrentTask;
+exports.formatMessagesForObserver = require_src.formatMessagesForObserver;
+exports.getObservationsAsOf = require_src.getObservationsAsOf;
+exports.hasCurrentTaskSection = require_src.hasCurrentTaskSection;
+exports.injectAnchorIds = require_src.injectAnchorIds;
+exports.optimizeObservationsForContext = require_src.optimizeObservationsForContext;
+exports.parseAnchorId = require_src.parseAnchorId;
+exports.parseObservationGroups = require_src.parseObservationGroups;
+exports.parseObserverOutput = require_src.parseObserverOutput;
+exports.reconcileObservationGroupsFromReflection = require_src.reconcileObservationGroupsFromReflection;
+exports.renderObservationGroupsForReflection = require_src.renderObservationGroupsForReflection;
+exports.stripEphemeralAnchorIds = require_src.stripEphemeralAnchorIds;
+exports.stripObservationGroups = require_src.stripObservationGroups;
+exports.summarizeConversation = require_src.summarizeConversation;
+exports.wrapInObservationGroup = require_src.wrapInObservationGroup;

package/dist/processors/index.d.ts

@@ -1,3 +1,2 @@
-export * from './token-limiter.js';
-export * from './tool-call-filter.js';
+export * from './observational-memory/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/processors/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/processors/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/processors/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC"}

package/dist/processors/index.js

@@ -1,158 +1,2 @@
-import { MemoryProcessor } from '@mastra/core/memory';
-import { Tiktoken } from 'js-tiktoken/lite';
-import o200k_base from 'js-tiktoken/ranks/o200k_base';
-
-// src/processors/token-limiter.ts
-var TokenLimiter = class extends MemoryProcessor {
-  encoder;
-  maxTokens;
-  // Token overheads per OpenAI's documentation
-  // See: https://cookbook.openai.com/examples/how_to_count_tokens_with_tiktoken#6-counting-tokens-for-chat-completions-api-calls
-  // Every message follows <|start|>{role/name}\n{content}<|end|>
-  TOKENS_PER_MESSAGE = 3.8;
-  // tokens added for each message (start & end tokens)
-  TOKENS_PER_CONVERSATION = 24;
-  // fixed overhead for the conversation
-  /**
-   * Create a token limiter for messages.
-   * @param options Either a number (token limit) or a configuration object
-   */
-  constructor(options) {
-    super({
-      name: "TokenLimiter"
-    });
-    if (typeof options === "number") {
-      this.maxTokens = options;
-      this.encoder = new Tiktoken(o200k_base);
-    } else {
-      this.maxTokens = options.limit;
-      this.encoder = new Tiktoken(options.encoding || o200k_base);
-    }
-  }
-  process(messages, { systemMessage, memorySystemMessage, newMessages } = {}) {
-    let totalTokens = 0;
-    totalTokens += this.TOKENS_PER_CONVERSATION;
-    if (systemMessage) {
-      totalTokens += this.countTokens(systemMessage);
-      totalTokens += this.TOKENS_PER_MESSAGE;
-    }
-    if (memorySystemMessage) {
-      totalTokens += this.countTokens(memorySystemMessage);
-      totalTokens += this.TOKENS_PER_MESSAGE;
-    }
-    const allMessages = [...messages, ...newMessages || []];
-    const result = [];
-    for (let i = allMessages.length - 1; i >= 0; i--) {
-      const message = allMessages[i];
-      if (!message) continue;
-      const messageTokens = this.countTokens(message);
-      if (totalTokens + messageTokens <= this.maxTokens) {
-        if (i < messages.length) {
-          result.unshift(message);
-        }
-        totalTokens += messageTokens;
-      } else {
-        this.logger.info(
-          `filtering ${allMessages.length - result.length}/${allMessages.length} messages, token limit of ${this.maxTokens} exceeded`
-        );
-        break;
-      }
-    }
-    return result;
-  }
-  countTokens(message) {
-    if (typeof message === `string`) {
-      return this.encoder.encode(message).length;
-    }
-    let tokenString = message.role;
-    let overhead = 0;
-    if (typeof message.content === "string" && message.content) {
-      tokenString += message.content;
-    } else if (Array.isArray(message.content)) {
-      for (const part of message.content) {
-        if (part.type === "text") {
-          tokenString += part.text;
-        } else if (part.type === "tool-call" || part.type === `tool-result`) {
-          if (`args` in part && part.args && part.type === `tool-call`) {
-            tokenString += part.toolName;
-            if (typeof part.args === "string") {
-              tokenString += part.args;
-            } else {
-              tokenString += JSON.stringify(part.args);
-              overhead -= 12;
-            }
-          }
-          if (`result` in part && part.result !== void 0 && part.type === `tool-result`) {
-            if (typeof part.result === "string") {
-              tokenString += part.result;
-            } else {
-              tokenString += JSON.stringify(part.result);
-              overhead -= 12;
-            }
-          }
-        } else {
-          tokenString += JSON.stringify(part);
-        }
-      }
-    }
-    if (typeof message.content === `string` || // if the message included non-tool parts, add our message overhead
-    message.content.some((p) => p.type !== `tool-call` && p.type !== `tool-result`)) {
-      overhead += this.TOKENS_PER_MESSAGE;
-    }
-    return this.encoder.encode(tokenString).length + overhead;
-  }
-};
-var ToolCallFilter = class extends MemoryProcessor {
-  exclude;
-  /**
-   * Create a filter for tool calls and results.
-   * @param options Configuration options
-   * @param options.exclude List of specific tool names to exclude. If not provided, all tool calls are excluded.
-   */
-  constructor(options = {}) {
-    super({ name: "ToolCallFilter" });
-    if (!options || !options.exclude) {
-      this.exclude = "all";
-    } else {
-      this.exclude = Array.isArray(options.exclude) ? options.exclude : [];
-    }
-  }
-  process(messages) {
-    if (this.exclude === "all") {
-      return messages.filter((message) => {
-        if (Array.isArray(message.content)) {
-          return !message.content.some((part) => part.type === "tool-call" || part.type === "tool-result");
-        }
-        return true;
-      });
-    }
-    if (this.exclude.length > 0) {
-      const excludedToolCallIds = /* @__PURE__ */ new Set();
-      return messages.filter((message) => {
-        if (!Array.isArray(message.content)) return true;
-        if (message.role === "assistant") {
-          let shouldExclude = false;
-          for (const part of message.content) {
-            if (part.type === "tool-call" && this.exclude.includes(part.toolName)) {
-              excludedToolCallIds.add(part.toolCallId);
-              shouldExclude = true;
-            }
-          }
-          return !shouldExclude;
-        }
-        if (message.role === "tool") {
-          const shouldExclude = message.content.some(
-            (part) => part.type === "tool-result" && excludedToolCallIds.has(part.toolCallId)
-          );
-          return !shouldExclude;
-        }
-        return true;
-      });
-    }
-    return messages;
-  }
-};
-
-export { TokenLimiter, ToolCallFilter };
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map
+import { A as extractCurrentTask, B as OBSERVATION_CONTEXT_INSTRUCTIONS, C as WorkingMemoryExtractor, D as OBSERVER_SYSTEM_PROMPT, E as TokenCounter, F as injectAnchorIds, H as OBSERVATION_CONTINUATION_HINT, I as parseAnchorId, L as stripEphemeralAnchorIds, M as hasCurrentTaskSection, N as optimizeObservationsForContext, O as buildObserverPrompt, P as parseObserverOutput, R as Extractor, T as summarizeConversation, V as OBSERVATION_CONTEXT_PROMPT, _ as reconcileObservationGroupsFromReflection, b as wrapInObservationGroup, d as getObservationsAsOf, f as ObservationalMemoryProcessor, g as parseObservationGroups, h as deriveObservationGroupProvenance, j as formatMessagesForObserver, k as buildObserverSystemPrompt, m as combineObservationGroupRanges, p as ObservationalMemory, v as renderObservationGroupsForReflection, x as ModelByInputTokens, y as stripObservationGroups, z as OBSERVATIONAL_MEMORY_DEFAULTS } from "../src-C1tlhGeW.js";
+export { Extractor, ModelByInputTokens, OBSERVATIONAL_MEMORY_DEFAULTS, OBSERVATION_CONTEXT_INSTRUCTIONS, OBSERVATION_CONTEXT_PROMPT, OBSERVATION_CONTINUATION_HINT, OBSERVER_SYSTEM_PROMPT, ObservationalMemory, ObservationalMemoryProcessor, TokenCounter, WorkingMemoryExtractor, buildObserverPrompt, buildObserverSystemPrompt, combineObservationGroupRanges, deriveObservationGroupProvenance, extractCurrentTask, formatMessagesForObserver, getObservationsAsOf, hasCurrentTaskSection, injectAnchorIds, optimizeObservationsForContext, parseAnchorId, parseObservationGroups, parseObserverOutput, reconcileObservationGroupsFromReflection, renderObservationGroupsForReflection, stripEphemeralAnchorIds, stripObservationGroups, summarizeConversation, wrapInObservationGroup };

package/dist/processors/observational-memory/activation-ttl.d.ts

@@ -0,0 +1,4 @@
+import type { ObservationModelContext, ResolvedActivationTTL } from './types.js';
+export declare function resolveActivationTTL(activateAfterIdle: ResolvedActivationTTL | undefined, modelContext?: ObservationModelContext): number | undefined;
+export declare function resolveAutoActivationTTL(modelContext?: ObservationModelContext): number;
+//# sourceMappingURL=activation-ttl.d.ts.map

package/dist/processors/observational-memory/activation-ttl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activation-ttl.d.ts","sourceRoot":"","sources":["../../../src/processors/observational-memory/activation-ttl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AA4B9E,wBAAgB,oBAAoB,CAClC,iBAAiB,EAAE,qBAAqB,GAAG,SAAS,EACpD,YAAY,CAAC,EAAE,uBAAuB,GACrC,MAAM,GAAG,SAAS,CAMpB;AAED,wBAAgB,wBAAwB,CAAC,YAAY,CAAC,EAAE,uBAAuB,GAAG,MAAM,CAmBvF"}

package/dist/processors/observational-memory/anchor-ids.d.ts

@@ -0,0 +1,4 @@
+export declare function parseAnchorId(line: string): string | null;
+export declare function injectAnchorIds(observations: string): string;
+export declare function stripEphemeralAnchorIds(observations: string): string;
+//# sourceMappingURL=anchor-ids.d.ts.map

package/dist/processors/observational-memory/anchor-ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor-ids.d.ts","sourceRoot":"","sources":["../../../src/processors/observational-memory/anchor-ids.ts"],"names":[],"mappings":"AAUA,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGzD;AAiCD,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAmC5D;AAED,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAMpE"}

package/dist/processors/observational-memory/buffering-coordinator.d.ts

@@ -0,0 +1,61 @@
+import type { ObservationalMemoryRecord } from '@mastra/core/storage';
+import type { ResolvedObservationConfig, ResolvedReflectionConfig } from './types.js';
+/**
+ * Manages the static buffering state machine for async observation and reflection.
+ *
+ * Static maps are shared across all ObservationalMemory instances in a process.
+ * This is critical because multiple OM instances are created per agent loop step,
+ * and they need to share knowledge of in-flight operations.
+ */
+export declare class BufferingCoordinator {
+    private readonly observationConfig;
+    private readonly reflectionConfig;
+    private readonly scope;
+    /**
+     * Track in-flight async buffering operations per resource/thread.
+     * Key format: "obs:{lockKey}" or "refl:{lockKey}"
+     * Value: Promise that resolves when buffering completes
+     */
+    static asyncBufferingOps: Map<string, Promise<void>>;
+    /**
+     * Track the last token boundary at which we started buffering.
+     * Key format: "obs:{lockKey}" or "refl:{lockKey}"
+     */
+    static lastBufferedBoundary: Map<string, number>;
+    /**
+     * Track the timestamp cursor for buffered messages.
+     * Key format: "obs:{lockKey}"
+     */
+    static lastBufferedAtTime: Map<string, Date>;
+    /**
+     * Tracks cycleId for in-flight buffered reflections.
+     * Key format: "refl:{lockKey}"
+     */
+    static reflectionBufferCycleIds: Map<string, string>;
+    constructor(opts: {
+        observationConfig: ResolvedObservationConfig;
+        reflectionConfig: ResolvedReflectionConfig;
+        scope: 'thread' | 'resource';
+    });
+    getLockKey(threadId: string | null | undefined, resourceId: string | null | undefined): string;
+    isAsyncObservationEnabled(): boolean;
+    isAsyncReflectionEnabled(): boolean;
+    getObservationBufferKey(lockKey: string): string;
+    getReflectionBufferKey(lockKey: string): string;
+    isAsyncBufferingInProgress(bufferKey: string): boolean;
+    /**
+     * Clean up static maps for a thread/resource to prevent memory leaks.
+     */
+    cleanupStaticMaps(threadId: string, resourceId?: string | null, activatedMessageIds?: string[]): void;
+    /**
+     * Check if we've crossed a new bufferTokens interval boundary for async observation.
+     */
+    shouldTriggerAsyncObservation(currentTokens: number, lockKey: string, record: ObservationalMemoryRecord, storage?: {
+        setBufferingObservationFlag(id: string, flag: boolean): Promise<void>;
+    }, messageTokensThreshold?: number): boolean;
+    /**
+     * Await any in-flight async buffering operations for a given thread/resource.
+     */
+    static awaitBuffering(threadId: string | null | undefined, resourceId: string | null | undefined, scope: 'thread' | 'resource', timeoutMs?: number): Promise<void>;
+}
+//# sourceMappingURL=buffering-coordinator.d.ts.map

package/dist/processors/observational-memory/buffering-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffering-coordinator.d.ts","sourceRoot":"","sources":["../../../src/processors/observational-memory/buffering-coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAItE,OAAO,KAAK,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAEnF;;;;;;GAMG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA4B;IAC9D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA2B;IAC5D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwB;IAE9C;;;;OAIG;IACH,MAAM,CAAC,iBAAiB,6BAAoC;IAE5D;;;OAGG;IACH,MAAM,CAAC,oBAAoB,sBAA6B;IAExD;;;OAGG;IACH,MAAM,CAAC,kBAAkB,oBAA2B;IAEpD;;;OAGG;IACH,MAAM,CAAC,wBAAwB,sBAA6B;gBAEhD,IAAI,EAAE;QAChB,iBAAiB,EAAE,yBAAyB,CAAC;QAC7C,gBAAgB,EAAE,wBAAwB,CAAC;QAC3C,KAAK,EAAE,QAAQ,GAAG,UAAU,CAAC;KAC9B;IAMD,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM;IAO9F,yBAAyB,IAAI,OAAO;IAIpC,wBAAwB,IAAI,OAAO;IAInC,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAIhD,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAI/C,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAItD;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,mBAAmB,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IAqBrG;;OAEG;IACH,6BAA6B,CAC3B,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,yBAAyB,EACjC,OAAO,CAAC,EAAE;QAAE,2BAA2B,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,EACnF,sBAAsB,CAAC,EAAE,MAAM,GAC9B,OAAO;IAgCV;;OAEG;WACU,cAAc,CACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACnC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACrC,KAAK,EAAE,QAAQ,GAAG,UAAU,EAC5B,SAAS,SAAQ,GAChB,OAAO,CAAC,IAAI,CAAC;CA6BjB"}

package/dist/processors/observational-memory/built-in-extractors.d.ts

@@ -0,0 +1,15 @@
+import { Extractor } from './extractor.js';
+import type { ObservationConfig, ReflectionConfig, ResolvedObservationConfig } from './types.js';
+export declare function createCurrentTaskExtractor(): Extractor<string>;
+export declare function createSuggestedResponseExtractor(): Extractor<string>;
+export declare function createThreadTitleExtractor(): Extractor<string>;
+interface ComposeExtractorOptions {
+    includeContinuationHints?: boolean;
+    includeThreadTitle?: boolean;
+    userExtractors?: readonly Extractor<any>[];
+}
+export declare function composeExtractors(options: ComposeExtractorOptions): Extractor<any>[];
+export declare function composeObservationExtractors(config: Pick<ResolvedObservationConfig, 'threadTitle'> & Pick<ObservationConfig, 'extract'>): Extractor[];
+export declare function composeReflectionExtractors(config: Pick<ReflectionConfig, 'extract'>): Extractor[];
+export {};
+//# sourceMappingURL=built-in-extractors.d.ts.map

package/dist/processors/observational-memory/built-in-extractors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-in-extractors.d.ts","sourceRoot":"","sources":["../../../src/processors/observational-memory/built-in-extractors.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAyB,MAAM,aAAa,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAmB9F,wBAAgB,0BAA0B,IAAI,SAAS,CAAC,MAAM,CAAC,CAU9D;AAED,wBAAgB,gCAAgC,IAAI,SAAS,CAAC,MAAM,CAAC,CAUpE;AAED,wBAAgB,0BAA0B,IAAI,SAAS,CAAC,MAAM,CAAC,CAU9D;AAED,UAAU,uBAAuB;IAC/B,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,cAAc,CAAC,EAAE,SAAS,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;CAC5C;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,uBAAuB,GAAG,SAAS,CAAC,GAAG,CAAC,EAAE,CAUpF;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,IAAI,CAAC,yBAAyB,EAAE,aAAa,CAAC,GAAG,IAAI,CAAC,iBAAiB,EAAE,SAAS,CAAC,GAC1F,SAAS,EAAE,CAMb;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,GAAG,SAAS,EAAE,CAKlG"}

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

@@ -0,0 +1,74 @@
+/**
+ * Default configuration values matching the spec
+ */
+export declare const OBSERVATIONAL_MEMORY_DEFAULTS: {
+    readonly observation: {
+        readonly model: "google/gemini-2.5-flash";
+        readonly messageTokens: 30000;
+        readonly modelSettings: {
+            readonly temperature: 0.3;
+            readonly maxOutputTokens: 100000;
+        };
+        readonly providerOptions: {
+            readonly google: {
+                readonly thinkingConfig: {
+                    readonly thinkingBudget: 215;
+                };
+            };
+        };
+        readonly maxTokensPerBatch: 10000;
+        readonly bufferTokens: number | undefined;
+        readonly bufferActivation: number | undefined;
+    };
+    readonly reflection: {
+        readonly model: "google/gemini-2.5-flash";
+        readonly observationTokens: 40000;
+        readonly modelSettings: {
+            readonly temperature: 0;
+            readonly maxOutputTokens: 100000;
+        };
+        readonly providerOptions: {
+            readonly google: {
+                readonly thinkingConfig: {
+                    readonly thinkingBudget: 1024;
+                };
+            };
+        };
+        readonly bufferActivation: number | undefined;
+    };
+};
+/**
+ * Continuation hint injected after observations to guide the model's behavior.
+ * Prevents the model from awkwardly acknowledging the memory system or treating
+ * the conversation as new after observed messages are removed.
+ */
+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}`
+ */
+export declare const OBSERVATION_CONTEXT_PROMPT = "The following observations block contains your memory of past conversations with this user.";
+/**
+ * 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.
+ */
+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\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.";
+/**
+ * Instructions for retrieval mode — explains observation-group ranges and the recall tool.
+ * Appended to context when `retrieval` is enabled.
+ *
+ * The content adapts to the retrieval scope:
+ * - `'resource'`: covers routing between `search`, `threads`, and `messages` across
+ *   all of the user's threads, including fallback when search results are unsuitable.
+ * - `'thread'`: covers cursor-based browsing and search within the current thread.
+ *
+ * @param scope - The retrieval scope the recall tool was registered with.
+ * @param customInstructions - Optional application-provided guidance appended after
+ *   the native instructions. Never replaces them.
+ * @param searchEnabled - Whether semantic search (`retrieval: { vector: true }`) is
+ *   available. When false, the guidance only covers \`threads\`/\`messages\` browsing so
+ *   the agent is not steered toward a mode that cannot work.
+ */
+export declare function getRetrievalInstructions(scope?: 'thread' | 'resource', customInstructions?: string, searchEnabled?: boolean): string;
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/processors/observational-memory/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;+BAiBjB,MAAM,GAAG,SAAS;mCACd,MAAM,GAAG,SAAS;;;;;;;;;;;;;;;;mCAiBlB,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,gCAAgC,+oDAQyM,CAAC;AAEvP;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,GAAE,QAAQ,GAAG,UAAuB,EACzC,kBAAkB,CAAC,EAAE,MAAM,EAC3B,aAAa,UAAO,GACnB,MAAM,CA6FR"}

package/dist/processors/observational-memory/date-utils.d.ts

@@ -0,0 +1,41 @@
+import type { MastraDBMessage } from '@mastra/core/agent';
+/**
+ * Date/time utility functions for Observational Memory.
+ * Pure functions for formatting relative timestamps and annotating observations.
+ */
+/**
+ * Format a relative time string like "5 days ago", "2 weeks ago", "today", etc.
+ */
+export declare function formatRelativeTime(date: Date, currentDate: Date): string;
+/**
+ * Format the gap between two dates as a human-readable string.
+ * Returns null for consecutive days (no gap marker needed).
+ */
+export declare function formatGapBetweenDates(prevDate: Date, currDate: Date): string | null;
+/**
+ * Parses a date string like "May 30, 2023", "May 27-28, 2023", "late April 2023", etc.
+ * Returns the parsed Date or null if unparseable.
+ */
+export declare function parseDateFromContent(dateContent: string): Date | null;
+/**
+ * Detects if an observation line indicates future intent (will do, plans to, looking forward to, etc.)
+ */
+export declare function isFutureIntentObservation(line: string): boolean;
+/**
+ * Expand inline estimated dates with relative time.
+ * Matches patterns like "(estimated May 27-28, 2023)" or "(meaning May 30, 2023)"
+ * and expands them to "(meaning May 30, 2023 - which was 3 weeks ago)"
+ */
+export declare function expandInlineEstimatedDates(observations: string, currentDate: Date): string;
+/**
+ * Add relative time annotations to observations.
+ * Transforms "Date: May 15, 2023" headers to "Date: May 15, 2023 (5 days ago)"
+ * and expands inline estimated dates with relative time context.
+ */
+export declare function addRelativeTimeToObservations(observations: string, currentDate: Date): string;
+export declare const MIN_TEMPORAL_GAP_MS: number;
+export declare function formatTemporalGap(diffMs: number): string | null;
+export declare function formatTemporalTimestamp(date: Date): string;
+export declare function getMessagePartTimestamp(msg: MastraDBMessage, position: 'first' | 'last'): number;
+export declare function isTemporalGapMarker(msg: MastraDBMessage): boolean;
+//# sourceMappingURL=date-utils.d.ts.map

package/dist/processors/observational-memory/date-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-utils.d.ts","sourceRoot":"","sources":["../../../src/processors/observational-memory/date-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D;;;GAGG;AAEH;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,GAAG,MAAM,CAwBxE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAmBnF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAuDrE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAa/D;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,GAAG,MAAM,CAkC1F;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,GAAG,MAAM,CA2D7F;AAED,eAAO,MAAM,mBAAmB,QAAiB,CAAC;AAElD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA+C/D;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAU1D;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,eAAe,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAYhG;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAEjE"}

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

@@ -0,0 +1,3 @@
+export declare function omDebug(msg: string): void;
+export declare function omError(msg: string, err?: unknown): void;
+//# sourceMappingURL=debug.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../../src/processors/observational-memory/debug.ts"],"names":[],"mappings":"AAKA,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,QAOlC;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,QAIjD"}