@mastra/mcp-docs-server 1.0.0-beta.11 → 1.0.0-beta.14

package/.docs/raw/guides/guide/chef-michel.mdx

@@ -31,7 +31,7 @@ To create an agent in Mastra use the `Agent` class to define it and then registe
 
 Create a new file `src/mastra/agents/chefAgent.ts` and define your agent:
 
-```ts copy title="src/mastra/agents/chefAgent.ts"
+```ts title="src/mastra/agents/chefAgent.ts"
 import { Agent } from "@mastra/core/agent";
 
 export const chefAgent = new Agent({
@@ -50,7 +50,7 @@ export const chefAgent = new Agent({
 
 In your `src/mastra/index.ts` file, register the agent:
 
-```ts copy title="src/mastra/index.ts" {2, 5}
+```ts title="src/mastra/index.ts" {2, 5}
 import { Mastra } from "@mastra/core";
 import { chefAgent } from "./agents/chefAgent";
 
@@ -73,7 +73,7 @@ Depending on your requirements you can interact and get responses from the agent
 
 Create a new file `src/index.ts` and add a `main()` function to it. Inside, craft a query to ask the agent and log its response.
 
-```ts copy title="src/index.ts"
+```ts title="src/index.ts"
 import { chefAgent } from "./mastra/agents/chefAgent";
 
 async function main() {
@@ -90,7 +90,7 @@ main();
 
 Afterwards, run the script:
 
-```bash copy
+```bash
 npx bun src/index.ts
 ```
 
@@ -108,7 +108,7 @@ Query: In my kitchen I have: pasta, canned tomatoes, garlic, olive oil, and some
 
 In the previous example you might have waited a bit for the response without any sign of progress. To show the agent's output as it creates it you should instead stream its response to the terminal.
 
-```ts copy title="src/index.ts"
+```ts title="src/index.ts"
 import { chefAgent } from "./mastra/agents/chefAgent";
 
 async function main() {
@@ -132,7 +132,7 @@ main();
 
 Afterwards, run the script again:
 
-```bash copy
+```bash
 npx bun src/index.ts
 ```
 
@@ -155,7 +155,7 @@ Instead of showing the agent's response to a human you might want to pass it alo
 
 Change your `src/index.ts` to the following:
 
-```ts copy title="src/index.ts"
+```ts title="src/index.ts"
 import { chefAgent } from "./mastra/agents/chefAgent";
 import { z } from "zod";
 
@@ -198,12 +198,10 @@ Query: I want to make lasagna, can you generate a lasagna recipe for me?
   ingredients: [
     { name: "Lasagna noodles", amount: "12 sheets" },
     { name: "Ground beef", amount: "1 pound" },
-    // ...
   ],
   steps: [
     "Preheat oven to 375°F (190°C).",
     "Cook the lasagna noodles according to package instructions.",
-    // ...
   ]
 }
 ```
@@ -222,7 +220,7 @@ Learn how to interact with your agent through Mastra's API.
 
 You can run your agent as a service using the `mastra dev` command:
 
-```bash copy
+```bash
 mastra dev
 ```
 
@@ -244,7 +242,7 @@ POST http://localhost:4111/api/agents/chefAgent/generate
 
 You can interact with the agent using `curl` from the command line:
 
-```bash copy
+```bash
 curl -X POST http://localhost:4111/api/agents/chefAgent/generate \
   -H "Content-Type: application/json" \
   -d '{

package/.docs/raw/guides/guide/notes-mcp-server.mdx

@@ -30,7 +30,7 @@ Before you can create an MCP server you first need to install additional depende
 
 Add `@mastra/mcp` to your project:
 
-```bash copy
+```bash
 npm install @mastra/mcp@beta
 ```
 
@@ -40,13 +40,13 @@ npm install @mastra/mcp@beta
 
 After following the default [installation guide](/guides/v1/getting-started/quickstart) your project will include files that are not relevant for this guide. You can safely remove them:
 
-```bash copy
+```bash
 rm -rf src/mastra/agents src/mastra/workflows src/mastra/tools/weather-tool.ts
 ```
 
 You should also change the `src/mastra/index.ts` file like so:
 
-```ts copy title="src/mastra/index.ts"
+```ts title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
 import { PinoLogger } from "@mastra/loggers";
 import { LibSQLStore } from "@mastra/libsql";
@@ -70,13 +70,13 @@ export const mastra = new Mastra({
 
 Create a dedicated directory for your MCP server's logic and a `notes` directory for your notes:
 
-```bash copy
+```bash
 mkdir notes src/mastra/mcp
 ```
 
 Create the following files:
 
-```bash copy
+```bash
 touch src/mastra/mcp/{server,resources,prompts}.ts
 ```
 
@@ -113,7 +113,7 @@ Let's add the MCP server!
 
 In `src/mastra/mcp/server.ts`, define the MCP server instance:
 
-```typescript copy title="src/mastra/mcp/server.ts"
+```typescript title="src/mastra/mcp/server.ts"
 import { MCPServer } from "@mastra/mcp";
 
 export const notes = new MCPServer({
@@ -126,7 +126,7 @@ export const notes = new MCPServer({
 
 Register this MCP server in your Mastra instance at `src/mastra/index.ts`. The key `notes` is the public identifier for your MCP server:
 
-```typescript copy title="src/mastra/index.ts" {4, 15-17}
+```typescript title="src/mastra/index.ts" {4, 15-17}
 import { Mastra } from "@mastra/core";
 import { PinoLogger } from "@mastra/loggers";
 import { LibSQLStore } from "@mastra/libsql";
@@ -154,7 +154,7 @@ export const mastra = new Mastra({
 
 Resource handlers allow clients to discover and read the content your server manages. Implement handlers to work with markdown files in the `notes` directory. Add to the `src/mastra/mcp/resources.ts` file:
 
-```typescript copy title="src/mastra/mcp/resources.ts"
+```typescript title="src/mastra/mcp/resources.ts"
 import fs from "fs/promises";
 import path from "path";
 import { fileURLToPath } from "url";
@@ -210,7 +210,7 @@ export const resourceHandlers: MCPServerResources = {
 
 Register these resource handlers in `src/mastra/mcp/server.ts`:
 
-```typescript copy title="src/mastra/mcp/server.ts" {2, 8}
+```typescript title="src/mastra/mcp/server.ts" {2, 8}
 import { MCPServer } from "@mastra/mcp";
 import { resourceHandlers } from "./resources";
 
@@ -230,7 +230,7 @@ export const notes = new MCPServer({
 Tools are the actions your server can perform. Let's create a `write` tool.
 First, define the tool in `src/mastra/tools/write-note.ts`:
 
-```typescript copy title="src/mastra/tools/write-note.ts"
+```typescript title="src/mastra/tools/write-note.ts"
 import { createTool } from "@mastra/core/tools";
 import { z } from "zod";
 import { fileURLToPath } from "url";
@@ -271,7 +271,7 @@ export const writeNoteTool = createTool({
 
 Register this tool in `src/mastra/mcp/server.ts`:
 
-```typescript copy title="src/mastra/mcp/server.ts"
+```typescript title="src/mastra/mcp/server.ts"
 import { MCPServer } from "@mastra/mcp";
 import { resourceHandlers } from "./resources";
 import { writeNoteTool } from "../tools/write-note";
@@ -299,13 +299,13 @@ Prompt handlers provide ready-to-use prompts for clients. You'll add these three
 
 This requires a few markdown-parsing libraries you need to install:
 
-```bash copy
+```bash
 npm install unified remark-parse gray-matter @types/unist
 ```
 
 Implement the prompts in `src/mastra/mcp/prompts.ts`:
 
-```typescript copy title="src/mastra/mcp/prompts.ts"
+```typescript title="src/mastra/mcp/prompts.ts"
 import type { MCPServerPrompts } from "@mastra/mcp";
 import { unified } from "unified";
 import remarkParse from "remark-parse";
@@ -413,7 +413,7 @@ export const promptHandlers: MCPServerPrompts = {
 
 Register these prompt handlers in `src/mastra/mcp/server.ts`:
 
-```typescript copy title="src/mastra/mcp/server.ts"
+```typescript title="src/mastra/mcp/server.ts"
 import { MCPServer } from "@mastra/mcp";
 import { resourceHandlers } from "./resources";
 import { writeNoteTool } from "../tools/write-note";
@@ -439,7 +439,7 @@ export const notes = new MCPServer({
 
 Great, you've authored your first MCP server! Now you can try it out by starting the Mastra dev server and opening [Studio](/docs/v1/getting-started/studio):
 
-```bash copy
+```bash
 npm run dev
 ```
 

package/.docs/raw/guides/guide/research-assistant.mdx

@@ -10,7 +10,7 @@ import StepItem from "@site/src/components/StepItem";
 
 In this guide, you'll create an AI research assistant that can analyze academic papers and answer specific questions about their content using Retrieval Augmented Generation (RAG).
 
-You'll use the foundational Transformer paper ["Attention Is All You Need"](https://arxiv.org/html/1706.03762) as your example. As a database you'll use a local LibSQL database.
+You'll use the foundational Transformer paper ["Attention Is All You Need"](https://arxiv.org/html/1706.03762) as your example. As a database you'll use a local libSQL database.
 
 ## Prerequisites
 
@@ -59,7 +59,7 @@ Install additional dependencies
 
 After running the [installation guide](/guides/v1/getting-started/quickstart) you'll need to install additional dependencies:
 
-```bash copy
+```bash
 npm install @mastra/rag@beta ai@^4.0.0
 ```
 </StepItem>
@@ -74,7 +74,7 @@ Now you'll create your RAG-enabled research assistant. The agent uses:
 
 Create a new file `src/mastra/agents/researchAgent.ts` and define your agent:
 
-```ts copy title="src/mastra/agents/researchAgent.ts"
+```ts title="src/mastra/agents/researchAgent.ts"
 import { Agent } from "@mastra/core/agent";
 import { ModelRouterEmbeddingModel } from "@mastra/core/llm";
 import { createVectorQueryTool } from "@mastra/rag";
@@ -114,7 +114,7 @@ In the root of your project, grab the absolute path with the `pwd` command. The
 
 In your `src/mastra/index.ts` file, add the following to your existing file and configuration:
 
-```ts copy title="src/mastra/index.ts" {2, 4-6, 9}
+```ts title="src/mastra/index.ts" {2, 4-6, 9}
 import { Mastra } from "@mastra/core";
 import { LibSQLVector } from "@mastra/libsql";
 
@@ -133,7 +133,7 @@ For the `connectionUrl` use the absolute path you got from the `pwd` command. Th
 :::note
 
 For the purpose of this guide you are using a hardcoded absolute path to your
-local LibSQL file, however for production usage this won't work. You should
+local libSQL file, however for production usage this won't work. You should
 use a remote persistent database then.
 
 :::
@@ -144,7 +144,7 @@ use a remote persistent database then.
 
 In the `src/mastra/index.ts` file, add the agent to Mastra:
 
-```ts copy title="src/mastra/index.ts" {3, 10}
+```ts title="src/mastra/index.ts" {3, 10}
 import { Mastra } from "@mastra/core";
 import { LibSQLVector } from "@mastra/libsql";
 import { researchAgent } from "./agents/researchAgent";
@@ -176,7 +176,7 @@ In this step the research paper is retrieved by providing an URL, then converted
 
 Create a new file `src/store.ts` and add the following:
 
-```ts copy title="src/store.ts"
+```ts title="src/store.ts"
 import { MDocument } from "@mastra/rag";
 
 // Load the paper
@@ -198,7 +198,7 @@ console.log("Number of chunks:", chunks.length);
 
 Run the file in your terminal:
 
-```bash copy
+```bash
 npx bun src/store.ts
 ```
 
@@ -229,7 +229,7 @@ This allows the agent to efficiently search and retrieve relevant information.
 
 Open the `src/store.ts` file and add the following:
 
-```ts copy title="src/store.ts"
+```ts title="src/store.ts"
 import { MDocument } from "@mastra/rag";
 import { embedMany } from "ai";
 import { mastra } from "./mastra";
@@ -276,7 +276,7 @@ await vectorStore.upsert({
 
 Lastly, you'll now need to store the embeddings by running the script again:
 
-```bash copy
+```bash
 npx bun src/store.ts
 ```
 
@@ -292,7 +292,7 @@ Now that the vector database has all embeddings, you can test the research assis
 
 Create a new file `src/ask-agent.ts` and add different types of queries:
 
-```ts title="src/ask-agent.ts" copy
+```ts title="src/ask-agent.ts"
 import { mastra } from "./mastra";
 const agent = mastra.getAgent("researchAgent");
 
@@ -306,7 +306,7 @@ console.log("Response:", response1.text);
 
 Run the script:
 
-```bash copy
+```bash
 npx bun src/ask-agent.ts
 ```
 
@@ -323,7 +323,7 @@ Response: Sequence modeling with neural networks faces several key challenges:
 
 Try another question:
 
-```ts title="src/ask-agent.ts" copy
+```ts title="src/ask-agent.ts"
 import { mastra } from "./mastra";
 const agent = mastra.getAgent("researchAgent");
 
@@ -373,7 +373,7 @@ curl -X POST http://localhost:4111/api/agents/researchAgent/generate \
 
 Explore these examples for more advanced RAG techniques:
 
-- [Filter RAG](/examples/v1/rag/usage/filter-rag) for filtering results using metadata
-- [Cleanup RAG](/examples/v1/rag/usage/cleanup-rag) for optimizing information density
-- [Chain of Thought RAG](/examples/v1/rag/usage/cot-rag) for complex reasoning queries using workflows
-- [Rerank RAG](/examples/v1/rag/usage/cleanup-rag) for improved result relevance
+- [Filter RAG](https://github.com/mastra-ai/mastra/tree/main/examples/basics/rag/filter-rag) for filtering results using metadata
+- [Cleanup RAG](https://github.com/mastra-ai/mastra/tree/main/examples/basics/rag/cleanup-rag) for optimizing information density
+- [Chain of Thought RAG](https://github.com/mastra-ai/mastra/tree/main/examples/basics/rag/cot-rag) for complex reasoning queries using workflows
+- [Rerank RAG](https://github.com/mastra-ai/mastra/tree/main/examples/basics/rag/rerank-rag) for improved result relevance

package/.docs/raw/guides/guide/stock-agent.mdx

@@ -29,7 +29,7 @@ To create an agent in Mastra use the `Agent` class to define it and then registe
 
 Create a new file `src/mastra/agents/stockAgent.ts` and define your agent:
 
-```ts copy title="src/mastra/agents/stockAgent.ts"
+```ts title="src/mastra/agents/stockAgent.ts"
 import { Agent } from "@mastra/core/agent";
 
 export const stockAgent = new Agent({
@@ -47,7 +47,7 @@ export const stockAgent = new Agent({
 
 In your `src/mastra/index.ts` file, register the agent:
 
-```ts copy title="src/mastra/index.ts" {2, 5}
+```ts title="src/mastra/index.ts" {2, 5}
 import { Mastra } from "@mastra/core";
 import { stockAgent } from "./agents/stockAgent";
 
@@ -103,7 +103,7 @@ export const stockPrices = createTool({
 
 Inside `src/mastra/agents/stockAgent.ts` import your newly created `stockPrices` tool and add it to the agent.
 
-```ts copy title="src/mastra/agents/stockAgent.ts" {9-11}
+```ts title="src/mastra/agents/stockAgent.ts" {9-11}
 import { Agent } from "@mastra/core/agent";
 import { stockPrices } from "../tools/stockPrices";
 
@@ -133,7 +133,7 @@ Learn how to interact with your agent through Mastra's API.
 
 You can run your agent as a service using the `mastra dev` command:
 
-```bash copy
+```bash
 mastra dev
 ```
 
@@ -155,7 +155,7 @@ POST http://localhost:4111/api/agents/stockAgent/generate
 
 You can interact with the agent using `curl` from the command line:
 
-```bash copy
+```bash
 curl -X POST http://localhost:4111/api/agents/stockAgent/generate \
   -H "Content-Type: application/json" \
   -d '{

package/.docs/raw/guides/guide/web-search.mdx

@@ -140,7 +140,7 @@ Setup the tool:
 
 In your `src/mastra/index.ts` file, register the agent:
 
-```ts copy title="src/mastra/index.ts" {2, 5}
+```ts title="src/mastra/index.ts" {2, 5}
 import { Mastra } from "@mastra/core";
 import { searchAgent } from "./agents/searchAgent";
 
@@ -155,7 +155,7 @@ export const mastra = new Mastra({
 
 You can test your agent with [Studio](/docs/v1/getting-started/studio) using the `mastra dev` command:
 
-```bash copy
+```bash
 mastra dev
 ```
 
@@ -175,7 +175,7 @@ For more control over search behavior, you can integrate external search APIs as
 
 Install dependencies
 
-```bash copy
+```bash
 npm install exa-js
 ```
 
@@ -185,7 +185,7 @@ npm install exa-js
 
 Create a new file `src/mastra/agents/searchAgent.ts` and define your agent:
 
-```ts copy title="src/mastra/agents/searchAgent.ts"
+```ts title="src/mastra/agents/searchAgent.ts"
 import { Agent } from "@mastra/core/agent";
 
 export const searchAgent = new Agent({
@@ -203,7 +203,7 @@ export const searchAgent = new Agent({
 
 Setup the tool
 
-```ts copy title="src/mastra/tools/searchTool.ts"
+```ts title="src/mastra/tools/searchTool.ts"
 import { createTool } from "@mastra/core/tools";
 import z from "zod";
 import Exa from "exa-js";
@@ -246,7 +246,7 @@ export const webSearch = createTool({
 
 Add to your Agent
 
-```ts copy title="src/mastra/agents/searchAgent.ts"
+```ts title="src/mastra/agents/searchAgent.ts"
 import { webSearch } from "./tools/searchTool";
 
 export const searchAgent = new Agent({
@@ -267,7 +267,7 @@ export const searchAgent = new Agent({
 
 In your `src/mastra/index.ts` file, register the agent:
 
-```ts copy title="src/mastra/index.ts" {2, 5}
+```ts title="src/mastra/index.ts" {2, 5}
 import { Mastra } from "@mastra/core";
 import { searchAgent } from "./agents/searchAgent";
 
@@ -282,7 +282,7 @@ export const mastra = new Mastra({
 
 You can test your agent with [Studio](/docs/v1/getting-started/studio) using the `mastra dev` command:
 
-```bash copy
+```bash
 mastra dev
 ```
 

package/.docs/raw/guides/guide/whatsapp-chat-bot.mdx

@@ -11,7 +11,7 @@ This guide demonstrates how to create a WhatsApp chat bot using Mastra agents an
 
 This example requires a WhatsApp Business API setup and uses the `anthropic` model. Add these environment variables to your `.env` file:
 
-```bash title=".env" copy
+```bash title=".env"
 ANTHROPIC_API_KEY=<your-anthropic-api-key>
 WHATSAPP_VERIFY_TOKEN=<your-verify-token>
 WHATSAPP_ACCESS_TOKEN=<your-whatsapp-access-token>
@@ -23,7 +23,7 @@ WHATSAPP_API_VERSION=v22.0
 
 This client handles sending messages to users via the WhatsApp Business API.
 
-```typescript title="src/whatsapp-client.ts" showLineNumbers copy
+```typescript title="src/whatsapp-client.ts"
 // Simple WhatsApp Business API client for sending messages
 
 interface SendMessageParams {
@@ -87,7 +87,7 @@ export async function sendWhatsAppMessage({ to, message }: SendMessageParams) {
 
 This agent handles the main conversation logic with a friendly, conversational personality.
 
-```typescript title="src/mastra/agents/chat-agent.ts" showLineNumbers copy
+```typescript title="src/mastra/agents/chat-agent.ts"
 import { Agent } from "@mastra/core/agent";
 import { Memory } from "@mastra/memory";
 import { LibSQLStore } from "@mastra/libsql";
@@ -136,7 +136,7 @@ export const chatAgent = new Agent({
 
 This agent converts longer responses into natural, bite-sized text messages suitable for WhatsApp.
 
-```typescript title="src/mastra/agents/text-message-agent.ts" showLineNumbers copy
+```typescript title="src/mastra/agents/text-message-agent.ts"
 import { Agent } from "@mastra/core/agent";
 import { Memory } from "@mastra/memory";
 import { LibSQLStore } from "@mastra/libsql";
@@ -174,7 +174,7 @@ export const textMessageAgent = new Agent({
 
 This workflow orchestrates the entire chat process: generating a response, breaking it into messages, and sending them via WhatsApp.
 
-```typescript title="src/mastra/workflows/chat-workflow.ts" showLineNumbers copy
+```typescript title="src/mastra/workflows/chat-workflow.ts"
 import { createStep, createWorkflow } from "@mastra/core/workflows";
 import { z } from "zod";
 import { sendWhatsAppMessage } from "../../whatsapp-client";
@@ -300,7 +300,7 @@ chatWorkflow.commit();
 
 Configure your Mastra instance with the agents, workflow, and WhatsApp webhook endpoints.
 
-```typescript title="src/mastra/index.ts" showLineNumbers copy
+```typescript title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
 import { registerApiRoute } from "@mastra/core/server";
 import { PinoLogger } from "@mastra/loggers";
@@ -365,7 +365,7 @@ export const mastra = new Mastra({
 
 You can test the chat bot locally by simulating a WhatsApp webhook payload.
 
-```typescript title="src/test-whatsapp-bot.ts" showLineNumbers copy
+```typescript title="src/test-whatsapp-bot.ts"
 import "dotenv/config";
 
 import { mastra } from "./mastra";

package/.docs/raw/guides/migrations/ai-sdk-v4-to-v5.mdx

@@ -45,7 +45,7 @@ When using tools with TypeScript in AI SDK v5, Mastra provides type inference he
 
 The `InferUITool` type helper infers the input and output types of a single Mastra tool:
 
-```typescript title="app/types.ts" copy
+```typescript title="app/types.ts"
 import { InferUITool, createTool } from "@mastra/core/tools";
 import { z } from "zod";
 
@@ -80,7 +80,7 @@ type WeatherUITool = InferUITool<typeof weatherTool>;
 
 The `InferUITools` type helper infers the input and output types of multiple tools:
 
-```typescript title="app/mastra/tools.ts" copy
+```typescript title="app/mastra/tools.ts"
 import { InferUITools, createTool } from "@mastra/core/tools";
 import { z } from "zod";
 

package/.docs/raw/guides/migrations/upgrade-to-v1/agent.mdx

@@ -213,7 +213,7 @@ To migrate, add an `id` field to all Agent configurations.
 +   id: 'my-agent',
     name: 'My Agent',
     instructions: 'You are a helpful assistant',
-    model: openai('gpt-4'),
+    model: 'openai/gpt-4',
   });
 ```
 

package/.docs/raw/guides/migrations/upgrade-to-v1/client.mdx

@@ -155,6 +155,23 @@ To migrate, use workflow streaming APIs instead of watch.
 + }
 ```
 
+### Run-related methods cannot be called directly on workflow instance
+
+Run-related methods cannot be called directly on workflow instance. You need to create a run instance first using `createRun()` method.
+
+
+```diff
+- const result = await workflow.start({ runId: '123', inputData: { ... } });
++ const run = await workflow.createRun({ runId: '123' });
++ const result = await run.start({ inputData: { ... } });
+```
+
+```diff
+- const result = await workflow.stream({ runId: '123', inputData: { ... } });
++ const run = await workflow.createRun({ runId: '123' });
++ const stream = await run.stream({ inputData: { ... } });
+```
+
 ### Deprecated stream endpoints
 
 Some stream endpoints are deprecated and will be removed. The `/api/agents/:agentId/stream/vnext` endpoint returns 410 Gone, and `/api/agents/:agentId/stream/ui` is deprecated. This change consolidates on standard streaming endpoints.

package/.docs/raw/guides/migrations/upgrade-to-v1/overview.mdx

@@ -5,6 +5,12 @@ description: "Overview of breaking changes when upgrading to Mastra v1."
 
 # Upgrade to Mastra v1
 
+:::info[First update to latest 0.x version]
+Before upgrading to v1, make sure you've updated to the latest 0.x version of Mastra. Follow the [upgrade to latest 0.x guide](https://mastra.ai/guides/migrations/upgrade-to-latest-0x) first, then return here to complete the v1 migration.
+:::
+
+Mastra v1 is coming in January 2026. We recommend starting any new projects with the beta, or upgrading your existing project today to get ahead.
+
 This guide provides a comprehensive overview of breaking changes when upgrading from Mastra 0.x to v1.0. The migration is organized by package and feature area to help you systematically update your codebase.
 
 :::tip[Need help?]

package/.docs/raw/guides/migrations/upgrade-to-v1/workflows.mdx

@@ -153,7 +153,6 @@ Step `suspendPayload` is now validated for steps that have a `suspendSchema` def
 -       return suspend({ reason: "Suspension reason" }); // Missing otherReason
 +       return suspend({ reason: "Suspension reason", otherReason: "Other reason" });
       }
-      //... continue execution logic
     },
   });
 ```
@@ -334,7 +333,6 @@ createStep({
 +   if (!context.resumeData) {
 +     return context.suspend({})
 +   }
-+   //..continue execution logic
 + }
 });
 +