@mastra/mcp-docs-server 0.13.37 → 0.13.39-alpha.0

package/.docs/raw/reference/memory/deleteMessages.mdx

@@ -40,7 +40,7 @@ await memory?.deleteMessages(["671ae63f-3a91-4082-a907-fe7de78e10ec"]);
 
 ## Extended usage example
 
-```typescript filename="src/test-memory.ts" showLineNumbers copy
+```typescript title="src/test-memory.ts" showLineNumbers copy
 import { mastra } from "./mastra";
 import { UIMessageWithMetadata } from "@mastra/core/agent";
 
@@ -49,12 +49,14 @@ const memory = await agent.getMemory();
 
 const { uiMessages } = await memory!.query({ threadId: "thread-123" });
 
-const messageIds = uiMessages.map((message: UIMessageWithMetadata) => message.id);
+const messageIds = uiMessages.map(
+  (message: UIMessageWithMetadata) => message.id,
+);
 await memory?.deleteMessages([...messageIds]);
 ```
 
 ## Related
 
-- [Memory Class Reference](/reference/memory/Memory.mdx)
-- [query](/reference/memory/query.mdx)
-- [Getting Started with Memory](/docs/memory/overview.mdx)
+- [Memory Class Reference](/reference/memory/memory-class)
+- [query](/reference/memory/query)
+- [Getting Started with Memory](/docs/memory/overview)

package/.docs/raw/reference/memory/getThreadById.mdx

@@ -33,14 +33,15 @@ await memory?.getThreadById({ threadId: "thread-123" });
     {
       name: "thread",
       type: "Promise<StorageThreadType | null>",
-      description: "A promise that resolves to the thread associated with the given ID, or null if not found.",
+      description:
+        "A promise that resolves to the thread associated with the given ID, or null if not found.",
     },
   ]}
 />
 
 ### Related
 
-- [Memory Class Reference](/reference/memory/Memory.mdx)
-- [Getting Started with Memory](/docs/memory/overview.mdx) (Covers threads concept)
-- [createThread](/reference/memory/createThread.mdx)
-- [getThreadsByResourceId](/reference/memory/getThreadsByResourceId.mdx)
+- [Memory Class Reference](/reference/memory/memory-class)
+- [Getting Started with Memory](/docs/memory/overview) (Covers threads concept)
+- [createThread](/reference/memory/createThread)
+- [getThreadsByResourceId](/reference/memory/getThreadsByResourceId)

package/.docs/raw/reference/memory/getThreadsByResourceId.mdx

@@ -26,19 +26,20 @@ await memory?.getThreadsByResourceId({ resourceId: "user-123" });
     {
       name: "orderBy",
       type: "ThreadOrderBy",
-      description: "Field to sort threads by. Accepts 'createdAt' or 'updatedAt'. Default: 'createdAt'",
+      description:
+        "Field to sort threads by. Accepts 'createdAt' or 'updatedAt'. Default: 'createdAt'",
       isOptional: true,
     },
     {
       name: "sortDirection",
       type: "ThreadSortDirection",
-      description: "Sort order direction. Accepts 'ASC' or 'DESC'. Default: 'DESC'",
+      description:
+        "Sort order direction. Accepts 'ASC' or 'DESC'. Default: 'DESC'",
       isOptional: true,
     },
   ]}
 />
 
-
 ## Returns
 
 <PropertiesTable
@@ -54,7 +55,7 @@ await memory?.getThreadsByResourceId({ resourceId: "user-123" });
 
 ## Extended usage example
 
-```typescript filename="src/test-memory.ts" showLineNumbers copy
+```typescript title="src/test-memory.ts" showLineNumbers copy
 import { mastra } from "./mastra";
 
 const agent = mastra.getAgent("agent");
@@ -63,7 +64,7 @@ const memory = await agent.getMemory();
 const thread = await memory?.getThreadsByResourceId({
   resourceId: "user-123",
   orderBy: "updatedAt",
-  sortDirection: "ASC"
+  sortDirection: "ASC",
 });
 
 console.log(thread);
@@ -71,8 +72,8 @@ console.log(thread);
 
 ### Related
 
-- [Memory Class Reference](/reference/memory/Memory.mdx)
-- [getThreadsByResourceIdPaginated](/reference/memory/getThreadsByResourceIdPaginated.mdx) - Paginated version
-- [Getting Started with Memory](/docs/memory/overview.mdx) (Covers threads/resources concept)
-- [createThread](/reference/memory/createThread.mdx)
-- [getThreadById](/reference/memory/getThreadById.mdx)
+- [Memory Class Reference](/reference/memory/memory-class)
+- [getThreadsByResourceIdPaginated](/reference/memory/getThreadsByResourceIdPaginated) - Paginated version
+- [Getting Started with Memory](/docs/memory/overview) (Covers threads/resources concept)
+- [createThread](/reference/memory/createThread)
+- [getThreadById](/reference/memory/getThreadById)

package/.docs/raw/reference/memory/getThreadsByResourceIdPaginated.mdx

@@ -13,7 +13,7 @@ The `.getThreadsByResourceIdPaginated()` method retrieves threads associated wit
 await memory.getThreadsByResourceIdPaginated({
   resourceId: "user-123",
   page: 0,
-  perPage: 10
+  perPage: 10,
 });
 ```
 
@@ -61,14 +61,15 @@ await memory.getThreadsByResourceIdPaginated({
     {
       name: "result",
       type: "Promise<PaginationInfo & { threads: StorageThreadType[] }>",
-      description: "A promise that resolves to paginated thread results with metadata",
+      description:
+        "A promise that resolves to paginated thread results with metadata",
     },
   ]}
 />
 
 ## Extended usage example
 
-```typescript filename="src/test-memory.ts" showLineNumbers copy
+```typescript title="src/test-memory.ts" showLineNumbers copy
 import { mastra } from "./mastra";
 
 const agent = mastra.getAgent("agent");
@@ -83,7 +84,7 @@ while (hasMorePages) {
     page: currentPage,
     perPage: 25,
     orderBy: "createdAt",
-    sortDirection: "ASC"
+    sortDirection: "ASC",
   });
 
   if (!threads) {
@@ -102,8 +103,8 @@ while (hasMorePages) {
 
 ## Related
 
-- [Memory Class Reference](/reference/memory/Memory.mdx)
-- [getThreadsByResourceId](/reference/memory/getThreadsByResourceId.mdx) - Non-paginated version
-- [Getting Started with Memory](/docs/memory/overview.mdx) (Covers threads/resources concept)
-- [createThread](/reference/memory/createThread.mdx)
-- [getThreadById](/reference/memory/getThreadById.mdx)
+- [Memory Class Reference](/reference/memory/memory-class)
+- [getThreadsByResourceId](/reference/memory/getThreadsByResourceId) - Non-paginated version
+- [Getting Started with Memory](/docs/memory/overview) (Covers threads/resources concept)
+- [createThread](/reference/memory/createThread)
+- [getThreadById](/reference/memory/getThreadById)

package/.docs/raw/reference/memory/{Memory.mdx → memory-class.mdx}

@@ -9,7 +9,7 @@ The `Memory` class provides a robust system for managing conversation history an
 
 ## Usage example
 
-```typescript filename="src/mastra/agents/test-agent.ts" showLineNumbers copy
+```typescript title="src/mastra/agents/test-agent.ts" showLineNumbers copy
 import { Memory } from "@mastra/memory";
 import { Agent } from "@mastra/core/agent";
 import { openai } from "@ai-sdk/openai";
@@ -21,14 +21,14 @@ export const agent = new Agent({
   memory: new Memory({
     options: {
       workingMemory: {
-        enabled: true
-      }
-    }
-  })
+        enabled: true,
+      },
+    },
+  }),
 });
 ```
 
-> To enable `workingMemory` on an agent, you’ll need a storage provider configured on your main Mastra instance. See [Mastra class](../core/mastra-class.mdx) for more information.
+> To enable `workingMemory` on an agent, you’ll need a storage provider configured on your main Mastra instance. See [Mastra class](../core/mastra-class) for more information.
 
 ## Constructor parameters
 
@@ -37,19 +37,22 @@ export const agent = new Agent({
     {
       name: "storage",
       type: "MastraStorage",
-      description: "Storage implementation for persisting memory data. Defaults to `new DefaultStorage({ config: { url: \"file:memory.db\" } })` if not provided.",
+      description:
+        'Storage implementation for persisting memory data. Defaults to `new DefaultStorage({ config: { url: "file:memory.db" } })` if not provided.',
       isOptional: true,
     },
     {
       name: "vector",
       type: "MastraVector | false",
-      description: "Vector store for semantic search capabilities. Set to `false` to disable vector operations.",
+      description:
+        "Vector store for semantic search capabilities. Set to `false` to disable vector operations.",
       isOptional: true,
     },
     {
       name: "embedder",
       type: "EmbeddingModel<string> | EmbeddingModelV2<string>",
-      description: "Embedder instance for vector embeddings. Required when semantic recall is enabled.",
+      description:
+        "Embedder instance for vector embeddings. Required when semantic recall is enabled.",
       isOptional: true,
     },
     {
@@ -61,7 +64,8 @@ export const agent = new Agent({
     {
       name: "processors",
       type: "MemoryProcessor[]",
-      description: "Array of memory processors that can filter or transform messages before they're sent to the LLM.",
+      description:
+        "Array of memory processors that can filter or transform messages before they're sent to the LLM.",
       isOptional: true,
     },
   ]}
@@ -74,28 +78,33 @@ export const agent = new Agent({
     {
       name: "lastMessages",
       type: "number | false",
-      description: "Number of most recent messages to retrieve. Set to false to disable.",
+      description:
+        "Number of most recent messages to retrieve. Set to false to disable.",
       isOptional: true,
       defaultValue: "10",
     },
     {
       name: "semanticRecall",
       type: "boolean | { topK: number; messageRange: number | { before: number; after: number }; scope?: 'thread' | 'resource' }",
-      description: "Enable semantic search in message history. Can be a boolean or an object with configuration options. When enabled, requires both vector store and embedder to be configured.",
+      description:
+        "Enable semantic search in message history. Can be a boolean or an object with configuration options. When enabled, requires both vector store and embedder to be configured. Default topK is 4, default messageRange is {before: 1, after: 1}.",
       isOptional: true,
       defaultValue: "false",
     },
     {
       name: "workingMemory",
       type: "WorkingMemory",
-      description: "Configuration for working memory feature. Can be `{ enabled: boolean; template?: string; schema?: ZodObject<any> | JSONSchema7; scope?: 'thread' | 'resource' }` or `{ enabled: boolean }` to disable.",
+      description:
+        "Configuration for working memory feature. Can be `{ enabled: boolean; template?: string; schema?: ZodObject<any> | JSONSchema7; scope?: 'thread' | 'resource' }` or `{ enabled: boolean }` to disable.",
       isOptional: true,
-      defaultValue: "{ enabled: false, template: '# User Information\\n- **First Name**:\\n- **Last Name**:\\n...' }",
+      defaultValue:
+        "{ enabled: false, template: '# User Information\\n- **First Name**:\\n- **Last Name**:\\n...' }",
     },
     {
       name: "threads",
       type: "{ generateTitle?: boolean | { model: DynamicArgument<MastraLanguageModel>; instructions?: DynamicArgument<string> } }",
-      description: "Settings related to memory thread creation. `generateTitle` controls automatic thread title generation from the user's first message. Can be a boolean or an object with custom model and instructions.",
+      description:
+        "Settings related to memory thread creation. `generateTitle` controls automatic thread title generation from the user's first message. Can be a boolean or an object with custom model and instructions.",
       isOptional: true,
       defaultValue: "{ generateTitle: false }",
     },
@@ -114,10 +123,9 @@ export const agent = new Agent({
   ]}
 />
 
-
 ## Extended usage example
 
-```typescript filename="src/mastra/agents/test-agent.ts" showLineNumbers copy
+```typescript title="src/mastra/agents/test-agent.ts" showLineNumbers copy
 import { Memory } from "@mastra/memory";
 import { Agent } from "@mastra/core/agent";
 import { openai } from "@ai-sdk/openai";
@@ -129,32 +137,32 @@ export const agent = new Agent({
   model: openai("gpt-4o"),
   memory: new Memory({
     storage: new LibSQLStore({
-      url: "file:./working-memory.db"
+      url: "file:./working-memory.db",
     }),
     vector: new LibSQLVector({
-      connectionUrl: "file:./vector-memory.db"
+      connectionUrl: "file:./vector-memory.db",
     }),
     options: {
       lastMessages: 10,
       semanticRecall: {
         topK: 3,
         messageRange: 2,
-        scope: 'resource'
+        scope: "resource",
       },
       workingMemory: {
-        enabled: true
+        enabled: true,
       },
       threads: {
-        generateTitle: true
-      }
-    }
-  })
+        generateTitle: true,
+      },
+    },
+  }),
 });
 ```
 
 ## PostgreSQL with index configuration
 
-```typescript filename="src/mastra/agents/pg-agent.ts" showLineNumbers copy
+```typescript title="src/mastra/agents/pg-agent.ts" showLineNumbers copy
 import { Memory } from "@mastra/memory";
 import { Agent } from "@mastra/core/agent";
 import { openai } from "@ai-sdk/openai";
@@ -166,10 +174,10 @@ export const agent = new Agent({
   model: openai("gpt-4o"),
   memory: new Memory({
     storage: new PgStore({
-      connectionString: process.env.DATABASE_URL
+      connectionString: process.env.DATABASE_URL,
     }),
     vector: new PgVector({
-      connectionString: process.env.DATABASE_URL
+      connectionString: process.env.DATABASE_URL,
     }),
     embedder: openai.embedding("text-embedding-3-small"),
     options: {
@@ -177,30 +185,30 @@ export const agent = new Agent({
       semanticRecall: {
         topK: 5,
         messageRange: 3,
-        scope: 'resource',
+        scope: "resource",
         indexConfig: {
-          type: 'hnsw',              // Use HNSW for better performance
-          metric: 'dotproduct',      // Optimal for OpenAI embeddings
-          m: 16,                     // Number of bi-directional links
-          efConstruction: 64         // Construction-time candidate list size
-        }
+          type: "hnsw", // Use HNSW for better performance
+          metric: "dotproduct", // Optimal for OpenAI embeddings
+          m: 16, // Number of bi-directional links
+          efConstruction: 64, // Construction-time candidate list size
+        },
       },
       workingMemory: {
-        enabled: true
-      }
-    }
-  })
+        enabled: true,
+      },
+    },
+  }),
 });
 ```
 
 ### Related
 
-- [Getting Started with Memory](/docs/memory/overview.mdx)
-- [Semantic Recall](/docs/memory/semantic-recall.mdx)
-- [Working Memory](/docs/memory/working-memory.mdx)
-- [Memory Processors](/docs/memory/memory-processors.mdx)
-- [createThread](/reference/memory/createThread.mdx)
-- [query](/reference/memory/query.mdx)
-- [getThreadById](/reference/memory/getThreadById.mdx)
-- [getThreadsByResourceId](/reference/memory/getThreadsByResourceId.mdx)
-- [deleteMessages](/reference/memory/deleteMessages.mdx)
+- [Getting Started with Memory](/docs/memory/overview)
+- [Semantic Recall](/docs/memory/semantic-recall)
+- [Working Memory](/docs/memory/working-memory)
+- [Memory Processors](/docs/memory/memory-processors)
+- [createThread](/reference/memory/createThread)
+- [query](/reference/memory/query)
+- [getThreadById](/reference/memory/getThreadById)
+- [getThreadsByResourceId](/reference/memory/getThreadsByResourceId)
+- [deleteMessages](/reference/memory/deleteMessages)

package/.docs/raw/reference/memory/query.mdx

@@ -20,13 +20,15 @@ await memory?.query({ threadId: "user-123" });
     {
       name: "threadId",
       type: "string",
-      description: "The unique identifier of the thread to retrieve messages from",
+      description:
+        "The unique identifier of the thread to retrieve messages from",
       isOptional: false,
     },
     {
       name: "resourceId",
       type: "string",
-      description: "Optional ID of the resource that owns the thread. If provided, validates thread ownership",
+      description:
+        "Optional ID of the resource that owns the thread. If provided, validates thread ownership",
       isOptional: true,
     },
     {
@@ -38,13 +40,15 @@ await memory?.query({ threadId: "user-123" });
     {
       name: "threadConfig",
       type: "MemoryConfig",
-      description: "Configuration options for message retrieval and semantic search",
+      description:
+        "Configuration options for message retrieval and semantic search",
       isOptional: true,
     },
     {
       name: "format",
       type: "'v1' | 'v2'",
-      description: "Message format to return. Defaults to 'v2' for current format, 'v1' for backwards compatibility",
+      description:
+        "Message format to return. Defaults to 'v2' for current format, 'v1' for backwards compatibility",
       isOptional: true,
     },
   ]}
@@ -57,25 +61,29 @@ await memory?.query({ threadId: "user-123" });
     {
       name: "vectorSearchString",
       type: "string",
-      description: "Search string for finding semantically similar messages. Requires semantic recall to be enabled in threadConfig.",
+      description:
+        "Search string for finding semantically similar messages. Requires semantic recall to be enabled in threadConfig.",
       isOptional: true,
     },
     {
       name: "last",
       type: "number | false",
-      description: "Number of most recent messages to retrieve. Set to false to disable limit. Note: threadConfig.lastMessages (default: 10) will override this if smaller.",
+      description:
+        "Number of most recent messages to retrieve. Set to false to disable limit. Note: threadConfig.lastMessages (default: 10) will override this if smaller.",
       isOptional: true,
     },
     {
       name: "include",
       type: "{ id: string; threadId?: string; withPreviousMessages?: number; withNextMessages?: number }[]",
-      description: "Array of specific message IDs to include with optional context messages. Each item has an `id` (required), optional `threadId` (defaults to main threadId), `withPreviousMessages` (number of messages before, defaults to 2 for vector search, 0 otherwise), and `withNextMessages` (number of messages after, defaults to 2 for vector search, 0 otherwise).",
+      description:
+        "Array of specific message IDs to include with optional context messages. Each item has an `id` (required), optional `threadId` (defaults to main threadId), `withPreviousMessages` (number of messages before, defaults to 2 for vector search, 0 otherwise), and `withNextMessages` (number of messages after, defaults to 2 for vector search, 0 otherwise).",
       isOptional: true,
     },
     {
       name: "pagination",
       type: "{ dateRange?: { start?: Date; end?: Date }; page?: number; perPage?: number }",
-      description: "Pagination options for retrieving messages in batches. Includes `dateRange` (filter by date range), `page` (0-based page number), and `perPage` (messages per page).",
+      description:
+        "Pagination options for retrieving messages in batches. Includes `dateRange` (filter by date range), `page` (0-based page number), and `perPage` (messages per page).",
       isOptional: true,
     },
   ]}
@@ -88,28 +96,33 @@ await memory?.query({ threadId: "user-123" });
     {
       name: "lastMessages",
       type: "number | false",
-      description: "Number of most recent messages to retrieve. Set to false to disable.",
+      description:
+        "Number of most recent messages to retrieve. Set to false to disable.",
       isOptional: true,
       defaultValue: "10",
     },
     {
       name: "semanticRecall",
       type: "boolean | { topK: number; messageRange: number | { before: number; after: number }; scope?: 'thread' | 'resource' }",
-      description: "Enable semantic search in message history. Can be a boolean or an object with configuration options. When enabled, requires both vector store and embedder to be configured.",
+      description:
+        "Enable semantic search in message history. Can be a boolean or an object with configuration options. When enabled, requires both vector store and embedder to be configured.",
       isOptional: true,
       defaultValue: "false",
     },
     {
       name: "workingMemory",
       type: "WorkingMemory",
-      description: "Configuration for working memory feature. Can be `{ enabled: boolean; template?: string; schema?: ZodObject<any> | JSONSchema7; scope?: 'thread' | 'resource' }` or `{ enabled: boolean }` to disable.",
+      description:
+        "Configuration for working memory feature. Can be `{ enabled: boolean; template?: string; schema?: ZodObject<any> | JSONSchema7; scope?: 'thread' | 'resource' }` or `{ enabled: boolean }` to disable.",
       isOptional: true,
-      defaultValue: "{ enabled: false, template: '# User Information\\n- **First Name**:\\n- **Last Name**:\\n...' }",
+      defaultValue:
+        "{ enabled: false, template: '# User Information\\n- **First Name**:\\n- **Last Name**:\\n...' }",
     },
     {
       name: "threads",
       type: "{ generateTitle?: boolean | { model: DynamicArgument<MastraLanguageModel>; instructions?: DynamicArgument<string> } }",
-      description: "Settings related to memory thread creation. `generateTitle` controls automatic thread title generation from the user's first message. Can be a boolean or an object with custom model and instructions.",
+      description:
+        "Settings related to memory thread creation. `generateTitle` controls automatic thread title generation from the user's first message. Can be a boolean or an object with custom model and instructions.",
       isOptional: true,
       defaultValue: "{ generateTitle: false }",
     },
@@ -128,14 +141,15 @@ await memory?.query({ threadId: "user-123" });
     {
       name: "uiMessages",
       type: "UIMessageWithMetadata[]",
-      description: "Array of messages formatted for UI display, including proper threading of tool calls and results",
+      description:
+        "Array of messages formatted for UI display, including proper threading of tool calls and results",
     },
   ]}
 />
 
 ## Extended usage example
 
-```typescript filename="src/test-memory.ts" showLineNumbers copy
+```typescript title="src/test-memory.ts" showLineNumbers copy
 import { mastra } from "./mastra";
 
 const agent = mastra.getAgent("agent");
@@ -148,18 +162,18 @@ const { messages, uiMessages } = await memory!.query({
     vectorSearchString: "What messages are there?",
     include: [
       {
-        id: "msg-123"
+        id: "msg-123",
       },
       {
         id: "msg-456",
         withPreviousMessages: 3,
-        withNextMessages: 1
-      }
-    ]
+        withNextMessages: 1,
+      },
+    ],
   },
   threadConfig: {
-    semanticRecall: true
-  }
+    semanticRecall: true,
+  },
 });
 
 console.log(messages);
@@ -168,7 +182,7 @@ console.log(uiMessages);
 
 ### Related
 
-- [Memory Class Reference](/reference/memory/Memory.mdx)
-- [Getting Started with Memory](/docs/memory/overview.mdx)
-- [Semantic Recall](/docs/memory/semantic-recall.mdx)
-- [createThread](/reference/memory/createThread.mdx)
+- [Memory Class Reference](/reference/memory/memory-class)
+- [Getting Started with Memory](/docs/memory/overview)
+- [Semantic Recall](/docs/memory/semantic-recall)
+- [createThread](/reference/memory/createThread)

package/.docs/raw/reference/observability/ai-tracing/ai-tracing.mdx

@@ -1,10 +1,9 @@
 ---
-title: "AITracing | AI Tracing | Reference"
+title: "Reference: AITracing | Observability | Mastra Docs"
 description: Core AI Tracing classes and methods
-asIndexPage: true
 ---
 
-import { PropertiesTable } from "@/components/properties-table";
+import PropertiesTable from "@site/src/components/PropertiesTable";
 
 # AITracing
 
@@ -137,10 +136,10 @@ class CustomAITracing extends BaseAITracing {
     super(config);
     // Custom initialization
   }
-  
+
   // Override methods as needed
   startSpan<TType extends AISpanType>(
-    options: StartSpanOptions<TType>
+    options: StartSpanOptions<TType>,
   ): AISpan<TType> {
     // Custom span creation logic
     return super.startSpan(options);
@@ -159,6 +158,7 @@ class NoOpAISpan<TType extends AISpanType> extends BaseAISpan<TType>
 ```
 
 A span that performs no operations. All methods are no-ops:
+
 - `id` returns `'no-op'`
 - `traceId` returns `'no-op-trace'`
 - `isValid` returns `false`
@@ -168,15 +168,18 @@ A span that performs no operations. All methods are no-ops:
 ## See Also
 
 ### Documentation
+
 - [AI Tracing Overview](/docs/observability/ai-tracing/overview) - Concepts and usage guide
 - [Configuration Reference](/reference/observability/ai-tracing/configuration) - Configuration options
 - [Interfaces Reference](/reference/observability/ai-tracing/interfaces) - Type definitions
 - [Span Reference](/reference/observability/ai-tracing/span) - Span lifecycle and methods
 
 ### Examples
+
 - [Basic AI Tracing](/examples/observability/basic-ai-tracing) - Getting started example
 
 ### Exporters
+
 - [DefaultExporter](/reference/observability/ai-tracing/exporters/default-exporter) - Storage persistence
 - [CloudExporter](/reference/observability/ai-tracing/exporters/cloud-exporter) - Mastra Cloud integration
-- [ConsoleExporter](/reference/observability/ai-tracing/exporters/console-exporter) - Debug output
+- [ConsoleExporter](/reference/observability/ai-tracing/exporters/console-exporter) - Debug output