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

package/dist/docs/SKILL.md

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

package/dist/docs/assets/SOURCE_MAP.json

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

package/dist/docs/references/docs-agents-human-in-the-loop.md

@@ -311,6 +311,9 @@ Instead of pausing every tool call at the agent level, you can mark individual t
 Set `requireApproval: true` on a tool definition. The tool pauses before execution regardless of whether `requireToolApproval` is set on the agent:
 
 ```typescript
+import { createTool } from '@mastra/core/tools'
+import { z } from 'zod'
+
 export const testTool = createTool({
   id: 'test-tool',
   description: 'Fetches weather for a location',
@@ -359,6 +362,9 @@ const handleApproval = async () => {
 With this approach, neither the agent nor the tool uses `requireApproval`. Instead, the tool's `execute` function calls `suspend()` to pause at a specific point and return context or confirmation prompts to the user. This is useful when approval depends on runtime conditions rather than being unconditional.
 
 ```typescript
+import { createTool } from '@mastra/core/tools'
+import { z } from 'zod'
+
 export const testToolB = createTool({
   id: 'test-tool-b',
   description: 'Fetches weather for a location',
@@ -662,6 +668,9 @@ for await (const chunk of stream.fullStream) {
 Tools can also use [`suspend()`](#approval-using-suspend) to pause execution and return context to the user. This approach works through the supervisor delegation chain the same way `requireApproval` does: the suspension surfaces at the supervisor level:
 
 ```typescript
+import { createTool } from '@mastra/core/tools'
+import { z } from 'zod'
+
 const conditionalTool = createTool({
   id: 'conditional-operation',
   description: 'Performs an operation that may require confirmation',

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

@@ -224,6 +224,8 @@ If a subagent isn't listed under the supervisor's `backgroundTasks.tools` but ha
 The background config used for the inherited dispatch (for example `waitTimeoutMs`) is derived from the subagent's own `backgroundTasks` config.
 
 ```typescript
+import { Agent } from '@mastra/core/agent'
+
 const researchAgent = new Agent({
   id: 'research-agent',
   description: 'Gathers factual information.',
@@ -311,6 +313,8 @@ Each layer can register terminal-state callbacks. They don't replace one another
 - Manager-level `onTaskComplete` / `onTaskFailed`: scoped globally.
 
 ```typescript
+import { Mastra } from '@mastra/core'
+
 export const mastra = new Mastra({
   storage,
   backgroundTasks: {

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

@@ -87,6 +87,8 @@ Pass `goal.scorer` to replace the pipeline with your own [scorer](https://mastra
 Configure the default scorer with `judge`, `maxRuns`, and `prompt`:
 
 ```typescript
+import { Agent } from '@mastra/core/agent'
+
 const worker = new Agent({
   id: 'worker',
   name: 'worker',

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

@@ -138,6 +138,9 @@ If you assemble the request input yourself and need it processed exactly as sent
 Message count is a poor proxy for context size: a tool result can be a few tokens or thousands. Use `messageHistory` to keep recent history within a token budget instead:
 
 ```typescript
+import { Agent } from '@mastra/core/agent'
+import { Memory } from '@mastra/memory'
+
 export const agent = new Agent({
   id: 'test-agent',
   memory: new Memory({

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

@@ -149,6 +149,8 @@ OM can activate buffered observations before the token threshold is reached. Thi
 Top-level early activation settings apply to observations by default:
 
 ```typescript
+import { Memory } from '@mastra/memory'
+
 const memory = new Memory({
   options: {
     observationalMemory: {
@@ -163,6 +165,8 @@ const memory = new Memory({
 Use nested `observation` and `reflection` settings for per-phase control. Reflection early activation is opt-in, so top-level settings affect only observations.
 
 ```typescript
+import { Memory } from '@mastra/memory'
+
 const memory = new Memory({
   options: {
     observationalMemory: {
@@ -187,6 +191,8 @@ In this example, the top-level idle setting is disabled for observations, while
 Set `observation.bufferOnIdle` to `true` to run background observation buffering when an agent turn ends and the agent becomes idle. This is useful for apps that want short turns to be observed without waiting for the next turn or the `messageTokens` threshold.
 
 ```typescript
+import { Memory } from '@mastra/memory'
+
 const memory = new Memory({
   options: {
     observationalMemory: {
@@ -209,6 +215,8 @@ Observer and Reflector model calls are retried on transient provider errors. By
 - `failurePolicy`: what happens once retries are exhausted, either `'abort'` (default) or `'continue'`.
 
 ```typescript
+import { Memory } from '@mastra/memory'
+
 const memory = new Memory({
   options: {
     observationalMemory: {
@@ -391,6 +399,8 @@ This setting adds `WorkingMemoryExtractor`, defaults `workingMemory.agentManaged
 Use `onExtracted` to normalize or react to custom extracted values before they're persisted:
 
 ```typescript
+import { z } from 'zod'
+
 new Extractor({
   name: 'Project status',
   instructions: 'Extract the current project status.',

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

@@ -164,6 +164,9 @@ const response = await memoryAgent.generate('Remember my favorite color is blue.
 Scopes can also come from the agent and from the request context. Mastra combines all three sources:
 
 ```typescript
+import { Agent } from '@mastra/core/agent'
+import { Memory } from '@mastra/memory'
+
 export const memoryAgent = new Agent({
   id: 'memory-agent',
   name: 'Memory Agent',
@@ -271,6 +274,9 @@ Open [Studio](https://mastra.ai/docs/studio/overview) and select the **Observabi
 Use [`RequestContext`](https://mastra.ai/docs/server/request-context) to access request-specific values. This lets you conditionally select different memory or storage configurations based on the context of the request.
 
 ```typescript
+import { Agent } from '@mastra/core/agent'
+import { Memory } from '@mastra/memory'
+
 export type UserTier = {
   'user-tier': 'enterprise' | 'pro'
 }

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

@@ -4,7 +4,11 @@
 
 # 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.
+Semantic recall is a built-in form of Retrieval-Augmented Generation (RAG) for agent memory. When a user sends a message, Mastra searches earlier messages for ones with a similar meaning and adds the most relevant ones to the agent's context.
+
+Matching on meaning matters because people often remember the idea behind something, not the exact words they used. A user might ask "What did we decide about the refund?" after originally writing "Let's give them their money back." A keyword search misses that connection, but semantic recall finds it.
+
+Use semantic recall when your agent needs details from earlier in a long conversation, or from a user's other conversations, that are no longer in [recent message history](https://mastra.ai/docs/memory/message-history).
 
 > **📹 Watch:** Watch [Mastra semantic recall](https://www.youtube.com/watch?v=UVZtK8cK8xQ\&pp=ygUVbWFzdHJhIHdvcmtpbmcgbWVtb3J5) to see how agents retrieve relevant messages from past conversations.
 

package/dist/docs/references/docs-subagents.md

@@ -72,9 +72,11 @@ Called before the parent agent delegates to a subagent. Return an object to cont
 - `proceed: true`: Allow the delegation (default behavior)
 - `proceed: false`: Reject the delegation with a `rejectionReason`
 - `modifiedPrompt`: Rewrite the prompt sent to the subagent
-- `modifiedMaxSteps`: Limit the subagent's iteration count
+- `modifiedMaxSteps`: Set the subagent's iteration budget. This overrides the cap on the model-supplied `maxSteps`, so it can raise the budget as well as lower it
 - `threadMetadata`: Attach metadata (for example a `tenantId`) to the subagent's thread when it's created, so you can filter threads with `memory.listThreads({ filter: { metadata } })`
 
+> **Note:** When the supervisor model passes `maxSteps` to a delegation, Mastra caps it at the subagent's `defaultOptions.maxSteps`. The model can lower the subagent's budget that way, but not raise it. `modifiedMaxSteps` is applied after that cap and replaces the capped value, so it can raise the budget above the subagent's default. Use it to stop a supervisor model from cutting a subagent short.
+
 ```typescript
 const stream = await parentAgent.stream('Research AI trends', {
   maxSteps: 10,
@@ -221,6 +223,8 @@ const stream = await parentAgent.stream('Research AI trends', {
 Either way, every hook failure is recorded on the run's request context under `__mastra_delegationHookErrors` as a list of `{ hook, primitiveId, toolCallId, runId, name, message }` entries, so you can detect a hook failure programmatically:
 
 ```typescript
+import { RequestContext } from '@mastra/core/request-context'
+
 const requestContext = new RequestContext()
 
 await parentAgent.generate('Research AI trends', { maxSteps: 10, requestContext })
@@ -495,6 +499,8 @@ Subagent invocations are dispatched as tool calls, so they can run as [backgroun
 Enable the [backgroundTasks manager](https://mastra.ai/reference/configuration) on the Mastra instance, then opt subagents in on the parent agent:
 
 ```typescript
+import { Agent } from '@mastra/core/agent'
+
 const parentAgent = new Agent({
   id: 'parent-agent',
   instructions: 'Coordinate research and writing using the available agents.',

package/dist/docs/references/integrations-databases-aurora-dsql.md

@@ -309,7 +309,7 @@ Aurora DSQL storage provides index management capabilities to optimize query per
 Aurora DSQL storage automatically creates composite indexes during initialization for common query patterns:
 
 - `mastra_threads_resourceid_createdat_idx`: (resourceId, createdAt)
-- `mastra_messages_thread_id_createdat_idx`: (thread\_id, createdAt)
+- `mastra_messages_thread_id_createdat_idx`: (thread_id, createdAt)
 - `mastra_ai_spans_traceid_startedat_idx`: (traceId, startedAt)
 - `mastra_ai_spans_parentspanid_startedat_idx`: (parentSpanId, startedAt)
 - `mastra_ai_spans_name_idx`: (name)
@@ -342,7 +342,7 @@ Aurora DSQL doesn't allow `ASC`/`DESC` in `CREATE INDEX ASYNC`. If you include t
 
 **name** (`string`): Unique name for the index
 
-**table** (`string`): Table name (e.g., 'mastra\_threads')
+**table** (`string`): Table name (e.g., 'mastra_threads')
 
 **columns** (`string[]`): Array of column names. ASC/DESC modifiers are automatically stripped for Aurora DSQL compatibility.
 

package/dist/docs/references/integrations-databases-dynamodb.md

@@ -50,7 +50,7 @@ bun add @mastra/dynamodb@latest
 
 Before using this package, you **must** create a DynamoDB table with a specific structure, including primary keys and Global Secondary Indexes (GSIs). This adapter expects the DynamoDB table and its GSIs to be provisioned externally.
 
-Detailed instructions for setting up the table using AWS CloudFormation or AWS CDK are available in [TABLE\_SETUP.md](https://github.com/mastra-ai/mastra/blob/main/stores/dynamodb/TABLE_SETUP.md). Please ensure your table is configured according to those instructions before proceeding.
+Detailed instructions for setting up the table using AWS CloudFormation or AWS CDK are available in [TABLE_SETUP.md](https://github.com/mastra-ai/mastra/blob/main/stores/dynamodb/TABLE_SETUP.md). Please ensure your table is configured according to those instructions before proceeding.
 
 ## Usage
 
@@ -122,7 +122,7 @@ For local development, you can use [DynamoDB Local](https://docs.aws.amazon.com/
 
 **config.credentials** (`object`): AWS credentials object with accessKeyId and secretAccessKey. If not provided, the AWS SDK will attempt to source credentials from environment variables, IAM roles (e.g., for EC2/Lambda), or the shared AWS credentials file.
 
-**config.ttl** (`object`): TTL (Time To Live) configuration for automatic data expiration. Configure per entity type: thread, message, trace, eval, workflow\_snapshot, resource, score. Each entity config includes: enabled (boolean), attributeName (string, default: 'ttl'), defaultTtlSeconds (number).
+**config.ttl** (`object`): TTL (Time To Live) configuration for automatic data expiration. Configure per entity type: thread, message, trace, eval, workflow_snapshot, resource, score. Each entity config includes: enabled (boolean), attributeName (string, default: 'ttl'), defaultTtlSeconds (number).
 
 ## TTL (time to live) configuration
 
@@ -254,7 +254,7 @@ The IAM role or user executing the code needs appropriate permissions to interac
 
 Before diving into the architectural details, keep these key points in mind when working with the DynamoDB storage adapter:
 
-- **External Table Provisioning:** This adapter _requires_ you to create and configure the DynamoDB table and its Global Secondary Indexes (GSIs) yourself, prior to using the adapter. Follow the guide in [TABLE\_SETUP.md](https://github.com/mastra-ai/mastra/blob/main/stores/dynamodb/TABLE_SETUP.md).
+- **External Table Provisioning:** This adapter _requires_ you to create and configure the DynamoDB table and its Global Secondary Indexes (GSIs) yourself, prior to using the adapter. Follow the guide in [TABLE_SETUP.md](https://github.com/mastra-ai/mastra/blob/main/stores/dynamodb/TABLE_SETUP.md).
 - **Single-Table Design:** All Mastra data (threads, messages, etc.) is stored in one DynamoDB table. This is a deliberate design choice optimized for DynamoDB, differing from relational database approaches.
 - **Understanding GSIs:** Familiarity with how the GSIs are structured (as per `TABLE_SETUP.md`) is important for understanding data retrieval and potential query patterns.
 - **ElectroDB:** The adapter uses ElectroDB to manage interactions with DynamoDB, providing a layer of abstraction and type safety over raw DynamoDB operations.
@@ -266,7 +266,7 @@ This storage adapter utilizes a **single-table design pattern** with [ElectroDB]
 Key aspects of this approach:
 
 - **DynamoDB Native:** The single-table design is optimized for DynamoDB's key-value and query capabilities, often leading to better performance and capacity compared to mimicking relational models.
-- **External Table Management:** Unlike some adapters that might offer helper functions to create tables via code, this adapter **expects the DynamoDB table and its associated Global Secondary Indexes (GSIs) to be provisioned externally** before use. Please refer to [TABLE\_SETUP.md](https://github.com/mastra-ai/mastra/blob/main/stores/dynamodb/TABLE_SETUP.md) for detailed instructions using tools like AWS CloudFormation or CDK. The adapter focuses solely on interacting with the pre-existing table structure.
+- **External Table Management:** Unlike some adapters that might offer helper functions to create tables via code, this adapter **expects the DynamoDB table and its associated Global Secondary Indexes (GSIs) to be provisioned externally** before use. Please refer to [TABLE_SETUP.md](https://github.com/mastra-ai/mastra/blob/main/stores/dynamodb/TABLE_SETUP.md) for detailed instructions using tools like AWS CloudFormation or CDK. The adapter focuses solely on interacting with the pre-existing table structure.
 - **Consistency via Interface:** While the underlying storage model differs, this adapter adheres to the same `MastraStorage` interface as other adapters, ensuring it can be used interchangeably within the Mastra `Memory` component.
 
 ### Mastra Data in the Single Table

package/dist/docs/references/integrations-databases-postgresql.md

@@ -429,14 +429,14 @@ PostgreSQL storage provides index management to optimize query performance.
 PostgreSQL storage creates composite indexes during initialization for common query patterns:
 
 - `mastra_threads_resourceid_createdat_idx`: (resourceId, createdAt DESC)
-- `mastra_messages_thread_id_createdat_idx`: (thread\_id, createdAt DESC)
+- `mastra_messages_thread_id_createdat_idx`: (thread_id, createdAt DESC)
 - `mastra_ai_spans_traceid_startedat_idx`: (traceId, startedAt DESC)
 - `mastra_ai_spans_parentspanid_startedat_idx`: (parentSpanId, startedAt DESC)
 - `mastra_ai_spans_name_startedat_idx`: (name, startedAt DESC)
 - `mastra_ai_spans_scope_startedat_idx`: (scope, startedAt DESC)
 - `mastra_scores_trace_id_span_id_created_at_idx`: (traceId, spanId, createdAt DESC)
-- `mastra_workflow_snapshot_name_createdat_idx`: (workflow\_name, createdAt DESC)
-- `mastra_workflow_snapshot_name_status_createdat_idx`: (workflow\_name, snapshot->>'status', createdAt DESC), created only when the `snapshot` column is `jsonb`
+- `mastra_workflow_snapshot_name_createdat_idx`: (workflow_name, createdAt DESC)
+- `mastra_workflow_snapshot_name_status_createdat_idx`: (workflow_name, snapshot->>'status', createdAt DESC), created only when the `snapshot` column is `jsonb`
 
 These indexes improve performance for filtered queries with sorting, including `dateRange` filters on message queries and Studio's workflow runs-list.
 
@@ -485,7 +485,7 @@ For advanced index types, you can specify additional options:
 
 **name** (`string`): Unique name for the index
 
-**table** (`string`): Table name (e.g., 'mastra\_threads')
+**table** (`string`): Table name (e.g., 'mastra_threads')
 
 **columns** (`string[]`): Array of column names with optional sort order (e.g., \['id', 'createdAt DESC'])
 

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

@@ -37,11 +37,11 @@ export const agent = new Agent({
 
 **embedder** (`EmbeddingModel<string> | EmbeddingModelV2<string>`): Embedder instance for vector embeddings. Required when semantic recall is enabled.
 
-**embeddingDimension** (`number`): Output dimension of the embedder, as a positive integer. When set, Memory uses it to name the semantic recall index instead of embedding a probe string on first use. It must match the vectors the embedder returns: a mismatch throws a MASTRA\_MEMORY\_EMBEDDING\_DIMENSION\_MISMATCH error before any index is created. See Setting the embedding dimension.
+**embeddingDimension** (`number`): Output dimension of the embedder, as a positive integer. When set, Memory uses it to name the semantic recall index instead of embedding a probe string on first use. It must match the vectors the embedder returns: a mismatch throws a MASTRA_MEMORY_EMBEDDING_DIMENSION_MISMATCH error before any index is created. See Setting the embedding dimension.
 
 **options** (`MemoryConfig`): Memory configuration options.
 
-**options.lastMessages** (`number | false`): Number of most recent messages to include in context. Set to false to disable the message history feature entirely (messages are not loaded into context or saved). Use Number.MAX\_SAFE\_INTEGER to retrieve all messages with no limit. To load messages without saving new ones, use the readOnly option. The window slides forward on every request, so once a thread exceeds the limit, each turn invalidates the provider prompt cache. For long-running conversations, use Observational Memory instead.
+**options.lastMessages** (`number | false`): Number of most recent messages to include in context. Set to false to disable the message history feature entirely (messages are not loaded into context or saved). Use Number.MAX_SAFE_INTEGER to retrieve all messages with no limit. To load messages without saving new ones, use the readOnly option. The window slides forward on every request, so once a thread exceeds the limit, each turn invalidates the provider prompt cache. For long-running conversations, use Observational Memory instead.
 
 **options.messageHistory** (`{ maxTokens: number; atMaxRemoveTokens?: number }`): Token budget for the complete prompt, including remembered history, system instructions, context, and the current turn. When the prompt exceeds maxTokens, the oldest remembered messages are dropped until the prompt is at most maxTokens - atMaxRemoveTokens (defaults to 25% of maxTokens). Protected content is never removed. Linked tool calls and results are removed together. During agent runs, trimmed history is excluded from later turns via a persisted per-thread boundary, but the messages themselves stay in storage. When set without an explicit lastMessages, the default 10-message cap is not applied. Set maxTokens to 0 to disable message history. Prefer this over lastMessages, since message count is a poor proxy for context size.