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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (93) hide show
  1. package/.docs/organized/changelogs/%40internal%2Fstorage-test-utils.md +30 -30
  2. package/.docs/organized/changelogs/%40mastra%2Fastra.md +31 -31
  3. package/.docs/organized/changelogs/%40mastra%2Fchroma.md +31 -31
  4. package/.docs/organized/changelogs/%40mastra%2Fclickhouse.md +31 -31
  5. package/.docs/organized/changelogs/%40mastra%2Fclient-js.md +60 -60
  6. package/.docs/organized/changelogs/%40mastra%2Fcloud.md +44 -44
  7. package/.docs/organized/changelogs/%40mastra%2Fcloudflare-d1.md +34 -34
  8. package/.docs/organized/changelogs/%40mastra%2Fcloudflare.md +33 -33
  9. package/.docs/organized/changelogs/%40mastra%2Fcore.md +72 -72
  10. package/.docs/organized/changelogs/%40mastra%2Fcouchbase.md +31 -31
  11. package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloudflare.md +56 -56
  12. package/.docs/organized/changelogs/%40mastra%2Fdeployer-netlify.md +52 -52
  13. package/.docs/organized/changelogs/%40mastra%2Fdeployer-vercel.md +52 -52
  14. package/.docs/organized/changelogs/%40mastra%2Fdeployer.md +73 -73
  15. package/.docs/organized/changelogs/%40mastra%2Fdynamodb.md +33 -33
  16. package/.docs/organized/changelogs/%40mastra%2Fevals.md +36 -36
  17. package/.docs/organized/changelogs/%40mastra%2Ffirecrawl.md +47 -47
  18. package/.docs/organized/changelogs/%40mastra%2Fgithub.md +31 -31
  19. package/.docs/organized/changelogs/%40mastra%2Flance.md +30 -0
  20. package/.docs/organized/changelogs/%40mastra%2Flibsql.md +50 -50
  21. package/.docs/organized/changelogs/%40mastra%2Floggers.md +31 -31
  22. package/.docs/organized/changelogs/%40mastra%2Fmcp-docs-server.md +44 -44
  23. package/.docs/organized/changelogs/%40mastra%2Fmcp-registry-registry.md +31 -31
  24. package/.docs/organized/changelogs/%40mastra%2Fmcp.md +43 -43
  25. package/.docs/organized/changelogs/%40mastra%2Fmem0.md +33 -33
  26. package/.docs/organized/changelogs/%40mastra%2Fmemory.md +51 -51
  27. package/.docs/organized/changelogs/%40mastra%2Fmongodb.md +48 -48
  28. package/.docs/organized/changelogs/%40mastra%2Fmssql.md +32 -0
  29. package/.docs/organized/changelogs/%40mastra%2Fopensearch.md +31 -31
  30. package/.docs/organized/changelogs/%40mastra%2Fpg.md +58 -58
  31. package/.docs/organized/changelogs/%40mastra%2Fpinecone.md +31 -31
  32. package/.docs/organized/changelogs/%40mastra%2Fplayground-ui.md +58 -58
  33. package/.docs/organized/changelogs/%40mastra%2Fqdrant.md +31 -31
  34. package/.docs/organized/changelogs/%40mastra%2Frag.md +46 -46
  35. package/.docs/organized/changelogs/%40mastra%2Fragie.md +31 -31
  36. package/.docs/organized/changelogs/%40mastra%2Fserver.md +58 -58
  37. package/.docs/organized/changelogs/%40mastra%2Fturbopuffer.md +31 -31
  38. package/.docs/organized/changelogs/%40mastra%2Fupstash.md +49 -49
  39. package/.docs/organized/changelogs/%40mastra%2Fvectorize.md +33 -33
  40. package/.docs/organized/changelogs/%40mastra%2Fvoice-azure.md +33 -33
  41. package/.docs/organized/changelogs/%40mastra%2Fvoice-cloudflare.md +33 -33
  42. package/.docs/organized/changelogs/%40mastra%2Fvoice-deepgram.md +31 -31
  43. package/.docs/organized/changelogs/%40mastra%2Fvoice-elevenlabs.md +31 -31
  44. package/.docs/organized/changelogs/%40mastra%2Fvoice-google.md +31 -31
  45. package/.docs/organized/changelogs/%40mastra%2Fvoice-murf.md +43 -43
  46. package/.docs/organized/changelogs/%40mastra%2Fvoice-openai-realtime.md +35 -35
  47. package/.docs/organized/changelogs/%40mastra%2Fvoice-openai.md +45 -45
  48. package/.docs/organized/changelogs/%40mastra%2Fvoice-playai.md +31 -31
  49. package/.docs/organized/changelogs/%40mastra%2Fvoice-sarvam.md +31 -31
  50. package/.docs/organized/changelogs/%40mastra%2Fvoice-speechify.md +31 -31
  51. package/.docs/organized/changelogs/create-mastra.md +10 -10
  52. package/.docs/organized/changelogs/mastra.md +70 -70
  53. package/.docs/raw/community/contributing-templates.mdx +1 -0
  54. package/.docs/raw/memory/overview.mdx +3 -1
  55. package/.docs/raw/memory/working-memory.mdx +67 -0
  56. package/.docs/raw/observability/logging.mdx +94 -19
  57. package/.docs/raw/reference/observability/logger.mdx +69 -50
  58. package/.docs/raw/reference/observability/providers/langfuse.mdx +47 -14
  59. package/.docs/raw/reference/workflows/dountil.mdx +1 -2
  60. package/.docs/raw/reference/workflows/dowhile.mdx +1 -2
  61. package/.docs/raw/reference/workflows/resume.mdx +13 -3
  62. package/.docs/raw/reference/workflows/step.mdx +0 -1
  63. package/.docs/raw/workflows/suspend-and-resume.mdx +13 -2
  64. package/dist/index.d.ts +5 -0
  65. package/dist/index.d.ts.map +1 -0
  66. package/dist/logger.d.ts +11 -0
  67. package/dist/logger.d.ts.map +1 -0
  68. package/dist/prepare-docs/code-examples.d.ts +5 -0
  69. package/dist/prepare-docs/code-examples.d.ts.map +1 -0
  70. package/dist/prepare-docs/copy-raw.d.ts +2 -0
  71. package/dist/prepare-docs/copy-raw.d.ts.map +1 -0
  72. package/dist/prepare-docs/package-changes.d.ts +5 -0
  73. package/dist/prepare-docs/package-changes.d.ts.map +1 -0
  74. package/dist/prepare-docs/prepare.d.ts +2 -1
  75. package/dist/prepare-docs/prepare.d.ts.map +1 -0
  76. package/dist/stdio.d.ts +2 -0
  77. package/dist/stdio.d.ts.map +1 -0
  78. package/dist/tools/__tests__/test-setup.d.ts +5 -0
  79. package/dist/tools/__tests__/test-setup.d.ts.map +1 -0
  80. package/dist/tools/blog.d.ts +22 -0
  81. package/dist/tools/blog.d.ts.map +1 -0
  82. package/dist/tools/changes.d.ts +22 -0
  83. package/dist/tools/changes.d.ts.map +1 -0
  84. package/dist/tools/course.d.ts +85 -0
  85. package/dist/tools/course.d.ts.map +1 -0
  86. package/dist/tools/docs.d.ts +28 -0
  87. package/dist/tools/docs.d.ts.map +1 -0
  88. package/dist/tools/examples.d.ts +28 -0
  89. package/dist/tools/examples.d.ts.map +1 -0
  90. package/dist/utils.d.ts +62 -0
  91. package/dist/utils.d.ts.map +1 -0
  92. package/package.json +6 -6
  93. package/dist/_tsup-dts-rollup.d.ts +0 -304
@@ -47,5 +47,4 @@ workflow.dountil(stepOne, async ({ inputData }) => true);
47
47
 
48
48
  ## Related
49
49
 
50
- - [Loops](../../docs/workflows/control-flow.mdx#loops)
51
- - [Loops example](../../examples/workflows/control-flow.mdx)
50
+ - [Control flow](../../docs/workflows/control-flow.mdx)
@@ -47,5 +47,4 @@ workflow.dowhile(stepOne, async ({ inputData }) => true);
47
47
 
48
48
  ## Related
49
49
 
50
- - [Loops](../../docs/workflows/flow-control.mdx#loops)
51
- - [Loops example](../../examples/workflows/control-flow.mdx)
50
+ - [Control flow](../../docs/workflows/control-flow.mdx)
@@ -15,12 +15,22 @@ const result = await run.start({ inputData: { startValue: 0 } });
15
15
 
16
16
  if (result.status === "suspended") {
17
17
  const resumedResults = await run.resume({
18
- step: result.suspended[0],
19
18
  resumeData: { newValue: 0 },
20
19
  });
21
20
  }
22
21
  ```
23
22
 
23
+
24
+ For more advanced scenarios where you need to specify the exact step to resume:
25
+
26
+ ```typescript
27
+ await run.resume({
28
+ step: result.suspended[0], // Explicitly choose which step to resume
29
+ resumeData: { newValue: 0 },
30
+ });
31
+ ```
32
+ > **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.
33
+
24
34
  ## Parameters
25
35
 
26
36
  <PropertiesTable
@@ -40,8 +50,8 @@ if (result.status === "suspended") {
40
50
  {
41
51
  name: "step",
42
52
  type: "Step | Step[] | string | string[]",
43
- description: "The step(s) to resume execution from",
44
- isOptional: false,
53
+ 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.",
54
+ isOptional: true,
45
55
  },
46
56
  {
47
57
  name: "runtimeContext",
@@ -156,5 +156,4 @@ const processOrder = createStep({
156
156
 
157
157
  - [Control flow](../../docs/workflows/control-flow.mdx)
158
158
  - [Using agents and tools](../../docs/workflows/using-with-agents-and-tools.mdx)
159
- - [Tool and agent as step example](../../examples/workflows/agent-and-tool-interop.mdx)
160
159
  - [Input data mapping](../../docs/workflows/input-data-mapping.mdx)
@@ -111,11 +111,11 @@ In this case, the logic resumes the first step listed in the `suspended` array.
111
111
  }
112
112
  ```
113
113
 
114
- > See [Run Workflow Results](/workflows/overview#run-workflow-results) for more details.
114
+ > See [Run Workflow Results](/docs/workflows/overview#run-workflow-results) for more details.
115
115
 
116
116
  ## Resuming a workflow with `resume()`
117
117
 
118
- A workflow can be resumed by calling `resume` and providing the required `resumeData`.
118
+ 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.
119
119
 
120
120
  ```typescript {16-18} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
121
121
  import { mastra } from "./mastra";
@@ -142,6 +142,17 @@ if (result.status === "suspended") {
142
142
  }
143
143
  ```
144
144
 
145
+ You can also omit the `step` parameter when exactly one step is suspended:
146
+
147
+ ```typescript {5} filename="src/mastra/workflows/test-workflow.ts" showLineNumbers copy
148
+ const resumedResult = await run.resume({
149
+ resumeData: {
150
+ city: "Berlin"
151
+ },
152
+ // step parameter omitted - automatically resumes the single suspended step
153
+ });
154
+ ```
155
+
145
156
  ### Resuming nested workflows
146
157
 
147
158
  To resume a suspended nested workflow pass the workflow instance to the `step` parameter of the `resume` function.
@@ -0,0 +1,5 @@
1
+ import { MCPServer } from '@mastra/mcp';
2
+ declare let server: MCPServer;
3
+ declare function runServer(): Promise<void>;
4
+ export { runServer, server };
5
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,11 @@
1
+ import type { MCPServer } from '@mastra/mcp';
2
+ export interface Logger {
3
+ info: (message: string, data?: any) => Promise<void>;
4
+ warning: (message: string, data?: any) => Promise<void>;
5
+ error: (message: string, error?: any) => Promise<void>;
6
+ debug: (message: string, data?: any) => Promise<void>;
7
+ }
8
+ export declare const writeErrorLog: (message: string, data?: any) => void;
9
+ export declare function createLogger(server?: MCPServer): Logger;
10
+ export declare const logger: Logger;
11
+ //# sourceMappingURL=logger.d.ts.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,5 @@
1
+ /**
2
+ * Scans example directories and creates flattened code example files
3
+ */
4
+ export declare function prepareCodeExamples(): Promise<void>;
5
+ //# sourceMappingURL=code-examples.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"code-examples.d.ts","sourceRoot":"","sources":["../../src/prepare-docs/code-examples.ts"],"names":[],"mappings":"AAoCA;;GAEG;AACH,wBAAsB,mBAAmB,kBAmFxC"}
@@ -0,0 +1,2 @@
1
+ export declare function copyRaw(): Promise<void>;
2
+ //# sourceMappingURL=copy-raw.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"copy-raw.d.ts","sourceRoot":"","sources":["../../src/prepare-docs/copy-raw.ts"],"names":[],"mappings":"AAgCA,wBAAsB,OAAO,kBAkB5B"}
@@ -0,0 +1,5 @@
1
+ /**
2
+ * Scans package directories and creates organized changelog files
3
+ */
4
+ export declare function preparePackageChanges(): Promise<void>;
5
+ //# sourceMappingURL=package-changes.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"package-changes.d.ts","sourceRoot":"","sources":["../../src/prepare-docs/package-changes.ts"],"names":[],"mappings":"AA8DA;;GAEG;AACH,wBAAsB,qBAAqB,kBAmC1C"}
@@ -1 +1,2 @@
1
- export { prepare } from '../_tsup-dts-rollup.js';
1
+ export declare function prepare(): Promise<void>;
2
+ //# sourceMappingURL=prepare.d.ts.map
@@ -0,0 +1 @@
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 CHANGED
@@ -1 +1,3 @@
1
+ #!/usr/bin/env node
1
2
  export {};
3
+ //# sourceMappingURL=stdio.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../src/stdio.ts"],"names":[],"mappings":""}
@@ -0,0 +1,5 @@
1
+ import { MCPClient } from '@mastra/mcp';
2
+ export declare const server: import("@hono/node-server").ServerType;
3
+ export declare const mcp: MCPClient;
4
+ export declare function callTool(tool: any, args: any): Promise<string>;
5
+ //# sourceMappingURL=test-setup.d.ts.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,22 @@
1
+ import { z } from 'zod';
2
+ export declare const blogInputSchema: z.ZodObject<{
3
+ url: z.ZodString;
4
+ }, "strip", z.ZodTypeAny, {
5
+ url: string;
6
+ }, {
7
+ url: string;
8
+ }>;
9
+ export type BlogInput = z.infer<typeof blogInputSchema>;
10
+ export declare const blogTool: {
11
+ name: string;
12
+ description: string;
13
+ parameters: z.ZodObject<{
14
+ url: z.ZodString;
15
+ }, "strip", z.ZodTypeAny, {
16
+ url: string;
17
+ }, {
18
+ url: string;
19
+ }>;
20
+ execute: (args: BlogInput) => Promise<string>;
21
+ };
22
+ //# sourceMappingURL=blog.d.ts.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,22 @@
1
+ import { z } from 'zod';
2
+ export declare const changesInputSchema: z.ZodObject<{
3
+ package: z.ZodOptional<z.ZodString>;
4
+ }, "strip", z.ZodTypeAny, {
5
+ package?: string | undefined;
6
+ }, {
7
+ package?: string | undefined;
8
+ }>;
9
+ export type ChangesInput = z.infer<typeof changesInputSchema>;
10
+ export declare const changesTool: {
11
+ name: string;
12
+ description: string;
13
+ parameters: z.ZodObject<{
14
+ package: z.ZodOptional<z.ZodString>;
15
+ }, "strip", z.ZodTypeAny, {
16
+ package?: string | undefined;
17
+ }, {
18
+ package?: string | undefined;
19
+ }>;
20
+ execute: (args: ChangesInput) => Promise<string>;
21
+ };
22
+ //# sourceMappingURL=changes.d.ts.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,85 @@
1
+ import { z } from 'zod';
2
+ declare const _courseLessonSchema: z.ZodObject<{
3
+ lessonName: z.ZodString;
4
+ }, "strip", z.ZodTypeAny, {
5
+ lessonName: string;
6
+ }, {
7
+ lessonName: string;
8
+ }>;
9
+ declare const _confirmationSchema: z.ZodObject<{
10
+ confirm: z.ZodOptional<z.ZodBoolean>;
11
+ }, "strip", z.ZodTypeAny, {
12
+ confirm?: boolean | undefined;
13
+ }, {
14
+ confirm?: boolean | undefined;
15
+ }>;
16
+ type CourseState = {
17
+ currentLesson: string;
18
+ lessons: Array<{
19
+ name: string;
20
+ status: number;
21
+ steps: Array<{
22
+ name: string;
23
+ status: number;
24
+ }>;
25
+ }>;
26
+ };
27
+ export declare function registerUserLocally(email: string): Promise<{
28
+ success: boolean;
29
+ id: string;
30
+ key: string;
31
+ message: string;
32
+ }>;
33
+ export declare function updateCourseStateOnServerLocally(deviceId: string, state: CourseState): Promise<void>;
34
+ export declare const startMastraCourse: {
35
+ name: string;
36
+ description: string;
37
+ parameters: z.ZodObject<{
38
+ email: z.ZodOptional<z.ZodString>;
39
+ }, "strip", z.ZodTypeAny, {
40
+ email?: string | undefined;
41
+ }, {
42
+ email?: string | undefined;
43
+ }>;
44
+ execute: (args: {
45
+ email?: string;
46
+ }) => Promise<string>;
47
+ };
48
+ export declare const getMastraCourseStatus: {
49
+ name: string;
50
+ description: string;
51
+ parameters: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
52
+ execute: (_args: Record<string, never>) => Promise<string>;
53
+ };
54
+ export declare const startMastraCourseLesson: {
55
+ name: string;
56
+ description: string;
57
+ parameters: z.ZodObject<{
58
+ lessonName: z.ZodString;
59
+ }, "strip", z.ZodTypeAny, {
60
+ lessonName: string;
61
+ }, {
62
+ lessonName: string;
63
+ }>;
64
+ execute: (args: z.infer<typeof _courseLessonSchema>) => Promise<string>;
65
+ };
66
+ export declare const nextMastraCourseStep: {
67
+ name: string;
68
+ description: string;
69
+ parameters: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
70
+ execute: (_args: Record<string, never>) => Promise<string>;
71
+ };
72
+ export declare const clearMastraCourseHistory: {
73
+ name: string;
74
+ description: string;
75
+ parameters: z.ZodObject<{
76
+ confirm: z.ZodOptional<z.ZodBoolean>;
77
+ }, "strip", z.ZodTypeAny, {
78
+ confirm?: boolean | undefined;
79
+ }, {
80
+ confirm?: boolean | undefined;
81
+ }>;
82
+ execute: (args: z.infer<typeof _confirmationSchema>) => Promise<string>;
83
+ };
84
+ export {};
85
+ //# sourceMappingURL=course.d.ts.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,28 @@
1
+ import { z } from 'zod';
2
+ export declare const docsInputSchema: z.ZodObject<{
3
+ paths: z.ZodArray<z.ZodString, "many">;
4
+ queryKeywords: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
5
+ }, "strip", z.ZodTypeAny, {
6
+ paths: string[];
7
+ queryKeywords?: string[] | undefined;
8
+ }, {
9
+ paths: string[];
10
+ queryKeywords?: string[] | undefined;
11
+ }>;
12
+ export type DocsInput = z.infer<typeof docsInputSchema>;
13
+ export declare const docsTool: {
14
+ name: string;
15
+ description: string;
16
+ parameters: z.ZodObject<{
17
+ paths: z.ZodArray<z.ZodString, "many">;
18
+ queryKeywords: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
19
+ }, "strip", z.ZodTypeAny, {
20
+ paths: string[];
21
+ queryKeywords?: string[] | undefined;
22
+ }, {
23
+ paths: string[];
24
+ queryKeywords?: string[] | undefined;
25
+ }>;
26
+ execute: (args: DocsInput) => Promise<string>;
27
+ };
28
+ //# sourceMappingURL=docs.d.ts.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,28 @@
1
+ import { z } from 'zod';
2
+ export declare const examplesInputSchema: z.ZodObject<{
3
+ example: z.ZodOptional<z.ZodString>;
4
+ queryKeywords: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
5
+ }, "strip", z.ZodTypeAny, {
6
+ queryKeywords?: string[] | undefined;
7
+ example?: string | undefined;
8
+ }, {
9
+ queryKeywords?: string[] | undefined;
10
+ example?: string | undefined;
11
+ }>;
12
+ export type ExamplesInput = z.infer<typeof examplesInputSchema>;
13
+ export declare const examplesTool: {
14
+ name: string;
15
+ description: string;
16
+ parameters: z.ZodObject<{
17
+ example: z.ZodOptional<z.ZodString>;
18
+ queryKeywords: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
19
+ }, "strip", z.ZodTypeAny, {
20
+ queryKeywords?: string[] | undefined;
21
+ example?: string | undefined;
22
+ }, {
23
+ queryKeywords?: string[] | undefined;
24
+ example?: string | undefined;
25
+ }>;
26
+ execute: (args: ExamplesInput) => Promise<string>;
27
+ };
28
+ //# sourceMappingURL=examples.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"examples.d.ts","sourceRoot":"","sources":["../../src/tools/examples.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA8CxB,eAAO,MAAM,mBAAmB;;;;;;;;;EAa9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,YAAY;;;;;;;;;;;;;oBAOD,aAAa;CAgBpC,CAAC"}
@@ -0,0 +1,62 @@
1
+ import z from 'zod';
2
+ export declare function fromRepoRoot(relative: string): string;
3
+ export declare function fromPackageRoot(relative: string): string;
4
+ export declare const log: {
5
+ (...data: any[]): void;
6
+ (message?: any, ...optionalParams: any[]): void;
7
+ };
8
+ export declare function getMatchingPaths(path: string, queryKeywords: string[], baseDir: string): Promise<string>;
9
+ export declare const blogPostSchema: z.ZodObject<{
10
+ slug: z.ZodString;
11
+ content: z.ZodString;
12
+ metadata: z.ZodObject<{
13
+ title: z.ZodString;
14
+ publishedAt: z.ZodString;
15
+ summary: z.ZodString;
16
+ image: z.ZodOptional<z.ZodString>;
17
+ author: z.ZodOptional<z.ZodString>;
18
+ draft: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
19
+ categories: z.ZodUnion<[z.ZodArray<z.ZodString, "many">, z.ZodString]>;
20
+ }, "strip", z.ZodTypeAny, {
21
+ title: string;
22
+ publishedAt: string;
23
+ summary: string;
24
+ draft: boolean;
25
+ categories: string | string[];
26
+ image?: string | undefined;
27
+ author?: string | undefined;
28
+ }, {
29
+ title: string;
30
+ publishedAt: string;
31
+ summary: string;
32
+ categories: string | string[];
33
+ image?: string | undefined;
34
+ author?: string | undefined;
35
+ draft?: boolean | undefined;
36
+ }>;
37
+ }, "strip", z.ZodTypeAny, {
38
+ content: string;
39
+ slug: string;
40
+ metadata: {
41
+ title: string;
42
+ publishedAt: string;
43
+ summary: string;
44
+ draft: boolean;
45
+ categories: string | string[];
46
+ image?: string | undefined;
47
+ author?: string | undefined;
48
+ };
49
+ }, {
50
+ content: string;
51
+ slug: string;
52
+ metadata: {
53
+ title: string;
54
+ publishedAt: string;
55
+ summary: string;
56
+ categories: string | string[];
57
+ image?: string | undefined;
58
+ author?: string | undefined;
59
+ draft?: boolean | undefined;
60
+ };
61
+ }>;
62
+ //# sourceMappingURL=utils.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAGA,OAAO,CAAC,MAAM,KAAK,CAAC;AAMpB,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,UAE5C;AACD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,UAE/C;AAGD,eAAO,MAAM,GAAG;;;CAAgB,CAAC;AAyIjC,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAe9G;AAED,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYzB,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mastra/mcp-docs-server",
3
- "version": "0.13.7",
3
+ "version": "0.13.8-alpha.0",
4
4
  "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -32,8 +32,8 @@
32
32
  "uuid": "^11.1.0",
33
33
  "zod": "^3.25.67",
34
34
  "zod-to-json-schema": "^3.24.5",
35
- "@mastra/core": "0.12.0",
36
- "@mastra/mcp": "^0.10.8"
35
+ "@mastra/mcp": "^0.10.9-alpha.0",
36
+ "@mastra/core": "0.12.1-alpha.0"
37
37
  },
38
38
  "devDependencies": {
39
39
  "@hono/node-server": "^1.17.1",
@@ -48,12 +48,12 @@
48
48
  "tsx": "^4.19.4",
49
49
  "typescript": "^5.8.3",
50
50
  "vitest": "^3.2.4",
51
- "@internal/lint": "0.0.24",
52
- "@mastra/core": "0.12.0"
51
+ "@mastra/core": "0.12.1-alpha.0",
52
+ "@internal/lint": "0.0.24"
53
53
  },
54
54
  "scripts": {
55
55
  "prepare-docs": "cross-env PREPARE=true node dist/prepare-docs/prepare.js",
56
- "build:cli": "tsup src/stdio.ts src/prepare-docs/prepare.ts --format esm --experimental-dts --treeshake=smallest --splitting",
56
+ "build:cli": "tsup src/stdio.ts src/prepare-docs/prepare.ts --format esm --no-dts --treeshake=smallest --splitting && tsc -p tsconfig.build.json",
57
57
  "pretest": "pnpm turbo build --filter @mastra/mcp-docs-server",
58
58
  "test": "vitest run",
59
59
  "lint": "eslint ."