@backendkit-labs/agent-enterprise 0.2.0

package/dist/__tests__/unit/VaultIndexer.test.js

@@ -0,0 +1,174 @@
+"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 });
+const fs = __importStar(require("fs/promises"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const VaultIndexer_1 = require("../../rag/VaultIndexer");
+async function writeFixture(dir, name, content) {
+    const filePath = path.join(dir, name);
+    await fs.writeFile(filePath, content, 'utf-8');
+    return filePath;
+}
+describe('VaultIndexer — unit', () => {
+    let tmpDir;
+    beforeAll(async () => {
+        tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'bk-vault-test-'));
+    });
+    afterAll(async () => {
+        await fs.rm(tmpDir, { recursive: true, force: true });
+    });
+    // ── buildChunks ──────────────────────────────────────────────────────────
+    test('extrae título del frontmatter', async () => {
+        const fp = await writeFixture(tmpDir, 'title-test.md', `---
+title: Mi Documento
+tags: [área/backend]
+---
+
+Contenido sin secciones.
+`);
+        const indexer = new VaultIndexer_1.VaultIndexer({ vaultPath: tmpDir });
+        const chunks = await indexer.buildChunks(fp, 1000);
+        expect(chunks[0].title).toBe('Mi Documento');
+    });
+    test('usa nombre de archivo si no hay title en frontmatter', async () => {
+        const fp = await writeFixture(tmpDir, 'sin-titulo.md', `Contenido simple.`);
+        const indexer = new VaultIndexer_1.VaultIndexer({ vaultPath: tmpDir });
+        const chunks = await indexer.buildChunks(fp, 1000);
+        expect(chunks[0].title).toBe('sin-titulo');
+    });
+    test('chunkea por headings ##', async () => {
+        const fp = await writeFixture(tmpDir, 'secciones.md', `---
+title: Doc con secciones
+---
+
+## Sección A
+
+Contenido de la sección A.
+
+## Sección B
+
+Contenido de la sección B.
+`);
+        const indexer = new VaultIndexer_1.VaultIndexer({ vaultPath: tmpDir });
+        const chunks = await indexer.buildChunks(fp, 1000);
+        expect(chunks).toHaveLength(2);
+        expect(chunks[0].section).toBe('Sección A');
+        expect(chunks[1].section).toBe('Sección B');
+    });
+    test('el texto del chunk incluye título y sección como prefijo', async () => {
+        const fp = await writeFixture(tmpDir, 'prefijo.md', `---
+title: Mi Nota
+---
+
+## Detalles
+
+Información importante.
+`);
+        const indexer = new VaultIndexer_1.VaultIndexer({ vaultPath: tmpDir });
+        const chunks = await indexer.buildChunks(fp, 1000);
+        expect(chunks[0].text).toMatch(/^Mi Nota — Detalles/);
+    });
+    test('excluye archivos con tag de exclusión', async () => {
+        const fp = await writeFixture(tmpDir, 'skill-file.md', `---
+tags: [skill]
+---
+
+Este es un skill, no debe indexarse.
+`);
+        const indexer = new VaultIndexer_1.VaultIndexer({ vaultPath: tmpDir, excludeTags: ['skill'] });
+        const chunks = await indexer.buildChunks(fp, 1000);
+        expect(chunks).toHaveLength(0);
+    });
+    test('cuerpo sin secciones produce un chunk con section vacía', async () => {
+        const fp = await writeFixture(tmpDir, 'sin-secciones.md', `---
+title: Flat
+---
+
+Un párrafo sin headings de nivel 2.
+`);
+        const indexer = new VaultIndexer_1.VaultIndexer({ vaultPath: tmpDir });
+        const chunks = await indexer.buildChunks(fp, 1000);
+        expect(chunks).toHaveLength(1);
+        expect(chunks[0].section).toBe('');
+    });
+    test('sección larga se divide en sub-chunks por párrafos', async () => {
+        const manyWords = Array.from({ length: 60 }, (_, i) => `palabra${i}`).join(' ');
+        const body = Array.from({ length: 12 }, () => manyWords).join('\n\n'); // ~720 palabras
+        const fp = await writeFixture(tmpDir, 'largo.md', `---
+title: Largo
+---
+
+## Sección grande
+
+${body}
+`);
+        const indexer = new VaultIndexer_1.VaultIndexer({ vaultPath: tmpDir });
+        const chunks = await indexer.buildChunks(fp, 1000);
+        expect(chunks.length).toBeGreaterThan(1);
+        expect(chunks[0].section).toMatch(/^Sección grande/);
+    });
+    // ── getChangedFiles ──────────────────────────────────────────────────────
+    test('archivos nuevos van a toIndex', async () => {
+        const subDir = path.join(tmpDir, 'changed-test');
+        await fs.mkdir(subDir, { recursive: true });
+        await writeFixture(subDir, 'nuevo.md', `# Nuevo\n\nContenido.`);
+        const indexer = new VaultIndexer_1.VaultIndexer({ vaultPath: subDir });
+        const { toIndex, toRemove } = await indexer.getChangedFiles(new Map());
+        expect(toIndex.some(f => f.filePath.endsWith('nuevo.md'))).toBe(true);
+        expect(toRemove).toHaveLength(0);
+    });
+    test('archivos eliminados van a toRemove', async () => {
+        const subDir = path.join(tmpDir, 'removed-test');
+        await fs.mkdir(subDir, { recursive: true });
+        const knownMtimes = new Map([
+            [path.join(subDir, 'fantasma.md'), 1000], // ya no existe
+        ]);
+        const indexer = new VaultIndexer_1.VaultIndexer({ vaultPath: subDir });
+        const { toRemove } = await indexer.getChangedFiles(knownMtimes);
+        expect(toRemove).toContain(path.join(subDir, 'fantasma.md'));
+    });
+    test('archivos sin cambios no van a toIndex', async () => {
+        const subDir = path.join(tmpDir, 'unchanged-test');
+        await fs.mkdir(subDir, { recursive: true });
+        const fp = await writeFixture(subDir, 'igual.md', `# Igual\n\nSin cambios.`);
+        const stat = await fs.stat(fp);
+        const knownMtimes = new Map([[fp, stat.mtimeMs]]);
+        const indexer = new VaultIndexer_1.VaultIndexer({ vaultPath: subDir });
+        const { toIndex } = await indexer.getChangedFiles(knownMtimes);
+        expect(toIndex.some(f => f.filePath === fp)).toBe(false);
+    });
+});
+//# sourceMappingURL=VaultIndexer.test.js.map

package/dist/__tests__/unit/VaultIndexer.test.js.map

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

package/dist/__tests__/unit/VectorStore.test.d.ts

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

package/dist/__tests__/unit/VectorStore.test.d.ts.map

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

package/dist/__tests__/unit/VectorStore.test.js

@@ -0,0 +1,146 @@
+"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 });
+const fs = __importStar(require("fs/promises"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const VectorStore_1 = require("../../rag/VectorStore");
+function makeChunk(id, filePath, embedding, mtime = 1000) {
+    return {
+        id,
+        filePath,
+        title: `Title ${id}`,
+        section: '',
+        text: `Text for chunk ${id}`,
+        embedding,
+        metadata: { tags: [], description: '', mtime },
+    };
+}
+describe('VectorStore — unit', () => {
+    let tmpDir;
+    let storePath;
+    beforeAll(async () => {
+        tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'bk-rag-test-'));
+        storePath = path.join(tmpDir, 'store.json');
+    });
+    afterAll(async () => {
+        await fs.rm(tmpDir, { recursive: true, force: true });
+    });
+    // ── in-memory operations ──────────────────────────────────────────────────
+    test('addChunks aumenta el tamaño', () => {
+        const store = new VectorStore_1.VectorStore(storePath, 'test-model');
+        expect(store.size).toBe(0);
+        store.addChunks([makeChunk('a', '/doc1.md', [1, 0, 0])]);
+        expect(store.size).toBe(1);
+        store.addChunks([makeChunk('b', '/doc2.md', [0, 1, 0])]);
+        expect(store.size).toBe(2);
+    });
+    test('removeFile elimina todos los chunks del archivo', () => {
+        const store = new VectorStore_1.VectorStore(storePath, 'test-model');
+        store.addChunks([
+            makeChunk('c1', '/multi.md', [1, 0, 0]),
+            makeChunk('c2', '/multi.md', [0, 1, 0]),
+            makeChunk('c3', '/other.md', [0, 0, 1]),
+        ]);
+        store.removeFile('/multi.md');
+        expect(store.size).toBe(1);
+    });
+    test('getKnownMtimes devuelve un entry por filePath', () => {
+        const store = new VectorStore_1.VectorStore(storePath, 'test-model');
+        store.addChunks([
+            makeChunk('m1', '/a.md', [1, 0], 1000),
+            makeChunk('m2', '/a.md', [0, 1], 1000), // mismo archivo, mismo mtime
+            makeChunk('m3', '/b.md', [1, 1], 2000),
+        ]);
+        const mtimes = store.getKnownMtimes();
+        expect(mtimes.size).toBe(2);
+        expect(mtimes.get('/a.md')).toBe(1000);
+        expect(mtimes.get('/b.md')).toBe(2000);
+    });
+    test('search devuelve resultados ordenados por similitud descendente', () => {
+        const store = new VectorStore_1.VectorStore(storePath, 'test-model');
+        // Vector base [1, 0, 0]: chunks más cercanos primero
+        store.addChunks([
+            makeChunk('s1', '/a.md', [1, 0, 0]), // idéntico → score 1.0
+            makeChunk('s2', '/b.md', [0, 1, 0]), // ortogonal → score 0.0
+            makeChunk('s3', '/c.md', [0.9, 0.1, 0]), // parecido → score ~0.99
+        ]);
+        const query = [1, 0, 0];
+        const results = store.search(query, 3);
+        expect(results[0].chunk.id).toBe('s1');
+        expect(results[1].chunk.id).toBe('s3');
+        expect(results[2].chunk.id).toBe('s2');
+        expect(results[0].score).toBeCloseTo(1.0, 4);
+        expect(results[2].score).toBeCloseTo(0.0, 4);
+    });
+    test('search respeta topK', () => {
+        const store = new VectorStore_1.VectorStore(storePath, 'test-model');
+        store.addChunks([
+            makeChunk('t1', '/a.md', [1, 0]),
+            makeChunk('t2', '/b.md', [0, 1]),
+            makeChunk('t3', '/c.md', [0.5, 0.5]),
+        ]);
+        const results = store.search([1, 0], 2);
+        expect(results).toHaveLength(2);
+    });
+    // ── persistencia ─────────────────────────────────────────────────────────
+    test('save/load round-trip preserva chunks', async () => {
+        const sp = path.join(tmpDir, 'round-trip.json');
+        const store = new VectorStore_1.VectorStore(sp, 'nomic-embed-text');
+        store.addChunks([makeChunk('rt1', '/x.md', [1, 0, 0])]);
+        await store.save();
+        const loaded = new VectorStore_1.VectorStore(sp, 'nomic-embed-text');
+        await loaded.load();
+        expect(loaded.size).toBe(1);
+        const results = loaded.search([1, 0, 0], 1);
+        expect(results[0].chunk.id).toBe('rt1');
+    });
+    test('load con modelo diferente resetea el índice', async () => {
+        const sp = path.join(tmpDir, 'mismatch.json');
+        const storeA = new VectorStore_1.VectorStore(sp, 'model-a');
+        storeA.addChunks([makeChunk('mm1', '/y.md', [1, 0])]);
+        await storeA.save();
+        const storeB = new VectorStore_1.VectorStore(sp, 'model-b');
+        await storeB.load();
+        expect(storeB.size).toBe(0);
+    });
+    test('save no escribe a disco si no hay cambios', async () => {
+        const sp = path.join(tmpDir, 'no-write.json');
+        const store = new VectorStore_1.VectorStore(sp, 'test-model');
+        await store.save(); // dirty=false, no debe crear el archivo
+        await expect(fs.access(sp)).rejects.toThrow();
+    });
+});
+//# sourceMappingURL=VectorStore.test.js.map

package/dist/__tests__/unit/VectorStore.test.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { ObsidianRAGProvider } from './rag/ObsidianRAGProvider';
+export type { ObsidianRAGOptions, Embedder } from './rag/ObsidianRAGProvider';
+export { OllamaEmbedder, OLLAMA_EMBED_DEFAULT_HOST, OLLAMA_EMBED_DEFAULT_MODEL } from './rag/OllamaEmbedder';
+export type { OllamaEmbedderOptions } from './rag/OllamaEmbedder';
+export { VectorStore } from './rag/VectorStore';
+export type { VectorChunk, SearchResult } from './rag/VectorStore';
+export { VaultIndexer } from './rag/VaultIndexer';
+export type { IndexerOptions, RawChunk } from './rag/VaultIndexer';
+export { VaultWriter } from './rag/VaultWriter';
+export type { VaultWriterOptions, WriteNoteParams } from './rag/VaultWriter';
+//# 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,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,YAAY,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE9E,OAAO,EAAE,cAAc,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAC7G,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAElE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEnE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VaultWriter = exports.VaultIndexer = exports.VectorStore = exports.OLLAMA_EMBED_DEFAULT_MODEL = exports.OLLAMA_EMBED_DEFAULT_HOST = exports.OllamaEmbedder = exports.ObsidianRAGProvider = void 0;
+var ObsidianRAGProvider_1 = require("./rag/ObsidianRAGProvider");
+Object.defineProperty(exports, "ObsidianRAGProvider", { enumerable: true, get: function () { return ObsidianRAGProvider_1.ObsidianRAGProvider; } });
+var OllamaEmbedder_1 = require("./rag/OllamaEmbedder");
+Object.defineProperty(exports, "OllamaEmbedder", { enumerable: true, get: function () { return OllamaEmbedder_1.OllamaEmbedder; } });
+Object.defineProperty(exports, "OLLAMA_EMBED_DEFAULT_HOST", { enumerable: true, get: function () { return OllamaEmbedder_1.OLLAMA_EMBED_DEFAULT_HOST; } });
+Object.defineProperty(exports, "OLLAMA_EMBED_DEFAULT_MODEL", { enumerable: true, get: function () { return OllamaEmbedder_1.OLLAMA_EMBED_DEFAULT_MODEL; } });
+var VectorStore_1 = require("./rag/VectorStore");
+Object.defineProperty(exports, "VectorStore", { enumerable: true, get: function () { return VectorStore_1.VectorStore; } });
+var VaultIndexer_1 = require("./rag/VaultIndexer");
+Object.defineProperty(exports, "VaultIndexer", { enumerable: true, get: function () { return VaultIndexer_1.VaultIndexer; } });
+var VaultWriter_1 = require("./rag/VaultWriter");
+Object.defineProperty(exports, "VaultWriter", { enumerable: true, get: function () { return VaultWriter_1.VaultWriter; } });
+//# 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,iEAAgE;AAAvD,0HAAA,mBAAmB,OAAA;AAG5B,uDAA6G;AAApG,gHAAA,cAAc,OAAA;AAAE,2HAAA,yBAAyB,OAAA;AAAE,4HAAA,0BAA0B,OAAA;AAG9E,iDAAgD;AAAvC,0GAAA,WAAW,OAAA;AAGpB,mDAAkD;AAAzC,4GAAA,YAAY,OAAA;AAGrB,iDAAgD;AAAvC,0GAAA,WAAW,OAAA"}

package/dist/rag/ObsidianRAGProvider.d.ts

@@ -0,0 +1,52 @@
+import type { ToolDefinition } from '@backendkit-labs/agent-core';
+/** Minimal interface any embedder must satisfy. */
+export interface Embedder {
+    readonly model: string;
+    embed(texts: string[]): Promise<number[][]>;
+    embedOne(text: string): Promise<number[]>;
+}
+export interface ObsidianRAGOptions {
+    /** Ruta absoluta al vault de Obsidian. */
+    vaultPath: string;
+    /** Subcarpetas a indexar. Si está vacío, indexa todo el vault. */
+    folders?: string[];
+    /** Dónde guardar el índice vectorial. Default: ~/.bk-agent/rag/<vault-name>.json */
+    indexPath?: string;
+    /** Custom embedder. When provided, ollamaHost and embeddingModel are ignored. */
+    embedder?: Embedder;
+    /** Host de Ollama para embeddings. Default: http://localhost:11434 */
+    ollamaHost?: string;
+    /** Modelo de embeddings. Default: nomic-embed-text */
+    embeddingModel?: string;
+    /** Resultados máximos por búsqueda. Default: 5 */
+    topK?: number;
+    /** Score mínimo de similitud para incluir un resultado (0-1). Default: 0.3 */
+    minScore?: number;
+    /** Tags del frontmatter a excluir de la indexación. Default: ['skill'] */
+    excludeTags?: string[];
+}
+export declare class ObsidianRAGProvider {
+    private readonly embedder;
+    private readonly store;
+    private readonly indexer;
+    private readonly topK;
+    private readonly minScore;
+    private indexed;
+    constructor(opts: ObsidianRAGOptions);
+    /**
+     * Indexa el vault de forma incremental.
+     * Solo re-embede archivos nuevos o modificados desde la última indexación.
+     */
+    index(opts?: {
+        verbose?: boolean;
+    }): Promise<{
+        indexed: number;
+        removed: number;
+    }>;
+    /** Busca en el vault usando similitud semántica. */
+    search(query: string, topK?: number): Promise<string>;
+    /** Devuelve el tool search_knowledge listo para registrar en ToolRegistry. */
+    createTool(): ToolDefinition;
+    get chunkCount(): number;
+}
+//# sourceMappingURL=ObsidianRAGProvider.d.ts.map

package/dist/rag/ObsidianRAGProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObsidianRAGProvider.d.ts","sourceRoot":"","sources":["../../src/rag/ObsidianRAGProvider.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAKlE,mDAAmD;AACnD,MAAM,WAAW,QAAQ;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,kBAAkB;IAC/B,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAID,qBAAa,mBAAmB;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,OAAO,CAAS;gBAEZ,IAAI,EAAE,kBAAkB;IA2BpC;;;OAGG;IACG,KAAK,CAAC,IAAI,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAwC5F,oDAAoD;IAC9C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA2B3D,8EAA8E;IAC9E,UAAU,IAAI,cAAc;IAkB5B,IAAI,UAAU,IAAI,MAAM,CAEvB;CACJ"}

package/dist/rag/ObsidianRAGProvider.js

@@ -0,0 +1,148 @@
+"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.ObsidianRAGProvider = void 0;
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const agent_core_1 = require("@backendkit-labs/agent-core");
+const OllamaEmbedder_1 = require("./OllamaEmbedder");
+const VectorStore_1 = require("./VectorStore");
+const VaultIndexer_1 = require("./VaultIndexer");
+const BATCH_SIZE = 10;
+class ObsidianRAGProvider {
+    embedder;
+    store;
+    indexer;
+    topK;
+    minScore;
+    indexed = false;
+    constructor(opts) {
+        if (opts.embedder) {
+            this.embedder = opts.embedder;
+        }
+        else {
+            const host = opts.ollamaHost ?? OllamaEmbedder_1.OLLAMA_EMBED_DEFAULT_HOST;
+            const model = opts.embeddingModel ?? OllamaEmbedder_1.OLLAMA_EMBED_DEFAULT_MODEL;
+            this.embedder = new OllamaEmbedder_1.OllamaEmbedder({ host, model });
+        }
+        const defaultIndexPath = path.join(os.homedir(), '.bk-agent', 'rag', `${path.basename(opts.vaultPath)}.json`);
+        this.store = new VectorStore_1.VectorStore(opts.indexPath ?? defaultIndexPath, this.embedder.model);
+        this.indexer = new VaultIndexer_1.VaultIndexer({
+            vaultPath: opts.vaultPath,
+            folders: opts.folders,
+            excludeTags: opts.excludeTags ?? ['skill'],
+        });
+        this.topK = opts.topK ?? 5;
+        this.minScore = opts.minScore ?? 0.3;
+    }
+    /**
+     * Indexa el vault de forma incremental.
+     * Solo re-embede archivos nuevos o modificados desde la última indexación.
+     */
+    async index(opts = {}) {
+        await this.store.load();
+        const knownMtimes = this.store.getKnownMtimes();
+        const { toIndex, toRemove } = await this.indexer.getChangedFiles(knownMtimes);
+        for (const filePath of toRemove) {
+            this.store.removeFile(filePath);
+        }
+        let indexed = 0;
+        for (let i = 0; i < toIndex.length; i += BATCH_SIZE) {
+            const batch = toIndex.slice(i, i + BATCH_SIZE);
+            const rawChunksBatch = await Promise.all(batch.map(f => this.indexer.buildChunks(f.filePath, f.mtime)));
+            const allRaw = rawChunksBatch.flat();
+            if (allRaw.length === 0)
+                continue;
+            const embeddings = await this.embedder.embed(allRaw.map(c => c.text));
+            const vectorChunks = allRaw.map((raw, idx) => this.indexer.toVectorChunk(raw, embeddings[idx] ?? []));
+            for (const f of batch)
+                this.store.removeFile(f.filePath);
+            this.store.addChunks(vectorChunks);
+            indexed += vectorChunks.length;
+            if (opts.verbose) {
+                console.log(`[RAG] Indexados ${Math.min(i + BATCH_SIZE, toIndex.length)}/${toIndex.length} archivos`);
+            }
+        }
+        await this.store.save();
+        this.indexed = true;
+        return { indexed, removed: toRemove.length };
+    }
+    /** Busca en el vault usando similitud semántica. */
+    async search(query, topK) {
+        if (!this.indexed) {
+            await this.index();
+        }
+        const queryEmbedding = await this.embedder.embedOne(query);
+        const results = this.store.search(queryEmbedding, topK ?? this.topK);
+        const filtered = results.filter(r => r.score >= this.minScore);
+        if (filtered.length === 0) {
+            return 'No se encontró información relevante en la base de conocimiento para esa consulta.';
+        }
+        return filtered
+            .map((r, i) => {
+            const { chunk, score } = r;
+            const area = chunk.metadata.area ? ` | área: ${chunk.metadata.area}` : '';
+            const stack = chunk.metadata.stack ? ` | stack: ${chunk.metadata.stack}` : '';
+            return [
+                `--- Resultado ${i + 1} (relevancia: ${(score * 100).toFixed(0)}%${area}${stack}) ---`,
+                `Fuente: ${chunk.title}${chunk.section ? ` › ${chunk.section}` : ''}`,
+                chunk.text,
+            ].join('\n');
+        })
+            .join('\n\n');
+    }
+    /** Devuelve el tool search_knowledge listo para registrar en ToolRegistry. */
+    createTool() {
+        const self = this;
+        return (0, agent_core_1.defineTool)({
+            name: 'search_knowledge',
+            description: 'Busca información en la base de conocimiento de la empresa (vault de Obsidian). ' +
+                'Úsalo cuando necesites información específica del dominio, procesos, políticas o documentación interna.',
+            input: agent_core_1.z.object({
+                query: agent_core_1.z.string().describe('Pregunta o tema a buscar en lenguaje natural'),
+                top_k: agent_core_1.z.number().int().min(1).max(20).optional()
+                    .describe('Número máximo de resultados (default: 5)'),
+            }),
+            execute: async ({ query, top_k }) => {
+                return self.search(query, top_k);
+            },
+        });
+    }
+    get chunkCount() {
+        return this.store.size;
+    }
+}
+exports.ObsidianRAGProvider = ObsidianRAGProvider;
+//# sourceMappingURL=ObsidianRAGProvider.js.map

package/dist/rag/ObsidianRAGProvider.js.map

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

package/dist/rag/OllamaEmbedder.d.ts

@@ -0,0 +1,15 @@
+export declare const OLLAMA_EMBED_DEFAULT_MODEL = "nomic-embed-text";
+export declare const OLLAMA_EMBED_DEFAULT_HOST = "http://localhost:11434";
+export interface OllamaEmbedderOptions {
+    host?: string;
+    model?: string;
+}
+export declare class OllamaEmbedder {
+    private readonly host;
+    readonly model: string;
+    constructor(opts?: OllamaEmbedderOptions);
+    embed(texts: string[]): Promise<number[][]>;
+    embedOne(text: string): Promise<number[]>;
+    checkConnection(): Promise<void>;
+}
+//# sourceMappingURL=OllamaEmbedder.d.ts.map

package/dist/rag/OllamaEmbedder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OllamaEmbedder.d.ts","sourceRoot":"","sources":["../../src/rag/OllamaEmbedder.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,0BAA0B,qBAAqB,CAAC;AAC7D,eAAO,MAAM,yBAAyB,2BAA2B,CAAC;AAElE,MAAM,WAAW,qBAAqB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD,qBAAa,cAAc;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,IAAI,GAAE,qBAA0B;IAKtC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAwB3C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAKzC,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;CAYzC"}