@saihm/shm 0.0.0-stage → 0.38.1

package/dist/retrieval/thread_lifecycle.js

@@ -0,0 +1,201 @@
+import { withPool } from "./scope.js";
+import { DEFAULT_RERANK } from "../rerank/reranking_retriever.js";
+export const KNOWN_KINDS = ["work-item", "design", "reference", "comms"];
+const STATUS_RE = /(?:^|[\s|,;])status\s*[:=]\s*(open|paused|closed)\b/i;
+const THREAD_RE = /(?:^|[\s|,;])thread\s*[:=]\s*([a-z0-9][a-z0-9-]*)/i;
+const KIND_RE = /(?:^|[\s|,;])kind\s*[:=]\s*([a-z][a-z0-9-]*)/i;
+const CONV_RE = /(?:^|[\s|,;])(?:convention-version|conv-v)\s*[:=]\s*(\d{1,4})\b/i;
+export function parseLifecycle(text) {
+    const out = {};
+    const t = THREAD_RE.exec(text);
+    if (t?.[1])
+        out.thread = t[1].toLowerCase();
+    const s = STATUS_RE.exec(text);
+    if (s?.[1])
+        out.status = s[1].toLowerCase();
+    const k = KIND_RE.exec(text);
+    if (k?.[1])
+        out.kind = k[1].toLowerCase();
+    const c = CONV_RE.exec(text);
+    if (c?.[1]) {
+        const v = Number(c[1]);
+        if (Number.isFinite(v))
+            out.conventionVersion = v;
+    }
+    return out;
+}
+function isDemotable(s) {
+    return s.kind === "work-item" && s.status === "closed";
+}
+function isStamped(s) {
+    return (s.thread !== undefined ||
+        s.status !== undefined ||
+        s.kind !== undefined ||
+        s.conventionVersion !== undefined);
+}
+export function lifecycleDemote(hits, stampOf, mode = "floor") {
+    if (mode === false)
+        return hits;
+    const demotable = hits.map((h) => isDemotable(stampOf(h.cellId)));
+    if (!demotable.includes(true))
+        return hits;
+    if (mode === "floor") {
+        const kept = [];
+        const demoted = [];
+        hits.forEach((h, i) => (demotable[i] ? demoted : kept).push(h));
+        return [...kept, ...demoted];
+    }
+    const n = Number.isFinite(mode) && mode >= 1 ? Math.floor(mode) : 1;
+    return hits
+        .map((h, i) => ({ h, i, d: demotable[i] === true, key: i + (demotable[i] === true ? n : 0) }))
+        .sort((a, b) => a.key - b.key || Number(a.d) - Number(b.d) || a.i - b.i)
+        .map((e) => e.h);
+}
+export function threadJoin(hits, stampOf, maxGroup) {
+    const byThread = new Map();
+    for (const h of hits) {
+        const th = stampOf(h.cellId).thread;
+        if (th === undefined)
+            continue;
+        const g = byThread.get(th);
+        if (g)
+            g.push(h);
+        else
+            byThread.set(th, [h]);
+    }
+    let anyGroup = false;
+    for (const g of byThread.values())
+        if (g.length >= 2) {
+            anyGroup = true;
+            break;
+        }
+    if (!anyGroup)
+        return hits;
+    const cap = maxGroup >= 1 ? Math.floor(maxGroup) : 1;
+    const emitted = new Set();
+    const processed = new Set();
+    const out = [];
+    for (const h of hits) {
+        if (emitted.has(h.cellId))
+            continue;
+        const th = stampOf(h.cellId).thread;
+        if (th !== undefined && !processed.has(th)) {
+            processed.add(th);
+            let n = 0;
+            for (const m of byThread.get(th)) {
+                if (n >= cap)
+                    break;
+                if (emitted.has(m.cellId))
+                    continue;
+                out.push(m);
+                emitted.add(m.cellId);
+                n++;
+            }
+        }
+        else {
+            out.push(h);
+            emitted.add(h.cellId);
+        }
+    }
+    return out;
+}
+export const DEFAULT_THREAD_LIFECYCLE = {
+    poolK: 30,
+    maxThreadGroup: 5,
+    join: true,
+    demote: false,
+};
+function posIntOr(v, fallback) {
+    return Number.isFinite(v) && v >= 1 ? Math.floor(v) : fallback;
+}
+export class ThreadLifecycleRankRetriever {
+    base;
+    stampOf;
+    poolK;
+    maxThreadGroup;
+    join;
+    demote;
+    attempts = 0;
+    threadsJoined = 0;
+    demoted = 0;
+    stampsResolved = 0;
+    selectScored;
+    constructor(base, stampOf, cfg = {}) {
+        this.base = base;
+        this.stampOf = stampOf;
+        this.poolK = posIntOr(cfg.poolK, DEFAULT_THREAD_LIFECYCLE.poolK);
+        this.maxThreadGroup = posIntOr(cfg.maxThreadGroup, DEFAULT_THREAD_LIFECYCLE.maxThreadGroup);
+        this.join = cfg.join ?? DEFAULT_THREAD_LIFECYCLE.join;
+        this.demote = cfg.demote ?? DEFAULT_THREAD_LIFECYCLE.demote;
+        if (this.base.selectScored) {
+            this.selectScored = (query, opts) => this.selectScoredImpl(query, opts);
+        }
+    }
+    get stats() {
+        return {
+            attempts: this.attempts,
+            threadsJoined: this.threadsJoined,
+            demoted: this.demoted,
+            stampsResolved: this.stampsResolved,
+            config: {
+                join: this.join,
+                demote: this.demote,
+                poolK: this.poolK,
+                maxThreadGroup: this.maxThreadGroup,
+            },
+        };
+    }
+    widen(maxK) {
+        return Math.max(this.poolK, maxK ?? this.poolK);
+    }
+    reorder(hits) {
+        const seen = new Map();
+        for (const h of hits) {
+            const st = this.stampOf(h.cellId);
+            if (isStamped(st))
+                this.stampsResolved++;
+            if (this.demote !== false && isDemotable(st))
+                this.demoted++;
+            if (st.thread !== undefined)
+                seen.set(st.thread, (seen.get(st.thread) ?? 0) + 1);
+        }
+        if (this.join)
+            for (const n of seen.values())
+                if (n >= 2)
+                    this.threadsJoined++;
+        const demotedOrder = lifecycleDemote(hits, this.stampOf, this.demote);
+        return this.join ? threadJoin(demotedOrder, this.stampOf, this.maxThreadGroup) : demotedOrder;
+    }
+    async select(query, opts) {
+        const maxK = opts?.maxK;
+        const pool = await this.base.select(query, withPool(opts, this.widen(maxK)));
+        if (pool.length <= 1)
+            return maxK !== undefined ? pool.slice(0, maxK) : pool;
+        this.attempts++;
+        const reordered = this.reorder(pool.map((cellId) => ({ cellId }))).map((h) => h.cellId);
+        return maxK !== undefined ? reordered.slice(0, maxK) : reordered;
+    }
+    async selectScoredImpl(query, opts) {
+        const maxK = opts?.maxK;
+        const pool = await this.base.selectScored(query, withPool(opts, this.widen(maxK)));
+        if (pool.length <= 1)
+            return maxK !== undefined ? pool.slice(0, maxK) : pool;
+        this.attempts++;
+        const reordered = this.reorder(pool);
+        return maxK !== undefined ? reordered.slice(0, maxK) : reordered;
+    }
+}
+export function assertThreadPoolWithinRerank(opts) {
+    if (!opts.hasReranker || opts.allowWider === true)
+        return;
+    const eff = (v, fallback) => typeof v === "number" && Number.isFinite(v) && v >= 1 ? Math.floor(v) : fallback;
+    const effectiveRerankK = eff(opts.rerankK, DEFAULT_RERANK.rerankK);
+    const wantPoolK = eff(opts.threadPoolK, DEFAULT_THREAD_LIFECYCLE.poolK);
+    if (wantPoolK <= effectiveRerankK)
+        return;
+    throw new Error(`threadPoolK (${wantPoolK}) > rerankK (${effectiveRerankK}) widens the reranker's scored pool, ` +
+        `which voids the byte-identical-when-unstamped guarantee even on a corpus with no ` +
+        `stamps. Raise rerankK to >= ${wantPoolK}, lower threadPoolK, or set ` +
+        `allowThreadPoolWiderThanRerank:true to accept it deliberately.`);
+}
+//# sourceMappingURL=thread_lifecycle.js.map

package/dist/retrieval/thread_lifecycle.js.map

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

package/dist/retrieval/vector_store.d.ts

@@ -0,0 +1,22 @@
+export interface DenseHit {
+    readonly id: number;
+    readonly score: number;
+}
+export interface VectorStore {
+    readonly dim: number;
+    readonly size: number;
+    query(qv: Float32Array, limit: number): DenseHit[];
+    remove(id: number): boolean;
+}
+export declare class FlatStore implements VectorStore {
+    readonly dim: number;
+    private readonly vecs;
+    constructor(dim: number, items: readonly {
+        readonly id: number;
+        readonly vec: Float32Array;
+    }[]);
+    get size(): number;
+    query(qv: Float32Array, limit: number): DenseHit[];
+    remove(id: number): boolean;
+}
+//# sourceMappingURL=vector_store.d.ts.map

package/dist/retrieval/vector_store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector_store.d.ts","sourceRoot":"","sources":["../../src/retrieval/vector_store.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,EAAE,CAAC;IACnD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;CAC7B;AAED,qBAAa,SAAU,YAAW,WAAW;IAC3C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmC;gBAGtD,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,SAAS;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAA;KAAE,EAAE;IAavE,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,KAAK,CAAC,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,EAAE;IAiBlD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAO5B"}

package/dist/retrieval/vector_store.js

@@ -0,0 +1,41 @@
+export class FlatStore {
+    dim;
+    vecs = new Map();
+    constructor(dim, items) {
+        this.dim = dim;
+        for (const { id, vec } of items) {
+            if (vec.length !== dim) {
+                throw new Error(`FlatStore: vector for id ${id} has dim ${vec.length}, store dim ${dim} (fail-closed)`);
+            }
+            this.vecs.set(id, vec);
+        }
+    }
+    get size() {
+        return this.vecs.size;
+    }
+    query(qv, limit) {
+        if (qv.length !== this.dim) {
+            throw new Error(`FlatStore: query dim ${qv.length} != store dim ${this.dim} (fail-closed)`);
+        }
+        const hits = [];
+        for (const [id, vec] of this.vecs) {
+            let s = 0;
+            for (let i = 0; i < vec.length; i++)
+                s += qv[i] * vec[i];
+            hits.push({ id, score: s });
+        }
+        if (limit >= hits.length)
+            return hits;
+        hits.sort((a, b) => b.score - a.score);
+        return hits.slice(0, limit);
+    }
+    remove(id) {
+        const vec = this.vecs.get(id);
+        if (!vec)
+            return false;
+        vec.fill(0);
+        this.vecs.delete(id);
+        return true;
+    }
+}
+//# sourceMappingURL=vector_store.js.map

package/dist/retrieval/vector_store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector_store.js","sourceRoot":"","sources":["../../src/retrieval/vector_store.ts"],"names":[],"mappings":"AAYA,MAAM,OAAO,SAAS;IACX,GAAG,CAAS;IACJ,IAAI,GAAG,IAAI,GAAG,EAAwB,CAAC;IAExD,YACE,GAAW,EACX,KAAqE;QAErE,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,KAAK,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,KAAK,EAAE,CAAC;YAChC,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CACb,4BAA4B,EAAE,YAAY,GAAG,CAAC,MAAM,eAAe,GAAG,gBAAgB,CACvF,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,EAAgB,EAAE,KAAa;QACnC,IAAI,EAAE,CAAC,MAAM,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CACb,wBAAwB,EAAE,CAAC,MAAM,iBAAiB,IAAI,CAAC,GAAG,gBAAgB,CAC3E,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAe,EAAE,CAAC;QAC5B,KAAK,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAClC,IAAI,CAAC,GAAG,CAAC,CAAC;YACV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE;gBAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAE,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC;YAC3D,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9B,CAAC;QACD,IAAI,KAAK,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACtC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,CAAC,EAAU;QACf,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,CAAC,GAAG;YAAE,OAAO,KAAK,CAAC;QACvB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACZ,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/retrieval/version_supersession.d.ts

@@ -0,0 +1,13 @@
+export interface VersionedCell {
+    readonly cellId: string;
+    readonly label: string;
+    readonly epoch: number;
+}
+export interface Currency {
+    readonly stem: string;
+    readonly version: number;
+    readonly dateOrd: number;
+}
+export declare function parseCurrency(label: string): Currency;
+export declare function computeVersionSupersededBy(cells: readonly VersionedCell[]): Map<string, string>;
+//# sourceMappingURL=version_supersession.d.ts.map

package/dist/retrieval/version_supersession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version_supersession.d.ts","sourceRoot":"","sources":["../../src/retrieval/version_supersession.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AA6BD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CA2BrD;AAmBD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAqB/F"}

package/dist/retrieval/version_supersession.js

@@ -0,0 +1,97 @@
+const NAME_BOUNDARY_RE = /\n|\s[—–]\s?|\s\(|\.\s/;
+const VERSION_RE = /[\s\-_]v(\d{1,4})\b/gi;
+const DATE_RE = /[\s\-_]?(\d{4})-(\d{2})-(\d{2})(?:[t~][\d:.~]*z?)?([a-z]?)\b/gi;
+function nameOf(label) {
+    const m = NAME_BOUNDARY_RE.exec(label);
+    const name = m ? label.slice(0, m.index) : label;
+    return name.slice(0, 100);
+}
+function normalizeStem(name) {
+    return name
+        .replace(VERSION_RE, " ")
+        .replace(DATE_RE, " ")
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+function isSubstantialStem(stem) {
+    let segs = 0;
+    for (const s of stem.split("-"))
+        if (s.length >= 2)
+            segs++;
+    return segs >= 2;
+}
+export function parseCurrency(label) {
+    const name = nameOf(label);
+    const stem = normalizeStem(name);
+    let version = 0;
+    for (const m of name.matchAll(VERSION_RE)) {
+        const v = Number(m[1]);
+        if (Number.isFinite(v) && v > version)
+            version = v;
+    }
+    let dateOrd = 0;
+    for (const m of name.matchAll(DATE_RE)) {
+        const y = Number(m[1]);
+        const mo = Number(m[2]);
+        const d = Number(m[3]);
+        if (!Number.isFinite(y) || !Number.isFinite(mo) || !Number.isFinite(d))
+            continue;
+        if (mo < 1 || mo > 12 || d < 1 || d > 31)
+            continue;
+        let ord = y * 10000 + mo * 100 + d;
+        const letter = m[4];
+        if (letter && letter.length === 1) {
+            const bump = (letter.toLowerCase().charCodeAt(0) - 96) / 100;
+            if (bump > 0 && bump < 1)
+                ord += bump;
+        }
+        if (ord > dateOrd)
+            dateOrd = ord;
+    }
+    return { stem, version, dateOrd };
+}
+function strictlyDominated(a, b) {
+    if (a.version !== b.version)
+        return a.version < b.version;
+    return a.dateOrd < b.dateOrd;
+}
+function moreCurrent(m, best) {
+    if (m.cur.version !== best.cur.version)
+        return m.cur.version > best.cur.version;
+    if (m.cur.dateOrd !== best.cur.dateOrd)
+        return m.cur.dateOrd > best.cur.dateOrd;
+    if (m.cell.epoch !== best.cell.epoch)
+        return m.cell.epoch > best.cell.epoch;
+    return m.cell.cellId < best.cell.cellId;
+}
+export function computeVersionSupersededBy(cells) {
+    const groups = new Map();
+    for (const cell of cells) {
+        const cur = parseCurrency(cell.label);
+        if (!isSubstantialStem(cur.stem))
+            continue;
+        const g = groups.get(cur.stem);
+        if (g)
+            g.push({ cell, cur });
+        else
+            groups.set(cur.stem, [{ cell, cur }]);
+    }
+    const out = new Map();
+    for (const members of groups.values()) {
+        if (members.length < 2)
+            continue;
+        let current = members[0];
+        for (const m of members)
+            if (moreCurrent(m, current))
+                current = m;
+        for (const m of members) {
+            if (m.cell.cellId === current.cell.cellId)
+                continue;
+            if (strictlyDominated(m.cur, current.cur))
+                out.set(m.cell.cellId, current.cell.cellId);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=version_supersession.js.map

package/dist/retrieval/version_supersession.js.map

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

package/dist/saihm_client/federated_port.d.ts

@@ -0,0 +1,30 @@
+import type { IndexEntry, RecalledBody, RecallOptions, SaihmReadPort } from "./types.js";
+import type { LifecycleStamp } from "../retrieval/thread_lifecycle.js";
+export interface FederatedSource {
+    readonly tag: string;
+    readonly port: SaihmReadPort;
+}
+export interface FederatedReadPortOptions {
+    readonly tenantId?: string;
+    readonly separator?: string;
+    readonly agentIdHash?: string;
+}
+export declare const DEFAULT_SEPARATOR = "::";
+export declare class FederatedReadPort implements SaihmReadPort {
+    readonly tenantId: string;
+    readonly agentIdHash?: string | undefined;
+    readonly identityNote: string;
+    private readonly sources;
+    private readonly sep;
+    get separator(): string;
+    private recallSourceFailures;
+    constructor(sources: readonly FederatedSource[], opts?: FederatedReadPortOptions);
+    private prefix;
+    readonly stampOf: (cellId: string) => LifecycleStamp;
+    readIndex(): Promise<IndexEntry[]>;
+    recallByQuery(query: string, opts?: RecallOptions): Promise<RecalledBody[]>;
+    get stats(): {
+        readonly recallSourceFailures: number;
+    };
+}
+//# sourceMappingURL=federated_port.d.ts.map

package/dist/saihm_client/federated_port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"federated_port.d.ts","sourceRoot":"","sources":["../../src/saihm_client/federated_port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzF,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,kCAAkC,CAAC;AAEpF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;CAC9B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,qBAAa,iBAAkB,YAAW,aAAa;IACrD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,IAAI,SAAS,IAAI,MAAM,CAEtB;IACD,OAAO,CAAC,oBAAoB,CAAK;gBAErB,OAAO,EAAE,SAAS,eAAe,EAAE,EAAE,IAAI,GAAE,wBAA6B;IAkCpF,OAAO,CAAC,MAAM;IAId,QAAQ,CAAC,OAAO,GAAI,QAAQ,MAAM,KAAG,cAAc,CASjD;IAEI,SAAS,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IASlC,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAejF,IAAI,KAAK,IAAI;QAAE,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAA;KAAE,CAErD;CACF"}

package/dist/saihm_client/federated_port.js

@@ -0,0 +1,99 @@
+export const DEFAULT_SEPARATOR = "::";
+export class FederatedReadPort {
+    tenantId;
+    agentIdHash;
+    identityNote;
+    sources;
+    sep;
+    get separator() {
+        return this.sep;
+    }
+    recallSourceFailures = 0;
+    constructor(sources, opts = {}) {
+        if (sources.length === 0)
+            throw new Error("FederatedReadPort needs >=1 source");
+        this.sep = opts.separator ?? DEFAULT_SEPARATOR;
+        if (this.sep.length === 0)
+            throw new Error("FederatedReadPort separator must be non-empty");
+        const seen = new Set();
+        for (const s of sources) {
+            if (!s.tag)
+                throw new Error("FederatedReadPort source tag must be non-empty");
+            if (s.tag.includes(this.sep)) {
+                throw new Error(`FederatedReadPort source tag "${s.tag}" must not contain the separator "${this.sep}"`);
+            }
+            if (seen.has(s.tag))
+                throw new Error(`FederatedReadPort duplicate source tag "${s.tag}"`);
+            seen.add(s.tag);
+        }
+        this.sources = [...sources];
+        this.tenantId = opts.tenantId ?? `federated(${this.sources.map((s) => s.tag).join("+")})`;
+        if (opts.agentIdHash !== undefined) {
+            if (!/^[0-9a-f]{64}$/.test(opts.agentIdHash))
+                throw new Error("FederatedReadPort agentIdHash must be a 64-hex agentIdHash");
+            this.agentIdHash = opts.agentIdHash;
+            this.identityNote = "identity given explicitly";
+        }
+        else {
+            const carried = new Map();
+            for (const s of this.sources)
+                if (s.port.agentIdHash !== undefined)
+                    carried.set(s.port.agentIdHash, [...(carried.get(s.port.agentIdHash) ?? []), s.tag]);
+            if (carried.size === 1) {
+                const [id, tags] = [...carried.entries()][0];
+                this.agentIdHash = id;
+                this.identityNote = `identity forwarded from source(s) ${tags.join(", ")}`;
+            }
+            else if (carried.size === 0) {
+                this.identityNote = "no source carries an identity; pass agentIdHash to locate the erasure feed";
+            }
+            else {
+                this.identityNote = `sources carry ${carried.size} distinct identities (${[...carried.values()].map((t) => t.join("+")).join(" vs ")}); none forwarded — pass agentIdHash explicitly`;
+            }
+        }
+    }
+    prefix(tag, cellId) {
+        return `${tag}${this.sep}${cellId}`;
+    }
+    stampOf = (cellId) => {
+        for (const s of this.sources) {
+            const p = this.prefix(s.tag, "");
+            if (!cellId.startsWith(p))
+                continue;
+            const src = s.port;
+            if (typeof src.stamps !== "function")
+                return {};
+            return src.stamps().get(cellId.slice(p.length)) ?? {};
+        }
+        return {};
+    };
+    async readIndex() {
+        const all = [];
+        for (const s of this.sources) {
+            const entries = await s.port.readIndex();
+            for (const e of entries)
+                all.push({ ...e, cellId: this.prefix(s.tag, e.cellId) });
+        }
+        return all;
+    }
+    async recallByQuery(query, opts) {
+        const out = [];
+        for (const s of this.sources) {
+            let bodies;
+            try {
+                bodies = await s.port.recallByQuery(query, opts);
+            }
+            catch {
+                this.recallSourceFailures++;
+                continue;
+            }
+            for (const b of bodies)
+                out.push({ ...b, cellId: this.prefix(s.tag, b.cellId) });
+        }
+        return out;
+    }
+    get stats() {
+        return { recallSourceFailures: this.recallSourceFailures };
+    }
+}
+//# sourceMappingURL=federated_port.js.map

package/dist/saihm_client/federated_port.js.map

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

package/dist/saihm_client/in_memory_port.d.ts

@@ -0,0 +1,35 @@
+import type { ForgetReceipt, IndexEntry, RecalledBody, RecallOptions, RememberReceipt, SaihmPort, ShareOptions, ShareReceipt, ShareRecipient, ShareScope } from "./types.js";
+export interface InMemorySaihmPortOptions {
+    readonly tenantId?: string;
+    readonly agentIdHash?: string;
+    readonly startEpoch?: number;
+    readonly recallCap?: number;
+    readonly maxContentChars?: number;
+    readonly cellIdHexLength?: 32 | 64;
+}
+export declare class InMemorySaihmPort implements SaihmPort {
+    readonly tenantId: string;
+    readonly agentIdHash: string | undefined;
+    private readonly cells;
+    private readonly order;
+    private nextEpoch;
+    private readonly recallCap;
+    private readonly maxContentChars;
+    private readonly cellIdHexLength;
+    readonly shares: ShareReceipt[];
+    constructor(opts?: InMemorySaihmPortOptions);
+    readIndex(): Promise<IndexEntry[]>;
+    recallByQuery(query: string, _opts?: RecallOptions): Promise<RecalledBody[]>;
+    remember(content: string): Promise<RememberReceipt>;
+    forget(cellId: string): Promise<ForgetReceipt | void>;
+    share(cellId: string, recipient: ShareRecipient, scope: ShareScope, opts?: ShareOptions): Promise<ShareReceipt>;
+    bodyOf(cellId: string): string | undefined;
+    private readonly inbound;
+    receiveShare(sharerAgentIdHash: string, cellId: string, plaintext: string): void;
+    readShared(sharerAgentIdHash: string, sharerRecord: {
+        readonly mldsaPubKey: string;
+        readonly mlkemPubKey: string;
+        readonly mlkemPubKeySelfSig: string;
+    }, cellId: string): Promise<string | undefined>;
+}
+//# sourceMappingURL=in_memory_port.d.ts.map

package/dist/saihm_client/in_memory_port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in_memory_port.d.ts","sourceRoot":"","sources":["../../src/saihm_client/in_memory_port.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAC9G,cAAc,EAAE,UAAU,EAC3B,MAAM,YAAY,CAAC;AAMpB,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC;CACpC;AAED,qBAAa,iBAAkB,YAAW,SAAS;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;IAC1C,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,CAAM;gBAEzB,IAAI,GAAE,wBAA6B;IASzC,SAAS,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAclC,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAc5E,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAUnD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAQrD,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;IAczH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;IAElE,YAAY,CAAC,iBAAiB,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAO1E,UAAU,CAAC,iBAAiB,EAAE,MAAM,EAAE,YAAY,EAAE;QAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;KAAE,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;CAI5M"}