@mastra/rag 2.0.0-beta.6 → 2.0.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 (34) hide show
  1. package/CHANGELOG.md +472 -0
  2. package/dist/docs/README.md +1 -1
  3. package/dist/docs/SKILL.md +1 -1
  4. package/dist/docs/SOURCE_MAP.json +1 -1
  5. package/dist/docs/rag/02-chunking-and-embedding.md +0 -1
  6. package/dist/docs/rag/03-retrieval.md +5 -6
  7. package/dist/docs/rag/05-reference.md +22 -8
  8. package/dist/document/document.d.ts +1 -1
  9. package/dist/document/document.d.ts.map +1 -1
  10. package/dist/document/extractors/index.d.ts +2 -1
  11. package/dist/document/extractors/index.d.ts.map +1 -1
  12. package/dist/document/extractors/schema.d.ts +13 -0
  13. package/dist/document/extractors/schema.d.ts.map +1 -0
  14. package/dist/document/extractors/types.d.ts +7 -0
  15. package/dist/document/extractors/types.d.ts.map +1 -1
  16. package/dist/document/transformers/sentence.d.ts +0 -1
  17. package/dist/document/transformers/sentence.d.ts.map +1 -1
  18. package/dist/document/transformers/text.d.ts +2 -2
  19. package/dist/document/transformers/text.d.ts.map +1 -1
  20. package/dist/document/types.d.ts +3 -2
  21. package/dist/document/types.d.ts.map +1 -1
  22. package/dist/index.cjs +56 -17
  23. package/dist/index.cjs.map +1 -1
  24. package/dist/index.js +56 -17
  25. package/dist/index.js.map +1 -1
  26. package/dist/tools/document-chunker.d.ts +3 -2
  27. package/dist/tools/document-chunker.d.ts.map +1 -1
  28. package/dist/tools/graph-rag.d.ts +2 -2
  29. package/dist/tools/graph-rag.d.ts.map +1 -1
  30. package/dist/tools/vector-query.d.ts +2 -2
  31. package/dist/tools/vector-query.d.ts.map +1 -1
  32. package/dist/utils/tool-schemas.d.ts +2 -2
  33. package/dist/utils/tool-schemas.d.ts.map +1 -1
  34. package/package.json +5 -5
package/dist/tools/document-chunker.d.ts CHANGED
@@ -1,7 +1,8 @@
1
- import { createTool } from '@mastra/core/tools';
2
1
  import type { MDocument, ChunkParams } from '../document/index.js';
3
2
  export declare const createDocumentChunkerTool: ({ doc, params, }: {
4
3
  doc: MDocument;
5
4
  params?: ChunkParams;
6
- }) => ReturnType<typeof createTool>;
5
+ }) => import("@mastra/core/tools").Tool<{}, {
6
+ chunks: import("../document/schema").Document<import("../document/schema").Metadata>[];
7
+ }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown>, "Document Chunker undefined undefined" | `Document Chunker undefined ${number}` | "Document Chunker json undefined" | `Document Chunker json ${number}` | "Document Chunker markdown undefined" | `Document Chunker markdown ${number}` | "Document Chunker latex undefined" | `Document Chunker latex ${number}` | "Document Chunker html undefined" | `Document Chunker html ${number}` | "Document Chunker recursive undefined" | `Document Chunker recursive ${number}` | "Document Chunker character undefined" | `Document Chunker character ${number}` | "Document Chunker token undefined" | `Document Chunker token ${number}` | "Document Chunker sentence undefined" | `Document Chunker sentence ${number}` | "Document Chunker semantic-markdown undefined" | `Document Chunker semantic-markdown ${number}`>;
7
8
  //# sourceMappingURL=document-chunker.d.ts.map
package/dist/tools/document-chunker.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"document-chunker.d.ts","sourceRoot":"","sources":["../../src/tools/document-chunker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAS1D,eAAO,MAAM,yBAAyB,GAAI,kBAGvC;IACD,GAAG,EAAE,SAAS,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,KAAG,UAAU,CAAC,OAAO,UAAU,CAe/B,CAAC"}
1
+ {"version":3,"file":"document-chunker.d.ts","sourceRoot":"","sources":["../../src/tools/document-chunker.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAS1D,eAAO,MAAM,yBAAyB,GAAI,kBAGvC;IACD,GAAG,EAAE,SAAS,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;;o3BAeA,CAAC"}
package/dist/tools/graph-rag.d.ts CHANGED
@@ -1,7 +1,7 @@
1
1
  import { z } from 'zod';
2
2
  import type { RagTool } from '../utils/index.js';
3
3
  import type { GraphRagToolOptions } from './types.js';
4
- export declare const createGraphRAGTool: (options: GraphRagToolOptions) => RagTool<z.ZodObject<{
4
+ export declare const createGraphRAGTool: (options: GraphRagToolOptions) => RagTool<z.infer<z.ZodObject<{
5
5
  filter: z.ZodString;
6
6
  queryText: z.ZodString;
7
7
  topK: z.ZodNumber;
@@ -22,5 +22,5 @@ export declare const createGraphRAGTool: (options: GraphRagToolOptions) => RagTo
22
22
  }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
23
23
  queryText: z.ZodString;
24
24
  topK: z.ZodNumber;
25
- }, z.ZodTypeAny, "passthrough">>, any>;
25
+ }, z.ZodTypeAny, "passthrough">>>, any>;
26
26
  //# sourceMappingURL=graph-rag.d.ts.map
package/dist/tools/graph-rag.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"graph-rag.d.ts","sourceRoot":"","sources":["../../src/tools/graph-rag.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC,OAAO,KAAK,EAAE,mBAAmB,EAAmB,MAAM,SAAS,CAAC;AAGpE,eAAO,MAAM,kBAAkB,GAAI,SAAS,mBAAmB,KA+HvD,OAAO;;;;;;;;;;;;;;;;;;;;;kCAAqB,GAAG,CACtC,CAAC"}
1
+ {"version":3,"file":"graph-rag.d.ts","sourceRoot":"","sources":["../../src/tools/graph-rag.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC,OAAO,KAAK,EAAE,mBAAmB,EAAmB,MAAM,SAAS,CAAC;AAGpE,eAAO,MAAM,kBAAkB,GAAI,SAAS,mBAAmB,KA+HvD,OAAO,CAAC,CAAC,CAAC,KAAK;;;;;;;;;;;;;;;;;;;;;iCAAoB,EAAE,GAAG,CAC/C,CAAC"}
package/dist/tools/vector-query.d.ts CHANGED
@@ -1,7 +1,7 @@
1
1
  import { z } from 'zod';
2
2
  import type { RagTool } from '../utils/index.js';
3
3
  import type { VectorQueryToolOptions } from './types.js';
4
- export declare const createVectorQueryTool: (options: VectorQueryToolOptions) => RagTool<z.ZodObject<{
4
+ export declare const createVectorQueryTool: (options: VectorQueryToolOptions) => RagTool<z.infer<z.ZodObject<{
5
5
  filter: z.ZodString;
6
6
  queryText: z.ZodString;
7
7
  topK: z.ZodNumber;
@@ -22,5 +22,5 @@ export declare const createVectorQueryTool: (options: VectorQueryToolOptions) =>
22
22
  }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
23
23
  queryText: z.ZodString;
24
24
  topK: z.ZodNumber;
25
- }, z.ZodTypeAny, "passthrough">>, any>;
25
+ }, z.ZodTypeAny, "passthrough">>>, any>;
26
26
  //# sourceMappingURL=vector-query.d.ts.map
package/dist/tools/vector-query.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"vector-query.d.ts","sourceRoot":"","sources":["../../src/tools/vector-query.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC,OAAO,KAAK,EAAmB,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEvE,eAAO,MAAM,qBAAqB,GAAI,SAAS,sBAAsB,KAoI7D,OAAO;;;;;;;;;;;;;;;;;;;;;kCAAqB,GAAG,CACtC,CAAC"}
1
+ {"version":3,"file":"vector-query.d.ts","sourceRoot":"","sources":["../../src/tools/vector-query.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC,OAAO,KAAK,EAAmB,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEvE,eAAO,MAAM,qBAAqB,GAAI,SAAS,sBAAsB,KAoI7D,OAAO,CAAC,CAAC,CAAC,KAAK;;;;;;;;;;;;;;;;;;;;;iCAAoB,EAAE,GAAG,CAC/C,CAAC"}
package/dist/utils/tool-schemas.d.ts CHANGED
@@ -57,7 +57,7 @@ export declare const filterSchema: z.ZodObject<{
57
57
  topK: number;
58
58
  queryText: string;
59
59
  }>;
60
- export type RagTool<TInput extends z.ZodType<any, z.ZodTypeDef, any> | undefined, TOutput extends z.ZodType<any, z.ZodTypeDef, any> | undefined> = Tool<TInput, TOutput> & {
61
- execute: NonNullable<Tool<TInput, TOutput>['execute']>;
60
+ export type RagTool<TInput, TOutput> = Tool<TInput, TOutput, never, never> & {
61
+ execute: NonNullable<Tool<TInput, TOutput, never, never>['execute']>;
62
62
  };
63
63
  //# sourceMappingURL=tool-schemas.d.ts.map
package/dist/utils/tool-schemas.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"tool-schemas.d.ts","sourceRoot":"","sources":["../../src/utils/tool-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,UAAU;;;CAGtB,CAAC;AAKF,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAavB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;EAGvB,CAAC;AAEH,MAAM,MAAM,OAAO,CACjB,MAAM,SAAS,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,UAAU,EAAE,GAAG,CAAC,GAAG,SAAS,EAC5D,OAAO,SAAS,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,UAAU,EAAE,GAAG,CAAC,GAAG,SAAS,IAC3D,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAC1B,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;CACxD,CAAC"}
1
+ {"version":3,"file":"tool-schemas.d.ts","sourceRoot":"","sources":["../../src/utils/tool-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,UAAU;;;CAGtB,CAAC;AAKF,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAavB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;EAGvB,CAAC;AAEH,MAAM,MAAM,OAAO,CAAC,MAAM,EAAE,OAAO,IAAI,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG;IAC3E,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;CACtE,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mastra/rag",
3
- "version": "2.0.0-beta.6",
3
+ "version": "2.0.0",
4
4
  "description": "",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -50,10 +50,10 @@
50
50
  "typescript": "^5.9.3",
51
51
  "vitest": "4.0.16",
52
52
  "zod": "^3.25.76",
53
- "@internal/ai-sdk-v4": "0.0.0",
54
- "@internal/lint": "0.0.53",
55
- "@internal/types-builder": "0.0.28",
56
- "@mastra/core": "1.0.0-beta.21"
53
+ "@internal/ai-sdk-v4": "0.0.1",
54
+ "@internal/types-builder": "0.0.29",
55
+ "@mastra/core": "1.0.0",
56
+ "@internal/lint": "0.0.54"
57
57
  },
58
58
  "keywords": [
59
59
  "rag",