@mastra/mcp-docs-server 1.0.0-beta.9 → 1.0.1

package/dist/tools/course.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"course.d.ts","sourceRoot":"","sources":["../../src/tools/course.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,QAAA,MAAM,mBAAmB;;;;;;EAEvB,CAAC;AAEH,QAAA,MAAM,mBAAmB;;;;;;EAEvB,CAAC;AAGH,KAAK,WAAW,GAAG;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,KAAK,CAAC;YACX,IAAI,EAAE,MAAM,CAAC;YACb,MAAM,EAAE,MAAM,CAAC;SAChB,CAAC,CAAC;KACJ,CAAC,CAAC;CACJ,CAAC;AAqGF,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAmCzE;AA+CD,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAgDpG;AA6LD,eAAO,MAAM,iBAAiB;;;;;;;;;;oBAON;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;CA0HzC,CAAC;AAEF,eAAO,MAAM,qBAAqB;;;;qBAIT,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;CAqF7C,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;oBAKZ,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC;CAwD1D,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;qBAKR,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;CA4F7C,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;oBAKb,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC;CA8B1D,CAAC"}
+{"version":3,"file":"course.d.ts","sourceRoot":"","sources":["../../src/tools/course.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,QAAA,MAAM,mBAAmB;;;;;;EAEvB,CAAC;AAEH,QAAA,MAAM,mBAAmB;;;;;;EAEvB,CAAC;AAGH,KAAK,WAAW,GAAG;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,KAAK,CAAC;YACX,IAAI,EAAE,MAAM,CAAC;YACb,MAAM,EAAE,MAAM,CAAC;SAChB,CAAC,CAAC;KACJ,CAAC,CAAC;CACJ,CAAC;AAqGF,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAmCzE;AA+CD,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAgDpG;AA6LD,eAAO,MAAM,iBAAiB;;;;;;;;;;oBAON;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;CA0HzC,CAAC;AAEF,eAAO,MAAM,qBAAqB;;;;qBAKT,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;CAqF7C,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;oBAKZ,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC;CAwD1D,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;qBAKR,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;CA4F7C,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;oBAKb,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC;CA8B1D,CAAC"}

package/dist/tools/embedded-docs.d.ts

@@ -0,0 +1,276 @@
+import { z } from 'zod';
+export declare const getMastraHelpTool: {
+    name: string;
+    description: string;
+    parameters: z.ZodObject<{
+        projectPath: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        projectPath: string;
+    }, {
+        projectPath: string;
+    }>;
+    execute: (args: {
+        projectPath: string;
+    }) => Promise<string>;
+};
+export declare const listInstalledPackagesTool: {
+    name: string;
+    description: string;
+    parameters: z.ZodObject<{
+        projectPath: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        projectPath: string;
+    }, {
+        projectPath: string;
+    }>;
+    execute: (args: {
+        projectPath: string;
+    }) => Promise<string>;
+};
+export declare const readSourceMapTool: {
+    name: string;
+    description: string;
+    parameters: z.ZodObject<{
+        package: z.ZodString;
+        projectPath: z.ZodString;
+        filter: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        package: string;
+        projectPath: string;
+        filter?: string | undefined;
+    }, {
+        package: string;
+        projectPath: string;
+        filter?: string | undefined;
+    }>;
+    execute: (args: {
+        package: string;
+        projectPath: string;
+        filter?: string;
+    }) => Promise<string>;
+};
+export declare const findExportTool: {
+    name: string;
+    description: string;
+    parameters: z.ZodObject<{
+        package: z.ZodString;
+        exportName: z.ZodString;
+        includeTypes: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        includeImplementation: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        implementationLines: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        projectPath: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        package: string;
+        projectPath: string;
+        exportName: string;
+        includeTypes: boolean;
+        includeImplementation: boolean;
+        implementationLines: number;
+    }, {
+        package: string;
+        projectPath: string;
+        exportName: string;
+        includeTypes?: boolean | undefined;
+        includeImplementation?: boolean | undefined;
+        implementationLines?: number | undefined;
+    }>;
+    execute: (args: {
+        package: string;
+        exportName: string;
+        projectPath: string;
+        includeTypes?: boolean;
+        includeImplementation?: boolean;
+        implementationLines?: number;
+    }) => Promise<string>;
+};
+export declare const readEmbeddedDocsTool: {
+    name: string;
+    description: string;
+    parameters: z.ZodObject<{
+        package: z.ZodString;
+        topic: z.ZodOptional<z.ZodString>;
+        file: z.ZodOptional<z.ZodString>;
+        projectPath: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        package: string;
+        projectPath: string;
+        topic?: string | undefined;
+        file?: string | undefined;
+    }, {
+        package: string;
+        projectPath: string;
+        topic?: string | undefined;
+        file?: string | undefined;
+    }>;
+    execute: (args: {
+        package: string;
+        projectPath: string;
+        topic?: string;
+        file?: string;
+    }) => Promise<string>;
+};
+export declare const searchEmbeddedDocsTool: {
+    name: string;
+    description: string;
+    parameters: z.ZodObject<{
+        query: z.ZodString;
+        package: z.ZodOptional<z.ZodString>;
+        maxResults: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        projectPath: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        projectPath: string;
+        query: string;
+        maxResults: number;
+        package?: string | undefined;
+    }, {
+        projectPath: string;
+        query: string;
+        package?: string | undefined;
+        maxResults?: number | undefined;
+    }>;
+    execute: (args: {
+        query: string;
+        projectPath: string;
+        package?: string;
+        maxResults?: number;
+    }) => Promise<string>;
+};
+export declare const embeddedDocsTools: {
+    getMastraHelp: {
+        name: string;
+        description: string;
+        parameters: z.ZodObject<{
+            projectPath: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            projectPath: string;
+        }, {
+            projectPath: string;
+        }>;
+        execute: (args: {
+            projectPath: string;
+        }) => Promise<string>;
+    };
+    listMastraPackages: {
+        name: string;
+        description: string;
+        parameters: z.ZodObject<{
+            projectPath: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            projectPath: string;
+        }, {
+            projectPath: string;
+        }>;
+        execute: (args: {
+            projectPath: string;
+        }) => Promise<string>;
+    };
+    getMastraExports: {
+        name: string;
+        description: string;
+        parameters: z.ZodObject<{
+            package: z.ZodString;
+            projectPath: z.ZodString;
+            filter: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            package: string;
+            projectPath: string;
+            filter?: string | undefined;
+        }, {
+            package: string;
+            projectPath: string;
+            filter?: string | undefined;
+        }>;
+        execute: (args: {
+            package: string;
+            projectPath: string;
+            filter?: string;
+        }) => Promise<string>;
+    };
+    getMastraExportDetails: {
+        name: string;
+        description: string;
+        parameters: z.ZodObject<{
+            package: z.ZodString;
+            exportName: z.ZodString;
+            includeTypes: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            includeImplementation: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            implementationLines: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            projectPath: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            package: string;
+            projectPath: string;
+            exportName: string;
+            includeTypes: boolean;
+            includeImplementation: boolean;
+            implementationLines: number;
+        }, {
+            package: string;
+            projectPath: string;
+            exportName: string;
+            includeTypes?: boolean | undefined;
+            includeImplementation?: boolean | undefined;
+            implementationLines?: number | undefined;
+        }>;
+        execute: (args: {
+            package: string;
+            exportName: string;
+            projectPath: string;
+            includeTypes?: boolean;
+            includeImplementation?: boolean;
+            implementationLines?: number;
+        }) => Promise<string>;
+    };
+    readMastraDocs: {
+        name: string;
+        description: string;
+        parameters: z.ZodObject<{
+            package: z.ZodString;
+            topic: z.ZodOptional<z.ZodString>;
+            file: z.ZodOptional<z.ZodString>;
+            projectPath: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            package: string;
+            projectPath: string;
+            topic?: string | undefined;
+            file?: string | undefined;
+        }, {
+            package: string;
+            projectPath: string;
+            topic?: string | undefined;
+            file?: string | undefined;
+        }>;
+        execute: (args: {
+            package: string;
+            projectPath: string;
+            topic?: string;
+            file?: string;
+        }) => Promise<string>;
+    };
+    searchMastraDocs: {
+        name: string;
+        description: string;
+        parameters: z.ZodObject<{
+            query: z.ZodString;
+            package: z.ZodOptional<z.ZodString>;
+            maxResults: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            projectPath: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            projectPath: string;
+            query: string;
+            maxResults: number;
+            package?: string | undefined;
+        }, {
+            projectPath: string;
+            query: string;
+            package?: string | undefined;
+            maxResults?: number | undefined;
+        }>;
+        execute: (args: {
+            query: string;
+            projectPath: string;
+            package?: string;
+            maxResults?: number;
+        }) => Promise<string>;
+    };
+};
+//# sourceMappingURL=embedded-docs.d.ts.map

package/dist/tools/embedded-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedded-docs.d.ts","sourceRoot":"","sources":["../../src/tools/embedded-docs.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAwJxB,eAAO,MAAM,iBAAiB;;;;;;;;;;oBAiDN;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE;CAwG9C,CAAC;AAMF,eAAO,MAAM,yBAAyB;;;;;;;;;;oBAgBd;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE;CAkC9C,CAAC;AAMF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;oBAoBN;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;CAqChF,CAAC;AAMF,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;oBAiCH;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,qBAAqB,CAAC,EAAE,OAAO,CAAC;QAChC,mBAAmB,CAAC,EAAE,MAAM,CAAC;KAC9B;CAmFF,CAAC;AAMF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;oBA2BT;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;CAgG9F,CAAC;AAMF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;oBA4BX;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;CAoFpG,CAAC;AAGF,eAAO,MAAM,iBAAiB;;;;;;;;;;;wBA1lBN;YAAE,WAAW,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;wBA8HvB;YAAE,WAAW,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;wBA4DvB;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA4EzD;YACpB,OAAO,EAAE,MAAM,CAAC;YAChB,UAAU,EAAE,MAAM,CAAC;YACnB,WAAW,EAAE,MAAM,CAAC;YACpB,YAAY,CAAC,EAAE,OAAO,CAAC;YACvB,qBAAqB,CAAC,EAAE,OAAO,CAAC;YAChC,mBAAmB,CAAC,EAAE,MAAM,CAAC;SAC9B;;;;;;;;;;;;;;;;;;;;;wBAoHqB;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;wBAkIvE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE;;CA8FpG,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.0.0-beta.9",
+  "version": "1.0.1",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -27,9 +27,10 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.17.5",
     "jsdom": "^26.1.0",
+    "local-pkg": "^1.1.2",
     "zod": "^3.25.76",
-    "@mastra/core": "1.0.0-beta.9",
-    "@mastra/mcp": "^1.0.0-beta.6"
+    "@mastra/core": "1.0.4",
+    "@mastra/mcp": "^1.0.0"
   },
   "devDependencies": {
     "@hono/node-server": "^1.19.6",
@@ -40,13 +41,13 @@
     "@wong2/mcp-cli": "^1.13.0",
     "cross-env": "^10.1.0",
     "eslint": "^9.37.0",
-    "hono": "^4.10.5",
+    "hono": "^4.11.3",
     "tsup": "^8.5.0",
     "tsx": "^4.19.4",
-    "typescript": "^5.8.3",
-    "vitest": "4.0.12",
-    "@internal/lint": "0.0.53",
-    "@mastra/core": "1.0.0-beta.9"
+    "typescript": "^5.9.3",
+    "vitest": "4.0.16",
+    "@internal/lint": "0.0.55",
+    "@mastra/core": "1.0.4"
   },
   "homepage": "https://mastra.ai",
   "repository": {

package/.docs/organized/changelogs/%40internal%2Fai-sdk-v4.md

@@ -1 +0,0 @@
-No changelog available.

package/.docs/raw/deployment/building-mastra.mdx

@@ -1,73 +0,0 @@
----
-title: "Building Mastra | Deployment"
-description: "Learn how to build a Mastra server with build settings and deployment options."
----
-
-# Building Mastra
-
-Mastra runs as a standard Node.js server and can be deployed across a wide range of environments.
-
-## Default project structure
-
-The [getting started guide](/guides/v1/getting-started/quickstart) scaffolds a project with sensible defaults to help you begin quickly. By default, the CLI organizes application files under the `src/mastra/` directory, resulting in a structure similar to the following:
-
-```
-src/
-└── mastra/
-    ├── agents/
-    ├── tools/
-    ├── workflows/
-    └── index.ts
-package.json
-tsconfig.json
-```
-
-## Building
-
-The `mastra build` command starts the build process:
-
-```bash copy
-mastra build
-```
-
-### Customizing the input directory
-
-If your Mastra files are located elsewhere, use the `--dir` flag to specify the custom location. The `--dir` flag tells Mastra where to find your entry point file (`index.ts` or `index.js`) and related directories.
-
-```bash copy
-mastra build --dir ./my-project/mastra
-```
-
-## Build process
-
-The build process follows these steps:
-
-1. **Locates entry file**: Finds `index.ts` or `index.js` in your specified directory (default: `src/mastra/`).
-2. **Creates build directory**: Generates a `.mastra/` directory containing:
-   - **`.build`**: Contains dependency analysis, bundled dependencies, and build configuration files.
-   - **`output`**: Contains the production-ready application bundle with `index.mjs` and project-specific files.
-3. **Copies static assets**: Copies the `public/` folder contents to the `output` directory for serving static files.
-4. **Bundles code**: Uses Rollup with tree shaking and source maps for optimization.
-5. **Generates server**: Creates a [Hono](https://hono.dev) HTTP server ready for deployment.
-
-### Build output structure
-
-After building, Mastra creates a `.mastra/` directory with the following structure:
-
-```
-.mastra/
-├── .build/
-└── output/
-```
-
-### `public` folder
-
-If a `public` folder exists in `src/mastra`, its contents are copied into the `.build/output` directory during the build process.
-
-## Running the Server
-
-Start the HTTP server:
-
-```bash copy
-node .mastra/output/index.mjs
-```

package/.docs/raw/deployment/cloud-providers/index.mdx

@@ -1,55 +0,0 @@
----
-title: "Cloud Providers | Deployment"
-description: "Deploy your Mastra applications to popular cloud providers."
----
-
-# Cloud Providers
-
-Standalone Mastra applications can be deployed to popular cloud providers, see one of the following guides for more information:
-
-- [Amazon EC2](/docs/v1/deployment/cloud-providers/amazon-ec2)
-- [AWS Lambda](/docs/v1/deployment/cloud-providers/aws-lambda)
-- [Azure App Services](/docs/v1/deployment/cloud-providers/azure-app-services)
-- [Cloudflare](/docs/v1/deployment/cloud-providers/cloudflare-deployer)
-- [Digital Ocean](/docs/v1/deployment/cloud-providers/digital-ocean)
-- [Netlify](/docs/v1/deployment/cloud-providers/netlify-deployer)
-- [Vercel](/docs/v1/deployment/cloud-providers/vercel-deployer)
-
-For self-hosted Node.js server deployment, see the [Creating A Mastra Server](/docs/v1/deployment/building-mastra) guide.
-
-## Prerequisites
-
-Before deploying to a cloud provider, ensure you have:
-
-- A [Mastra application](/guides/v1/getting-started/quickstart)
-- Node.js `v22.13.0` or later
-- A GitHub repository for your application (required for most CI/CD setups)
-- Domain name management access (for SSL and HTTPS)
-- Basic familiarity with server setup (e.g. Nginx, environment variables)
-
-## LibSQLStore
-
-`LibSQLStore` writes to the local filesystem, which is not supported in cloud environments that use ephemeral file systems. If you're deploying to platforms like AWS Lambda, Netlify, Azure App Services, or Digital Ocean App Platform, you must remove all usage of `LibSQLStore`.
-
-Specifically, ensure you've removed it from all Mastra files, including configuration on the main Mastra instance and any agents using it, e.g. for memory storage.
-
-```diff title="src/mastra/index.ts"
- export const mastra = new Mastra({
--  storage: new LibSQLStore({
--    id: 'mastra-storage',
--    url: ":memory:",
--  }),
- });
-```
-
-```diff
- export const weatherAgent = new Agent({
-   id: "weather-agent",
-   memory: new Memory({
--    storage: new LibSQLStore({
--      id: 'mastra-storage',
--      url: "file:../mastra.db",
--    }),
-   }),
- });
-```

package/.docs/raw/deployment/mastra-cloud/dashboard.mdx

@@ -1,100 +0,0 @@
----
-title: "Navigating the Dashboard | Mastra Cloud"
-description: Details of each feature available in Mastra Cloud
----
-
-import { MastraCloudCallout } from "@site/src/components/MastraCloudCallout";
-
-# Navigating the Dashboard
-
-This page explains how to navigate the Mastra Cloud dashboard, where you can configure your project, view deployment details, and interact with agents and workflows using the built-in [Studio](/docs/v1/deployment/mastra-cloud/dashboard#studio).
-
-<MastraCloudCallout />
-
-## Overview
-
-The **Overview** page provides details about your application, including its domain URL, status, latest deployment, and connected agents and workflows.
-
-![Project dashboard](/img/mastra-cloud/mastra-cloud-project-dashboard.jpg)
-
-Key features:
-
-Each project shows its current deployment status, active domains, and environment variables, so you can quickly understand how your application is running.
-
-## Deployments
-
-The **Deployments** page shows recent builds and gives you quick access to detailed build logs. Click any row to view more information about a specific deployment.
-
-![Dashboard deployment](/img/mastra-cloud/mastra-cloud-dashboard-deployments.jpg)
-
-Key features:
-
-Each deployment includes its current status, the Git branch it was deployed from, and a title generated from the commit hash.
-
-## Logs
-
-The **Logs** page is where you'll find detailed information to help debug and monitor your application's behavior in the production environment.
-
-![Dashboard logs](/img/mastra-cloud/mastra-cloud-dashboard-logs.jpg)
-
-Key features:
-
-Each log includes a severity level and detailed messages showing agent, workflow, and storage activity.
-
-## Settings
-
-On the **Settings** page you can modify the configuration of your application.
-
-![Dashboard settings](/img/mastra-cloud/mastra-cloud-dashboard-settings.jpg)
-
-Key features:
-
-You can manage environment variables, edit key project settings like the name and branch, configure storage with LibSQLStore, and set a stable URL for your endpoints.
-
-> Changes to configuration require a new deployment before taking effect.
-
-## Studio
-
-### Agents
-
-On the **Agents** page you'll see all agents used in your application. Click any agent to interact using the chat interface.
-
-![Dashboard Studio agents](/img/mastra-cloud/mastra-cloud-dashboard-playground-agents.jpg)
-
-Key features:
-
-Test your agents in real time using the chat interface, review traces of each interaction, and see evaluation scores for every response.
-
-### Workflows
-
-On the **Workflows** page you'll see all workflows used in your application. Click any workflow to interact using the runner interface.
-
-![Dashboard Studio workflows](/img/mastra-cloud/mastra-cloud-dashboard-playground-workflows.jpg)
-
-Key features:
-
-Visualize your workflow with a step-by-step graph, view execution traces, and run workflows directly using the built-in runner.
-
-### Tools
-
-On the **Tools** page you'll see all tools used by your agents. Click any tool to interact using the input interface.
-
-![Dashboard Studio tools](/img/mastra-cloud/mastra-cloud-dashboard-playground-tools.jpg)
-
-Key features:
-
-Test your tools by providing an input that matches the schema and viewing the structured output.
-
-## MCP Servers
-
-The **MCP Servers** page lists all MCP Servers included in your application. Click any MCP Server for more information.
-
-![Dashboard Studio mcp servers](/img/mastra-cloud/mastra-cloud-dashboard-playground-mcpservers.jpg)
-
-Key features:
-
-Each MCP Server includes API endpoints for HTTP and SSE, along with IDE configuration snippets for tools like Cursor and Windsurf.
-
-## Next steps
-
-- [Understanding Tracing and Logs](/docs/v1/deployment/mastra-cloud/observability)

package/.docs/raw/deployment/mastra-cloud/observability.mdx

@@ -1,53 +0,0 @@
----
-title: "Understanding Tracing and Logs | Mastra Cloud"
-description: Monitoring and debugging tools for Mastra Cloud deployments
----
-
-import { MastraCloudCallout } from "@site/src/components/MastraCloudCallout";
-
-# Understanding Tracing and Logs
-
-Mastra Cloud provides full observability for production applications, giving you insight into how your agents and workflows behave. Observability can be enabled whether your application is deployed to Mastra Cloud, running locally, or hosted on your own infrastructure. Any Mastra project can send traces and logs to the platform regardless of where it's running.
-
-For details on configuring observability, see the [Cloud Exporter](/docs/v1/observability/tracing/exporters/cloud) docs.
-
-<MastraCloudCallout />
-
-## Traces
-
-More detailed traces are available for both agents and workflows by enabling [observability](/docs/v1/observability/tracing/overview) using one of our [supported providers](/docs/v1/observability/tracing/overview#exporters).
-
-### Agents
-
-With observability enabled, you can view detailed outputs from your agents in the **Traces** section in Studio.
-
-![observability agents](/img/mastra-cloud/mastra-cloud-observability-agents.jpg)
-
-Key features:
-
-Agent traces break a run into clear steps, model calls, tool calls, and intermediate chunks, each with timing, inputs, outputs, and errors. You can drill into any span to inspect prompts, token usage, and results, making it easy to diagnose issues and understand how the agent produced its output.
-
-### Workflows
-
-With observability enabled, you can view detailed outputs from your workflows in the **Traces** section in Studio.
-
-![observability workflows](/img/mastra-cloud/mastra-cloud-observability-workflows.jpg)
-
-Key features:
-
-Workflow traces capture each step in the run, including transitions, branching, timing, and any tool calls inside the workflow. You can inspect inputs, outputs, and errors for every step, making it easy to debug long-running or multi-step processes and understand how data flows through the workflow.
-
-## Logs
-
-You can view detailed logs for debugging and monitoring your application's behavior on the [Logs](/docs/v1/deployment/mastra-cloud/dashboard#logs) page of the Dashboard.
-
-![Dashboard logs](/img/mastra-cloud/mastra-cloud-dashboard-logs.jpg)
-
-Key features:
-
-Each log entry includes its severity level and a detailed message showing agent, workflow, or storage activity.
-
-## Next steps
-
-- [Logging](/docs/v1/observability/logging)
-- [Tracing](/docs/v1/observability/tracing/overview)

package/.docs/raw/deployment/mastra-cloud/overview.mdx

@@ -1,65 +0,0 @@
----
-title: "Mastra Cloud | Mastra Cloud"
-description: Deployment and monitoring service for Mastra applications
----
-
-import { MastraCloudCallout } from "@site/src/components/MastraCloudCallout";
-
-# Mastra Cloud
-
-[Mastra Cloud](https://mastra.ai/cloud) is a platform for deploying, managing, monitoring, and debugging Mastra applications. When you [deploy](/docs/v1/deployment/mastra-cloud/setting-up) your application, Mastra Cloud exposes your agents, tools, and workflows as REST API endpoints.
-
-<MastraCloudCallout />
-
-## Platform features
-
-Deploy and manage your applications with automated builds, organized projects, and no additional configuration.
-
-![Platform features](/img/mastra-cloud/mastra-cloud-platform-features.jpg)
-
-Key features:
-
-Mastra Cloud supports zero-config deployment, continuous integration with GitHub, and atomic deployments that package agents, tools, and workflows together.
-
-## Project Dashboard
-
-Monitor and debug your applications with detailed output logs, deployment state, and interactive tools.
-
-![Project dashboard](/img/mastra-cloud/mastra-cloud-project-dashboard.jpg)
-
-Key features:
-
-The Project Dashboard gives you an overview of your application's status and deployments, with access to logs and a Studio for testing agents and workflows.
-
-## Project structure
-
-Use a standard Mastra project structure for proper detection and deployment.
-
-```shell
-src
-└── mastra
-    ├── agents
-    │   └── agent-name.ts
-    ├── tools
-    │   └── tool-name.ts
-    ├── workflows
-    │   └── workflow-name.ts
-    └── index.ts
-package.json
-```
-
-Mastra Cloud scans your repository for:
-
-- **Agents**: Defined using: `new Agent({...})`
-- **Tools**: Defined using: `createTool({...})`
-- **Workflows**: Defined using: `createWorkflow({...})`
-- **Steps**: Defined using: `createStep({...})`
-- **Environment Variables**: API keys and configuration variables
-
-## Technical implementation
-
-Mastra Cloud is purpose-built for Mastra agents, tools, and workflows. It handles long-running requests, records detailed traces for every execution, and includes built-in support for evals.
-
-## Next steps
-
-- [Setting Up and Deploying](/docs/v1/deployment/mastra-cloud/setting-up)