ctxpkg 0.0.3 → 0.0.5

package/dist/documents/documents.schemas.d.ts

@@ -0,0 +1,418 @@
+import { z } from 'zod';
+declare const referenceDocumentSchema: z.ZodObject<{
+    collection: z.ZodString;
+    id: z.ZodString;
+    content: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    collection: string;
+    content: string;
+}, {
+    id: string;
+    collection: string;
+    content: string;
+}>;
+type ReferenceDocument = z.infer<typeof referenceDocumentSchema>;
+declare const searchChunksOptionsSchema: z.ZodObject<{
+    query: z.ZodString;
+    collections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    /**
+     * Maximum distance threshold for results (0-2 for cosine, lower is better).
+     * Results with distance greater than this will be filtered out.
+     */
+    maxDistance: z.ZodOptional<z.ZodNumber>;
+    /**
+     * Enable hybrid search combining vector similarity with keyword matching.
+     * Uses Reciprocal Rank Fusion (RRF) to merge results.
+     * @default true
+     */
+    hybridSearch: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * Enable re-ranking of results using cross-encoder model.
+     * Slower but more accurate. Only re-ranks top candidates.
+     * @default false
+     */
+    rerank: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    collections?: string[] | undefined;
+    limit?: number | undefined;
+    maxDistance?: number | undefined;
+    hybridSearch?: boolean | undefined;
+    rerank?: boolean | undefined;
+}, {
+    query: string;
+    collections?: string[] | undefined;
+    limit?: number | undefined;
+    maxDistance?: number | undefined;
+    hybridSearch?: boolean | undefined;
+    rerank?: boolean | undefined;
+}>;
+type SearchChunksOptions = z.infer<typeof searchChunksOptionsSchema>;
+declare const searchChunkItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    document: z.ZodString;
+    collection: z.ZodString;
+    content: z.ZodString;
+    distance: z.ZodNumber;
+    /** Combined score after hybrid search fusion (higher is better) */
+    score: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    collection: string;
+    document: string;
+    content: string;
+    distance: number;
+    score?: number | undefined;
+}, {
+    id: string;
+    collection: string;
+    document: string;
+    content: string;
+    distance: number;
+    score?: number | undefined;
+}>;
+type SearchChunkItem = z.infer<typeof searchChunkItemSchema>;
+declare const listDocumentsParamsSchema: z.ZodObject<{
+    collection: z.ZodString;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    collection: string;
+    limit: number;
+    offset: number;
+}, {
+    collection: string;
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
+type ListDocumentsParams = z.infer<typeof listDocumentsParamsSchema>;
+declare const documentInfoSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    size: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    title: string;
+    size: number;
+}, {
+    id: string;
+    title: string;
+    size: number;
+}>;
+type DocumentInfo = z.infer<typeof documentInfoSchema>;
+declare const listDocumentsResultSchema: z.ZodObject<{
+    documents: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        size: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        title: string;
+        size: number;
+    }, {
+        id: string;
+        title: string;
+        size: number;
+    }>, "many">;
+    total: z.ZodNumber;
+    hasMore: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    total: number;
+    documents: {
+        id: string;
+        title: string;
+        size: number;
+    }[];
+    hasMore: boolean;
+}, {
+    total: number;
+    documents: {
+        id: string;
+        title: string;
+        size: number;
+    }[];
+    hasMore: boolean;
+}>;
+type ListDocumentsResult = z.infer<typeof listDocumentsResultSchema>;
+declare const getOutlineParamsSchema: z.ZodObject<{
+    collection: z.ZodString;
+    document: z.ZodString;
+    maxDepth: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    collection: string;
+    document: string;
+    maxDepth: number;
+}, {
+    collection: string;
+    document: string;
+    maxDepth?: number | undefined;
+}>;
+type GetOutlineParams = z.infer<typeof getOutlineParamsSchema>;
+declare const outlineItemSchema: z.ZodObject<{
+    level: z.ZodNumber;
+    text: z.ZodString;
+    line: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    level: number;
+    text: string;
+    line: number;
+}, {
+    level: number;
+    text: string;
+    line: number;
+}>;
+type OutlineItem = z.infer<typeof outlineItemSchema>;
+declare const outlineResultSchema: z.ZodObject<{
+    title: z.ZodString;
+    outline: z.ZodArray<z.ZodObject<{
+        level: z.ZodNumber;
+        text: z.ZodString;
+        line: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        level: number;
+        text: string;
+        line: number;
+    }, {
+        level: number;
+        text: string;
+        line: number;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    outline: {
+        level: number;
+        text: string;
+        line: number;
+    }[];
+}, {
+    title: string;
+    outline: {
+        level: number;
+        text: string;
+        line: number;
+    }[];
+}>;
+type OutlineResult = z.infer<typeof outlineResultSchema>;
+declare const getSectionParamsSchema: z.ZodObject<{
+    collection: z.ZodString;
+    document: z.ZodString;
+    section: z.ZodString;
+    includeSubsections: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    collection: string;
+    document: string;
+    section: string;
+    includeSubsections: boolean;
+}, {
+    collection: string;
+    document: string;
+    section: string;
+    includeSubsections?: boolean | undefined;
+}>;
+type GetSectionParams = z.infer<typeof getSectionParamsSchema>;
+declare const sectionResultSchema: z.ZodObject<{
+    section: z.ZodString;
+    level: z.ZodNumber;
+    content: z.ZodString;
+    startLine: z.ZodNumber;
+    endLine: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    section: string;
+    content: string;
+    level: number;
+    startLine: number;
+    endLine: number;
+}, {
+    section: string;
+    content: string;
+    level: number;
+    startLine: number;
+    endLine: number;
+}>;
+type SectionResult = z.infer<typeof sectionResultSchema>;
+declare const findRelatedParamsSchema: z.ZodObject<{
+    collection: z.ZodString;
+    document: z.ZodString;
+    chunk: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    sameDocument: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    collection: string;
+    document: string;
+    limit: number;
+    sameDocument: boolean;
+    chunk?: string | undefined;
+}, {
+    collection: string;
+    document: string;
+    limit?: number | undefined;
+    chunk?: string | undefined;
+    sameDocument?: boolean | undefined;
+}>;
+type FindRelatedParams = z.infer<typeof findRelatedParamsSchema>;
+declare const searchBatchQuerySchema: z.ZodObject<{
+    query: z.ZodString;
+    collections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    collections?: string[] | undefined;
+}, {
+    query: string;
+    collections?: string[] | undefined;
+}>;
+declare const searchBatchParamsSchema: z.ZodObject<{
+    queries: z.ZodArray<z.ZodObject<{
+        query: z.ZodString;
+        collections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        query: string;
+        collections?: string[] | undefined;
+    }, {
+        query: string;
+        collections?: string[] | undefined;
+    }>, "many">;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    maxDistance: z.ZodOptional<z.ZodNumber>;
+    hybridSearch: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    hybridSearch: boolean;
+    queries: {
+        query: string;
+        collections?: string[] | undefined;
+    }[];
+    maxDistance?: number | undefined;
+}, {
+    queries: {
+        query: string;
+        collections?: string[] | undefined;
+    }[];
+    limit?: number | undefined;
+    maxDistance?: number | undefined;
+    hybridSearch?: boolean | undefined;
+}>;
+type SearchBatchParams = z.infer<typeof searchBatchParamsSchema>;
+declare const searchBatchResultItemSchema: z.ZodObject<{
+    query: z.ZodString;
+    results: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        document: z.ZodString;
+        collection: z.ZodString;
+        content: z.ZodString;
+        distance: z.ZodNumber;
+        /** Combined score after hybrid search fusion (higher is better) */
+        score: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        collection: string;
+        document: string;
+        content: string;
+        distance: number;
+        score?: number | undefined;
+    }, {
+        id: string;
+        collection: string;
+        document: string;
+        content: string;
+        distance: number;
+        score?: number | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    results: {
+        id: string;
+        collection: string;
+        document: string;
+        content: string;
+        distance: number;
+        score?: number | undefined;
+    }[];
+}, {
+    query: string;
+    results: {
+        id: string;
+        collection: string;
+        document: string;
+        content: string;
+        distance: number;
+        score?: number | undefined;
+    }[];
+}>;
+declare const searchBatchResultSchema: z.ZodObject<{
+    results: z.ZodArray<z.ZodObject<{
+        query: z.ZodString;
+        results: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            document: z.ZodString;
+            collection: z.ZodString;
+            content: z.ZodString;
+            distance: z.ZodNumber;
+            /** Combined score after hybrid search fusion (higher is better) */
+            score: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            collection: string;
+            document: string;
+            content: string;
+            distance: number;
+            score?: number | undefined;
+        }, {
+            id: string;
+            collection: string;
+            document: string;
+            content: string;
+            distance: number;
+            score?: number | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        query: string;
+        results: {
+            id: string;
+            collection: string;
+            document: string;
+            content: string;
+            distance: number;
+            score?: number | undefined;
+        }[];
+    }, {
+        query: string;
+        results: {
+            id: string;
+            collection: string;
+            document: string;
+            content: string;
+            distance: number;
+            score?: number | undefined;
+        }[];
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    results: {
+        query: string;
+        results: {
+            id: string;
+            collection: string;
+            document: string;
+            content: string;
+            distance: number;
+            score?: number | undefined;
+        }[];
+    }[];
+}, {
+    results: {
+        query: string;
+        results: {
+            id: string;
+            collection: string;
+            document: string;
+            content: string;
+            distance: number;
+            score?: number | undefined;
+        }[];
+    }[];
+}>;
+type SearchBatchResult = z.infer<typeof searchBatchResultSchema>;
+export type { ReferenceDocument, SearchChunksOptions, SearchChunkItem, ListDocumentsParams, DocumentInfo, ListDocumentsResult, GetOutlineParams, OutlineItem, OutlineResult, GetSectionParams, SectionResult, FindRelatedParams, SearchBatchParams, SearchBatchResult, };
+export { referenceDocumentSchema, searchChunksOptionsSchema, searchChunkItemSchema, listDocumentsParamsSchema, documentInfoSchema, listDocumentsResultSchema, getOutlineParamsSchema, outlineItemSchema, outlineResultSchema, getSectionParamsSchema, sectionResultSchema, findRelatedParamsSchema, searchBatchQuerySchema, searchBatchParamsSchema, searchBatchResultItemSchema, searchBatchResultSchema, };
+//# sourceMappingURL=documents.schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"documents.schemas.d.ts","sourceRoot":"","sources":["../../src/documents/documents.schemas.ts"],"names":[],"mappings":"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"}

package/dist/documents/documents.schemas.js

@@ -0,0 +1,111 @@
+import { z } from 'zod';
+const referenceDocumentSchema = z.object({
+    collection: z.string(),
+    id: z.string(),
+    content: z.string(),
+});
+const searchChunksOptionsSchema = z.object({
+    query: z.string(),
+    collections: z.array(z.string()).optional(),
+    limit: z.number().optional(),
+    /**
+     * Maximum distance threshold for results (0-2 for cosine, lower is better).
+     * Results with distance greater than this will be filtered out.
+     */
+    maxDistance: z.number().optional(),
+    /**
+     * Enable hybrid search combining vector similarity with keyword matching.
+     * Uses Reciprocal Rank Fusion (RRF) to merge results.
+     * @default true
+     */
+    hybridSearch: z.boolean().optional(),
+    /**
+     * Enable re-ranking of results using cross-encoder model.
+     * Slower but more accurate. Only re-ranks top candidates.
+     * @default false
+     */
+    rerank: z.boolean().optional(),
+});
+const searchChunkItemSchema = z.object({
+    id: z.string(),
+    document: z.string(),
+    collection: z.string(),
+    content: z.string(),
+    distance: z.number(),
+    /** Combined score after hybrid search fusion (higher is better) */
+    score: z.number().optional(),
+});
+// === New schemas for MCP tools v2 ===
+// List documents params and result
+const listDocumentsParamsSchema = z.object({
+    collection: z.string(),
+    limit: z.number().optional().default(100),
+    offset: z.number().optional().default(0),
+});
+const documentInfoSchema = z.object({
+    id: z.string(),
+    title: z.string(),
+    size: z.number(),
+});
+const listDocumentsResultSchema = z.object({
+    documents: z.array(documentInfoSchema),
+    total: z.number(),
+    hasMore: z.boolean(),
+});
+// Get outline params and result
+const getOutlineParamsSchema = z.object({
+    collection: z.string(),
+    document: z.string(),
+    maxDepth: z.number().optional().default(3),
+});
+const outlineItemSchema = z.object({
+    level: z.number(),
+    text: z.string(),
+    line: z.number(),
+});
+const outlineResultSchema = z.object({
+    title: z.string(),
+    outline: z.array(outlineItemSchema),
+});
+// Get section params and result
+const getSectionParamsSchema = z.object({
+    collection: z.string(),
+    document: z.string(),
+    section: z.string(),
+    includeSubsections: z.boolean().optional().default(true),
+});
+const sectionResultSchema = z.object({
+    section: z.string(),
+    level: z.number(),
+    content: z.string(),
+    startLine: z.number(),
+    endLine: z.number(),
+});
+// Find related params
+const findRelatedParamsSchema = z.object({
+    collection: z.string(),
+    document: z.string(),
+    chunk: z.string().optional(),
+    limit: z.number().optional().default(5),
+    sameDocument: z.boolean().optional().default(false),
+});
+// Search batch params and result
+const searchBatchQuerySchema = z.object({
+    query: z.string(),
+    collections: z.array(z.string()).optional(),
+});
+const searchBatchParamsSchema = z.object({
+    queries: z.array(searchBatchQuerySchema).min(1).max(10),
+    limit: z.number().optional().default(5),
+    maxDistance: z.number().optional(),
+    hybridSearch: z.boolean().optional().default(true),
+});
+const searchBatchResultItemSchema = z.object({
+    query: z.string(),
+    results: z.array(searchChunkItemSchema),
+});
+const searchBatchResultSchema = z.object({
+    results: z.array(searchBatchResultItemSchema),
+});
+export { referenceDocumentSchema, searchChunksOptionsSchema, searchChunkItemSchema, listDocumentsParamsSchema, documentInfoSchema, listDocumentsResultSchema, getOutlineParamsSchema, outlineItemSchema, outlineResultSchema, getSectionParamsSchema, sectionResultSchema, findRelatedParamsSchema, searchBatchQuerySchema, searchBatchParamsSchema, searchBatchResultItemSchema, searchBatchResultSchema, };
+//# sourceMappingURL=documents.schemas.js.map

package/dist/documents/documents.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.schemas.js","sourceRoot":"","sources":["../../src/documents/documents.schemas.ts"],"names":[],"mappings":"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"}

package/dist/embedder/embedder.d.ts

@@ -0,0 +1,22 @@
+import { type FeatureExtractionPipeline } from '@huggingface/transformers';
+declare class EmbedderService {
+    #private;
+    getExtractor: () => Promise<FeatureExtractionPipeline>;
+    /**
+     * Create embeddings for documents (no instruction prefix).
+     * Use this when indexing document chunks.
+     */
+    createDocumentEmbeddings: (inputs: string[]) => Promise<number[][]>;
+    /**
+     * Create embedding for a search query (with instruction prefix).
+     * Use this when searching for relevant documents.
+     */
+    createQueryEmbedding: (query: string) => Promise<number[]>;
+    /**
+     * @deprecated Use createDocumentEmbeddings or createQueryEmbedding instead.
+     * Kept for backwards compatibility.
+     */
+    createEmbeddings: (inputs: string[]) => Promise<number[][]>;
+}
+export { EmbedderService };
+//# sourceMappingURL=embedder.d.ts.map

package/dist/embedder/embedder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedder.d.ts","sourceRoot":"","sources":["../../src/embedder/embedder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,yBAAyB,EAAY,MAAM,2BAA2B,CAAC;AAKrF,cAAM,eAAe;;IAUZ,YAAY,2CAKjB;IAEF;;;OAGG;IACI,wBAAwB,GAAU,QAAQ,MAAM,EAAE,KAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAI7E;IAEF;;;OAGG;IACI,oBAAoB,GAAU,OAAO,MAAM,KAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAKpE;IAEF;;;OAGG;IACI,gBAAgB,GAAU,QAAQ,MAAM,EAAE,KAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAErE;CACH;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/embedder/embedder.js

@@ -0,0 +1,46 @@
+import { pipeline } from '@huggingface/transformers';
+// Instruction prefix for query embeddings (mxbai-embed format)
+const QUERY_INSTRUCTION = 'Represent this sentence for searching relevant passages: ';
+class EmbedderService {
+    #pipeline;
+    #setup = async () => {
+        const extractor = await pipeline('feature-extraction', 'mixedbread-ai/mxbai-embed-large-v1', {
+            dtype: 'fp32',
+        });
+        return extractor;
+    };
+    getExtractor = async () => {
+        if (!this.#pipeline) {
+            this.#pipeline = this.#setup();
+        }
+        return await this.#pipeline;
+    };
+    /**
+     * Create embeddings for documents (no instruction prefix).
+     * Use this when indexing document chunks.
+     */
+    createDocumentEmbeddings = async (inputs) => {
+        const extractor = await this.getExtractor();
+        const output = await extractor(inputs, { pooling: 'cls' });
+        return output.tolist();
+    };
+    /**
+     * Create embedding for a search query (with instruction prefix).
+     * Use this when searching for relevant documents.
+     */
+    createQueryEmbedding = async (query) => {
+        const extractor = await this.getExtractor();
+        const instructedQuery = `${QUERY_INSTRUCTION}${query}`;
+        const output = await extractor([instructedQuery], { pooling: 'cls' });
+        return output.tolist()[0];
+    };
+    /**
+     * @deprecated Use createDocumentEmbeddings or createQueryEmbedding instead.
+     * Kept for backwards compatibility.
+     */
+    createEmbeddings = async (inputs) => {
+        return this.createDocumentEmbeddings(inputs);
+    };
+}
+export { EmbedderService };
+//# sourceMappingURL=embedder.js.map

package/dist/embedder/embedder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedder.js","sourceRoot":"","sources":["../../src/embedder/embedder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErF,+DAA+D;AAC/D,MAAM,iBAAiB,GAAG,2DAA2D,CAAC;AAEtF,MAAM,eAAe;IACnB,SAAS,CAAsC;IAE/C,MAAM,GAAG,KAAK,IAAI,EAAE;QAClB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,oBAAoB,EAAE,oCAAoC,EAAE;YAC3F,KAAK,EAAE,MAAM;SACd,CAAC,CAAC;QACH,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;IAEK,YAAY,GAAG,KAAK,IAAI,EAAE;QAC/B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACjC,CAAC;QACD,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC;IAC9B,CAAC,CAAC;IAEF;;;OAGG;IACI,wBAAwB,GAAG,KAAK,EAAE,MAAgB,EAAuB,EAAE;QAChF,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3D,OAAO,MAAM,CAAC,MAAM,EAAE,CAAC;IACzB,CAAC,CAAC;IAEF;;;OAGG;IACI,oBAAoB,GAAG,KAAK,EAAE,KAAa,EAAqB,EAAE;QACvE,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC5C,MAAM,eAAe,GAAG,GAAG,iBAAiB,GAAG,KAAK,EAAE,CAAC;QACvD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,CAAC,eAAe,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QACtE,OAAO,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC,CAAC;IAEF;;;OAGG;IACI,gBAAgB,GAAG,KAAK,EAAE,MAAgB,EAAuB,EAAE;QACxE,OAAO,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC,CAAC;CACH;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/exports.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=exports.d.ts.map

package/dist/exports.d.ts.map

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

package/dist/exports.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=exports.js.map

package/dist/exports.js.map

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

package/dist/mcp/mcp.d.ts

@@ -0,0 +1,44 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { LLMConfig } from '#root/agent/agent.types.js';
+import type { BackendClient } from '#root/client/client.js';
+type McpServerOptions = {
+    /** Name of the MCP server */
+    name?: string;
+    /** Version of the MCP server */
+    version?: string;
+};
+type DocumentsMcpServerOptions = McpServerOptions & {
+    /** Backend client for accessing the documents service */
+    client: BackendClient;
+    /** Collections to limit searches to (optional, uses cwd and default collections if not specified) */
+    collections?: string[];
+    /** Optional map of project aliases to collection IDs */
+    aliasMap?: Map<string, string>;
+};
+type AgentMcpServerOptions = McpServerOptions & {
+    /** Backend client for accessing the documents service */
+    client: BackendClient;
+    /** LLM configuration for the agent */
+    llmConfig: LLMConfig;
+    /** Optional map of project aliases to collection IDs */
+    aliasMap?: Map<string, string>;
+    /** Maximum agent iterations */
+    maxIterations?: number;
+};
+/**
+ * Create an MCP server with document tools.
+ */
+declare const createDocumentsMcpServer: (options: DocumentsMcpServerOptions) => McpServer;
+/**
+ * Create an MCP server with agent mode (single ask_documents tool).
+ * The internal agent uses LLM to search and synthesize answers.
+ */
+declare const createAgentMcpServer: (options: AgentMcpServerOptions) => McpServer;
+/**
+ * Run an MCP server over stdio transport.
+ * This is the main entry point for running as a standalone MCP server.
+ */
+declare const runMcpServer: (server: McpServer) => Promise<void>;
+export { createAgentMcpServer, createDocumentsMcpServer, runMcpServer };
+export type { AgentMcpServerOptions, DocumentsMcpServerOptions, McpServerOptions };
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAK5D,KAAK,gBAAgB,GAAG;IACtB,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,KAAK,yBAAyB,GAAG,gBAAgB,GAAG;IAClD,yDAAyD;IACzD,MAAM,EAAE,aAAa,CAAC;IACtB,qGAAqG;IACrG,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC,CAAC;AAEF,KAAK,qBAAqB,GAAG,gBAAgB,GAAG;IAC9C,yDAAyD;IACzD,MAAM,EAAE,aAAa,CAAC;IACtB,sCAAsC;IACtC,SAAS,EAAE,SAAS,CAAC;IACrB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,+BAA+B;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;GAEG;AACH,QAAA,MAAM,wBAAwB,GAAI,SAAS,yBAAyB,cAanE,CAAC;AAEF;;;GAGG;AACH,QAAA,MAAM,oBAAoB,GAAI,SAAS,qBAAqB,cAsB3D,CAAC;AAEF;;;GAGG;AACH,QAAA,MAAM,YAAY,GAAU,QAAQ,SAAS,kBAc5C,CAAC;AAEF,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,YAAY,EAAE,CAAC;AACxE,YAAY,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,CAAC"}