@mastra/memory 1.5.1 → 1.5.2

package/dist/docs/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: mastra-memory
+description: Documentation for @mastra/memory. Use when working with @mastra/memory APIs, configuration, or implementation.
+metadata:
+  package: "@mastra/memory"
+  version: "1.5.2"
+---
+
+## When to use
+
+Use this skill whenever you are working with @mastra/memory to obtain the domain-specific knowledge.
+
+## How to use
+
+Read the individual reference documents for detailed explanations and code examples.
+
+### Docs
+
+- [Agent Approval](references/docs-agents-agent-approval.md) - Learn how to require approvals, suspend tool execution, and automatically resume suspended tools while keeping humans in control of agent workflows.
+- [Agent Memory](references/docs-agents-agent-memory.md) - Learn how to add memory to agents to store message history and maintain context across interactions.
+- [Network Approval](references/docs-agents-network-approval.md) - Learn how to require approvals, suspend execution, and resume suspended networks while keeping humans in control of agent network workflows.
+- [Agent Networks](references/docs-agents-networks.md) - Learn how to coordinate multiple agents, workflows, and tools using agent networks for complex, non-deterministic task execution.
+- [Supervisor Agents](references/docs-agents-supervisor-agents.md) - Learn how to coordinate multiple agents using the supervisor pattern with delegation hooks, iteration monitoring, message filtering, and task completion scoring.
+- [Memory Processors](references/docs-memory-memory-processors.md) - Learn how to use memory processors in Mastra to filter, trim, and transform messages before they're sent to the language model to manage context window limits.
+- [Message History](references/docs-memory-message-history.md) - Learn how to configure message history in Mastra to store recent messages from the current conversation.
+- [Observational Memory](references/docs-memory-observational-memory.md) - Learn how Observational Memory keeps your agent's context window small while preserving long-term memory across conversations.
+- [Memory overview](references/docs-memory-overview.md) - Learn how Mastra's memory system works with working memory, message history, semantic recall, and observational memory.
+- [Semantic Recall](references/docs-memory-semantic-recall.md) - Learn how to use semantic recall in Mastra to retrieve relevant messages from past conversations using vector search and embeddings.
+- [Storage](references/docs-memory-storage.md) - Configure storage for Mastra's memory system to persist conversations, workflows, and traces.
+- [Working Memory](references/docs-memory-working-memory.md) - Learn how to configure working memory in Mastra to store persistent user data, preferences.
+
+### Reference
+
+- [Reference: Mastra.getMemory()](references/reference-core-getMemory.md) - Documentation for the `Mastra.getMemory()` method in Mastra, which retrieves a registered memory instance by its registry key.
+- [Reference: Mastra.listMemory()](references/reference-core-listMemory.md) - Documentation for the `Mastra.listMemory()` method in Mastra, which returns all registered memory instances.
+- [Reference: Cloned Thread Utilities](references/reference-memory-clone-utilities.md) - Documentation for utility methods to work with cloned threads in Mastra Memory.
+- [Reference: Memory.cloneThread()](references/reference-memory-cloneThread.md) - Documentation for the `Memory.cloneThread()` method in Mastra, which creates a copy of a conversation thread with all its messages.
+- [Reference: Memory.createThread()](references/reference-memory-createThread.md) - Documentation for the `Memory.createThread()` method in Mastra, which creates a new conversation thread in the memory system.
+- [Reference: Memory.getThreadById()](references/reference-memory-getThreadById.md) - Documentation for the `Memory.getThreadById()` method in Mastra, which retrieves a specific thread by its ID.
+- [Reference: Memory.listThreads()](references/reference-memory-listThreads.md) - Documentation for the `Memory.listThreads()` method in Mastra, which retrieves threads with optional filtering by resourceId and/or metadata.
+- [Reference: Memory Class](references/reference-memory-memory-class.md) - Documentation for the `Memory` class in Mastra, which provides a robust system for managing conversation history and thread-based message storage.
+- [Reference: Observational Memory](references/reference-memory-observational-memory.md) - API reference for Observational Memory in Mastra — a three-tier memory system that uses Observer and Reflector agents to maintain long-term memory across conversations.
+- [Reference: Token Limiter Processor](references/reference-processors-token-limiter-processor.md) - Documentation for the TokenLimiterProcessor in Mastra, which limits the number of tokens in messages.
+- [Reference: DynamoDB Storage](references/reference-storage-dynamodb.md) - Documentation for the DynamoDB storage implementation in Mastra, using a single-table design with ElectroDB.
+- [Reference: libSQL Storage](references/reference-storage-libsql.md) - Documentation for the libSQL storage implementation in Mastra.
+- [Reference: MongoDB Storage](references/reference-storage-mongodb.md) - Documentation for the MongoDB storage implementation in Mastra.
+- [Reference: PostgreSQL Storage](references/reference-storage-postgresql.md) - Documentation for the PostgreSQL storage implementation in Mastra.
+- [Reference: Upstash Storage](references/reference-storage-upstash.md) - Documentation for the Upstash storage implementation in Mastra.
+- [Reference: libSQL Vector Store](references/reference-vectors-libsql.md) - Documentation for the LibSQLVector class in Mastra, which provides vector search using libSQL with vector extensions.
+- [Reference: MongoDB Vector Store](references/reference-vectors-mongodb.md) - Documentation for the MongoDBVector class in Mastra, which provides vector search using MongoDB Atlas and Atlas Vector Search.
+- [Reference: PG Vector Store](references/reference-vectors-pg.md) - Documentation for the PgVector class in Mastra, which provides vector search using PostgreSQL with pgvector extension.
+- [Reference: Upstash Vector Store](references/reference-vectors-upstash.md) - Documentation for the UpstashVector class in Mastra, which provides vector search using Upstash Vector.
+
+
+Read [assets/SOURCE_MAP.json](assets/SOURCE_MAP.json) for source code references.

package/dist/docs/assets/SOURCE_MAP.json

@@ -0,0 +1,103 @@
+{
+  "version": "1.5.2",
+  "package": "@mastra/memory",
+  "exports": {
+    "OBSERVATIONAL_MEMORY_DEFAULTS": {
+      "types": "dist/processors/index.d.ts",
+      "implementation": "dist/chunk-HNPAIFCZ.js"
+    },
+    "OBSERVATION_CONTEXT_INSTRUCTIONS": {
+      "types": "dist/processors/index.d.ts",
+      "implementation": "dist/chunk-HNPAIFCZ.js"
+    },
+    "OBSERVATION_CONTEXT_PROMPT": {
+      "types": "dist/processors/index.d.ts",
+      "implementation": "dist/chunk-HNPAIFCZ.js"
+    },
+    "OBSERVATION_CONTINUATION_HINT": {
+      "types": "dist/processors/index.d.ts",
+      "implementation": "dist/chunk-HNPAIFCZ.js"
+    },
+    "OBSERVER_SYSTEM_PROMPT": {
+      "types": "dist/processors/index.d.ts",
+      "implementation": "dist/chunk-HNPAIFCZ.js"
+    },
+    "ObservationalMemory": {
+      "types": "dist/processors/index.d.ts",
+      "implementation": "dist/chunk-HNPAIFCZ.js",
+      "line": 1258
+    },
+    "TokenCounter": {
+      "types": "dist/processors/index.d.ts",
+      "implementation": "dist/chunk-HNPAIFCZ.js",
+      "line": 919
+    },
+    "buildObserverPrompt": {
+      "types": "dist/processors/index.d.ts",
+      "implementation": "dist/chunk-HNPAIFCZ.js",
+      "line": 533
+    },
+    "buildObserverSystemPrompt": {
+      "types": "dist/processors/index.d.ts",
+      "implementation": "dist/chunk-HNPAIFCZ.js",
+      "line": 281
+    },
+    "extractCurrentTask": {
+      "types": "dist/processors/index.d.ts",
+      "implementation": "dist/chunk-HNPAIFCZ.js",
+      "line": 662
+    },
+    "formatMessagesForObserver": {
+      "types": "dist/processors/index.d.ts",
+      "implementation": "dist/chunk-HNPAIFCZ.js",
+      "line": 376
+    },
+    "hasCurrentTaskSection": {
+      "types": "dist/processors/index.d.ts",
+      "implementation": "dist/chunk-HNPAIFCZ.js",
+      "line": 650
+    },
+    "optimizeObservationsForContext": {
+      "types": "dist/processors/index.d.ts",
+      "implementation": "dist/chunk-HNPAIFCZ.js",
+      "line": 673
+    },
+    "parseObserverOutput": {
+      "types": "dist/processors/index.d.ts",
+      "implementation": "dist/chunk-HNPAIFCZ.js",
+      "line": 564
+    },
+    "extractWorkingMemoryContent": {
+      "types": "dist/index.d.ts",
+      "implementation": "dist/memory"
+    },
+    "extractWorkingMemoryTags": {
+      "types": "dist/index.d.ts",
+      "implementation": "dist/memory"
+    },
+    "removeWorkingMemoryTags": {
+      "types": "dist/index.d.ts",
+      "implementation": "dist/memory"
+    },
+    "MessageHistory": {
+      "types": "dist/index.d.ts",
+      "implementation": "dist/processors"
+    },
+    "SemanticRecall": {
+      "types": "dist/index.d.ts",
+      "implementation": "dist/processors"
+    },
+    "WorkingMemory": {
+      "types": "dist/index.d.ts",
+      "implementation": "dist/processors"
+    }
+  },
+  "modules": {
+    "processors": {
+      "index": "dist/processors/index.js",
+      "chunks": [
+        "chunk-HNPAIFCZ.js"
+      ]
+    }
+  }
+}