@mastra/mcp-docs-server 0.13.22-alpha.2 → 0.13.22-alpha.3

package/.docs/organized/changelogs/mastra.md

@@ -1,5 +1,53 @@
 # mastra
 
+## 0.13.0-alpha.1
+
+### Minor Changes
+
+- Improved workspace dependency resolution during development and builds. This makes the build process more reliable when working with monorepos and workspace packages, reducing potential bundling errors and improving development experience. ([#7619](https://github.com/mastra-ai/mastra/pull/7619))
+
+### Patch Changes
+
+- Improve the `mastra init` CLI. ([#7837](https://github.com/mastra-ai/mastra/pull/7837))
+
+  Previously, when you ran `mastra init` in a directory without a `package.json` file you'd receive no output. Now the CLI shows an error with next steps. Additionally, `mastra init` now also installs `zod` if not present already.
+
+- Add support for running the Mastra dev server over HTTPS for local development. ([#7871](https://github.com/mastra-ai/mastra/pull/7871))
+  - Add `--https` flag for `mastra dev`. This automatically creates a local key and certificate for you.
+  - Alternatively, you can provide your own key and cert through `server.https`:
+
+    ```ts
+    // src/mastra/index.ts
+    import { Mastra } from '@mastra/core/mastra';
+    import fs from 'node:fs';
+
+    export const mastra = new Mastra({
+      server: {
+        https: {
+          key: fs.readFileSync('path/to/key.pem'),
+          cert: fs.readFileSync('path/to/cert.pem'),
+        },
+      },
+    });
+    ```
+
+- avoid refetching on error when resolving a workflow in cloud ([#7842](https://github.com/mastra-ai/mastra/pull/7842))
+
+- dependencies updates: ([#7810](https://github.com/mastra-ai/mastra/pull/7810))
+  - Updated dependency [`strip-json-comments@^5.0.3` ↗︎](https://www.npmjs.com/package/strip-json-comments/v/5.0.3) (from `^5.0.2`, in `dependencies`)
+
+- fix markdown rendering in agent in agent text-delta ([#7851](https://github.com/mastra-ai/mastra/pull/7851))
+
+- fix workflows runs fetching and displaying ([#7852](https://github.com/mastra-ai/mastra/pull/7852))
+
+- fix empty state for scorers on agent page ([#7846](https://github.com/mastra-ai/mastra/pull/7846))
+
+- Updated dependencies [[`b1c155b`](https://github.com/mastra-ai/mastra/commit/b1c155b57ce702674f207f1d4c6a4ebf94225f44), [`790f7d1`](https://github.com/mastra-ai/mastra/commit/790f7d17895d7a5f75b6b5d2d794c2e820b99d4c), [`3cd6538`](https://github.com/mastra-ai/mastra/commit/3cd6538811fc94f84a19dbd1064f46cb42e38c1d), [`a1bb887`](https://github.com/mastra-ai/mastra/commit/a1bb887e8bfae44230f487648da72e96ef824561), [`8a3f5e4`](https://github.com/mastra-ai/mastra/commit/8a3f5e4212ec36b302957deb4bd47005ab598382), [`7e82fbf`](https://github.com/mastra-ai/mastra/commit/7e82fbf3715175e274d2015eb59fb7f57dc9b09d), [`a0f5f1c`](https://github.com/mastra-ai/mastra/commit/a0f5f1ca39c3c5c6d26202e9fcab986b4fe14568), [`b356f5f`](https://github.com/mastra-ai/mastra/commit/b356f5f7566cb3edb755d91f00b72fc1420b2a37), [`f5ce05f`](https://github.com/mastra-ai/mastra/commit/f5ce05f831d42c69559bf4c0fdb46ccb920fc3a3), [`9f6f30f`](https://github.com/mastra-ai/mastra/commit/9f6f30f04ec6648bbca798ea8aad59317c40d8db), [`d706fad`](https://github.com/mastra-ai/mastra/commit/d706fad6e6e4b72357b18d229ba38e6c913c0e70), [`8a3f5e4`](https://github.com/mastra-ai/mastra/commit/8a3f5e4212ec36b302957deb4bd47005ab598382), [`5c3768f`](https://github.com/mastra-ai/mastra/commit/5c3768fa959454232ad76715c381f4aac00c6881), [`8a3f5e4`](https://github.com/mastra-ai/mastra/commit/8a3f5e4212ec36b302957deb4bd47005ab598382)]:
+  - @mastra/deployer@0.17.0-alpha.3
+  - @mastra/core@0.17.0-alpha.3
+  - @mastra/loggers@0.10.12-alpha.0
+  - @mastra/mcp@0.12.1-alpha.0
+
 ## 0.12.4-alpha.0
 
 ### Patch Changes
@@ -250,53 +298,5 @@
 - Updated dependencies [0ce418a]
 - Updated dependencies [3e0153a]
 - Updated dependencies [af90672]
-- Updated dependencies [8387952]
-- Updated dependencies [7f3b8da]
-- Updated dependencies [905352b]
-- Updated dependencies [599d04c]
-- Updated dependencies [a6e2254]
-- Updated dependencies [56041d0]
-- Updated dependencies [3412597]
-- Updated dependencies [5eca5d2]
-- Updated dependencies [8f22a2c]
-- Updated dependencies [f2cda47]
-- Updated dependencies [5de1555]
-- Updated dependencies [cfd377a]
-- Updated dependencies [1ed5a3e]
-- Updated dependencies [03d0c39]
-  - @mastra/core@0.15.3
-  - @mastra/deployer@0.15.3
-  - @mastra/loggers@0.10.10
-  - @mastra/mcp@0.11.3
-
-## 0.11.3-alpha.4
-
-### Patch Changes
-
-- [#7358](https://github.com/mastra-ai/mastra/pull/7358) [`2f55297`](https://github.com/mastra-ai/mastra/commit/2f552975f4eb602f24c9e811c18587a65f620d72) Thanks [@LekoArts](https://github.com/LekoArts)! - Fix issue when using `yarn dlx create-mastra`
-
-- [#7357](https://github.com/mastra-ai/mastra/pull/7357) [`01264f1`](https://github.com/mastra-ai/mastra/commit/01264f1280db040d1bd1ac9b8d29cfcaac3d6cbc) Thanks [@TheIsrael1](https://github.com/TheIsrael1)! - Mastra dev- load env vars before watch
-
-- Updated dependencies [[`c19bcf7`](https://github.com/mastra-ai/mastra/commit/c19bcf7b43542b02157b5e17303e519933a153ab), [`b42a961`](https://github.com/mastra-ai/mastra/commit/b42a961a5aefd19d6e938a7705fc0ecc90e8f756), [`45e4d39`](https://github.com/mastra-ai/mastra/commit/45e4d391a2a09fc70c48e4d60f505586ada1ba0e), [`3b8972b`](https://github.com/mastra-ai/mastra/commit/3b8972bab8161d9fd96f6a41f57181443636cd43), [`0302f50`](https://github.com/mastra-ai/mastra/commit/0302f50861a53c66ff28801fc371b37c5f97e41e), [`74db265`](https://github.com/mastra-ai/mastra/commit/74db265b96aa01a72ffd91dcae0bc3b346cca0f2), [`6cffb99`](https://github.com/mastra-ai/mastra/commit/6cffb99030dc46256e4c3c0e6730565a2825d7a4), [`7f3b8da`](https://github.com/mastra-ai/mastra/commit/7f3b8da6dd21c35d3672e44b4f5dd3502b8f8f92), [`905352b`](https://github.com/mastra-ai/mastra/commit/905352bcda134552400eb252bca1cb05a7975c14), [`f2cda47`](https://github.com/mastra-ai/mastra/commit/f2cda47ae911038c5d5489f54c36517d6f15bdcc), [`cfd377a`](https://github.com/mastra-ai/mastra/commit/cfd377a3a33a9c88b644f6540feed9cd9832db47), [`03d0c39`](https://github.com/mastra-ai/mastra/commit/03d0c3963a748294577dd232a53ee01e1e5bcc12)]:
-  - @mastra/core@0.15.3-alpha.6
-  - @mastra/mcp@0.11.3-alpha.3
-  - @mastra/deployer@0.15.3-alpha.6
-
-## 0.11.3-alpha.3
-
-### Patch Changes
-
-- [#7343](https://github.com/mastra-ai/mastra/pull/7343) [`de3cbc6`](https://github.com/mastra-ai/mastra/commit/de3cbc61079211431bd30487982ea3653517278e) Thanks [@LekoArts](https://github.com/LekoArts)! - Update the `package.json` file to include additional fields like `repository`, `homepage` or `files`.
-
-- Updated dependencies [[`2b64943`](https://github.com/mastra-ai/mastra/commit/2b64943a282c99988c2e5b6e1269bfaca60e6fe3), [`85ef90b`](https://github.com/mastra-ai/mastra/commit/85ef90bb2cd4ae4df855c7ac175f7d392c55c1bf), [`de3cbc6`](https://github.com/mastra-ai/mastra/commit/de3cbc61079211431bd30487982ea3653517278e)]:
-  - @mastra/deployer@0.15.3-alpha.5
-  - @mastra/core@0.15.3-alpha.5
-  - @mastra/loggers@0.10.10-alpha.0
-  - @mastra/mcp@0.11.3-alpha.2
-
-## 0.11.3-alpha.2
-
-### Patch Changes
-
 
-... 5486 more lines hidden. See full changelog in package directory.
+... 5534 more lines hidden. See full changelog in package directory.

package/.docs/organized/code-examples/weather-agent.md

@@ -3,7 +3,8 @@
 {
   "name": "examples-weather-agent",
   "dependencies": {
-    "@ai-sdk/openai": "^1.3.24",
+    "@ai-sdk/anthropic": "^2.0.9",
+    "@ai-sdk/openai": "^2.0.23",
     "@mastra/core": "latest",
     "@mastra/libsql": "latest",
     "zod": "^3.25.76"
@@ -14,6 +15,7 @@
 ### mastra/agents/index.ts
 ```typescript
 import { openai } from '@ai-sdk/openai';
+import { anthropic } from '@ai-sdk/anthropic';
 import { Agent } from '@mastra/core/agent';
 // import { Memory } from '@mastra/memory';
 import { LibSQLStore } from '@mastra/libsql';
@@ -42,7 +44,12 @@ Your primary function is to help users get weather details for specific location
 - Keep responses concise but informative
 
 Use the weatherTool to fetch current weather data.`,
-  model: openai('gpt-4o'),
+  model: [
+    { model: anthropic('claude-3-5-sonnet-20241022') },
+    { model: openai('gpt-4o') },
+    { model: openai('gpt-4o-mini') },
+  ],
+  maxRetries: 3,
   tools: { weatherTool },
   // memory,
   // voice,
@@ -64,7 +71,7 @@ export const weatherReporterAgent = new Agent({
 import { Mastra } from '@mastra/core';
 import { LibSQLStore } from '@mastra/libsql';
 
-import { weatherAgent } from './agents';
+import { weatherAgent, weatherReporterAgent } from './agents';
 import { weatherWorkflow as legacyWeatherWorkflow } from './workflows';
 import { weatherWorkflow, weatherWorkflow2 } from './workflows/new-workflow';
 
@@ -72,7 +79,7 @@ export const mastra = new Mastra({
   storage: new LibSQLStore({
     url: 'file:./mastra.db',
   }),
-  agents: { weatherAgent },
+  agents: { weatherAgent, weatherReporterAgent },
   legacy_workflows: { legacyWeatherWorkflow },
   workflows: { weatherWorkflow, weatherWorkflow2 },
 });

package/.docs/raw/agents/overview.mdx

@@ -120,7 +120,7 @@ Use `.stream()` for real-time responses. Pass a single string for simple prompts
 
 ### Streaming text
 
-Call `.stream()` with an array of message objects that include `role` and `content`:
+Use `.stream()` with an array of message objects that include `role` and `content`:
 
 ```typescript showLineNumbers copy
 const stream = await testAgent.stream([

package/.docs/raw/auth/firebase.mdx

@@ -0,0 +1,285 @@
+---
+title: "MastraAuthFirebase Class"
+description: "Documentation for the MastraAuthFirebase class, which authenticates Mastra applications using Firebase Authentication."
+---
+
+import { Tabs, Tab } from "@/components/tabs";
+
+# MastraAuthFirebase Class
+
+The `MastraAuthFirebase` class provides authentication for Mastra using Firebase Authentication. It verifies incoming requests using Firebase ID tokens and integrates with the Mastra server using the `experimental_auth` option.
+
+## Prerequisites
+
+This example uses Firebase Authentication. Make sure to:
+
+1. Create a Firebase project in the [Firebase Console](https://console.firebase.google.com/)
+2. Enable Authentication and configure your preferred sign-in methods (Google, Email/Password, etc.)
+3. Generate a service account key from Project Settings > Service Accounts
+4. Download the service account JSON file
+
+```env filename=".env" copy
+FIREBASE_SERVICE_ACCOUNT=/path/to/your/service-account-key.json
+FIRESTORE_DATABASE_ID=(default)
+# Alternative environment variable names:
+# FIREBASE_DATABASE_ID=(default)
+```
+
+> **Note:** Store your service account JSON file securely and never commit it to version control.
+
+## Installation
+
+Before you can use the `MastraAuthFirebase` class you have to install the `@mastra/auth-firebase` package.
+
+```bash copy
+npm install @mastra/auth-firebase@latest
+```
+
+## Usage examples
+
+### Basic usage with environment variables
+
+If you set the required environment variables (`FIREBASE_SERVICE_ACCOUNT` and `FIRESTORE_DATABASE_ID`), you can initialize `MastraAuthFirebase` without any constructor arguments. The class will automatically read these environment variables as configuration:
+
+```typescript {2,7} filename="src/mastra/index.ts" showLineNumbers copy
+import { Mastra } from "@mastra/core/mastra";
+import { MastraAuthFirebase } from '@mastra/auth-firebase';
+
+// Automatically uses FIREBASE_SERVICE_ACCOUNT and FIRESTORE_DATABASE_ID env vars
+export const mastra = new Mastra({
+  // ..
+  server: {
+    experimental_auth: new MastraAuthFirebase(),
+  },
+});
+```
+
+### Custom configuration
+
+```typescript {2,7-10} filename="src/mastra/index.ts" showLineNumbers copy
+import { Mastra } from "@mastra/core/mastra";
+import { MastraAuthFirebase } from '@mastra/auth-firebase';
+
+export const mastra = new Mastra({
+  // ..
+  server: {
+    experimental_auth: new MastraAuthFirebase({
+      serviceAccount: '/path/to/service-account.json',
+      databaseId: 'your-database-id'
+    }),
+  },
+});
+```
+
+## Configuration
+
+The `MastraAuthFirebase` class can be configured through constructor options or environment variables.
+
+### Environment Variables
+
+- `FIREBASE_SERVICE_ACCOUNT`: Path to Firebase service account JSON file
+- `FIRESTORE_DATABASE_ID` or `FIREBASE_DATABASE_ID`: Firestore database ID
+
+> **Note:** When constructor options are not provided, the class automatically reads these environment variables. This means you can simply call `new MastraAuthFirebase()` without any arguments if your environment variables are properly configured.
+
+### User Authorization
+
+By default, `MastraAuthFirebase` uses Firestore to manage user access. It expects a collection named `user_access` with documents keyed by user UIDs. The presence of a document in this collection determines whether a user is authorized.
+
+```typescript filename="firestore-structure.txt" copy
+user_access/
+  {user_uid_1}/     // Document exists = user authorized
+  {user_uid_2}/     // Document exists = user authorized
+```
+
+To customize user authorization, provide a custom `authorizeUser` function:
+
+```typescript filename="src/mastra/auth.ts" showLineNumbers copy
+import { MastraAuthFirebase } from '@mastra/auth-firebase';
+
+const firebaseAuth = new MastraAuthFirebase({
+  authorizeUser: async (user) => {
+    // Custom authorization logic
+    return user.email?.endsWith('@yourcompany.com') || false;
+  }
+});
+```
+
+> See the [MastraAuthFirebase](/reference/auth/firebase.mdx) API reference for all available configuration options.
+
+## Client-side setup
+
+When using Firebase auth, you'll need to initialize Firebase on the client side, authenticate users, and retrieve their ID tokens to pass to your Mastra requests.
+
+### Setting up Firebase on the client
+
+First, initialize Firebase in your client application:
+
+```typescript filename="lib/firebase.ts" showLineNumbers copy
+import { initializeApp } from 'firebase/app';
+import { getAuth, GoogleAuthProvider } from 'firebase/auth';
+
+const firebaseConfig = {
+  apiKey: process.env.NEXT_PUBLIC_FIREBASE_API_KEY,
+  authDomain: process.env.NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN,
+  projectId: process.env.NEXT_PUBLIC_FIREBASE_PROJECT_ID,
+};
+
+const app = initializeApp(firebaseConfig);
+export const auth = getAuth(app);
+export const googleProvider = new GoogleAuthProvider();
+```
+
+### Authenticating users and retrieving tokens
+
+Use Firebase authentication to sign in users and retrieve their ID tokens:
+
+```typescript filename="lib/auth.ts" showLineNumbers copy
+import { signInWithPopup, signOut, User } from 'firebase/auth';
+import { auth, googleProvider } from './firebase';
+
+export const signInWithGoogle = async () => {
+  try {
+    const result = await signInWithPopup(auth, googleProvider);
+    return result.user;
+  } catch (error) {
+    console.error('Error signing in:', error);
+    throw error;
+  }
+};
+
+export const getIdToken = async (user: User) => {
+  try {
+    const idToken = await user.getIdToken();
+    return idToken;
+  } catch (error) {
+    console.error('Error getting ID token:', error);
+    throw error;
+  }
+};
+
+export const signOutUser = async () => {
+  try {
+    await signOut(auth);
+  } catch (error) {
+    console.error('Error signing out:', error);
+    throw error;
+  }
+};
+```
+
+> Refer to the [Firebase documentation](https://firebase.google.com/docs/auth) for other authentication methods like email/password, phone authentication, and more.
+
+## Configuring `MastraClient`
+
+When `experimental_auth` is enabled, all requests made with `MastraClient` must include a valid Firebase ID token in the `Authorization` header:
+
+```typescript {6} filename="lib/mastra/mastra-client.ts" showLineNumbers copy
+import { MastraClient } from "@mastra/client-js";
+
+export const createMastraClient = (idToken: string) => {
+  return new MastraClient({
+    baseUrl: "https://<mastra-api-url>",
+    headers: {
+      Authorization: `Bearer ${idToken}`
+    }
+  });
+};
+```
+
+> **Note:** The ID token must be prefixed with `Bearer` in the Authorization header.
+
+> See [Mastra Client SDK](/docs/server-db/mastra-client.mdx) for more configuration options.
+
+### Making authenticated requests
+
+Once `MastraClient` is configured with the Firebase ID token, you can send authenticated requests:
+
+<Tabs items={["React Component", "Node.js Server", "curl"]}>
+  <Tab>
+    ```tsx filename="src/components/test-agent.tsx" showLineNumbers copy
+    "use client";
+
+    import { useAuthState } from 'react-firebase-hooks/auth';
+    import { MastraClient } from "@mastra/client-js";
+    import { auth } from '../lib/firebase';
+    import { getIdToken } from '../lib/auth';
+
+    export const TestAgent = () => {
+      const [user] = useAuthState(auth);
+
+      async function handleClick() {
+        if (!user) return;
+
+        const token = await getIdToken(user);
+        const client = createMastraClient(token);
+
+        const weatherAgent = client.getAgent("weatherAgent");
+        const response = await weatherAgent.generate({
+          messages: "What's the weather like in New York",
+        });
+
+        console.log({ response });
+      }
+
+      return (
+        <button onClick={handleClick} disabled={!user}>
+          Test Agent
+        </button>
+      );
+    };
+    ```
+  </Tab>
+  <Tab>
+    ```typescript filename="server.js" showLineNumbers copy
+    const express = require('express');
+    const admin = require('firebase-admin');
+    const { MastraClient } = require('@mastra/client-js');
+
+    // Initialize Firebase Admin
+    admin.initializeApp({
+      credential: admin.credential.cert({
+        // Your service account credentials
+      })
+    });
+
+    const app = express();
+    app.use(express.json());
+
+    app.post('/generate', async (req, res) => {
+      try {
+        const { idToken } = req.body;
+        
+        // Verify the token
+        await admin.auth().verifyIdToken(idToken);
+
+        const mastra = new MastraClient({
+          baseUrl: "http://localhost:4111",
+          headers: {
+            Authorization: `Bearer ${idToken}`
+          }
+        });
+
+        const weatherAgent = mastra.getAgent("weatherAgent");
+        const response = await weatherAgent.generate({
+          messages: "What's the weather like in Nairobi"
+        });
+
+        res.json({ response: response.text });
+      } catch (error) {
+        res.status(401).json({ error: 'Unauthorized' });
+      }
+    });
+    ```
+  </Tab>
+  <Tab>
+    ```bash copy
+    curl -X POST http://localhost:4111/api/agents/weatherAgent/generate \
+      -H "Content-Type: application/json" \
+      -H "Authorization: Bearer <your-firebase-id-token>" \
+      -d '{
+        "messages": "Weather in London"
+      }'
+    ```
+  </Tab>
+</Tabs>

package/.docs/raw/auth/index.mdx

@@ -12,13 +12,13 @@ You can start with simple shared secret JWT authentication and switch to provide
 ## Available providers
 
 - [JSON Web Token (JWT)](/docs/auth/jwt)
+- [Clerk](/docs/auth/clerk)
+- [Supabase](/docs/auth/supabase)
+- [Firebase](/docs/auth/firebase)
 
 ### Coming soon
 
 The following providers will be available soon:
 
-- Supabase Auth
-- Firebase Auth
 - Auth0
-- Clerk
 - WorkOS

package/.docs/raw/deployment/overview.mdx

@@ -9,6 +9,13 @@ Mastra offers multiple deployment options to suit your application's needs, from
 
 ## Deployment Options
 
+### Runtime support
+
+- Node.js `v20.0` or higher
+- Bun
+- Deno
+- [Cloudflare](../deployment/serverless-platforms/cloudflare-deployer.mdx)
+
 ### Mastra Cloud
 
 Mastra Cloud is a deployment platform that connects to your GitHub repository, automatically deploys on code changes, and provides monitoring tools. It includes:
@@ -21,7 +28,6 @@ Mastra Cloud is a deployment platform that connects to your GitHub repository, a
 
 [View Mastra Cloud documentation →](../mastra-cloud/overview.mdx)
 
-
 ### With a Web Framework
 
 Mastra can be integrated with a variety of web frameworks. For example, see one of the following for a detailed guide.

package/.docs/raw/frameworks/agentic-uis/cedar-os.mdx

@@ -0,0 +1,108 @@
+---
+title: 'Cedar-OS Integration'
+description: 'Build AI-native frontends for your Mastra agents with Cedar-OS'
+---
+
+
+import { Tabs, Steps } from "nextra/components";
+
+# Integrate Cedar-OS with Mastra
+
+Cedar-OS is an open-source agentic UI framework designed specifically for building the most ambitious AI-native applications. We built Cedar with Mastra in mind.
+
+## Should you use Cedar?
+
+There are a few pillars we care about strongly that you can read more about [here](https://docs.cedarcopilot.com/introduction/philosophy):
+
+#### 1. Developer experience
+- **Every single component is downloaded shadcn-style** – You own all the code and can style it however you want
+- **Works out of the box** – Just drop in our chat component, and it'll work
+- **Fully extensible** - Built on a [Zustand store architecture](https://docs.cedarcopilot.com/introduction/architecture) that you can customize completely. Every single internal function can be overridden in one line.
+
+#### 2. Enabling truly AI-native applications
+For the first time in history, products can come to life. We want to help you build something with life.
+- **[Spells](https://docs.cedarcopilot.com/spells/spells#what-are-spells)** - Users can trigger AI from keyboard shortcuts, mouse events, text selection, and other components
+- **[State Diff Management](https://docs.cedarcopilot.com/state-diff/using-state-diff)** - Give users control over accepting/rejecting agent outputs 
+- **[Voice Integration](https://docs.cedarcopilot.com/voice/voice-integration)** - Let users control your app with their voice
+
+## Quick Start
+
+<Steps>
+### Set up your project
+
+Run Cedar's CLI command:
+``` bash
+npx cedar-os-cli plant-seed
+```
+
+If starting from scratch, select the **Mastra starter** template for a complete setup with both frontend and backend in a monorepo
+
+If you already have a Mastra backend, use the **blank frontend cedar repo** option instead.
+- This will give you the option to download components and download all dependencies for Cedar. We recommend at least downloading one of the chat components to get started. 
+
+### Wrap your app with CedarCopilot
+
+Wrap your application with the CedarCopilot provider to connect to your Mastra backend:
+
+```tsx
+import { CedarCopilot } from 'cedar-os';
+
+function App() {
+	return (
+		<CedarCopilot
+			llmProvider={{
+				provider: 'mastra',
+				baseURL: 'http://localhost:4111', // default dev port for Mastra
+				apiKey: process.env.NEXT_PUBLIC_MASTRA_API_KEY, // optional — only for backend auth
+			}}>
+			<YourApp />
+		</CedarCopilot>
+	);
+}
+```
+
+### Configure Mastra endpoints
+
+Configure your Mastra backend to work with Cedar by following the [Mastra Configuration Options](https://docs.cedarcopilot.com/agent-backend-connection/agent-backend-connection#mastra-configuration-options).
+
+[Register API routes](https://mastra.ai/en/examples/deployment/custom-api-route) in your Mastra server (or NextJS serverless routes if in a monorepo):
+
+```ts mastra/src/index.ts
+import { registerApiRoute } from '@mastra/core/server';
+
+// POST /chat
+// The chat's non-streaming default endpoint
+registerApiRoute('/chat', {
+	method: 'POST',
+	// …validate input w/ zod
+	handler: async (c) => {
+		/* your agent.generate() logic */
+	},
+});
+
+// POST /chat/stream (SSE)
+// The chat's streaming default endpoint
+registerApiRoute('/chat/stream', {
+	method: 'POST',
+	handler: async (c) => {
+		/* stream agent output in SSE format */
+	},
+});
+```
+
+### Add Cedar components
+
+Drop Cedar components into your frontend – see [Chat Overview](https://docs.cedarcopilot.com/chat/chat-overview).
+
+Your backend and frontend are now linked! You're ready to start building AI-native experiences with your Mastra agents.
+</Steps>
+
+
+## More information
+
+- Check out the [detailed Mastra integration guide](https://docs.cedarcopilot.com/agent-backend-connection/mastra#extending-mastra) for more configuration options (or for manual installation instructions if something goes wrong)
+- Explore Mastra-specific optimizations and features we've built
+  - **Seamless event streaming** - Automatic rendering of [Mastra streamed events](https://docs.cedarcopilot.com/chat/custom-message-rendering#mastra-event-renderer)
+  - **Voice endpoint support** - Built-in [voice backend integration](https://docs.cedarcopilot.com/voice/agentic-backend#endpoint-configuration)
+  - **End-to-End type safety** - [Types](https://docs.cedarcopilot.com/type-safety/typing-agent-requests) for communicating between your app and Mastra backend
+- [Join our Discord!](https://discord.gg/4AWawRjNdZ) We're excited to have you :)

package/.docs/raw/getting-started/installation.mdx

@@ -12,7 +12,6 @@ To get started with Mastra, you’ll need access to a large language model (LLM)
 
 Mastra also supports other LLM providers. For a full list of supported models and setup instructions, see [Model Providers](/docs/getting-started/model-providers).
 
-
 ## Prerequisites
 
 - Node.js `v20.0` or higher

package/.docs/raw/memory/overview.mdx

@@ -26,7 +26,7 @@ All memory types are [thread-scoped](./working-memory.mdx#thread-scoped-memory-d
 
 ### Working memory
 
-Stores persistent user-specific details such as names, preferences, goals, and other structured data. Uses [Markdown templates](./working-memory-template.mdx) or [Zod schemas](./working-memory-schema.mdx) to define structure.
+Stores persistent user-specific details such as names, preferences, goals, and other structured data. Uses [Markdown templates](./working-memory.mdx) or [Zod schemas](./working-memory.mdx#structured-working-memory) to define structure.
 
 ### Conversation history
 

package/.docs/raw/reference/agents/ChunkType.mdx

@@ -5,7 +5,7 @@ description: "Documentation for the ChunkType type used in Mastra streaming resp
 
 import { Callout } from "nextra/components";
 import { PropertiesTable } from "@/components/properties-table";
- 
+
 # ChunkType
 
 <Callout type="warning">
@@ -826,24 +826,24 @@ for await (const chunk of stream.fullStream) {
     case 'text-delta':
       console.log('Text:', chunk.payload.text);
       break;
-    
+
     case 'tool-call':
       console.log('Calling tool:', chunk.payload.toolName);
       break;
-    
+
     case 'tool-result':
       console.log('Tool result:', chunk.payload.result);
       break;
-    
+
     case 'reasoning-delta':
       console.log('Reasoning:', chunk.payload.text);
       break;
-    
+
     case 'finish':
       console.log('Finished:', chunk.payload.stepResult.reason);
       console.log('Usage:', chunk.payload.output.usage);
       break;
-    
+
     case 'error':
       console.error('Error:', chunk.payload.error);
       break;
@@ -853,5 +853,5 @@ for await (const chunk of stream.fullStream) {
 
 ## Related Types
 
-- [MastraModelOutput](/reference/agents/MastraModelOutput) - The stream object that emits these chunks
-- [Agent.streamVNext()](/reference/agents/streamVNext) - Method that returns streams emitting these chunks
+- [MastraModelOutput](./MastraModelOutput.mdx) - The stream object that emits these chunks
+- [Agent.streamVNext()](./streamVNext.mdx) - Method that returns streams emitting these chunks