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

package/.docs/raw/workflows/time-travel.mdx

@@ -23,7 +23,7 @@ Time travel requires storage to be configured since it relies on persisted workf
 
 Use `run.timeTravel()` to re-execute a workflow from a specific step:
 
-```typescript showLineNumbers copy
+```typescript
 import { mastra } from "./mastra";
 
 const workflow = mastra.getWorkflow("myWorkflow");
@@ -41,7 +41,7 @@ You can specify the target step using either a step reference or a step ID:
 
 ### Using step reference
 
-```typescript showLineNumbers copy
+```typescript
 const result = await run.timeTravel({
   step: step2,
   inputData: { value: 10 },
@@ -50,7 +50,7 @@ const result = await run.timeTravel({
 
 ### Using step ID
 
-```typescript showLineNumbers copy
+```typescript
 const result = await run.timeTravel({
   step: "step2",
   inputData: { value: 10 },
@@ -61,7 +61,7 @@ const result = await run.timeTravel({
 
 For steps inside nested workflows, use dot notation, an array of step IDS or an array of step references:
 
-```typescript showLineNumbers copy
+```typescript
 // Using dot notation
 const result = await run.timeTravel({
   step: "nestedWorkflow.step3",
@@ -85,7 +85,7 @@ const result = await run.timeTravel({
 
 You can provide context to specify the state of previous steps when time traveling:
 
-```typescript {3-13} showLineNumbers copy
+```typescript {3-13}
 const result = await run.timeTravel({
   step: "step2",
   context: {
@@ -114,7 +114,7 @@ The context object contains step results keyed by step ID. Each step result incl
 
 Time travel is particularly useful for debugging and recovering from failed workflow executions:
 
-```typescript showLineNumbers copy
+```typescript
 const workflow = mastra.getWorkflow("myWorkflow");
 const run = await workflow.createRun();
 
@@ -136,7 +136,7 @@ if (failedResult.status === "failed") {
 
 You can time travel to resume a suspended workflow from an earlier step:
 
-```typescript showLineNumbers copy
+```typescript
 const run = await workflow.createRun();
 
 // Start workflow - suspends at promptAgent step
@@ -159,7 +159,7 @@ if (initialResult.status === "suspended") {
 
 Use `timeTravelStream()` to receive streaming events during time travel execution:
 
-```typescript showLineNumbers copy
+```typescript
 const run = await workflow.createRun();
 
 const output = run.timeTravelStream({
@@ -180,7 +180,7 @@ const result = await output.result;
 
 You can provide initial state when time traveling to set workflow-level state:
 
-```typescript showLineNumbers copy
+```typescript
 const result = await run.timeTravel({
   step: "step2",
   inputData: { value: 10 },
@@ -199,7 +199,7 @@ Time travel throws errors in specific situations:
 
 You cannot time travel to a workflow that is currently running:
 
-```typescript showLineNumbers copy
+```typescript
 try {
   await run.timeTravel({ step: "step2" });
 } catch (error) {
@@ -211,7 +211,7 @@ try {
 
 Time travel throws if the target step doesn't exist in the workflow:
 
-```typescript showLineNumbers copy
+```typescript
 try {
   await run.timeTravel({ step: "nonExistentStep" });
 } catch (error) {
@@ -223,7 +223,7 @@ try {
 
 When `validateInputs` is enabled, time travel validates the input data against the step's schema:
 
-```typescript showLineNumbers copy
+```typescript
 try {
   await run.timeTravel({
     step: "step2",
@@ -238,7 +238,7 @@ try {
 
 When time traveling into a nested workflow, you can provide context for both the parent and nested workflow steps:
 
-```typescript showLineNumbers copy
+```typescript
 const result = await run.timeTravel({
   step: "nestedWorkflow.step3",
   context: {
@@ -275,7 +275,7 @@ const result = await run.timeTravel({
 
 Re-run a failed step with the same or modified input to diagnose issues:
 
-```typescript showLineNumbers copy
+```typescript
 const result = await run.timeTravel({
   step: failedStepId,
   context: originalContext, // Use context from the failed run
@@ -286,7 +286,7 @@ const result = await run.timeTravel({
 
 Test individual steps with specific inputs on a new workflow run, useful for testing a step logic without starting workflow execution from the beginning.
 
-```typescript showLineNumbers copy
+```typescript
 const result = await run.timeTravel({
   step: "processData",
   inputData: { testData: "specific test case" },
@@ -297,7 +297,7 @@ const result = await run.timeTravel({
 
 Re-run steps that failed due to temporary issues (network errors, rate limits):
 
-```typescript showLineNumbers copy
+```typescript
 // After fixing the external service issue
 const result = await run.timeTravel({
   step: "callExternalApi",

package/.docs/raw/workflows/workflow-state.mdx

@@ -14,7 +14,7 @@ It's important to understand the difference between **state** and **step input/o
 - **Step input/output**: Data flows sequentially between steps. Each step receives the previous step's output as its `inputData`, and returns an output for the next step.
 - **State**: A shared store that all steps can read and update via `state` and `setState`. State persists across the entire workflow run, including suspend/resume cycles.
 
-```typescript title="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+```typescript title="src/mastra/workflows/test-workflow.ts"
 const step1 = createStep({
   id: "step-1",
   inputSchema: z.object({ workflowInput: z.string() }),
@@ -40,9 +40,8 @@ const step1 = createStep({
 
 Define a `stateSchema` on both the workflow and individual steps. The workflow's stateSchema is the master schema containing all possible state values, while each step declares only the subset it needs:
 
-```typescript title="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+```typescript title="src/mastra/workflows/test-workflow.ts"
 const step1 = createStep({
-  // ...
   stateSchema: z.object({
     processedItems: z.array(z.string()),
   }),
@@ -61,7 +60,6 @@ const step1 = createStep({
 });
 
 const step2 = createStep({
-  // ...
   stateSchema: z.object({
     metadata: z.object({
       processedBy: z.string(),
@@ -78,7 +76,6 @@ const step2 = createStep({
 });
 
 export const testWorkflow = createWorkflow({
-  // ...
   stateSchema: z.object({
     processedItems: z.array(z.string()),
     metadata: z.object({
@@ -95,7 +92,7 @@ export const testWorkflow = createWorkflow({
 
 Pass `initialState` when starting a workflow run to set the starting values:
 
-```typescript showLineNumbers copy
+```typescript
 const run = await workflow.createRun();
 
 const result = await run.start({
@@ -113,7 +110,7 @@ The `initialState` object should match the structure defined in the workflow's `
 
 State automatically persists across suspend and resume cycles. When a workflow suspends and later resumes, all state updates made before the suspension are preserved:
 
-```typescript title="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+```typescript title="src/mastra/workflows/test-workflow.ts"
 const step1 = createStep({
   id: "step-1",
   inputSchema: z.object({}),
@@ -137,7 +134,7 @@ const step1 = createStep({
 
 When using nested workflows, state propagates from parent to child. Changes made by the parent workflow before calling a nested workflow are visible to steps inside the nested workflow:
 
-```typescript title="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+```typescript title="src/mastra/workflows/test-workflow.ts"
 const nestedStep = createStep({
   id: "nested-step",
   inputSchema: z.object({}),

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # @mastra/mcp-docs-server
 
+## 1.0.0-beta.14
+
+### Patch Changes
+
+- Add --log-level CLI argument to control log verbosity ([#11256](https://github.com/mastra-ai/mastra/pull/11256))
+
+- Updated dependencies [[`4f94ed8`](https://github.com/mastra-ai/mastra/commit/4f94ed8177abfde3ec536e3574883e075423350c), [`ac3cc23`](https://github.com/mastra-ai/mastra/commit/ac3cc2397d1966bc0fc2736a223abc449d3c7719), [`a86f4df`](https://github.com/mastra-ai/mastra/commit/a86f4df0407311e0d2ea49b9a541f0938810d6a9), [`029540c`](https://github.com/mastra-ai/mastra/commit/029540ca1e582fc2dd8d288ecd4a9b0f31a954ef), [`66741d1`](https://github.com/mastra-ai/mastra/commit/66741d1a99c4f42cf23a16109939e8348ac6852e), [`01b20fe`](https://github.com/mastra-ai/mastra/commit/01b20fefb7c67c2b7d79417598ef4e60256d1225), [`0dbf199`](https://github.com/mastra-ai/mastra/commit/0dbf199110f22192ce5c95b1c8148d4872b4d119), [`a7ce182`](https://github.com/mastra-ai/mastra/commit/a7ce1822a8785ce45d62dd5c911af465e144f7d7)]:
+  - @mastra/core@1.0.0-beta.14
+
+## 1.0.0-beta.13
+
+### Patch Changes
+
+- Updated dependencies [[`919a22b`](https://github.com/mastra-ai/mastra/commit/919a22b25876f9ed5891efe5facbe682c30ff497)]:
+  - @mastra/core@1.0.0-beta.13
+
+## 1.0.0-beta.12
+
+### Patch Changes
+
+- Updated dependencies [[`d5ed981`](https://github.com/mastra-ai/mastra/commit/d5ed981c8701c1b8a27a5f35a9a2f7d9244e695f), [`9650cce`](https://github.com/mastra-ai/mastra/commit/9650cce52a1d917ff9114653398e2a0f5c3ba808), [`932d63d`](https://github.com/mastra-ai/mastra/commit/932d63dd51be9c8bf1e00e3671fe65606c6fb9cd), [`b760b73`](https://github.com/mastra-ai/mastra/commit/b760b731aca7c8a3f041f61d57a7f125ae9cb215), [`695a621`](https://github.com/mastra-ai/mastra/commit/695a621528bdabeb87f83c2277cf2bb084c7f2b4), [`2b459f4`](https://github.com/mastra-ai/mastra/commit/2b459f466fd91688eeb2a44801dc23f7f8a887ab), [`486352b`](https://github.com/mastra-ai/mastra/commit/486352b66c746602b68a95839f830de14c7fb8c0), [`09e4bae`](https://github.com/mastra-ai/mastra/commit/09e4bae18dd5357d2ae078a4a95a2af32168ab08), [`24b76d8`](https://github.com/mastra-ai/mastra/commit/24b76d8e17656269c8ed09a0c038adb9cc2ae95a), [`243a823`](https://github.com/mastra-ai/mastra/commit/243a8239c5906f5c94e4f78b54676793f7510ae3), [`486352b`](https://github.com/mastra-ai/mastra/commit/486352b66c746602b68a95839f830de14c7fb8c0), [`c61fac3`](https://github.com/mastra-ai/mastra/commit/c61fac3add96f0dcce0208c07415279e2537eb62), [`6f14f70`](https://github.com/mastra-ai/mastra/commit/6f14f706ccaaf81b69544b6c1b75ab66a41e5317), [`09e4bae`](https://github.com/mastra-ai/mastra/commit/09e4bae18dd5357d2ae078a4a95a2af32168ab08), [`4524734`](https://github.com/mastra-ai/mastra/commit/45247343e384717a7c8404296275c56201d6470f), [`2a53598`](https://github.com/mastra-ai/mastra/commit/2a53598c6d8cfeb904a7fc74e57e526d751c8fa6), [`c7cd3c7`](https://github.com/mastra-ai/mastra/commit/c7cd3c7a187d7aaf79e2ca139de328bf609a14b4), [`847c212`](https://github.com/mastra-ai/mastra/commit/847c212caba7df0d6f2fc756b494ac3c75c3720d), [`6f941c4`](https://github.com/mastra-ai/mastra/commit/6f941c438ca5f578619788acc7608fc2e23bd176)]:
+  - @mastra/core@1.0.0-beta.12
+
 ## 1.0.0-beta.11
 
 ### Patch Changes

package/dist/logger.d.ts

@@ -1,4 +1,7 @@
 import type { MCPServer } from '@mastra/mcp';
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'none';
+export declare function setLogLevel(level: LogLevel): void;
+export declare function getLogLevel(): LogLevel;
 export interface Logger {
     debug: (message: string, data?: any) => Promise<void>;
     info: (message: string, data?: any) => Promise<void>;

package/dist/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAI7C,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAED,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,EAAE,OAAO,GAAG,SA2BxD,CAAC;AAGF,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CA2FvD;AAGD,eAAO,MAAM,MAAM,QAAiB,CAAC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAI7C,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAkCpE,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD;AAED,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AASD,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAED,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,EAAE,OAAO,GAAG,SA2BxD,CAAC;AAGF,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CA4FvD;AAGD,eAAO,MAAM,MAAM,QAAiB,CAAC"}

package/dist/stdio.js

@@ -10,6 +10,40 @@ import fs3 from 'fs/promises';
 import { MCPServer } from '@mastra/mcp';
 import { z } from 'zod';
 
+var LOG_LEVEL_PRIORITY = {
+  debug: 0,
+  info: 1,
+  warn: 2,
+  error: 3,
+  none: 4
+  // none = disable all logs
+};
+function mapToLogLevel(level) {
+  switch (level) {
+    case "debug":
+      return "debug";
+    case "info":
+    case "notice":
+      return "info";
+    case "warning":
+      return "warn";
+    case "error":
+    case "critical":
+    case "alert":
+    case "emergency":
+      return "error";
+    default:
+      return "info";
+  }
+}
+var currentLogLevel = "debug";
+function setLogLevel(level) {
+  currentLogLevel = level;
+}
+function shouldLog(level) {
+  const mappedLevel = mapToLogLevel(level);
+  return LOG_LEVEL_PRIORITY[mappedLevel] >= LOG_LEVEL_PRIORITY[currentLogLevel];
+}
 var writeErrorLog = (message, data) => {
   const now = /* @__PURE__ */ new Date();
   const timestamp = now.toISOString();
@@ -31,6 +65,7 @@ var writeErrorLog = (message, data) => {
 function createLogger(server2) {
   const sendLog = async (level, message, data) => {
     if (!server2) return;
+    if (!shouldLog(level)) return;
     try {
       const sdkServer = server2.getServer();
       if (!sdkServer) return;
@@ -1499,6 +1534,24 @@ async function runServer() {
 }
 
 // src/stdio.ts
+function parseLogLevel() {
+  const args = process.argv.slice(2);
+  const logLevelIndex = args.indexOf("--log-level");
+  if (logLevelIndex === -1 || logLevelIndex === args.length - 1) {
+    return void 0;
+  }
+  const level = args[logLevelIndex + 1];
+  const validLevels = ["debug", "info", "warn", "error", "none"];
+  if (validLevels.includes(level)) {
+    return level;
+  }
+  console.error(`Invalid log level: ${level}. Valid levels: ${validLevels.join(", ")}`);
+  return void 0;
+}
+var logLevel = parseLogLevel();
+if (logLevel) {
+  setLogLevel(logLevel);
+}
 runServer().catch((error) => {
   const errorMessage = "Fatal error running server";
   console.error(errorMessage, error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.0.0-beta.11",
+  "version": "1.0.0-beta.14",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -28,8 +28,8 @@
     "@modelcontextprotocol/sdk": "^1.17.5",
     "jsdom": "^26.1.0",
     "zod": "^3.25.76",
-    "@mastra/core": "1.0.0-beta.11",
-    "@mastra/mcp": "^1.0.0-beta.6"
+    "@mastra/mcp": "^1.0.0-beta.6",
+    "@mastra/core": "1.0.0-beta.14"
   },
   "devDependencies": {
     "@hono/node-server": "^1.19.6",
@@ -46,7 +46,7 @@
     "typescript": "^5.8.3",
     "vitest": "4.0.12",
     "@internal/lint": "0.0.53",
-    "@mastra/core": "1.0.0-beta.11"
+    "@mastra/core": "1.0.0-beta.14"
   },
   "homepage": "https://mastra.ai",
   "repository": {

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

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

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/memory/conversation-history.mdx

@@ -1,24 +0,0 @@
----
-title: "Conversation History | Memory"
-description: "Learn how to configure conversation history in Mastra to store recent messages from the current conversation."
----
-
-# Conversation History
-
-Conversation history is the simplest kind of memory. It is a list of messages from the current conversation.
-
-By default, each request includes the last 10 messages from the current memory thread, giving the agent short-term conversational context. This limit can be increased using the `lastMessages` parameter.
-
-You can increase this limit by passing the `lastMessages` parameter to the `Memory` instance.
-
-```typescript {3-7} showLineNumbers
-export const testAgent = new Agent({
-  id: "test-agent",
-  // ...
-  memory: new Memory({
-    options: {
-      lastMessages: 20,
-    },
-  }),
-});
-```

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

@@ -1,140 +0,0 @@
----
-title: "Memory with LibSQL | Memory"
-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 title=".env" copy
-OPENAI_API_KEY=<your-api-key>
-```
-
-And install the following package:
-
-```bash copy
-npm install @mastra/libsql@beta
-```
-
-## 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 title="src/mastra/agents/example-libsql-agent.ts" showLineNumbers copy
-import { Memory } from "@mastra/memory";
-import { Agent } from "@mastra/core/agent";
-import { LibSQLStore } from "@mastra/libsql";
-
-export const libsqlAgent = new Agent({
-  id: "libsql-agent",
-  name: "LibSQL Agent",
-  instructions:
-    "You are an AI agent with the ability to automatically recall memories from previous interactions.",
-  model: "openai/gpt-5.1",
-  memory: new Memory({
-    storage: new LibSQLStore({
-      id: 'libsql-agent-storage',
-      url: "file:libsql-agent.db",
-    }),
-    options: {
-      generateTitle: true, // Explicitly enable automatic title generation
-    },
-  }),
-});
-```
-
-## 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@beta
-```
-
-Add the following to your agent:
-
-```typescript title="src/mastra/agents/example-libsql-agent.ts" showLineNumbers copy
-import { Memory } from "@mastra/memory";
-import { Agent } from "@mastra/core/agent";
-import { LibSQLStore, LibSQLVector } from "@mastra/libsql";
-import { fastembed } from "@mastra/fastembed";
-
-export const libsqlAgent = new Agent({
-  id: "libsql-agent",
-  name: "LibSQL Agent",
-  instructions:
-    "You are an AI agent with the ability to automatically recall memories from previous interactions.",
-  model: "openai/gpt-5.1",
-  memory: new Memory({
-    storage: new LibSQLStore({
-      id: 'libsql-agent-storage',
-      url: "file:libsql-agent.db",
-    }),
-    vector: new LibSQLVector({
-      id: 'libsql-agent-vector',
-      connectionUrl: "file:libsql-agent.db",
-    }),
-    embedder: fastembed,
-    options: {
-      lastMessages: 10,
-      semanticRecall: {
-        topK: 3,
-        messageRange: 2,
-      },
-      threads: {
-        generateTitle: true, // Explicitly enable automatic title generation
-      },
-    },
-  }),
-});
-```
-
-## 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 title="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);
-}
-```
-