@loreai/core 0.0.1 → 0.10.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 BYK
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,7 +1,28 @@
 # @loreai/core
 
-> Placeholder release — not yet functional.
->
-> The real release follows shortly via CI.
->
-> See [github.com/BYK/opencode-lore](https://github.com/BYK/loreai) for details.
+> **Experimental** — Under active development. APIs, storage format, and behavior may change.
+
+Shared memory engine for [Lore](https://github.com/BYK/loreai) — three-tier storage, distillation, curation, gradient context management, and FTS5-backed recall.
+
+This package is host-agnostic. It doesn't ship a user-facing extension on its own; it's consumed by adapter packages that wire it into a specific coding agent:
+
+- [`@loreai/opencode`](https://www.npmjs.com/package/@loreai/opencode) — [OpenCode](https://opencode.ai) plugin (also published as [`opencode-lore`](https://www.npmjs.com/package/opencode-lore) legacy alias)
+- [`@loreai/pi`](https://www.npmjs.com/package/@loreai/pi) — [Pi coding-agent](https://github.com/badlogic/pi-mono) extension
+
+## Install
+
+```bash
+npm install @loreai/core
+# or
+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.
+
+## Documentation
+
+Full architecture, benchmarks, and rationale: **[github.com/BYK/loreai](https://github.com/BYK/loreai)**
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

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

@@ -0,0 +1,59 @@
+/**
+ * agents-file.ts — AGENTS.md export/import/sync for lore.
+ *
+ * Lore owns a clearly delimited section inside the file, bounded by HTML
+ * comment markers. Everything outside those markers is preserved verbatim.
+ * Each knowledge entry is preceded by a hidden <!-- lore:UUID --> comment so
+ * the same entry can be tracked across machines and merge conflicts resolved
+ * without duplication.
+ */
+export declare const LORE_SECTION_START = "<!-- This section is maintained by the coding agent via lore (https://github.com/BYK/loreai) -->";
+export declare const LORE_SECTION_END = "<!-- End lore-managed section -->";
+export type ParsedFileEntry = {
+    /** UUID from `<!-- lore:UUID -->` marker, or null for hand-written entries. */
+    id: string | null;
+    category: string;
+    title: string;
+    content: string;
+};
+/**
+ * Extract ParsedFileEntry objects from a markdown section body.
+ * Handles:
+ * - `<!-- lore:UUID -->` markers before bullet points  → id set
+ * - Bare bullet points without markers                → id null
+ * - Category derived from the nearest preceding `### Heading`
+ * - Malformed or non-UUID markers                    → id null (hand-written)
+ * - Duplicate UUIDs                                  → both returned; caller deduplicates
+ */
+export declare function parseEntriesFromSection(section: string): ParsedFileEntry[];
+/**
+ * Write current knowledge entries into the AGENTS.md file, preserving all
+ * non-lore content. Creates the file if it doesn't exist.
+ */
+export declare function exportToFile(input: {
+    projectPath: string;
+    filePath: string;
+}): void;
+/**
+ * Returns true if the file needs to be imported:
+ * - File exists and has never been processed (no lore markers)
+ * - File exists and its lore section differs from what lore would currently produce
+ */
+export declare function shouldImport(input: {
+    projectPath: string;
+    filePath: string;
+}): boolean;
+/**
+ * Import knowledge entries from the agents file into the local DB.
+ *
+ * Behaviour per entry:
+ * - Known UUID (already in DB)  → update content if it changed (manual edit)
+ * - Unknown UUID (other machine)→ create with that exact ID
+ * - No UUID (hand-written)      → create with a new UUIDv7
+ * - Duplicate UUID in same file → first occurrence wins, rest ignored
+ */
+export declare function importFromFile(input: {
+    projectPath: string;
+    filePath: string;
+}): void;
+//# sourceMappingURL=agents-file.d.ts.map

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

@@ -0,0 +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;AAyBpE,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;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CAsBP;AAMD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAcV;AAMD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CA2DP"}

package/dist/bun/config.d.ts

@@ -0,0 +1,58 @@
+import { z } from "zod";
+export declare const LoreConfig: z.ZodObject<{
+    model: z.ZodOptional<z.ZodObject<{
+        providerID: z.ZodString;
+        modelID: z.ZodString;
+    }, z.core.$strip>>;
+    budget: z.ZodDefault<z.ZodObject<{
+        distilled: z.ZodDefault<z.ZodNumber>;
+        raw: z.ZodDefault<z.ZodNumber>;
+        output: z.ZodDefault<z.ZodNumber>;
+        ltm: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    distillation: z.ZodDefault<z.ZodObject<{
+        minMessages: z.ZodDefault<z.ZodNumber>;
+        maxSegment: z.ZodDefault<z.ZodNumber>;
+        metaThreshold: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    knowledge: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    curator: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        onIdle: z.ZodDefault<z.ZodBoolean>;
+        afterTurns: z.ZodDefault<z.ZodNumber>;
+        maxEntries: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    pruning: z.ZodDefault<z.ZodObject<{
+        retention: z.ZodDefault<z.ZodNumber>;
+        maxStorage: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    search: z.ZodDefault<z.ZodObject<{
+        ftsWeights: z.ZodDefault<z.ZodObject<{
+            title: z.ZodDefault<z.ZodNumber>;
+            content: z.ZodDefault<z.ZodNumber>;
+            category: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+        recallLimit: z.ZodDefault<z.ZodNumber>;
+        queryExpansion: z.ZodDefault<z.ZodBoolean>;
+        embeddings: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            provider: z.ZodDefault<z.ZodEnum<{
+                voyage: "voyage";
+                openai: "openai";
+            }>>;
+            model: z.ZodDefault<z.ZodString>;
+            dimensions: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    crossProject: z.ZodDefault<z.ZodBoolean>;
+    agentsFile: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        path: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type LoreConfig = z.infer<typeof LoreConfig>;
+export declare function config(): LoreConfig;
+export declare function load(directory: string): Promise<LoreConfig>;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA4GrB,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/curator.d.ts

@@ -0,0 +1,35 @@
+import type { LLMClient } from "./types";
+export declare function run(input: {
+    llm: LLMClient;
+    projectPath: string;
+    sessionID: string;
+    model?: {
+        providerID: string;
+        modelID: string;
+    };
+}): Promise<{
+    created: number;
+    updated: number;
+    deleted: number;
+}>;
+export declare function resetCurationTracker(sessionID?: string): void;
+/**
+ * Consolidation pass: reviews ALL project entries and merges/trims/deletes
+ * to reduce entry count to cfg.curator.maxEntries. Only runs when the current
+ * entry count exceeds the target. Uses the same worker session as curation.
+ *
+ * Only "update" and "delete" ops are applied — consolidation never creates entries.
+ */
+export declare function consolidate(input: {
+    llm: LLMClient;
+    projectPath: string;
+    sessionID: string;
+    model?: {
+        providerID: string;
+        modelID: string;
+    };
+}): Promise<{
+    updated: number;
+    deleted: number;
+}>;
+//# sourceMappingURL=curator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"curator.d.ts","sourceRoot":"","sources":["../../src/curator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AA+CzC,wBAAsB,GAAG,CAAC,KAAK,EAAE;IAC/B,GAAG,EAAE,SAAS,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACjD,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAsFjE;AAED,wBAAgB,oBAAoB,CAAC,SAAS,CAAC,EAAE,MAAM,QAMtD;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE;IACvC,GAAG,EAAE,SAAS,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACjD,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAsDhD"}

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

@@ -0,0 +1,5 @@
+import { Database } from "bun:sqlite";
+export { Database };
+/** Stable SHA-256 hex digest — replaces the Bun-only `Bun.CryptoHasher`. */
+export declare function sha256(input: string): string;
+//# sourceMappingURL=driver.bun.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"driver.bun.d.ts","sourceRoot":"","sources":["../../../src/db/driver.bun.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,OAAO,EAAE,QAAQ,EAAE,CAAC;AAEpB,4EAA4E;AAC5E,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5C"}

package/dist/bun/db/driver.node.d.ts

@@ -0,0 +1,15 @@
+import { DatabaseSync, type StatementSync } from "node:sqlite";
+/**
+ * Drop-in replacement for `bun:sqlite`'s `Database`.
+ *
+ * Adds a `.query()` method that caches the underlying `StatementSync`
+ * per SQL string. All other methods (`.prepare()`, `.exec()`, `.run()`,
+ * `.close()`, PRAGMAs, transactions) come from `DatabaseSync` unchanged.
+ */
+export declare class Database extends DatabaseSync {
+    /** Cached prepared statement for this SQL. Compiled on first call. */
+    query(sql: string): StatementSync;
+}
+/** Stable SHA-256 hex digest — replaces the Bun-only `Bun.CryptoHasher`. */
+export declare function sha256(input: string): string;
+//# sourceMappingURL=driver.node.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"driver.node.d.ts","sourceRoot":"","sources":["../../../src/db/driver.node.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAgB/D;;;;;;GAMG;AACH,qBAAa,QAAS,SAAQ,YAAY;IACxC,sEAAsE;IACtE,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa;CAalC;AAED,4EAA4E;AAC5E,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5C"}

package/dist/bun/db.d.ts

@@ -0,0 +1,22 @@
+import { Database } from "#db/driver";
+export declare function db(): Database;
+export declare function close(): void;
+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. */
+export declare function projectName(id: string): string | null;
+/**
+ * Returns true if Lore has never been used before (no projects in the DB).
+ * Must be called before ensureProject() to get an accurate result.
+ */
+export declare function isFirstRun(): boolean;
+/**
+ * Load persisted forceMinLayer for a session. Returns 0 if none stored.
+ */
+export declare function loadForceMinLayer(sessionID: string): number;
+/**
+ * Persist forceMinLayer for a session. Deletes the row when layer is 0
+ * (consumed) to avoid unbounded growth.
+ */
+export declare function saveForceMinLayer(sessionID: string, layer: number): void;
+//# sourceMappingURL=db.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/db.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAqStC,wBAAgB,EAAE,IAAI,QAAQ,CAwB7B;AAqCD,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"}

package/dist/bun/distillation.d.ts

@@ -0,0 +1,32 @@
+import { workerSessionIDs } from "./worker";
+import type { LLMClient } from "./types";
+export { workerSessionIDs };
+/** Safely parse the source_ids JSON column. Defaults to [] on corrupt data. */
+export declare function parseSourceIds(raw: string): string[];
+export type Distillation = {
+    id: string;
+    project_id: string;
+    session_id: string;
+    observations: string;
+    source_ids: string[];
+    generation: number;
+    token_count: number;
+    created_at: number;
+};
+/** Load all distillations for a session, oldest first. */
+export declare function loadForSession(projectPath: string, sessionID: string): Distillation[];
+export declare function run(input: {
+    llm: LLMClient;
+    projectPath: string;
+    sessionID: string;
+    model?: {
+        providerID: string;
+        modelID: string;
+    };
+    /** Skip minMessages threshold check — distill whatever is pending */
+    force?: boolean;
+}): Promise<{
+    rounds: number;
+    distilled: number;
+}>;
+//# sourceMappingURL=distillation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"distillation.d.ts","sourceRoot":"","sources":["../../src/distillation.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGzC,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAuE5B,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAQpD;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,0DAA0D;AAC1D,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,YAAY,EAAE,CAoBhB;AAuID,wBAAsB,GAAG,CAAC,KAAK,EAAE;IAC/B,GAAG,EAAE,SAAS,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,qEAAqE;IACrE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CA4DjD"}

package/dist/bun/embedding.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Embedding integration for vector search.
+ *
+ * Supports multiple embedding providers (Voyage AI, OpenAI) behind a common
+ * interface. Provides embedding generation, pure-JS cosine similarity, and
+ * vector search over the knowledge and distillation tables. All operations
+ * are gated behind `search.embeddings.enabled` config + the provider's API
+ * key env var — falls back silently to FTS-only when unavailable.
+ */
+export interface EmbeddingProvider {
+    embed(texts: string[], inputType: "document" | "query"): Promise<Float32Array[]>;
+    readonly maxBatchSize: number;
+}
+/** Reset cached provider — called when config changes. */
+export declare function resetProvider(): void;
+/** Returns true if embedding is available.
+ *  Active when the configured provider's API key is set, unless explicitly
+ *  disabled via `search.embeddings.enabled: false` in .lore.json. */
+export declare function isAvailable(): boolean;
+/**
+ * Generate embeddings for the given texts using the configured provider.
+ *
+ * @param texts     Array of texts to embed
+ * @param inputType "document" for storage, "query" for search
+ * @returns         Float32Array per input text
+ * @throws          On API errors or missing provider
+ */
+export declare function embed(texts: string[], inputType: "document" | "query"): Promise<Float32Array[]>;
+/**
+ * Cosine similarity between two Float32Array vectors.
+ * Returns -1.0 to 1.0 where 1.0 = identical direction.
+ * Returns 0 if either vector is zero-length.
+ */
+export declare function cosineSimilarity(a: Float32Array, b: Float32Array): number;
+/** Convert Float32Array to Buffer for SQLite BLOB storage. */
+export declare function toBlob(arr: Float32Array): Buffer;
+/** Convert SQLite BLOB (Buffer/Uint8Array) back to Float32Array. */
+export declare function fromBlob(blob: Buffer | Uint8Array): Float32Array;
+type VectorHit = {
+    id: string;
+    similarity: number;
+};
+/**
+ * Search all knowledge entries with embeddings by cosine similarity.
+ * Returns top-k entries sorted by similarity descending.
+ * Pure brute-force — fine for <100 entries (microseconds).
+ */
+export declare function vectorSearch(queryEmbedding: Float32Array, limit?: number): VectorHit[];
+/**
+ * Search non-archived distillations with embeddings by cosine similarity.
+ * Returns top-k entries sorted by similarity descending.
+ * Pure brute-force — fine for ~50 entries.
+ */
+export declare function vectorSearchDistillations(queryEmbedding: Float32Array, limit?: number): VectorHit[];
+/**
+ * Embed a knowledge entry and store the result in the DB.
+ * Fire-and-forget — errors are logged, never thrown.
+ * The entry remains usable via FTS even if embedding fails.
+ */
+export declare function embedKnowledgeEntry(id: string, title: string, content: string): void;
+/**
+ * Embed a distillation and store the result in the DB.
+ * Fire-and-forget — errors are logged, never thrown.
+ * The distillation remains searchable via FTS even if embedding fails.
+ */
+export declare function embedDistillation(id: string, observations: string): void;
+/**
+ * Check if embedding config has changed since the last backfill.
+ * If so, clear all existing embeddings (they're incompatible) and
+ * update the stored fingerprint.
+ *
+ * Returns true if embeddings were cleared (full re-embed needed).
+ */
+export declare function checkConfigChange(): boolean;
+/**
+ * Embed all knowledge entries that are missing embeddings.
+ * Called on startup when embeddings are first enabled.
+ * Also handles config changes: if provider/model/dimensions changed, clears
+ * stale embeddings first, then re-embeds all entries.
+ * Returns the number of entries embedded.
+ */
+export declare function backfillEmbeddings(): Promise<number>;
+/**
+ * Embed all non-archived distillations that are missing embeddings.
+ * Called on startup alongside knowledge backfill.
+ * Returns the number of distillations embedded.
+ */
+export declare function backfillDistillationEmbeddings(): Promise<number>;
+export {};
+//# sourceMappingURL=embedding.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"embedding.d.ts","sourceRoot":"","sources":["../../src/embedding.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACjF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAoKD,0DAA0D;AAC1D,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAMD;;qEAEqE;AACrE,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAMD;;;;;;;GAOG;AACH,wBAAsB,KAAK,CACzB,KAAK,EAAE,MAAM,EAAE,EACf,SAAS,EAAE,UAAU,GAAG,OAAO,GAC9B,OAAO,CAAC,YAAY,EAAE,CAAC,CAIzB;AAMD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,MAAM,CAazE;AAMD,8DAA8D;AAC9D,wBAAgB,MAAM,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAEhD;AAED,oEAAoE;AACpE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,CAGhE;AAMD,KAAK,SAAS,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpD;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,cAAc,EAAE,YAAY,EAC5B,KAAK,SAAK,GACT,SAAS,EAAE,CAcb;AAMD;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,cAAc,EAAE,YAAY,EAC5B,KAAK,SAAK,GACT,SAAS,EAAE,CAgBb;AAMD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GACd,IAAI,CAWN;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,MAAM,EACV,YAAY,EAAE,MAAM,GACnB,IAAI,CAUN;AAkBD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAoC3C;AAMD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAuC1D;AAMD;;;;GAIG;AACH,wBAAsB,8BAA8B,IAAI,OAAO,CAAC,MAAM,CAAC,CAsCtE"}

package/dist/bun/gradient.d.ts

@@ -0,0 +1,73 @@
+import type { LoreMessageWithParts } from "./types";
+type MessageWithParts = LoreMessageWithParts;
+export declare function setModelLimits(limits: {
+    context: number;
+    output: number;
+}): void;
+/** Called by the system transform hook after formatting LTM knowledge. */
+export declare function setLtmTokens(tokens: number): void;
+/** Returns the current LTM token count (for tests and diagnostics). */
+export declare function getLtmTokens(): number;
+/**
+ * Returns the token budget available for LTM system-prompt injection.
+ * This is the usable context (after output + overhead) multiplied by
+ * the configured ltm budget fraction. Call this from the system transform
+ * hook to cap how many tokens formatKnowledge may use.
+ */
+export declare function getLtmBudget(ltmFraction: number): number;
+export declare function calibrate(actualInput: number, sessionID?: string, messageCount?: number): void;
+export declare function getOverhead(): number;
+/**
+ * Returns the number of messages in the most recent transform() output for
+ * the given session. Used by calibrate() to track the compressed window size.
+ */
+export declare function getLastTransformedCount(sessionID: string): number;
+/** Returns the token estimate from the most recent transform() output. */
+export declare function getLastTransformEstimate(sessionID: string): number;
+/** Returns the layer used by the most recent transform() call. For testing. */
+export declare function getLastLayer(sessionID?: string): SafetyLayer;
+/**
+ * Force the next transform() call for this session to use at least the given layer.
+ * Called when the API returns "prompt is too long" so the next attempt
+ * trims the context enough to fit within the model's context window.
+ */
+export declare function setForceMinLayer(layer: SafetyLayer, sessionID?: string): void;
+export declare function resetCalibration(sessionID?: string): void;
+/**
+ * Replace duplicate tool outputs with compact back-references, keeping only
+ * the latest occurrence of each unique output. Reduces context token usage
+ * without information loss — the model sees the most recent content intact.
+ *
+ * Deduplicates by:
+ * 1. Exact content hash: identical tool outputs (same file read twice, same command output)
+ * 2. Same-file reads: read_file outputs for the same path (content may differ due to edits)
+ *
+ * The current turn (from currentTurnIdx onward) is never touched — the model
+ * needs full context for its active work. Tool parts are never removed entirely;
+ * only state.output is replaced with a compact annotation.
+ *
+ * Returns the original array reference (not a copy) when no duplicates exist.
+ */
+export declare function deduplicateToolOutputs(messages: MessageWithParts[], currentTurnIdx: number): MessageWithParts[];
+export declare function resetPrefixCache(sessionID?: string): void;
+export declare function resetRawWindowCache(sessionID?: string): void;
+export type SafetyLayer = 0 | 1 | 2 | 3 | 4;
+export type TransformResult = {
+    messages: MessageWithParts[];
+    layer: SafetyLayer;
+    distilledTokens: number;
+    rawTokens: number;
+    totalTokens: number;
+    usable: number;
+    distilledBudget: number;
+    rawBudget: number;
+};
+export declare function needsUrgentDistillation(): boolean;
+export declare function transform(input: {
+    messages: MessageWithParts[];
+    projectPath: string;
+    sessionID?: string;
+}): TransformResult;
+export declare function estimateMessages(messages: MessageWithParts[]): number;
+export {};
+//# sourceMappingURL=gradient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gradient.d.ts","sourceRoot":"","sources":["../../src/gradient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAyB,oBAAoB,EAAqE,MAAM,SAAS,CAAC;AAO9I,KAAK,gBAAgB,GAAG,oBAAoB,CAAC;AAmH7C,wBAAgB,cAAc,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,QASzE;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,QAE1C;AAED,uEAAuE;AACvE,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAIxD;AAWD,wBAAgB,SAAS,CACvB,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,MAAM,QA2BtB;AAED,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,0EAA0E;AAC1E,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,WAAW,CAK5D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,MAAM,QAWtE;AAGD,wBAAgB,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,QAWlD;AA0ID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,cAAc,EAAE,MAAM,GACrB,gBAAgB,EAAE,CA0EpB;AA4YD,wBAAgB,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,QAOlD;AA0BD,wBAAgB,mBAAmB,CAAC,SAAS,CAAC,EAAE,MAAM,QAOrD;AAuFD,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAE5C,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,KAAK,EAAE,WAAW,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IAEpB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAIF,wBAAgB,uBAAuB,IAAI,OAAO,CAIjD;AAiPD,wBAAgB,SAAS,CAAC,KAAK,EAAE;IAC/B,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,eAAe,CAiBlB;AAGD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAErE"}

package/dist/bun/index.d.ts

@@ -0,0 +1,19 @@
+export * as temporal from "./temporal";
+export * as ltm from "./ltm";
+export * as distillation from "./distillation";
+export * as curator from "./curator";
+export * as embedding from "./embedding";
+export * as latReader from "./lat-reader";
+export * as log from "./log";
+export { runRecall, RECALL_TOOL_DESCRIPTION, RECALL_PARAM_DESCRIPTIONS, type RecallInput, type RecallResult, type RecallScope, type ScoredDistillation, } from "./recall";
+export type { LoreMessage, LoreUserMessage, LoreAssistantMessage, LorePart, LoreTextPart, LoreReasoningPart, LoreToolPart, LoreGenericPart, LoreToolState, LoreToolStatePending, LoreToolStateRunning, LoreToolStateCompleted, LoreToolStateError, LoreMessageWithParts, LLMClient, } from "./types";
+export { isTextPart, isReasoningPart, isToolPart } from "./types";
+export { load, config, type LoreConfig } from "./config";
+export { db, ensureProject, isFirstRun, projectId, projectName, loadForceMinLayer, saveForceMinLayer, close, } from "./db";
+export { transform, setModelLimits, needsUrgentDistillation, calibrate, setLtmTokens, getLtmTokens, getLtmBudget, setForceMinLayer, getLastTransformedCount, getLastTransformEstimate, } from "./gradient";
+export { formatKnowledge, formatDistillations, DISTILLATION_SYSTEM, distillationUser, RECURSIVE_SYSTEM, recursiveUser, CURATOR_SYSTEM, curatorUser, CONSOLIDATION_SYSTEM, consolidationUser, QUERY_EXPANSION_SYSTEM, } from "./prompt";
+export { shouldImport, importFromFile, exportToFile } from "./agents-file";
+export { workerSessionIDs, isWorkerSession } from "./worker";
+export { ftsQuery, ftsQueryOr, EMPTY_QUERY, reciprocalRankFusion, expandQuery, extractTopTerms, } from "./search";
+export { serialize, inline, h, p, ul, lip, liph, t, root, strong, normalize, sanitizeSurrogates, unescapeMarkdown, } from "./markdown";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,GAAG,MAAM,OAAO,CAAC;AAC7B,OAAO,KAAK,YAAY,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,SAAS,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,GAAG,MAAM,OAAO,CAAC;AAE7B,OAAO,EACL,SAAS,EACT,uBAAuB,EACvB,yBAAyB,EACzB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,kBAAkB,GACxB,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,QAAQ,EACR,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,SAAS,GACV,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAElE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EACL,EAAE,EACF,aAAa,EACb,UAAU,EACV,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,GACN,MAAM,MAAM,CAAC;AACd,OAAO,EACL,SAAS,EACT,cAAc,EACd,uBAAuB,EACvB,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC7D,OAAO,EACL,QAAQ,EACR,UAAU,EACV,WAAW,EACX,oBAAoB,EACpB,WAAW,EACX,eAAe,GAChB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,SAAS,EACT,MAAM,EACN,CAAC,EACD,CAAC,EACD,EAAE,EACF,GAAG,EACH,IAAI,EACJ,CAAC,EACD,IAAI,EACJ,MAAM,EACN,SAAS,EACT,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}