@vibe-agent-toolkit/rag 0.1.0-rc.7

package/dist/schemas/chunk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk.js","sourceRoot":"","sources":["../../src/schemas/chunk.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,WAAW;IACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IAC9D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;IAE3E,UAAU;IACV,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IACrD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IACxE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IAEzE,oCAAoC;IACpC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC;IAClG,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;IAC/F,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IAChF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAE5E,sGAAsG;IACtG,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IACjD,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;IAC9D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;IACrD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAEvD,qBAAqB;IACrB,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IAC3D,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gEAAgE,CAAC;IACrG,UAAU,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IAE7D,0BAA0B;IAC1B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;IAC3F,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;CACpF,CAAC,CAAC"}

package/dist/schemas/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * RAG Schemas
+ *
+ * Zod schemas for RAG data structures with generated JSON schemas.
+ */
+export { RAGChunkSchema, type RAGChunk } from './chunk.js';
+export { RAGQuerySchema, RAGResultSchema, type RAGQuery, type RAGResult } from './query.js';
+export { RAGStatsSchema, IndexResultSchema, type RAGStats, type IndexResult } from './admin.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/schemas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5F,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,KAAK,QAAQ,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/schemas/index.js

@@ -0,0 +1,9 @@
+/**
+ * RAG Schemas
+ *
+ * Zod schemas for RAG data structures with generated JSON schemas.
+ */
+export { RAGChunkSchema } from './chunk.js';
+export { RAGQuerySchema, RAGResultSchema } from './query.js';
+export { RAGStatsSchema, IndexResultSchema } from './admin.js';
+//# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAiB,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,eAAe,EAAiC,MAAM,YAAY,CAAC;AAC5F,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAmC,MAAM,YAAY,CAAC"}

package/dist/schemas/json-schema.d.ts

@@ -0,0 +1,86 @@
+/**
+ * JSON Schema generation from Zod schemas
+ *
+ * Exports JSON schemas for use by external tools and documentation.
+ */
+/**
+ * Generate JSON Schema for RAGChunk
+ */
+export declare const RAGChunkJsonSchema: import("zod-to-json-schema").JsonSchema7Type & {
+    $schema?: string | undefined;
+    definitions?: {
+        [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+    } | undefined;
+};
+/**
+ * Generate JSON Schema for RAGQuery
+ */
+export declare const RAGQueryJsonSchema: import("zod-to-json-schema").JsonSchema7Type & {
+    $schema?: string | undefined;
+    definitions?: {
+        [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+    } | undefined;
+};
+/**
+ * Generate JSON Schema for RAGResult
+ */
+export declare const RAGResultJsonSchema: import("zod-to-json-schema").JsonSchema7Type & {
+    $schema?: string | undefined;
+    definitions?: {
+        [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+    } | undefined;
+};
+/**
+ * Generate JSON Schema for RAGStats
+ */
+export declare const RAGStatsJsonSchema: import("zod-to-json-schema").JsonSchema7Type & {
+    $schema?: string | undefined;
+    definitions?: {
+        [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+    } | undefined;
+};
+/**
+ * Generate JSON Schema for IndexResult
+ */
+export declare const IndexResultJsonSchema: import("zod-to-json-schema").JsonSchema7Type & {
+    $schema?: string | undefined;
+    definitions?: {
+        [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+    } | undefined;
+};
+/**
+ * All JSON Schemas exported as a collection
+ */
+export declare const jsonSchemas: {
+    RAGChunk: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+    RAGQuery: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+    RAGResult: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+    RAGStats: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+    IndexResult: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+};
+//# sourceMappingURL=json-schema.d.ts.map

package/dist/schemas/json-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.d.ts","sourceRoot":"","sources":["../../src/schemas/json-schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;CAG7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;CAG7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;CAG9B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;CAG7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;CAGhC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMvB,CAAC"}

package/dist/schemas/json-schema.js

@@ -0,0 +1,55 @@
+/**
+ * JSON Schema generation from Zod schemas
+ *
+ * Exports JSON schemas for use by external tools and documentation.
+ */
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { IndexResultSchema, RAGStatsSchema } from './admin.js';
+import { RAGChunkSchema } from './chunk.js';
+import { RAGQuerySchema, RAGResultSchema } from './query.js';
+/**
+ * Generate JSON Schema for RAGChunk
+ */
+export const RAGChunkJsonSchema = zodToJsonSchema(RAGChunkSchema, {
+    name: 'RAGChunk',
+    $refStrategy: 'none',
+});
+/**
+ * Generate JSON Schema for RAGQuery
+ */
+export const RAGQueryJsonSchema = zodToJsonSchema(RAGQuerySchema, {
+    name: 'RAGQuery',
+    $refStrategy: 'none',
+});
+/**
+ * Generate JSON Schema for RAGResult
+ */
+export const RAGResultJsonSchema = zodToJsonSchema(RAGResultSchema, {
+    name: 'RAGResult',
+    $refStrategy: 'none',
+});
+/**
+ * Generate JSON Schema for RAGStats
+ */
+export const RAGStatsJsonSchema = zodToJsonSchema(RAGStatsSchema, {
+    name: 'RAGStats',
+    $refStrategy: 'none',
+});
+/**
+ * Generate JSON Schema for IndexResult
+ */
+export const IndexResultJsonSchema = zodToJsonSchema(IndexResultSchema, {
+    name: 'IndexResult',
+    $refStrategy: 'none',
+});
+/**
+ * All JSON Schemas exported as a collection
+ */
+export const jsonSchemas = {
+    RAGChunk: RAGChunkJsonSchema,
+    RAGQuery: RAGQueryJsonSchema,
+    RAGResult: RAGResultJsonSchema,
+    RAGStats: RAGStatsJsonSchema,
+    IndexResult: IndexResultJsonSchema,
+};
+//# sourceMappingURL=json-schema.js.map

package/dist/schemas/json-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.js","sourceRoot":"","sources":["../../src/schemas/json-schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7D;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC,cAAc,EAAE;IAChE,IAAI,EAAE,UAAU;IAChB,YAAY,EAAE,MAAM;CACrB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC,cAAc,EAAE;IAChE,IAAI,EAAE,UAAU;IAChB,YAAY,EAAE,MAAM;CACrB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,eAAe,CAAC,eAAe,EAAE;IAClE,IAAI,EAAE,WAAW;IACjB,YAAY,EAAE,MAAM;CACrB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC,cAAc,EAAE;IAChE,IAAI,EAAE,UAAU;IAChB,YAAY,EAAE,MAAM;CACrB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,eAAe,CAAC,iBAAiB,EAAE;IACtE,IAAI,EAAE,aAAa;IACnB,YAAY,EAAE,MAAM;CACrB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,QAAQ,EAAE,kBAAkB;IAC5B,QAAQ,EAAE,kBAAkB;IAC5B,SAAS,EAAE,mBAAmB;IAC9B,QAAQ,EAAE,kBAAkB;IAC5B,WAAW,EAAE,qBAAqB;CACnC,CAAC"}

package/dist/schemas/query.d.ts

@@ -0,0 +1,262 @@
+/**
+ * RAGQuery and RAGResult Zod schemas
+ */
+import { z } from 'zod';
+/**
+ * RAGQuery Schema
+ *
+ * Defines the structure of a query to the RAG database.
+ */
+export declare const RAGQuerySchema: z.ZodObject<{
+    /** Search query text */
+    text: z.ZodString;
+    /** Maximum results to return (default: 10) */
+    limit: z.ZodOptional<z.ZodNumber>;
+    /** Metadata filters */
+    filters: z.ZodOptional<z.ZodObject<{
+        /** Filter by resource ID(s) */
+        resourceId: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+        /** Filter by tags */
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** Filter by resource type */
+        type: z.ZodOptional<z.ZodString>;
+        /** Filter by heading path */
+        headingPath: z.ZodOptional<z.ZodString>;
+        /** Filter by date range */
+        dateRange: z.ZodOptional<z.ZodObject<{
+            start: z.ZodDate;
+            end: z.ZodDate;
+        }, "strip", z.ZodTypeAny, {
+            start: Date;
+            end: Date;
+        }, {
+            start: Date;
+            end: Date;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        resourceId?: string | string[] | undefined;
+        headingPath?: string | undefined;
+        type?: string | undefined;
+        tags?: string[] | undefined;
+        dateRange?: {
+            start: Date;
+            end: Date;
+        } | undefined;
+    }, {
+        resourceId?: string | string[] | undefined;
+        headingPath?: string | undefined;
+        type?: string | undefined;
+        tags?: string[] | undefined;
+        dateRange?: {
+            start: Date;
+            end: Date;
+        } | undefined;
+    }>>;
+    /** Hybrid search configuration */
+    hybridSearch: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodBoolean;
+        keywordWeight: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        keywordWeight?: number | undefined;
+    }, {
+        enabled: boolean;
+        keywordWeight?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+    limit?: number | undefined;
+    filters?: {
+        resourceId?: string | string[] | undefined;
+        headingPath?: string | undefined;
+        type?: string | undefined;
+        tags?: string[] | undefined;
+        dateRange?: {
+            start: Date;
+            end: Date;
+        } | undefined;
+    } | undefined;
+    hybridSearch?: {
+        enabled: boolean;
+        keywordWeight?: number | undefined;
+    } | undefined;
+}, {
+    text: string;
+    limit?: number | undefined;
+    filters?: {
+        resourceId?: string | string[] | undefined;
+        headingPath?: string | undefined;
+        type?: string | undefined;
+        tags?: string[] | undefined;
+        dateRange?: {
+            start: Date;
+            end: Date;
+        } | undefined;
+    } | undefined;
+    hybridSearch?: {
+        enabled: boolean;
+        keywordWeight?: number | undefined;
+    } | undefined;
+}>;
+/**
+ * RAGQuery TypeScript type
+ */
+export type RAGQuery = z.infer<typeof RAGQuerySchema>;
+/**
+ * RAGResult Schema
+ *
+ * Defines the structure of results from a RAG query.
+ */
+export declare const RAGResultSchema: z.ZodObject<{
+    /** Matched chunks, sorted by relevance */
+    chunks: z.ZodArray<z.ZodObject<{
+        chunkId: z.ZodString;
+        resourceId: z.ZodString;
+        content: z.ZodString;
+        contentHash: z.ZodString;
+        tokenCount: z.ZodNumber;
+        headingPath: z.ZodOptional<z.ZodString>;
+        headingLevel: z.ZodOptional<z.ZodNumber>;
+        startLine: z.ZodOptional<z.ZodNumber>;
+        endLine: z.ZodOptional<z.ZodNumber>;
+        filePath: z.ZodString;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        type: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        embedding: z.ZodArray<z.ZodNumber, "many">;
+        embeddingModel: z.ZodString;
+        embeddedAt: z.ZodDate;
+        previousChunkId: z.ZodOptional<z.ZodString>;
+        nextChunkId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        chunkId: string;
+        resourceId: string;
+        content: string;
+        contentHash: string;
+        tokenCount: number;
+        filePath: string;
+        embedding: number[];
+        embeddingModel: string;
+        embeddedAt: Date;
+        headingPath?: string | undefined;
+        headingLevel?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+        type?: string | undefined;
+        tags?: string[] | undefined;
+        title?: string | undefined;
+        previousChunkId?: string | undefined;
+        nextChunkId?: string | undefined;
+    }, {
+        chunkId: string;
+        resourceId: string;
+        content: string;
+        contentHash: string;
+        tokenCount: number;
+        filePath: string;
+        embedding: number[];
+        embeddingModel: string;
+        embeddedAt: Date;
+        headingPath?: string | undefined;
+        headingLevel?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+        type?: string | undefined;
+        tags?: string[] | undefined;
+        title?: string | undefined;
+        previousChunkId?: string | undefined;
+        nextChunkId?: string | undefined;
+    }>, "many">;
+    /** Search statistics */
+    stats: z.ZodObject<{
+        totalMatches: z.ZodNumber;
+        searchDurationMs: z.ZodNumber;
+        embedding: z.ZodOptional<z.ZodObject<{
+            model: z.ZodString;
+            tokensUsed: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            model: string;
+            tokensUsed?: number | undefined;
+        }, {
+            model: string;
+            tokensUsed?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        totalMatches: number;
+        searchDurationMs: number;
+        embedding?: {
+            model: string;
+            tokensUsed?: number | undefined;
+        } | undefined;
+    }, {
+        totalMatches: number;
+        searchDurationMs: number;
+        embedding?: {
+            model: string;
+            tokensUsed?: number | undefined;
+        } | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    chunks: {
+        chunkId: string;
+        resourceId: string;
+        content: string;
+        contentHash: string;
+        tokenCount: number;
+        filePath: string;
+        embedding: number[];
+        embeddingModel: string;
+        embeddedAt: Date;
+        headingPath?: string | undefined;
+        headingLevel?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+        type?: string | undefined;
+        tags?: string[] | undefined;
+        title?: string | undefined;
+        previousChunkId?: string | undefined;
+        nextChunkId?: string | undefined;
+    }[];
+    stats: {
+        totalMatches: number;
+        searchDurationMs: number;
+        embedding?: {
+            model: string;
+            tokensUsed?: number | undefined;
+        } | undefined;
+    };
+}, {
+    chunks: {
+        chunkId: string;
+        resourceId: string;
+        content: string;
+        contentHash: string;
+        tokenCount: number;
+        filePath: string;
+        embedding: number[];
+        embeddingModel: string;
+        embeddedAt: Date;
+        headingPath?: string | undefined;
+        headingLevel?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+        type?: string | undefined;
+        tags?: string[] | undefined;
+        title?: string | undefined;
+        previousChunkId?: string | undefined;
+        nextChunkId?: string | undefined;
+    }[];
+    stats: {
+        totalMatches: number;
+        searchDurationMs: number;
+        embedding?: {
+            model: string;
+            tokensUsed?: number | undefined;
+        } | undefined;
+    };
+}>;
+/**
+ * RAGResult TypeScript type
+ */
+export type RAGResult = z.infer<typeof RAGResultSchema>;
+//# sourceMappingURL=query.d.ts.map

package/dist/schemas/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/schemas/query.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;GAIG;AACH,eAAO,MAAM,cAAc;IACzB,wBAAwB;;IAGxB,8CAA8C;;IAG9C,uBAAuB;;QAErB,+BAA+B;;QAE/B,qBAAqB;;QAErB,8BAA8B;;QAE9B,6BAA6B;;QAE7B,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAO7B,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKlC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD;;;;GAIG;AACH,eAAO,MAAM,eAAe;IAC1B,0CAA0C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAG1C,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASxB,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/schemas/query.js

@@ -0,0 +1,56 @@
+/**
+ * RAGQuery and RAGResult Zod schemas
+ */
+import { z } from 'zod';
+import { RAGChunkSchema } from './chunk.js';
+/**
+ * RAGQuery Schema
+ *
+ * Defines the structure of a query to the RAG database.
+ */
+export const RAGQuerySchema = z.object({
+    /** Search query text */
+    text: z.string().describe('Search query text'),
+    /** Maximum results to return (default: 10) */
+    limit: z.number().optional().describe('Maximum results to return'),
+    /** Metadata filters */
+    filters: z.object({
+        /** Filter by resource ID(s) */
+        resourceId: z.union([z.string(), z.array(z.string())]).optional().describe('Filter by resource ID(s)'),
+        /** Filter by tags */
+        tags: z.array(z.string()).optional().describe('Filter by tags'),
+        /** Filter by resource type */
+        type: z.string().optional().describe('Filter by resource type'),
+        /** Filter by heading path */
+        headingPath: z.string().optional().describe('Filter by heading path (e.g., "Architecture > RAG Design")'),
+        /** Filter by date range */
+        dateRange: z.object({
+            start: z.date(),
+            end: z.date(),
+        }).optional().describe('Filter by date range'),
+    }).optional().describe('Metadata filters'),
+    /** Hybrid search configuration */
+    hybridSearch: z.object({
+        enabled: z.boolean().describe('Enable hybrid search (vector + keyword)'),
+        keywordWeight: z.number().optional().describe('Keyword weight (0-1, balance between semantic and keyword)'),
+    }).optional().describe('Hybrid search configuration'),
+});
+/**
+ * RAGResult Schema
+ *
+ * Defines the structure of results from a RAG query.
+ */
+export const RAGResultSchema = z.object({
+    /** Matched chunks, sorted by relevance */
+    chunks: z.array(RAGChunkSchema).describe('Matched chunks, sorted by relevance'),
+    /** Search statistics */
+    stats: z.object({
+        totalMatches: z.number().describe('Total number of matches'),
+        searchDurationMs: z.number().describe('Search duration in milliseconds'),
+        embedding: z.object({
+            model: z.string().describe('Embedding model used'),
+            tokensUsed: z.number().optional().describe('Tokens used for embedding (if applicable)'),
+        }).optional().describe('Embedding statistics'),
+    }).describe('Search statistics'),
+});
+//# sourceMappingURL=query.js.map

package/dist/schemas/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/schemas/query.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,wBAAwB;IACxB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAE9C,8CAA8C;IAC9C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IAElE,uBAAuB;IACvB,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,+BAA+B;QAC/B,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;QACtG,qBAAqB;QACrB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAC/D,8BAA8B;QAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QAC/D,6BAA6B;QAC7B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;QACzG,2BAA2B;QAC3B,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC;YAClB,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE;YACf,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE;SACd,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;KAC/C,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IAE1C,kCAAkC;IAClC,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC;QACrB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;QACxE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;KAC5G,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;CACtD,CAAC,CAAC;AAOH;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,0CAA0C;IAC1C,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IAE/E,wBAAwB;IACxB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QAC5D,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QACxE,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC;YAClB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;YAClD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;SACxF,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;KAC/C,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;CACjC,CAAC,CAAC"}

package/dist/token-counters/approximate-token-counter.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Approximate Token Counter
+ *
+ * Uses gpt-tokenizer for accurate token counting compatible with GPT-3.5/GPT-4.
+ */
+import type { TokenCounter } from '../interfaces/token-counter.js';
+/**
+ * ApproximateTokenCounter
+ *
+ * Uses gpt-tokenizer library for accurate token counting.
+ * Compatible with GPT-3.5/GPT-4 tokenization (cl100k_base encoding).
+ *
+ * Recommended padding factor: 0.9 (90% of target)
+ */
+export declare class ApproximateTokenCounter implements TokenCounter {
+    readonly name = "approximate";
+    /**
+     * Count tokens using gpt-tokenizer
+     *
+     * @param text - Text to count tokens in
+     * @returns Accurate token count
+     */
+    count(text: string): number;
+    /**
+     * Count tokens in multiple texts
+     *
+     * @param texts - Array of texts to count tokens in
+     * @returns Array of token counts
+     */
+    countBatch(texts: string[]): number[];
+}
+//# sourceMappingURL=approximate-token-counter.d.ts.map

package/dist/token-counters/approximate-token-counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approximate-token-counter.d.ts","sourceRoot":"","sources":["../../src/token-counters/approximate-token-counter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAEnE;;;;;;;GAOG;AACH,qBAAa,uBAAwB,YAAW,YAAY;IAC1D,QAAQ,CAAC,IAAI,iBAAiB;IAE9B;;;;;OAKG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAS3B;;;;;OAKG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;CAGtC"}

package/dist/token-counters/approximate-token-counter.js

@@ -0,0 +1,40 @@
+/**
+ * Approximate Token Counter
+ *
+ * Uses gpt-tokenizer for accurate token counting compatible with GPT-3.5/GPT-4.
+ */
+import { encode } from 'gpt-tokenizer';
+/**
+ * ApproximateTokenCounter
+ *
+ * Uses gpt-tokenizer library for accurate token counting.
+ * Compatible with GPT-3.5/GPT-4 tokenization (cl100k_base encoding).
+ *
+ * Recommended padding factor: 0.9 (90% of target)
+ */
+export class ApproximateTokenCounter {
+    name = 'approximate';
+    /**
+     * Count tokens using gpt-tokenizer
+     *
+     * @param text - Text to count tokens in
+     * @returns Accurate token count
+     */
+    count(text) {
+        if (text.length === 0) {
+            return 0;
+        }
+        const tokens = encode(text);
+        return tokens.length;
+    }
+    /**
+     * Count tokens in multiple texts
+     *
+     * @param texts - Array of texts to count tokens in
+     * @returns Array of token counts
+     */
+    countBatch(texts) {
+        return texts.map((text) => this.count(text));
+    }
+}
+//# sourceMappingURL=approximate-token-counter.js.map

package/dist/token-counters/approximate-token-counter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approximate-token-counter.js","sourceRoot":"","sources":["../../src/token-counters/approximate-token-counter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAIvC;;;;;;;GAOG;AACH,MAAM,OAAO,uBAAuB;IACzB,IAAI,GAAG,aAAa,CAAC;IAE9B;;;;;OAKG;IACH,KAAK,CAAC,IAAY;QAChB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,CAAC;QACX,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5B,OAAO,MAAM,CAAC,MAAM,CAAC;IACvB,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,KAAe;QACxB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/C,CAAC;CACF"}

package/dist/token-counters/fast-token-counter.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Fast Token Counter
+ *
+ * Uses bytes/4 heuristic for token estimation.
+ * Fast but inaccurate - suitable for quick validation checks.
+ */
+import type { TokenCounter } from '../interfaces/token-counter.js';
+/**
+ * FastTokenCounter
+ *
+ * Estimates token count using bytes/4 heuristic.
+ * Very fast, but accuracy is ~25% for English text.
+ *
+ * Recommended padding factor: 0.8 (80% of target)
+ */
+export declare class FastTokenCounter implements TokenCounter {
+    readonly name = "fast";
+    /**
+     * Count tokens using bytes/4 heuristic
+     *
+     * @param text - Text to count tokens in
+     * @returns Estimated token count
+     */
+    count(text: string): number;
+    /**
+     * Count tokens in multiple texts
+     *
+     * @param texts - Array of texts to count tokens in
+     * @returns Array of estimated token counts
+     */
+    countBatch(texts: string[]): number[];
+}
+//# sourceMappingURL=fast-token-counter.d.ts.map

package/dist/token-counters/fast-token-counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fast-token-counter.d.ts","sourceRoot":"","sources":["../../src/token-counters/fast-token-counter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAEnE;;;;;;;GAOG;AACH,qBAAa,gBAAiB,YAAW,YAAY;IACnD,QAAQ,CAAC,IAAI,UAAU;IAEvB;;;;;OAKG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAS3B;;;;;OAKG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;CAGtC"}

package/dist/token-counters/fast-token-counter.js

@@ -0,0 +1,40 @@
+/**
+ * Fast Token Counter
+ *
+ * Uses bytes/4 heuristic for token estimation.
+ * Fast but inaccurate - suitable for quick validation checks.
+ */
+/**
+ * FastTokenCounter
+ *
+ * Estimates token count using bytes/4 heuristic.
+ * Very fast, but accuracy is ~25% for English text.
+ *
+ * Recommended padding factor: 0.8 (80% of target)
+ */
+export class FastTokenCounter {
+    name = 'fast';
+    /**
+     * Count tokens using bytes/4 heuristic
+     *
+     * @param text - Text to count tokens in
+     * @returns Estimated token count
+     */
+    count(text) {
+        if (text.length === 0) {
+            return 0;
+        }
+        const bytes = new TextEncoder().encode(text).length;
+        return Math.ceil(bytes / 4);
+    }
+    /**
+     * Count tokens in multiple texts
+     *
+     * @param texts - Array of texts to count tokens in
+     * @returns Array of estimated token counts
+     */
+    countBatch(texts) {
+        return texts.map((text) => this.count(text));
+    }
+}
+//# sourceMappingURL=fast-token-counter.js.map

package/dist/token-counters/fast-token-counter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fast-token-counter.js","sourceRoot":"","sources":["../../src/token-counters/fast-token-counter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;GAOG;AACH,MAAM,OAAO,gBAAgB;IAClB,IAAI,GAAG,MAAM,CAAC;IAEvB;;;;;OAKG;IACH,KAAK,CAAC,IAAY;QAChB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,CAAC;QACX,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QACpD,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,KAAe;QACxB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/C,CAAC;CACF"}