@backendkit-labs/curator-codex-agent 0.2.0

package/dist/documentation-curator.js

@@ -0,0 +1,231 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocumentationCurator = void 0;
+const fs = __importStar(require("node:fs/promises"));
+const path = __importStar(require("node:path"));
+const zod_1 = require("zod");
+const DocumentationNoteSchema = zod_1.z.object({
+    type: zod_1.z.enum(['politica', 'decision', 'procedimiento', 'leccion', 'norma_externa']),
+    area: zod_1.z.enum(['rrhh', 'finanzas', 'operaciones', 'ventas', 'soporte', 'legal', 'calidad', 'general']),
+    title: zod_1.z.string().max(120),
+    resumen: zod_1.z.string().max(500),
+    content: zod_1.z.string(),
+    tags: zod_1.z.array(zod_1.z.string()),
+    vigente_desde: zod_1.z.string().optional(),
+    version: zod_1.z.number().optional(),
+    expires_at: zod_1.z.string().optional(),
+    decidido_por: zod_1.z.array(zod_1.z.string()).optional(),
+    aplica_a: zod_1.z.array(zod_1.z.string()).optional(),
+});
+const DocumentationResponseSchema = zod_1.z.object({
+    notes: zod_1.z.array(DocumentationNoteSchema),
+});
+const SYSTEM_PROMPT = `\
+You are a Knowledge Curator for an enterprise vault.
+Your task: analyze a document and extract structured knowledge notes.
+
+IMPORTANT: Return ONLY a valid JSON object — no markdown, no prose, no code fences.
+
+Schema (return exactly this shape):
+{
+  "notes": [
+    {
+      "type":         "politica" | "decision" | "procedimiento" | "leccion" | "norma_externa",
+      "area":         "rrhh" | "finanzas" | "operaciones" | "ventas" | "soporte" | "legal" | "calidad" | "general",
+      "title":        string,       // Specific and searchable. Max 120 chars.
+      "resumen":      string,       // 1-2 sentences DENSE with key terms, numbers, rules, names.
+      "content":      string,       // Markdown with ## sections. Extract facts, rules, actions.
+      "tags":         string[],     // e.g. ["área/rrhh", "tipo/politica", "estado/vigente"]
+      "vigente_desde": "YYYY-MM-DD" | undefined,
+      "version":      number | undefined,
+      "expires_at":   "YYYY-MM-DD" | undefined,
+      "decidido_por": string[] | undefined,
+      "aplica_a":     string[] | undefined
+    }
+  ]
+}
+
+Rules:
+- If the document covers multiple areas, create one note per area (max 5 total).
+- Each note must be self-contained.
+- "resumen" must contain all key searchable terms: amounts, dates, percentages, proper nouns.
+- "content" must use ## headings.
+- Documents in any language are valid. Output in the same language as the document.
+- If the document has no enterprise relevance, return { "notes": [] }.`;
+function slugify(title) {
+    return title
+        .toLowerCase()
+        .normalize('NFD')
+        .replace(/[̀-ͯ]/g, '')
+        .replace(/[^a-z0-9\s-]/g, '')
+        .trim()
+        .replace(/\s+/g, '-')
+        .slice(0, 60);
+}
+function buildFrontmatter(note, source, date) {
+    const tagsLine = `[${note.tags.map(t => `"${t}"`).join(', ')}]`;
+    const lines = [
+        '---',
+        `title: "${note.title.replace(/"/g, '\\"')}"`,
+        `area: ${note.area}`,
+        `tipo: ${note.type}`,
+        `resumen: "${note.resumen.replace(/"/g, '\\"')}"`,
+        `author: "agent/codex"`,
+        `date: ${date}`,
+        `source_ref: "${source}"`,
+        `tags: ${tagsLine}`,
+    ];
+    if (note.vigente_desde)
+        lines.push(`vigente_desde: ${note.vigente_desde}`);
+    if (note.version)
+        lines.push(`version: ${note.version}`);
+    if (note.expires_at)
+        lines.push(`expires_at: ${note.expires_at}`);
+    if (note.decidido_por?.length) {
+        lines.push(`decidido_por: [${note.decidido_por.map(d => `"${d}"`).join(', ')}]`);
+    }
+    if (note.aplica_a?.length) {
+        lines.push(`aplica_a: [${note.aplica_a.map(a => `"${a}"`).join(', ')}]`);
+    }
+    lines.push('---', '', note.content);
+    return lines.join('\n');
+}
+class DocumentationCurator {
+    provider;
+    vaultPath;
+    maxInputChars;
+    constructor(opts) {
+        this.provider = opts.provider;
+        this.vaultPath = opts.vaultPath;
+        this.maxInputChars = opts.maxInputChars ?? 12_000;
+    }
+    async curateText(text, source, areaHint) {
+        const start = Date.now();
+        const result = {
+            notesWritten: [],
+            notesSkipped: [],
+            errors: [],
+            durationMs: 0,
+        };
+        let parsed;
+        try {
+            parsed = await this.callLLM(text, source, areaHint);
+        }
+        catch (err) {
+            result.errors.push(`LLM call failed: ${err.message}`);
+            result.durationMs = Date.now() - start;
+            return result;
+        }
+        if (!parsed.notes.length) {
+            result.errors.push('LLM returned no notes — document may not have enterprise relevance.');
+            result.durationMs = Date.now() - start;
+            return result;
+        }
+        const date = new Date().toISOString().slice(0, 10);
+        for (const note of parsed.notes) {
+            try {
+                const written = await this.writeNote(note, source, date);
+                if (written === null) {
+                    result.notesSkipped.push(note.title);
+                }
+                else {
+                    result.notesWritten.push(written);
+                }
+            }
+            catch (err) {
+                result.errors.push(`Failed to write "${note.title}": ${err.message}`);
+            }
+        }
+        result.durationMs = Date.now() - start;
+        return result;
+    }
+    async curateFile(filePath, areaHint) {
+        let text;
+        try {
+            text = await fs.readFile(filePath, 'utf-8');
+        }
+        catch (err) {
+            return {
+                notesWritten: [],
+                notesSkipped: [],
+                errors: [`Cannot read file: ${err.message}`],
+                durationMs: 0,
+            };
+        }
+        const source = path.basename(filePath);
+        return await this.curateText(text, source, areaHint);
+    }
+    // ── Private ────────────────────────────────────────────────────────────────
+    async callLLM(text, source, areaHint) {
+        const truncated = text.slice(0, this.maxInputChars);
+        const hintLine = areaHint ? `\nArea hint: this document is primarily about "${areaHint}".` : '';
+        const userMsg = `Source: ${source}${hintLine}\n\nDocument:\n${truncated}`;
+        const raw = await this.provider.complete(SYSTEM_PROMPT, userMsg);
+        const jsonStr = raw.replace(/^```(?:json)?\s*/i, '').replace(/\s*```\s*$/, '').trim();
+        const sanitized = jsonStr.replace(/:\s*undefined/g, ': null');
+        const parsed = JSON.parse(sanitized);
+        if (Array.isArray(parsed?.notes)) {
+            for (const note of parsed.notes) {
+                if (typeof note.resumen === 'string' && note.resumen.length > 500) {
+                    note.resumen = note.resumen.slice(0, 497) + '…';
+                }
+                for (const key of ['vigente_desde', 'version', 'expires_at', 'decidido_por', 'aplica_a']) {
+                    if (note[key] === null)
+                        delete note[key];
+                }
+            }
+        }
+        return DocumentationResponseSchema.parse(parsed);
+    }
+    async writeNote(note, source, date) {
+        const dir = path.join(this.vaultPath, note.area);
+        const slug = slugify(note.title);
+        const filename = `${date}-${slug}.md`;
+        const filePath = path.join(dir, filename);
+        try {
+            await fs.access(filePath);
+            return null;
+        }
+        catch {
+            // doesn't exist — proceed
+        }
+        await fs.mkdir(dir, { recursive: true });
+        await fs.writeFile(filePath, buildFrontmatter(note, source, date), 'utf-8');
+        return filePath;
+    }
+}
+exports.DocumentationCurator = DocumentationCurator;
+//# sourceMappingURL=documentation-curator.js.map

package/dist/documentation-curator.js.map

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

package/dist/http-server-main.d.ts

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+/**
+ * curator-codex-http — HTTP server for unified curation + knowledge
+ *
+ * Required env vars:
+ *   CURATOR_API_KEY      — LLM API key
+ *   CURATOR_OUTPUT_PATH  — Vault path
+ *
+ * Optional:
+ *   CURATOR_INPUT_PATH   — Code/doc directory to curate
+ *   CURATOR_HTTP_PORT    — Server port (default: 3100)
+ *   CURATOR_PROVIDER     — LLM provider (default: deepseek)
+ *   CURATOR_MODEL        — LLM model (default: deepseek-reasoner)
+ *   CURATOR_BASE_URL     — Custom LLM base URL
+ *
+ * Usage:
+ *   npm run http-server
+ *   CURATOR_OUTPUT_PATH=/vault CURATOR_API_KEY=sk-... npm run http-server
+ *
+ * API Examples:
+ *   GET  http://localhost:3100/              # Info
+ *   GET  http://localhost:3100/status        # Status
+ *   GET  http://localhost:3100/curator/config
+ *   POST http://localhost:3100/curator/config
+ *   POST http://localhost:3100/curator/process
+ */
+import 'dotenv/config';
+//# sourceMappingURL=http-server-main.d.ts.map

package/dist/http-server-main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-server-main.d.ts","sourceRoot":"","sources":["../src/http-server-main.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,eAAe,CAAC"}

package/dist/http-server-main.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * curator-codex-http — HTTP server for unified curation + knowledge
+ *
+ * Required env vars:
+ *   CURATOR_API_KEY      — LLM API key
+ *   CURATOR_OUTPUT_PATH  — Vault path
+ *
+ * Optional:
+ *   CURATOR_INPUT_PATH   — Code/doc directory to curate
+ *   CURATOR_HTTP_PORT    — Server port (default: 3100)
+ *   CURATOR_PROVIDER     — LLM provider (default: deepseek)
+ *   CURATOR_MODEL        — LLM model (default: deepseek-reasoner)
+ *   CURATOR_BASE_URL     — Custom LLM base URL
+ *
+ * Usage:
+ *   npm run http-server
+ *   CURATOR_OUTPUT_PATH=/vault CURATOR_API_KEY=sk-... npm run http-server
+ *
+ * API Examples:
+ *   GET  http://localhost:3100/              # Info
+ *   GET  http://localhost:3100/status        # Status
+ *   GET  http://localhost:3100/curator/config
+ *   POST http://localhost:3100/curator/config
+ *   POST http://localhost:3100/curator/process
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+require("dotenv/config");
+const http_server_js_1 = require("./api/http-server.js");
+async function main() {
+    const outputPath = process.env.CURATOR_OUTPUT_PATH;
+    const port = process.env.CURATOR_HTTP_PORT ? parseInt(process.env.CURATOR_HTTP_PORT) : 3100;
+    if (!outputPath) {
+        console.error('✗ CURATOR_OUTPUT_PATH is required');
+        process.exit(1);
+    }
+    if (!process.env.CURATOR_API_KEY) {
+        console.error('✗ CURATOR_API_KEY is required');
+        process.exit(1);
+    }
+    const server = new http_server_js_1.CuratorHttpServer({
+        port,
+        apiConfig: {
+            inputPath: process.env.CURATOR_INPUT_PATH,
+            outputPath,
+            provider: process.env.CURATOR_PROVIDER,
+            model: process.env.CURATOR_MODEL,
+            baseUrl: process.env.CURATOR_BASE_URL,
+        },
+    });
+    await server.start();
+    // Graceful shutdown
+    process.on('SIGINT', async () => {
+        console.log('\n\n  Shutting down...');
+        await server.stop();
+        process.exit(0);
+    });
+    process.on('SIGTERM', async () => {
+        console.log('\n\n  Shutting down...');
+        await server.stop();
+        process.exit(0);
+    });
+}
+main().catch((err) => {
+    console.error('Fatal error:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=http-server-main.js.map

package/dist/http-server-main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-server-main.js","sourceRoot":"","sources":["../src/http-server-main.ts"],"names":[],"mappings":";;AACA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;;AAEH,yBAAuB;AACvB,yDAAyD;AAEzD,KAAK,UAAU,IAAI;IACf,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IACnD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAE5F,IAAI,CAAC,UAAU,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;QAC/B,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,kCAAiB,CAAC;QACjC,IAAI;QACJ,SAAS,EAAE;YACP,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB;YACzC,UAAU;YACV,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB;YACtC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa;YAChC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB;SACxC;KACJ,CAAC,CAAC;IAEH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IAErB,oBAAoB;IACpB,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;QAC5B,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;QACtC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;QAC7B,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;QACtC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;AACP,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACjB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export { CodeAnalyzer } from './analyzer.js';
+export { DocumentationCurator } from './documentation-curator.js';
+export type { CodeAnalysisNote, CodeAnalysisResult, FileAnalysisContext, AssociatedDocs } from './types.js';
+export { createProvider } from './providers/index.js';
+export type { CuratorLLMProvider } from './providers/types.js';
+export { OpenAIAdapter, AnthropicAdapter } from './providers/index.js';
+export { CuratorHttpServer } from './api/http-server.js';
+export { ConfigManager } from './api/config.js';
+export type { ApiConfig } from './api/config.js';
+export { CuratorRagProvider } from './knowledge/rag-provider.js';
+export type { RagSearchResult, RagSearchOptions } from './knowledge/rag-provider.js';
+export { KnowledgeSynthesizer } from './knowledge/synthesis.js';
+export type { SynthesizedNote } from './knowledge/synthesis.js';
+export { KnowledgeEngine } from './knowledge/engine.js';
+export type { SearchResponse, ReloadResponse } from './knowledge/engine.js';
+//# 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":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5G,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,YAAY,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KnowledgeEngine = exports.KnowledgeSynthesizer = exports.CuratorRagProvider = exports.ConfigManager = exports.CuratorHttpServer = exports.AnthropicAdapter = exports.OpenAIAdapter = exports.createProvider = exports.DocumentationCurator = exports.CodeAnalyzer = void 0;
+var analyzer_js_1 = require("./analyzer.js");
+Object.defineProperty(exports, "CodeAnalyzer", { enumerable: true, get: function () { return analyzer_js_1.CodeAnalyzer; } });
+var documentation_curator_js_1 = require("./documentation-curator.js");
+Object.defineProperty(exports, "DocumentationCurator", { enumerable: true, get: function () { return documentation_curator_js_1.DocumentationCurator; } });
+var index_js_1 = require("./providers/index.js");
+Object.defineProperty(exports, "createProvider", { enumerable: true, get: function () { return index_js_1.createProvider; } });
+var index_js_2 = require("./providers/index.js");
+Object.defineProperty(exports, "OpenAIAdapter", { enumerable: true, get: function () { return index_js_2.OpenAIAdapter; } });
+Object.defineProperty(exports, "AnthropicAdapter", { enumerable: true, get: function () { return index_js_2.AnthropicAdapter; } });
+var http_server_js_1 = require("./api/http-server.js");
+Object.defineProperty(exports, "CuratorHttpServer", { enumerable: true, get: function () { return http_server_js_1.CuratorHttpServer; } });
+var config_js_1 = require("./api/config.js");
+Object.defineProperty(exports, "ConfigManager", { enumerable: true, get: function () { return config_js_1.ConfigManager; } });
+var rag_provider_js_1 = require("./knowledge/rag-provider.js");
+Object.defineProperty(exports, "CuratorRagProvider", { enumerable: true, get: function () { return rag_provider_js_1.CuratorRagProvider; } });
+var synthesis_js_1 = require("./knowledge/synthesis.js");
+Object.defineProperty(exports, "KnowledgeSynthesizer", { enumerable: true, get: function () { return synthesis_js_1.KnowledgeSynthesizer; } });
+var engine_js_1 = require("./knowledge/engine.js");
+Object.defineProperty(exports, "KnowledgeEngine", { enumerable: true, get: function () { return engine_js_1.KnowledgeEngine; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,6CAA6C;AAApC,2GAAA,YAAY,OAAA;AACrB,uEAAkE;AAAzD,gIAAA,oBAAoB,OAAA;AAE7B,iDAAsD;AAA7C,0GAAA,cAAc,OAAA;AAEvB,iDAAuE;AAA9D,yGAAA,aAAa,OAAA;AAAE,4GAAA,gBAAgB,OAAA;AACxC,uDAAyD;AAAhD,mHAAA,iBAAiB,OAAA;AAC1B,6CAAgD;AAAvC,0GAAA,aAAa,OAAA;AAEtB,+DAAiE;AAAxD,qHAAA,kBAAkB,OAAA;AAE3B,yDAAgE;AAAvD,oHAAA,oBAAoB,OAAA;AAE7B,mDAAwD;AAA/C,4GAAA,eAAe,OAAA"}

package/dist/knowledge/engine.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Knowledge Engine
+ * Orchestrates RAG search, synthesis, and vault indexing
+ */
+import { type RagSearchResult } from './rag-provider.js';
+import type { CuratorLLMProvider } from '../providers/types.js';
+export interface SearchResponse {
+    query: string;
+    results: RagSearchResult[];
+    synthesized?: {
+        title: string;
+        content: string;
+        basedOn: string[];
+    };
+    totalResults: number;
+    durationMs: number;
+}
+export interface ReloadResponse {
+    indexed: number;
+    updated: number;
+    durationMs: number;
+}
+export declare class KnowledgeEngine {
+    private rag;
+    private synthesizer;
+    private isInitialized;
+    constructor(provider: CuratorLLMProvider, vaultPath: string);
+    /**
+     * Initialize the knowledge engine
+     */
+    initialize(): Promise<void>;
+    /**
+     * Search the vault
+     */
+    search(query: string, opts?: {
+        topK?: number;
+        autoSynthesize?: boolean;
+    }): Promise<SearchResponse>;
+    /**
+     * Reload and reindex the vault
+     */
+    reload(): Promise<ReloadResponse>;
+    /**
+     * Get engine statistics
+     */
+    getStats(): Promise<{
+        initialized: boolean;
+        vaultStats: any;
+    }>;
+    /**
+     * Create MCP tools for knowledge operations
+     */
+    createTools(): ({
+        name: string;
+        description: string;
+        inputSchema: {
+            type: string;
+            properties: {
+                query: {
+                    type: string;
+                    description: string;
+                };
+                topK: {
+                    type: string;
+                    description: string;
+                };
+                autoSynthesize: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: any) => Promise<string>;
+    } | {
+        name: string;
+        description: string;
+        inputSchema: {
+            type: string;
+            properties: {
+                query?: undefined;
+                topK?: undefined;
+                autoSynthesize?: undefined;
+            };
+            required: never[];
+        };
+        handler: () => Promise<string>;
+    })[];
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/knowledge/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/knowledge/engine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,MAAM,WAAW,cAAc;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,WAAW,CAAC,EAAE;QACV,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IACF,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,eAAe;IACxB,OAAO,CAAC,GAAG,CAAqB;IAChC,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,aAAa,CAAkB;gBAE3B,QAAQ,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM;IAK3D;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAUjC;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,cAAc,CAAC;IAsC5G;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;IAkBvC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC;QACtB,WAAW,EAAE,OAAO,CAAC;QACrB,UAAU,EAAE,GAAG,CAAC;KACnB,CAAC;IAOF;;OAEG;IACH,WAAW;;;;;;;;;;;;;;;;;;;;;wBAwBuB,GAAG;;;;;;;;;;;;;;;CAsDxC"}