@loreai/core 0.15.0 → 0.17.0

package/README.md

@@ -19,6 +19,17 @@ bun add @loreai/core
 
 You only need to install this directly if you're building a new adapter. End users install one of the host packages above.
 
+### Optional dependency: `fastembed`
+
+`fastembed` is declared as an `optionalDependencies` because its native `onnxruntime-node` bindings can fail to build on some hosts (e.g. CUDA 13 on Linux/x64 — [microsoft/onnxruntime#26586](https://github.com/microsoft/onnxruntime/discussions/26586)). Install always succeeds, and `embed()` resolves a provider in this order:
+
+1. **Vendored** (standalone `lore` binary only) — fastembed and its native bindings are bundled directly into the binary at compile time via `bun build --compile`. The bge-small INT8 model files and the side-load `libonnxruntime` shared library ride along as Bun assets and are materialized to `~/.lore/embeddings-vendored/v{version}-{target}/` on first call. Supported targets: `darwin-arm64`, `linux-arm64`, `linux-x64`, `windows-x64`. (`darwin-x64` is unsupported — Apple Silicon-only.)
+2. **npm-installed** — `import("fastembed")` resolves to the user's `node_modules`, including the optional-dep install.
+3. **Remote auto-fallback** — when the local probe fails AND `VOYAGE_API_KEY` or `OPENAI_API_KEY` is set, `embed()` swaps to that provider for the rest of the process. Voyage wins ties.
+4. **FTS-only** — if none of the above resolve, `recall.runRecall()` and `vectorSearch()` return zero hits and callers continue with full-text search only.
+
+To force the optional install on a CUDA-13 host, run with `ONNXRUNTIME_NODE_INSTALL_CUDA=skip` — the bundled CPU EP is sufficient for `bge-small-en-v1.5`.
+
 ## Documentation
 
 Full architecture, benchmarks, and rationale: **[github.com/BYK/loreai](https://github.com/BYK/loreai)**

package/dist/bun/agents-file.d.ts

@@ -15,6 +15,11 @@ export declare const LORE_SECTION_END = "<!-- End lore-managed section -->";
  * by lore — no section markers needed, no non-lore content to preserve.
  */
 export declare const LORE_FILE = ".lore.md";
+/**
+ * Clear the cached mtime/hash for a project's `.lore.md`.
+ * Useful in tests or after data wipes to force a full re-check.
+ */
+export declare function clearLoreFileCache(projectPath: string): void;
 export type ParsedFileEntry = {
     /** UUID from `<!-- lore:UUID -->` marker, or null for hand-written entries. */
     id: string | null;
@@ -65,11 +70,18 @@ export declare function loreFileExists(projectPath: string): boolean;
 /**
  * Export current knowledge entries to `.lore.md` in the project root.
  * The entire file is lore-owned — no section markers, no content to preserve.
+ *
+ * Skips the write if the content hash matches the cached hash (DB state
+ * unchanged since last export), avoiding unnecessary filesystem writes
+ * and mtime bumps.
  */
 export declare function exportLoreFile(projectPath: string): void;
 /**
  * Returns true if `.lore.md` needs to be imported:
- * - File exists and its content differs from what lore would currently produce
+ * - File exists and its content differs from what lore would currently produce.
+ *
+ * Uses an mtime + content-hash cache to skip the expensive buildSection()
+ * call when the file hasn't been touched since we last processed it.
  */
 export declare function shouldImportLoreFile(projectPath: string): boolean;
 /**

package/dist/bun/agents-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents-file.d.ts","sourceRoot":"","sources":["../../src/agents-file.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH,eAAO,MAAM,kBAAkB,qGACqE,CAAC;AACrG,eAAO,MAAM,gBAAgB,sCAAsC,CAAC;AAepE;;;;GAIG;AACH,eAAO,MAAM,SAAS,aAAa,CAAC;AAepC,MAAM,MAAM,eAAe,GAAG;IAC5B,+EAA+E;IAC/E,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AA+EF;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE,CAgD1E;AAmFD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CA8BP;AAMD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAcV;AAsED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CAeP;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAIxD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAOjE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CASxD"}
+{"version":3,"file":"agents-file.d.ts","sourceRoot":"","sources":["../../src/agents-file.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAYH,eAAO,MAAM,kBAAkB,qGACqE,CAAC;AACrG,eAAO,MAAM,gBAAgB,sCAAsC,CAAC;AAepE;;;;GAIG;AACH,eAAO,MAAM,SAAS,aAAa,CAAC;AA8CpC;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAI5D;AAMD,MAAM,MAAM,eAAe,GAAG;IAC5B,+EAA+E;IAC/E,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AA+EF;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE,CAgD1E;AAmFD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CA8BP;AAMD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAcV;AAsED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CAeP;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAiBxD;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAwBjE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CASxD"}

package/dist/bun/config.d.ts

@@ -15,11 +15,14 @@ export declare const LoreConfig: z.ZodObject<{
         ltm: z.ZodDefault<z.ZodNumber>;
         targetCacheReadCostPerTurn: z.ZodDefault<z.ZodNumber>;
         maxLayer0Tokens: z.ZodOptional<z.ZodNumber>;
+        targetBustCost: z.ZodDefault<z.ZodNumber>;
+        maxContextTokens: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
     idleResumeMinutes: z.ZodDefault<z.ZodNumber>;
     distillation: z.ZodDefault<z.ZodObject<{
         minMessages: z.ZodDefault<z.ZodNumber>;
-        maxSegment: z.ZodDefault<z.ZodNumber>;
+        minSegmentTokens: z.ZodDefault<z.ZodNumber>;
+        maxSegmentTokens: z.ZodDefault<z.ZodNumber>;
         metaThreshold: z.ZodDefault<z.ZodNumber>;
         toolOutputMaxChars: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>;
@@ -54,6 +57,22 @@ export declare const LoreConfig: z.ZodObject<{
             model: z.ZodDefault<z.ZodString>;
             dimensions: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strip>>;
+        recall: z.ZodDefault<z.ZodObject<{
+            charBudget: z.ZodDefault<z.ZodNumber>;
+            relevanceFloor: z.ZodDefault<z.ZodNumber>;
+            maxResults: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    cache: z.ZodDefault<z.ZodObject<{
+        conversationTTL: z.ZodDefault<z.ZodEnum<{
+            "5m": "5m";
+            "1h": "1h";
+            auto: "auto";
+        }>>;
+        warming: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            minReturnProbability: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     crossProject: z.ZodDefault<z.ZodBoolean>;
     agentsFile: z.ZodDefault<z.ZodObject<{

package/dist/bun/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkKrB,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAIpD,wBAAgB,MAAM,IAAI,UAAU,CAEnC;AAED,wBAAsB,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CASjE"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiOrB,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAIpD,wBAAgB,MAAM,IAAI,UAAU,CAEnC;AAED,wBAAsB,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CASjE"}

package/dist/bun/data.d.ts

@@ -0,0 +1,174 @@
+/**
+ * data.ts — Data listing, inspection, and deletion for Lore.
+ *
+ * Provides a unified API for both the CLI (`lore data`) and the web UI
+ * (`/ui/`) to browse, search, and delete stored data across all tables.
+ *
+ * Cross-cutting concerns (e.g. `clearProject` touches knowledge, temporal,
+ * distillations, and session_state in one transaction) live here instead of
+ * being spread across ltm/temporal/distillation modules.
+ */
+export type ProjectSummary = {
+    id: string;
+    path: string;
+    name: string | null;
+    git_remote: string | null;
+    created_at: number;
+    knowledge_count: number;
+    session_count: number;
+    message_count: number;
+    distillation_count: number;
+};
+export type SessionSummary = {
+    session_id: string;
+    message_count: number;
+    first_message_at: number;
+    last_message_at: number;
+    distilled_count: number;
+    undistilled_count: number;
+    distillation_count: number;
+};
+export type DistillationSummary = {
+    id: string;
+    session_id: string;
+    generation: number;
+    token_count: number;
+    r_compression: number | null;
+    c_norm: number | null;
+    archived: number;
+    created_at: number;
+    call_type: string | null;
+};
+export type DistillationDetail = DistillationSummary & {
+    project_id: string;
+    observations: string;
+    source_ids: string;
+};
+export type ClearResult = {
+    knowledge_deleted: number;
+    temporal_deleted: number;
+    distillations_deleted: number;
+    sessions_cleared: number;
+};
+export type GlobalStats = {
+    project_count: number;
+    knowledge_count: number;
+    session_count: number;
+    message_count: number;
+    distillation_count: number;
+    db_size_bytes: number;
+};
+/** List all projects with summary counts. */
+export declare function listProjects(): ProjectSummary[];
+/** List distinct sessions for a project, with message/distillation counts. */
+export declare function listSessions(projectPath: string, limit?: number): SessionSummary[];
+/** List distillations for a project (optionally filtered by session). */
+export declare function listDistillations(projectPath: string, opts?: {
+    sessionId?: string;
+    limit?: number;
+}): DistillationSummary[];
+/** Get a single distillation by ID (or resolved prefix). */
+export declare function getDistillation(id: string): DistillationDetail | null;
+/**
+ * Resolve a partial ID prefix to a full ID for a given table.
+ * Returns null if 0 or 2+ matches (ambiguous prefix).
+ */
+export declare function resolveId(table: "knowledge" | "distillations", prefix: string): string | null;
+/** Global stats for the dashboard. */
+export declare function globalStats(): GlobalStats;
+/**
+ * Count rows that will be affected, for confirmation prompts.
+ */
+export declare function countForProject(projectPath: string): {
+    knowledge: number;
+    messages: number;
+    distillations: number;
+    sessions: number;
+};
+/**
+ * Clear all data for a project.
+ * Deletes: knowledge, temporal_messages, distillations, session_state.
+ * Does NOT delete the project row itself (preserves path->id mapping).
+ * Regenerates `.lore.md` if the project path exists on disk.
+ */
+export declare function clearProject(projectPath: string): ClearResult;
+/**
+ * Fully delete a project: all associated data AND the project row itself.
+ * Also removes path aliases pointing to this project.
+ *
+ * Unlike clearProject(), this does NOT call ensureProject() (avoids
+ * re-creating the project) and does NOT regenerate .lore.md.
+ *
+ * Returns deletion counts, or null if the project ID doesn't exist.
+ */
+export declare function deleteProject(projectId: string): ClearResult | null;
+/** Rename a project. Returns true if the project exists and was renamed. */
+export declare function renameProject(projectId: string, newName: string): boolean;
+/** Clear only knowledge entries for a project. Regenerates .lore.md. */
+export declare function clearKnowledge(projectPath: string): number;
+/** Clear only temporal messages for a project. */
+export declare function clearTemporal(projectPath: string): number;
+/** Clear only distillations for a project. */
+export declare function clearDistillations(projectPath: string): number;
+/** Delete a single knowledge entry. Returns true if found and deleted. */
+export declare function deleteKnowledge(id: string): boolean;
+/** Delete a single distillation. Returns true if found and deleted. */
+export declare function deleteDistillation(id: string): boolean;
+/**
+ * Delete all data for a specific session (messages + distillations + session_state).
+ */
+export declare function deleteSession(projectPath: string, sessionId: string): {
+    messages_deleted: number;
+    distillations_deleted: number;
+};
+/**
+ * Nuclear option: close the DB, delete the file, re-initialize.
+ * Returns the path of the deleted DB file.
+ */
+export declare function wipeDatabase(): string;
+export type MergeResult = {
+    knowledge_moved: number;
+    messages_moved: number;
+    distillations_moved: number;
+};
+/**
+ * Merge a source project into a target project.
+ *
+ * Moves all data (knowledge, messages, distillations, LAT sections, path
+ * aliases) from source to target, then deletes the source project row.
+ * The source project's path is registered as an alias of the target.
+ *
+ * Returns counts of moved rows for reporting.
+ */
+export declare function mergeProjects(sourceId: string, targetId: string): MergeResult;
+/**
+ * Backfill git_remote for existing projects, merge duplicates, and
+ * update project names from git remote repo names where still using
+ * the directory-basename default.
+ *
+ * Iterates all projects that lack a git_remote value, runs `git remote -v`
+ * on their stored path, and:
+ *  - If no other project shares that remote: sets git_remote on the row.
+ *  - If another project already has that remote: merges this project into
+ *    the existing one (consolidating fragmented data).
+ *
+ * Also backfills project names: if a project's name matches the directory
+ * basename (the old default) or is null, and a git remote is available,
+ * the name is updated to the repo name from the remote URL.
+ *
+ * Skips projects whose path no longer exists on disk or is not a git repo.
+ *
+ * Returns counts for reporting.
+ */
+export declare function backfillGitRemotes(): {
+    updated: number;
+    merged: number;
+    namesBackfilled: number;
+    mergeDetails: Array<{
+        sourcePath: string;
+        targetPath: string;
+        gitRemote: string;
+        result: MergeResult;
+    }>;
+};
+//# sourceMappingURL=data.d.ts.map

package/dist/bun/data.d.ts.map

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

package/dist/bun/db.d.ts

@@ -1,6 +1,43 @@
 import { Database } from "#db/driver";
+/**
+ * Extract the repository name from a normalized git remote URL.
+ *
+ * Examples:
+ *   "github.com/BYK/LoreAI" → "LoreAI"
+ *   "github.com/org/repo"    → "repo"
+ *   "github.com"             → null (no path components)
+ *   null                     → null
+ */
+export declare function repoNameFromRemote(remote: string | null): string | null;
+/** Return the resolved path of the SQLite database file. */
+export declare function dbPath(): string;
 export declare function db(): Database;
+/**
+ * Merge all data from `sourceId` project into `targetId` project.
+ *
+ * Moves knowledge, temporal messages, distillations, LAT sections, and
+ * path aliases from source to target. Registers the source project's path
+ * as an alias of the target. Deletes the source project row.
+ *
+ * Used internally during lazy git-remote backfill when two path-only
+ * projects are discovered to share the same git remote.
+ */
+export declare function mergeProjectInternal(sourceId: string, targetId: string): void;
 export declare function close(): void;
+/**
+ * Look up or create a project by filesystem path, with git-remote awareness.
+ *
+ * Resolution order:
+ *  1. Exact path match in `projects` table (fast path, O(1) index scan)
+ *  2. Path alias match in `project_path_aliases` (worktree/clone re-visits)
+ *  3. Git remote match — runs `git remote -v` (once per unique path, cached),
+ *     finds an existing project with the same normalized remote URL
+ *  4. Create a new project row
+ *
+ * When a git-remote match is found (step 3), the new path is registered as
+ * an alias so subsequent calls skip the subprocess. If the matched project's
+ * git_remote was not yet populated (pre-v14 rows), it is backfilled lazily.
+ */
 export declare function ensureProject(path: string, name?: string): string;
 export declare function projectId(path: string): string | undefined;
 /** Look up a project's display name by its internal ID. */
@@ -19,6 +56,34 @@ export declare function loadForceMinLayer(sessionID: string): number;
  * (consumed) to avoid unbounded growth.
  */
 export declare function saveForceMinLayer(sessionID: string, layer: number): void;
+/** Persisted cost snapshot for a session. */
+export type SessionCostSnapshot = {
+    conversationCost: number;
+    workerCost: number;
+    conversationTurns: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+    warmupSavings: number;
+    warmupHits: number;
+    ttlSavings: number;
+    ttlHits: number;
+    batchSavings: number;
+};
+/**
+ * Persist a session's cost snapshot. Uses INSERT OR REPLACE so it works
+ * whether or not a row already exists (forceMinLayer may have created one).
+ */
+export declare function saveSessionCosts(sessionID: string, costs: SessionCostSnapshot): void;
+/**
+ * Load persisted cost snapshot for a session. Returns null if not stored
+ * or if all cost columns are zero (pre-migration row from forceMinLayer only).
+ */
+export declare function loadSessionCosts(sessionID: string): SessionCostSnapshot | null;
+/**
+ * Load cost snapshots for all sessions that have non-zero cost data.
+ * Returns a map of sessionID → SessionCostSnapshot.
+ */
+export declare function loadAllSessionCosts(): Map<string, SessionCostSnapshot>;
 /** Get a metadata value by key. Returns null if not found. */
 export declare function getMeta(key: string): string | null;
 /** Set a metadata value (upsert). */

package/dist/bun/db.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/db.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAsXtC,wBAAgB,EAAE,IAAI,QAAQ,CAkC7B;AAwGD,wBAAgB,KAAK,SAKpB;AAGD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAYjE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK1D;AAED,2DAA2D;AAC3D,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKrD;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAKpC;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAK3D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAYxE;AAMD,8DAA8D;AAC9D,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKlD;AAED,qCAAqC;AACrC,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAMxD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAMtC"}
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/db.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAMtC;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAMvE;AA0bD,4DAA4D;AAC5D,wBAAgB,MAAM,IAAI,MAAM,CAI/B;AAID,wBAAgB,EAAE,IAAI,QAAQ,CA8C7B;AAsHD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,IAAI,CAoCN;AAED,wBAAgB,KAAK,SAKpB;AAID;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAiEjE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAW1D;AAED,2DAA2D;AAC3D,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKrD;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAKpC;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAK3D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAYxE;AAED,6CAA6C;AAC7C,MAAM,MAAM,mBAAmB,GAAG;IAChC,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,GAAG,IAAI,CA2BpF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAiC9E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAsCtE;AAMD,8DAA8D;AAC9D,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKlD;AAED,qCAAqC;AACrC,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAMxD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAMtC"}

package/dist/bun/distillation.d.ts

@@ -15,20 +15,58 @@ type TemporalMessage = temporal.TemporalMessage;
  * use as a diagnostic signal, not a hard gate.
  */
 export declare function compressionRatio(distilledTokens: number, sourceTokens: number): number;
+/**
+ * Maximum allowed expansion for distillation output.
+ *
+ * Tiny segments can't meaningfully compress — distillation adds metadata
+ * (timestamps, importance markers, cross-references) that necessarily
+ * exceeds the source. Allow generous expansion for small segments while
+ * still enforcing compression on large ones.
+ *
+ * @returns Maximum allowed distilled tokens for a given source token count.
+ */
+export declare function maxAllowedExpansion(sourceTokens: number): number;
 /**
  * Segment detection: group related messages into distillation-sized chunks.
  *
- * When the message count exceeds `maxSegment`, prefers splitting at the
+ * When the total token count exceeds `maxTokens`, prefers splitting at the
  * largest inter-message time gap (if it's ≥ 3× the median gap) to respect
- * natural conversation boundaries. Falls back to count-based splitting at
- * `maxSegment` when timestamps are uniform.
+ * natural conversation boundaries. Falls back to token-boundary splitting
+ * when timestamps are uniform.
  *
- * Trailing segments with < 3 messages are merged into the previous segment
- * to avoid tiny distillation inputs with too little context.
+ * Trailing segments whose token sum is below {@link MIN_SEGMENT_TOKENS}
+ * are merged into the previous segment to avoid tiny distillation inputs
+ * with too little context.
  *
  * Exported for testing; `run()` is the production caller.
  */
-export declare function detectSegments(messages: TemporalMessage[], maxSegment: number): TemporalMessage[][];
+export declare function detectSegments(messages: TemporalMessage[], maxTokens: number): TemporalMessage[][];
+/**
+ * Compute the max_tokens budget for a worker LLM call.
+ *
+ * @param inputTokens  Estimated source token count
+ * @param ratio        Compression ratio (0.0–1.0) — output ≈ ratio × input
+ * @param floor        Minimum output tokens
+ * @param cap          Maximum output tokens
+ */
+export declare function workerTokenBudget(inputTokens: number, ratio: number, floor: number, cap: number): number;
+/**
+ * Compute the max_tokens budget for gen-0 distillation of raw messages.
+ *
+ * Uses a √N-based formula (8 × √N) instead of a linear ratio so that the
+ * budget grows sub-linearly with input size. This naturally constrains the
+ * LLM to produce output at ~R ≈ 2–4 (the square-root boundary) and avoids
+ * expansion on small segments where a linear 0.25 ratio + 1024 floor gave
+ * the model far too much room.
+ *
+ * The multiplier (8) gives ~4× headroom above the R=2.0 target, accounting
+ * for the detailed observation format (emoji markers, timestamps, entity
+ * tags, exact numbers) required by the distillation prompt.
+ *
+ * @param sourceTokens  Estimated source token count from raw messages
+ * @returns             Token budget clamped to [256, 4096]
+ */
+export declare function distillTokenBudget(sourceTokens: number): number;
 /**
  * Truncate tool outputs within a `TemporalMessage.content` string (produced
  * by `temporal.partsToText`). Plain text and `[reasoning]` chunks pass
@@ -100,6 +138,7 @@ export type Distillation = {
  * rare callers that explicitly want all rows.
  */
 export declare function loadForSession(projectPath: string, sessionID: string, includeArchived?: boolean): Distillation[];
+export declare function gen0Count(projectPath: string, sessionID: string): number;
 export declare function run(input: {
     llm: LLMClient;
     projectPath: string;
@@ -121,6 +160,9 @@ export declare function run(input: {
      *  where the caller is blocking on the result. Background/idle distillation
      *  should leave this false to benefit from batch API 50% cost savings. */
     urgent?: boolean;
+    /** Whether the LLM call will use batch or direct pricing. Recorded on the
+     *  distillation row for accurate historical cost estimates. */
+    callType?: "batch" | "direct";
 }): Promise<{
     rounds: number;
     distilled: number;
@@ -142,6 +184,7 @@ export declare function metaDistill(input: {
         modelID: string;
     };
     urgent?: boolean;
+    callType?: "batch" | "direct";
 }): Promise<DistillationResult | null>;
 /**
  * Backfill `r_compression` and `c_norm` for distillations that were created

package/dist/bun/distillation.d.ts.map

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

package/dist/bun/embedding-vendor.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Vendored bge-small registration for the standalone Lore binary.
+ *
+ * The Bun-compiled `lore` binary uses `bun build --compile` to bundle
+ * `fastembed` + `onnxruntime-node` + `@anush008/tokenizers-<platform>`
+ * directly into the executable — including the platform-specific
+ * `.node` addons which Bun embeds and dlopens from `$bunfs` at runtime.
+ *
+ * Two pieces don't fit into Bun's automatic bundling and need our help:
+ *
+ *  1. **Side-load shared libraries**. `onnxruntime_binding.node` does a
+ *     runtime `dlopen("libonnxruntime.so.1")` (or the .dylib / .dll
+ *     equivalent) for the actual ONNX Runtime computation library. Bun
+ *     doesn't follow this kind of dependency. The binary's wrapper
+ *     pre-loads these libs via `bun:ffi` *before* fastembed evaluates,
+ *     so when the addon's dlopen fires it finds the cached handle.
+ *
+ *  2. **Model weights + tokenizer**. fastembed downloads from the HF
+ *     Hub on first use; we want zero network on first run. The wrapper
+ *     embeds the bge-small INT8 files as Bun assets, writes them to a
+ *     real disk dir on first run, and sets `globalThis.__LORE_VENDOR_MODEL__`
+ *     to that path. This module exposes that registration to the
+ *     LocalProvider so it can hand the path to fastembed's CUSTOM-mode
+ *     init (`modelAbsoluteDirPath` + `modelName`).
+ *
+ * In npm-mode usage from `@loreai/opencode` / `@loreai/pi` the global
+ * is unset and `vendorModelInfo()` returns `null`, so the LocalProvider
+ * falls through to fastembed's default Qdrant repo + cache.
+ */
+/** What the binary wrapper writes to globalThis after extracting model files. */
+export interface VendorRegistration {
+    /** Absolute path to the dir containing the bge-small files
+     *  (config.json, tokenizer.json, model_quantized.onnx, …). Pass to
+     *  fastembed as `modelAbsoluteDirPath` in CUSTOM init. */
+    modelAbsoluteDirPath: string;
+    /** Filename of the ONNX weights inside that dir. Pass to fastembed
+     *  as `modelName` in CUSTOM init. */
+    modelName: string;
+    /** Target identifier the binary was built for, e.g. "linux-x64".
+     *  Diagnostic only — the runtime doesn't branch on it. */
+    target: string;
+    /** Lore CLI version that produced the binary. Diagnostic only. */
+    version: string;
+}
+/** Test-only: programmatically set/clear the registration to exercise
+ *  both binary-mode and npm-mode code paths without spinning up a real
+ *  compiled binary. */
+export declare function _setVendorRegistration(reg: VendorRegistration | null): void;
+/** Subset of the registration fastembed needs. Stripped of the
+ *  diagnostic fields so the LocalProvider has exactly what it should
+ *  hand to `FlagEmbedding.init`. */
+export interface VendorModelInfo {
+    modelAbsoluteDirPath: string;
+    modelName: string;
+}
+/**
+ * Resolve the bundled-model arguments for fastembed CUSTOM init. Returns
+ * `null` when no vendor is registered (npm-mode), so the caller can fall
+ * through to fastembed's default cacheDir/HF Hub flow.
+ */
+export declare function vendorModelInfo(): VendorModelInfo | null;
+/** True iff this process is running inside a vendored Lore binary. */
+export declare function isVendoredBinary(): boolean;
+/** The full registration, for diagnostics (`lore --print-vendor-info`). */
+export declare function vendorRegistration(): VendorRegistration | null;
+//# sourceMappingURL=embedding-vendor.d.ts.map

package/dist/bun/embedding-vendor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-vendor.d.ts","sourceRoot":"","sources":["../../src/embedding-vendor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAMH,iFAAiF;AACjF,MAAM,WAAW,kBAAkB;IACjC;;8DAE0D;IAC1D,oBAAoB,EAAE,MAAM,CAAC;IAC7B;yCACqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB;8DAC0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;CACjB;AAUD;;uBAEuB;AACvB,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,kBAAkB,GAAG,IAAI,GAAG,IAAI,CAI3E;AAMD;;oCAEoC;AACpC,MAAM,WAAW,eAAe;IAC9B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,eAAe,GAAG,IAAI,CAOxD;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED,2EAA2E;AAC3E,wBAAgB,kBAAkB,IAAI,kBAAkB,GAAG,IAAI,CAE9D"}

package/dist/bun/embedding-worker-types.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Shared message types for the embedding worker thread.
+ *
+ * The embedding worker (`embedding-worker.ts`) runs fastembed/ONNX inference
+ * in a separate `node:worker_threads` Worker so the main thread's event loop
+ * stays free during inference. This file defines the message protocol between
+ * the main thread (`LocalProvider` in `embedding.ts`) and the worker.
+ *
+ * Imported by both sides — keep this file free of runtime dependencies.
+ */
+/** Request an embedding batch. */
+export interface EmbedRequest {
+    type: "embed";
+    /** Monotonic request ID for correlating responses. */
+    id: number;
+    /** Texts to embed. */
+    texts: string[];
+    /** "document" for storage, "query" for search. */
+    inputType: "document" | "query";
+    /** "high" = recall queries (jump the queue), "normal" = backfill. */
+    priority: "high" | "normal";
+}
+/** Ask the worker to exit cleanly. */
+export interface ShutdownRequest {
+    type: "shutdown";
+}
+export type WorkerInbound = EmbedRequest | ShutdownRequest;
+/** Embedding result — vectors are Float32Array[], sent via structured clone. */
+export interface EmbedResult {
+    type: "result";
+    /** Matches the request ID. */
+    id: number;
+    /** One Float32Array per input text. Sent via structured clone
+     *  (Bun preserves Float32Array identity across threads). */
+    vectors: Float32Array[];
+}
+/** A single embed request failed (ONNX error, etc.). */
+export interface EmbedError {
+    type: "error";
+    /** Matches the request ID. */
+    id: number;
+    /** Human-readable error message. */
+    error: string;
+}
+/** Model initialization failed inside the worker. All pending and future
+ *  requests should be rejected — the worker is unusable. */
+export interface InitError {
+    type: "init-error";
+    /** Human-readable error message. */
+    error: string;
+}
+export type WorkerOutbound = EmbedResult | EmbedError | InitError;
+/** Passed to the worker via `workerData` at construction time. */
+export interface WorkerInitData {
+    /** fastembed model name, e.g. "BGESmallENV15". */
+    modelName: string;
+    /** Vendored model info for binary mode, or null for npm mode.
+     *  Mirrors the `globalThis.__LORE_VENDOR_MODEL__` registration which
+     *  only exists on the main thread — passed explicitly so the worker
+     *  can hand it to `FlagEmbedding.init()`. */
+    vendorModel: {
+        modelAbsoluteDirPath: string;
+        modelName: string;
+    } | null;
+}
+//# sourceMappingURL=embedding-worker-types.d.ts.map

package/dist/bun/embedding-worker-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-worker-types.d.ts","sourceRoot":"","sources":["../../src/embedding-worker-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,kCAAkC;AAClC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,sDAAsD;IACtD,EAAE,EAAE,MAAM,CAAC;IACX,sBAAsB;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,kDAAkD;IAClD,SAAS,EAAE,UAAU,GAAG,OAAO,CAAC;IAChC,qEAAqE;IACrE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC;CAC7B;AAED,sCAAsC;AACtC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,eAAe,CAAC;AAM3D,gFAAgF;AAChF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX;gEAC4D;IAC5D,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,wDAAwD;AACxD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;4DAC4D;AAC5D,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,YAAY,CAAC;IACnB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;AAMlE,kEAAkE;AAClE,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB;;;iDAG6C;IAC7C,WAAW,EAAE;QAAE,oBAAoB,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACzE"}

package/dist/bun/embedding-worker.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Embedding worker thread — runs fastembed/ONNX inference off the main thread.
+ *
+ * This file is the entry point for a `node:worker_threads` Worker spawned by
+ * `LocalProvider` in `embedding.ts`. It owns the `FlagEmbedding` ONNX model
+ * and processes embed requests sequentially from a priority queue. Moving
+ * inference here keeps the main thread's event loop free — HTTP requests,
+ * SSE streams, and session APIs are no longer blocked during embedding.
+ *
+ * Communication uses `parentPort` message passing with structured clone.
+ * Float32Array vectors are sent back directly (Bun preserves identity).
+ *
+ * @see embedding-worker-types.ts for the message protocol.
+ */
+export {};
+//# sourceMappingURL=embedding-worker.d.ts.map

package/dist/bun/embedding-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-worker.d.ts","sourceRoot":"","sources":["../../src/embedding-worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}