@mastra/mcp-docs-server 0.13.4 → 0.13.5-alpha.0

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

@@ -63,6 +63,7 @@ const memory = new Memory({
       // Or use a different model for title generation
       // generateTitle: {
       //   model: openai("gpt-4.1-nano"), // Use cheaper model for titles
+      //   instructions: "Generate a concise title based on the initial user message.", // Custom instructions for title
       // },
     },
   },
@@ -109,9 +110,9 @@ const memory = new Memory({
 });
 ```
 
-#### Cost Optimization with Custom Models
+#### Cost Optimization with Custom Models and Instructions
 
-You can specify a different (typically cheaper) model for title generation while using a high-quality model for the main conversation:
+You can specify a different (typically cheaper) model and custom instructions for title generation while using a high-quality model for the main conversation:
 
 ```typescript copy showLineNumbers
 import { openai } from "@ai-sdk/openai";
@@ -121,6 +122,7 @@ const memory = new Memory({
     threads: {
       generateTitle: {
         model: openai("gpt-4.1-nano"), // Cheaper model for titles
+        instructions: "Generate a concise, friendly title based on the initial user message.", // Custom title instructions
       },
     },
   },
@@ -132,9 +134,9 @@ const agent = new Agent({
 });
 ```
 
-#### Dynamic Model Selection
+#### Dynamic Model Selection and Instructions
 
-You can also use a function to dynamically determine the model based on runtime context:
+You can also use a function to dynamically determine the model and instructions based on runtime context:
 
 ```typescript copy showLineNumbers
 const memory = new Memory({
@@ -148,6 +150,10 @@ const memory = new Memory({
             ? openai("gpt-4.1")
             : openai("gpt-4.1-nano");
         },
+        instructions: (ctx: RuntimeContext) => {
+          const language = ctx.get("userLanguage") || "English";
+          return `Generate a concise, engaging title in ${language} based on the user's first message.`;
+        },
       },
     },
   },
@@ -285,9 +291,9 @@ Mastra supports many embedding models through the [Vercel AI SDK](https://sdk.ve
     },
     {
       name: "threads",
-      type: "{ generateTitle?: boolean | { model: LanguageModelV1 | ((ctx: RuntimeContext) => LanguageModelV1 | Promise<LanguageModelV1>) } }",
+      type: "{ generateTitle?: boolean | { model: LanguageModelV1 | ((ctx: RuntimeContext) => LanguageModelV1 | Promise<LanguageModelV1>), instructions?: string | ((ctx: RuntimeContext) => string | Promise<string>) } }",
       description:
-        "Settings related to memory thread creation. `generateTitle` controls automatic thread title generation from the user's first message. Can be a boolean to enable/disable using the agent's model, or an object with a custom model for title generation (useful for cost optimization). Example: { generateTitle: { model: openai('gpt-4.1-nano') } }",
+        "Settings related to memory thread creation. `generateTitle` controls automatic thread title generation from the user's first message. Can be a boolean to enable/disable using the agent's model, or an object specifying a custom model or custom instructions for title generation (useful for cost optimization or title customization). Example: { generateTitle: { model: openai('gpt-4.1-nano'), instructions: 'Concise title based on the initial user message.' } }",
       isOptional: true,
       defaultValue: "{ generateTitle: false }",
     },

package/.docs/raw/reference/workflows/create-run.mdx

@@ -1,11 +1,11 @@
 ---
-title: "Reference: Workflow.createRun() | Building Workflows | Mastra Docs"
-description: Documentation for the `.createRun()` method in workflows, which creates a new workflow run instance.
+title: "Reference: Workflow.createRunAsync() | Building Workflows | Mastra Docs"
+description: Documentation for the `.createRunAsync()` method in workflows, which creates a new workflow run instance.
 ---
 
-# Workflow.createRun()
+# Workflow.createRunAsync()
 
-The `.createRun()` method creates a new workflow run instance, allowing you to execute the workflow with specific input data.
+The `.createRunAsync()` method creates a new workflow run instance, allowing you to execute the workflow with specific input data.
 
 ## Usage
 

package/.docs/raw/reference/workflows/sendEvent.mdx

@@ -0,0 +1,49 @@
+---
+title: "Reference: Workflow.sendEvent() | Building Workflows | Mastra Docs"
+description: Documentation for the `.sendEvent()` method in workflows, which resumes execution when an event is sent.
+---
+
+# Workflow.sendEvent()
+
+The `.sendEvent()` resumes execution when an event is sent.
+
+## Usage
+
+```typescript
+workflow.sendEvent('my-event-name', step1);
+```
+
+## Parameters
+
+<PropertiesTable
+  content={[
+    {
+      name: "eventName",
+      type: "string",
+      description: "The name of the event to send",
+      isOptional: false,
+    },
+    {
+      name: "step",
+      type: "Step",
+      description: "The step to resume after the event is sent",
+      isOptional: false,
+    },
+  ]}
+/>
+
+## Returns
+
+<PropertiesTable
+  content={[
+    {
+      name: "workflow",
+      type: "Workflow",
+      description: "The workflow instance for method chaining",
+    },
+  ]}
+/>
+
+## Related
+
+- [Sleep & Events](../../docs/workflows/pausing-execution.mdx)

package/.docs/raw/workflows/overview.mdx

@@ -176,7 +176,7 @@ console.log(JSON.stringify(result, null, 2));
 
 To trigger this workflow, run the following:
 
-```bash
+```bash copy
 npx tsx src/test-workflow.ts
 ```
 

package/.docs/raw/workflows/pausing-execution.mdx

@@ -5,56 +5,93 @@ description: "Pausing execution in Mastra workflows allows you to pause executio
 
 # Sleep & Events
 
-Pausing execution in Mastra workflows allows you to pause execution while waiting for external input or resources via `sleep()`, `sleepUntil()` and `waitForEvent()`.
+Mastra lets you pause workflow execution when waiting for external input or timing conditions. This can be useful for things like polling, delayed retries, or waiting on user actions.
 
-This sets the workflow status to `waiting`.
+You can pause execution using:
 
-## sleep()
+- `sleep()`: Pause for a set number of milliseconds
+- `sleepUntil()`: Pause until a specific timestamp
+- `waitForEvent()`: Pause until an external event is received
+- `sendEvent()`: Send an event to resume a waiting workflow
 
-`sleep()` pauses execution for a specified number of milliseconds.
+When using any of these methods, the workflow status is set to `waiting` until execution resumes.
 
-```typescript
-workflow
-    .then(step1)
-    .sleep(1000)
-    .then(step2)
-    .commit();
+## sleep
+
+The `sleep()` method pauses execution between steps for a specified number of milliseconds.
+
+```typescript {9} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+import { createWorkflow, createStep } from "@mastra/core/workflows";
+import { z } from "zod";
+
+const step1 = createStep({...});
+const step2 = createStep({...});
+
+export const testWorkflow = createWorkflow({...})
+  .then(step1)
+  .sleep(1000)
+  .then(step2)
+  .commit();
 ```
 
-## sleepUntil()
+## sleepUntil
 
-`sleepUntil()` pauses execution until a specified date.
+The `sleepUntil()` method pauses execution between steps until a specified date.
 
-```typescript
-workflow
-    .then(step1)
-    .sleepUntil(new Date(Date.now() + 1000))
-    .then(step2)
-    .commit();
+```typescript {9} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+import { createWorkflow, createStep } from "@mastra/core/workflows";
+import { z } from "zod";
+
+const step1 = createStep({...});
+const step2 = createStep({...});
+
+export const testWorkflow = createWorkflow({...})
+  .then(step1)
+  .sleepUntil(new Date(Date.now() + 5000))
+  .then(step2)
+  .commit();
 ```
 
-## waitForEvent()
+> `Date.now()` is evaluated when the workflow starts, not at the moment the `sleepUntil()` method is called.
 
-`waitForEvent()` pauses execution until an event is received. Events can be sent to the workflow using `run.sendEvent()`. The event name and the step to resume after the event is received are provided as arguments to `waitForEvent()`.
+## waitForEvent
 
-`.sendEvent()` takes as arguments the event name and the event data. The event data is optional and can be any JSON-serializable value.
+The `waitForEvent()` method pauses execution until a specific event is received. Use `run.sendEvent()` to send the event. You must provide both the event name and the step to resume.
 
-```typescript
-workflow
-    .then(step1)
-    .waitForEvent('my-event-name', step2)
-    .then(step3)
-    .commit();
+```typescript {10} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+import { createWorkflow, createStep } from "@mastra/core/workflows";
+import { z } from "zod";
 
-const run = await workflow.createRunAsync()
-run.start({})
+const step1 = createStep({...});
+const step2 = createStep({...});
+const step3 = createStep({...});
+
+export const testWorkflow = createWorkflow({...})
+  .then(step1)
+  .waitForEvent("my-event-name", step2)
+  .then(step3)
+  .commit();
+```
+## sendEvent
+
+The `.sendEvent()` method sends an event to the workflow. It accepts the event name and optional event data, which can be any JSON-serializable value.
+
+```typescript {5,12,15} filename="src/test-workflow.ts" showLineNumbers copy
+import { mastra } from "./mastra";
+
+const run = await mastra.getWorkflow("testWorkflow").createRunAsync();
+
+const result = run.start({
+  inputData: {
+    value: "hello"
+  }
+});
 
 setTimeout(() => {
-    run.sendEvent('my-event-name', {
-        data1: 'hello',
-        data2: {
-            anyData: 12
-        }
-    })
-}, 2e3)
-```
+  run.sendEvent("my-event-name", { value: "from event" });
+}, 3000);
+
+console.log(JSON.stringify(await result, null, 2));
+```
+
+> In this example, avoid using `await run.start()` directly, it would block sending the event before the workflow reaches its waiting state.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "0.13.4",
+  "version": "0.13.5-alpha.0",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -32,7 +32,7 @@
     "uuid": "^11.1.0",
     "zod": "^3.25.67",
     "zod-to-json-schema": "^3.24.5",
-    "@mastra/mcp": "^0.10.5"
+    "@mastra/mcp": "^0.10.6-alpha.0"
   },
   "devDependencies": {
     "@hono/node-server": "^1.14.4",
@@ -42,13 +42,13 @@
     "@wong2/mcp-cli": "^1.10.0",
     "cross-env": "^7.0.3",
     "eslint": "^9.29.0",
-    "hono": "^4.8.3",
+    "hono": "^4.8.4",
     "tsup": "^8.5.0",
     "tsx": "^4.19.4",
     "typescript": "^5.8.3",
     "vitest": "^3.2.4",
     "@internal/lint": "0.0.17",
-    "@mastra/core": "0.10.10"
+    "@mastra/core": "0.10.11-alpha.2"
   },
   "peerDependencies": {
     "@mastra/core": "^0.10.0-alpha.0"