opensquid 0.5.395

package/dist/rag/config.js

@@ -0,0 +1,127 @@
+/**
+ * RAG backend configuration resolver.
+ *
+ * Decides which backend `buildRegistry()` instantiates for the host
+ * runtime. Resolution chain (first match wins):
+ *
+ *   1. `OPENSQUID_RAG_BACKEND` env var — explicit override (test seam +
+ *      user pinning). Accepts: `loop-engine` | `libsql-qwen3` |
+ *      `libsql-fastembed` | `libsql-lexical` | `claude-auto-memory`. Unknown
+ *      values surface as an error at boot rather than silently defaulting.
+ *   2. `~/.opensquid/rag-config.json` — persisted user choice. Same kind
+ *      vocabulary. Phase 1 ships read-only; setup wizard writes it.
+ *   3. Default: `loop-engine` when the engine binary is discoverable
+ *      via `resolveEngineBin()`; else `libsql-fastembed` (self-contained
+ *      in-process embedder — works out-of-box with NO Ollama; E2-validated
+ *      recall parity with Qwen3). `libsql-qwen3` stays available via override.
+ *
+ * The discoverability check is non-blocking — if the engine binary
+ * lookup throws, we fall back to libsql-fastembed with a stderr note. This
+ * keeps boot resilient to a half-migrated engine path while still
+ * preferring the engine when it's wired up correctly.
+ *
+ * Each variant's tunable opts (`dbUrl`, `ollamaUrl`, `mode`) accept
+ * config-file overrides. Sensible defaults baked in so a missing
+ * config file produces a working backend without any user setup.
+ *
+ * Imports from: ../engine/config.js, ./backend_factory.js.
+ * Imported by: src/runtime/bootstrap.ts.
+ */
+import { promises as fs } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+const RAG_CONFIG_FILENAME = 'rag-config.json';
+function opensquidHome() {
+    const env = process.env.OPENSQUID_HOME?.trim();
+    return env && env.length > 0 ? env : join(homedir(), '.opensquid');
+}
+function ragConfigPath() {
+    return join(opensquidHome(), RAG_CONFIG_FILENAME);
+}
+/**
+ * Resolve the backend config for `buildRegistry()`. Always returns a
+ * usable config — never null. Logs to stderr when falling back to the
+ * libsql default after an engine binary lookup miss so users see why
+ * their preferred backend isn't active.
+ */
+export async function resolveBackendConfig() {
+    const fromEnv = process.env.OPENSQUID_RAG_BACKEND?.trim();
+    const persisted = await loadPersisted();
+    // Order: env > persisted > default. Each layer can supply opts the
+    // others don't (env picks kind; persisted supplies dbUrl/ollamaUrl).
+    const kind = fromEnv ?? persisted.kind ?? pickDefaultKind();
+    switch (kind) {
+        case 'loop-engine':
+            // retire-Rust (RES-1): the loop-engine backend is removed. A stale env/persisted
+            // `loop-engine` pin degrades gracefully to libsql-fastembed instead of failing.
+            process.stderr.write('[opensquid] loop-engine backend has been removed (retire-Rust); ' +
+                'falling back to libsql-fastembed.\n');
+            return {
+                kind: 'libsql-fastembed',
+                dbUrl: persisted.dbUrl ?? defaultLibsqlUrl(),
+                sourceDir: join(opensquidHome(), 'store', 'lessons'),
+            };
+        case 'libsql-qwen3':
+            return {
+                kind: 'libsql-qwen3',
+                dbUrl: persisted.dbUrl ?? defaultLibsqlUrl(),
+                ollamaUrl: persisted.ollamaUrl ?? 'http://localhost:11434',
+                ...(persisted.embedderModel === undefined
+                    ? {}
+                    : { embedderModel: persisted.embedderModel }),
+            };
+        case 'libsql-lexical':
+            return { kind: 'libsql-lexical', dbUrl: persisted.dbUrl ?? defaultLibsqlUrl() };
+        case 'libsql-fastembed':
+            return {
+                kind: 'libsql-fastembed',
+                dbUrl: persisted.dbUrl ?? defaultLibsqlUrl(),
+                // Per-file git source-of-truth (T-STORE-PERFILE-SOURCE) under the opensquid home; the DB
+                // at dbUrl is the derived, rebuildable index.
+                sourceDir: join(opensquidHome(), 'store', 'lessons'),
+            };
+        case 'claude-auto-memory':
+            return { kind: 'claude-auto-memory' };
+        default:
+            throw new Error(`Unknown RAG backend kind: ${kind}. ` +
+                `Expected one of: libsql-qwen3, libsql-fastembed, libsql-lexical, claude-auto-memory.`);
+    }
+}
+async function loadPersisted() {
+    let raw;
+    try {
+        raw = await fs.readFile(ragConfigPath(), 'utf8');
+    }
+    catch (e) {
+        // Missing file is the common-case (no user override) — silent. Any
+        // other read error (EACCES, EIO, etc.) is unusual — warn so users
+        // know why their persisted backend choice isn't being picked up.
+        const code = e.code;
+        if (code !== 'ENOENT') {
+            process.stderr.write(`[opensquid] rag-config read failed at ${ragConfigPath()} (${String(e)}); ` +
+                `using defaults.\n`);
+        }
+        return {};
+    }
+    try {
+        return JSON.parse(raw);
+    }
+    catch (e) {
+        // Parse-error path is loud — a typo silently downgrading the user's
+        // chosen backend was the bug A.04 addresses. Return {} to keep boot
+        // resilient but surface the cause so users can fix the file.
+        process.stderr.write(`[opensquid] rag-config parse failed at ${ragConfigPath()} (${String(e)}); ` +
+            `using defaults — fix or delete the file to silence this warning.\n`);
+        return {};
+    }
+}
+// retire-Rust (RES-1): libSQL/fastembed (in-process, no Ollama) is the UNCONDITIONAL
+// default backend. Engine-binary presence no longer changes RAG selection — the
+// loop-engine backend has been removed.
+function pickDefaultKind() {
+    return 'libsql-fastembed';
+}
+function defaultLibsqlUrl() {
+    return `file:${join(opensquidHome(), 'rag.sqlite')}`;
+}
+//# sourceMappingURL=config.js.map

package/dist/rag/config.js.map

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

package/dist/rag/embedders/fastembed.d.ts

@@ -0,0 +1,3 @@
+import type { Embedder } from './types.js';
+export declare function fastembedEmbedder(): Embedder;
+//# sourceMappingURL=fastembed.d.ts.map

package/dist/rag/embedders/fastembed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fastembed.d.ts","sourceRoot":"","sources":["../../../src/rag/embedders/fastembed.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAa3C,wBAAgB,iBAAiB,IAAI,QAAQ,CA+B5C"}

package/dist/rag/embedders/fastembed.js

@@ -0,0 +1,51 @@
+/**
+ * fastembed embedder — in-process text→vector via fastembed-js (bge-small-en-v1.5, 384d).
+ * No Ollama, no Python, no daemon (confirmed by spike E0: init ~6.5s one-time model load,
+ * ~112ms for 2 strings, dim 384). This is the self-contained OSS-local embedder.
+ *
+ * The model loads lazily on first `embed()` (the one-time ~6.5s download+load is a startup
+ * cost, not per-call) and is cached for the process. `fastembed` is imported dynamically so a
+ * host that never selects this embedder pays nothing for the native onnxruntime dependency.
+ * Same one-way `up` latch as the Ollama embedder: on failure, degrade to `null` for the session.
+ *
+ * Imported by: src/rag/backend_factory.ts (the `libsql-fastembed` arm).
+ */
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+// Cache the downloaded model under opensquid's home, NOT the process CWD (fastembed's default
+// `local_cache/` would otherwise dump model files into the user's project tree).
+function modelCacheDir() {
+    const home = process.env.OPENSQUID_HOME?.trim();
+    return join(home && home.length > 0 ? home : join(homedir(), '.opensquid'), 'models');
+}
+export function fastembedEmbedder() {
+    let model = null;
+    let up = true;
+    return {
+        dim: 384, // bge-small-en-v1.5
+        async embed(text) {
+            if (!up)
+                return null;
+            try {
+                if (model === null) {
+                    const { FlagEmbedding, EmbeddingModel } = (await import('fastembed'));
+                    model = await FlagEmbedding.init({
+                        model: EmbeddingModel.BGESmallENV15,
+                        cacheDir: modelCacheDir(),
+                    });
+                }
+                for await (const batch of model.embed([text])) {
+                    const v = batch[0];
+                    if (v !== undefined)
+                        return Array.from(v);
+                }
+                return null;
+            }
+            catch {
+                up = false;
+                return null;
+            }
+        },
+    };
+}
+//# sourceMappingURL=fastembed.js.map

package/dist/rag/embedders/fastembed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fastembed.js","sourceRoot":"","sources":["../../../src/rag/embedders/fastembed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAQjC,8FAA8F;AAC9F,iFAAiF;AACjF,SAAS,aAAa;IACpB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC;IAChD,OAAO,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,EAAE,QAAQ,CAAC,CAAC;AACxF,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,IAAI,KAAK,GAA0B,IAAI,CAAC;IACxC,IAAI,EAAE,GAAG,IAAI,CAAC;IACd,OAAO;QACL,GAAG,EAAE,GAAG,EAAE,oBAAoB;QAC9B,KAAK,CAAC,KAAK,CAAC,IAAY;YACtB,IAAI,CAAC,EAAE;gBAAE,OAAO,IAAI,CAAC;YACrB,IAAI,CAAC;gBACH,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBACnB,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,GAAG,CAAC,MAAM,MAAM,CAAC,WAAW,CAAC,CAKnE,CAAC;oBACF,KAAK,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC;wBAC/B,KAAK,EAAE,cAAc,CAAC,aAAa;wBACnC,QAAQ,EAAE,aAAa,EAAE;qBAC1B,CAAC,CAAC;gBACL,CAAC;gBACD,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;oBAC9C,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;oBACnB,IAAI,CAAC,KAAK,SAAS;wBAAE,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAC5C,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,MAAM,CAAC;gBACP,EAAE,GAAG,KAAK,CAAC;gBACX,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/rag/embedders/ollama_qwen3.d.ts

@@ -0,0 +1,6 @@
+import type { Embedder } from './types.js';
+export declare function ollamaQwen3Embedder(opts: {
+    ollamaUrl: string;
+    model?: string;
+}): Embedder;
+//# sourceMappingURL=ollama_qwen3.d.ts.map

package/dist/rag/embedders/ollama_qwen3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama_qwen3.d.ts","sourceRoot":"","sources":["../../../src/rag/embedders/ollama_qwen3.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,QAAQ,CAgBzF"}

package/dist/rag/embedders/ollama_qwen3.js

@@ -0,0 +1,30 @@
+/**
+ * Ollama/Qwen3 embedder — wraps `ollamaEmbed` as an `Embedder`. Preserves the exact behavior
+ * the shipped `libsql_qwen3` backend had inline: a one-way `up` latch that flips to `false` on
+ * the first throw (Ollama down / model not pulled / network) so subsequent calls short-circuit
+ * to `null` without re-paying worst-case latency for the session.
+ *
+ * Imports from: ../ollama_client.js, ./types.js.
+ * Imported by: src/rag/backend_factory.ts (the `libsql-qwen3` arm).
+ */
+import { QWEN3_DIM, ollamaEmbed } from '../ollama_client.js';
+export function ollamaQwen3Embedder(opts) {
+    let up = true;
+    return {
+        dim: QWEN3_DIM,
+        async embed(text) {
+            if (!up)
+                return null;
+            try {
+                return opts.model === undefined
+                    ? await ollamaEmbed(opts.ollamaUrl, text)
+                    : await ollamaEmbed(opts.ollamaUrl, text, opts.model);
+            }
+            catch {
+                up = false;
+                return null;
+            }
+        },
+    };
+}
+//# sourceMappingURL=ollama_qwen3.js.map

package/dist/rag/embedders/ollama_qwen3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama_qwen3.js","sourceRoot":"","sources":["../../../src/rag/embedders/ollama_qwen3.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAI7D,MAAM,UAAU,mBAAmB,CAAC,IAA2C;IAC7E,IAAI,EAAE,GAAG,IAAI,CAAC;IACd,OAAO;QACL,GAAG,EAAE,SAAS;QACd,KAAK,CAAC,KAAK,CAAC,IAAY;YACtB,IAAI,CAAC,EAAE;gBAAE,OAAO,IAAI,CAAC;YACrB,IAAI,CAAC;gBACH,OAAO,IAAI,CAAC,KAAK,KAAK,SAAS;oBAC7B,CAAC,CAAC,MAAM,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC;oBACzC,CAAC,CAAC,MAAM,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1D,CAAC;YAAC,MAAM,CAAC;gBACP,EAAE,GAAG,KAAK,CAAC;gBACX,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/rag/embedders/types.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Embedder: the injectable text→vector dependency for the libSQL store backend.
+ *
+ * Extracted (T-STORE-FOUNDATION-LIBSQL) so the shipped libSQL backend is no longer
+ * hard-coupled to Ollama/Qwen3 — the only Ollama coupling was the embedder (bounded by the
+ * single `{ QWEN3_DIM, ollamaEmbed }` import in libsql_qwen3.ts). Two impls ship:
+ * `ollamaQwen3Embedder` (the existing path, behavior preserved) and `fastembedEmbedder`
+ * (in-process bge-small, no daemon — the self-contained OSS-local path).
+ *
+ * `embed()` returns `Promise<number[] | null>` — `null` means the embedder is unavailable
+ * (the backend degrades to lexical-only), matching the `RagBackend.embed` contract. `dim` is
+ * the vector dimension, used to declare the `F32_BLOB(dim)` column.
+ *
+ * Imported by: src/rag/backends/libsql_store.ts, src/rag/embedders/*.
+ */
+export interface Embedder {
+    embed(text: string): Promise<number[] | null>;
+    readonly dim: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/rag/embedders/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/rag/embedders/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;IAC9C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB"}

package/dist/rag/embedders/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/rag/embedders/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/rag/embedders/types.ts"],"names":[],"mappings":""}

package/dist/rag/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * RAG: pluggable backend dispatching abstract primitives (recall, embed,
+ * store_lesson) to libsql-qwen3 default, libsql-lexical fallback (Task 1.11),
+ * or the claude-auto-memory adapter (Task 1.12).
+ *
+ * Public surface: types, the factory, and RRF (so consumers can fuse
+ * additional ranked lists if they extend recall). Backends themselves
+ * are NOT re-exported — packs route through the factory, never import
+ * a concrete backend directly.
+ *
+ * Imports from: nothing in src/ (sibling layer).
+ * Imported by: runtime/, setup/, mcp/.
+ */
+export type { BackendConfig, QwenWithFallbackOpts } from './backend_factory.js';
+export { createBackend, libsqlQwen3WithLexicalFallback } from './backend_factory.js';
+export { rrfFuse } from './rrf.js';
+export type { Lesson, RagBackend, RecallHit } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rag/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/rag/index.js

@@ -0,0 +1,16 @@
+/**
+ * RAG: pluggable backend dispatching abstract primitives (recall, embed,
+ * store_lesson) to libsql-qwen3 default, libsql-lexical fallback (Task 1.11),
+ * or the claude-auto-memory adapter (Task 1.12).
+ *
+ * Public surface: types, the factory, and RRF (so consumers can fuse
+ * additional ranked lists if they extend recall). Backends themselves
+ * are NOT re-exported — packs route through the factory, never import
+ * a concrete backend directly.
+ *
+ * Imports from: nothing in src/ (sibling layer).
+ * Imported by: runtime/, setup/, mcp/.
+ */
+export { createBackend, libsqlQwen3WithLexicalFallback } from './backend_factory.js';
+export { rrfFuse } from './rrf.js';
+//# sourceMappingURL=index.js.map

package/dist/rag/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rag/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,aAAa,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC"}

package/dist/rag/memory/compress.d.ts

@@ -0,0 +1,36 @@
+import type { Lesson } from '../types.js';
+/** The memory row compress reads/writes — the libSQL `lessons` (source:'memory') shape EXTENDED with
+ * the two compression columns. No `scope` column: scope is the `scope:<v>` tag. */
+export interface MemoryRow extends Lesson {
+    derivedFrom: string[];
+    consumedByUserLessons: number;
+    embedding?: number[] | null;
+}
+export interface CompressDeps {
+    getMemoryById: (id: string) => Promise<MemoryRow | null>;
+    insertMemory: (m: MemoryRow) => Promise<void>;
+    summarize: (prompt: string) => Promise<string>;
+    embed: (text: string) => Promise<number[] | null>;
+    now: () => Date;
+}
+/** Empty window OR an LLM refusal (an `error` key) — compress.rs maps both to InsufficientInput. */
+export declare class CompressionInsufficientInputError extends Error {
+    constructor(message?: string);
+}
+export declare class CompressionScopeMismatchError extends Error {
+    readonly window: string[];
+    constructor(window: string[]);
+}
+export declare class CompressionParseError extends Error {
+    constructor(message: string);
+}
+export declare class CompressionValidationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Compress a window of memory ids into one minted Mc (NO delete). Throws the typed errors above on
+ * empty input, cycle/over-depth (via cycle.ts), scope mismatch, LLM refusal/parse, or invariant
+ * violation. Predecessors are never mutated.
+ */
+export declare function compress(deps: CompressDeps, ids: string[]): Promise<MemoryRow>;
+//# sourceMappingURL=compress.d.ts.map

package/dist/rag/memory/compress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compress.d.ts","sourceRoot":"","sources":["../../../src/rag/memory/compress.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AA0B1C;mFACmF;AACnF,MAAM,WAAW,SAAU,SAAQ,MAAM;IACvC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IACzD,YAAY,EAAE,CAAC,CAAC,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;IAClD,GAAG,EAAE,MAAM,IAAI,CAAC;CACjB;AAED,oGAAoG;AACpG,qBAAa,iCAAkC,SAAQ,KAAK;gBAC9C,OAAO,SAAiC;CAIrD;AACD,qBAAa,6BAA8B,SAAQ,KAAK;aAC1B,MAAM,EAAE,MAAM,EAAE;gBAAhB,MAAM,EAAE,MAAM,EAAE;CAI7C;AACD,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AACD,qBAAa,0BAA2B,SAAQ,KAAK;gBACvC,OAAO,EAAE,MAAM;CAI5B;AAwDD;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAgDpF"}

package/dist/rag/memory/compress.js

@@ -0,0 +1,158 @@
+/**
+ * Pure memory compression (retire-Rust RES-4a; port of engine compress.rs `compress`). A window of
+ * memories → one summary memory `Mc` carrying `derived_from` + the summed `consumed_by_user_lessons`
+ * counter. compress only INSERTS Mc — it never deletes/mutates predecessors (that is RES-4b's
+ * verified, immunity-gated terminal step). The LLM summarize step uses the host's raw-text
+ * `subagent_call` (the host has NO structured-output path), so this parses JSON out of the raw text
+ * and runs the ported refusal/validation guards.
+ *
+ * Imports from: node:crypto, ./cycle.js.
+ * Imported by: RES-4b (consolidate) — not yet wired.
+ */
+import { createHash } from 'node:crypto';
+import { detectCycleInWindow } from './cycle.js';
+const MAX_DESCRIPTION_CHARS = 200; // compress.rs:42
+const MAX_CONTENT_CHARS = 4_000; // compress.rs:43
+const MAX_DERIVED_FROM_LEN = 64; // compress.rs:44
+const U32_MAX = 0xffffffff;
+const COMPRESSION_PROMPT_TEMPLATE = `You are compressing a window of MEMORIES into ONE summary memory. The summary will replace the originals in the long-tail memory store.
+
+Inputs (each item is one memory, \`--- MEMORY <id> ---\` separator):
+{MEMORIES_BLOCK}
+
+Rules:
+- Preserve key facts, decisions, references, names, paths. Drop ephemera (small talk, exact timestamps, redundant repetitions).
+- Do NOT invent facts not present in the inputs.
+- Do NOT use praise words ("great", "excellent", "successfully") — sycophancy markers.
+- description: a single-sentence summary, <=200 chars, no period at end.
+- content: the compressed body. Multi-paragraph allowed. <=4000 chars.
+- If the input memories are too thin / contradictory / off-topic to compose a coherent summary, return {"error": "insufficient_input"} instead.
+
+Output as JSON matching one of:
+  Success: {"description": "...", "content": "..."}
+  Refusal: {"error": "insufficient_input"}`;
+/** Empty window OR an LLM refusal (an `error` key) — compress.rs maps both to InsufficientInput. */
+export class CompressionInsufficientInputError extends Error {
+    constructor(message = 'compress: insufficient input') {
+        super(message);
+        this.name = 'CompressionInsufficientInputError';
+    }
+}
+export class CompressionScopeMismatchError extends Error {
+    window;
+    constructor(window) {
+        super(`compress: scope mismatch across window [${window.join(', ')}]`);
+        this.window = window;
+        this.name = 'CompressionScopeMismatchError';
+    }
+}
+export class CompressionParseError extends Error {
+    constructor(message) {
+        super(`compress: LLM output was not valid JSON: ${message}`);
+        this.name = 'CompressionParseError';
+    }
+}
+export class CompressionValidationError extends Error {
+    constructor(message) {
+        super(`compress: ${message}`);
+        this.name = 'CompressionValidationError';
+    }
+}
+const scopeOf = (m) => m.tags.find((t) => t.startsWith('scope:')) ?? null;
+function fillTemplate(preds) {
+    let block = '';
+    for (const m of preds) {
+        block += `--- MEMORY ${m.id} ---\ncontent:\n${m.content.trim()}\n\n`;
+    }
+    return COMPRESSION_PROMPT_TEMPLATE.replace('{MEMORIES_BLOCK}', block.trim());
+}
+/** `error` key = refusal → InsufficientInput (compress.rs:543-545); else expect {description, content}. */
+function discriminateCompressOutput(parsed) {
+    if (typeof parsed !== 'object' || parsed === null) {
+        throw new CompressionParseError('expected a JSON object');
+    }
+    const obj = parsed;
+    if ('error' in obj)
+        throw new CompressionInsufficientInputError('LLM refused: insufficient input');
+    if (typeof obj.description !== 'string' || typeof obj.content !== 'string') {
+        throw new CompressionParseError('missing description/content');
+    }
+    return { description: obj.description, content: obj.content };
+}
+/** D-Cx7 parse-time validation (compress.rs:552-591). */
+function validateCompressedInvariants(draft, predecessorIds) {
+    if (draft.description.trim().length === 0)
+        throw new CompressionValidationError('description empty after trim');
+    if (draft.content.trim().length === 0)
+        throw new CompressionValidationError('content empty after trim');
+    if ([...draft.description].length > MAX_DESCRIPTION_CHARS)
+        throw new CompressionValidationError(`description length > cap ${MAX_DESCRIPTION_CHARS}`);
+    if ([...draft.content].length > MAX_CONTENT_CHARS)
+        throw new CompressionValidationError(`content length > cap ${MAX_CONTENT_CHARS}`);
+    if (predecessorIds.length === 0)
+        throw new CompressionValidationError('derived_from cannot be empty for a compressed memory');
+    if (predecessorIds.length > MAX_DERIVED_FROM_LEN)
+        throw new CompressionValidationError(`derived_from len > cap ${MAX_DERIVED_FROM_LEN}`);
+}
+/** `mem-c-<16hex>` — the `-c-` infix marks a compressed memory (engine identifies via derived_from). */
+function mintCompressedId(now, predecessorIds) {
+    const h = createHash('sha256')
+        .update(`${now.getTime()}\n${predecessorIds.join(',')}`)
+        .digest('hex')
+        .slice(0, 16);
+    return `mem-c-${h}`;
+}
+/**
+ * Compress a window of memory ids into one minted Mc (NO delete). Throws the typed errors above on
+ * empty input, cycle/over-depth (via cycle.ts), scope mismatch, LLM refusal/parse, or invariant
+ * violation. Predecessors are never mutated.
+ */
+export async function compress(deps, ids) {
+    const unique = [...new Set(ids)]; // dedupe BEFORE load (compress.rs:151-155)
+    if (unique.length === 0)
+        throw new CompressionInsufficientInputError('empty window');
+    const preds = [];
+    for (const id of unique) {
+        const m = await deps.getMemoryById(id);
+        if (m === null)
+            throw new Error(`compress: predecessor ${id} not found`);
+        preds.push(m);
+    }
+    // Cycle + depth across the input set (compress.rs:172).
+    await detectCycleInWindow(async (id) => {
+        const m = await deps.getMemoryById(id);
+        return m === null ? null : m.derivedFrom;
+    }, unique);
+    // Scope-consistency — all predecessors must share the `scope:` tag (compress.rs:179-192).
+    const scope = scopeOf(preds[0]);
+    if (preds.some((m) => scopeOf(m) !== scope))
+        throw new CompressionScopeMismatchError(unique);
+    // LLM summarize via RAW TEXT, then parse + the ported guards.
+    const raw = await deps.summarize(fillTemplate(preds));
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new CompressionParseError(raw.slice(0, 200));
+    }
+    const draft = discriminateCompressOutput(parsed);
+    validateCompressedInvariants(draft, unique);
+    // Mint Mc: derived_from = the window, consumed_by_user_lessons = saturating sum (compress.rs:217-225).
+    // libSQL memory is content-only → fold description into content (matches migrate_memories' shape).
+    const consumed = preds.reduce((acc, m) => Math.min(acc + m.consumedByUserLessons, U32_MAX), 0);
+    const mc = {
+        id: mintCompressedId(deps.now(), unique),
+        content: `${draft.description}\n\n${draft.content}`,
+        tags: scope !== null ? [scope] : [],
+        source: 'memory',
+        author: 'agent',
+        createdAt: deps.now().toISOString(),
+        derivedFrom: unique,
+        consumedByUserLessons: consumed,
+    };
+    const embedding = await deps.embed(mc.content);
+    await deps.insertMemory({ ...mc, embedding }); // ADD only — predecessors untouched
+    return mc;
+}
+//# sourceMappingURL=compress.js.map

package/dist/rag/memory/compress.js.map

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

package/dist/rag/memory/consolidate.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Memory consolidation (retire-Rust RES-4b; port of engine compress.rs `consolidate`). The D2 safety
+ * contract: compress a window → Mc, VERIFY (recall-replay) that Mc preserves each predecessor's
+ * recall, and ONLY THEN force-delete the NON-immune predecessors. Fail-closed on ANY uncertainty
+ * (recall_k==0, a vanished predecessor, a search error, or Mc absent from the top-k) → delete
+ * NOTHING; Mc lives alongside the originals and the caller surfaces drift.
+ *
+ * The citation-counter immunity (`consumed_by_user_lessons > 0`) is checked HERE, re-loaded right
+ * before the irreversible delete — NOT delegated to the force-delete (which would bypass it). The
+ * delete MUST go through the backend `deleteLesson(force:true)` so the per-file source is removed too;
+ * a DB-only delete would let `rebuildLibsqlIndex` resurrect the predecessor, undoing the consolidation.
+ *
+ * Imports from: ./compress.js.
+ * Imported by: RES-4c (the compression orchestrator) — not yet wired.
+ */
+import { type CompressDeps } from './compress.js';
+/** Top-k for the recall-replay probe — engine DEFAULT_CONSOLIDATE_RECALL_K (compress.rs:252). */
+export declare const DEFAULT_CONSOLIDATE_RECALL_K = 5;
+export interface ConsolidateDeps extends CompressDeps {
+    /** Backend recall → the hit ids (e.g. `recall(q,k).then(hs => hs.map(h => h.lesson.id))`). */
+    recallIds: (query: string, k: number) => Promise<string[]>;
+    /** Backend `deleteLesson(id, {force:true})` — removes the per-file source too (NOT a DB-only delete). */
+    deleteMemory: (id: string) => Promise<void>;
+}
+export interface ConsolidateOutcome {
+    mcId: string;
+    deleted: string[];
+    keptImmune: string[];
+    verified: boolean;
+}
+export declare function consolidate(deps: ConsolidateDeps, ids: string[], recallK?: number): Promise<ConsolidateOutcome>;
+//# sourceMappingURL=consolidate.d.ts.map

package/dist/rag/memory/consolidate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consolidate.d.ts","sourceRoot":"","sources":["../../../src/rag/memory/consolidate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAY,KAAK,YAAY,EAAkB,MAAM,eAAe,CAAC;AAE5E,iGAAiG;AACjG,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAE9C,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD,8FAA8F;IAC9F,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3D,yGAAyG;IACzG,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAUD,wBAAsB,WAAW,CAC/B,IAAI,EAAE,eAAe,EACrB,GAAG,EAAE,MAAM,EAAE,EACb,OAAO,GAAE,MAAqC,GAC7C,OAAO,CAAC,kBAAkB,CAAC,CAkD7B"}