@framers/agentos 0.1.126 → 0.1.127

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

@@ -1,116 +0,0 @@
-/**
- * @fileoverview FolderScanner — recursive directory walker for the ingestion
- * pipeline.
- *
- * FolderScanner is NOT an {@link IDocumentLoader}; instead it orchestrates a
- * `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 `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 `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 `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 `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
-     * the returned `failed` list 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 `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

@@ -1 +0,0 @@
-{"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;AAO1D;;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;CA8ExF"}

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

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

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

@@ -1,49 +0,0 @@
-/**
- * @fileoverview HtmlLoader — basic HTML-to-text document loader.
- *
- * Converts `.html` and `.htm` files into plain text using lightweight regex
- * transformations.  This is intentionally a *simple* loader — it covers the
- * common case of stripping tag soup and decoding standard HTML entities.  For
- * complex documents (nested frames, JavaScript-rendered content) a headless
- * browser or DOM-parsing library would be more appropriate.
- *
- * Supported extensions: `.html`, `.htm`
- *
- * @module memory/ingestion/HtmlLoader
- */
-import type { IDocumentLoader } from './IDocumentLoader.js';
-import type { LoadOptions, LoadedDocument } from '../facade/types.js';
-/**
- * Basic document loader for HTML (`.html`, `.htm`) files.
- *
- * ### Text extraction strategy
- * 1. `<script>` and `<style>` blocks are removed entirely.
- * 2. Block-level elements (`<p>`, `<div>`, `<h1>`–`<h6>`, etc.) are replaced
- *    with newline characters to preserve paragraph structure.
- * 3. All remaining HTML tags are stripped.
- * 4. A common subset of HTML entities is decoded.
- * 5. Excessive whitespace is collapsed.
- *
- * ### Metadata
- * - `title` — extracted from the `<title>` element when present.
- * - `wordCount` — approximate count of words in the extracted text.
- * - `source` — absolute file path (when loaded from disk).
- *
- * @implements {IDocumentLoader}
- *
- * @example
- * ```ts
- * const loader = new HtmlLoader();
- * const doc = await loader.load('/public/index.html');
- * console.log(doc.metadata.title); // e.g. 'Welcome to AgentOS'
- * ```
- */
-export declare class HtmlLoader implements IDocumentLoader {
-    /** @inheritdoc */
-    readonly supportedExtensions: string[];
-    /** @inheritdoc */
-    canLoad(source: string | Buffer): boolean;
-    /** @inheritdoc */
-    load(source: string | Buffer, _options?: LoadOptions): Promise<LoadedDocument>;
-}
-//# sourceMappingURL=HtmlLoader.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"HtmlLoader.d.ts","sourceRoot":"","sources":["../../../src/memory/ingestion/HtmlLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAoB,MAAM,oBAAoB,CAAC;AAoIxF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;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;IAWzC,kBAAkB;IACZ,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;CAiCrF"}

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

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

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

@@ -1,63 +0,0 @@
-/**
- * @fileoverview IDocumentLoader — contract for all document loading strategies.
- *
- * Every loader targets one or more file extensions and exposes a uniform
- * `load()` primitive that normalises diverse document formats into a single
- * {@link LoadedDocument} shape ready for chunking and indexing.
- *
- * @module memory/ingestion/IDocumentLoader
- */
-import type { LoadOptions, LoadedDocument } from '../facade/types.js';
-/**
- * Unified interface for all document loaders in the AgentOS ingestion
- * pipeline.
- *
- * Implementations handle a specific set of file extensions and are
- * responsible for:
- * 1. Reading raw bytes from a file path or in-memory `Buffer`.
- * 2. Extracting plain-text `content` and structured `metadata`.
- * 3. Returning a {@link LoadedDocument} ready for downstream chunking.
- *
- * @example
- * ```ts
- * const loader: IDocumentLoader = new MarkdownLoader();
- * if (loader.canLoad('README.md')) {
- *   const doc = await loader.load('README.md');
- *   console.log(doc.metadata.title);
- * }
- * ```
- */
-export interface IDocumentLoader {
-    /**
-     * File extensions this loader handles, each with a leading dot.
-     *
-     * Used by {@link LoaderRegistry} to route file paths to the correct loader.
-     *
-     * @example ['.md', '.mdx']
-     */
-    readonly supportedExtensions: string[];
-    /**
-     * Parses `source` and returns a normalised {@link LoadedDocument}.
-     *
-     * When `source` is a `string` the loader treats it as an absolute (or
-     * resolvable) file path and reads the file from disk.  When `source` is a
-     * `Buffer` the loader parses the bytes directly and derives as much
-     * metadata as possible from the buffer content alone.
-     *
-     * @param source  - Absolute file path OR raw document bytes.
-     * @param options - Optional hints such as a format override.
-     * @returns A promise resolving to the fully-populated {@link LoadedDocument}.
-     * @throws When the file cannot be read or the format is not parsable.
-     */
-    load(source: string | Buffer, options?: LoadOptions): Promise<LoadedDocument>;
-    /**
-     * Returns `true` when this loader is capable of handling `source`.
-     *
-     * For string sources the check is purely extension-based.  For `Buffer`
-     * sources the loader may inspect magic bytes when relevant.
-     *
-     * @param source - Absolute file path or raw bytes.
-     */
-    canLoad(source: string | Buffer): boolean;
-}
-//# sourceMappingURL=IDocumentLoader.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"IDocumentLoader.d.ts","sourceRoot":"","sources":["../../../src/memory/ingestion/IDocumentLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEtE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;OAMG;IACH,QAAQ,CAAC,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAEvC;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAE9E;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAC3C"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"IDocumentLoader.js","sourceRoot":"","sources":["../../../src/memory/ingestion/IDocumentLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

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

@@ -1,140 +0,0 @@
-/**
- * @fileoverview LoaderRegistry — extension-to-loader routing table.
- *
- * The registry maintains a map of file extensions to {@link IDocumentLoader}
- * implementations and provides a convenience `loadFile()` method that
- * auto-detects the format from a file path before delegating to the
- * appropriate loader.
- *
- * On construction the registry pre-registers five built-in loaders:
- * {@link TextLoader}, {@link MarkdownLoader}, {@link HtmlLoader},
- * {@link PdfLoader}, and {@link DocxLoader}.  In addition, the optional
- * OCR and Docling-backed loaders are registered when their
- * respective factories return non-null values (i.e. when `tesseract.js` and
- * `python3 -m docling` are available in the environment).
- *
- * Additional loaders can be added at runtime via {@link LoaderRegistry.register}.
- *
- * @module memory/ingestion/LoaderRegistry
- */
-import type { IDocumentLoader } from './IDocumentLoader.js';
-import type { LoadOptions, LoadedDocument } from '../facade/types.js';
-/**
- * Central registry mapping file extensions to {@link IDocumentLoader}
- * implementations.
- *
- * ### Built-in loaders (registered automatically)
- * | Extensions                                         | Loader                |
- * |----------------------------------------------------|-----------------------|
- * | `.txt`, `.csv`, `.tsv`, `.json`, `.yaml`, `.yml`  | {@link TextLoader}    |
- * | `.md`, `.mdx`                                     | {@link MarkdownLoader} |
- * | `.html`, `.htm`                                   | {@link HtmlLoader}    |
- * | `.pdf`                                            | {@link PdfLoader}     |
- * | `.docx`                                           | {@link DocxLoader}    |
- *
- * ### Conditional loaders (registered when available)
- * | Condition                     | Loader                                                  |
- * |-------------------------------|---------------------------------------------------------|
- * | `tesseract.js` installed      | factory from {@link createOcrPdfLoader} (overrides PDF) |
- * | `python3 -m docling` available | factory from {@link createDoclingLoader} (overrides PDF + DOCX) |
- *
- * ### Registering a custom loader
- * ```ts
- * const registry = new LoaderRegistry();
- * registry.register(new PdfLoader());
- * const doc = await registry.loadFile('/reports/q3.pdf');
- * ```
- *
- * ### Using loadFile
- * ```ts
- * const registry = new LoaderRegistry();
- * const doc = await registry.loadFile('/notes/meeting.md');
- * console.log(doc.metadata.title);
- * ```
- */
-export declare class LoaderRegistry {
-    /**
-     * Internal map from lower-cased extension (with dot) to the loader
-     * responsible for that extension.
-     *
-     * When multiple loaders claim the same extension the last one registered
-     * wins (newest-registration-wins semantics), allowing callers to override
-     * built-in loaders.
-     */
-    private readonly _loaders;
-    /**
-     * Creates a new registry pre-populated with the built-in loaders.
-     *
-     * Loader registration order determines conflict resolution: later
-     * registrations override earlier ones for the same extension.
-     *
-     * Registration order:
-     * 1. {@link TextLoader}, {@link MarkdownLoader}, {@link HtmlLoader} — core text formats.
-     * 2. {@link PdfLoader} (with injected OCR + Docling loaders) — PDF extraction.
-     * 3. {@link DocxLoader} — DOCX extraction.
-     * 4. Optional: an override from {@link createOcrPdfLoader} when `tesseract.js` is installed.
-     * 5. Optional: an override from {@link createDoclingLoader} when Python Docling is available.
-     *    The Docling-backed loader supports both `.pdf` and `.docx`, so it supersedes both
-     *    PdfLoader and DocxLoader when present.
-     */
-    constructor();
-    /**
-     * Register a loader for all extensions it declares.
-     *
-     * If a previously registered loader already handles one of the extension,
-     * it is replaced.  This makes it trivial to swap in a higher-fidelity
-     * implementation for any format.
-     *
-     * @param loader - The loader instance to register.
-     *
-     * @example
-     * ```ts
-     * registry.register(new PdfLoader());
-     * ```
-     */
-    register(loader: IDocumentLoader): void;
-    /**
-     * Retrieve the loader registered for `extensionOrPath`.
-     *
-     * Both bare extensions (`.md`, `md`) and full file paths
-     * (`/docs/guide.md`) are accepted.
-     *
-     * @param extensionOrPath - File extension or full path.
-     * @returns The matching {@link IDocumentLoader}, or `undefined` when no
-     *          loader is registered for the detected extension.
-     *
-     * @example
-     * ```ts
-     * const loader = registry.getLoader('.md');
-     * const loader2 = registry.getLoader('README.md');
-     * ```
-     */
-    getLoader(extensionOrPath: string): IDocumentLoader | undefined;
-    /**
-     * Return a sorted array of all extensions currently registered.
-     *
-     * Each extension is returned with a leading dot in lower-case, e.g.
-     * `['.csv', '.htm', '.html', '.json', '.md', …]`.
-     *
-     * @returns Sorted array of registered extension strings.
-     */
-    getSupportedExtensions(): string[];
-    /**
-     * Convenience method: detect format from `filePath`, find the matching
-     * loader, and delegate to its `load()` method.
-     *
-     * @param filePath - Absolute (or resolvable relative) file path.
-     * @param options  - Optional load hints forwarded to the loader.
-     * @returns A promise resolving to the {@link LoadedDocument}.
-     *
-     * @throws {Error} When no loader is registered for the file's extension.
-     * @throws {Error} When the underlying loader's `load()` throws.
-     *
-     * @example
-     * ```ts
-     * const doc = await registry.loadFile('/notes/architecture.md');
-     * ```
-     */
-    loadFile(filePath: string, options?: LoadOptions): Promise<LoadedDocument>;
-}
-//# sourceMappingURL=LoaderRegistry.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"LoaderRegistry.d.ts","sourceRoot":"","sources":["../../../src/memory/ingestion/LoaderRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAgDtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,cAAc;IACzB;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2C;IAEpE;;;;;;;;;;;;;;OAcG;;IA6BH;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAUvC;;;;;;;;;;;;;;;OAeG;IACH,SAAS,CAAC,eAAe,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAS/D;;;;;;;OAOG;IACH,sBAAsB,IAAI,MAAM,EAAE;IAQlC;;;;;;;;;;;;;;;OAeG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;CAajF"}

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

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

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

@@ -1,50 +0,0 @@
-/**
- * @fileoverview MarkdownLoader — loads `.md` and `.mdx` documents.
- *
- * Parses YAML front-matter using the `gray-matter` library, strips it from
- * the returned content, and promotes key metadata fields (title, author,
- * createdAt, etc.) into the {@link DocumentMetadata} shape.
- *
- * When no `title` key is present in the front-matter the loader falls back
- * to extracting the first ATX heading (`# …`) from the document body.
- *
- * @module memory/ingestion/MarkdownLoader
- */
-import type { IDocumentLoader } from './IDocumentLoader.js';
-import type { LoadOptions, LoadedDocument } from '../facade/types.js';
-/**
- * Document loader for Markdown (`.md`) and MDX (`.mdx`) files.
- *
- * ### Front-matter handling
- * YAML front-matter delimited by `---` is parsed via `gray-matter`.  All
- * key-value pairs are merged into {@link DocumentMetadata} as-is, with a
- * handful of well-known keys (`title`, `author`, `createdAt`, `modifiedAt`,
- * `language`) mapped to the corresponding typed metadata fields.
- *
- * ### Title extraction fallback
- * When the front-matter does **not** contain a `title` field the loader
- * searches the document body for the first level-1 ATX heading (`# Title`)
- * and uses that as the title.
- *
- * ### Returned content
- * The `content` field in the returned {@link LoadedDocument} contains the
- * Markdown body **without** the front-matter block.
- *
- * @implements {IDocumentLoader}
- *
- * @example
- * ```ts
- * const loader = new MarkdownLoader();
- * const doc = await loader.load('/docs/architecture.md');
- * console.log(doc.metadata.title); // from front-matter or first # heading
- * ```
- */
-export declare class MarkdownLoader implements IDocumentLoader {
-    /** @inheritdoc */
-    readonly supportedExtensions: string[];
-    /** @inheritdoc */
-    canLoad(source: string | Buffer): boolean;
-    /** @inheritdoc */
-    load(source: string | Buffer, _options?: LoadOptions): Promise<LoadedDocument>;
-}
-//# sourceMappingURL=MarkdownLoader.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"MarkdownLoader.d.ts","sourceRoot":"","sources":["../../../src/memory/ingestion/MarkdownLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAoB,MAAM,oBAAoB,CAAC;AAqExF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,cAAe,YAAW,eAAe;IACpD,kBAAkB;IAClB,QAAQ,CAAC,mBAAmB,EAAE,MAAM,EAAE,CAA6B;IAMnE,kBAAkB;IAClB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO;IAazC,kBAAkB;IACZ,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;CAqDrF"}

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

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

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

@@ -1,88 +0,0 @@
-/**
- * @fileoverview MultimodalAggregator — post-processing stage for images
- * extracted from documents.
- *
- * After loaders such as {@link PdfLoader} and {@link DocxLoader} extract
- * embedded images as {@link ExtractedImage} objects, `MultimodalAggregator`
- * enriches them with natural-language captions by optionally calling a
- * vision-capable LLM function supplied by the application layer.
- *
- * The class is intentionally thin: it holds no state beyond the optional
- * configuration and delegates all vision intelligence to the caller-supplied
- * `describeImage` function.  This keeps the aggregator testable without any
- * live LLM dependencies.
- *
- * @module memory/ingestion/MultimodalAggregator
- */
-import type { ExtractedImage } from '../facade/types.js';
-/**
- * Configuration for {@link MultimodalAggregator}.
- */
-export interface MultimodalConfig {
-    /**
-     * Async function that accepts a raw image buffer and its MIME type and
-     * returns a natural-language description of the image.
-     *
-     * When this is `undefined` the aggregator passes images through unchanged.
-     *
-     * @param imageBuffer - Raw bytes of the image (PNG, JPEG, WebP, …).
-     * @param mimeType    - MIME type of the image, e.g. `'image/png'`.
-     * @returns A promise resolving to a human-readable description string.
-     *
-     * @example
-     * ```ts
-     * async (buffer, mimeType) => {
-     *   return openaiClient.vision(buffer, mimeType);
-     * }
-     * ```
-     */
-    describeImage?: (imageBuffer: Buffer, mimeType: string) => Promise<string>;
-}
-/**
- * Adds auto-generated captions to {@link ExtractedImage} objects that lack
- * one, using a caller-supplied vision LLM function.
- *
- * Images are processed in parallel via `Promise.allSettled()` so a single
- * failed captioning attempt does not block the rest.  Images whose captioning
- * fails retain their original (un-captioned) state rather than propagating the
- * error.
- *
- * ### Example — with a vision LLM
- * ```ts
- * const aggregator = new MultimodalAggregator({
- *   describeImage: async (buf, mime) => myVisionLLM.describe(buf, mime),
- * });
- *
- * const captioned = await aggregator.processImages(doc.images ?? []);
- * ```
- *
- * ### Example — passthrough (no LLM configured)
- * ```ts
- * const aggregator = new MultimodalAggregator();
- * const unchanged  = await aggregator.processImages(doc.images ?? []);
- * ```
- */
-export declare class MultimodalAggregator {
-    private readonly config?;
-    /**
-     * @param config - Optional configuration.  Omit to use in passthrough mode.
-     */
-    constructor(config?: MultimodalConfig | undefined);
-    /**
-     * Enrich images with captions via the configured vision LLM.
-     *
-     * Only images that have no existing `caption` field are processed.  Images
-     * that already carry a caption are left unchanged to avoid redundant LLM
-     * calls.
-     *
-     * When no `describeImage` function is configured all images are returned
-     * unchanged.
-     *
-     * @param images - Array of {@link ExtractedImage} objects to process.
-     * @returns A promise resolving to the same-length array of
-     *          {@link ExtractedImage} objects, with captions filled in where
-     *          possible.
-     */
-    processImages(images: ExtractedImage[]): Promise<ExtractedImage[]>;
-}
-//# sourceMappingURL=MultimodalAggregator.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"MultimodalAggregator.d.ts","sourceRoot":"","sources":["../../../src/memory/ingestion/MultimodalAggregator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAMzD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;;;;;;;;OAgBG;IACH,aAAa,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5E;AAMD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,oBAAoB;IAInB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAHpC;;OAEG;gBAC0B,MAAM,CAAC,EAAE,gBAAgB,YAAA;IAMtD;;;;;;;;;;;;;;OAcG;IACG,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;CAiCzE"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"MultimodalAggregator.js","sourceRoot":"","sources":["../../../src/memory/ingestion/MultimodalAggregator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAgCH,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,OAAO,oBAAoB;IAC/B;;OAEG;IACH,YAA6B,MAAyB;QAAzB,WAAM,GAAN,MAAM,CAAmB;IAAG,CAAC;IAE1D,4EAA4E;IAC5E,gBAAgB;IAChB,4EAA4E;IAE5E;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,aAAa,CAAC,MAAwB;QAC1C,0EAA0E;QAC1E,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC;YAChC,OAAO,MAAM,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC;QAEhD,gEAAgE;QAChE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAA2B,EAAE;YAClD,2CAA2C;YAC3C,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBAChC,OAAO,KAAK,CAAC;YACf,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;gBAChE,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,CAAC;YAC/B,CAAC;YAAC,MAAM,CAAC;gBACP,2DAA2D;gBAC3D,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC,CAAC,CACH,CAAC;QAEF,yEAAyE;QACzE,2EAA2E;QAC3E,uEAAuE;QACvE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CACnC,MAAM,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAC7D,CAAC;IACJ,CAAC;CACF"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"OcrPdfLoader.d.ts","sourceRoot":"","sources":["../../../src/memory/ingestion/OcrPdfLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAsH5D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,GAAG,IAAI,CAY3D"}

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

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