@rbalchii/anchor-engine 4.7.0

package/engine/dist/services/search/context-inflator.d.ts

@@ -0,0 +1,63 @@
+import { SearchResult } from './search.js';
+export declare class ContextInflator {
+    /**
+     * Inflate search results into expanded Context Windows.
+     *
+     * Architecture: Atoms are POINTERS — the DB stores entity labels + byte coordinates.
+     * Content lives in the original files on disk (mirrored). This method:
+     *   1. Skips results already inflated by inflateFromAtomPositions (read from disk)
+     *   2. For results with compound coordinates: resolves file path → reads from disk with radial expansion
+     *   3. Falls back to compound_body in DB only if the disk file doesn't exist
+     *
+     * Progressive Inflation: Top results get larger radius for better budget allocation.
+     *
+     * The DB is a lightweight routing layer. Actual content comes from the filesystem.
+     */
+    static inflate(results: SearchResult[], totalBudget?: number, radius?: number): Promise<SearchResult[]>;
+    /**
+     * Helper: Expand logical window to nearest sentence boundary
+     */
+    private static snapToSentenceBoundary;
+    /**
+     * Inflate a single result from the mirrored file on disk.
+     * Returns the extracted content string, or null if the file doesn't exist.
+     */
+    private static inflateFromDisk;
+    /**
+     * Fallback: inflate from compound_body stored in the DB.
+     * Used when the disk file doesn't exist (e.g., during initial ingest before mirror).
+     */
+    private static inflateFromCompoundBody;
+    /**
+     * Get atom locations for Elastic Context sizing
+     * Returns the raw positions so we can calculate density/hits BEFORE inflating
+     */
+    static getAtomLocations(term: string, limit?: number, options?: {
+        buckets?: string[];
+        provenance?: string;
+    }): Promise<{
+        compoundId: string;
+        byteOffset: number;
+        filePath: string;
+        timestamp: number;
+        provenance: string;
+    }[]>;
+    /**
+     * Radial Inflation from Atom Positions (Lazy Molecule Architecture)
+     * Searches atom_positions for keyword occurrences and expands radially
+     *
+     * @param searchTerm - The atom/keyword to search for
+     * @param radius - How many bytes to expand in each direction (default 500)
+     * @param maxResults - Maximum results to return
+     */
+    static inflateFromAtomPositions(searchTerm: string, radius?: number, maxResults?: number, maxWindowSize?: number, // Default cap if not provided
+    options?: {
+        buckets?: string[];
+        provenance?: string;
+    }): Promise<SearchResult[]>;
+    /**
+     * Fetch additional context to fill the token budget with less directly connected but still relevant data
+     */
+    private static fetchAdditionalContext;
+}
+//# sourceMappingURL=context-inflator.d.ts.map

package/engine/dist/services/search/context-inflator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-inflator.d.ts","sourceRoot":"","sources":["../../../src/services/search/context-inflator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAa3C,qBAAa,eAAe;IAExB;;;;;;;;;;;;OAYG;WACU,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,MAAM,GAAE,MAAU,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA6GhH;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAkDrC;;;OAGG;mBACkB,eAAe;IAsGpC;;;OAGG;mBACkB,uBAAuB;IAoC5C;;;OAGG;WACU,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAY,EAAE,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAyD3O;;;;;;;OAOG;WACU,wBAAwB,CACjC,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,MAAY,EACpB,UAAU,GAAE,MAAW,EACvB,aAAa,GAAE,MAAmB,EAAE,8BAA8B;IAClE,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO,GAC1D,OAAO,CAAC,YAAY,EAAE,CAAC;IA4M1B;;OAEG;mBACkB,sBAAsB;CA6H9C"}