@mastra/mcp-docs-server 0.13.37 → 0.13.38

package/.docs/raw/reference/legacyWorkflows/suspend.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Reference: suspend() | Control Flow | Mastra Docs"
+title: "Reference: suspend() | Legacy Workflows | Mastra Docs"
 description: "Documentation for the suspend function in Mastra workflows, which pauses execution until resumed."
 ---
 
@@ -65,6 +65,6 @@ const reviewStep = new LegacyStep({
 
 ### Related
 
-- [Suspend & Resume Workflows](../../docs/workflows-legacy/suspend-and-resume.mdx)
-- [.resume()](./resume.mdx)
-- [.watch()](./watch.mdx)
+- [Suspend & Resume Workflows](/docs/workflows-legacy/suspend-and-resume)
+- [.resume()](./resume)
+- [.watch()](./watch)

package/.docs/raw/reference/legacyWorkflows/then.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Reference: Workflow.then() | Building Workflows (Legacy) | Mastra Docs"
+title: "Reference: Workflow.then() | Legacy Workflows | Mastra Docs"
 description: Documentation for the `.then()` method in workflows, which creates sequential dependencies between steps.
 ---
 
@@ -66,7 +66,7 @@ try {
 
 ## Related
 
-- [step Reference](./step-class.mdx)
-- [after Reference](./after.mdx)
-- [Sequential Steps Example](../../examples/workflows_legacy/sequential-steps.mdx)
-- [Control Flow Guide](../../docs/workflows-legacy/control-flow.mdx)
+- [step Reference](./step-class)
+- [after Reference](./after)
+- [Sequential Steps Example](/examples/workflows_legacy/sequential-steps)
+- [Control Flow Guide](/docs/workflows-legacy/control-flow)

package/.docs/raw/reference/legacyWorkflows/until.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Reference: Workflow.until() | Looping in Workflows (Legacy) | Mastra Docs"
+title: "Reference: Workflow.until() | Legacy Workflows | Mastra Docs"
 description: "Documentation for the `.until()` method in Mastra workflows, which repeats a step until a specified condition becomes true."
 ---
 
@@ -163,6 +163,6 @@ const result = await run.start({
 
 ## Related
 
-- [.while()](./while.mdx) - Loop while a condition is true
-- [Control Flow Guide](../../docs/workflows-legacy/control-flow.mdx)
-- [Workflow Class Reference](./workflow.mdx)
+- [.while()](./while) - Loop while a condition is true
+- [Control Flow Guide](/docs/workflows-legacy/control-flow)
+- [Workflow Class Reference](./workflow)

package/.docs/raw/reference/legacyWorkflows/watch.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Reference: run.watch() | Workflows (Legacy) | Mastra Docs"
+title: "Reference: run.watch() | Legacy Workflows | Mastra Docs"
 description: Documentation for the `.watch()` method in workflows, which monitors the status of a workflow run.
 ---
 
@@ -120,5 +120,5 @@ run.watch(({ results, activePaths }) => {
 
 ### Related
 
-- [Workflow Creation](./createRun.mdx)
-- [Step Configuration](./step-class.mdx)
+- [Workflow Creation](./createRun)
+- [Step Configuration](./step-class)

package/.docs/raw/reference/legacyWorkflows/while.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Reference: Workflow.while() | Looping in Workflows (Legacy) | Mastra Docs"
+title: "Reference: Workflow.while() | Legacy Workflows | Mastra Docs"
 description: "Documentation for the `.while()` method in Mastra workflows, which repeats a step as long as a specified condition remains true."
 ---
 
@@ -163,6 +163,6 @@ const result = await run.start({
 
 ## Related
 
-- [.until()](./until.mdx) - Loop until a condition becomes true
-- [Control Flow Guide](../../docs/workflows-legacy/control-flow.mdx)
-- [Workflow Class Reference](./workflow.mdx)
+- [.until()](./until) - Loop until a condition becomes true
+- [Control Flow Guide](/docs/workflows-legacy/control-flow)
+- [Workflow Class Reference](./workflow)

package/.docs/raw/reference/legacyWorkflows/workflow.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Reference: Workflow Class | Building Workflows (Legacy) | Mastra Docs"
+title: "Reference: Workflow Class | Legacy Workflows | Mastra Docs"
 description: Documentation for the Workflow class in Mastra, which enables you to create state machines for complex sequences of operations with conditional branching and data validation.
 ---
 
@@ -47,7 +47,7 @@ const workflow = new LegacyWorkflow({ name: "my-workflow" });
 
 #### `step()`
 
-Adds a [Step](./step-class.mdx) to the workflow, including transitions to other steps. Returns the workflow instance for chaining. [Learn more about steps](./step-class.mdx).
+Adds a [Step](./step-class) to the workflow, including transitions to other steps. Returns the workflow instance for chaining. [Learn more about steps](./step-class).
 
 #### `commit()`
 
@@ -55,7 +55,7 @@ Validates and finalizes the workflow configuration. Must be called after adding
 
 #### `execute()`
 
-Executes the workflow with optional trigger data. Typed based on the [trigger schema](./workflow.mdx#trigger-schemas).
+Executes the workflow with optional trigger data. Typed based on the [trigger schema](./workflow#trigger-schemas).
 
 ## Trigger Schemas
 
@@ -228,7 +228,7 @@ The context object:
 
 ## Related Documentation
 
-- [Step](./step-class.mdx)
-- [.then()](./then.mdx)
-- [.step()](./step-function.mdx)
-- [.after()](./after.mdx)
+- [Step](./step-class)
+- [.then()](./then)
+- [.step()](./step-function)
+- [.after()](./after)

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

@@ -85,7 +85,7 @@ await memory?.createThread({ 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");
@@ -96,15 +96,15 @@ const thread = await memory?.createThread({
   title: "Memory Test Thread",
   metadata: {
     source: "test-script",
-    purpose: "memory-testing"
-  }
+    purpose: "memory-testing",
+  },
 });
 
 const response = await agent.generate("message for agent", {
   memory: {
     thread: thread!.id,
-    resource: thread!.resourceId
-  }
+    resource: thread!.resourceId,
+  },
 });
 
 console.log(response.text);
@@ -112,8 +112,8 @@ console.log(response.text);
 
 ### Related
 
-- [Memory Class Reference](/reference/memory/Memory.mdx)
-- [Getting Started with Memory](/docs/memory/overview.mdx) (Covers threads concept)
-- [getThreadById](/reference/memory/getThreadById.mdx)
-- [getThreadsByResourceId](/reference/memory/getThreadsByResourceId.mdx)
-- [query](/reference/memory/query.mdx)
+- [Memory Class Reference](/reference/memory/memory-class)
+- [Getting Started with Memory](/docs/memory/overview) (Covers threads concept)
+- [getThreadById](/reference/memory/getThreadById)
+- [getThreadsByResourceId](/reference/memory/getThreadsByResourceId)
+- [query](/reference/memory/query)

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,7 +78,8 @@ 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",
     },
@@ -88,14 +93,17 @@ export const agent = new Agent({
     {
       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 +122,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 +136,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 +173,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 +184,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)