@mastra/mcp-docs-server 0.13.2 → 0.13.3-alpha.0

package/.docs/raw/reference/memory/Memory.mdx

@@ -56,6 +56,15 @@ const memory = new Memory({
 - Last Name:
 `,
     },
+
+    // Thread configuration
+    threads: {
+      generateTitle: true, // Enable title generation using agent's model
+      // Or use a different model for title generation
+      // generateTitle: {
+      //   model: openai("gpt-4.1-nano"), // Use cheaper model for titles
+      // },
+    },
   },
 });
 
@@ -84,6 +93,66 @@ const memory = new Memory({
 
 If no template is provided, the Memory class uses a default template that includes fields for user details, preferences, goals, and other contextual information in Markdown format. See the [Working Memory guide](/docs/memory/working-memory.mdx#designing-effective-templates) for detailed usage examples and best practices.
 
+### Thread Title Generation
+
+The `generateTitle` feature automatically creates meaningful titles for conversation threads based on the user's first message. This helps organize and identify conversations in your application.
+
+#### Basic Usage
+
+```typescript copy showLineNumbers
+const memory = new Memory({
+  options: {
+    threads: {
+      generateTitle: true, // Use the agent's model for title generation
+    },
+  },
+});
+```
+
+#### Cost Optimization with Custom Models
+
+You can specify a different (typically cheaper) model for title generation while using a high-quality model for the main conversation:
+
+```typescript copy showLineNumbers
+import { openai } from "@ai-sdk/openai";
+
+const memory = new Memory({
+  options: {
+    threads: {
+      generateTitle: {
+        model: openai("gpt-4.1-nano"), // Cheaper model for titles
+      },
+    },
+  },
+});
+
+const agent = new Agent({
+  model: openai("gpt-4o"), // High-quality model for main conversation
+  memory,
+});
+```
+
+#### Dynamic Model Selection
+
+You can also use a function to dynamically determine the model based on runtime context:
+
+```typescript copy showLineNumbers
+const memory = new Memory({
+  options: {
+    threads: {
+      generateTitle: {
+        model: (ctx: RuntimeContext) => {
+          // Use different models based on context
+          const userTier = ctx.get("userTier");
+          return userTier === "premium" 
+            ? openai("gpt-4.1")
+            : openai("gpt-4.1-nano");
+        },
+      },
+    },
+  },
+});
+```
 ### embedder
 
 An embedding model is required if `semanticRecall` is enabled.
@@ -216,9 +285,9 @@ Mastra supports many embedding models through the [Vercel AI SDK](https://sdk.ve
     },
     {
       name: "threads",
-      type: "{ generateTitle?: boolean }",
+      type: "{ generateTitle?: boolean | { model: LanguageModelV1 | ((ctx: RuntimeContext) => LanguageModelV1 | Promise<LanguageModelV1>) } }",
       description:
-        "Settings related to memory thread creation. `generateTitle` will cause the thread.title to be generated from an llm summary of the users first message.",
+        "Settings related to memory thread creation. `generateTitle` controls automatic thread title generation from the user's first message. Can be a boolean to enable/disable using the agent's model, or an object with a custom model for title generation (useful for cost optimization). Example: { generateTitle: { model: openai('gpt-4.1-nano') } }",
       isOptional: true,
       defaultValue: "{ generateTitle: false }",
     },

package/.docs/raw/reference/observability/logger.mdx

@@ -57,3 +57,73 @@ logger.error("An error occurred"); // Logged as ERROR
 />
 
 **Note:** Some loggers require a `BaseLogMessage` object (with `message`, `destinationPath`, `type` fields). For instance, the `File` and `Upstash` loggers need structured messages.
+
+## File Transport (Structured Logs)
+
+```typescript showLineNumbers copy
+import { FileTransport } from "@mastra/loggers/file";
+
+const fileLogger = new PinoLogger({
+  name: "Mastra",
+  transports: { file: new FileTransport({ path: "test-dir/test.log" }) },
+  level: "warn",
+});
+
+fileLogger.warn("Low disk space", {
+  destinationPath: "system",
+  type: "WORKFLOW",
+});
+```
+
+## Upstash Logger (Remote Log Drain)
+
+```typescript showLineNumbers copy
+import { UpstashTransport } from "@mastra/loggers/upstash";
+
+const logger = new PinoLogger({
+  name: "Mastra",
+  transports: {
+    upstash: new UpstashTransport({
+      listName: "production-logs",
+      upstashUrl: process.env.UPSTASH_URL!,
+      upstashToken: process.env.UPSTASH_TOKEN!,
+    }),
+  },
+  level: "info",
+});
+
+logger.info({
+  message: "User signed in",
+  destinationPath: "auth",
+  type: "AGENT",
+  runId: "run_123",
+});
+```
+
+## Custom Transport
+
+You can create custom transports using the `createCustomTransport` utility to integrate with any logging service or stream.
+
+### Example: Sentry Integration
+
+```typescript showLineNumbers copy
+import { createCustomTransport } from "@mastra/core/loggers";
+import pinoSentry from 'pino-sentry-transport';
+
+const sentryStream = await pinoSentry({
+  sentry: {
+    dsn: 'YOUR_SENTRY_DSN',
+    _experiments: {
+      enableLogs: true,
+    },
+  },
+});
+
+const customTransport = createCustomTransport(sentryStream);
+
+const logger = new PinoLogger({
+  name: "Mastra",
+  transports: { sentry: customTransport },
+  level: "info",
+});
+```

package/.docs/raw/reference/rag/pg.mdx

@@ -504,6 +504,21 @@ try {
 - Adjust parameters like `lists` and `m` based on dataset size and query requirements.
 - Rebuild indexes periodically to maintain efficiency, especially after significant data changes.
 
+## Direct Pool Access
+
+The `PgVector` class exposes its underlying PostgreSQL connection pool as a public field:
+
+```typescript
+pgVector.pool // instance of pg.Pool
+```
+
+This enables advanced usage such as running direct SQL queries, managing transactions, or monitoring pool state. When using the pool directly:
+- You are responsible for releasing clients (`client.release()`) after use.
+- The pool remains accessible after calling `disconnect()`, but new queries will fail.
+- Direct access bypasses any validation or transaction logic provided by PgVector methods.
+
+This design supports advanced use cases but requires careful resource management by the user.
+
 ## Related
 
 - [Metadata Filters](./metadata-filters)

package/.docs/raw/reference/storage/postgresql.mdx

@@ -91,3 +91,20 @@ The storage implementation handles schema creation and updates automatically. It
 - `threads`: Stores conversation threads
 - `messages`: Stores individual messages
 - `metadata`: Stores additional metadata for threads and messages
+
+### Direct Database and Pool Access
+
+`PostgresStore` exposes both the underlying database object and the pg-promise instance as public fields:
+
+```typescript
+store.db  // pg-promise database instance
+store.pgp // pg-promise main instance
+```
+
+This enables direct queries and custom transaction management. When using these fields:
+- You are responsible for proper connection and transaction handling.
+- Closing the store (`store.close()`) will destroy the associated connection pool.
+- Direct access bypasses any additional logic or validation provided by PostgresStore methods.
+
+This approach is intended for advanced scenarios where low-level access is required.
+

package/.docs/raw/reference/workflows/step.mdx

@@ -35,6 +35,7 @@ const processOrder = createStep({
     getInitData,
     suspend,
     runtimeContext,
+    runCount
     runId,
   }) => {
     return {
@@ -90,7 +91,7 @@ const processOrder = createStep({
       type: "(params: ExecuteParams) => Promise<any>",
       description: "Async function containing step logic",
       required: true,
-    },
+    }
   ]}
 />
 
@@ -142,6 +143,12 @@ const processOrder = createStep({
       description:
         "Runtime context for dependency injection and contextual information.",
     },
+    {
+      name: "runCount",
+      type: "number",
+      description: "The run count for this specific step, it automatically increases each time the step runs",
+      isOptional: true,
+    }
   ]}
 />
 

package/.docs/raw/workflows/overview.mdx

@@ -172,7 +172,7 @@ const result = await run.start({
 
 console.log(JSON.stringify(result, null, 2));
 ```
-> see [createRunAsync](/reference/workflows/create-run-async) and [start](/reference/workflows/start) for more information.
+> see [createRunAsync](/reference/workflows/create-run) and [start](/reference/workflows/start) for more information.
 
 To trigger this workflow, run the following:
 

package/dist/{chunk-P5AHYMUI.js → chunk-7QXT2IEP.js}

@@ -119,6 +119,21 @@ ${pathList}`;
 }
 var EXAMPLES_SOURCE = fromRepoRoot("examples");
 var OUTPUT_DIR = fromPackageRoot(".docs/organized/code-examples");
+async function loadExampleConfig(examplePath) {
+  try {
+    const configPath = path4.join(examplePath, ".mcp-docs.json");
+    const configContent = await fs2.readFile(configPath, "utf-8");
+    return JSON.parse(configContent);
+  } catch {
+    return {};
+  }
+}
+function shouldIgnoreFile(filePath, ignorePatterns = []) {
+  return ignorePatterns.some((pattern) => {
+    const regex = pattern.replace(/\*/g, ".*").replace(/\?/g, ".").replace(/\//g, "\\/");
+    return new RegExp(regex).test(filePath);
+  });
+}
 async function prepareCodeExamples() {
   try {
     await fs2.rm(OUTPUT_DIR, { recursive: true, force: true });
@@ -130,18 +145,37 @@ async function prepareCodeExamples() {
   for (const dir of exampleDirs) {
     const examplePath = path4.join(EXAMPLES_SOURCE, dir.name);
     const outputFile = path4.join(OUTPUT_DIR, `${dir.name}.md`);
+    const config = await loadExampleConfig(examplePath);
     const files = [];
-    try {
-      const packageJson = await fs2.readFile(path4.join(examplePath, "package.json"), "utf-8");
-      files.push({
-        path: "package.json",
-        content: packageJson
-      });
-    } catch {
+    if (!shouldIgnoreFile("package.json", config.ignore)) {
+      try {
+        const packageJsonContent = await fs2.readFile(path4.join(examplePath, "package.json"), "utf-8");
+        const packageJson = JSON.parse(packageJsonContent);
+        for (const key of [
+          "scripts",
+          "private",
+          "type",
+          "description",
+          "version",
+          "main",
+          "pnpm",
+          "packageManager",
+          "keywords",
+          "author",
+          "license"
+        ]) {
+          if (key in packageJson) delete packageJson[key];
+        }
+        files.push({
+          path: "package.json",
+          content: JSON.stringify(packageJson, null, 2)
+        });
+      } catch {
+      }
     }
     try {
       const srcPath = path4.join(examplePath, "src");
-      await scanDirectory(srcPath, srcPath, files);
+      await scanDirectory(srcPath, srcPath, files, config.ignore);
     } catch {
     }
     if (files.length > 0) {
@@ -151,7 +185,7 @@ ${file.content}
 \`\`\`
 `).join("\n");
       const totalLines = output.split("\n").length;
-      const limit = 1e3;
+      const limit = config.maxLines || 1500;
       if (totalLines > limit) {
         log(`Skipping ${dir.name}: ${totalLines} lines exceeds limit of ${limit}`);
         continue;
@@ -161,13 +195,16 @@ ${file.content}
     }
   }
 }
-async function scanDirectory(basePath, currentPath, files) {
+async function scanDirectory(basePath, currentPath, files, ignorePatterns) {
   const entries = await fs2.readdir(currentPath, { withFileTypes: true });
   for (const entry of entries) {
     const fullPath = path4.join(currentPath, entry.name);
     const relativePath = path4.relative(basePath, fullPath);
+    if (shouldIgnoreFile(relativePath, ignorePatterns)) {
+      continue;
+    }
     if (entry.isDirectory()) {
-      await scanDirectory(basePath, fullPath, files);
+      await scanDirectory(basePath, fullPath, files, ignorePatterns);
     } else if (entry.isFile() && entry.name.endsWith(".ts")) {
       const content = await fs2.readFile(fullPath, "utf-8");
       files.push({

package/dist/prepare-docs/prepare.js

@@ -1 +1 @@
-export { prepare } from '../chunk-P5AHYMUI.js';
+export { prepare } from '../chunk-7QXT2IEP.js';

package/dist/stdio.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { fromPackageRoot, prepare, getMatchingPaths } from './chunk-P5AHYMUI.js';
+import { fromPackageRoot, prepare, getMatchingPaths } from './chunk-7QXT2IEP.js';
 import * as fs from 'fs';
 import { existsSync, mkdirSync } from 'fs';
 import * as os2 from 'os';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "0.13.2",
+  "version": "0.13.3-alpha.0",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -42,13 +42,13 @@
     "@wong2/mcp-cli": "^1.10.0",
     "cross-env": "^7.0.3",
     "eslint": "^9.29.0",
-    "hono": "^4.7.11",
+    "hono": "^4.8.3",
     "tsup": "^8.5.0",
     "tsx": "^4.19.4",
     "typescript": "^5.8.3",
-    "vitest": "^3.2.3",
-    "@internal/lint": "0.0.14",
-    "@mastra/core": "0.10.7"
+    "vitest": "^3.2.4",
+    "@internal/lint": "0.0.15",
+    "@mastra/core": "0.10.9-alpha.0"
   },
   "peerDependencies": {
     "@mastra/core": "^0.10.0-alpha.0"