@mastra/memory 0.0.0-error-handler-fix-20251020202607 → 0.0.0-execa-dynamic-import-20260304221256

package/dist/observational-memory-3NJCJNCQ.cjs

@@ -0,0 +1,64 @@
+'use strict';
+
+var chunkQ7VDGOMJ_cjs = require('./chunk-Q7VDGOMJ.cjs');
+
+
+
+Object.defineProperty(exports, "OBSERVATIONAL_MEMORY_DEFAULTS", {
+  enumerable: true,
+  get: function () { return chunkQ7VDGOMJ_cjs.OBSERVATIONAL_MEMORY_DEFAULTS; }
+});
+Object.defineProperty(exports, "OBSERVATION_CONTEXT_INSTRUCTIONS", {
+  enumerable: true,
+  get: function () { return chunkQ7VDGOMJ_cjs.OBSERVATION_CONTEXT_INSTRUCTIONS; }
+});
+Object.defineProperty(exports, "OBSERVATION_CONTEXT_PROMPT", {
+  enumerable: true,
+  get: function () { return chunkQ7VDGOMJ_cjs.OBSERVATION_CONTEXT_PROMPT; }
+});
+Object.defineProperty(exports, "OBSERVATION_CONTINUATION_HINT", {
+  enumerable: true,
+  get: function () { return chunkQ7VDGOMJ_cjs.OBSERVATION_CONTINUATION_HINT; }
+});
+Object.defineProperty(exports, "OBSERVER_SYSTEM_PROMPT", {
+  enumerable: true,
+  get: function () { return chunkQ7VDGOMJ_cjs.OBSERVER_SYSTEM_PROMPT; }
+});
+Object.defineProperty(exports, "ObservationalMemory", {
+  enumerable: true,
+  get: function () { return chunkQ7VDGOMJ_cjs.ObservationalMemory; }
+});
+Object.defineProperty(exports, "TokenCounter", {
+  enumerable: true,
+  get: function () { return chunkQ7VDGOMJ_cjs.TokenCounter; }
+});
+Object.defineProperty(exports, "buildObserverPrompt", {
+  enumerable: true,
+  get: function () { return chunkQ7VDGOMJ_cjs.buildObserverPrompt; }
+});
+Object.defineProperty(exports, "buildObserverSystemPrompt", {
+  enumerable: true,
+  get: function () { return chunkQ7VDGOMJ_cjs.buildObserverSystemPrompt; }
+});
+Object.defineProperty(exports, "extractCurrentTask", {
+  enumerable: true,
+  get: function () { return chunkQ7VDGOMJ_cjs.extractCurrentTask; }
+});
+Object.defineProperty(exports, "formatMessagesForObserver", {
+  enumerable: true,
+  get: function () { return chunkQ7VDGOMJ_cjs.formatMessagesForObserver; }
+});
+Object.defineProperty(exports, "hasCurrentTaskSection", {
+  enumerable: true,
+  get: function () { return chunkQ7VDGOMJ_cjs.hasCurrentTaskSection; }
+});
+Object.defineProperty(exports, "optimizeObservationsForContext", {
+  enumerable: true,
+  get: function () { return chunkQ7VDGOMJ_cjs.optimizeObservationsForContext; }
+});
+Object.defineProperty(exports, "parseObserverOutput", {
+  enumerable: true,
+  get: function () { return chunkQ7VDGOMJ_cjs.parseObserverOutput; }
+});
+//# sourceMappingURL=observational-memory-3NJCJNCQ.cjs.map
+//# sourceMappingURL=observational-memory-3NJCJNCQ.cjs.map

package/dist/observational-memory-3NJCJNCQ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"observational-memory-3NJCJNCQ.cjs"}

package/dist/observational-memory-SKDDNPFW.js

@@ -0,0 +1,3 @@
+export { OBSERVATIONAL_MEMORY_DEFAULTS, OBSERVATION_CONTEXT_INSTRUCTIONS, OBSERVATION_CONTEXT_PROMPT, OBSERVATION_CONTINUATION_HINT, OBSERVER_SYSTEM_PROMPT, ObservationalMemory, TokenCounter, buildObserverPrompt, buildObserverSystemPrompt, extractCurrentTask, formatMessagesForObserver, hasCurrentTaskSection, optimizeObservationsForContext, parseObserverOutput } from './chunk-33ZIVK5L.js';
+//# sourceMappingURL=observational-memory-SKDDNPFW.js.map
+//# sourceMappingURL=observational-memory-SKDDNPFW.js.map

package/dist/observational-memory-SKDDNPFW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"observational-memory-SKDDNPFW.js"}

package/dist/processors/index.cjs

@@ -1,165 +1,64 @@
 'use strict';
 
-var memory = require('@mastra/core/memory');
-var lite = require('js-tiktoken/lite');
-var o200k_base = require('js-tiktoken/ranks/o200k_base');
+var chunkQ7VDGOMJ_cjs = require('../chunk-Q7VDGOMJ.cjs');
 
-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;
+Object.defineProperty(exports, "OBSERVATIONAL_MEMORY_DEFAULTS", {
+  enumerable: true,
+  get: function () { return chunkQ7VDGOMJ_cjs.OBSERVATIONAL_MEMORY_DEFAULTS; }
+});
+Object.defineProperty(exports, "OBSERVATION_CONTEXT_INSTRUCTIONS", {
+  enumerable: true,
+  get: function () { return chunkQ7VDGOMJ_cjs.OBSERVATION_CONTEXT_INSTRUCTIONS; }
+});
+Object.defineProperty(exports, "OBSERVATION_CONTEXT_PROMPT", {
+  enumerable: true,
+  get: function () { return chunkQ7VDGOMJ_cjs.OBSERVATION_CONTEXT_PROMPT; }
+});
+Object.defineProperty(exports, "OBSERVATION_CONTINUATION_HINT", {
+  enumerable: true,
+  get: function () { return chunkQ7VDGOMJ_cjs.OBSERVATION_CONTINUATION_HINT; }
+});
+Object.defineProperty(exports, "OBSERVER_SYSTEM_PROMPT", {
+  enumerable: true,
+  get: function () { return chunkQ7VDGOMJ_cjs.OBSERVER_SYSTEM_PROMPT; }
+});
+Object.defineProperty(exports, "ObservationalMemory", {
+  enumerable: true,
+  get: function () { return chunkQ7VDGOMJ_cjs.ObservationalMemory; }
+});
+Object.defineProperty(exports, "TokenCounter", {
+  enumerable: true,
+  get: function () { return chunkQ7VDGOMJ_cjs.TokenCounter; }
+});
+Object.defineProperty(exports, "buildObserverPrompt", {
+  enumerable: true,
+  get: function () { return chunkQ7VDGOMJ_cjs.buildObserverPrompt; }
+});
+Object.defineProperty(exports, "buildObserverSystemPrompt", {
+  enumerable: true,
+  get: function () { return chunkQ7VDGOMJ_cjs.buildObserverSystemPrompt; }
+});
+Object.defineProperty(exports, "extractCurrentTask", {
+  enumerable: true,
+  get: function () { return chunkQ7VDGOMJ_cjs.extractCurrentTask; }
+});
+Object.defineProperty(exports, "formatMessagesForObserver", {
+  enumerable: true,
+  get: function () { return chunkQ7VDGOMJ_cjs.formatMessagesForObserver; }
+});
+Object.defineProperty(exports, "hasCurrentTaskSection", {
+  enumerable: true,
+  get: function () { return chunkQ7VDGOMJ_cjs.hasCurrentTaskSection; }
+});
+Object.defineProperty(exports, "optimizeObservationsForContext", {
+  enumerable: true,
+  get: function () { return chunkQ7VDGOMJ_cjs.optimizeObservationsForContext; }
+});
+Object.defineProperty(exports, "parseObserverOutput", {
+  enumerable: true,
+  get: function () { return chunkQ7VDGOMJ_cjs.parseObserverOutput; }
+});
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/processors/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/processors/token-limiter.ts","../../src/processors/tool-call-filter.ts"],"names":["MemoryProcessor","Tiktoken","o200k_base"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { CoreMessage } from '@mastra/core/llm';\nimport { MemoryProcessor } from '@mastra/core/memory';\nimport type { MemoryProcessorOpts } from '@mastra/core/memory';\n\nimport { Tiktoken } from 'js-tiktoken/lite';\nimport type { TiktokenBPE } from 'js-tiktoken/lite';\nimport o200k_base from 'js-tiktoken/ranks/o200k_base';\n\n/**\n * Configuration options for TokenLimiter\n */\ninterface TokenLimiterOptions {\n  /** Maximum number of tokens to allow */\n  limit: number;\n  /** Optional encoding to use (defaults to o200k_base which is used by gpt-4o) */\n  encoding?: TiktokenBPE;\n}\n\n/**\n * Limits the total number of tokens in the messages.\n * Uses js-tiktoken with o200k_base encoding by default for accurate token counting with modern models.\n */\nexport class TokenLimiter extends MemoryProcessor {\n  private encoder: Tiktoken;\n  private maxTokens: number;\n\n  // Token overheads per OpenAI's documentation\n  // See: https://cookbook.openai.com/examples/how_to_count_tokens_with_tiktoken#6-counting-tokens-for-chat-completions-api-calls\n  // Every message follows <|start|>{role/name}\\n{content}<|end|>\n  public TOKENS_PER_MESSAGE = 3.8; // tokens added for each message (start & end tokens)\n  public TOKENS_PER_CONVERSATION = 24; // fixed overhead for the conversation\n\n  /**\n   * Create a token limiter for messages.\n   * @param options Either a number (token limit) or a configuration object\n   */\n  constructor(options: number | TokenLimiterOptions) {\n    super({\n      name: 'TokenLimiter',\n    });\n\n    if (typeof options === 'number') {\n      // Simple number format - just the token limit with default encoding\n      this.maxTokens = options;\n      this.encoder = new Tiktoken(o200k_base);\n    } else {\n      // Object format with limit and optional encoding\n      this.maxTokens = options.limit;\n      this.encoder = new Tiktoken(options.encoding || o200k_base);\n    }\n  }\n\n  process(\n    messages: CoreMessage[],\n    { systemMessage, memorySystemMessage, newMessages }: MemoryProcessorOpts = {},\n  ): CoreMessage[] {\n    // Messages are already chronologically ordered - take most recent ones up to the token limit\n    let totalTokens = 0;\n\n    // Start with the conversation overhead\n    totalTokens += this.TOKENS_PER_CONVERSATION;\n\n    if (systemMessage) {\n      totalTokens += this.countTokens(systemMessage);\n      totalTokens += this.TOKENS_PER_MESSAGE; // Add message overhead for system message\n    }\n\n    if (memorySystemMessage) {\n      totalTokens += this.countTokens(memorySystemMessage);\n      totalTokens += this.TOKENS_PER_MESSAGE; // Add message overhead for memory system message\n    }\n\n    const allMessages = [...messages, ...(newMessages || [])];\n\n    const result: CoreMessage[] = [];\n\n    // Process messages in reverse (newest first) so that we stop estimating tokens on old messages. Once we get to our limit of tokens there's no reason to keep processing older messages\n    for (let i = allMessages.length - 1; i >= 0; i--) {\n      const message = allMessages[i];\n\n      // Skip undefined messages (shouldn't happen, but TypeScript is concerned)\n      if (!message) continue;\n\n      const messageTokens = this.countTokens(message);\n\n      if (totalTokens + messageTokens <= this.maxTokens) {\n        // Insert at the beginning to maintain chronological order, but only if it's not a new message\n        if (i < messages.length) {\n          // less than messages.length because we're iterating in reverse. If the index is greater than messages.length it's a new message\n          result.unshift(message);\n        }\n        totalTokens += messageTokens;\n      } else {\n        this.logger.info(\n          `filtering ${allMessages.length - result.length}/${allMessages.length} messages, token limit of ${this.maxTokens} exceeded`,\n        );\n        // If we can't fit the message, we stop\n        break;\n      }\n    }\n\n    return result;\n  }\n\n  public countTokens(message: string | CoreMessage): number {\n    if (typeof message === `string`) {\n      return this.encoder.encode(message).length;\n    }\n\n    let tokenString = message.role;\n    let overhead = 0;\n\n    if (typeof message.content === 'string' && message.content) {\n      tokenString += message.content;\n    } else if (Array.isArray(message.content)) {\n      // Calculate tokens for each content part\n      for (const part of message.content) {\n        if (part.type === 'text') {\n          tokenString += part.text;\n        } else if (part.type === 'tool-call' || part.type === `tool-result`) {\n          if (`args` in part && part.args && part.type === `tool-call`) {\n            tokenString += part.toolName as any;\n            if (typeof part.args === 'string') {\n              tokenString += part.args;\n            } else {\n              tokenString += JSON.stringify(part.args);\n              // minus some tokens for JSON\n              overhead -= 12;\n            }\n          }\n          // Token cost for result if present\n          if (`result` in part && part.result !== undefined && part.type === `tool-result`) {\n            if (typeof part.result === 'string') {\n              tokenString += part.result;\n            } else {\n              tokenString += JSON.stringify(part.result);\n              // minus some tokens for JSON\n              overhead -= 12;\n            }\n          }\n        } else {\n          tokenString += JSON.stringify(part);\n        }\n      }\n    }\n\n    if (\n      typeof message.content === `string` ||\n      // if the message included non-tool parts, add our message overhead\n      message.content.some(p => p.type !== `tool-call` && p.type !== `tool-result`)\n    ) {\n      // Ensure we account for message formatting tokens\n      // See: https://cookbook.openai.com/examples/how_to_count_tokens_with_tiktoken#6-counting-tokens-for-chat-completions-api-calls\n      overhead += this.TOKENS_PER_MESSAGE;\n    }\n\n    return this.encoder.encode(tokenString).length + overhead;\n  }\n}\n","import type { CoreMessage } from '@mastra/core/llm';\nimport { MemoryProcessor } from '@mastra/core/memory';\n\n/**\n * Filters out tool calls and results from messages.\n * By default (with no arguments), excludes all tool calls and their results.\n * Can be configured to exclude only specific tools by name.\n */\nexport class ToolCallFilter extends MemoryProcessor {\n  private exclude: string[] | 'all';\n\n  /**\n   * Create a filter for tool calls and results.\n   * @param options Configuration options\n   * @param options.exclude List of specific tool names to exclude. If not provided, all tool calls are excluded.\n   */\n  constructor(options: { exclude?: string[] } = {}) {\n    super({ name: 'ToolCallFilter' });\n    // If no options or exclude is provided, exclude all tools\n    if (!options || !options.exclude) {\n      this.exclude = 'all'; // Exclude all tools\n    } else {\n      // Exclude specific tools\n      this.exclude = Array.isArray(options.exclude) ? options.exclude : [];\n    }\n  }\n\n  process(messages: CoreMessage[]): CoreMessage[] {\n    // Case 1: Exclude all tool calls and tool results\n    if (this.exclude === 'all') {\n      return messages.filter(message => {\n        if (Array.isArray(message.content)) {\n          return !message.content.some(part => part.type === 'tool-call' || part.type === 'tool-result');\n        }\n        return true;\n      });\n    }\n\n    // Case 2: Exclude specific tools by name\n    if (this.exclude.length > 0) {\n      // Single pass approach - track excluded tool call IDs while filtering\n      const excludedToolCallIds = new Set<string>();\n\n      return messages.filter(message => {\n        if (!Array.isArray(message.content)) return true;\n\n        // For assistant messages, check for excluded tool calls and track their IDs\n        if (message.role === 'assistant') {\n          let shouldExclude = false;\n\n          for (const part of message.content) {\n            if (part.type === 'tool-call' && this.exclude.includes(part.toolName)) {\n              excludedToolCallIds.add(part.toolCallId);\n              shouldExclude = true;\n            }\n          }\n\n          return !shouldExclude;\n        }\n\n        // For tool messages, filter out results for excluded tool calls\n        if (message.role === 'tool') {\n          const shouldExclude = message.content.some(\n            part => part.type === 'tool-result' && excludedToolCallIds.has(part.toolCallId),\n          );\n\n          return !shouldExclude;\n        }\n\n        return true;\n      });\n    }\n\n    // Case 3: Empty exclude array, return original messages\n    return messages;\n  }\n}\n"]}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

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,3 @@
-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 };
+export { OBSERVATIONAL_MEMORY_DEFAULTS, OBSERVATION_CONTEXT_INSTRUCTIONS, OBSERVATION_CONTEXT_PROMPT, OBSERVATION_CONTINUATION_HINT, OBSERVER_SYSTEM_PROMPT, ObservationalMemory, TokenCounter, buildObserverPrompt, buildObserverSystemPrompt, extractCurrentTask, formatMessagesForObserver, hasCurrentTaskSection, optimizeObservationsForContext, parseObserverOutput } from '../chunk-33ZIVK5L.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/processors/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/processors/token-limiter.ts","../../src/processors/tool-call-filter.ts"],"names":["MemoryProcessor"],"mappings":";;;;;AAsBO,IAAM,YAAA,GAAN,cAA2B,eAAA,CAAgB;AAAA,EACxC,OAAA;AAAA,EACA,SAAA;AAAA;AAAA;AAAA;AAAA,EAKD,kBAAA,GAAqB,GAAA;AAAA;AAAA,EACrB,uBAAA,GAA0B,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMjC,YAAY,OAAA,EAAuC;AACjD,IAAA,KAAA,CAAM;AAAA,MACJ,IAAA,EAAM;AAAA,KACP,CAAA;AAED,IAAA,IAAI,OAAO,YAAY,QAAA,EAAU;AAE/B,MAAA,IAAA,CAAK,SAAA,GAAY,OAAA;AACjB,MAAA,IAAA,CAAK,OAAA,GAAU,IAAI,QAAA,CAAS,UAAU,CAAA;AAAA,IACxC,CAAA,MAAO;AAEL,MAAA,IAAA,CAAK,YAAY,OAAA,CAAQ,KAAA;AACzB,MAAA,IAAA,CAAK,OAAA,GAAU,IAAI,QAAA,CAAS,OAAA,CAAQ,YAAY,UAAU,CAAA;AAAA,IAC5D;AAAA,EACF;AAAA,EAEA,OAAA,CACE,UACA,EAAE,aAAA,EAAe,qBAAqB,WAAA,EAAY,GAAyB,EAAC,EAC7D;AAEf,IAAA,IAAI,WAAA,GAAc,CAAA;AAGlB,IAAA,WAAA,IAAe,IAAA,CAAK,uBAAA;AAEpB,IAAA,IAAI,aAAA,EAAe;AACjB,MAAA,WAAA,IAAe,IAAA,CAAK,YAAY,aAAa,CAAA;AAC7C,MAAA,WAAA,IAAe,IAAA,CAAK,kBAAA;AAAA,IACtB;AAEA,IAAA,IAAI,mBAAA,EAAqB;AACvB,MAAA,WAAA,IAAe,IAAA,CAAK,YAAY,mBAAmB,CAAA;AACnD,MAAA,WAAA,IAAe,IAAA,CAAK,kBAAA;AAAA,IACtB;AAEA,IAAA,MAAM,cAAc,CAAC,GAAG,UAAU,GAAI,WAAA,IAAe,EAAG,CAAA;AAExD,IAAA,MAAM,SAAwB,EAAC;AAG/B,IAAA,KAAA,IAAS,IAAI,WAAA,CAAY,MAAA,GAAS,CAAA,EAAG,CAAA,IAAK,GAAG,CAAA,EAAA,EAAK;AAChD,MAAA,MAAM,OAAA,GAAU,YAAY,CAAC,CAAA;AAG7B,MAAA,IAAI,CAAC,OAAA,EAAS;AAEd,MAAA,MAAM,aAAA,GAAgB,IAAA,CAAK,WAAA,CAAY,OAAO,CAAA;AAE9C,MAAA,IAAI,WAAA,GAAc,aAAA,IAAiB,IAAA,CAAK,SAAA,EAAW;AAEjD,QAAA,IAAI,CAAA,GAAI,SAAS,MAAA,EAAQ;AAEvB,UAAA,MAAA,CAAO,QAAQ,OAAO,CAAA;AAAA,QACxB;AACA,QAAA,WAAA,IAAe,aAAA;AAAA,MACjB,CAAA,MAAO;AACL,QAAA,IAAA,CAAK,MAAA,CAAO,IAAA;AAAA,UACV,CAAA,UAAA,EAAa,WAAA,CAAY,MAAA,GAAS,MAAA,CAAO,MAAM,IAAI,WAAA,CAAY,MAAM,CAAA,0BAAA,EAA6B,IAAA,CAAK,SAAS,CAAA,SAAA;AAAA,SAClH;AAEA,QAAA;AAAA,MACF;AAAA,IACF;AAEA,IAAA,OAAO,MAAA;AAAA,EACT;AAAA,EAEO,YAAY,OAAA,EAAuC;AACxD,IAAA,IAAI,OAAO,YAAY,CAAA,MAAA,CAAA,EAAU;AAC/B,MAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,MAAA,CAAO,OAAO,CAAA,CAAE,MAAA;AAAA,IACtC;AAEA,IAAA,IAAI,cAAc,OAAA,CAAQ,IAAA;AAC1B,IAAA,IAAI,QAAA,GAAW,CAAA;AAEf,IAAA,IAAI,OAAO,OAAA,CAAQ,OAAA,KAAY,QAAA,IAAY,QAAQ,OAAA,EAAS;AAC1D,MAAA,WAAA,IAAe,OAAA,CAAQ,OAAA;AAAA,IACzB,CAAA,MAAA,IAAW,KAAA,CAAM,OAAA,CAAQ,OAAA,CAAQ,OAAO,CAAA,EAAG;AAEzC,MAAA,KAAA,MAAW,IAAA,IAAQ,QAAQ,OAAA,EAAS;AAClC,QAAA,IAAI,IAAA,CAAK,SAAS,MAAA,EAAQ;AACxB,UAAA,WAAA,IAAe,IAAA,CAAK,IAAA;AAAA,QACtB,WAAW,IAAA,CAAK,IAAA,KAAS,WAAA,IAAe,IAAA,CAAK,SAAS,CAAA,WAAA,CAAA,EAAe;AACnE,UAAA,IAAI,UAAU,IAAA,IAAQ,IAAA,CAAK,IAAA,IAAQ,IAAA,CAAK,SAAS,CAAA,SAAA,CAAA,EAAa;AAC5D,YAAA,WAAA,IAAe,IAAA,CAAK,QAAA;AACpB,YAAA,IAAI,OAAO,IAAA,CAAK,IAAA,KAAS,QAAA,EAAU;AACjC,cAAA,WAAA,IAAe,IAAA,CAAK,IAAA;AAAA,YACtB,CAAA,MAAO;AACL,cAAA,WAAA,IAAe,IAAA,CAAK,SAAA,CAAU,IAAA,CAAK,IAAI,CAAA;AAEvC,cAAA,QAAA,IAAY,EAAA;AAAA,YACd;AAAA,UACF;AAEA,UAAA,IAAI,YAAY,IAAA,IAAQ,IAAA,CAAK,WAAW,MAAA,IAAa,IAAA,CAAK,SAAS,CAAA,WAAA,CAAA,EAAe;AAChF,YAAA,IAAI,OAAO,IAAA,CAAK,MAAA,KAAW,QAAA,EAAU;AACnC,cAAA,WAAA,IAAe,IAAA,CAAK,MAAA;AAAA,YACtB,CAAA,MAAO;AACL,cAAA,WAAA,IAAe,IAAA,CAAK,SAAA,CAAU,IAAA,CAAK,MAAM,CAAA;AAEzC,cAAA,QAAA,IAAY,EAAA;AAAA,YACd;AAAA,UACF;AAAA,QACF,CAAA,MAAO;AACL,UAAA,WAAA,IAAe,IAAA,CAAK,UAAU,IAAI,CAAA;AAAA,QACpC;AAAA,MACF;AAAA,IACF;AAEA,IAAA,IACE,OAAO,QAAQ,OAAA,KAAY,CAAA,MAAA,CAAA;AAAA,IAE3B,OAAA,CAAQ,OAAA,CAAQ,IAAA,CAAK,CAAA,CAAA,KAAK,CAAA,CAAE,SAAS,CAAA,SAAA,CAAA,IAAe,CAAA,CAAE,IAAA,KAAS,CAAA,WAAA,CAAa,CAAA,EAC5E;AAGA,MAAA,QAAA,IAAY,IAAA,CAAK,kBAAA;AAAA,IACnB;AAEA,IAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,MAAA,CAAO,WAAW,EAAE,MAAA,GAAS,QAAA;AAAA,EACnD;AACF;ACtJO,IAAM,cAAA,GAAN,cAA6BA,eAAAA,CAAgB;AAAA,EAC1C,OAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOR,WAAA,CAAY,OAAA,GAAkC,EAAC,EAAG;AAChD,IAAA,KAAA,CAAM,EAAE,IAAA,EAAM,gBAAA,EAAkB,CAAA;AAEhC,IAAA,IAAI,CAAC,OAAA,IAAW,CAAC,OAAA,CAAQ,OAAA,EAAS;AAChC,MAAA,IAAA,CAAK,OAAA,GAAU,KAAA;AAAA,IACjB,CAAA,MAAO;AAEL,MAAA,IAAA,CAAK,OAAA,GAAU,MAAM,OAAA,CAAQ,OAAA,CAAQ,OAAO,CAAA,GAAI,OAAA,CAAQ,UAAU,EAAC;AAAA,IACrE;AAAA,EACF;AAAA,EAEA,QAAQ,QAAA,EAAwC;AAE9C,IAAA,IAAI,IAAA,CAAK,YAAY,KAAA,EAAO;AAC1B,MAAA,OAAO,QAAA,CAAS,OAAO,CAAA,OAAA,KAAW;AAChC,QAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,OAAA,CAAQ,OAAO,CAAA,EAAG;AAClC,UAAA,OAAO,CAAC,OAAA,CAAQ,OAAA,CAAQ,IAAA,CAAK,CAAA,IAAA,KAAQ,KAAK,IAAA,KAAS,WAAA,IAAe,IAAA,CAAK,IAAA,KAAS,aAAa,CAAA;AAAA,QAC/F;AACA,QAAA,OAAO,IAAA;AAAA,MACT,CAAC,CAAA;AAAA,IACH;AAGA,IAAA,IAAI,IAAA,CAAK,OAAA,CAAQ,MAAA,GAAS,CAAA,EAAG;AAE3B,MAAA,MAAM,mBAAA,uBAA0B,GAAA,EAAY;AAE5C,MAAA,OAAO,QAAA,CAAS,OAAO,CAAA,OAAA,KAAW;AAChC,QAAA,IAAI,CAAC,KAAA,CAAM,OAAA,CAAQ,OAAA,CAAQ,OAAO,GAAG,OAAO,IAAA;AAG5C,QAAA,IAAI,OAAA,CAAQ,SAAS,WAAA,EAAa;AAChC,UAAA,IAAI,aAAA,GAAgB,KAAA;AAEpB,UAAA,KAAA,MAAW,IAAA,IAAQ,QAAQ,OAAA,EAAS;AAClC,YAAA,IAAI,IAAA,CAAK,SAAS,WAAA,IAAe,IAAA,CAAK,QAAQ,QAAA,CAAS,IAAA,CAAK,QAAQ,CAAA,EAAG;AACrE,cAAA,mBAAA,CAAoB,GAAA,CAAI,KAAK,UAAU,CAAA;AACvC,cAAA,aAAA,GAAgB,IAAA;AAAA,YAClB;AAAA,UACF;AAEA,UAAA,OAAO,CAAC,aAAA;AAAA,QACV;AAGA,QAAA,IAAI,OAAA,CAAQ,SAAS,MAAA,EAAQ;AAC3B,UAAA,MAAM,aAAA,GAAgB,QAAQ,OAAA,CAAQ,IAAA;AAAA,YACpC,UAAQ,IAAA,CAAK,IAAA,KAAS,iBAAiB,mBAAA,CAAoB,GAAA,CAAI,KAAK,UAAU;AAAA,WAChF;AAEA,UAAA,OAAO,CAAC,aAAA;AAAA,QACV;AAEA,QAAA,OAAO,IAAA;AAAA,MACT,CAAC,CAAA;AAAA,IACH;AAGA,IAAA,OAAO,QAAA;AAAA,EACT;AACF","file":"index.js","sourcesContent":["import type { CoreMessage } from '@mastra/core/llm';\nimport { MemoryProcessor } from '@mastra/core/memory';\nimport type { MemoryProcessorOpts } from '@mastra/core/memory';\n\nimport { Tiktoken } from 'js-tiktoken/lite';\nimport type { TiktokenBPE } from 'js-tiktoken/lite';\nimport o200k_base from 'js-tiktoken/ranks/o200k_base';\n\n/**\n * Configuration options for TokenLimiter\n */\ninterface TokenLimiterOptions {\n  /** Maximum number of tokens to allow */\n  limit: number;\n  /** Optional encoding to use (defaults to o200k_base which is used by gpt-4o) */\n  encoding?: TiktokenBPE;\n}\n\n/**\n * Limits the total number of tokens in the messages.\n * Uses js-tiktoken with o200k_base encoding by default for accurate token counting with modern models.\n */\nexport class TokenLimiter extends MemoryProcessor {\n  private encoder: Tiktoken;\n  private maxTokens: number;\n\n  // Token overheads per OpenAI's documentation\n  // See: https://cookbook.openai.com/examples/how_to_count_tokens_with_tiktoken#6-counting-tokens-for-chat-completions-api-calls\n  // Every message follows <|start|>{role/name}\\n{content}<|end|>\n  public TOKENS_PER_MESSAGE = 3.8; // tokens added for each message (start & end tokens)\n  public TOKENS_PER_CONVERSATION = 24; // fixed overhead for the conversation\n\n  /**\n   * Create a token limiter for messages.\n   * @param options Either a number (token limit) or a configuration object\n   */\n  constructor(options: number | TokenLimiterOptions) {\n    super({\n      name: 'TokenLimiter',\n    });\n\n    if (typeof options === 'number') {\n      // Simple number format - just the token limit with default encoding\n      this.maxTokens = options;\n      this.encoder = new Tiktoken(o200k_base);\n    } else {\n      // Object format with limit and optional encoding\n      this.maxTokens = options.limit;\n      this.encoder = new Tiktoken(options.encoding || o200k_base);\n    }\n  }\n\n  process(\n    messages: CoreMessage[],\n    { systemMessage, memorySystemMessage, newMessages }: MemoryProcessorOpts = {},\n  ): CoreMessage[] {\n    // Messages are already chronologically ordered - take most recent ones up to the token limit\n    let totalTokens = 0;\n\n    // Start with the conversation overhead\n    totalTokens += this.TOKENS_PER_CONVERSATION;\n\n    if (systemMessage) {\n      totalTokens += this.countTokens(systemMessage);\n      totalTokens += this.TOKENS_PER_MESSAGE; // Add message overhead for system message\n    }\n\n    if (memorySystemMessage) {\n      totalTokens += this.countTokens(memorySystemMessage);\n      totalTokens += this.TOKENS_PER_MESSAGE; // Add message overhead for memory system message\n    }\n\n    const allMessages = [...messages, ...(newMessages || [])];\n\n    const result: CoreMessage[] = [];\n\n    // Process messages in reverse (newest first) so that we stop estimating tokens on old messages. Once we get to our limit of tokens there's no reason to keep processing older messages\n    for (let i = allMessages.length - 1; i >= 0; i--) {\n      const message = allMessages[i];\n\n      // Skip undefined messages (shouldn't happen, but TypeScript is concerned)\n      if (!message) continue;\n\n      const messageTokens = this.countTokens(message);\n\n      if (totalTokens + messageTokens <= this.maxTokens) {\n        // Insert at the beginning to maintain chronological order, but only if it's not a new message\n        if (i < messages.length) {\n          // less than messages.length because we're iterating in reverse. If the index is greater than messages.length it's a new message\n          result.unshift(message);\n        }\n        totalTokens += messageTokens;\n      } else {\n        this.logger.info(\n          `filtering ${allMessages.length - result.length}/${allMessages.length} messages, token limit of ${this.maxTokens} exceeded`,\n        );\n        // If we can't fit the message, we stop\n        break;\n      }\n    }\n\n    return result;\n  }\n\n  public countTokens(message: string | CoreMessage): number {\n    if (typeof message === `string`) {\n      return this.encoder.encode(message).length;\n    }\n\n    let tokenString = message.role;\n    let overhead = 0;\n\n    if (typeof message.content === 'string' && message.content) {\n      tokenString += message.content;\n    } else if (Array.isArray(message.content)) {\n      // Calculate tokens for each content part\n      for (const part of message.content) {\n        if (part.type === 'text') {\n          tokenString += part.text;\n        } else if (part.type === 'tool-call' || part.type === `tool-result`) {\n          if (`args` in part && part.args && part.type === `tool-call`) {\n            tokenString += part.toolName as any;\n            if (typeof part.args === 'string') {\n              tokenString += part.args;\n            } else {\n              tokenString += JSON.stringify(part.args);\n              // minus some tokens for JSON\n              overhead -= 12;\n            }\n          }\n          // Token cost for result if present\n          if (`result` in part && part.result !== undefined && part.type === `tool-result`) {\n            if (typeof part.result === 'string') {\n              tokenString += part.result;\n            } else {\n              tokenString += JSON.stringify(part.result);\n              // minus some tokens for JSON\n              overhead -= 12;\n            }\n          }\n        } else {\n          tokenString += JSON.stringify(part);\n        }\n      }\n    }\n\n    if (\n      typeof message.content === `string` ||\n      // if the message included non-tool parts, add our message overhead\n      message.content.some(p => p.type !== `tool-call` && p.type !== `tool-result`)\n    ) {\n      // Ensure we account for message formatting tokens\n      // See: https://cookbook.openai.com/examples/how_to_count_tokens_with_tiktoken#6-counting-tokens-for-chat-completions-api-calls\n      overhead += this.TOKENS_PER_MESSAGE;\n    }\n\n    return this.encoder.encode(tokenString).length + overhead;\n  }\n}\n","import type { CoreMessage } from '@mastra/core/llm';\nimport { MemoryProcessor } from '@mastra/core/memory';\n\n/**\n * Filters out tool calls and results from messages.\n * By default (with no arguments), excludes all tool calls and their results.\n * Can be configured to exclude only specific tools by name.\n */\nexport class ToolCallFilter extends MemoryProcessor {\n  private exclude: string[] | 'all';\n\n  /**\n   * Create a filter for tool calls and results.\n   * @param options Configuration options\n   * @param options.exclude List of specific tool names to exclude. If not provided, all tool calls are excluded.\n   */\n  constructor(options: { exclude?: string[] } = {}) {\n    super({ name: 'ToolCallFilter' });\n    // If no options or exclude is provided, exclude all tools\n    if (!options || !options.exclude) {\n      this.exclude = 'all'; // Exclude all tools\n    } else {\n      // Exclude specific tools\n      this.exclude = Array.isArray(options.exclude) ? options.exclude : [];\n    }\n  }\n\n  process(messages: CoreMessage[]): CoreMessage[] {\n    // Case 1: Exclude all tool calls and tool results\n    if (this.exclude === 'all') {\n      return messages.filter(message => {\n        if (Array.isArray(message.content)) {\n          return !message.content.some(part => part.type === 'tool-call' || part.type === 'tool-result');\n        }\n        return true;\n      });\n    }\n\n    // Case 2: Exclude specific tools by name\n    if (this.exclude.length > 0) {\n      // Single pass approach - track excluded tool call IDs while filtering\n      const excludedToolCallIds = new Set<string>();\n\n      return messages.filter(message => {\n        if (!Array.isArray(message.content)) return true;\n\n        // For assistant messages, check for excluded tool calls and track their IDs\n        if (message.role === 'assistant') {\n          let shouldExclude = false;\n\n          for (const part of message.content) {\n            if (part.type === 'tool-call' && this.exclude.includes(part.toolName)) {\n              excludedToolCallIds.add(part.toolCallId);\n              shouldExclude = true;\n            }\n          }\n\n          return !shouldExclude;\n        }\n\n        // For tool messages, filter out results for excluded tool calls\n        if (message.role === 'tool') {\n          const shouldExclude = message.content.some(\n            part => part.type === 'tool-result' && excludedToolCallIds.has(part.toolCallId),\n          );\n\n          return !shouldExclude;\n        }\n\n        return true;\n      });\n    }\n\n    // Case 3: Empty exclude array, return original messages\n    return messages;\n  }\n}\n"]}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

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

@@ -0,0 +1,35 @@
+/**
+ * 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;
+//# 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;;;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"}

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

@@ -0,0 +1,18 @@
+/**
+ * Observational Memory (OM)
+ *
+ * A memory system that keeps agents performant across long conversations by:
+ * 1. Automatically compressing turn-based message history into structured observations
+ * 2. Reflecting on observations when they grow too large
+ *
+ * Three-agent architecture:
+ * - Actor: The main agent, sees observations + recent unobserved messages
+ * - Observer: Extracts observations when history exceeds threshold
+ * - Reflector: Condenses observations when they exceed threshold
+ */
+export { ObservationalMemory, OBSERVATIONAL_MEMORY_DEFAULTS, OBSERVATION_CONTINUATION_HINT, OBSERVATION_CONTEXT_PROMPT, OBSERVATION_CONTEXT_INSTRUCTIONS, type ObservationalMemoryConfig, type ObservationDebugEvent, type ObserveHooks, } from './observational-memory.js';
+export type { ObservationConfig, ReflectionConfig, ObserverResult, ReflectorResult, DataOmBufferingStartPart, DataOmBufferingEndPart, DataOmBufferingFailedPart, DataOmBufferingPart, DataOmActivationPart, DataOmPart, } from './types.js';
+export { OBSERVER_SYSTEM_PROMPT, buildObserverSystemPrompt, buildObserverPrompt, parseObserverOutput, optimizeObservationsForContext, formatMessagesForObserver, hasCurrentTaskSection, extractCurrentTask, type ObserverResult as ObserverAgentResult, } from './observer-agent.js';
+export type { ObservationalMemoryRecord, ObservationalMemoryScope, ObservationalMemoryOriginType, CreateObservationalMemoryInput, UpdateActiveObservationsInput, UpdateBufferedObservationsInput, CreateReflectionGenerationInput, } from '@mastra/core/storage';
+export { TokenCounter } from './token-counter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/processors/observational-memory/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EACL,mBAAmB,EACnB,6BAA6B,EAC7B,6BAA6B,EAC7B,0BAA0B,EAC1B,gCAAgC,EAChC,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,YAAY,GAClB,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,eAAe,EAEf,wBAAwB,EACxB,sBAAsB,EACtB,yBAAyB,EACzB,mBAAmB,EAEnB,oBAAoB,EACpB,UAAU,GACX,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,EACnB,8BAA8B,EAC9B,yBAAyB,EACzB,qBAAqB,EACrB,kBAAkB,EAClB,KAAK,cAAc,IAAI,mBAAmB,GAC3C,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,yBAAyB,EACzB,wBAAwB,EACxB,6BAA6B,EAC7B,8BAA8B,EAC9B,6BAA6B,EAC7B,+BAA+B,EAC/B,+BAA+B,GAChC,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}