@mastra/memory 1.22.0 → 1.22.1-alpha.1

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.22.0"
+  version: "1.22.1-alpha.1"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,129 +1,129 @@
 {
-  "version": "1.22.0",
+  "version": "1.22.1-alpha.1",
   "package": "@mastra/memory",
   "exports": {
     "Extractor": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-KKP6DG65.js",
+      "implementation": "dist/chunk-2NSPHF6Q.js",
       "line": 316
     },
     "ModelByInputTokens": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-KKP6DG65.js",
+      "implementation": "dist/chunk-2NSPHF6Q.js",
       "line": 1354
     },
     "OBSERVER_SYSTEM_PROMPT": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-KKP6DG65.js"
+      "implementation": "dist/chunk-2NSPHF6Q.js"
     },
     "ObservationalMemory": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-KKP6DG65.js",
-      "line": 27526
+      "implementation": "dist/chunk-2NSPHF6Q.js",
+      "line": 27532
     },
     "ObservationalMemoryProcessor": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-KKP6DG65.js",
-      "line": 30157
+      "implementation": "dist/chunk-2NSPHF6Q.js",
+      "line": 30163
     },
     "TokenCounter": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-KKP6DG65.js",
+      "implementation": "dist/chunk-2NSPHF6Q.js",
       "line": 26857
     },
     "WorkingMemoryExtractor": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-KKP6DG65.js",
+      "implementation": "dist/chunk-2NSPHF6Q.js",
       "line": 20684
     },
     "buildObserverPrompt": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-KKP6DG65.js",
+      "implementation": "dist/chunk-2NSPHF6Q.js",
       "line": 4465
     },
     "buildObserverSystemPrompt": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-KKP6DG65.js",
+      "implementation": "dist/chunk-2NSPHF6Q.js",
       "line": 3732
     },
     "combineObservationGroupRanges": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-KKP6DG65.js",
+      "implementation": "dist/chunk-2NSPHF6Q.js",
       "line": 1446
     },
     "deriveObservationGroupProvenance": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-KKP6DG65.js",
+      "implementation": "dist/chunk-2NSPHF6Q.js",
       "line": 1480
     },
     "extractCurrentTask": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-KKP6DG65.js",
+      "implementation": "dist/chunk-2NSPHF6Q.js",
       "line": 4588
     },
     "formatMessagesForObserver": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-KKP6DG65.js",
+      "implementation": "dist/chunk-2NSPHF6Q.js",
       "line": 4187
     },
     "getObservationsAsOf": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-KKP6DG65.js",
-      "line": 30379
+      "implementation": "dist/chunk-2NSPHF6Q.js",
+      "line": 30385
     },
     "hasCurrentTaskSection": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-KKP6DG65.js",
+      "implementation": "dist/chunk-2NSPHF6Q.js",
       "line": 4576
     },
     "injectAnchorIds": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-KKP6DG65.js",
+      "implementation": "dist/chunk-2NSPHF6Q.js",
       "line": 3287
     },
     "optimizeObservationsForContext": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-KKP6DG65.js",
+      "implementation": "dist/chunk-2NSPHF6Q.js",
       "line": 4599
     },
     "parseAnchorId": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-KKP6DG65.js",
+      "implementation": "dist/chunk-2NSPHF6Q.js",
       "line": 3260
     },
     "parseObservationGroups": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-KKP6DG65.js",
+      "implementation": "dist/chunk-2NSPHF6Q.js",
       "line": 1415
     },
     "parseObserverOutput": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-KKP6DG65.js",
+      "implementation": "dist/chunk-2NSPHF6Q.js",
       "line": 4479
     },
     "reconcileObservationGroupsFromReflection": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-KKP6DG65.js",
+      "implementation": "dist/chunk-2NSPHF6Q.js",
       "line": 1504
     },
     "renderObservationGroupsForReflection": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-KKP6DG65.js",
+      "implementation": "dist/chunk-2NSPHF6Q.js",
       "line": 1460
     },
     "stripEphemeralAnchorIds": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-KKP6DG65.js",
+      "implementation": "dist/chunk-2NSPHF6Q.js",
       "line": 3317
     },
     "stripObservationGroups": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-KKP6DG65.js",
+      "implementation": "dist/chunk-2NSPHF6Q.js",
       "line": 1437
     },
     "wrapInObservationGroup": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-KKP6DG65.js",
+      "implementation": "dist/chunk-2NSPHF6Q.js",
       "line": 1408
     },
     "OBSERVATIONAL_MEMORY_DEFAULTS": {
@@ -144,39 +144,39 @@
     },
     "Memory": {
       "types": "dist/index.d.ts",
-      "implementation": "dist/chunk-KKP6DG65.js",
+      "implementation": "dist/chunk-2NSPHF6Q.js",
       "line": 22108
     },
     "MessageHistory": {
       "types": "dist/index.d.ts",
-      "implementation": "dist/chunk-KKP6DG65.js"
+      "implementation": "dist/chunk-2NSPHF6Q.js"
     },
     "SemanticRecall": {
       "types": "dist/index.d.ts",
-      "implementation": "dist/chunk-KKP6DG65.js"
+      "implementation": "dist/chunk-2NSPHF6Q.js"
     },
     "WorkingMemory": {
       "types": "dist/index.d.ts",
-      "implementation": "dist/chunk-KKP6DG65.js"
+      "implementation": "dist/chunk-2NSPHF6Q.js"
     },
     "deepMergeWorkingMemory": {
       "types": "dist/index.d.ts",
-      "implementation": "dist/chunk-KKP6DG65.js",
+      "implementation": "dist/chunk-2NSPHF6Q.js",
       "line": 21747
     },
     "extractWorkingMemoryContent": {
       "types": "dist/index.d.ts",
-      "implementation": "dist/chunk-KKP6DG65.js",
+      "implementation": "dist/chunk-2NSPHF6Q.js",
       "line": 22063
     },
     "extractWorkingMemoryTags": {
       "types": "dist/index.d.ts",
-      "implementation": "dist/chunk-KKP6DG65.js",
+      "implementation": "dist/chunk-2NSPHF6Q.js",
       "line": 22031
     },
     "removeWorkingMemoryTags": {
       "types": "dist/index.d.ts",
-      "implementation": "dist/chunk-KKP6DG65.js",
+      "implementation": "dist/chunk-2NSPHF6Q.js",
       "line": 22044
     },
     "WORKING_MEMORY_STATE_ID": {
@@ -197,7 +197,7 @@
     "processors": {
       "index": "dist/processors/index.js",
       "chunks": [
-        "chunk-KKP6DG65.js",
+        "chunk-2NSPHF6Q.js",
         "chunk-LSJJAJAF.js"
       ]
     }

package/dist/docs/references/docs-agents-agent-approval.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Agent approval
 
 Agents sometimes require the same [human-in-the-loop](https://mastra.ai/docs/workflows/human-in-the-loop) oversight used in workflows when calling tools that handle sensitive operations, like deleting resources or running long processes. With agent approval you can suspend a tool call before it executes so a human can approve or decline it, or let tools suspend themselves to request additional context from the user.

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

@@ -1,8 +1,10 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Background tasks
 
 **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, the LLM continues responding, and the task 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/agents/agent) 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, the LLM continues responding, and the task 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.
 
 ## When to use background tasks
 
@@ -166,7 +168,7 @@ const stream = await agent.stream('Research solana for me', {
 })
 ```
 
-> **Note:** Visit [`Agent.stream()`](https://mastra.ai/reference/agents/agent) for the full API.
+> **Note:** Visit [`Agent.stream()`](https://mastra.ai/reference/streaming/agents/stream) for the full API.
 
 ### Aggregate properties
 
@@ -372,7 +374,7 @@ These read from storage rather than the pubsub stream, so they're suitable for p
 
 ## Related
 
-- [`Agent.stream()` reference](https://mastra.ai/reference/agents/agent)
+- [`Agent.stream()` reference](https://mastra.ai/reference/streaming/agents/stream)
 - [backgroundTasks configuration reference](https://mastra.ai/reference/configuration)
 - [Durable agents](https://mastra.ai/docs/agents/durable-agents)
 - [Supervisor agents](https://mastra.ai/docs/agents/supervisor-agents)

package/dist/docs/references/docs-agents-goals.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Goals
 
 **Added in:** `@mastra/core@1.42.0`
@@ -26,6 +28,7 @@ Goals require a configured [storage](https://mastra.ai/docs/memory/storage) back
 import { Agent } from '@mastra/core/agent'
 
 const worker = new Agent({
+  id: 'worker',
   name: 'worker',
   instructions: 'You complete software tasks end to end.',
   model: 'openai/gpt-5.5',
@@ -66,6 +69,7 @@ By default the step uses a built-in LLM-as-judge scorer that returns `1` when th
 
 ```typescript
 const worker = new Agent({
+  id: 'worker',
   name: 'worker',
   instructions: 'You complete software tasks end to end.',
   model: 'openai/gpt-5.5',

package/dist/docs/references/docs-agents-networks.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Agent networks
 
 > **Deprecated — Use supervisor agents:** Agent networks are deprecated and will be removed in a future major release. [Supervisor agents](https://mastra.ai/docs/agents/supervisor-agents) using `agent.stream()` or `agent.generate()` are now the recommended approach. It provides the same multi-agent coordination with better control, a simpler API, and easier debugging.

package/dist/docs/references/docs-agents-supervisor-agents.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Supervisor agents
 
 **Added in:** `@mastra/core@1.8.0`
@@ -351,6 +353,7 @@ Each subagent should have a clear `description` that explains what it does, what
 
 ```typescript
 const supervisor = new Agent({
+  id: 'supervisor',
   instructions: `You coordinate research and writing tasks.
 
 Available resources:

package/dist/docs/references/docs-evals-evals-with-memory.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Evals with memory
 
 Agents that use memory in `thread` scope — including observational memory — require a thread ID at run time. When an eval invokes the agent without one, you'll see:

package/dist/docs/references/docs-memory-memory-processors.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Memory processors
 
 Memory processors transform and filter messages as they pass through an agent with memory enabled. They manage context window limits, remove unnecessary content, and optimize the information sent to the language model.
@@ -248,6 +250,7 @@ const contentBlocker = {
 }
 
 const agent = new Agent({
+  id: 'safe-agent',
   name: 'safe-agent',
   instructions: 'You are a helpful assistant',
   model: 'openai/gpt-5.5',
@@ -287,6 +290,7 @@ const inputValidator = {
 }
 
 const agent = new Agent({
+  id: 'validated-agent',
   name: 'validated-agent',
   instructions: 'You are a helpful assistant',
   model: 'openai/gpt-5.5',

package/dist/docs/references/docs-memory-message-history.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Message history
 
 Message history is the most basic and important form of memory. It gives the LLM a view of recent messages in the context window, enabling your agent to reference earlier exchanges and respond coherently.

package/dist/docs/references/docs-memory-multi-user-threads.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Multi-user threads
 
 A single Mastra thread can be shared by multiple users, each with their own name and functional role. You carry speaker identity in the message body so the agent can tell users apart while reading from a single shared thread.

package/dist/docs/references/docs-memory-observational-memory.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Observational Memory
 
 **Added in:** `@mastra/memory@1.1.0`
@@ -13,6 +15,7 @@ import { Memory } from '@mastra/memory'
 import { Agent } from '@mastra/core/agent'
 
 export const agent = new Agent({
+  id: 'my-agent',
   name: 'my-agent',
   instructions: 'You are a helpful assistant.',
   model: 'openai/gpt-5-mini',
@@ -57,6 +60,7 @@ import { Memory } from '@mastra/memory'
 import { Agent } from '@mastra/core/agent'
 
 export const agent = new Agent({
+  id: 'my-agent',
   name: 'my-agent',
   instructions: 'You are a helpful assistant.',
   model: 'openai/gpt-5-mini',
@@ -196,6 +200,7 @@ const memory = new Memory({
 })
 
 export const agent = new Agent({
+  id: 'assistant',
   name: 'assistant',
   instructions: 'You are a helpful assistant.',
   model: 'openai/gpt-5-mini',
@@ -281,6 +286,7 @@ If your Observer model is text-only or its API rejects multimodal input, set `ob
 
 ```typescript
 new Agent({
+  id: 'assistant',
   name: 'assistant',
   instructions: 'You are a helpful assistant.',
   model: 'openai/gpt-5-mini',

package/dist/docs/references/docs-memory-overview.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Memory
 
 Memory enables your agent to remember user messages, agent replies, and tool results across interactions, giving it the context it needs to stay consistent, maintain conversation flow, and produce better answers over time.
@@ -174,7 +176,9 @@ Each delegation creates a fresh `threadId` and a deterministic `resourceId` for
 
 - **Thread ID**: Unique per delegation. The subagent starts with a clean message history every time it's called.
 - **Resource ID**: Derived as `{parentResourceId}-{agentName}`. Because the resource ID is stable across delegations, resource-scoped memory persists between calls. A subagent remembers facts from previous delegations by the same user.
-- **Memory instance**: If a subagent has no memory configured, it inherits the supervisor's `Memory` instance. If the subagent defines its own, that takes precedence.
+- **Memory instance**: If a subagent has no memory configured, it inherits the supervisor's `Memory` instance, including all of its options. If the subagent defines its own, that takes precedence.
+
+> **Note:** Title generation (`generateTitle`) is a top-level thread concern and is **not** applied to inherited subagent threads. Because each delegation creates an ephemeral thread that no one sees, running title generation for it would waste an LLM call per delegation. To generate titles for a subagent's own threads, give that subagent its own memory configuration.
 
 The supervisor forwards its conversation context to the subagent so it has enough background to complete the task. Only the delegation prompt and the subagent's response are saved — the full parent conversation isn't stored. You can control which messages reach the subagent with the [`messageFilter`](https://mastra.ai/docs/agents/supervisor-agents) callback.
 

package/dist/docs/references/docs-memory-semantic-recall.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Semantic recall
 
 If you ask your friend what they did last weekend, they will search in their memory for events associated with "last weekend" and then tell you what they did. That's sort of like how semantic recall works in Mastra.
@@ -130,6 +132,7 @@ The following options control semantic recall behavior:
 
 ```typescript
 const agent = new Agent({
+  id: 'agent',
   memory: new Memory({
     options: {
       semanticRecall: {
@@ -151,6 +154,7 @@ The `filter` option restricts semantic recall results to messages with matching
 
 ```typescript
 const agent = new Agent({
+  id: 'agent',
   memory: new Memory({
     options: {
       semanticRecall: {
@@ -217,6 +221,7 @@ import { Agent } from '@mastra/core/agent'
 import { ModelRouterEmbeddingModel } from '@mastra/core/llm'
 
 const agent = new Agent({
+  id: 'agent',
   memory: new Memory({
     embedder: new ModelRouterEmbeddingModel('openai/text-embedding-3-small'),
     options: {
@@ -238,6 +243,7 @@ import { Memory } from '@mastra/memory'
 import { ModelRouterEmbeddingModel } from '@mastra/core/llm'
 
 const agent = new Agent({
+  id: 'agent',
   memory: new Memory({
     embedder: new ModelRouterEmbeddingModel({
       providerId: 'openrouter',
@@ -259,6 +265,7 @@ import { Agent } from '@mastra/core/agent'
 import { ModelRouterEmbeddingModel } from '@mastra/core/llm'
 
 const agent = new Agent({
+  id: 'agent',
   memory: new Memory({
     embedder: new ModelRouterEmbeddingModel('openai/text-embedding-3-small'),
   }),
@@ -301,6 +308,7 @@ import { Agent } from '@mastra/core/agent'
 import { fastembed } from '@mastra/fastembed'
 
 const agent = new Agent({
+  id: 'agent',
   memory: new Memory({
     embedder: fastembed,
   }),

package/dist/docs/references/docs-memory-storage.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Storage
 
 For agents to remember previous interactions, Mastra needs a storage adapter. Use one of the [supported providers](#supported-providers) and pass it to your Mastra instance.
@@ -100,6 +102,10 @@ export const mastra = new Mastra({
 
 This is useful when different types of data have different performance or operational requirements, such as low-latency storage for memory, durable storage for workflows, and high-throughput storage for observability.
 
+#### Retention
+
+Storage grows without bound by default. To cap growth, declare per-table `maxAge` policies in the `retention` config and call `storage.prune()` from your own scheduler to delete old rows. Anything you don't configure is kept forever. See [Storage retention](https://mastra.ai/reference/storage/retention) for `prune()` and the full config shape.
+
 ### Agent-level storage
 
 Agent-level storage overrides storage configured at the instance level. Add storage to a specific agent when you need to keep data separate or use different providers per agent.

package/dist/docs/references/docs-memory-working-memory.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Working Memory
 
 While [message history](https://mastra.ai/docs/memory/message-history) and [semantic recall](https://mastra.ai/docs/memory/semantic-recall) help agents remember conversations, working memory allows them to maintain persistent information about users across interactions.

package/dist/docs/references/reference-core-getMemory.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Mastra.getMemory()
 
 The `.getMemory()` method retrieves a memory instance from the Mastra registry by its key. Memory instances are registered in the Mastra constructor and can be referenced by stored agents.

package/dist/docs/references/reference-core-listMemory.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Mastra.listMemory()
 
 The `.listMemory()` method returns all memory instances registered with the Mastra instance.

package/dist/docs/references/reference-memory-clone-utilities.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Cloned thread utilities
 
 The Memory class provides utility methods for working with cloned threads. These methods help you check clone status, retrieve clone metadata, navigate clone relationships, and track clone history.

package/dist/docs/references/reference-memory-cloneThread.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Memory.cloneThread()
 
 The `.cloneThread()` method creates a copy of an existing conversation thread, including all its messages. This enables creating divergent conversation paths from a specific point in a conversation. When semantic recall is enabled, the method also creates vector embeddings for the cloned messages.

package/dist/docs/references/reference-memory-createThread.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Memory.createThread()
 
 The `.createThread()` method creates a new conversation thread in the memory system. Each thread represents a distinct conversation or context and can contain multiple messages.

package/dist/docs/references/reference-memory-getThreadById.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Memory.getThreadById()
 
 The `.getThreadById()` method retrieves a specific thread by its ID.

package/dist/docs/references/reference-memory-listThreads.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Memory.listThreads()
 
 The `listThreads()` method retrieves threads with pagination support and optional filtering by `resourceId`, `metadata`, or both.

package/dist/docs/references/reference-memory-memory-class.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Memory class
 
 The `Memory` class provides a robust system for managing conversation history and thread-based message storage in Mastra. It enables persistent storage of conversations, semantic search capabilities, and efficient message retrieval. You must configure a storage provider for conversation history, and if you enable semantic recall you will also need to provide a vector store and embedder.
@@ -9,6 +11,7 @@ import { Memory } from '@mastra/memory'
 import { Agent } from '@mastra/core/agent'
 
 export const agent = new Agent({
+  id: 'test-agent',
   name: 'test-agent',
   instructions: 'You are an agent with memory.',
   model: 'openai/gpt-5.5',

package/dist/docs/references/reference-memory-observational-memory.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Observational Memory
 
 **Added in:** `@mastra/memory@1.1.0`
@@ -11,6 +13,7 @@ import { Memory } from '@mastra/memory'
 import { Agent } from '@mastra/core/agent'
 
 export const agent = new Agent({
+  id: 'my-agent',
   name: 'my-agent',
   instructions: 'You are a helpful assistant.',
   model: 'openai/gpt-5-mini',
@@ -203,6 +206,7 @@ import { Memory } from '@mastra/memory'
 import { Agent } from '@mastra/core/agent'
 
 export const agent = new Agent({
+  id: 'my-agent',
   name: 'my-agent',
   instructions: 'You are a helpful assistant.',
   model: 'openai/gpt-5-mini',
@@ -232,6 +236,7 @@ import { Memory } from '@mastra/memory'
 import { Agent } from '@mastra/core/agent'
 
 export const agent = new Agent({
+  id: 'my-agent',
   name: 'my-agent',
   instructions: 'You are a helpful assistant.',
   model: 'openai/gpt-5-mini',
@@ -261,6 +266,7 @@ import { Memory } from '@mastra/memory'
 import { Agent } from '@mastra/core/agent'
 
 export const agent = new Agent({
+  id: 'my-agent',
   name: 'my-agent',
   instructions: 'You are a helpful assistant.',
   model: 'openai/gpt-5.5',
@@ -281,6 +287,7 @@ import { Memory } from '@mastra/memory'
 import { Agent } from '@mastra/core/agent'
 
 export const agent = new Agent({
+  id: 'my-agent',
   name: 'my-agent',
   instructions: 'You are a helpful assistant.',
   model: 'openai/gpt-5.5',
@@ -308,6 +315,7 @@ import { Memory } from '@mastra/memory'
 import { Agent } from '@mastra/core/agent'
 
 export const agent = new Agent({
+  id: 'health-assistant',
   name: 'health-assistant',
   instructions: 'You are a health and wellness assistant.',
   model: 'openai/gpt-5.5',
@@ -351,6 +359,7 @@ import { Memory } from '@mastra/memory'
 import { Agent } from '@mastra/core/agent'
 
 export const agent = new Agent({
+  id: 'my-agent',
   name: 'my-agent',
   instructions: 'You are a helpful assistant.',
   model: 'openai/gpt-5-mini',
@@ -666,6 +675,7 @@ const om = new ObservationalMemory({
 })
 
 export const agent = new Agent({
+  id: 'my-agent',
   name: 'my-agent',
   instructions: 'You are a helpful assistant.',
   model: 'openai/gpt-5-mini',

package/dist/docs/references/reference-processors-token-limiter-processor.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # TokenLimiterProcessor
 
 The `TokenLimiterProcessor` limits the number of tokens in messages. It can be used as an input, per-step input, and output processor:
@@ -79,6 +81,7 @@ import { Memory } from '@mastra/memory'
 import { TokenLimiterProcessor } from '@mastra/core/processors'
 
 export const agent = new Agent({
+  id: 'context-limited-agent',
   name: 'context-limited-agent',
   instructions: 'You are a helpful assistant',
   model: 'openai/gpt-5.5',
@@ -100,6 +103,7 @@ import { Agent } from '@mastra/core/agent'
 import { TokenLimiterProcessor } from '@mastra/core/processors'
 
 export const agent = new Agent({
+  id: 'multi-step-agent',
   name: 'multi-step-agent',
   instructions: 'You are a helpful research assistant with access to tools',
   model: 'openai/gpt-5.5',
@@ -123,6 +127,7 @@ import { Agent } from '@mastra/core/agent'
 import { TokenLimiterProcessor } from '@mastra/core/processors'
 
 export const agent = new Agent({
+  id: 'response-limited-agent',
   name: 'response-limited-agent',
   instructions: 'You are a helpful assistant',
   model: 'openai/gpt-5.5',