@mastra/mcp-docs-server 0.13.34-alpha.0 → 0.13.35-alpha.0

package/.docs/organized/changelogs/%40mastra%2Fplayground-ui.md

@@ -1,5 +1,31 @@
 # @mastra/playground-ui
 
+## 6.7.0-alpha.0
+
+### Minor Changes
+
+- Update peer dependencies to match core package version bump (0.22.1) ([#8649](https://github.com/mastra-ai/mastra/pull/8649))
+
+### Patch Changes
+
+- Add tool call approval ([#8649](https://github.com/mastra-ai/mastra/pull/8649))
+
+- Updated dependencies [[`f743dbb`](https://github.com/mastra-ai/mastra/commit/f743dbb8b40d1627b5c10c0e6fc154f4ebb6e394), [`5df9cce`](https://github.com/mastra-ai/mastra/commit/5df9cce1a753438413f64c11eeef8f845745c2a8), [`2060766`](https://github.com/mastra-ai/mastra/commit/20607667bf78ea104cca3e15dfb93ae0b62c9d18), [`2c4438b`](https://github.com/mastra-ai/mastra/commit/2c4438b87817ab7eed818c7990fef010475af1a3)]:
+  - @mastra/core@0.23.0-alpha.0
+  - @mastra/client-js@0.16.5-alpha.0
+  - @mastra/react@0.0.11-alpha.0
+
+## 6.6.2
+
+### Patch Changes
+
+- Move all the fetching hooks that should be shared with cloud into playground-ui ([#9133](https://github.com/mastra-ai/mastra/pull/9133))
+
+- Updated dependencies [[`2b031e2`](https://github.com/mastra-ai/mastra/commit/2b031e25ca10cd3e4d63e6a27f909cba26d91405)]:
+  - @mastra/core@0.22.2
+  - @mastra/client-js@0.16.4
+  - @mastra/react@0.0.10
+
 ## 6.6.2-alpha.0
 
 ### Patch Changes
@@ -272,31 +298,5 @@
 
 - Updated dependencies [[`0d71771`](https://github.com/mastra-ai/mastra/commit/0d71771f5711164c79f8e80919bc84d6bffeb6bc), [`0d6e55e`](https://github.com/mastra-ai/mastra/commit/0d6e55ecc5a2e689cd4fc9c86525e0eb54d82372)]:
   - @mastra/core@0.20.2-alpha.0
-  - @mastra/client-js@0.15.2-alpha.0
-  - @mastra/react@0.0.5-alpha.0
-
-## 6.4.0
-
-### Minor Changes
-
-- Update peer dependencies to match core package version bump (0.20.1) ([#8589](https://github.com/mastra-ai/mastra/pull/8589))
-
-### Patch Changes
-
-- workflow run thread more visible ([#8539](https://github.com/mastra-ai/mastra/pull/8539))
-
-- Mutable shared workflow run state ([#8545](https://github.com/mastra-ai/mastra/pull/8545))
-
-- streamLegacy/generateLegacy clarification in playground ([#8468](https://github.com/mastra-ai/mastra/pull/8468))
-
-- add tripwire reason in playground ([#8568](https://github.com/mastra-ai/mastra/pull/8568))
-
-- Save waiting step status in snapshot ([#8576](https://github.com/mastra-ai/mastra/pull/8576))
-
-- Added AI SDK provider packages to model router for anthropic/google/openai/openrouter/xai ([#8559](https://github.com/mastra-ai/mastra/pull/8559))
-
-- type fixes and missing changeset ([#8545](https://github.com/mastra-ai/mastra/pull/8545))
-
-- Convert WorkflowWatchResult to WorkflowResult in workflow graph ([#8541](https://github.com/mastra-ai/mastra/pull/8541))
 
-... 3803 more lines hidden. See full changelog in package directory.
+... 3829 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Freact.md

@@ -1,5 +1,21 @@
 # @mastra/react-hooks
 
+## 0.0.11-alpha.0
+
+### Patch Changes
+
+- Add tool call approval ([#8649](https://github.com/mastra-ai/mastra/pull/8649))
+
+- Updated dependencies [[`5df9cce`](https://github.com/mastra-ai/mastra/commit/5df9cce1a753438413f64c11eeef8f845745c2a8), [`2060766`](https://github.com/mastra-ai/mastra/commit/20607667bf78ea104cca3e15dfb93ae0b62c9d18)]:
+  - @mastra/client-js@0.16.5-alpha.0
+
+## 0.0.10
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @mastra/client-js@0.16.4
+
 ## 0.0.10-alpha.0
 
 ### Patch Changes
@@ -283,12 +299,4 @@
 
 - modify the useMastraChat hook to useChat ([#8265](https://github.com/mastra-ai/mastra/pull/8265))
 
-- Updated dependencies [[`5cb4596`](https://github.com/mastra-ai/mastra/commit/5cb4596c644104ea817bb0c5a07b8b1f8de595a8), [`86be6be`](https://github.com/mastra-ai/mastra/commit/86be6bee7e64b7d828a6b4eec283265c820dfa43), [`57b6dd5`](https://github.com/mastra-ai/mastra/commit/57b6dd50f9e6d92c0ed3e7199e6a92752025e3a1), [`ea8d386`](https://github.com/mastra-ai/mastra/commit/ea8d386cd8c5593664515fd5770c06bf2aa980ef), [`6f67656`](https://github.com/mastra-ai/mastra/commit/6f676562276926e2982401574d1e07157579be30)]:
-  - @mastra/client-js@0.14.0-alpha.1
-
-## 0.0.1-alpha.1
-
-### Patch Changes
-
-- Updated dependencies [[`dc099b4`](https://github.com/mastra-ai/mastra/commit/dc099b40fb31147ba3f362f98d991892033c4c67)]:
-  - @mastra/client-js@0.14.0-alpha.0
+... 11 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fserver.md

@@ -1,5 +1,25 @@
 # @mastra/server
 
+## 0.23.0-alpha.0
+
+### Minor Changes
+
+- Update peer dependencies to match core package version bump (0.22.1) ([#8649](https://github.com/mastra-ai/mastra/pull/8649))
+
+### Patch Changes
+
+- Add tool call approval ([#8649](https://github.com/mastra-ai/mastra/pull/8649))
+
+- Updated dependencies [[`f743dbb`](https://github.com/mastra-ai/mastra/commit/f743dbb8b40d1627b5c10c0e6fc154f4ebb6e394), [`5df9cce`](https://github.com/mastra-ai/mastra/commit/5df9cce1a753438413f64c11eeef8f845745c2a8), [`2060766`](https://github.com/mastra-ai/mastra/commit/20607667bf78ea104cca3e15dfb93ae0b62c9d18), [`2c4438b`](https://github.com/mastra-ai/mastra/commit/2c4438b87817ab7eed818c7990fef010475af1a3)]:
+  - @mastra/core@0.23.0-alpha.0
+
+## 0.22.2
+
+### Patch Changes
+
+- Updated dependencies [[`2b031e2`](https://github.com/mastra-ai/mastra/commit/2b031e25ca10cd3e4d63e6a27f909cba26d91405)]:
+  - @mastra/core@0.22.2
+
 ## 0.22.2-alpha.0
 
 ### Patch Changes
@@ -278,25 +298,5 @@
 
 - Breaking change to move the agent.streamVNext/generateVNext implementation to the default stream/generate. The old stream/generate have now been moved to streamLegacy and generateLegacy ([#8097](https://github.com/mastra-ai/mastra/pull/8097))
 
-### Patch Changes
-
-- Add approve and decline tool calls to mastra server pkg ([#8360](https://github.com/mastra-ai/mastra/pull/8360))
-
-- Fix/8219 preserve resourceid on resume ([#8359](https://github.com/mastra-ai/mastra/pull/8359))
-
-- Add observe strean to get streans after workflow has been interrupted ([#8318](https://github.com/mastra-ai/mastra/pull/8318))
-
-- Updated dependencies [[`00cb6bd`](https://github.com/mastra-ai/mastra/commit/00cb6bdf78737c0fac14a5a0c7b532a11e38558a), [`869ba22`](https://github.com/mastra-ai/mastra/commit/869ba222e1d6b58fc1b65e7c9fd55ca4e01b8c2f), [`1b73665`](https://github.com/mastra-ai/mastra/commit/1b73665e8e23f5c09d49fcf3e7d709c75259259e), [`f7d7475`](https://github.com/mastra-ai/mastra/commit/f7d747507341aef60ed39e4b49318db1f86034a6), [`084b77b`](https://github.com/mastra-ai/mastra/commit/084b77b2955960e0190af8db3f77138aa83ed65c), [`a93ff84`](https://github.com/mastra-ai/mastra/commit/a93ff84b5e1af07ee236ac8873dac9b49aa5d501), [`bc5aacb`](https://github.com/mastra-ai/mastra/commit/bc5aacb646d468d325327e36117129f28cd13bf6), [`6b5af12`](https://github.com/mastra-ai/mastra/commit/6b5af12ce9e09066e0c32e821c203a6954498bea), [`bf60e4a`](https://github.com/mastra-ai/mastra/commit/bf60e4a89c515afd9570b7b79f33b95e7d07c397), [`d41aee5`](https://github.com/mastra-ai/mastra/commit/d41aee526d124e35f42720a08e64043229193679), [`e8fe13c`](https://github.com/mastra-ai/mastra/commit/e8fe13c4b4c255a42520127797ec394310f7c919), [`3ca833d`](https://github.com/mastra-ai/mastra/commit/3ca833dc994c38e3c9b4f9b4478a61cd8e07b32a), [`1edb8d1`](https://github.com/mastra-ai/mastra/commit/1edb8d1cfb963e72a12412990fb9170936c9904c), [`fbf6e32`](https://github.com/mastra-ai/mastra/commit/fbf6e324946332d0f5ed8930bf9d4d4479cefd7a), [`4753027`](https://github.com/mastra-ai/mastra/commit/4753027ee889288775c6958bdfeda03ff909af67)]:
-  - @mastra/core@0.20.0-alpha.0
-
-## 0.19.1
-
-### Patch Changes
-
-- Added Mastra model router to Playground UI ([#8332](https://github.com/mastra-ai/mastra/pull/8332))
-
-- Updated dependencies [[`4a70ccc`](https://github.com/mastra-ai/mastra/commit/4a70ccc5cfa12ae9c2b36545a5814cd98e5a0ead), [`0992b8b`](https://github.com/mastra-ai/mastra/commit/0992b8bf0f4f1ba7ad9940883ec4bb8d867d3105), [`283bea0`](https://github.com/mastra-ai/mastra/commit/283bea07adbaf04a27fa3ad2df611095e0825195)]:
-  - @mastra/core@0.19.1
-
 
-... 3846 more lines hidden. See full changelog in package directory.
+... 3866 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,9 @@
 # create-mastra
 
+## 0.17.4-alpha.0
+
+## 0.17.3
+
 ## 0.17.3-alpha.0
 
 ## 0.17.2
@@ -294,9 +298,5 @@
 
 - Add conditional chaining to scorer.agentNames return ([#8199](https://github.com/mastra-ai/mastra/pull/8199))
 
-- Show model that worked when there are model fallbacks ([#8167](https://github.com/mastra-ai/mastra/pull/8167))
-
-## 0.13.3-alpha.0
-
 
-... 1774 more lines hidden. See full changelog in package directory.
+... 1778 more lines hidden. See full changelog in package directory.

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

@@ -1,5 +1,21 @@
 # mastra
 
+## 0.17.4-alpha.0
+
+### Patch Changes
+
+- Updated dependencies [[`f743dbb`](https://github.com/mastra-ai/mastra/commit/f743dbb8b40d1627b5c10c0e6fc154f4ebb6e394), [`5df9cce`](https://github.com/mastra-ai/mastra/commit/5df9cce1a753438413f64c11eeef8f845745c2a8), [`5df9cce`](https://github.com/mastra-ai/mastra/commit/5df9cce1a753438413f64c11eeef8f845745c2a8), [`2060766`](https://github.com/mastra-ai/mastra/commit/20607667bf78ea104cca3e15dfb93ae0b62c9d18), [`2060766`](https://github.com/mastra-ai/mastra/commit/20607667bf78ea104cca3e15dfb93ae0b62c9d18), [`2c4438b`](https://github.com/mastra-ai/mastra/commit/2c4438b87817ab7eed818c7990fef010475af1a3)]:
+  - @mastra/core@0.23.0-alpha.0
+  - @mastra/deployer@0.23.0-alpha.0
+
+## 0.17.3
+
+### Patch Changes
+
+- Updated dependencies [[`2b031e2`](https://github.com/mastra-ai/mastra/commit/2b031e25ca10cd3e4d63e6a27f909cba26d91405)]:
+  - @mastra/core@0.22.2
+  - @mastra/deployer@0.22.2
+
 ## 0.17.3-alpha.0
 
 ### Patch Changes
@@ -282,21 +298,5 @@
 
 ## 0.14.2-alpha.2
 
-### Patch Changes
-
-- Added AI SDK provider packages to model router for anthropic/google/openai/openrouter/xai ([#8559](https://github.com/mastra-ai/mastra/pull/8559))
-
-- Updated dependencies [[`42ffed3`](https://github.com/mastra-ai/mastra/commit/42ffed311b9d8750652bbc55c773be62c989fcc6), [`ee9108f`](https://github.com/mastra-ai/mastra/commit/ee9108fa29bb8368fc23df158c9f0645b2d7b65c)]:
-  - @mastra/deployer@0.20.1-alpha.2
-  - @mastra/core@0.20.1-alpha.2
-
-## 0.14.2-alpha.1
-
-### Patch Changes
-
-- workflow run thread more visible ([#8539](https://github.com/mastra-ai/mastra/pull/8539))
-
-- Mutable shared workflow run state ([#8545](https://github.com/mastra-ai/mastra/pull/8545))
-
 
-... 6288 more lines hidden. See full changelog in package directory.
+... 6304 more lines hidden. See full changelog in package directory.

package/.docs/organized/code-examples/memory-with-mongodb.md

@@ -0,0 +1,208 @@
+### package.json
+```json
+{
+  "name": "memory-with-mongodb",
+  "dependencies": {
+    "@ai-sdk/openai": "latest",
+    "@mastra/core": "latest",
+    "@mastra/memory": "latest",
+    "@mastra/mongodb": "latest"
+  },
+  "devDependencies": {
+    "dotenv": "^17.0.0",
+    "tsx": "^4.19.3"
+  }
+}
+```
+
+### chat.ts
+```typescript
+import { randomUUID } from 'crypto';
+import Readline from 'readline';
+
+import 'dotenv/config';
+
+import { mastra } from './mastra';
+
+const agent = mastra.getAgent('memoryAgent');
+
+let thread = randomUUID();
+// use this to play with a long running conversation. comment it out to get a new thread id every time
+thread = `39873fbf-84d6-425e-8c1b-8afd798d72a4`;
+// thread = `12569b14-3e16-4e31-8130-8d9676f1932c`;
+console.log(thread);
+
+const resource = 'SOME_USER_ID';
+
+async function logRes(res: Awaited<ReturnType<typeof agent.stream>>) {
+  console.log(`\n🤖 Agent:`);
+  for await (const chunk of res.textStream) {
+    process.stdout.write(chunk);
+  }
+  console.log(`\n\n`);
+}
+
+async function main() {
+  await logRes(
+    await agent.stream(
+      [
+        {
+          role: 'system',
+          content: `Chat with user started now ${new Date().toISOString()}. Don't mention this message. This means some time may have passed between this message and the one before. The user left and came back again. Say something to start the conversation up again.`,
+        },
+      ],
+      { memory: { resource, thread } },
+    ),
+  );
+
+  const rl = Readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  while (true) {
+    const prompt: string = await new Promise(res => {
+      rl.question('Message: ', answer => {
+        res(answer);
+      });
+    });
+
+    await logRes(
+      await agent.stream(prompt, {
+        memory: { thread, resource },
+      }),
+    );
+  }
+}
+
+main();
+
+```
+
+### index.ts
+```typescript
+import { randomUUID } from 'crypto';
+
+import { mastra } from './mastra';
+
+function log(message: string) {
+  console.log(`\n>>Prompt: ${message}`);
+  return message;
+}
+
+const agent = mastra.getAgent('chefAgent');
+const threadId = randomUUID();
+const resourceId = 'SOME_USER_ID';
+
+async function logRes(res: Awaited<ReturnType<typeof agent.stream>>) {
+  console.log(`\n👨‍🍳 Chef:`);
+  for await (const chunk of res.textStream) {
+    process.stdout.write(chunk);
+  }
+  console.log(`\n\n`);
+}
+
+async function main() {
+  await logRes(
+    await agent.stream(
+      log(
+        'In my kitchen I have: pasta, canned tomatoes, garlic, olive oil, and some dried herbs (basil and oregano). What can I make? Please keep your answer brief, only give me the high level steps.',
+      ),
+      {
+        threadId,
+        resourceId,
+      },
+    ),
+  );
+
+  await logRes(
+    await agent.stream(
+      log(
+        "Now I'm over at my friend's house, and they have: chicken thighs, coconut milk, sweet potatoes, and some curry powder.",
+      ),
+      {
+        threadId,
+        resourceId,
+      },
+    ),
+  );
+
+  await logRes(
+    await agent.stream(log('What did we cook before I went to my friends house?'), {
+      threadId,
+      resourceId,
+      memoryOptions: {
+        lastMessages: 3,
+      },
+    }),
+  );
+
+  process.exit(0);
+}
+
+main();
+
+```
+
+### mastra/agents/index.ts
+```typescript
+import { openai } from '@ai-sdk/openai';
+import { Agent } from '@mastra/core/agent';
+import { Memory } from '@mastra/memory';
+import { MongoDBStore, MongoDBVector } from '@mastra/mongodb';
+
+// This URI must be an Atlas MongoDB deployment in order to work with vector search
+// in the format mongodb+srv://<username>:<password>@<cluster>.mongodb.net
+const uri = process.env.MONGODB_URI;
+const dbName = process.env.MONGODB_DB_NAME || 'mastra_memory';
+
+export const memory = new Memory({
+  storage: new MongoDBStore({
+    url: uri,
+    dbName,
+  }),
+  vector: new MongoDBVector({
+    uri,
+    dbName,
+  }),
+  options: {
+    lastMessages: 10,
+    semanticRecall: {
+      topK: 3,
+      messageRange: 2,
+    },
+  },
+  embedder: openai.embedding('text-embedding-3-small'),
+});
+
+export const chefAgent = new Agent({
+  name: 'chefAgent',
+  instructions:
+    'You are Michel, a practical and experienced home chef who helps people cook great meals with whatever ingredients they have available. Your first priority is understanding what ingredients and equipment the user has access to, then suggesting achievable recipes. You explain cooking steps clearly and offer substitutions when needed, maintaining a friendly and encouraging tone throughout.',
+  model: openai('gpt-4o'),
+  memory,
+});
+
+export const memoryAgent = new Agent({
+  name: 'Memory Agent',
+  instructions:
+    "You are an AI agent with the ability to automatically recall memories from previous interactions. You may have conversations that last hours, days, months, or years. If you don't know it already you should ask for the users name and some info about them.",
+  model: openai('gpt-4o'),
+  memory,
+});
+
+```
+
+### mastra/index.ts
+```typescript
+import { Mastra } from '@mastra/core';
+
+import 'dotenv/config';
+
+import { chefAgent, memoryAgent } from './agents';
+
+export const mastra = new Mastra({
+  agents: { chefAgent, memoryAgent },
+});
+
+```

package/.docs/raw/getting-started/project-structure.mdx

@@ -63,7 +63,7 @@ Top-level files define how your Mastra project is configured, built, and connect
 | File                  | Description |
 | --------------------- | ------------ |
 | `src/mastra/index.ts` | Central entry point where you configure and initialize Mastra. |
-| `.env.example`        | Template for environment variables — copy and rename to `.env` to add your secret [model provider](/models) keys. |
+| `.env.example`        | Template for environment variables - copy and rename to `.env` to add your secret [model provider](/models) keys. |
 | `package.json`        | Defines project metadata, dependencies, and available npm scripts. |
 | `tsconfig.json`       | Configures TypeScript options such as path aliases, compiler settings, and build output. |
 

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

@@ -10,15 +10,15 @@ import { Callout } from "nextra/components";
 
 # Playground
 
-Playground helps you build agents quickly. It provides an interactive UI for testing your agents and workflows, along with a REST API that exposes your Mastra application as a local service. This lets you start building without having to integrate Mastra into your project right away.
+Playground provides an interactive UI for building and testing your agents, along with a REST API that exposes your Mastra application as a local service. This lets you start building without worrying about integration right away.
 
-As your project evolves, Playground enables you to iterate quickly. Features like Observability and Scorers give you visibility into performance at every stage of development.
+As your project evolves, Playground's development environment helps you iterate on your agent quickly. Meanwhile, Observability and Scorer features give you visibility into performance at every stage.
 
-To get started, run Playground locally using the instructions below, or [deploy to Mastra Cloud](/docs/mastra-cloud/setting-up) to access the Playground remotely and collaborate with your team.
+To get started, run Playground locally using the instructions below, or [deploy to Mastra Cloud](https://mastra.ai/docs/mastra-cloud/setting-up) to collaborate with your team.
 
 <YouTube id="spGlcTEjuXY" startTime={126}/>
 
-## Launch Playground
+## Start Playground
 
 If you created your application with `create mastra`, start the local development server using the `dev` script. You can also run it directly with `mastra dev`.
 

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

@@ -69,7 +69,7 @@ All memory types are [thread-scoped](./working-memory.mdx#thread-scoped-memory-d
 
 To persist and recall information between conversations, memory requires a storage adapter.
 
-Supported options include [LibSQL](/examples/memory/memory-with-libsql), [Postgres](/examples/memory/memory-with-pg), and [Upstash](/examples/memory/memory-with-upstash)
+Supported options include [LibSQL](/docs/memory/storage/memory-with-libsql), [MongoDB](/docs/memory/storage/memory-with-mongodb), [Postgres](/docs/memory/storage/memory-with-pg), and [Upstash](/docs/memory/storage/memory-with-upstash)
 
 We use LibSQL out of the box because it is file-based or in-memory, so it is easy to install and works well with the playground.
 

package/.docs/raw/memory/semantic-recall.mdx

@@ -92,9 +92,10 @@ const agent = new Agent({
 
 **Storage/vector code Examples**:
 
-- [LibSQL](/examples/memory/memory-with-libsql)
-- [Postgres](/examples/memory/memory-with-pg)
-- [Upstash](/examples/memory/memory-with-upstash)
+- [LibSQL](/docs/memory/storage/memory-with-libsql)
+- [MongoDB](/docs/memory/storage/memory-with-mongodb)
+- [Postgres](/docs/memory/storage/memory-with-pg)
+- [Upstash](/docs/memory/storage/memory-with-upstash)
 
 ### Embedder configuration
 

package/.docs/raw/memory/storage/memory-with-libsql.mdx

@@ -0,0 +1,141 @@
+---
+title: "Example: Memory with LibSQL | Memory | Mastra Docs"
+description: Example for how to use Mastra's memory system with LibSQL storage and vector database backend.
+---
+
+# Memory with LibSQL
+
+This example demonstrates how to use Mastra's memory system with LibSQL as the storage backend.
+
+## Prerequisites
+
+This example uses the `openai` model. Make sure to add `OPENAI_API_KEY` to your `.env` file.
+
+```bash filename=".env" copy
+OPENAI_API_KEY=<your-api-key>
+```
+
+And install the following package:
+
+```bash copy
+npm install @mastra/libsql
+```
+
+## Adding memory to an agent
+
+To add LibSQL memory to an agent use the `Memory` class and create a new `storage` key using `LibSQLStore`. The `url` can either by a remote location, or a local file system resource.
+
+```typescript filename="src/mastra/agents/example-libsql-agent.ts" showLineNumbers copy
+import { Memory } from "@mastra/memory";
+import { Agent } from "@mastra/core/agent";
+import { openai } from "@ai-sdk/openai";
+import { LibSQLStore } from "@mastra/libsql";
+
+export const libsqlAgent = new Agent({
+  name: "libsql-agent",
+  instructions: "You are an AI agent with the ability to automatically recall memories from previous interactions.",
+  model: openai("gpt-4o"),
+  memory: new Memory({
+    storage: new LibSQLStore({
+      url: "file:libsql-agent.db"
+    }),
+    options: {
+      threads: {
+        generateTitle: true
+      }
+    }
+  })
+});
+```
+
+## Local embeddings with fastembed
+
+Embeddings are numeric vectors used by memory’s `semanticRecall` to retrieve related messages by meaning (not keywords). This setup uses `@mastra/fastembed` to generate vector embeddings.
+
+Install `fastembed` to get started:
+
+```bash copy
+npm install @mastra/fastembed
+```
+
+Add the following to your agent:
+
+```typescript filename="src/mastra/agents/example-libsql-agent.ts" showLineNumbers copy
+import { Memory } from "@mastra/memory";
+import { Agent } from "@mastra/core/agent";
+import { openai } from "@ai-sdk/openai";
+import { LibSQLStore, LibSQLVector } from "@mastra/libsql";
+import { fastembed } from "@mastra/fastembed";
+
+export const libsqlAgent = new Agent({
+  name: "libsql-agent",
+  instructions: "You are an AI agent with the ability to automatically recall memories from previous interactions.",
+  model: openai("gpt-4o"),
+  memory: new Memory({
+    storage: new LibSQLStore({
+      url: "file:libsql-agent.db"
+    }),
+    vector: new LibSQLVector({
+      connectionUrl: "file:libsql-agent.db"
+    }),
+    embedder: fastembed,
+    options: {
+      lastMessages: 10,
+      semanticRecall: {
+        topK: 3,
+        messageRange: 2
+      },
+      threads: {
+        generateTitle: true
+      }
+    }
+  })
+});
+```
+
+## Usage example
+
+Use `memoryOptions` to scope recall for this request. Set `lastMessages: 5` to limit recency-based recall, and use `semanticRecall` to fetch the `topK: 3` most relevant messages, including `messageRange: 2` neighboring messages for context around each match.
+
+```typescript filename="src/test-libsql-agent.ts" showLineNumbers copy
+import "dotenv/config";
+
+import { mastra } from "./mastra";
+
+const threadId = "123";
+const resourceId = "user-456";
+
+const agent = mastra.getAgent("libsqlAgent");
+
+const message = await agent.stream("My name is Mastra", {
+  memory: {
+    thread: threadId,
+    resource: resourceId
+  }
+});
+
+await message.textStream.pipeTo(new WritableStream());
+
+const stream = await agent.stream("What's my name?", {
+  memory: {
+    thread: threadId,
+    resource: resourceId
+  },
+  memoryOptions: {
+    lastMessages: 5,
+    semanticRecall: {
+      topK: 3,
+      messageRange: 2
+    }
+  }
+});
+
+for await (const chunk of stream.textStream) {
+  process.stdout.write(chunk);
+}
+```
+
+
+## Related
+
+- [Calling Agents](../agents/calling-agents.mdx)