@framers/agentos 0.1.101 → 0.1.102

package/dist/memory/ingestion/DoclingLoader.js

@@ -0,0 +1,228 @@
+/**
+ * @fileoverview DoclingLoader — high-fidelity PDF/DOCX extraction via Python Docling.
+ *
+ * Docling (https://github.com/DS4SD/docling) is an IBM Research open-source
+ * library that converts PDFs and office documents to structured JSON, preserving
+ * tables, figures, and layout information far beyond what pure-JS text extraction
+ * can achieve.
+ *
+ * This module provides a factory function {@link createDoclingLoader} that:
+ * 1. Checks whether `python3 -m docling --version` succeeds in the current PATH.
+ * 2. If it does, returns a {@link DoclingLoader} instance that spawns a
+ *    `python3 -m docling` subprocess for each document.
+ * 3. If Docling is not installed, returns `null` gracefully.
+ *
+ * ### Opting in
+ * ```sh
+ * pip install docling
+ * ```
+ *
+ * @module memory/ingestion/DoclingLoader
+ */
+import { spawn, spawnSync } from 'node:child_process';
+import path from 'node:path';
+import os from 'node:os';
+import fs from 'node:fs/promises';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Extensions this loader can handle (Docling supports PDF and DOCX). */
+const SUPPORTED_EXTENSIONS = ['.pdf', '.docx'];
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Returns the lower-cased extension (with dot) of a file path.
+ *
+ * @param filePath - Absolute or relative file path.
+ */
+function extOf(filePath) {
+    return path.extname(filePath).toLowerCase();
+}
+// ---------------------------------------------------------------------------
+// DoclingLoader (internal class)
+// ---------------------------------------------------------------------------
+/**
+ * High-fidelity document loader that delegates to a `python3 -m docling`
+ * subprocess.
+ *
+ * Consumers should use {@link createDoclingLoader} rather than constructing
+ * this class directly so that the Python availability check is always run
+ * before first use.
+ *
+ * @implements {IDocumentLoader}
+ */
+class DoclingLoader {
+    constructor() {
+        /** @inheritdoc */
+        this.supportedExtensions = [...SUPPORTED_EXTENSIONS];
+    }
+    // -------------------------------------------------------------------------
+    // canLoad
+    // -------------------------------------------------------------------------
+    /** @inheritdoc */
+    canLoad(source) {
+        if (Buffer.isBuffer(source)) {
+            // Without an extension we can't determine compatibility from bytes alone.
+            return false;
+        }
+        return SUPPORTED_EXTENSIONS.includes(extOf(source));
+    }
+    // -------------------------------------------------------------------------
+    // load
+    // -------------------------------------------------------------------------
+    /** @inheritdoc */
+    async load(source, _options) {
+        let filePath;
+        let tempFile = null;
+        if (Buffer.isBuffer(source)) {
+            // Write buffer to a temp file so Docling has a real path to read.
+            tempFile = path.join(os.tmpdir(), `docling-input-${Date.now()}.pdf`);
+            await fs.writeFile(tempFile, source);
+            filePath = tempFile;
+        }
+        else {
+            filePath = source;
+        }
+        try {
+            const jsonOutput = await this._runDocling(filePath);
+            return this._mapToLoadedDocument(jsonOutput, Buffer.isBuffer(source) ? undefined : source);
+        }
+        finally {
+            // Clean up any temp file we created.
+            if (tempFile !== null) {
+                await fs.unlink(tempFile).catch(() => { });
+            }
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Private: subprocess invocation
+    // -------------------------------------------------------------------------
+    /**
+     * Spawn `python3 -m docling --output-format json <filePath>` and collect
+     * stdout.
+     *
+     * @param filePath - Absolute path to the PDF or DOCX file.
+     * @returns Parsed Docling JSON output.
+     * @throws When the subprocess exits with a non-zero code or stdout is not
+     *         valid JSON.
+     */
+    async _runDocling(filePath) {
+        return new Promise((resolve, reject) => {
+            let stdout = '';
+            let stderr = '';
+            const proc = spawn('python3', ['-m', 'docling', '--output-format', 'json', filePath], {
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            proc.stdout.on('data', (chunk) => {
+                stdout += chunk.toString('utf8');
+            });
+            proc.stderr.on('data', (chunk) => {
+                stderr += chunk.toString('utf8');
+            });
+            proc.on('close', (code) => {
+                if (code !== 0) {
+                    reject(new Error(`DoclingLoader: python3 -m docling exited with code ${code}.\n${stderr.slice(0, 500)}`));
+                    return;
+                }
+                try {
+                    const parsed = JSON.parse(stdout);
+                    resolve(parsed);
+                }
+                catch (err) {
+                    reject(new Error(`DoclingLoader: failed to parse Docling JSON output: ${String(err)}\n` +
+                        `stdout (first 500 chars): ${stdout.slice(0, 500)}`));
+                }
+            });
+            proc.on('error', (err) => {
+                reject(new Error(`DoclingLoader: failed to spawn python3: ${err.message}`));
+            });
+        });
+    }
+    // -------------------------------------------------------------------------
+    // Private: JSON → LoadedDocument mapping
+    // -------------------------------------------------------------------------
+    /**
+     * Convert a Docling JSON output object to a {@link LoadedDocument}.
+     *
+     * Handles both the newer (`text` top-level string) and older
+     * (`pages[].text` array) Docling output shapes.
+     *
+     * @param json         - Parsed Docling JSON.
+     * @param resolvedPath - Original source path for the `source` metadata field.
+     */
+    _mapToLoadedDocument(json, resolvedPath) {
+        // Prefer top-level `text` (Docling v2+), fall back to concatenating pages.
+        let content;
+        if (typeof json['text'] === 'string') {
+            content = json['text'];
+        }
+        else if (Array.isArray(json['pages'])) {
+            content = json['pages']
+                .map((p) => (typeof p['text'] === 'string' ? p['text'] : ''))
+                .join('\n\n');
+        }
+        else {
+            content = '';
+        }
+        const rawMeta = json['metadata'] ?? {};
+        const pageCount = typeof rawMeta['pageCount'] === 'number' ? rawMeta['pageCount'] :
+            typeof rawMeta['page_count'] === 'number' ? rawMeta['page_count'] :
+                undefined;
+        const meta = {
+            ...(typeof rawMeta['title'] === 'string' && rawMeta['title']
+                ? { title: rawMeta['title'] }
+                : {}),
+            ...(typeof rawMeta['author'] === 'string' ? { author: rawMeta['author'] } : {}),
+            ...(pageCount !== undefined ? { pageCount } : {}),
+            ...(resolvedPath ? { source: resolvedPath } : {}),
+        };
+        return {
+            content,
+            metadata: meta,
+            format: 'pdf',
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Checks whether `python3 -m docling` is available in the current environment
+ * and, if so, returns a new {@link DoclingLoader} instance; otherwise returns
+ * `null`.
+ *
+ * The availability check runs `python3 -m docling --version` synchronously
+ * via `spawnSync` — it exits quickly and is only called once during registry
+ * initialisation.
+ *
+ * ### Usage
+ * ```ts
+ * import { createDoclingLoader } from './DoclingLoader.js';
+ * import { PdfLoader } from './PdfLoader.js';
+ *
+ * const doclingLoader = createDoclingLoader();
+ * const loader = new PdfLoader(null, doclingLoader);
+ * ```
+ *
+ * @returns A `DoclingLoader` instance when Docling is installed, or `null`.
+ */
+export function createDoclingLoader() {
+    try {
+        const result = spawnSync('python3', ['-m', 'docling', '--version'], {
+            stdio: 'ignore',
+            timeout: 5000,
+        });
+        // spawnSync throws when the binary cannot be found, and sets .error for
+        // other failure modes.  A non-zero status also means docling is absent.
+        if (result.error !== undefined || result.status !== 0) {
+            return null;
+        }
+        return new DoclingLoader();
+    }
+    catch {
+        // python3 is not in PATH or docling is not installed.
+        return null;
+    }
+}
+//# sourceMappingURL=DoclingLoader.js.map

package/dist/memory/ingestion/DoclingLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DoclingLoader.js","sourceRoot":"","sources":["../../../src/memory/ingestion/DoclingLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAIlC,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,yEAAyE;AACzE,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,OAAO,CAAU,CAAC;AAExD,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;GAIG;AACH,SAAS,KAAK,CAAC,QAAgB;IAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;AAC9C,CAAC;AAgCD,8EAA8E;AAC9E,iCAAiC;AACjC,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,aAAa;IAAnB;QACE,kBAAkB;QACT,wBAAmB,GAAa,CAAC,GAAG,oBAAoB,CAAC,CAAC;IAqJrE,CAAC;IAnJC,4EAA4E;IAC5E,UAAU;IACV,4EAA4E;IAE5E,kBAAkB;IAClB,OAAO,CAAC,MAAuB;QAC7B,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5B,0EAA0E;YAC1E,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAQ,oBAA0C,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAqB,CAAC,CAAC;IACjG,CAAC;IAED,4EAA4E;IAC5E,OAAO;IACP,4EAA4E;IAE5E,kBAAkB;IAClB,KAAK,CAAC,IAAI,CAAC,MAAuB,EAAE,QAAsB;QACxD,IAAI,QAAgB,CAAC;QACrB,IAAI,QAAQ,GAAkB,IAAI,CAAC;QAEnC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5B,kEAAkE;YAClE,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,iBAAiB,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACrE,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACrC,QAAQ,GAAG,QAAQ,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,QAAQ,GAAG,MAAM,CAAC;QACpB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YACpD,OAAO,IAAI,CAAC,oBAAoB,CAAC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC7F,CAAC;gBAAS,CAAC;YACT,qCAAqC;YACrC,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;gBACtB,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAA+B,CAAC,CAAC,CAAC;YACzE,CAAC;QACH,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,iCAAiC;IACjC,4EAA4E;IAE5E;;;;;;;;OAQG;IACK,KAAK,CAAC,WAAW,CAAC,QAAgB;QACxC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,IAAI,MAAM,GAAG,EAAE,CAAC;YAEhB,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE;gBACpF,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;aAClC,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;gBACvC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACnC,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;gBACvC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACnC,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBACxB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;oBACf,MAAM,CAAC,IAAI,KAAK,CACd,sDAAsD,IAAI,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CACvF,CAAC,CAAC;oBACH,OAAO;gBACT,CAAC;gBAED,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAsB,CAAC;oBACvD,OAAO,CAAC,MAAM,CAAC,CAAC;gBAClB,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,CAAC,IAAI,KAAK,CACd,uDAAuD,MAAM,CAAC,GAAG,CAAC,IAAI;wBACtE,6BAA6B,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CACpD,CAAC,CAAC;gBACL,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACvB,MAAM,CAAC,IAAI,KAAK,CAAC,2CAA2C,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YAC9E,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,4EAA4E;IAC5E,yCAAyC;IACzC,4EAA4E;IAE5E;;;;;;;;OAQG;IACK,oBAAoB,CAC1B,IAAuB,EACvB,YAAqB;QAErB,2EAA2E;QAC3E,IAAI,OAAe,CAAC;QACpB,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,QAAQ,EAAE,CAAC;YACrC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QACzB,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YACxC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;iBACpB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;iBAC5D,IAAI,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,EAAE,CAAC;QACf,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;QACvC,MAAM,SAAS,GACb,OAAO,OAAO,CAAC,WAAW,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;YACjE,OAAO,OAAO,CAAC,YAAY,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;gBACnE,SAAS,CAAC;QAEZ,MAAM,IAAI,GAAqB;YAC7B,GAAG,CAAC,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;gBAC1D,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE;gBAC7B,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,OAAO,OAAO,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/E,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjD,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClD,CAAC;QAEF,OAAO;YACL,OAAO;YACP,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,KAAK;SACd,CAAC;IACJ,CAAC;CACF;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,mBAAmB;IACjC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE;YAClE,KAAK,EAAE,QAAQ;YACf,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QACH,wEAAwE;QACxE,wEAAwE;QACxE,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,aAAa,EAAE,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,sDAAsD;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/memory/ingestion/DocxLoader.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @fileoverview DocxLoader — loads `.docx` documents using `mammoth`.
+ *
+ * The `mammoth` library extracts raw text from OOXML (Office Open XML) Word
+ * documents by stripping all formatting and returning the plain-text content.
+ * This keeps the ingestion pipeline fast and dependency-light while still
+ * producing high-quality text suitable for chunking and embedding.
+ *
+ * @module memory/ingestion/DocxLoader
+ */
+import type { IDocumentLoader } from './IDocumentLoader.js';
+import type { LoadOptions, LoadedDocument } from '../facade/types.js';
+/**
+ * Document loader for Microsoft Word (`.docx`) files.
+ *
+ * Uses `mammoth.extractRawText()` to strip all styling and return plain
+ * prose text, which is then stored as the `content` field.  The `metadata`
+ * block includes an approximate `wordCount`.
+ *
+ * @implements {IDocumentLoader}
+ *
+ * @example
+ * ```ts
+ * const loader = new DocxLoader();
+ * const doc = await loader.load('/docs/spec.docx');
+ * console.log(doc.metadata.wordCount); // e.g. 1842
+ * ```
+ */
+export declare class DocxLoader implements IDocumentLoader {
+    /** @inheritdoc */
+    readonly supportedExtensions: string[];
+    /** @inheritdoc */
+    canLoad(source: string | Buffer): boolean;
+    /** @inheritdoc */
+    load(source: string | Buffer, _options?: LoadOptions): Promise<LoadedDocument>;
+}
+//# sourceMappingURL=DocxLoader.d.ts.map

package/dist/memory/ingestion/DocxLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocxLoader.d.ts","sourceRoot":"","sources":["../../../src/memory/ingestion/DocxLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAoB,MAAM,oBAAoB,CAAC;AAsCxF;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,UAAW,YAAW,eAAe;IAChD,kBAAkB;IAClB,QAAQ,CAAC,mBAAmB,EAAE,MAAM,EAAE,CAA6B;IAMnE,kBAAkB;IAClB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO;IAezC,kBAAkB;IACZ,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;CA+BrF"}

package/dist/memory/ingestion/DocxLoader.js

@@ -0,0 +1,111 @@
+/**
+ * @fileoverview DocxLoader — loads `.docx` documents using `mammoth`.
+ *
+ * The `mammoth` library extracts raw text from OOXML (Office Open XML) Word
+ * documents by stripping all formatting and returning the plain-text content.
+ * This keeps the ingestion pipeline fast and dependency-light while still
+ * producing high-quality text suitable for chunking and embedding.
+ *
+ * @module memory/ingestion/DocxLoader
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import mammoth from 'mammoth';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Extensions handled by this loader, each with a leading dot. */
+const SUPPORTED_EXTENSIONS = ['.docx'];
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Returns the lower-cased extension (with dot) of a file path.
+ *
+ * @param filePath - Absolute or relative file path.
+ */
+function extOf(filePath) {
+    return path.extname(filePath).toLowerCase();
+}
+/**
+ * Count the approximate number of words in a string.
+ *
+ * Splits on runs of whitespace — intentionally lightweight for the typical
+ * document sizes encountered during ingestion.
+ *
+ * @param text - Raw text to count.
+ */
+function wordCount(text) {
+    return text.trim() === '' ? 0 : text.trim().split(/\s+/).length;
+}
+// ---------------------------------------------------------------------------
+// DocxLoader
+// ---------------------------------------------------------------------------
+/**
+ * Document loader for Microsoft Word (`.docx`) files.
+ *
+ * Uses `mammoth.extractRawText()` to strip all styling and return plain
+ * prose text, which is then stored as the `content` field.  The `metadata`
+ * block includes an approximate `wordCount`.
+ *
+ * @implements {IDocumentLoader}
+ *
+ * @example
+ * ```ts
+ * const loader = new DocxLoader();
+ * const doc = await loader.load('/docs/spec.docx');
+ * console.log(doc.metadata.wordCount); // e.g. 1842
+ * ```
+ */
+export class DocxLoader {
+    constructor() {
+        /** @inheritdoc */
+        this.supportedExtensions = [...SUPPORTED_EXTENSIONS];
+    }
+    // -------------------------------------------------------------------------
+    // canLoad
+    // -------------------------------------------------------------------------
+    /** @inheritdoc */
+    canLoad(source) {
+        if (Buffer.isBuffer(source)) {
+            // OOXML magic: PK zip signature (0x50 0x4B 0x03 0x04).
+            // .docx files are ZIP archives — check for the PK header.
+            return source.length >= 4 &&
+                source[0] === 0x50 && source[1] === 0x4B &&
+                source[2] === 0x03 && source[3] === 0x04;
+        }
+        return SUPPORTED_EXTENSIONS.includes(extOf(source));
+    }
+    // -------------------------------------------------------------------------
+    // load
+    // -------------------------------------------------------------------------
+    /** @inheritdoc */
+    async load(source, _options) {
+        let buffer;
+        let resolvedPath;
+        if (Buffer.isBuffer(source)) {
+            buffer = source;
+        }
+        else {
+            resolvedPath = source;
+            buffer = await fs.readFile(resolvedPath);
+        }
+        // mammoth.extractRawText strips all OOXML formatting and returns plain text.
+        // The `buffer` option accepts a Node Buffer directly (no temp file needed).
+        const result = await mammoth.extractRawText({ buffer });
+        // `result.value` is the extracted text; `result.messages` holds any
+        // conversion warnings (ignored here — they're rarely actionable for
+        // text-only extraction).
+        const content = result.value;
+        const meta = {
+            wordCount: wordCount(content),
+            ...(resolvedPath ? { source: resolvedPath } : {}),
+        };
+        return {
+            content,
+            metadata: meta,
+            format: 'docx',
+        };
+    }
+}
+//# sourceMappingURL=DocxLoader.js.map

package/dist/memory/ingestion/DocxLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocxLoader.js","sourceRoot":"","sources":["../../../src/memory/ingestion/DocxLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,OAAO,MAAM,SAAS,CAAC;AAI9B,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,kEAAkE;AAClE,MAAM,oBAAoB,GAAG,CAAC,OAAO,CAAU,CAAC;AAEhD,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;GAIG;AACH,SAAS,KAAK,CAAC,QAAgB;IAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;AAC9C,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;AAClE,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,UAAU;IAAvB;QACE,kBAAkB;QACT,wBAAmB,GAAa,CAAC,GAAG,oBAAoB,CAAC,CAAC;IAsDrE,CAAC;IApDC,4EAA4E;IAC5E,UAAU;IACV,4EAA4E;IAE5E,kBAAkB;IAClB,OAAO,CAAC,MAAuB;QAC7B,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5B,uDAAuD;YACvD,0DAA0D;YAC1D,OAAO,MAAM,CAAC,MAAM,IAAI,CAAC;gBACvB,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI;gBACxC,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;QAC7C,CAAC;QACD,OAAQ,oBAA0C,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAY,CAAC,CAAC;IACxF,CAAC;IAED,4EAA4E;IAC5E,OAAO;IACP,4EAA4E;IAE5E,kBAAkB;IAClB,KAAK,CAAC,IAAI,CAAC,MAAuB,EAAE,QAAsB;QACxD,IAAI,MAAc,CAAC;QACnB,IAAI,YAAgC,CAAC;QAErC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5B,MAAM,GAAG,MAAM,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,YAAY,GAAG,MAAM,CAAC;YACtB,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QAC3C,CAAC;QAED,6EAA6E;QAC7E,4EAA4E;QAC5E,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAExD,oEAAoE;QACpE,oEAAoE;QACpE,yBAAyB;QACzB,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC;QAE7B,MAAM,IAAI,GAAqB;YAC7B,SAAS,EAAE,SAAS,CAAC,OAAO,CAAC;YAC7B,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClD,CAAC;QAEF,OAAO;YACL,OAAO;YACP,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,MAAM;SACf,CAAC;IACJ,CAAC;CACF"}

package/dist/memory/ingestion/FolderScanner.d.ts

@@ -0,0 +1,116 @@
+/**
+ * @fileoverview FolderScanner — recursive directory walker for the ingestion
+ * pipeline.
+ *
+ * FolderScanner is NOT an {@link IDocumentLoader}; instead it orchestrates a
+ * {@link LoaderRegistry} to batch-process every file in a directory tree.  It
+ * supports glob-based include/exclude filters via `minimatch`, per-file
+ * progress callbacks, and graceful error collection so a single unreadable file
+ * never aborts a whole scan.
+ *
+ * @module memory/ingestion/FolderScanner
+ */
+import type { LoadedDocument } from '../facade/types.js';
+import type { LoaderRegistry } from './LoaderRegistry.js';
+/**
+ * Configuration options for {@link FolderScanner.scan}.
+ */
+export interface FolderScanOptions {
+    /**
+     * Whether to descend into sub-directories.
+     *
+     * When `false` only the direct children of `dirPath` are considered.
+     *
+     * @default true
+     */
+    recursive?: boolean;
+    /**
+     * Glob patterns that a file path must match at least one of in order to be
+     * processed.  Patterns are evaluated against the path *relative* to the
+     * scanned root directory using {@link minimatch}.
+     *
+     * When omitted every file with a registered extension is processed.
+     *
+     * @example ['**\/*.pdf', '**\/*.md']
+     */
+    include?: string[];
+    /**
+     * Glob patterns that cause a file to be skipped when its relative path
+     * matches any of them.  Evaluated *after* `include`.
+     *
+     * @example ['**\/node_modules\/**', '**\/.git\/**']
+     */
+    exclude?: string[];
+    /**
+     * Called after each file attempt (success *or* failure).
+     *
+     * @param file  - Absolute path of the file that was just processed.
+     * @param index - 1-based index of the file in the total discovered list.
+     * @param total - Total number of matching files discovered before processing began.
+     */
+    onProgress?: (file: string, index: number, total: number) => void;
+}
+/**
+ * The aggregated result of a {@link FolderScanner.scan} call.
+ */
+export interface FolderScanResult {
+    /**
+     * Successfully loaded documents, one per processed file.
+     */
+    documents: LoadedDocument[];
+    /**
+     * Absolute paths of files that were loaded without error.
+     */
+    succeeded: string[];
+    /**
+     * Files that could not be processed, with per-file error messages.
+     */
+    failed: Array<{
+        path: string;
+        error: string;
+    }>;
+}
+/**
+ * Recursively scans a directory and loads every file whose extension has a
+ * registered loader in the supplied {@link LoaderRegistry}.
+ *
+ * ### Example
+ * ```ts
+ * const registry = new LoaderRegistry();
+ * const scanner  = new FolderScanner(registry);
+ *
+ * const result = await scanner.scan('/knowledge-base', {
+ *   recursive:  true,
+ *   include:    ['**\/*.md', '**\/*.pdf'],
+ *   exclude:    ['**\/node_modules\/**'],
+ *   onProgress: (file, i, total) => console.log(`${i}/${total} ${file}`),
+ * });
+ *
+ * console.log(`Loaded ${result.documents.length} documents`);
+ * console.log(`Failed: ${result.failed.length}`);
+ * ```
+ */
+export declare class FolderScanner {
+    private readonly registry;
+    /**
+     * @param registry - The {@link LoaderRegistry} used to dispatch each file to
+     *                   the appropriate loader.
+     */
+    constructor(registry: LoaderRegistry);
+    /**
+     * Walk `dirPath` and load every matching file.
+     *
+     * Files are discovered first and then loaded sequentially.  Errors thrown
+     * by individual loaders are caught and accumulated in
+     * {@link FolderScanResult.failed} rather than propagating.
+     *
+     * @param dirPath - Absolute path to the directory to scan.
+     * @param options - Optional include/exclude filters and progress callback.
+     * @returns A promise that resolves to a {@link FolderScanResult}.
+     *
+     * @throws {Error} When `dirPath` cannot be read as a directory (e.g.
+     *                 it does not exist or is a regular file).
+     */
+    scan(dirPath: string, options?: FolderScanOptions): Promise<FolderScanResult>;
+}
+//# sourceMappingURL=FolderScanner.d.ts.map

package/dist/memory/ingestion/FolderScanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FolderScanner.d.ts","sourceRoot":"","sources":["../../../src/memory/ingestion/FolderScanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAM1D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnE;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,SAAS,EAAE,cAAc,EAAE,CAAC;IAE5B;;OAEG;IACH,SAAS,EAAE,MAAM,EAAE,CAAC;IAEpB;;OAEG;IACH,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,aAAa;IAKZ,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJrC;;;OAGG;gBAC0B,QAAQ,EAAE,cAAc;IAMrD;;;;;;;;;;;;;OAaG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAoFxF"}

package/dist/memory/ingestion/FolderScanner.js

@@ -0,0 +1,127 @@
+/**
+ * @fileoverview FolderScanner — recursive directory walker for the ingestion
+ * pipeline.
+ *
+ * FolderScanner is NOT an {@link IDocumentLoader}; instead it orchestrates a
+ * {@link LoaderRegistry} to batch-process every file in a directory tree.  It
+ * supports glob-based include/exclude filters via `minimatch`, per-file
+ * progress callbacks, and graceful error collection so a single unreadable file
+ * never aborts a whole scan.
+ *
+ * @module memory/ingestion/FolderScanner
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { minimatch } from 'minimatch';
+// ---------------------------------------------------------------------------
+// FolderScanner
+// ---------------------------------------------------------------------------
+/**
+ * Recursively scans a directory and loads every file whose extension has a
+ * registered loader in the supplied {@link LoaderRegistry}.
+ *
+ * ### Example
+ * ```ts
+ * const registry = new LoaderRegistry();
+ * const scanner  = new FolderScanner(registry);
+ *
+ * const result = await scanner.scan('/knowledge-base', {
+ *   recursive:  true,
+ *   include:    ['**\/*.md', '**\/*.pdf'],
+ *   exclude:    ['**\/node_modules\/**'],
+ *   onProgress: (file, i, total) => console.log(`${i}/${total} ${file}`),
+ * });
+ *
+ * console.log(`Loaded ${result.documents.length} documents`);
+ * console.log(`Failed: ${result.failed.length}`);
+ * ```
+ */
+export class FolderScanner {
+    /**
+     * @param registry - The {@link LoaderRegistry} used to dispatch each file to
+     *                   the appropriate loader.
+     */
+    constructor(registry) {
+        this.registry = registry;
+    }
+    // -------------------------------------------------------------------------
+    // scan
+    // -------------------------------------------------------------------------
+    /**
+     * Walk `dirPath` and load every matching file.
+     *
+     * Files are discovered first and then loaded sequentially.  Errors thrown
+     * by individual loaders are caught and accumulated in
+     * {@link FolderScanResult.failed} rather than propagating.
+     *
+     * @param dirPath - Absolute path to the directory to scan.
+     * @param options - Optional include/exclude filters and progress callback.
+     * @returns A promise that resolves to a {@link FolderScanResult}.
+     *
+     * @throws {Error} When `dirPath` cannot be read as a directory (e.g.
+     *                 it does not exist or is a regular file).
+     */
+    async scan(dirPath, options = {}) {
+        const { recursive = true, include, exclude, onProgress, } = options;
+        // ------------------------------------------------------------------
+        // 1. Discover all candidate file paths.
+        // ------------------------------------------------------------------
+        const allEntries = await fs.readdir(dirPath, { recursive, withFileTypes: true });
+        // Filter to only regular files whose extension is registered.
+        const supportedExtensions = new Set(this.registry.getSupportedExtensions());
+        const candidatePaths = [];
+        for (const entry of allEntries) {
+            // Skip directories (readdir with recursive:true includes dirs too).
+            if (!entry.isFile())
+                continue;
+            // Build the absolute path.  In Node 20+ with recursive:true the
+            // `parentPath` property is set; older versions use `path` (deprecated).
+            // We fall back gracefully.
+            const parentPath = entry.parentPath ??
+                entry.path ??
+                dirPath;
+            const absolutePath = path.join(parentPath, entry.name);
+            // Check that the extension has a registered loader.
+            const ext = path.extname(entry.name).toLowerCase();
+            if (!supportedExtensions.has(ext))
+                continue;
+            // Build relative path for glob matching.
+            const relativePath = path.relative(dirPath, absolutePath);
+            // Apply include filter — file must match at least one pattern.
+            if (include && include.length > 0) {
+                const matches = include.some((pattern) => minimatch(relativePath, pattern, { dot: true }));
+                if (!matches)
+                    continue;
+            }
+            // Apply exclude filter — file must NOT match any pattern.
+            if (exclude && exclude.length > 0) {
+                const excluded = exclude.some((pattern) => minimatch(relativePath, pattern, { dot: true }));
+                if (excluded)
+                    continue;
+            }
+            candidatePaths.push(absolutePath);
+        }
+        // ------------------------------------------------------------------
+        // 2. Load each candidate file, collecting results and errors.
+        // ------------------------------------------------------------------
+        const documents = [];
+        const succeeded = [];
+        const failed = [];
+        for (let i = 0; i < candidatePaths.length; i++) {
+            const filePath = candidatePaths[i];
+            try {
+                const doc = await this.registry.loadFile(filePath);
+                documents.push(doc);
+                succeeded.push(filePath);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                failed.push({ path: filePath, error: message });
+            }
+            // Fire progress callback (1-based index).
+            onProgress?.(filePath, i + 1, candidatePaths.length);
+        }
+        return { documents, succeeded, failed };
+    }
+}
+//# sourceMappingURL=FolderScanner.js.map

package/dist/memory/ingestion/FolderScanner.js.map

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