@backendkit-labs/agent-enterprise 0.2.0

package/dist/rag/OllamaEmbedder.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OllamaEmbedder = exports.OLLAMA_EMBED_DEFAULT_HOST = exports.OLLAMA_EMBED_DEFAULT_MODEL = void 0;
+exports.OLLAMA_EMBED_DEFAULT_MODEL = 'nomic-embed-text';
+exports.OLLAMA_EMBED_DEFAULT_HOST = 'http://localhost:11434';
+class OllamaEmbedder {
+    host;
+    model;
+    constructor(opts = {}) {
+        this.host = (opts.host ?? exports.OLLAMA_EMBED_DEFAULT_HOST).replace(/\/$/, '');
+        this.model = opts.model ?? exports.OLLAMA_EMBED_DEFAULT_MODEL;
+    }
+    async embed(texts) {
+        if (texts.length === 0)
+            return [];
+        const res = await fetch(`${this.host}/api/embed`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ model: this.model, input: texts }),
+        });
+        if (!res.ok) {
+            const body = await res.text().catch(() => '');
+            if (res.status === 404) {
+                throw new Error(`Modelo de embeddings '${this.model}' no encontrado en Ollama. ` +
+                    `Descárgalo con: ollama pull ${this.model}`);
+            }
+            throw new Error(`Ollama /api/embed error ${res.status}: ${body}`);
+        }
+        const data = await res.json();
+        return data.embeddings;
+    }
+    async embedOne(text) {
+        const results = await this.embed([text]);
+        return results[0] ?? [];
+    }
+    async checkConnection() {
+        try {
+            const res = await fetch(`${this.host}/api/tags`);
+            if (!res.ok)
+                throw new Error(`Status ${res.status}`);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new Error(`No se puede conectar a Ollama en ${this.host}: ${msg}\n` +
+                `Asegúrate de que Ollama esté corriendo con: ollama serve`);
+        }
+    }
+}
+exports.OllamaEmbedder = OllamaEmbedder;
+//# sourceMappingURL=OllamaEmbedder.js.map

package/dist/rag/OllamaEmbedder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OllamaEmbedder.js","sourceRoot":"","sources":["../../src/rag/OllamaEmbedder.ts"],"names":[],"mappings":";;;AAAa,QAAA,0BAA0B,GAAG,kBAAkB,CAAC;AAChD,QAAA,yBAAyB,GAAG,wBAAwB,CAAC;AAWlE,MAAa,cAAc;IACN,IAAI,CAAS;IACrB,KAAK,CAAS;IAEvB,YAAY,OAA8B,EAAE;QACxC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,iCAAyB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACxE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,kCAA0B,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAe;QACvB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAElC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,YAAY,EAAE;YAC9C,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;SAC5D,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACV,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YAC9C,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBACrB,MAAM,IAAI,KAAK,CACX,yBAAyB,IAAI,CAAC,KAAK,6BAA6B;oBAChE,+BAA+B,IAAI,CAAC,KAAK,EAAE,CAC9C,CAAC;YACN,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC;QACtE,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAmB,CAAC;QAC/C,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAY;QACvB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACzC,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,eAAe;QACjB,IAAI,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,WAAW,CAAC,CAAC;YACjD,IAAI,CAAC,GAAG,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,UAAU,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,MAAM,IAAI,KAAK,CACX,oCAAoC,IAAI,CAAC,IAAI,KAAK,GAAG,IAAI;gBACzD,0DAA0D,CAC7D,CAAC;QACN,CAAC;IACL,CAAC;CACJ;AAlDD,wCAkDC"}

package/dist/rag/VaultIndexer.d.ts

@@ -0,0 +1,34 @@
+import type { VectorChunk } from './VectorStore';
+export interface RawChunk {
+    filePath: string;
+    mtime: number;
+    title: string;
+    section: string;
+    text: string;
+    tags: string[];
+    description: string;
+}
+export interface IndexerOptions {
+    vaultPath: string;
+    /** Subcarpetas a incluir. Si está vacío, escanea todo el vault. */
+    folders?: string[];
+    /** Tags del frontmatter a excluir (ej. 'skill' para no duplicar con ObsidianProvider). */
+    excludeTags?: string[];
+    /** Archivos a excluir por nombre (ej. 'MEMORY.md'). */
+    excludeFiles?: string[];
+}
+export declare class VaultIndexer {
+    private readonly opts;
+    constructor(opts: IndexerOptions);
+    getChangedFiles(knownMtimes: Map<string, number>): Promise<{
+        toIndex: Array<{
+            filePath: string;
+            mtime: number;
+        }>;
+        toRemove: string[];
+    }>;
+    buildChunks(filePath: string, mtime: number): Promise<RawChunk[]>;
+    private scanVault;
+    toVectorChunk(raw: RawChunk, embedding: number[]): VectorChunk;
+}
+//# sourceMappingURL=VaultIndexer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"VaultIndexer.d.ts","sourceRoot":"","sources":["../../src/rag/VaultIndexer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAYjD,MAAM,WAAW,QAAQ;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACvB;AAmGD,MAAM,WAAW,cAAc;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,0FAA0F;IAC1F,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA2B;gBAEpC,IAAI,EAAE,cAAc;IAS1B,eAAe,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC;QAC7D,OAAO,EAAE,KAAK,CAAC;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACpD,QAAQ,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;IAcI,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;YAiCzD,SAAS;IAqBvB,aAAa,CAAC,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,WAAW;CAiBjE"}

package/dist/rag/VaultIndexer.js

@@ -0,0 +1,230 @@
+"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.VaultIndexer = void 0;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const yaml = __importStar(require("yaml"));
+const crypto_1 = require("crypto");
+const MAX_WORDS_PER_CHUNK = 500;
+function parseFrontmatter(content) {
+    const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
+    if (!match)
+        return { meta: {}, body: content };
+    try {
+        const meta = yaml.parse(match[1]) ?? {};
+        return { meta, body: match[2] ?? '' };
+    }
+    catch {
+        return { meta: {}, body: content };
+    }
+}
+function normalizeTags(raw) {
+    if (!Array.isArray(raw))
+        return raw ? [raw] : [];
+    return raw.map(String);
+}
+function extractArea(tags) {
+    return tags.find(t => t.startsWith('área/'))?.replace('área/', '');
+}
+function extractStack(tags) {
+    return tags.find(t => t.startsWith('stack/'))?.replace('stack/', '');
+}
+function wordCount(text) {
+    return text.split(/\s+/).filter(Boolean).length;
+}
+function splitByParagraph(text, maxWords) {
+    const paragraphs = text.split(/\n{2,}/);
+    const chunks = [];
+    let current = '';
+    for (const para of paragraphs) {
+        const candidate = current ? `${current}\n\n${para}` : para;
+        if (wordCount(candidate) > maxWords && current) {
+            chunks.push(current.trim());
+            current = para;
+        }
+        else {
+            current = candidate;
+        }
+    }
+    if (current.trim())
+        chunks.push(current.trim());
+    return chunks.filter(c => c.length > 0);
+}
+function chunkBody(body) {
+    const lines = body.split('\n');
+    const sections = [];
+    let current = { heading: '', lines: [] };
+    for (const line of lines) {
+        const h2Match = line.match(/^##\s+(.+)/);
+        if (h2Match) {
+            if (current.lines.join('\n').trim())
+                sections.push(current);
+            current = { heading: h2Match[1].trim(), lines: [] };
+        }
+        else {
+            current.lines.push(line);
+        }
+    }
+    if (current.lines.join('\n').trim())
+        sections.push(current);
+    const result = [];
+    for (const sec of sections) {
+        const text = sec.lines.join('\n').trim();
+        if (!text)
+            continue;
+        if (wordCount(text) <= MAX_WORDS_PER_CHUNK) {
+            result.push({ section: sec.heading, text });
+        }
+        else {
+            const subChunks = splitByParagraph(text, MAX_WORDS_PER_CHUNK);
+            subChunks.forEach((sub, i) => result.push({ section: sec.heading ? `${sec.heading} (${i + 1})` : `parte ${i + 1}`, text: sub }));
+        }
+    }
+    return result;
+}
+async function collectMdFiles(dir) {
+    let result = [];
+    let entries;
+    try {
+        entries = await fs.readdir(dir, { withFileTypes: true, encoding: 'utf8' });
+    }
+    catch {
+        return [];
+    }
+    for (const entry of entries) {
+        if (entry.name.startsWith('.'))
+            continue;
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            result = result.concat(await collectMdFiles(fullPath));
+        }
+        else if (entry.isFile() && entry.name.endsWith('.md')) {
+            result.push(fullPath);
+        }
+    }
+    return result;
+}
+class VaultIndexer {
+    opts;
+    constructor(opts) {
+        this.opts = {
+            vaultPath: opts.vaultPath,
+            folders: opts.folders ?? [],
+            excludeTags: opts.excludeTags ?? ['skill'],
+            excludeFiles: opts.excludeFiles ?? [],
+        };
+    }
+    async getChangedFiles(knownMtimes) {
+        const allFiles = await this.scanVault();
+        const currentPaths = new Set(allFiles.map(f => f.filePath));
+        const toIndex = allFiles.filter(f => {
+            const known = knownMtimes.get(f.filePath);
+            return known === undefined || known < f.mtime;
+        });
+        const toRemove = [...knownMtimes.keys()].filter(p => !currentPaths.has(p));
+        return { toIndex, toRemove };
+    }
+    async buildChunks(filePath, mtime) {
+        let content;
+        try {
+            content = await fs.readFile(filePath, 'utf-8');
+        }
+        catch {
+            return [];
+        }
+        const { meta, body } = parseFrontmatter(content);
+        const tags = normalizeTags(meta.tags);
+        if (this.opts.excludeTags.some(t => tags.includes(t)))
+            return [];
+        const title = meta.title ?? path.basename(filePath, '.md');
+        const description = meta.description ?? '';
+        const topicHints = Array.isArray(meta.semantic_topics)
+            ? `\n\nTopics: ${meta.semantic_topics.join(', ')}`
+            : '';
+        const sections = chunkBody(body + topicHints);
+        if (sections.length === 0)
+            return [];
+        return sections.map(sec => ({
+            filePath,
+            mtime,
+            title,
+            section: sec.section,
+            text: `${title}${sec.section ? ` — ${sec.section}` : ''}\n\n${sec.text}`,
+            tags,
+            description,
+        }));
+    }
+    async scanVault() {
+        const scanDirs = this.opts.folders.length > 0
+            ? this.opts.folders.map(f => path.join(this.opts.vaultPath, f))
+            : [this.opts.vaultPath];
+        const allFiles = [];
+        for (const dir of scanDirs) {
+            const mdFiles = await collectMdFiles(dir);
+            for (const filePath of mdFiles) {
+                if (this.opts.excludeFiles.some(ex => path.basename(filePath) === ex))
+                    continue;
+                try {
+                    const stat = await fs.stat(filePath);
+                    allFiles.push({ filePath, mtime: stat.mtimeMs });
+                }
+                catch {
+                    // archivo desapareció entre escaneo y stat
+                }
+            }
+        }
+        return allFiles;
+    }
+    toVectorChunk(raw, embedding) {
+        return {
+            id: (0, crypto_1.randomUUID)(),
+            filePath: raw.filePath,
+            title: raw.title,
+            section: raw.section,
+            text: raw.text,
+            embedding,
+            metadata: {
+                tags: raw.tags,
+                description: raw.description,
+                mtime: raw.mtime,
+                area: extractArea(raw.tags),
+                stack: extractStack(raw.tags),
+            },
+        };
+    }
+}
+exports.VaultIndexer = VaultIndexer;
+//# sourceMappingURL=VaultIndexer.js.map

package/dist/rag/VaultIndexer.js.map

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

package/dist/rag/VaultWriter.d.ts

@@ -0,0 +1,33 @@
+import type { ToolDefinition } from '@backendkit-labs/agent-core';
+export interface VaultWriterOptions {
+    /** Absolute path to the shared vault directory. */
+    vaultPath: string;
+    /** Sub-folder for agent-written notes. Default: 'agentes' */
+    agentFolder?: string;
+}
+export interface WriteNoteParams {
+    title: string;
+    content: string;
+    agentId: string;
+    tags?: string[];
+    description?: string;
+}
+/**
+ * Writes structured Markdown notes to a shared Obsidian vault.
+ *
+ * Notes use standard YAML frontmatter so the VaultIndexer picks them up
+ * on the next incremental index() call, making them immediately searchable
+ * by any agent or human that queries the vault.
+ */
+export declare class VaultWriter {
+    private readonly vaultPath;
+    private readonly agentFolder;
+    constructor(opts: VaultWriterOptions);
+    writeNote(params: WriteNoteParams): Promise<string>;
+    /**
+     * Returns a ToolDefinition ready to register with ToolRegistry.
+     * The agentId is baked in so audit trails show which agent wrote each note.
+     */
+    createTool(agentId: string): ToolDefinition;
+}
+//# sourceMappingURL=VaultWriter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"VaultWriter.d.ts","sourceRoot":"","sources":["../../src/rag/VaultWriter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,MAAM,WAAW,kBAAkB;IAC/B,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;GAMG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,IAAI,EAAE,kBAAkB;IAK9B,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAoCzD;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc;CA4B9C"}

package/dist/rag/VaultWriter.js

@@ -0,0 +1,112 @@
+"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.VaultWriter = void 0;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const agent_core_1 = require("@backendkit-labs/agent-core");
+/**
+ * Writes structured Markdown notes to a shared Obsidian vault.
+ *
+ * Notes use standard YAML frontmatter so the VaultIndexer picks them up
+ * on the next incremental index() call, making them immediately searchable
+ * by any agent or human that queries the vault.
+ */
+class VaultWriter {
+    vaultPath;
+    agentFolder;
+    constructor(opts) {
+        this.vaultPath = opts.vaultPath;
+        this.agentFolder = opts.agentFolder ?? 'agentes';
+    }
+    async writeNote(params) {
+        const { title, content, agentId, tags = [], description = '' } = params;
+        const date = new Date().toISOString().slice(0, 10);
+        const slug = title
+            .toLowerCase()
+            .normalize('NFD')
+            .replace(/[̀-ͯ]/g, '')
+            .replace(/[^a-z0-9\s-]/g, '')
+            .trim()
+            .replace(/\s+/g, '-')
+            .slice(0, 60);
+        const filename = `${date}-${slug}.md`;
+        const dir = path.join(this.vaultPath, this.agentFolder);
+        await fs.mkdir(dir, { recursive: true });
+        const tagsLine = tags.length
+            ? `[${tags.map(t => `"${t}"`).join(', ')}]`
+            : '[]';
+        const lines = [
+            '---',
+            `title: "${title}"`,
+            `author: "agent/${agentId}"`,
+            `date: ${date}`,
+            `tags: ${tagsLine}`,
+        ];
+        if (description)
+            lines.push(`description: "${description}"`);
+        lines.push('---', '', content);
+        const filePath = path.join(dir, filename);
+        await fs.writeFile(filePath, lines.join('\n'), 'utf-8');
+        return filePath;
+    }
+    /**
+     * Returns a ToolDefinition ready to register with ToolRegistry.
+     * The agentId is baked in so audit trails show which agent wrote each note.
+     */
+    createTool(agentId) {
+        const self = this;
+        return (0, agent_core_1.defineTool)({
+            name: 'write_knowledge',
+            description: "Write a new note to the organization's shared knowledge vault. " +
+                'Use this to record findings, decisions, resolved problems, or any knowledge ' +
+                'worth sharing with other agents and team members. ' +
+                'Notes are indexed automatically and become searchable via search_knowledge.',
+            input: agent_core_1.z.object({
+                title: agent_core_1.z.string().describe('Short descriptive title for the note'),
+                content: agent_core_1.z.string().describe('Note body in Markdown. Use ## headings for sections. ' +
+                    'Be specific — this will be retrieved by semantic search.'),
+                tags: agent_core_1.z.array(agent_core_1.z.string()).default([]).describe('Domain tags, e.g. ["función/arquitectura", "stack/typescript", "área/rag"]'),
+                description: agent_core_1.z.string().optional().describe('One-line summary shown in search results'),
+            }),
+            execute: async ({ title, content, tags, description }) => {
+                const filePath = await self.writeNote({ title, content, agentId, tags, description });
+                return `Knowledge saved to vault: ${path.basename(filePath)}`;
+            },
+        });
+    }
+}
+exports.VaultWriter = VaultWriter;
+//# sourceMappingURL=VaultWriter.js.map

package/dist/rag/VaultWriter.js.map

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

package/dist/rag/VectorStore.d.ts

@@ -0,0 +1,36 @@
+export interface VectorChunk {
+    id: string;
+    filePath: string;
+    title: string;
+    section: string;
+    text: string;
+    embedding: number[];
+    metadata: {
+        tags: string[];
+        description: string;
+        mtime: number;
+        area?: string;
+        stack?: string;
+    };
+}
+export interface SearchResult {
+    chunk: VectorChunk;
+    score: number;
+}
+export declare class VectorStore {
+    private chunks;
+    private readonly storePath;
+    private readonly embeddingModel;
+    private dirty;
+    constructor(storePath: string, embeddingModel: string);
+    load(): Promise<void>;
+    save(): Promise<void>;
+    /** Devuelve los mtime conocidos por filePath para detectar cambios. */
+    getKnownMtimes(): Map<string, number>;
+    /** Elimina todos los chunks de un archivo (para re-indexar). */
+    removeFile(filePath: string): void;
+    addChunks(newChunks: VectorChunk[]): void;
+    search(queryEmbedding: number[], topK: number): SearchResult[];
+    get size(): number;
+}
+//# sourceMappingURL=VectorStore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"VectorStore.d.ts","sourceRoot":"","sources":["../../src/rag/VectorStore.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE;QACN,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACL;AAmBD,MAAM,WAAW,YAAY;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,WAAW;IACpB,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,KAAK,CAAS;gBAEV,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM;IAK/C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAerB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B,uEAAuE;IACvE,cAAc,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAUrC,gEAAgE;IAChE,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAMlC,SAAS,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,IAAI;IAMzC,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE;IAO9D,IAAI,IAAI,IAAI,MAAM,CAEjB;CACJ"}

package/dist/rag/VectorStore.js

@@ -0,0 +1,119 @@
+"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.VectorStore = void 0;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+function cosineSimilarity(a, b) {
+    let dot = 0, normA = 0, normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    return denom === 0 ? 0 : dot / denom;
+}
+class VectorStore {
+    chunks = [];
+    storePath;
+    embeddingModel;
+    dirty = false;
+    constructor(storePath, embeddingModel) {
+        this.storePath = storePath;
+        this.embeddingModel = embeddingModel;
+    }
+    async load() {
+        try {
+            const raw = await fs.readFile(this.storePath, 'utf-8');
+            const data = JSON.parse(raw);
+            // Si el modelo de embeddings cambió, el índice no es compatible
+            if (data.embeddingModel !== this.embeddingModel) {
+                this.chunks = [];
+                return;
+            }
+            this.chunks = data.chunks;
+        }
+        catch {
+            this.chunks = [];
+        }
+    }
+    async save() {
+        if (!this.dirty)
+            return;
+        await fs.mkdir(path.dirname(this.storePath), { recursive: true });
+        const data = {
+            version: '1',
+            embeddingModel: this.embeddingModel,
+            chunks: this.chunks,
+        };
+        await fs.writeFile(this.storePath, JSON.stringify(data), 'utf-8');
+        this.dirty = false;
+    }
+    /** Devuelve los mtime conocidos por filePath para detectar cambios. */
+    getKnownMtimes() {
+        const map = new Map();
+        for (const chunk of this.chunks) {
+            if (!map.has(chunk.filePath)) {
+                map.set(chunk.filePath, chunk.metadata.mtime);
+            }
+        }
+        return map;
+    }
+    /** Elimina todos los chunks de un archivo (para re-indexar). */
+    removeFile(filePath) {
+        const before = this.chunks.length;
+        this.chunks = this.chunks.filter(c => c.filePath !== filePath);
+        if (this.chunks.length !== before)
+            this.dirty = true;
+    }
+    addChunks(newChunks) {
+        if (newChunks.length === 0)
+            return;
+        this.chunks.push(...newChunks);
+        this.dirty = true;
+    }
+    search(queryEmbedding, topK) {
+        return this.chunks
+            .map(chunk => ({ chunk, score: cosineSimilarity(queryEmbedding, chunk.embedding) }))
+            .sort((a, b) => b.score - a.score)
+            .slice(0, topK);
+    }
+    get size() {
+        return this.chunks.length;
+    }
+}
+exports.VectorStore = VectorStore;
+//# sourceMappingURL=VectorStore.js.map

package/dist/rag/VectorStore.js.map

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