@mastra/mcp-docs-server 0.13.7 → 0.13.8-alpha.1

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

@@ -1,86 +1,98 @@
 ---
-title: "Reference: Logger Instance | Mastra Observability Docs"
-description: Documentation for Logger instances, which provide methods to record events at various severity levels.
+title: "Reference: PinoLogger | Mastra Observability Docs"
+description: Documentation for PinoLogger, which provides methods to record events at various severity levels.
 ---
 
-# Logger Instance
+# PinoLogger
 
-A Logger instance is created by `new PinoLogger()` and provides methods to record events at various severity levels. Depending on the logger type, messages may be written to the console, file, or an external service.
+A Logger instance is created using `new PinoLogger()` and provides methods to record events at various severity levels.
 
-## Example
+When deploying to Mastra Cloud, logs are displayed on the [Logs](../../docs/mastra-cloud/dashboard.mdx#logs) page. In self-hosted or custom environments, logs can be directed to files or external services depending on the configured transports.
 
-```typescript showLineNumbers copy
-// Using a console logger
-const logger = new PinoLogger({ name: "Mastra", level: "info" });
+## Usage example
 
-logger.debug("Debug message"); // Won't be logged because level is INFO
-logger.info({
-  message: "User action occurred",
-  destinationPath: "user-actions",
-  type: "AGENT",
-}); // Logged
-logger.error("An error occurred"); // Logged as ERROR
+```typescript filename="src/mastra/index.ts" showLineNumbers copy
+import { Mastra } from '@mastra/core/mastra';
+import { PinoLogger } from '@mastra/loggers';
+
+export const mastra = new Mastra({
+  // ...
+  logger: new PinoLogger({
+    name: 'Mastra',
+    level: 'info',
+  }),
+});
 ```
 
-## Methods
+## Parameters
 
 <PropertiesTable
   content={[
     {
-      name: "debug",
-      type: "(message: BaseLogMessage | string, ...args: any[]) => void | Promise<void>",
-      description: "Write a DEBUG-level log. Only recorded if level ≤ DEBUG.",
+      name: "name",
+      type: "string",
+      description: "A label used to group and identify logs from this logger.",
     },
-    {
-      name: "info",
-      type: "(message: BaseLogMessage | string, ...args: any[]) => void | Promise<void>",
-      description: "Write an INFO-level log. Only recorded if level ≤ INFO.",
+     {
+      name: "level",
+      type: `"debug" | "info" | "warn" | "error"`,
+      description: "Sets the minimum log level. Messages below this level are ignored.",
     },
     {
-      name: "warn",
-      type: "(message: BaseLogMessage | string, ...args: any[]) => void | Promise<void>",
-      description: "Write a WARN-level log. Only recorded if level ≤ WARN.",
+      name: "transports",
+      type: "Record<string, LoggerTransport>",
+      description: "A map of transport instances used to persist logs.",
     },
     {
-      name: "error",
-      type: "(message: BaseLogMessage | string, ...args: any[]) => void | Promise<void>",
-      description: "Write an ERROR-level log. Only recorded if level ≤ ERROR.",
+      name: "overrideDefaultTransports",
+      type: "boolean",
+      isOptional: true,
+      description: "If true, disables the default console transport.",
     },
     {
-      name: "cleanup",
-      type: "() => Promise<void>",
+      name: "formatters",
+      type: "pino.LoggerOptions['formatters']",
       isOptional: true,
-      description:
-        "Cleanup resources held by the logger (e.g., network connections for Upstash). Not all loggers implement this.",
+      description: "Custom Pino formatters for log serialization.",
     },
   ]}
 />
 
-**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)
+## File transport (structured logs)
 
-```typescript showLineNumbers copy
+Writes structured logs to a file using the `FileTransport`. The logger accepts a plain message as the first argument and structured metadata as the second argument. These are internally converted to a `BaseLogMessage` and persisted to the configured file path.
+
+
+```typescript filename="src/mastra/loggers/file-transport.ts" showLineNumbers copy
 import { FileTransport } from "@mastra/loggers/file";
+import { PinoLogger } from "@mastra/loggers/pino";
 
-const fileLogger = new PinoLogger({
+export const fileLogger = new PinoLogger({
   name: "Mastra",
   transports: { file: new FileTransport({ path: "test-dir/test.log" }) },
   level: "warn",
 });
+```
+
+### File transport usage
 
+```typescript showLineNumbers copy
 fileLogger.warn("Low disk space", {
   destinationPath: "system",
   type: "WORKFLOW",
 });
 ```
 
-## Upstash Logger (Remote Log Drain)
+## Upstash transport (remote log drain)
 
-```typescript showLineNumbers copy
+Streams structured logs to a remote Redis list using the `UpstashTransport`. The logger accepts a string message and a structured metadata object. This enables centralized logging for distributed environments, supporting filtering by `destinationPath`, `type`, and `runId`.
+
+```typescript filename="src/mastra/loggers/upstash-transport.ts" showLineNumbers copy
 import { UpstashTransport } from "@mastra/loggers/upstash";
+import { PinoLogger } from "@mastra/loggers/pino";
 
-const logger = new PinoLogger({
+export const upstashLogger = new PinoLogger({
   name: "Mastra",
   transports: {
     upstash: new UpstashTransport({
@@ -91,28 +103,35 @@ const logger = new PinoLogger({
   },
   level: "info",
 });
+```
 
-logger.info({
-  message: "User signed in",
+
+### Upstash transport usage
+
+```typescript showLineNumbers copy
+upstashLogger.info("User signed in", {
   destinationPath: "auth",
   type: "AGENT",
   runId: "run_123",
 });
 ```
 
-## Custom Transport
+## Custom transport
 
 You can create custom transports using the `createCustomTransport` utility to integrate with any logging service or stream.
 
-### Example: Sentry Integration
+### Sentry transport example
 
-```typescript showLineNumbers copy
+Creates a custom transport using `createCustomTransport` and integrates it with a third-party logging stream such as `pino-sentry-transport`. This allows forwarding logs to an external system like Sentry for advanced monitoring and observability.
+
+```typescript filename="src/mastra/loggers/sentry-transport.ts" showLineNumbers copy
 import { createCustomTransport } from "@mastra/core/loggers";
-import pinoSentry from 'pino-sentry-transport';
+import { PinoLogger } from "@mastra/loggers/pino";
+import pinoSentry from "pino-sentry-transport";
 
 const sentryStream = await pinoSentry({
   sentry: {
-    dsn: 'YOUR_SENTRY_DSN',
+    dsn: "YOUR_SENTRY_DSN",
     _experiments: {
       enableLogs: true,
     },
@@ -121,9 +140,9 @@ const sentryStream = await pinoSentry({
 
 const customTransport = createCustomTransport(sentryStream);
 
-const logger = new PinoLogger({
+export const sentryLogger = new PinoLogger({
   name: "Mastra",
-  transports: { sentry: customTransport },
   level: "info",
+  transports: { sentry: customTransport },
 });
-```
+```

package/.docs/raw/reference/observability/providers/langfuse.mdx

@@ -11,36 +11,69 @@ Langfuse is an open-source observability platform designed specifically for LLM
 
 ## Configuration
 
-To use Langfuse with Mastra, you'll need to configure the following environment variables:
+To use Langfuse with Mastra, you can configure it using either environment variables or directly in your Mastra configuration.
+
+### Using Environment Variables
+
+Set the following environment variables:
 
 ```env
-LANGFUSE_PUBLIC_KEY=your_public_key
-LANGFUSE_SECRET_KEY=your_secret_key
-LANGFUSE_BASEURL=https://cloud.langfuse.com  # Optional - defaults to cloud.langfuse.com
+OTEL_EXPORTER_OTLP_ENDPOINT="https://cloud.langfuse.com/api/public/otel/v1/traces" # 🇪🇺 EU data region
+# OTEL_EXPORTER_OTLP_ENDPOINT="https://us.cloud.langfuse.com/api/public/otel/v1/traces" # 🇺🇸 US data region
+
+OTEL_EXPORTER_OTLP_HEADERS="Authorization=Basic ${AUTH_STRING}"
+```
+
+Where `AUTH_STRING` is the base64-encoded combination of your public and secret keys (see below).
+
+### Generating AUTH_STRING
+
+The authorization uses basic auth with your Langfuse API keys. You can generate the base64-encoded auth string using:
+
+```bash
+echo -n "pk-lf-1234567890:sk-lf-1234567890" | base64
 ```
 
-**Important**: When configuring the telemetry export settings, the `traceName` parameter must be set to `"ai"` for the Langfuse integration to work properly.
+For long API keys on GNU systems, you may need to add `-w 0` to prevent auto-wrapping:
+
+```bash
+echo -n "pk-lf-1234567890:sk-lf-1234567890" | base64 -w 0
+```
 
 ## Implementation
 
-Here's how to configure Mastra to use Langfuse:
+Here's how to configure Mastra to use Langfuse with OpenTelemetry:
+
+```typescript
+import { Mastra } from "@mastra/core";
+
+export const mastra = new Mastra({
+  // ... other config
+  telemetry: {
+    enabled: true,
+    export: {
+      type: 'otlp',
+      endpoint: 'https://cloud.langfuse.com/api/public/otel/v1/traces', // or your preferred endpoint
+      headers: {
+        Authorization: `Basic ${AUTH_STRING}`, // Your base64-encoded auth string
+      },
+    },
+  },
+});
+```
+
+Alternatively, if you're using environment variables, you can simplify the configuration:
 
 ```typescript
 import { Mastra } from "@mastra/core";
-import { LangfuseExporter } from "langfuse-vercel";
 
 export const mastra = new Mastra({
   // ... other config
   telemetry: {
-    serviceName: "ai", // this must be set to "ai" so that the LangfuseExporter thinks it's an AI SDK trace
     enabled: true,
     export: {
-      type: "custom",
-      exporter: new LangfuseExporter({
-        publicKey: process.env.LANGFUSE_PUBLIC_KEY,
-        secretKey: process.env.LANGFUSE_SECRET_KEY,
-        baseUrl: process.env.LANGFUSE_BASEURL,
-      }),
+      type: 'otlp',
+      // endpoint and headers will be read from OTEL_EXPORTER_OTLP_* env vars
     },
   },
 });

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

@@ -47,5 +47,4 @@ workflow.dountil(stepOne, async ({ inputData }) => true);
 
 ## Related
 
-- [Loops](../../docs/workflows/control-flow.mdx#loops)
-- [Loops example](../../examples/workflows/control-flow.mdx)
+- [Control flow](../../docs/workflows/control-flow.mdx)

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

@@ -47,5 +47,4 @@ workflow.dowhile(stepOne, async ({ inputData }) => true);
 
 ## Related
 
-- [Loops](../../docs/workflows/flow-control.mdx#loops)
-- [Loops example](../../examples/workflows/control-flow.mdx)
+- [Control flow](../../docs/workflows/control-flow.mdx)

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

@@ -15,12 +15,22 @@ const result = await run.start({ inputData: { startValue: 0 } });
 
 if (result.status === "suspended") {
   const resumedResults = await run.resume({
-    step: result.suspended[0],
     resumeData: { newValue: 0 },
   });
 }
 ```
 
+
+For more advanced scenarios where you need to specify the exact step to resume:
+
+```typescript
+await run.resume({
+  step: result.suspended[0], // Explicitly choose which step to resume
+  resumeData: { newValue: 0 },
+});
+```
+> **Note**: When exactly one step is suspended, you can omit the `step` parameter and the workflow will automatically resume that step. For workflows with multiple suspended steps, you must explicitly specify which step to resume.
+
 ## Parameters
 
 <PropertiesTable
@@ -40,8 +50,8 @@ if (result.status === "suspended") {
         {
           name: "step",
           type: "Step | Step[] | string | string[]",
-          description: "The step(s) to resume execution from",
-          isOptional: false,
+          description: "The step(s) to resume execution from. When omitted, the workflow will automatically resume the suspended step if exactly one step is suspended. Throws an error if multiple steps are suspended and no step is specified.",
+          isOptional: true,
         },
         {
           name: "runtimeContext",

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

@@ -156,5 +156,4 @@ const processOrder = createStep({
 
 - [Control flow](../../docs/workflows/control-flow.mdx)
 - [Using agents and tools](../../docs/workflows/using-with-agents-and-tools.mdx)
-- [Tool and agent as step example](../../examples/workflows/agent-and-tool-interop.mdx)
 - [Input data mapping](../../docs/workflows/input-data-mapping.mdx)

package/.docs/raw/workflows/suspend-and-resume.mdx

@@ -111,11 +111,11 @@ In this case, the logic resumes the first step listed in the `suspended` array.
 }
 ```
 
-> See [Run Workflow Results](/workflows/overview#run-workflow-results) for more details.
+> See [Run Workflow Results](/docs/workflows/overview#run-workflow-results) for more details.
 
 ## Resuming a workflow with `resume()`
 
-A workflow can be resumed by calling `resume` and providing the required `resumeData`.
+A workflow can be resumed by calling `resume` and providing the required `resumeData`. You can either explicitly specify which step to resume from, or when exactly one step is suspended, omit the `step` parameter and the workflow will automatically resume that step.
 
 ```typescript {16-18} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
 import { mastra } from "./mastra";
@@ -142,6 +142,17 @@ if (result.status === "suspended") {
 }
 ```
 
+You can also omit the `step` parameter when exactly one step is suspended:
+
+```typescript {5} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
+const resumedResult = await run.resume({
+  resumeData: {
+    city: "Berlin"
+  },
+  // step parameter omitted - automatically resumes the single suspended step
+});
+```
+
 ### Resuming nested workflows
 
 To resume a suspended nested workflow pass the workflow instance to the `step` parameter of the `resume` function.

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import { MCPServer } from '@mastra/mcp';
+declare let server: MCPServer;
+declare function runServer(): Promise<void>;
+export { runServer, server };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAiBxC,QAAA,IAAI,MAAM,EAAE,SAAS,CAAC;AA+BtB,iBAAe,SAAS,kBAQvB;AAED,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,11 @@
+import type { MCPServer } from '@mastra/mcp';
+export interface Logger {
+    info: (message: string, data?: any) => Promise<void>;
+    warning: (message: string, data?: any) => Promise<void>;
+    error: (message: string, error?: any) => Promise<void>;
+    debug: (message: string, data?: any) => Promise<void>;
+}
+export declare const writeErrorLog: (message: string, data?: any) => void;
+export declare function createLogger(server?: MCPServer): Logger;
+export declare const logger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,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,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD;AAED,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,EAAE,OAAO,GAAG,SA2BxD,CAAC;AAGF,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CAoDvD;AAGD,eAAO,MAAM,MAAM,QAAiB,CAAC"}

package/dist/prepare-docs/code-examples.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Scans example directories and creates flattened code example files
+ */
+export declare function prepareCodeExamples(): Promise<void>;
+//# sourceMappingURL=code-examples.d.ts.map

package/dist/prepare-docs/code-examples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-examples.d.ts","sourceRoot":"","sources":["../../src/prepare-docs/code-examples.ts"],"names":[],"mappings":"AAoCA;;GAEG;AACH,wBAAsB,mBAAmB,kBAmFxC"}

package/dist/prepare-docs/copy-raw.d.ts

@@ -0,0 +1,2 @@
+export declare function copyRaw(): Promise<void>;
+//# sourceMappingURL=copy-raw.d.ts.map

package/dist/prepare-docs/copy-raw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-raw.d.ts","sourceRoot":"","sources":["../../src/prepare-docs/copy-raw.ts"],"names":[],"mappings":"AAgCA,wBAAsB,OAAO,kBAkB5B"}

package/dist/prepare-docs/package-changes.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Scans package directories and creates organized changelog files
+ */
+export declare function preparePackageChanges(): Promise<void>;
+//# sourceMappingURL=package-changes.d.ts.map

package/dist/prepare-docs/package-changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-changes.d.ts","sourceRoot":"","sources":["../../src/prepare-docs/package-changes.ts"],"names":[],"mappings":"AA8DA;;GAEG;AACH,wBAAsB,qBAAqB,kBAmC1C"}

package/dist/prepare-docs/prepare.d.ts

@@ -1 +1,2 @@
-export { prepare } from '../_tsup-dts-rollup.js';
+export declare function prepare(): Promise<void>;
+//# sourceMappingURL=prepare.d.ts.map

package/dist/prepare-docs/prepare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare.d.ts","sourceRoot":"","sources":["../../src/prepare-docs/prepare.ts"],"names":[],"mappings":"AAKA,wBAAsB,OAAO,kBAQ5B"}

package/dist/stdio.d.ts

@@ -1 +1,3 @@
+#!/usr/bin/env node
 export {};
+//# sourceMappingURL=stdio.d.ts.map

package/dist/stdio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../src/stdio.ts"],"names":[],"mappings":""}

package/dist/tools/__tests__/test-setup.d.ts

@@ -0,0 +1,5 @@
+import { MCPClient } from '@mastra/mcp';
+export declare const server: import("@hono/node-server").ServerType;
+export declare const mcp: MCPClient;
+export declare function callTool(tool: any, args: any): Promise<string>;
+//# sourceMappingURL=test-setup.d.ts.map

package/dist/tools/__tests__/test-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-setup.d.ts","sourceRoot":"","sources":["../../../src/tools/__tests__/test-setup.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAuCxC,eAAO,MAAM,MAAM,wCAGjB,CAAC;AAKH,eAAO,MAAM,GAAG,WAWd,CAAC;AAEH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,mBAsBlD"}

package/dist/tools/blog.d.ts

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+export declare const blogInputSchema: z.ZodObject<{
+    url: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+}, {
+    url: string;
+}>;
+export type BlogInput = z.infer<typeof blogInputSchema>;
+export declare const blogTool: {
+    name: string;
+    description: string;
+    parameters: z.ZodObject<{
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+    }, {
+        url: string;
+    }>;
+    execute: (args: BlogInput) => Promise<string>;
+};
+//# sourceMappingURL=blog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blog.d.ts","sourceRoot":"","sources":["../../src/tools/blog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAyExB,eAAO,MAAM,eAAe;;;;;;EAM1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,QAAQ;;;;;;;;;;oBAKG,SAAS;CAehC,CAAC"}

package/dist/tools/changes.d.ts

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+export declare const changesInputSchema: z.ZodObject<{
+    package: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    package?: string | undefined;
+}, {
+    package?: string | undefined;
+}>;
+export type ChangesInput = z.infer<typeof changesInputSchema>;
+export declare const changesTool: {
+    name: string;
+    description: string;
+    parameters: z.ZodObject<{
+        package: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        package?: string | undefined;
+    }, {
+        package?: string | undefined;
+    }>;
+    execute: (args: ChangesInput) => Promise<string>;
+};
+//# sourceMappingURL=changes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"changes.d.ts","sourceRoot":"","sources":["../../src/tools/changes.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAuDxB,eAAO,MAAM,kBAAkB;;;;;;EAK7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,WAAW;;;;;;;;;;oBAIA,YAAY;CAgBnC,CAAC"}

package/dist/tools/course.d.ts

@@ -0,0 +1,85 @@
+import { z } from 'zod';
+declare const _courseLessonSchema: z.ZodObject<{
+    lessonName: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    lessonName: string;
+}, {
+    lessonName: string;
+}>;
+declare const _confirmationSchema: z.ZodObject<{
+    confirm: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    confirm?: boolean | undefined;
+}, {
+    confirm?: boolean | undefined;
+}>;
+type CourseState = {
+    currentLesson: string;
+    lessons: Array<{
+        name: string;
+        status: number;
+        steps: Array<{
+            name: string;
+            status: number;
+        }>;
+    }>;
+};
+export declare function registerUserLocally(email: string): Promise<{
+    success: boolean;
+    id: string;
+    key: string;
+    message: string;
+}>;
+export declare function updateCourseStateOnServerLocally(deviceId: string, state: CourseState): Promise<void>;
+export declare const startMastraCourse: {
+    name: string;
+    description: string;
+    parameters: z.ZodObject<{
+        email: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        email?: string | undefined;
+    }, {
+        email?: string | undefined;
+    }>;
+    execute: (args: {
+        email?: string;
+    }) => Promise<string>;
+};
+export declare const getMastraCourseStatus: {
+    name: string;
+    description: string;
+    parameters: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    execute: (_args: Record<string, never>) => Promise<string>;
+};
+export declare const startMastraCourseLesson: {
+    name: string;
+    description: string;
+    parameters: z.ZodObject<{
+        lessonName: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        lessonName: string;
+    }, {
+        lessonName: string;
+    }>;
+    execute: (args: z.infer<typeof _courseLessonSchema>) => Promise<string>;
+};
+export declare const nextMastraCourseStep: {
+    name: string;
+    description: string;
+    parameters: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    execute: (_args: Record<string, never>) => Promise<string>;
+};
+export declare const clearMastraCourseHistory: {
+    name: string;
+    description: string;
+    parameters: z.ZodObject<{
+        confirm: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        confirm?: boolean | undefined;
+    }, {
+        confirm?: boolean | undefined;
+    }>;
+    execute: (args: z.infer<typeof _confirmationSchema>) => Promise<string>;
+};
+export {};
+//# sourceMappingURL=course.d.ts.map

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

@@ -0,0 +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"}

package/dist/tools/docs.d.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+export declare const docsInputSchema: z.ZodObject<{
+    paths: z.ZodArray<z.ZodString, "many">;
+    queryKeywords: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    paths: string[];
+    queryKeywords?: string[] | undefined;
+}, {
+    paths: string[];
+    queryKeywords?: string[] | undefined;
+}>;
+export type DocsInput = z.infer<typeof docsInputSchema>;
+export declare const docsTool: {
+    name: string;
+    description: string;
+    parameters: z.ZodObject<{
+        paths: z.ZodArray<z.ZodString, "many">;
+        queryKeywords: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        paths: string[];
+        queryKeywords?: string[] | undefined;
+    }, {
+        paths: string[];
+        queryKeywords?: string[] | undefined;
+    }>;
+    execute: (args: DocsInput) => Promise<string>;
+};
+//# sourceMappingURL=docs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/tools/docs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA4JxB,eAAO,MAAM,eAAe;;;;;;;;;EAW1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,QAAQ;;;;;;;;;;;;;oBAkBG,SAAS;CAiDhC,CAAC"}