@moolam/edge-agent 1.0.0

package/dist/local_vector_db.d.ts

@@ -0,0 +1,115 @@
+/**
+ * @module local_vector_db
+ *
+ * Offline vector memory of the Edge Harness — the on-device mirror of the
+ * cloud Memory & Context Engine (MCE).
+ *
+ * Storage strategy: a `StorageDriver` abstraction over SQLite so the same
+ * logic runs on expo-sqlite (mobile), better-sqlite3 (desktop/CI), and
+ * wa-sqlite/OPFS (web). Vectors are packed Float32 BLOBs; similarity search
+ * is brute-force cosine over a working set bounded by `maxResidentVectors`.
+ *
+ * `semantic` kind, `deleteById`, query-dimension hard error,
+ * injectable `nowMs` for decay probes.
+ * Kind-aware decay factor + correction pinning under scan
+ * caps; recall ordering prefers pinned kinds when scores tie.
+ */
+import type { StorageDriver } from "@moolam/contracts";
+import type { ConceptId, HLCTimestamp } from "@moolam/sync-protocol";
+export type { StorageDriver };
+/** Memory class shared with MemoryInterface kinds (incl. semantic). */
+export type VectorMemoryKind = "correction" | "milestone" | "preference" | "episodic" | "semantic";
+/** A single retrievable memory: a moment worth remembering about the subject. */
+export interface MemoryRecord {
+    /** ULID-style unique id, generated on-device. */
+    id: string;
+    subjectId: string;
+    conceptId: ConceptId;
+    /** Natural-language content, e.g. "confused derivative with slope of chord". */
+    text: string;
+    /** Embedding produced by the active SlmRuntime. Dimension is store-wide. */
+    vector: Float32Array;
+    /** Memory class drives decay: corrections/semantic never decay; episodics do. */
+    kind: VectorMemoryKind;
+    createdAt: HLCTimestamp;
+}
+export interface ScoredMemory {
+    record: MemoryRecord;
+    /** Cosine similarity in [-1, 1], already decay-weighted. */
+    score: number;
+}
+export type LocalVectorDbOptions = {
+    /** Hard cap on rows scanned per query; oldest episodics evicted first. */
+    maxResidentVectors?: number;
+    /** Half-life (days) applied to episodic memories during scoring. */
+    episodicHalfLifeDays?: number;
+    /** Injected clock for decay (MEMOADAP / CK-02.2). Defaults to Date.now. */
+    nowMs?: () => number;
+};
+/** MCE-03 / CK-02.2 default episodic half-life (30 days). */
+export declare const EPISODIC_HALF_LIFE_DAYS = 30;
+export declare const EPISODIC_HALF_LIFE_MS: number;
+/** Accept ISO-8601 or HLC physical prefix for age computation. */
+export declare function parseMemoryCreatedAtMs(createdAt: string): number;
+/**
+ * Kind-aware decay (CK-02.2): only `episodic` decays; correction /
+ * milestone / preference / semantic stay at 1.0 (never forget corrections).
+ */
+export declare function kindAwareDecayFactor(kind: VectorMemoryKind, createdAt: string, nowMs: number, halfLifeMs?: number): number;
+/**
+ * Pin priority for tie-breaks and working-set retention (lower = stronger).
+ * Corrections are pinned above all other kinds.
+ */
+export declare function memoryKindPinRank(kind: VectorMemoryKind): number;
+/**
+ * Working-set selection under `maxResidentVectors`: keep every correction,
+ * then fill remaining slots (oldest episodics drop first when over cap).
+ */
+export declare function pinCorrectionsInWorkingSet<T extends {
+    kind: VectorMemoryKind;
+    created_at: string;
+}>(rows: readonly T[], cap: number): T[];
+/** Score desc, then pin-rank asc (correction before episodic on ties). */
+export declare function compareScoredMemories(a: ScoredMemory, b: ScoredMemory): number;
+/**
+ * Brute-force-exact, decay-aware local vector store.
+ *
+ * All writes are durable before `upsert` resolves; the friction telemetry
+ * and sync layers rely on this store never losing an acknowledged record.
+ */
+export declare class LocalVectorDb {
+    private readonly driver;
+    private readonly options;
+    private dimension;
+    constructor(driver: StorageDriver, options?: LocalVectorDbOptions);
+    /** Locked embedding width after first upsert; null until then. */
+    get embeddingDimension(): number | null;
+    /** Create tables/indexes. Safe to call on every app launch. */
+    initialize(): Promise<void>;
+    /** Insert or replace a memory. Dimension is locked by the first write. */
+    upsert(record: MemoryRecord): Promise<void>;
+    /**
+     * Retrieve the memories most relevant to `queryVector`, optionally scoped
+     * to a concept. Scores are cosine × {@link kindAwareDecayFactor}; corrections
+     * never decay and are pinned in the working set under scan caps.
+     */
+    search(subjectId: string, queryVector: Float32Array, opts?: {
+        conceptId?: ConceptId;
+        limit?: number;
+    }): Promise<ScoredMemory[]>;
+    /** Delete one row by id (MemoryInterface.forget). */
+    deleteById(id: string): Promise<void>;
+    /**
+     * Remove episodic records past retention. When `subjectId` is set, only that
+     * subject's rows are pruned (subject isolation).
+     */
+    pruneEpisodicOlderThan(cutoff: HLCTimestamp, subjectId?: string): Promise<number>;
+}
+/**
+ * Durable in-memory StorageDriver for the SQL LocalVectorDb issues.
+ * execute flushes rows before resolve (CK-02.1 substrate).
+ */
+export declare function createLocalVectorMemoryDriver(): StorageDriver & {
+    rowCount(): number;
+};
+//# sourceMappingURL=local_vector_db.d.ts.map

package/dist/local_vector_db.d.ts.map

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

package/dist/local_vector_db.js

@@ -0,0 +1,297 @@
+/**
+ * @module local_vector_db
+ *
+ * Offline vector memory of the Edge Harness — the on-device mirror of the
+ * cloud Memory & Context Engine (MCE).
+ *
+ * Storage strategy: a `StorageDriver` abstraction over SQLite so the same
+ * logic runs on expo-sqlite (mobile), better-sqlite3 (desktop/CI), and
+ * wa-sqlite/OPFS (web). Vectors are packed Float32 BLOBs; similarity search
+ * is brute-force cosine over a working set bounded by `maxResidentVectors`.
+ *
+ * `semantic` kind, `deleteById`, query-dimension hard error,
+ * injectable `nowMs` for decay probes.
+ * Kind-aware decay factor + correction pinning under scan
+ * caps; recall ordering prefers pinned kinds when scores tie.
+ */
+const SCHEMA_SQL = `
+CREATE TABLE IF NOT EXISTS memory_records (
+  id          TEXT PRIMARY KEY,
+  subject_id  TEXT NOT NULL,
+  concept_id  TEXT NOT NULL,
+  text        TEXT NOT NULL,
+  vector      BLOB NOT NULL,
+  kind        TEXT NOT NULL CHECK (kind IN ('correction','milestone','preference','episodic','semantic')),
+  created_at  TEXT NOT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_memory_subject_concept
+  ON memory_records (subject_id, concept_id);
+`;
+/** MCE-03 / CK-02.2 default episodic half-life (30 days). */
+export const EPISODIC_HALF_LIFE_DAYS = 30;
+export const EPISODIC_HALF_LIFE_MS = EPISODIC_HALF_LIFE_DAYS * 86_400_000;
+/** Accept ISO-8601 or HLC physical prefix for age computation. */
+export function parseMemoryCreatedAtMs(createdAt) {
+    const iso = Date.parse(createdAt);
+    if (!Number.isNaN(iso))
+        return iso;
+    const physical = Number(createdAt.slice(0, 15));
+    if (!Number.isFinite(physical)) {
+        throw new Error(`unparseable createdAt: ${createdAt}`);
+    }
+    return physical;
+}
+/**
+ * Kind-aware decay (CK-02.2): only `episodic` decays; correction /
+ * milestone / preference / semantic stay at 1.0 (never forget corrections).
+ */
+export function kindAwareDecayFactor(kind, createdAt, nowMs, halfLifeMs = EPISODIC_HALF_LIFE_MS) {
+    if (kind !== "episodic")
+        return 1;
+    const ageMs = Math.max(0, nowMs - parseMemoryCreatedAtMs(createdAt));
+    if (ageMs === 0)
+        return 1;
+    return Math.exp((-Math.LN2 * ageMs) / halfLifeMs);
+}
+/**
+ * Pin priority for tie-breaks and working-set retention (lower = stronger).
+ * Corrections are pinned above all other kinds.
+ */
+export function memoryKindPinRank(kind) {
+    switch (kind) {
+        case "correction":
+            return 0;
+        case "milestone":
+            return 1;
+        case "preference":
+            return 2;
+        case "semantic":
+            return 3;
+        case "episodic":
+            return 4;
+        default:
+            return 5;
+    }
+}
+/**
+ * Working-set selection under `maxResidentVectors`: keep every correction,
+ * then fill remaining slots (oldest episodics drop first when over cap).
+ */
+export function pinCorrectionsInWorkingSet(rows, cap) {
+    if (rows.length <= cap)
+        return [...rows];
+    const corrections = rows.filter((r) => r.kind === "correction");
+    const others = rows
+        .filter((r) => r.kind !== "correction")
+        .sort((a, b) => {
+        // Prefer newer non-corrections when space is scarce.
+        return b.created_at.localeCompare(a.created_at);
+    });
+    if (corrections.length >= cap) {
+        // Still never drop a correction below another correction by age — keep all
+        // corrections even if over cap (pin invariant beats soft NFR scan cap).
+        return corrections;
+    }
+    const room = cap - corrections.length;
+    return [...corrections, ...others.slice(0, room)];
+}
+/** Score desc, then pin-rank asc (correction before episodic on ties). */
+export function compareScoredMemories(a, b) {
+    if (b.score !== a.score)
+        return b.score - a.score;
+    return (memoryKindPinRank(a.record.kind) - memoryKindPinRank(b.record.kind));
+}
+/**
+ * Brute-force-exact, decay-aware local vector store.
+ *
+ * All writes are durable before `upsert` resolves; the friction telemetry
+ * and sync layers rely on this store never losing an acknowledged record.
+ */
+export class LocalVectorDb {
+    driver;
+    options;
+    dimension = null;
+    constructor(driver, options = {}) {
+        this.driver = driver;
+        this.options = options;
+    }
+    /** Locked embedding width after first upsert; null until then. */
+    get embeddingDimension() {
+        return this.dimension;
+    }
+    /** Create tables/indexes. Safe to call on every app launch. */
+    async initialize() {
+        for (const statement of SCHEMA_SQL.split(";")
+            .map((s) => s.trim())
+            .filter(Boolean)) {
+            await this.driver.execute(statement);
+        }
+    }
+    /** Insert or replace a memory. Dimension is locked by the first write. */
+    async upsert(record) {
+        if (this.dimension === null)
+            this.dimension = record.vector.length;
+        if (record.vector.length !== this.dimension) {
+            throw new Error(`vector dimension ${record.vector.length} does not match store dimension ${this.dimension}; ` +
+                "re-embed the corpus before switching embedding models");
+        }
+        await this.driver.execute(`INSERT OR REPLACE INTO memory_records (id, subject_id, concept_id, text, vector, kind, created_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?)`, [
+            record.id,
+            record.subjectId,
+            record.conceptId,
+            record.text,
+            new Uint8Array(record.vector.buffer.slice(0)),
+            record.kind,
+            record.createdAt,
+        ]);
+    }
+    /**
+     * Retrieve the memories most relevant to `queryVector`, optionally scoped
+     * to a concept. Scores are cosine × {@link kindAwareDecayFactor}; corrections
+     * never decay and are pinned in the working set under scan caps.
+     */
+    async search(subjectId, queryVector, opts = {}) {
+        if (this.dimension !== null && queryVector.length !== this.dimension) {
+            throw new Error(`query vector dimension ${queryVector.length} does not match store dimension ${this.dimension}; ` +
+                "re-embed before switching embedding models");
+        }
+        const limit = opts.limit ?? 8;
+        const cap = this.options.maxResidentVectors ?? 50_000;
+        // Fetch the full subject/topic slice, then pin corrections before cap —
+        // SQL LIMIT alone could drop corrections underneath episodic noise.
+        const fetched = await this.driver.query(opts.conceptId
+            ? `SELECT * FROM memory_records WHERE subject_id = ? AND concept_id = ?`
+            : `SELECT * FROM memory_records WHERE subject_id = ?`, opts.conceptId ? [subjectId, opts.conceptId] : [subjectId]);
+        const rows = pinCorrectionsInWorkingSet(fetched, cap);
+        const halfLifeMs = (this.options.episodicHalfLifeDays ?? EPISODIC_HALF_LIFE_DAYS) *
+            86_400_000;
+        const nowMs = this.options.nowMs?.() ?? Date.now();
+        const scored = rows.map((row) => {
+            const vector = new Float32Array(row.vector.buffer, row.vector.byteOffset, row.vector.byteLength / 4);
+            const similarity = cosine(queryVector, vector);
+            const decay = kindAwareDecayFactor(row.kind, row.created_at, nowMs, halfLifeMs);
+            return {
+                record: {
+                    id: row.id,
+                    subjectId: row.subject_id,
+                    conceptId: row.concept_id,
+                    text: row.text,
+                    vector,
+                    kind: row.kind,
+                    createdAt: row.created_at,
+                },
+                score: similarity * decay,
+            };
+        });
+        return scored.sort(compareScoredMemories).slice(0, limit);
+    }
+    /** Delete one row by id (MemoryInterface.forget). */
+    async deleteById(id) {
+        await this.driver.execute(`DELETE FROM memory_records WHERE id = ?`, [id]);
+    }
+    /**
+     * Remove episodic records past retention. When `subjectId` is set, only that
+     * subject's rows are pruned (subject isolation).
+     */
+    async pruneEpisodicOlderThan(cutoff, subjectId) {
+        if (subjectId !== undefined && subjectId.trim().length > 0) {
+            const sid = subjectId.trim();
+            const before = await this.driver.query(`SELECT COUNT(*) AS n FROM memory_records WHERE kind = 'episodic' AND created_at < ? AND subject_id = ?`, [cutoff, sid]);
+            await this.driver.execute(`DELETE FROM memory_records WHERE kind = 'episodic' AND created_at < ? AND subject_id = ?`, [cutoff, sid]);
+            return before[0]?.n ?? 0;
+        }
+        const before = await this.driver.query(`SELECT COUNT(*) AS n FROM memory_records WHERE kind = 'episodic' AND created_at < ?`, [cutoff]);
+        await this.driver.execute(`DELETE FROM memory_records WHERE kind = 'episodic' AND created_at < ?`, [cutoff]);
+        return before[0]?.n ?? 0;
+    }
+}
+/** Cosine similarity; returns 0 for degenerate zero vectors. */
+function cosine(a, b) {
+    let dot = 0;
+    let na = 0;
+    let nb = 0;
+    const len = Math.min(a.length, b.length);
+    for (let i = 0; i < len; i++) {
+        const x = a[i];
+        const y = b[i];
+        dot += x * y;
+        na += x * x;
+        nb += y * y;
+    }
+    const denom = Math.sqrt(na) * Math.sqrt(nb);
+    return denom === 0 ? 0 : dot / denom;
+}
+/**
+ * Durable in-memory StorageDriver for the SQL LocalVectorDb issues.
+ * execute flushes rows before resolve (CK-02.1 substrate).
+ */
+export function createLocalVectorMemoryDriver() {
+    const rows = new Map();
+    return {
+        rowCount: () => rows.size,
+        async execute(sql, params = []) {
+            const s = sql.trim();
+            if (s.startsWith("CREATE"))
+                return;
+            if (sql.includes("INSERT OR REPLACE INTO memory_records")) {
+                const id = String(params[0]);
+                const vector = params[4];
+                const blob = vector instanceof Uint8Array
+                    ? vector
+                    : vector instanceof Float32Array
+                        ? new Uint8Array(vector.buffer.slice(0))
+                        : new Uint8Array(vector);
+                rows.set(id, {
+                    id,
+                    subject_id: String(params[1]),
+                    concept_id: String(params[2]),
+                    text: String(params[3]),
+                    vector: blob,
+                    kind: String(params[5]),
+                    created_at: String(params[6]),
+                });
+                return;
+            }
+            if (sql.includes("DELETE FROM memory_records WHERE id = ?")) {
+                rows.delete(String(params[0]));
+                return;
+            }
+            if (sql.includes("DELETE FROM memory_records WHERE kind = 'episodic'")) {
+                const cutoff = String(params[0]);
+                const subjectScoped = sql.includes("subject_id = ?");
+                const sid = subjectScoped ? String(params[1]) : null;
+                for (const [id, r] of [...rows.entries()]) {
+                    if (r.kind === "episodic" &&
+                        r.created_at < cutoff &&
+                        (sid === null || r.subject_id === sid)) {
+                        rows.delete(id);
+                    }
+                }
+            }
+        },
+        async query(sql, params = []) {
+            if (sql.includes("COUNT(*)")) {
+                const cutoff = String(params[0]);
+                const subjectScoped = sql.includes("subject_id = ?");
+                const sid = subjectScoped ? String(params[1]) : null;
+                const n = [...rows.values()].filter((r) => r.kind === "episodic" &&
+                    r.created_at < cutoff &&
+                    (sid === null || r.subject_id === sid)).length;
+                return [{ n }];
+            }
+            const subjectId = String(params[0]);
+            let bySubject = [...rows.values()].filter((r) => r.subject_id === subjectId);
+            if (sql.includes("concept_id = ?")) {
+                const conceptId = String(params[1]);
+                bySubject = bySubject.filter((r) => r.concept_id === conceptId);
+            }
+            const limitIdx = sql.includes("concept_id = ?") ? 2 : 1;
+            const limit = typeof params[limitIdx] === "number"
+                ? params[limitIdx]
+                : bySubject.length;
+            return bySubject.slice(0, limit);
+        },
+    };
+}
+//# sourceMappingURL=local_vector_db.js.map

package/dist/local_vector_db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local_vector_db.js","sourceRoot":"","sources":["../src/local_vector_db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AA6CH,MAAM,UAAU,GAAG;;;;;;;;;;;;CAYlB,CAAC;AAEF,6DAA6D;AAC7D,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAC1C,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,GAAG,UAAU,CAAC;AAE1E,kEAAkE;AAClE,MAAM,UAAU,sBAAsB,CAAC,SAAiB;IACtD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACnC,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,0BAA0B,SAAS,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAsB,EACtB,SAAiB,EACjB,KAAa,EACb,aAAqB,qBAAqB;IAE1C,IAAI,IAAI,KAAK,UAAU;QAAE,OAAO,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC,CAAC;IACrE,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC1B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,UAAU,CAAC,CAAC;AACpD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAsB;IACtD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,YAAY;YACf,OAAO,CAAC,CAAC;QACX,KAAK,WAAW;YACd,OAAO,CAAC,CAAC;QACX,KAAK,YAAY;YACf,OAAO,CAAC,CAAC;QACX,KAAK,UAAU;YACb,OAAO,CAAC,CAAC;QACX,KAAK,UAAU;YACb,OAAO,CAAC,CAAC;QACX;YACE,OAAO,CAAC,CAAC;IACb,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAExC,IAAkB,EAAE,GAAW;IAC/B,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IACzC,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;IAChE,MAAM,MAAM,GAAG,IAAI;SAChB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC;SACtC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACb,qDAAqD;QACrD,OAAO,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IACL,IAAI,WAAW,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;QAC9B,2EAA2E;QAC3E,wEAAwE;QACxE,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,MAAM,IAAI,GAAG,GAAG,GAAG,WAAW,CAAC,MAAM,CAAC;IACtC,OAAO,CAAC,GAAG,WAAW,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;AACpD,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,qBAAqB,CAAC,CAAe,EAAE,CAAe;IACpE,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;IAClD,OAAO,CACL,iBAAiB,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CACpE,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IAIL;IACA;IAJX,SAAS,GAAkB,IAAI,CAAC;IAExC,YACmB,MAAqB,EACrB,UAAgC,EAAE;QADlC,WAAM,GAAN,MAAM,CAAe;QACrB,YAAO,GAAP,OAAO,CAA2B;IAClD,CAAC;IAEJ,kEAAkE;IAClE,IAAI,kBAAkB;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,+DAA+D;IAC/D,KAAK,CAAC,UAAU;QACd,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC;aAC1C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACpB,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,0EAA0E;IAC1E,KAAK,CAAC,MAAM,CAAC,MAAoB;QAC/B,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI;YAAE,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;QACnE,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CACb,oBAAoB,MAAM,CAAC,MAAM,CAAC,MAAM,mCAAmC,IAAI,CAAC,SAAS,IAAI;gBAC3F,uDAAuD,CAC1D,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACvB;oCAC8B,EAC9B;YACE,MAAM,CAAC,EAAE;YACT,MAAM,CAAC,SAAS;YAChB,MAAM,CAAC,SAAS;YAChB,MAAM,CAAC,IAAI;YACX,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC7C,MAAM,CAAC,IAAI;YACX,MAAM,CAAC,SAAS;SACjB,CACF,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CACV,SAAiB,EACjB,WAAyB,EACzB,OAAkD,EAAE;QAEpD,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,IAAI,WAAW,CAAC,MAAM,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;YACrE,MAAM,IAAI,KAAK,CACb,0BAA0B,WAAW,CAAC,MAAM,mCAAmC,IAAI,CAAC,SAAS,IAAI;gBAC/F,4CAA4C,CAC/C,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,IAAI,MAAM,CAAC;QACtD,wEAAwE;QACxE,oEAAoE;QACpE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CASrC,IAAI,CAAC,SAAS;YACZ,CAAC,CAAC,sEAAsE;YACxE,CAAC,CAAC,mDAAmD,EACvD,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAC3D,CAAC;QACF,MAAM,IAAI,GAAG,0BAA0B,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAEtD,MAAM,UAAU,GACd,CAAC,IAAI,CAAC,OAAO,CAAC,oBAAoB,IAAI,uBAAuB,CAAC;YAC9D,UAAU,CAAC;QACb,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QAEnD,MAAM,MAAM,GAAmB,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YAC9C,MAAM,MAAM,GAAG,IAAI,YAAY,CAC7B,GAAG,CAAC,MAAM,CAAC,MAAM,EACjB,GAAG,CAAC,MAAM,CAAC,UAAU,EACrB,GAAG,CAAC,MAAM,CAAC,UAAU,GAAG,CAAC,CAC1B,CAAC;YACF,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YAC/C,MAAM,KAAK,GAAG,oBAAoB,CAChC,GAAG,CAAC,IAAI,EACR,GAAG,CAAC,UAAU,EACd,KAAK,EACL,UAAU,CACX,CAAC;YACF,OAAO;gBACL,MAAM,EAAE;oBACN,EAAE,EAAE,GAAG,CAAC,EAAE;oBACV,SAAS,EAAE,GAAG,CAAC,UAAU;oBACzB,SAAS,EAAE,GAAG,CAAC,UAAU;oBACzB,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,MAAM;oBACN,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,SAAS,EAAE,GAAG,CAAC,UAA0B;iBAC1C;gBACD,KAAK,EAAE,UAAU,GAAG,KAAK;aAC1B,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC5D,CAAC;IAED,qDAAqD;IACrD,KAAK,CAAC,UAAU,CAAC,EAAU;QACzB,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,yCAAyC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,sBAAsB,CAC1B,MAAoB,EACpB,SAAkB;QAElB,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3D,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CACpC,wGAAwG,EACxG,CAAC,MAAM,EAAE,GAAG,CAAC,CACd,CAAC;YACF,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACvB,0FAA0F,EAC1F,CAAC,MAAM,EAAE,GAAG,CAAC,CACd,CAAC;YACF,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CACpC,qFAAqF,EACrF,CAAC,MAAM,CAAC,CACT,CAAC;QACF,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACvB,uEAAuE,EACvE,CAAC,MAAM,CAAC,CACT,CAAC;QACF,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;CACF;AAED,gEAAgE;AAChE,SAAS,MAAM,CAAC,CAAe,EAAE,CAAe;IAC9C,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QAChB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QAChB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QACb,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QACZ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5C,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,6BAA6B;IAG3C,MAAM,IAAI,GAAG,IAAI,GAAG,EAWjB,CAAC;IAEJ,OAAO;QACL,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI;QAEzB,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,SAAoB,EAAE;YAC/C,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;YACrB,IAAI,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC;gBAAE,OAAO;YACnC,IAAI,GAAG,CAAC,QAAQ,CAAC,uCAAuC,CAAC,EAAE,CAAC;gBAC1D,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;gBACzB,MAAM,IAAI,GACR,MAAM,YAAY,UAAU;oBAC1B,CAAC,CAAC,MAAM;oBACR,CAAC,CAAC,MAAM,YAAY,YAAY;wBAC9B,CAAC,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;wBACxC,CAAC,CAAC,IAAI,UAAU,CAAC,MAAqB,CAAC,CAAC;gBAC9C,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE;oBACX,EAAE;oBACF,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;oBAC7B,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;oBAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;oBACvB,MAAM,EAAE,IAAI;oBACZ,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAqB;oBAC3C,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;iBAC9B,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YACD,IAAI,GAAG,CAAC,QAAQ,CAAC,yCAAyC,CAAC,EAAE,CAAC;gBAC5D,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC/B,OAAO;YACT,CAAC;YACD,IAAI,GAAG,CAAC,QAAQ,CAAC,oDAAoD,CAAC,EAAE,CAAC;gBACvE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;gBACjC,MAAM,aAAa,GAAG,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;gBACrD,MAAM,GAAG,GAAG,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;gBACrD,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;oBAC1C,IACE,CAAC,CAAC,IAAI,KAAK,UAAU;wBACrB,CAAC,CAAC,UAAU,GAAG,MAAM;wBACrB,CAAC,GAAG,KAAK,IAAI,IAAI,CAAC,CAAC,UAAU,KAAK,GAAG,CAAC,EACtC,CAAC;wBACD,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;oBAClB,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,KAAK,CAAC,KAAK,CAAI,GAAW,EAAE,SAAoB,EAAE;YAChD,IAAI,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;gBACjC,MAAM,aAAa,GAAG,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;gBACrD,MAAM,GAAG,GAAG,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;gBACrD,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CACjC,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,IAAI,KAAK,UAAU;oBACrB,CAAC,CAAC,UAAU,GAAG,MAAM;oBACrB,CAAC,GAAG,KAAK,IAAI,IAAI,CAAC,CAAC,UAAU,KAAK,GAAG,CAAC,CACzC,CAAC,MAAM,CAAC;gBACT,OAAO,CAAC,EAAE,CAAC,EAAE,CAAQ,CAAC;YACxB,CAAC;YACD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACpC,IAAI,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CACvC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,SAAS,CAClC,CAAC;YACF,IAAI,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBACnC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;gBACpC,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC;YAClE,CAAC;YACD,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACxD,MAAM,KAAK,GACT,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,QAAQ;gBAClC,CAAC,CAAE,MAAM,CAAC,QAAQ,CAAY;gBAC9B,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC;YACvB,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAQ,CAAC;QAC1C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/slm_runtime.d.ts

@@ -0,0 +1,158 @@
+/**
+ * @module slm_runtime
+ *
+ * Pluggable local inference boundary of the Edge Harness.
+ *
+ * The harness never links against a specific inference engine. Instead it
+ * speaks `SlmRuntime`, and adapters bind that interface to whatever the
+ * host device offers:
+ *   - llama.cpp / GGUF   (`@moolam/bindings-slm` LlamaCppSlmRuntime;
+ *     ModelInterface via createLlamaCppModelAdapter / createSlmModelAdapter)
+ *   - ONNX Runtime Mobile (quantized INT4/INT8 exports)
+ *   - MediaPipe LLM Inference API (Android AICore)
+ *   - Apple Foundation Models / MLX (iOS)
+ *   - any localhost OpenAI-compatible server (Ollama, llamafile)
+ *
+ * CognitiveCore consumes ModelInterface. Pass a loaded LlamaCppSlmRuntime
+ * into edge cognitive bindings, or call createLlamaCppModelAdapter and
+ * inject the resulting model into the binding set.
+ *
+ * This is what makes the Edge Harness sovereign: a district deployment can
+ * swap models and engines without touching a line of domain code.
+ */
+/** Declarative description of the local model an adapter has loaded. */
+export interface SlmModelCard {
+    /** e.g. "phi-3-mini-4k-instruct-q4_K_M" */
+    modelId: string;
+    /** Context window in tokens the adapter will actually honor. */
+    contextWindow: number;
+    /** Quantization descriptor, e.g. "Q4_K_M", "int4-awq", "fp16". */
+    quantization: string;
+    /** Rough on-device footprint in MiB, used by the harness's load planner. */
+    memoryFootprintMiB: number;
+    /** Languages the model operates competently in (BCP-47). */
+    languages: string[];
+}
+export interface SlmGenerateParams {
+    /** Fully-assembled prompt (the harness owns prompt construction). */
+    prompt: string;
+    maxTokens: number;
+    temperature: number;
+    /** Hard wall-clock budget; adapters MUST abort and flush on breach. */
+    deadlineMs: number;
+    stopSequences?: string[];
+}
+export interface SlmGenerateResult {
+    text: string;
+    /** Tokens emitted per second — fed into CAST as a device-health signal. */
+    tokensPerSecond: number;
+    finishReason: "stop" | "length" | "deadline" | "aborted";
+}
+/**
+ * The single interface every local inference adapter implements.
+ * Adapters must be side-effect free until `load()` is invoked so the
+ * harness can enumerate candidates cheaply on constrained devices.
+ *
+ * Streaming MUST yield CK-03.2 deltas (new text only), never cumulative
+ * restatements of prior frames. Implementations SHOULD race an
+ * AbortController-equivalent against `deadlineMs` at the native/FFI layer
+ * so generation cannot hang the harness thread.
+ */
+export interface SlmRuntime {
+    readonly card: SlmModelCard;
+    /** Materialize weights into memory. Idempotent. */
+    load(): Promise<void>;
+    /** Release weights. The harness calls this under memory pressure. */
+    unload(): Promise<void>;
+    /** Single-shot generation within a strict deadline. */
+    generate(params: SlmGenerateParams): Promise<SlmGenerateResult>;
+    /** Streaming variant for word-by-word reply rendering (delta frames). */
+    generateStream(params: SlmGenerateParams): AsyncIterable<string>;
+    /** Embed text for the local vector store. Dimension must be stable. */
+    embed(text: string): Promise<Float32Array>;
+}
+/** Init/load obligation named on typed failures (never silent catch-and-continue). */
+export declare const EDGE_SLM_LOAD_OBLIGATION = "EDGE.SLM_LOAD";
+/** Closed set of SlmRuntime load failure classes. */
+export type SlmRuntimeInitFailureClass = "missing_weights" | "corrupt_weights" | "config";
+/**
+ * Typed initialization/load failure for local model weights.
+ * Hosts MUST surface this to the operator — never retry unboundedly.
+ */
+export declare class SlmRuntimeInitError extends Error {
+    readonly name = "SlmRuntimeInitError";
+    readonly failureClass: SlmRuntimeInitFailureClass;
+    readonly obligationId: string;
+    readonly reason: "missing" | "corrupt" | "config";
+    constructor(message: string, opts: {
+        failureClass: SlmRuntimeInitFailureClass;
+        reason: "missing" | "corrupt" | "config";
+        obligationId?: string;
+    });
+}
+/** Metadata-only telemetry for SLM load/unload (never utterance/prompt bodies). */
+export type SlmRuntimeTelemetryEvent = {
+    event: "edge_agent.slm_runtime";
+    op: "load" | "unload";
+    outcome: "ok" | "init_error";
+    modelId: string;
+    subjectId?: string;
+    deviceId?: string;
+    failureClass?: SlmRuntimeInitFailureClass;
+    obligationId?: string;
+    reason?: "missing" | "corrupt" | "config";
+};
+/** Magic prefix for drill / on-disk weight fixtures (not a full GGUF parser). */
+export declare const SLM_WEIGHTS_MAGIC = "SUTRA-WEIGHTS-v1";
+export type LocalWeightSlmRuntimeOptions = {
+    /** Absolute or relative path to on-disk model weights. */
+    weightsPath: string;
+    subjectId?: string;
+    deviceId?: string;
+    onTelemetry?: (event: SlmRuntimeTelemetryEvent) => void;
+    /**
+     * Optional custom integrity check after magic-header validation.
+     * Return false → corrupt_weights.
+     */
+    inspectWeights?: (bytes: Uint8Array) => boolean;
+};
+/**
+ * File-backed SlmRuntime load seam used for edge degradation drills and
+ * host deployments that materialize weights from disk before inference.
+ *
+ * Missing or corrupt weights → {@link SlmRuntimeInitError} once per `load()`
+ * (no internal retry loop). Generation requires a prior successful load.
+ */
+export declare class LocalWeightSlmRuntime implements SlmRuntime {
+    readonly card: SlmModelCard;
+    private readonly options;
+    private loaded;
+    private loadAttempts;
+    constructor(card: SlmModelCard, options: LocalWeightSlmRuntimeOptions);
+    /** How many times `load()` has been invoked (crash-loop detection). */
+    get loadAttemptCount(): number;
+    get isLoaded(): boolean;
+    load(): Promise<void>;
+    unload(): Promise<void>;
+    generate(_params: SlmGenerateParams): Promise<SlmGenerateResult>;
+    generateStream(params: SlmGenerateParams): AsyncIterable<string>;
+    embed(_text: string): Promise<Float32Array>;
+    private failLoad;
+    private emit;
+}
+/**
+ * Adapter for any localhost OpenAI-compatible endpoint (Ollama, llamafile,
+ * llama.cpp server). This is the reference adapter used by the Playground and
+ * by desktop deployments; mobile targets ship their own native adapters.
+ */
+export declare class OpenAiCompatibleSlmRuntime implements SlmRuntime {
+    readonly card: SlmModelCard;
+    private readonly baseUrl;
+    constructor(card: SlmModelCard, baseUrl?: string);
+    load(): Promise<void>;
+    unload(): Promise<void>;
+    generate(params: SlmGenerateParams): Promise<SlmGenerateResult>;
+    generateStream(params: SlmGenerateParams): AsyncIterable<string>;
+    embed(text: string): Promise<Float32Array>;
+}
+//# sourceMappingURL=slm_runtime.d.ts.map

package/dist/slm_runtime.d.ts.map

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