@backendkit-labs/agent-enterprise 0.2.0

package/README.md

@@ -0,0 +1,185 @@
+# @backendkit-labs/agent-enterprise
+
+Enterprise knowledge layer for the BackendKit Agent Framework — local RAG over Obsidian vaults, shared knowledge vault with agent write-back, and pluggable embedders.
+
+```bash
+npm install @backendkit-labs/agent-enterprise
+```
+
+> Requires `@backendkit-labs/agent-core`. Works with any LLM provider — no cloud dependency required.
+
+---
+
+## What it does
+
+Gives your agents a **shared, persistent knowledge base** backed by Markdown files:
+
+- **Read** — agents search the vault semantically (`search_knowledge` tool)
+- **Write** — agents contribute new knowledge back to the vault (`write_knowledge` tool)
+- **Index** — incremental indexing by file mtime; only re-embeds new or modified files
+- **Human-readable** — the vault is plain Markdown, openable in Obsidian or any editor
+
+---
+
+## Quick start — RAG over an Obsidian vault
+
+```ts
+import { AgentEngine, ToolRegistry } from '@backendkit-labs/agent-core';
+import { ObsidianRAGProvider } from '@backendkit-labs/agent-enterprise';
+
+const rag = new ObsidianRAGProvider({
+  vaultPath:      '/path/to/your/vault',
+  ollamaHost:     'http://localhost:11434',  // default
+  embeddingModel: 'nomic-embed-text',        // default
+});
+
+// Index the vault (incremental — only changed files on subsequent runs)
+await rag.index({ verbose: true });
+
+// Register the search_knowledge tool with your engine
+const tools = new ToolRegistry();
+tools.register(rag.createTool());
+```
+
+The agent calls `search_knowledge` automatically when it needs information from the vault.
+
+---
+
+## Shared vault with agent write-back
+
+```ts
+import { ObsidianRAGProvider, VaultWriter } from '@backendkit-labs/agent-enterprise';
+
+const rag    = new ObsidianRAGProvider({ vaultPath: '/vault', ...opts });
+const writer = new VaultWriter({ vaultPath: '/vault' });
+
+const tools = new ToolRegistry();
+tools.register(rag.createTool());           // search_knowledge
+tools.register(writer.createTool('analyst')); // write_knowledge — baked in with agent id
+
+// After the agent writes a note, re-index to make it searchable:
+await rag.index();
+```
+
+Agent-written notes land in `<vaultPath>/agentes/` with standard frontmatter:
+
+```markdown
+---
+title: "Cache Decision for RAG Embeddings"
+author: "agent/analyst"
+date: 2026-06-10
+tags: ["área/rag", "tipo/decisión"]
+description: "LRU in-memory cache chosen over persistent or semantic cache"
+---
+
+## Context
+...
+```
+
+---
+
+## Custom embedder — no Ollama required
+
+Pass any object that implements `Embedder` to skip Ollama:
+
+```ts
+import { ObsidianRAGProvider, type Embedder } from '@backendkit-labs/agent-enterprise';
+
+class MyEmbedder implements Embedder {
+  readonly model = 'my-model-v1';
+  async embed(texts: string[]): Promise<number[][]> { /* ... */ }
+  async embedOne(text: string): Promise<number[]>   { /* ... */ }
+}
+
+const rag = new ObsidianRAGProvider({
+  vaultPath: '/vault',
+  embedder:  new MyEmbedder(),   // ollamaHost and embeddingModel are ignored
+});
+```
+
+---
+
+## SimpleEmbedder — local testing without Ollama
+
+For tests and CI where Ollama is not available:
+
+```ts
+// Not exported from the package — copy from pilot/src/embedders/SimpleEmbedder.ts
+// TF-IDF feature hashing, 256 dims, pure Node.js, zero dependencies
+const rag = new ObsidianRAGProvider({
+  vaultPath: '/vault',
+  embedder:  new SimpleEmbedder(),
+  minScore:  0.1,  // lower threshold for keyword-based vectors
+});
+```
+
+---
+
+## ObsidianRAGProvider options
+
+```ts
+new ObsidianRAGProvider({
+  vaultPath:      string;          // absolute path to vault directory
+  folders?:       string[];        // sub-folders to index (default: all)
+  indexPath?:     string;          // where to save the vector index JSON
+  embedder?:      Embedder;        // custom embedder (overrides ollamaHost/embeddingModel)
+  ollamaHost?:    string;          // default: http://localhost:11434
+  embeddingModel?: string;         // default: nomic-embed-text
+  topK?:          number;          // max results per search (default: 5)
+  minScore?:      number;          // min cosine similarity 0–1 (default: 0.3)
+  excludeTags?:   string[];        // frontmatter tags to skip (default: ['skill'])
+})
+```
+
+---
+
+## VaultWriter options
+
+```ts
+new VaultWriter({
+  vaultPath:    string;   // must match the ObsidianRAGProvider vaultPath
+  agentFolder?: string;   // sub-folder for agent notes (default: 'agentes')
+})
+
+writer.createTool(agentId: string): ToolDefinition
+// Returns write_knowledge tool with agentId baked into each note's author field
+```
+
+---
+
+## Vault structure
+
+Recommended layout for enterprise deployments:
+
+```
+vault/
+  rrhh/           ← HR domain — only HR Agent indexed here
+  ventas/         ← Sales domain
+  ops/            ← Operations
+  compartido/     ← Cross-domain, all agents read
+  agentes/        ← Auto-created — agent-written notes land here
+```
+
+Mount only the relevant folders per agent:
+
+```ts
+new ObsidianRAGProvider({ vaultPath, folders: ['ventas', 'compartido', 'agentes'] })
+```
+
+---
+
+## How indexing works
+
+1. `VaultIndexer` scans `.md` files and reads their `mtime`
+2. Compares against stored mtimes in `VectorStore`
+3. Only embeds files that are new or modified since last index
+4. Chunks each file by `##` headings (max 500 words per chunk)
+5. Stores vectors + metadata in a single JSON file on disk
+
+The JSON store scales to ~5–10k chunks. For larger vaults, use a proper vector DB (pgvector, Qdrant) with a custom `Embedder` adapter.
+
+---
+
+## License
+
+MIT © [BackendKit Labs](https://github.com/BackendKit-labs)

package/dist/__tests__/integration/ObsidianRAGProvider.test.d.ts

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

package/dist/__tests__/integration/ObsidianRAGProvider.test.d.ts.map

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

package/dist/__tests__/integration/ObsidianRAGProvider.test.js

@@ -0,0 +1,237 @@
+"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 ObsidianRAGProvider_1 = require("../../rag/ObsidianRAGProvider");
+const OLLAMA_HOST = process.env.OLLAMA_HOST ?? 'http://localhost:11434';
+const EMBED_MODEL = process.env.EMBEDDING_MODEL ?? 'nomic-embed-text';
+// ── Vault de fixtures ─────────────────────────────────────────────────────────
+const FIXTURES = {
+    'agentes-orquestacion.md': `---
+title: Orquestación de Agentes IA
+tags: [área/arquitectura, stack/typescript]
+description: Patrones para coordinar múltiples agentes especializados
+---
+
+## Patrón orquestador-especialista
+
+El orquestador recibe la tarea del usuario y la descompone en subtareas.
+Cada subtarea se delega a un agente especialista a través del tool ask_agent.
+Los especialistas devuelven su resultado al orquestador, que sintetiza la respuesta final.
+
+## Delegación paralela
+
+Cuando las subtareas son independientes entre sí, el orquestador puede lanzar
+múltiples ask_agent en el mismo turno. El engine ejecuta todas las delegaciones
+en paralelo, limitado por el bulkhead de 6 slots concurrentes.
+`,
+    'rag-vectorial.md': `---
+title: RAG con Vector Store Local
+tags: [área/ia, stack/typescript]
+description: Implementación de Retrieval Augmented Generation sin dependencias externas
+---
+
+## Embeddings con Ollama
+
+Los embeddings se generan usando el modelo nomic-embed-text de Ollama.
+La API es POST /api/embed con el texto y el nombre del modelo.
+El resultado es un vector de 768 dimensiones para nomic-embed-text.
+
+## Similitud coseno
+
+La búsqueda semántica compara el embedding de la consulta con los embeddings
+almacenados usando similitud coseno. El resultado más cercano a 1.0 es el más relevante.
+
+## Indexación incremental
+
+El VectorStore guarda el mtime de cada archivo. En el siguiente índice,
+solo se re-embeden los archivos nuevos o modificados.
+`,
+    'typescript-patterns.md': `---
+title: Patrones TypeScript en el Framework
+tags: [stack/typescript, área/arquitectura]
+description: Convenciones de código usadas en el proyecto
+---
+
+## Tipos estrictos
+
+El proyecto usa strict mode de TypeScript. Todos los parámetros opcionales
+deben declararse explícitamente. No se permite any sin justificación.
+
+## Inyección de dependencias
+
+Los providers se registran en ProviderRegistry y se resuelven por nombre.
+Esto permite intercambiar OllamaProvider por otros providers en tests.
+`,
+};
+// ── Helpers ───────────────────────────────────────────────────────────────────
+async function ollamaAvailable() {
+    try {
+        const res = await fetch(`${OLLAMA_HOST}/api/tags`, {
+            signal: AbortSignal.timeout(3000),
+        });
+        if (!res.ok)
+            return false;
+        const data = await res.json();
+        return (data.models ?? []).some(m => m.name.startsWith(EMBED_MODEL));
+    }
+    catch {
+        return false;
+    }
+}
+async function createFixtureVault(dir) {
+    for (const [name, content] of Object.entries(FIXTURES)) {
+        await fs.writeFile(path.join(dir, name), content, 'utf-8');
+    }
+}
+// ── Suite ─────────────────────────────────────────────────────────────────────
+describe('ObsidianRAGProvider — integración', () => {
+    let available = false;
+    let vaultDir;
+    let indexDir;
+    beforeAll(async () => {
+        available = await ollamaAvailable();
+        if (!available) {
+            console.warn(`\n⚠  ObsidianRAGProvider tests saltados — Ollama no disponible en ${OLLAMA_HOST} ` +
+                `o modelo '${EMBED_MODEL}' no descargado.\n` +
+                `   Para ejecutarlos: ollama serve && ollama pull ${EMBED_MODEL}\n`);
+            return;
+        }
+        const base = await fs.mkdtemp(path.join(os.tmpdir(), 'bk-rag-e2e-'));
+        vaultDir = path.join(base, 'vault');
+        indexDir = path.join(base, 'index');
+        await fs.mkdir(vaultDir);
+        await fs.mkdir(indexDir);
+        await createFixtureVault(vaultDir);
+    });
+    afterAll(async () => {
+        if (vaultDir) {
+            await fs.rm(path.dirname(vaultDir), { recursive: true, force: true });
+        }
+    });
+    test('index() indexa todos los archivos del vault fixture', async () => {
+        if (!available)
+            return;
+        const rag = new ObsidianRAGProvider_1.ObsidianRAGProvider({
+            vaultPath: vaultDir,
+            indexPath: path.join(indexDir, 'index.json'),
+            ollamaHost: OLLAMA_HOST,
+            embeddingModel: EMBED_MODEL,
+        });
+        const { indexed, removed } = await rag.index({ verbose: false });
+        expect(indexed).toBeGreaterThan(0); // al menos un chunk por archivo
+        expect(removed).toBe(0);
+        expect(rag.chunkCount).toBeGreaterThan(0);
+    });
+    test('index() incremental no re-indexa archivos sin cambios', async () => {
+        if (!available)
+            return;
+        const indexPath = path.join(indexDir, 'incremental.json');
+        const rag = new ObsidianRAGProvider_1.ObsidianRAGProvider({
+            vaultPath: vaultDir, indexPath, ollamaHost: OLLAMA_HOST, embeddingModel: EMBED_MODEL,
+        });
+        await rag.index(); // primera pasada — indexa todo
+        const rag2 = new ObsidianRAGProvider_1.ObsidianRAGProvider({
+            vaultPath: vaultDir, indexPath, ollamaHost: OLLAMA_HOST, embeddingModel: EMBED_MODEL,
+        });
+        const { indexed } = await rag2.index(); // segunda pasada — nada cambió
+        expect(indexed).toBe(0);
+    });
+    test('search devuelve el chunk más relevante para "orquestador"', async () => {
+        if (!available)
+            return;
+        const rag = new ObsidianRAGProvider_1.ObsidianRAGProvider({
+            vaultPath: vaultDir,
+            indexPath: path.join(indexDir, 'search-test.json'),
+            ollamaHost: OLLAMA_HOST,
+            embeddingModel: EMBED_MODEL,
+            topK: 3,
+            minScore: 0.1,
+        });
+        const result = await rag.search('patrón orquestador especialista delegación');
+        expect(result).toContain('orquestaci'); // título o contenido del archivo relevante
+        expect(result).not.toBe('No se encontró información relevante en la base de conocimiento para esa consulta.');
+    });
+    test('search devuelve mensaje de no-resultados para consulta sin match', async () => {
+        if (!available)
+            return;
+        const rag = new ObsidianRAGProvider_1.ObsidianRAGProvider({
+            vaultPath: vaultDir,
+            indexPath: path.join(indexDir, 'no-match.json'),
+            ollamaHost: OLLAMA_HOST,
+            embeddingModel: EMBED_MODEL,
+            minScore: 0.99, // umbral imposible de alcanzar
+        });
+        const result = await rag.search('xyzabcnonexistent987');
+        expect(result).toContain('No se encontró información relevante');
+    });
+    test('búsquedas sobre temas distintos devuelven fuentes distintas', async () => {
+        if (!available)
+            return;
+        const rag = new ObsidianRAGProvider_1.ObsidianRAGProvider({
+            vaultPath: vaultDir,
+            indexPath: path.join(indexDir, 'multi-topic.json'),
+            ollamaHost: OLLAMA_HOST,
+            embeddingModel: EMBED_MODEL,
+            topK: 1,
+            minScore: 0.1,
+        });
+        const resultOrq = await rag.search('orquestador y delegación de agentes');
+        const resultTS = await rag.search('strict mode TypeScript inyección dependencias');
+        // Los resultados top deben venir de archivos distintos
+        const titleOrq = resultOrq.match(/Fuente: ([^\n]+)/)?.[1] ?? '';
+        const titleTS = resultTS.match(/Fuente: ([^\n]+)/)?.[1] ?? '';
+        expect(titleOrq).not.toBe(titleTS);
+    });
+    test('createTool devuelve un ToolDefinition ejecutable', async () => {
+        if (!available)
+            return;
+        const rag = new ObsidianRAGProvider_1.ObsidianRAGProvider({
+            vaultPath: vaultDir,
+            indexPath: path.join(indexDir, 'tool-test.json'),
+            ollamaHost: OLLAMA_HOST,
+            embeddingModel: EMBED_MODEL,
+        });
+        const tool = rag.createTool();
+        expect(tool.name).toBe('search_knowledge');
+        expect(typeof tool.execute).toBe('function');
+        const result = await tool.execute({ query: 'embeddings vectoriales' }, {});
+        expect(typeof result).toBe('string');
+        expect(result.length).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=ObsidianRAGProvider.test.js.map

package/dist/__tests__/integration/ObsidianRAGProvider.test.js.map

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

package/dist/__tests__/integration/OllamaEmbedder.test.d.ts

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

package/dist/__tests__/integration/OllamaEmbedder.test.d.ts.map

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

package/dist/__tests__/integration/OllamaEmbedder.test.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const OllamaEmbedder_1 = require("../../rag/OllamaEmbedder");
+const OLLAMA_HOST = process.env.OLLAMA_HOST ?? 'http://localhost:11434';
+const EMBED_MODEL = process.env.EMBEDDING_MODEL ?? 'nomic-embed-text';
+async function ollamaAvailable() {
+    try {
+        const res = await fetch(`${OLLAMA_HOST}/api/tags`, {
+            signal: AbortSignal.timeout(3000),
+        });
+        return res.ok;
+    }
+    catch {
+        return false;
+    }
+}
+async function modelAvailable(model) {
+    try {
+        const res = await fetch(`${OLLAMA_HOST}/api/tags`);
+        const data = await res.json();
+        return (data.models ?? []).some(m => m.name.startsWith(model));
+    }
+    catch {
+        return false;
+    }
+}
+describe('OllamaEmbedder — integración', () => {
+    let available = false;
+    beforeAll(async () => {
+        available = await ollamaAvailable() && await modelAvailable(EMBED_MODEL);
+        if (!available) {
+            console.warn(`\n⚠  OllamaEmbedder tests saltados — Ollama no disponible en ${OLLAMA_HOST} ` +
+                `o modelo '${EMBED_MODEL}' no descargado.\n` +
+                `   Para ejecutarlos: ollama serve && ollama pull ${EMBED_MODEL}\n`);
+        }
+    });
+    test('checkConnection no lanza si Ollama está corriendo', async () => {
+        if (!available)
+            return;
+        const embedder = new OllamaEmbedder_1.OllamaEmbedder({ host: OLLAMA_HOST, model: EMBED_MODEL });
+        await expect(embedder.checkConnection()).resolves.not.toThrow();
+    });
+    test('embedOne devuelve un vector de la dimensión correcta (768 para nomic-embed-text)', async () => {
+        if (!available)
+            return;
+        const embedder = new OllamaEmbedder_1.OllamaEmbedder({ host: OLLAMA_HOST, model: EMBED_MODEL });
+        const vec = await embedder.embedOne('Hola mundo');
+        expect(Array.isArray(vec)).toBe(true);
+        expect(vec.length).toBeGreaterThan(0);
+        // nomic-embed-text produce vectores de 768 dimensiones
+        if (EMBED_MODEL === 'nomic-embed-text') {
+            expect(vec.length).toBe(768);
+        }
+    });
+    test('embed([]) devuelve array vacío sin llamar a Ollama', async () => {
+        // Este test no requiere Ollama — verifica el early-return
+        const embedder = new OllamaEmbedder_1.OllamaEmbedder({ host: OLLAMA_HOST, model: EMBED_MODEL });
+        const result = await embedder.embed([]);
+        expect(result).toEqual([]);
+    });
+    test('embed de un batch devuelve tantos vectores como textos', async () => {
+        if (!available)
+            return;
+        const embedder = new OllamaEmbedder_1.OllamaEmbedder({ host: OLLAMA_HOST, model: EMBED_MODEL });
+        const texts = ['primer texto', 'segundo texto', 'tercer texto'];
+        const vecs = await embedder.embed(texts);
+        expect(vecs).toHaveLength(3);
+        for (const v of vecs) {
+            expect(v.length).toBeGreaterThan(0);
+        }
+    });
+    test('textos similares tienen mayor similitud coseno que textos no relacionados', async () => {
+        if (!available)
+            return;
+        const embedder = new OllamaEmbedder_1.OllamaEmbedder({ host: OLLAMA_HOST, model: EMBED_MODEL });
+        const [vBase, vSimilar, vUnrelated] = await embedder.embed([
+            'orquestación de agentes IA',
+            'coordinación de múltiples agentes inteligentes',
+            'receta de paella valenciana',
+        ]);
+        const cosine = (a, b) => {
+            let dot = 0, na = 0, nb = 0;
+            for (let i = 0; i < a.length; i++) {
+                dot += a[i] * b[i];
+                na += a[i] ** 2;
+                nb += b[i] ** 2;
+            }
+            return dot / (Math.sqrt(na) * Math.sqrt(nb));
+        };
+        const simSimilar = cosine(vBase, vSimilar);
+        const simUnrelated = cosine(vBase, vUnrelated);
+        expect(simSimilar).toBeGreaterThan(simUnrelated);
+    });
+    test('lanza error descriptivo si el modelo no existe', async () => {
+        if (!available)
+            return;
+        const embedder = new OllamaEmbedder_1.OllamaEmbedder({ host: OLLAMA_HOST, model: 'modelo-inexistente-xyz' });
+        await expect(embedder.embedOne('test')).rejects.toThrow(/modelo-inexistente-xyz/i);
+    });
+});
+//# sourceMappingURL=OllamaEmbedder.test.js.map

package/dist/__tests__/integration/OllamaEmbedder.test.js.map

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

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

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

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

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