@spinabot/brigade 0.1.1 → 1.0.0

package/dist/agents/memory/decay.js.map

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

package/dist/agents/memory/dream.d.ts

@@ -0,0 +1,52 @@
+import { FactStore, type MemoryStatus, type RecordOriginFilter } from "./records.js";
+export interface DreamOpts {
+    /** Reflect over just this principal's facts (default: every origin). */
+    origin?: RecordOriginFilter;
+    /** Assertions (accessCount + 1) needed to confirm a belief. Default 3. */
+    confirmCount?: number;
+    /** Confidence to stamp on a confirmed belief. Default 0.9. */
+    confirmConfidence?: number;
+    /** Cosine bar for merging near-identical duplicates. Default 0.95. */
+    consolidateThreshold?: number;
+    /** Cosine bar for persisting a generic `relates` edge between two facts that are
+     *  related but NOT merged (the synonymy band below the merge bar — Step 19). Default
+     *  0.8. Must be < consolidateThreshold. Set to 1 to disable relatedness linking. */
+    relatesThreshold?: number;
+    /** effectiveScore floor below which a fact is eligible for eviction. Default 0.05. */
+    evictBelowScore?: number;
+    /** Only evict facts older than this (ms). Default 30 days. */
+    evictMinAgeMs?: number;
+    /** Injectable wall-clock (epoch ms). Defaults to `Date.now()`. Pin in tests
+     *  to make the pass fully deterministic (same value flows to every effectiveScore
+     *  call and the evict age gate). The curator always passes `now` so all
+     *  per-origin passes share one pinned instant. */
+    now?: number;
+}
+export interface DreamResult {
+    /** How many active facts were examined. */
+    reflected: number;
+    /** Beliefs promoted to confirmed (with the prior values, for reversal). */
+    confirmed: Array<{
+        memoryId: string;
+        prior: {
+            confidence?: number;
+            status?: MemoryStatus;
+            importance?: number;
+        };
+    }>;
+    /** Near-identical merges: keeper ← duplicate. */
+    consolidated: Array<{
+        kept: string;
+        merged: string;
+    }>;
+    /** Archived (decayed) ids. */
+    evicted: string[];
+    /** New `relates` association edges persisted this pass (Step 19 synonymy links). */
+    related: number;
+}
+/**
+ * Run one dream pass over `store`. Pass `origin` to scope it to a single
+ * principal (the cron fans this out per-origin). Returns what it changed.
+ */
+export declare function runDream(store: FactStore, opts?: DreamOpts): DreamResult;
+//# sourceMappingURL=dream.d.ts.map

package/dist/agents/memory/dream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dream.d.ts","sourceRoot":"","sources":["../../../src/agents/memory/dream.ts"],"names":[],"mappings":"AAwBA,OAAO,EAEN,SAAS,EAIT,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,MAAM,cAAc,CAAC;AAKtB,MAAM,WAAW,SAAS;IACzB,wEAAwE;IACxE,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sEAAsE;IACtE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;wFAEoF;IACpF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sFAAsF;IACtF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;sDAGkD;IAClD,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC3B,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,SAAS,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE;YAAE,UAAU,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,YAAY,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;IACnH,iDAAiD;IACjD,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD,8BAA8B;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,GAAE,SAAc,GAAG,WAAW,CA2J5E"}

package/dist/agents/memory/dream.js

@@ -0,0 +1,192 @@
+// src/agents/memory/dream.ts
+//
+// Tideline Step 22 — the nightly dream (Lane A reflection, per-origin).
+//
+// A periodic, deterministic reflection over an origin's facts that lets memory
+// AUTO-EVOLVE — Lane A is reversible and changes NO agent behaviour:
+//   • CONFIRM    — a belief asserted/reinforced ≥ N times (a "3× repeated
+//                  correction") is promoted to a CONFIRMED preference
+//                  (status="confirmed" + confidence ↑). The marquee outcome.
+//   • CONSOLIDATE— near-identical active facts (embedding cosine ≥ a high bar)
+//                  are merged: the stronger keeper bi-temporally supersedes the
+//                  duplicate. Per-origin only (the candidate set is origin-
+//                  filtered first), so it never crosses principals.
+//   • EVICT      — active facts whose effectiveScore has decayed below a floor
+//                  (old enough, NOT confirmed) are archived.
+//
+// REVERSIBLE: confirms log their `prior` (a future pass / the operator restores
+// it); consolidations + evictions ARCHIVE, never delete. The "reflection with
+// citations" + an NLI confirm are SEAMS — an LLM adapter can gate/justify each
+// promotion; the v1 default is the deterministic rules above so it runs offline
+// on a cron with zero model cost.
+import { effectiveScore } from "./decay.js";
+import { synonymyEdges } from "./graph.js";
+import { compareRichness, originBucketKey, recordMatchesOriginFilter, } from "./records.js";
+import { isTrustedTarget } from "./write-gate.js";
+const DAY_MS = 86_400_000;
+/**
+ * Run one dream pass over `store`. Pass `origin` to scope it to a single
+ * principal (the cron fans this out per-origin). Returns what it changed.
+ */
+export function runDream(store, opts = {}) {
+    const now = opts.now ?? Date.now();
+    const confirmCount = opts.confirmCount ?? 3;
+    const confirmConfidence = opts.confirmConfidence ?? 0.9;
+    const consolidateThreshold = opts.consolidateThreshold ?? 0.95;
+    const relatesThreshold = opts.relatesThreshold ?? 0.8;
+    const evictBelow = opts.evictBelowScore ?? 0.05;
+    const evictMinAge = opts.evictMinAgeMs ?? 30 * DAY_MS;
+    const inOrigin = (r) => !opts.origin || recordMatchesOriginFilter(r, opts.origin);
+    const activeNow = () => store.list({ limit: 100_000 }).filter(inOrigin);
+    let active = activeNow();
+    const result = { reflected: active.length, confirmed: [], consolidated: [], evicted: [], related: 0 };
+    // ── CONFIRM: a subjectKey belief is confirmed when EITHER the same value was
+    //    asserted/reinforced ≥ confirmCount (assertions = accessCount + 1), OR the
+    //    subject was CORRECTED ≥ confirmCount times (archived same-subject,
+    //    same-origin predecessors). So both "said X three times" and "revised the
+    //    value over three corrections, now settled" promote the current belief.
+    // GENUINE same-slot user corrections only. A write-time supersede stamps the
+    // SUPERSEDER with contradicts/transition edges at the prior it replaced, and the
+    // write path only supersedes priors sharing its subjectKey AND origin — so a
+    // genuine correction is an edge whose source occupies the SAME [origin, subjectKey]
+    // slot as its archived target (true even mid-chain: each link in M←T←W←Th joins two
+    // same-slot values, and an earlier superseder may itself be archived by a later one).
+    // Pure decay/eviction archive WITHOUT any such edge. Consolidation DOES add
+    // contradicts/transition edges (it archives via invalidate(... supersededBy ...)),
+    // but it merges embedding near-duplicates that generally DON'T share a subjectKey/
+    // slot — so the same-slot requirement structurally excludes a system merge that
+    // would otherwise inflate the count and falsely CONFIRM a belief whose slot merely
+    // churned (status="confirmed", confidence ↑, eviction-immune) off a system-initiated,
+    // not user-driven, change.
+    const recordById = new Map(store.readAll().map((r) => [r.memoryId, r]));
+    const slotOf = (r) => JSON.stringify([originBucketKey(r), r.subjectKey]);
+    const supersededTargets = new Set();
+    for (const a of store.readAll()) {
+        if (!a.subjectKey)
+            continue;
+        const srcSlot = slotOf(a);
+        for (const l of a.links ?? []) {
+            if (l.kind !== "contradicts" && l.kind !== "transition")
+                continue;
+            const target = recordById.get(l.target);
+            // Only a same-slot supersede (the source shares the target's origin +
+            // subjectKey) is a genuine user correction; this structurally excludes a
+            // consolidation merge of cross-slot near-duplicates.
+            if (target?.subjectKey && slotOf(target) === srcSlot)
+                supersededTargets.add(l.target);
+        }
+    }
+    const correctionDepth = new Map();
+    for (const a of store.readAll()) {
+        if (a.lifecycle === "active" || !a.subjectKey || !supersededTargets.has(a.memoryId))
+            continue;
+        const k = JSON.stringify([originBucketKey(a), a.subjectKey]);
+        correctionDepth.set(k, (correctionDepth.get(k) ?? 0) + 1);
+    }
+    for (const r of active) {
+        if (!r.subjectKey || r.status === "confirmed")
+            continue;
+        const assertions = r.accessCount + 1;
+        const corrections = correctionDepth.get(JSON.stringify([originBucketKey(r), r.subjectKey])) ?? 0;
+        if (Math.max(assertions, corrections) < confirmCount)
+            continue;
+        const prior = store.promote(r.memoryId, { status: "confirmed", confidence: confirmConfidence, importance: Math.max(r.importance, 0.8) }, { now });
+        if (prior)
+            result.confirmed.push({ memoryId: r.memoryId, prior });
+    }
+    if (result.confirmed.length > 0)
+        active = activeNow();
+    // ── CONSOLIDATE: near-identical active pairs → keep stronger, supersede dup.
+    // Bucket by origin FIRST so a merge NEVER crosses principals — even in a
+    // whole-store pass (opts.origin undefined): synonymyEdges runs PER origin
+    // bucket, so an owner fact can't dissolve into a channel peer's identical one
+    // (which would leak a cross-principal contradicts/transition edge).
+    const byId = new Map(active.map((r) => [r.memoryId, r]));
+    const merged = new Set();
+    const buckets = new Map();
+    for (const r of active) {
+        const k = originBucketKey(r);
+        const arr = buckets.get(k);
+        if (arr)
+            arr.push(r);
+        else
+            buckets.set(k, [r]);
+    }
+    // Step 19 relatedness edges — collected across buckets, persisted once after merges.
+    const relatedPairs = [];
+    for (const bucket of buckets.values()) {
+        // A pair that's BOTH confirmed is a supersede we DECLINE below — record it so the
+        // relatedness scan doesn't then mint a `relates` edge between two near-identical
+        // confirmed facts (graph-recall noise, not a genuine association).
+        const bothConfirmedPairs = new Set();
+        for (const e of synonymyEdges(bucket, { threshold: consolidateThreshold })) {
+            if (merged.has(e.from) || merged.has(e.to))
+                continue;
+            const a = byId.get(e.from);
+            const b = byId.get(e.to);
+            if (!a || !b)
+                continue;
+            // Keeper precedence, each dominating the next: (1) TRUST — an untrusted fact
+            // must NEVER supersede a trusted owner-authored one (write-gate Rule 2: the
+            // write path enforces it, so the dream must too — else attacker-influenceable
+            // content archives an owner belief); (2) RICHNESS (Fix 3) — the metadata-richer
+            // fact (has subjectKey, more-specific segment, importance, confirmations) wins,
+            // so a reworded subject-less `knowledge` copy can NEVER archive a subject-bearing
+            // `identity`/`preference` original; (3) CONFIRMED — a confirmed belief outranks a
+            // non-confirmed near-duplicate; (4) effectiveScore.
+            const trust = (r) => (isTrustedTarget(r.sourceType) ? 1 : 0);
+            const conf = (r) => (r.status === "confirmed" ? 1 : 0);
+            const richer = compareRichness(a, b); // >0 a richer, <0 b richer, 0 tie
+            const aWins = trust(a) !== trust(b)
+                ? trust(a) > trust(b)
+                : richer !== 0
+                    ? richer > 0
+                    : conf(a) !== conf(b)
+                        ? conf(a) > conf(b)
+                        : effectiveScore(a, now) >= effectiveScore(b, now);
+            const [keep, drop] = aWins ? [a, b] : [b, a];
+            // Don't dissolve one confirmed belief into ANOTHER — both are load-bearing.
+            if (keep.status === "confirmed" && drop.status === "confirmed") {
+                bothConfirmedPairs.add(`${e.from}|${e.to}`); // a declined supersede ⇒ not a relation either
+                continue;
+            }
+            // Preserve metadata (Fix 2): the keeper inherits the richer of each field
+            // from the duplicate BEFORE it's archived, so a merge never silently drops a
+            // subjectKey / more-specific segment / higher importance the loser carried.
+            store.mergeMetadataInto(keep.memoryId, drop.memoryId);
+            store.invalidate(drop.memoryId, { supersededBy: keep.memoryId, now });
+            merged.add(drop.memoryId);
+            result.consolidated.push({ kept: keep.memoryId, merged: drop.memoryId });
+        }
+        // RELATE (Step 19): synonymy pairs in the relatedness band (>= relatesThreshold)
+        // that we did NOT merge become persistent `relates` edges, so graph-recall pulls
+        // in associated — not just duplicate — facts. Inside the per-origin bucket, so
+        // every edge is same-origin (no cross-principal leak).
+        if (relatesThreshold < 1) {
+            for (const e of synonymyEdges(bucket, { threshold: relatesThreshold })) {
+                if (merged.has(e.from) || merged.has(e.to))
+                    continue; // a merged pair is a supersede, not a relation
+                if (bothConfirmedPairs.has(`${e.from}|${e.to}`))
+                    continue; // declined confirmed-vs-confirmed supersede: not an association
+                relatedPairs.push({ a: e.from, b: e.to });
+            }
+        }
+    }
+    if (result.consolidated.length > 0)
+        active = activeNow();
+    // Persist relatedness edges once (post-merge ⇒ linkRelated skips any now-archived).
+    if (relatedPairs.length > 0) {
+        result.related = store.linkRelated(relatedPairs);
+        if (result.related > 0)
+            active = activeNow();
+    }
+    // ── EVICT: decayed below the floor, old enough, never a confirmed belief.
+    const toEvict = active
+        .filter((r) => r.status !== "confirmed")
+        .filter((r) => now - r.createdAt >= evictMinAge)
+        .filter((r) => effectiveScore(r, now) < evictBelow)
+        .map((r) => r.memoryId);
+    result.evicted = store.evict(toEvict, { now });
+    return result;
+}
+//# sourceMappingURL=dream.js.map

package/dist/agents/memory/dream.js.map

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

package/dist/agents/memory/embedder-providers.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Embedder PROVIDER registry — the pluggable, lazy, optional, graceful-degrading
+ * embedder selection: a registry of adapters, each of which LAZILY creates an
+ * embedder or returns `null` to degrade. The heavy local backend
+ * (`node-llama-cpp` → `embeddinggemma`) is an OPTIONAL dependency, lazy-imported,
+ * never top-level — so the default install never pays for it and air-gap stays
+ * intact. When no learned embedder is available (no key, dep not installed),
+ * resolution falls back to the zero-dep model-free {@link HrrEmbedder} — recall
+ * ALWAYS works, degrading to lexical-only like any robust hybrid engine.
+ *
+ * The model-free HRR is the always-available floor; this module adds the
+ * learned-embedder path on top (a learned model lifts true-synonymy recall).
+ *
+ * Provider tiers (three transports):
+ *   - "model-free" → HrrEmbedder (zero-dep, offline, sync) — the always-available floor.
+ *   - "local"      → embeddinggemma via node-llama-cpp (offline, air-gap, async).
+ *   - "remote"     → OpenAI text-embedding-3-small @ 256 dims (network, async).
+ *
+ * DIMS: every adapter emits 256-dim L2-normalised vectors so they're drop-in for
+ * the existing convex `by_embedding` vectorIndex (no schema migration) and
+ * cosine-comparable with the bundled HRR. The learned models are truncated via
+ * Matryoshka (text-embedding-3-small `dimensions:256`; embeddinggemma 768→256)
+ * then re-normalised. (NOTE: switching embedder FAMILIES requires re-embedding
+ * stored facts — cross-family cosine is meaningless — i.e. re-index on model
+ * change. That re-embed pass + async write/recall wiring is the activation step
+ * that turns a registered adapter into live recall.)
+ */
+import { type Embedder } from "./embedder.js";
+/** Vectors every adapter emits at this width (matches the convex vectorIndex + HRR). */
+export declare const EMBEDDER_DIMS = 256;
+/** L2-normalise (and optionally Matryoshka-truncate) a raw model vector to unit
+ *  length at `dims` — so cosine = dot and short/long texts compare fairly. A
+ *  near-zero vector maps to all-zeros (cosine() then returns 0). Standard
+ *  embedding sanitize-and-normalize. */
+export declare function normalizeTo(raw: readonly number[], dims?: number): number[];
+/**
+ * An embedder adapter (a memory-embedding provider adapter): lazily make
+ * an {@link Embedder}, or return `null` to gracefully degrade (missing key /
+ * uninstalled optional dep). `create` MUST return null — never throw — for a
+ * missing-credential / missing-dep case, so resolution can fall through.
+ */
+export interface EmbedderAdapter {
+    readonly id: string;
+    readonly transport: "model-free" | "local" | "remote";
+    /** Lower = tried first in auto-select; omit to exclude from auto-select. */
+    readonly autoSelectPriority?: number;
+    create(): Promise<Embedder | null>;
+    /** One-line setup hint shown when this adapter was requested but unavailable. */
+    formatSetupError?(): string;
+}
+export declare function registerEmbedderAdapter(adapter: EmbedderAdapter): void;
+export declare function listEmbedderAdapters(): EmbedderAdapter[];
+export declare function getEmbedderAdapter(id: string): EmbedderAdapter | undefined;
+/** Test-only. */
+export declare function __resetEmbedderRegistryForTests(): void;
+/**
+ * Resolve the embedder for a `selection`:
+ *   - "model-free" (default) → always the zero-dep HRR (air-gap, no network).
+ *   - a specific adapter id  → that adapter; falls back to HRR if it yields null.
+ *   - "auto"                 → highest-priority adapter that creates successfully,
+ *                              else HRR.
+ * NEVER throws and ALWAYS returns a working embedder (graceful degrade) — the
+ * the always-fallback invariant: a missing model/key downgrades, never breaks.
+ */
+export declare function resolveEmbedder(selection?: string): Promise<Embedder>;
+/** OpenAI text-embedding-3-small, requesting `dimensions:256` (Matryoshka) so it
+ *  drops into the existing 256-dim vectorIndex. Async; L2-normalised on output. */
+export declare class OpenAiEmbedder implements Embedder {
+    private readonly apiKey;
+    private readonly model;
+    private readonly fetchImpl;
+    readonly id = "openai:text-embedding-3-small:256";
+    readonly dims = 256;
+    constructor(apiKey: string, model?: string, fetchImpl?: typeof fetch);
+    embed(texts: string[]): Promise<number[][]>;
+}
+/** Adapter: enabled only when an OpenAI key is present (env or injected). Returns
+ *  null (degrade) when absent — never throws on a missing key. */
+export declare function openAiEmbedderAdapter(opts?: {
+    apiKey?: string;
+}): EmbedderAdapter;
+/** Default local embedding model (Q8 GGUF, auto-resolved/downloaded). */
+export declare const DEFAULT_LOCAL_EMBED_MODEL = "hf:ggml-org/embeddinggemma-300m-qat-q8_0-GGUF/embeddinggemma-300m-qat-Q8_0.gguf";
+/**
+ * Local embedder over `node-llama-cpp` + embeddinggemma (768-dim → 256 Matryoshka).
+ * OFFLINE / AIR-GAP once the model is cached. The model + context init is memoised
+ * behind a shared promise (an init-promise guard) so concurrent calls share one load.
+ * Runs only when the optional `node-llama-cpp` dep is installed.
+ */
+export declare class LocalLlamaEmbedder implements Embedder {
+    private readonly loadCtx;
+    readonly id = "local:embeddinggemma-300m:256";
+    readonly dims = 256;
+    private ctx;
+    constructor(loadCtx: () => Promise<{
+        getEmbeddingFor: (t: string) => Promise<{
+            vector: number[];
+        }>;
+    }>);
+    private ensure;
+    embed(texts: string[]): Promise<number[][]>;
+}
+/** Adapter: lazy-imports `node-llama-cpp` (an OPTIONAL dep). Returns null (degrade
+ *  to HRR) when the dep isn't installed — the optional-dependency
+ *  pattern, so air-gap installs that haven't added it simply fall back. */
+export declare function localLlamaEmbedderAdapter(opts?: {
+    model?: string;
+    cacheDir?: string;
+}): EmbedderAdapter;
+/** Register the built-in adapters. Idempotent-ish (overwrites by id). The
+ *  model-free HRR is the implicit fallback in resolveEmbedder, so it's not an
+ *  auto-select adapter; the two LEARNED adapters are (local first, then remote). */
+export declare function registerBuiltInEmbedderAdapters(): void;
+//# sourceMappingURL=embedder-providers.d.ts.map

package/dist/agents/memory/embedder-providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedder-providers.d.ts","sourceRoot":"","sources":["../../../src/agents/memory/embedder-providers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,KAAK,QAAQ,EAAe,MAAM,eAAe,CAAC;AAE3D,wFAAwF;AACxF,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC;;;wCAGwC;AACxC,wBAAgB,WAAW,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,GAAE,MAAsB,GAAG,MAAM,EAAE,CAO1F;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,YAAY,GAAG,OAAO,GAAG,QAAQ,CAAC;IACtD,4EAA4E;IAC5E,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,MAAM,IAAI,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IACnC,iFAAiF;IACjF,gBAAgB,CAAC,IAAI,MAAM,CAAC;CAC5B;AAID,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAEtE;AACD,wBAAgB,oBAAoB,IAAI,eAAe,EAAE,CAExD;AACD,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAE1E;AACD,iBAAiB;AACjB,wBAAgB,+BAA+B,IAAI,IAAI,CAGtD;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,SAAS,GAAE,MAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAsBzF;AAID;mFACmF;AACnF,qBAAa,cAAe,YAAW,QAAQ;IAO7C,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAR3B,QAAQ,CAAC,EAAE,uCAAuC;IAClD,QAAQ,CAAC,IAAI,OAAiB;gBAKZ,MAAM,EAAE,MAAM,EACd,KAAK,SAA2B,EAChC,SAAS,GAAE,OAAO,KAAa;IAG3C,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;CAajD;AAED;kEACkE;AAClE,wBAAgB,qBAAqB,CAAC,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,eAAe,CAWrF;AAID,yEAAyE;AACzE,eAAO,MAAM,yBAAyB,oFAC4C,CAAC;AAEnF;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,QAAQ;IAMjD,OAAO,CAAC,QAAQ,CAAC,OAAO;IALzB,QAAQ,CAAC,EAAE,mCAAmC;IAC9C,QAAQ,CAAC,IAAI,OAAiB;IAC9B,OAAO,CAAC,GAAG,CAA2F;gBAGpF,OAAO,EAAE,MAAM,OAAO,CAAC;QAAE,eAAe,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;YAAE,MAAM,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAG3G,OAAO,CAAC,MAAM;IAKR,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;CAQjD;AAED;;2EAE2E;AAC3E,wBAAgB,yBAAyB,CAAC,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,eAAe,CAkC3G;AAED;;oFAEoF;AACpF,wBAAgB,+BAA+B,IAAI,IAAI,CAGtD"}

package/dist/agents/memory/embedder-providers.js

@@ -0,0 +1,213 @@
+/**
+ * Embedder PROVIDER registry — the pluggable, lazy, optional, graceful-degrading
+ * embedder selection: a registry of adapters, each of which LAZILY creates an
+ * embedder or returns `null` to degrade. The heavy local backend
+ * (`node-llama-cpp` → `embeddinggemma`) is an OPTIONAL dependency, lazy-imported,
+ * never top-level — so the default install never pays for it and air-gap stays
+ * intact. When no learned embedder is available (no key, dep not installed),
+ * resolution falls back to the zero-dep model-free {@link HrrEmbedder} — recall
+ * ALWAYS works, degrading to lexical-only like any robust hybrid engine.
+ *
+ * The model-free HRR is the always-available floor; this module adds the
+ * learned-embedder path on top (a learned model lifts true-synonymy recall).
+ *
+ * Provider tiers (three transports):
+ *   - "model-free" → HrrEmbedder (zero-dep, offline, sync) — the always-available floor.
+ *   - "local"      → embeddinggemma via node-llama-cpp (offline, air-gap, async).
+ *   - "remote"     → OpenAI text-embedding-3-small @ 256 dims (network, async).
+ *
+ * DIMS: every adapter emits 256-dim L2-normalised vectors so they're drop-in for
+ * the existing convex `by_embedding` vectorIndex (no schema migration) and
+ * cosine-comparable with the bundled HRR. The learned models are truncated via
+ * Matryoshka (text-embedding-3-small `dimensions:256`; embeddinggemma 768→256)
+ * then re-normalised. (NOTE: switching embedder FAMILIES requires re-embedding
+ * stored facts — cross-family cosine is meaningless — i.e. re-index on model
+ * change. That re-embed pass + async write/recall wiring is the activation step
+ * that turns a registered adapter into live recall.)
+ */
+import { HrrEmbedder } from "./embedder.js";
+/** Vectors every adapter emits at this width (matches the convex vectorIndex + HRR). */
+export const EMBEDDER_DIMS = 256;
+/** L2-normalise (and optionally Matryoshka-truncate) a raw model vector to unit
+ *  length at `dims` — so cosine = dot and short/long texts compare fairly. A
+ *  near-zero vector maps to all-zeros (cosine() then returns 0). Standard
+ *  embedding sanitize-and-normalize. */
+export function normalizeTo(raw, dims = EMBEDDER_DIMS) {
+    const v = raw.length > dims ? raw.slice(0, dims) : raw.slice();
+    let mag = 0;
+    for (const x of v)
+        mag += (Number.isFinite(x) ? x : 0) ** 2;
+    mag = Math.sqrt(mag);
+    if (mag < 1e-10)
+        return new Array(v.length).fill(0);
+    return v.map((x) => (Number.isFinite(x) ? x : 0) / mag);
+}
+const registry = new Map();
+export function registerEmbedderAdapter(adapter) {
+    registry.set(adapter.id, adapter);
+}
+export function listEmbedderAdapters() {
+    return [...registry.values()];
+}
+export function getEmbedderAdapter(id) {
+    return registry.get(id);
+}
+/** Test-only. */
+export function __resetEmbedderRegistryForTests() {
+    registry.clear();
+    registerBuiltInEmbedderAdapters();
+}
+/**
+ * Resolve the embedder for a `selection`:
+ *   - "model-free" (default) → always the zero-dep HRR (air-gap, no network).
+ *   - a specific adapter id  → that adapter; falls back to HRR if it yields null.
+ *   - "auto"                 → highest-priority adapter that creates successfully,
+ *                              else HRR.
+ * NEVER throws and ALWAYS returns a working embedder (graceful degrade) — the
+ * the always-fallback invariant: a missing model/key downgrades, never breaks.
+ */
+export async function resolveEmbedder(selection = "model-free") {
+    const fallback = () => new HrrEmbedder(128);
+    if (selection === "model-free")
+        return fallback();
+    if (selection !== "auto") {
+        const adapter = registry.get(selection);
+        if (adapter) {
+            const e = await adapter.create().catch(() => null);
+            if (e)
+                return e;
+        }
+        return fallback();
+    }
+    // auto: try learned adapters by priority (lowest first), degrade to HRR.
+    const ordered = [...registry.values()]
+        .filter((a) => a.autoSelectPriority !== undefined)
+        .sort((x, y) => (x.autoSelectPriority ?? 1e9) - (y.autoSelectPriority ?? 1e9));
+    for (const a of ordered) {
+        const e = await a.create().catch(() => null);
+        if (e)
+            return e;
+    }
+    return fallback();
+}
+/* ─────────────────────────── remote: OpenAI ─────────────────────────── */
+/** OpenAI text-embedding-3-small, requesting `dimensions:256` (Matryoshka) so it
+ *  drops into the existing 256-dim vectorIndex. Async; L2-normalised on output. */
+export class OpenAiEmbedder {
+    apiKey;
+    model;
+    fetchImpl;
+    id = "openai:text-embedding-3-small:256";
+    dims = EMBEDDER_DIMS;
+    // A learned model's cosine tracks MEANING not tokens, so unrelated text scores
+    // ~0 and true paraphrases clear a low floor — a clean 0.3 default works (no
+    // HRR-style high floor needed). Left at the hybrid default by omitting minSim.
+    constructor(apiKey, model = "text-embedding-3-small", fetchImpl = fetch) {
+        this.apiKey = apiKey;
+        this.model = model;
+        this.fetchImpl = fetchImpl;
+    }
+    async embed(texts) {
+        if (texts.length === 0)
+            return [];
+        const res = await this.fetchImpl("https://api.openai.com/v1/embeddings", {
+            method: "POST",
+            headers: { authorization: `Bearer ${this.apiKey}`, "content-type": "application/json" },
+            body: JSON.stringify({ model: this.model, input: texts, dimensions: EMBEDDER_DIMS }),
+        });
+        if (!res.ok)
+            throw new Error(`openai embeddings HTTP ${res.status}`);
+        const data = (await res.json());
+        const rows = data.data ?? [];
+        // Preserve input order (OpenAI returns in order); normalise each.
+        return texts.map((_, i) => normalizeTo(rows[i]?.embedding ?? []));
+    }
+}
+/** Adapter: enabled only when an OpenAI key is present (env or injected). Returns
+ *  null (degrade) when absent — never throws on a missing key. */
+export function openAiEmbedderAdapter(opts = {}) {
+    return {
+        id: "openai-256",
+        transport: "remote",
+        autoSelectPriority: 20, // after local (10)
+        async create() {
+            const key = opts.apiKey ?? process.env.OPENAI_API_KEY ?? "";
+            return key.trim() ? new OpenAiEmbedder(key.trim()) : null;
+        },
+        formatSetupError: () => "set OPENAI_API_KEY to use the OpenAI text-embedding-3-small (256-dim) embedder",
+    };
+}
+/* ──────────────────── local: node-llama-cpp / embeddinggemma ──────────────────── */
+/** Default local embedding model (Q8 GGUF, auto-resolved/downloaded). */
+export const DEFAULT_LOCAL_EMBED_MODEL = "hf:ggml-org/embeddinggemma-300m-qat-q8_0-GGUF/embeddinggemma-300m-qat-Q8_0.gguf";
+/**
+ * Local embedder over `node-llama-cpp` + embeddinggemma (768-dim → 256 Matryoshka).
+ * OFFLINE / AIR-GAP once the model is cached. The model + context init is memoised
+ * behind a shared promise (an init-promise guard) so concurrent calls share one load.
+ * Runs only when the optional `node-llama-cpp` dep is installed.
+ */
+export class LocalLlamaEmbedder {
+    loadCtx;
+    id = "local:embeddinggemma-300m:256";
+    dims = EMBEDDER_DIMS;
+    ctx = null;
+    constructor(loadCtx) {
+        this.loadCtx = loadCtx;
+    }
+    ensure() {
+        if (!this.ctx)
+            this.ctx = this.loadCtx();
+        return this.ctx;
+    }
+    async embed(texts) {
+        if (texts.length === 0)
+            return [];
+        const ctx = await this.ensure();
+        // Per-text (batch via Promise.all).
+        return Promise.all(texts.map(async (t) => normalizeTo(Array.from((await ctx.getEmbeddingFor(t)).vector ?? []))));
+    }
+}
+/** Adapter: lazy-imports `node-llama-cpp` (an OPTIONAL dep). Returns null (degrade
+ *  to HRR) when the dep isn't installed — the optional-dependency
+ *  pattern, so air-gap installs that haven't added it simply fall back. */
+export function localLlamaEmbedderAdapter(opts = {}) {
+    return {
+        id: "local-embeddinggemma",
+        transport: "local",
+        autoSelectPriority: 10, // tried FIRST in auto (local before remote)
+        async create() {
+            let mod;
+            try {
+                // Optional dep — never a top-level import; a NON-LITERAL specifier so
+                // the type-checker doesn't try to resolve an uninstalled module, and
+                // absence at runtime ⇒ graceful null (the optional-dependency pattern).
+                const optionalModule = "node-llama-cpp";
+                mod = (await import(optionalModule));
+            }
+            catch {
+                return null;
+            }
+            const getLlama = mod.getLlama;
+            const resolveModelFile = mod.resolveModelFile;
+            if (typeof getLlama !== "function" || typeof resolveModelFile !== "function")
+                return null;
+            const loadCtx = async () => {
+                const llama = (await getLlama());
+                const modelPath = await resolveModelFile(opts.model ?? DEFAULT_LOCAL_EMBED_MODEL, opts.cacheDir);
+                const model = await llama.loadModel({ modelPath });
+                return model.createEmbeddingContext();
+            };
+            return new LocalLlamaEmbedder(loadCtx);
+        },
+        formatSetupError: () => "install the optional `node-llama-cpp` dependency to use the local embeddinggemma embedder (offline/air-gap)",
+    };
+}
+/** Register the built-in adapters. Idempotent-ish (overwrites by id). The
+ *  model-free HRR is the implicit fallback in resolveEmbedder, so it's not an
+ *  auto-select adapter; the two LEARNED adapters are (local first, then remote). */
+export function registerBuiltInEmbedderAdapters() {
+    registerEmbedderAdapter(localLlamaEmbedderAdapter());
+    registerEmbedderAdapter(openAiEmbedderAdapter());
+}
+registerBuiltInEmbedderAdapters();
+//# sourceMappingURL=embedder-providers.js.map

package/dist/agents/memory/embedder-providers.js.map

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