@saihm/shm 0.0.0-stage → 0.38.1

package/dist/saihm_client/in_memory_port.js

@@ -0,0 +1,100 @@
+import { createHash } from "node:crypto";
+import { SaihmTransportError } from "./types.js";
+import { guardContent, guardShare } from "./share_guard.js";
+export class InMemorySaihmPort {
+    tenantId;
+    agentIdHash;
+    cells = new Map();
+    order = [];
+    nextEpoch;
+    recallCap;
+    maxContentChars;
+    cellIdHexLength;
+    shares = [];
+    constructor(opts = {}) {
+        this.tenantId = opts.tenantId ?? "local";
+        this.agentIdHash = opts.agentIdHash;
+        this.nextEpoch = Number.isFinite(opts.startEpoch) ? opts.startEpoch : 0;
+        this.recallCap = Number.isFinite(opts.recallCap) && opts.recallCap >= 1 ? Math.floor(opts.recallCap) : 200;
+        this.maxContentChars = Number.isFinite(opts.maxContentChars) && opts.maxContentChars >= 1 ? Math.floor(opts.maxContentChars) : 100_000;
+        this.cellIdHexLength = opts.cellIdHexLength === 32 ? 32 : 64;
+    }
+    async readIndex() {
+        return this.order.map((id) => {
+            const c = this.cells.get(id);
+            return {
+                cellId: c.cellId,
+                label: (c.body ?? "").slice(0, 120),
+                epoch: c.epoch,
+                byteSize: c.body === undefined ? 0 : Buffer.byteLength(c.body, "utf8"),
+                tier: "memory",
+                forgotten: c.forgotten,
+            };
+        });
+    }
+    async recallByQuery(query, _opts) {
+        const q = query.trim().toLowerCase();
+        if (q.length === 0)
+            throw new SaihmTransportError("empty query rejected (would trigger a bulk recall)");
+        const out = [];
+        for (const id of this.order) {
+            const c = this.cells.get(id);
+            if (c.forgotten || c.body === undefined)
+                continue;
+            if (!c.body.toLowerCase().includes(q))
+                continue;
+            out.push({ cellId: c.cellId, plaintext: c.body, epoch: c.epoch, tier: "memory" });
+            if (out.length >= this.recallCap)
+                break;
+        }
+        return out;
+    }
+    async remember(content) {
+        const text = guardContent(content, this.maxContentChars);
+        const cellId = createHash("sha256").update(`${this.order.length}:${text}`).digest("hex").slice(0, this.cellIdHexLength);
+        const shardId = createHash("sha256").update(`shard:${cellId}`).digest("hex");
+        this.cells.set(cellId, { cellId, shardId, epoch: this.nextEpoch, body: text, forgotten: false });
+        if (this.nextEpoch !== 0)
+            this.nextEpoch += 1;
+        this.order.push(cellId);
+        return { cellId, shardId, seq: "1" };
+    }
+    async forget(cellId) {
+        const c = this.cells.get(cellId);
+        if (c === undefined)
+            throw new SaihmTransportError(`forget refused: unknown cellId ${cellId.slice(0, 12)}…`);
+        if (c.forgotten)
+            throw new SaihmTransportError(`forget refused: ${cellId.slice(0, 12)}… is already forgotten`);
+        c.forgotten = true;
+        c.body = undefined;
+    }
+    async share(cellId, recipient, scope, opts = {}) {
+        const id = guardShare(recipient, scope, opts);
+        const c = this.cells.get(cellId);
+        if (c === undefined || c.forgotten)
+            throw new SaihmTransportError(`share refused: ${cellId.slice(0, 12)}… is not a live cell`);
+        const receipt = {
+            cellId,
+            recipientAgentIdHash: id,
+            scope,
+            contractId: createHash("sha256").update(`${id}:${c.shardId}:${scope}:${opts.expiryEpoch ?? ""}`).digest("hex"),
+        };
+        this.shares.push(receipt);
+        return receipt;
+    }
+    bodyOf(cellId) {
+        return this.cells.get(cellId)?.body;
+    }
+    inbound = new Map();
+    receiveShare(sharerAgentIdHash, cellId, plaintext) {
+        const id = sharerAgentIdHash.toLowerCase();
+        const m = this.inbound.get(id) ?? new Map();
+        m.set(cellId, plaintext);
+        this.inbound.set(id, m);
+    }
+    async readShared(sharerAgentIdHash, sharerRecord, cellId) {
+        const id = guardShare({ agentIdHash: sharerAgentIdHash, record: sharerRecord }, "read");
+        return this.inbound.get(id)?.get(cellId);
+    }
+}
+//# sourceMappingURL=in_memory_port.js.map

package/dist/saihm_client/in_memory_port.js.map

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

package/dist/saihm_client/index.d.ts

@@ -0,0 +1,12 @@
+export type { IndexEntry, RecalledBody, RecallOptions, RecallAnswer, ListingPage, SaihmReadPort, SaihmWritePort, SaihmPort, RememberReceipt, ForgetReceipt, ShareScope, ShareRecipient, ShareOptions, ShareReceipt, } from "./types.js";
+export { IgnoredParameterError, SaihmTransportError } from "./types.js";
+export { guardShare, guardContent, guardExpiry, hourEpochNow, expiryEpochHoursFromNow, EPOCH_HOUR_MS, MAX_EXPIRY_HOURS_AHEAD } from "./share_guard.js";
+export { InMemorySaihmPort, type InMemorySaihmPortOptions } from "./in_memory_port.js";
+export { McpSaihmClient, unwrapToolResult, type McpClientConfig, type McpToolCaller, type OwnCellRead } from "./mcp_client.js";
+export { FederatedReadPort } from "./federated_port.js";
+export type { FederatedSource, FederatedReadPortOptions } from "./federated_port.js";
+export { parseServerFeatures, parseLatencyObjective, SERVER_FEATURE_NAMES, READ_VERSION, MAX_LIST_ENTRIES, MAX_LABEL_LENGTH, MAX_REPORT_PATH_LENGTH, MAX_DURATION_LENGTH, FAST_TIERS, OWN_CELL_EVENT_KINDS, WARM_START_TOKEN, } from "./server_features.js";
+export type { FeatureName, FeatureRead, GatedFeatureRead, UnusableRule, ServerFeatures, EventsFeature, WarmStartFeature, ReplicasFeature, ErasureFence, CapacityFeature, AttainmentReport, AttainmentEntry, LatencyObjective, LatencyObjectiveEntry, } from "./server_features.js";
+export { parseTiming, nearestRank, TimingCollector, DEFAULT_SAMPLES_PER_OPERATION, DEFAULT_MAX_OPERATIONS, SAMPLES_PER_OPERATION_LIMIT, OPERATIONS_LIMIT, DEFAULT_MIN_ATTAINMENT_SAMPLES, } from "./timing.js";
+export type { Admission, Timing, TimingRead, Percentiles, AdmissionCounts, OperationTimingReport, TimingReport, RecordRefusal, RecordOutcome, AttainmentGap, ObjectiveAttainment, TimingCollectorOptions, AttainmentOptions, } from "./timing.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/saihm_client/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EACjF,cAAc,EAAE,SAAS,EAAE,eAAe,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,GAClH,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,uBAAuB,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AACvJ,OAAO,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,KAAK,eAAe,EAAE,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC/H,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EACL,mBAAmB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAClH,sBAAsB,EAAE,mBAAmB,EAAE,UAAU,EAAE,oBAAoB,EAAE,gBAAgB,GAChG,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAC1H,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,gBAAgB,EAAE,qBAAqB,GAC1G,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,6BAA6B,EAAE,sBAAsB,EAChG,2BAA2B,EAAE,gBAAgB,EAAE,8BAA8B,GAC9E,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,qBAAqB,EAAE,YAAY,EAAE,aAAa,EAC/G,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,iBAAiB,GAC7F,MAAM,aAAa,CAAC"}

package/dist/saihm_client/index.js

@@ -0,0 +1,8 @@
+export { IgnoredParameterError, SaihmTransportError } from "./types.js";
+export { guardShare, guardContent, guardExpiry, hourEpochNow, expiryEpochHoursFromNow, EPOCH_HOUR_MS, MAX_EXPIRY_HOURS_AHEAD } from "./share_guard.js";
+export { InMemorySaihmPort } from "./in_memory_port.js";
+export { McpSaihmClient, unwrapToolResult } from "./mcp_client.js";
+export { FederatedReadPort } from "./federated_port.js";
+export { parseServerFeatures, parseLatencyObjective, SERVER_FEATURE_NAMES, READ_VERSION, MAX_LIST_ENTRIES, MAX_LABEL_LENGTH, MAX_REPORT_PATH_LENGTH, MAX_DURATION_LENGTH, FAST_TIERS, OWN_CELL_EVENT_KINDS, WARM_START_TOKEN, } from "./server_features.js";
+export { parseTiming, nearestRank, TimingCollector, DEFAULT_SAMPLES_PER_OPERATION, DEFAULT_MAX_OPERATIONS, SAMPLES_PER_OPERATION_LIMIT, OPERATIONS_LIMIT, DEFAULT_MIN_ATTAINMENT_SAMPLES, } from "./timing.js";
+//# sourceMappingURL=index.js.map

package/dist/saihm_client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/saihm_client/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,uBAAuB,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AACvJ,OAAO,EAAE,iBAAiB,EAAiC,MAAM,qBAAqB,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAA8D,MAAM,iBAAiB,CAAC;AAC/H,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EACL,mBAAmB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAClH,sBAAsB,EAAE,mBAAmB,EAAE,UAAU,EAAE,oBAAoB,EAAE,gBAAgB,GAChG,MAAM,sBAAsB,CAAC;AAK9B,OAAO,EACL,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,6BAA6B,EAAE,sBAAsB,EAChG,2BAA2B,EAAE,gBAAgB,EAAE,8BAA8B,GAC9E,MAAM,aAAa,CAAC"}

package/dist/saihm_client/mcp_client.d.ts

@@ -0,0 +1,38 @@
+import type { ForgetReceipt, IndexEntry, ListingPage, OwnCellRead, RecallAnswer, RecalledBody, RecallOptions, RememberReceipt, SaihmPort, ShareOptions, ShareReceipt, ShareRecipient, ShareScope } from "./types.js";
+export type McpToolCaller = (toolName: string, args: Readonly<Record<string, unknown>>) => Promise<unknown>;
+export interface McpClientConfig {
+    readonly endpoint: string;
+    readonly tenantId: string;
+    readonly authToken?: string;
+    readonly callTool?: McpToolCaller;
+    readonly maxContentChars?: number;
+}
+export type { OwnCellRead } from "./types.js";
+export declare function unwrapToolResult(raw: unknown, opts?: {
+    readonly requireObject?: boolean;
+}): unknown;
+export declare class McpSaihmClient implements SaihmPort {
+    readonly tenantId: string;
+    private readonly cfg;
+    constructor(cfg: McpClientConfig);
+    private caller;
+    status(): Promise<Readonly<Record<string, unknown>>>;
+    readIndex(): Promise<IndexEntry[]>;
+    recallByQuery(query: string, opts?: RecallOptions): Promise<RecalledBody[]>;
+    recallByQueryWithMeta(query: string, _opts?: RecallOptions): Promise<RecallAnswer>;
+    recallOwn(cellId: string): Promise<{
+        readonly found: OwnCellRead | null;
+        readonly servedBy?: string;
+        readonly asOf?: string;
+    }>;
+    listVersionsPage(after?: string): Promise<ListingPage>;
+    readShared(sharerAgentIdHash: string, sharerRecord: {
+        readonly mldsaPubKey: string;
+        readonly mlkemPubKey: string;
+        readonly mlkemPubKeySelfSig: string;
+    }, cellId: string): Promise<string | undefined>;
+    remember(content: string): Promise<RememberReceipt>;
+    forget(cellId: string): Promise<ForgetReceipt>;
+    share(cellId: string, recipient: ShareRecipient, scope: ShareScope, opts?: ShareOptions): Promise<ShareReceipt>;
+}
+//# sourceMappingURL=mcp_client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp_client.d.ts","sourceRoot":"","sources":["../../src/saihm_client/mcp_client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EACtJ,cAAc,EAAE,UAAU,EAC3B,MAAM,YAAY,CAAC;AAIpB,MAAM,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAE5G,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAgBD,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAM9C,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,GAAE;IAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAiBvG;AAED,qBAAa,cAAe,YAAW,SAAS;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAkB;gBAE1B,GAAG,EAAE,eAAe;IAKhC,OAAO,CAAC,MAAM;IAQR,MAAM,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAc1D,SAAS,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAQ5B,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAI3E,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAuBlF,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;QAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAmC9H,gBAAgB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAiCtD,UAAU,CACd,iBAAiB,EAAE,MAAM,EACzB,YAAY,EAAE;QAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;KAAE,EACjH,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAcxB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAyBnD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAmB9C,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;CAqB1H"}

package/dist/saihm_client/mcp_client.js

@@ -0,0 +1,266 @@
+import { IgnoredParameterError, SaihmTransportError } from "./types.js";
+import { guardContent, guardShare } from "./share_guard.js";
+const asRecord = (v) => (typeof v === "object" && v !== null ? v : {});
+const HEX64 = /^[0-9a-f]{64}$/;
+const DECIMAL = /^\d+$/;
+const ISO_UTC = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,3})?Z$/;
+const LABEL = /^[\x21-\x7e](?:[\x20-\x7e]{0,62}[\x21-\x7e])?$/;
+function servedByOf(r) {
+    if (!Object.prototype.hasOwnProperty.call(r, "servedBy") || r["servedBy"] === undefined)
+        return {};
+    const v = r["servedBy"];
+    return { servedBy: typeof v === "string" && LABEL.test(v) ? v : "(unreadable)" };
+}
+const asOfOf = (r) => (typeof r["asOf"] === "string" && ISO_UTC.test(r["asOf"]) ? { asOf: r["asOf"] } : {});
+const isPlainObject = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+const excerpt = (s) => s.replace(/[\u0000-\u001f\u007f-\u009f\u200b-\u200f\u202a-\u202e\u2066-\u2069\ufeff]/g, " ").trim().slice(0, 200);
+export function unwrapToolResult(raw, opts = {}) {
+    if (!isPlainObject(raw) || !Array.isArray(raw["content"]))
+        return raw;
+    const texts = raw["content"].filter(isPlainObject).filter((c) => c["type"] === "text" && typeof c["text"] === "string").map((c) => c["text"]);
+    if (raw["isError"] === true)
+        throw new SaihmTransportError(`the tool reported an error: ${excerpt(texts[0] ?? "(no text)")}`);
+    if (isPlainObject(raw["structuredContent"]))
+        return raw["structuredContent"];
+    const first = texts[0];
+    if (first !== undefined) {
+        let parsed;
+        try {
+            parsed = JSON.parse(first);
+        }
+        catch {
+            parsed = undefined;
+        }
+        if (isPlainObject(parsed))
+            return parsed;
+    }
+    if (opts.requireObject === false)
+        return {};
+    throw new SaihmTransportError("the tool answered with display text and no structured result — fail-closed");
+}
+export class McpSaihmClient {
+    tenantId;
+    cfg;
+    constructor(cfg) {
+        this.cfg = cfg;
+        this.tenantId = cfg.tenantId;
+    }
+    caller(what, requireObject = true) {
+        const callTool = this.cfg.callTool;
+        if (callTool === undefined) {
+            throw new SaihmTransportError(`McpSaihmClient.${what}: no callTool supplied (endpoint=${this.cfg.endpoint})`);
+        }
+        return async (toolName, args) => unwrapToolResult(await callTool(toolName, args), { requireObject });
+    }
+    async status() {
+        const call = this.caller("status");
+        let raw;
+        try {
+            raw = await call("saihm_status", {});
+        }
+        catch (e) {
+            throw new SaihmTransportError("status: saihm_status failed", e);
+        }
+        if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+            throw new SaihmTransportError("status: saihm_status returned no status object — fail-closed");
+        }
+        return raw;
+    }
+    readIndex() {
+        return Promise.reject(new SaihmTransportError(`McpSaihmClient.readIndex: the public MCP surface exposes no label index — supply one through another port (endpoint=${this.cfg.endpoint})`));
+    }
+    async recallByQuery(query, opts) {
+        return (await this.recallByQueryWithMeta(query, opts)).bodies;
+    }
+    async recallByQueryWithMeta(query, _opts) {
+        const q = query.trim();
+        if (q.length === 0)
+            throw new SaihmTransportError("empty query rejected (would recall every cell)");
+        const call = this.caller("recallByQuery");
+        let raw;
+        try {
+            raw = await call("saihm_recall", { query: q });
+        }
+        catch (e) {
+            throw new SaihmTransportError(`recallByQuery: saihm_recall failed for ${JSON.stringify(q)}`, e);
+        }
+        const rec = asRecord(raw);
+        const mem = rec["memories"];
+        if (!Array.isArray(mem))
+            throw new SaihmTransportError("recallByQuery: saihm_recall result carries no `memories` array — fail-closed");
+        const out = [];
+        for (const m of mem) {
+            const r = asRecord(m);
+            if (typeof r["cellId"] !== "string" || typeof r["plaintext"] !== "string")
+                continue;
+            const seq = r["seq"];
+            out.push({ cellId: r["cellId"], plaintext: r["plaintext"], epoch: 0, tier: "saihm", ...(typeof seq === "string" && DECIMAL.test(seq) ? { seq } : {}) });
+        }
+        return { bodies: out, ...servedByOf(rec), ...asOfOf(rec) };
+    }
+    async recallOwn(cellId) {
+        if (typeof cellId !== "string" || cellId === "")
+            throw new SaihmTransportError("recallOwn refused: empty cellId");
+        const call = this.caller("recallOwn");
+        let raw;
+        try {
+            raw = await call("saihm_recall", { cellId });
+        }
+        catch (e) {
+            throw new SaihmTransportError(`recallOwn: saihm_recall failed for ${excerpt(cellId.slice(0, 12))}…`, e);
+        }
+        const rec = asRecord(raw);
+        const meta = { ...servedByOf(rec), ...asOfOf(rec) };
+        const said = rec["found"];
+        if (said !== undefined && typeof said !== "boolean")
+            throw new SaihmTransportError("recallOwn: found is neither true nor false — fail-closed");
+        const mem = rec["memories"];
+        if (said === false) {
+            if (mem !== undefined && !(Array.isArray(mem) && mem.length === 0))
+                throw new SaihmTransportError("recallOwn: found false beside memories — contradictory, fail-closed");
+            return { found: null, ...meta };
+        }
+        if (!Array.isArray(mem))
+            throw new SaihmTransportError("recallOwn: saihm_recall result carries no `memories` array — fail-closed");
+        const rows = mem.map(asRecord);
+        if (rows.some((m) => m["cellId"] !== cellId)) {
+            throw new IgnoredParameterError("cellId", "recallOwn: the answer holds cells other than the one asked for, so it is refused (cellId was not applied)");
+        }
+        const hit = rows.find((m) => m["cellId"] === cellId);
+        if (hit === undefined) {
+            if (said === true)
+                throw new SaihmTransportError("recallOwn: found true without the cell — contradictory, fail-closed");
+            return { found: null, ...meta };
+        }
+        const seq = hit["seq"], commitment = hit["commitment"], plaintext = hit["plaintext"];
+        if (typeof seq !== "string" || !DECIMAL.test(seq))
+            throw new SaihmTransportError("recallOwn: the cell carries no decimal seq — fail-closed");
+        if (typeof commitment !== "string" || !HEX64.test(commitment))
+            throw new SaihmTransportError("recallOwn: the cell carries no 64-hex commitment — fail-closed");
+        if (typeof plaintext !== "string")
+            throw new SaihmTransportError("recallOwn: the cell carries no plaintext — fail-closed");
+        return { found: { cellId, seq, commitment, plaintext }, ...meta };
+    }
+    async listVersionsPage(after) {
+        if (after !== undefined && (typeof after !== "string" || after === ""))
+            throw new SaihmTransportError("listVersionsPage refused: an empty `after`");
+        const call = this.caller("listVersionsPage");
+        let raw;
+        try {
+            raw = await call("saihm_recall", { listOnly: true, ...(after !== undefined ? { after } : {}) });
+        }
+        catch (e) {
+            throw new SaihmTransportError("listVersionsPage: saihm_recall failed", e);
+        }
+        const rec = asRecord(raw);
+        if (Object.prototype.hasOwnProperty.call(rec, "mode") && rec["mode"] !== "list") {
+            throw new SaihmTransportError("listVersionsPage: the answer states a mode other than \"list\" — not a listing, fail-closed");
+        }
+        const mem = rec["memories"];
+        if (mem !== undefined && !(Array.isArray(mem) && mem.length === 0)) {
+            throw new SaihmTransportError("listVersionsPage: the answer carries memories — a recall, not a listing (a listing carries no content); fail-closed");
+        }
+        const cells = rec["cells"];
+        if (!Array.isArray(cells))
+            throw new SaihmTransportError("listVersionsPage: the answer is not a listing (no `cells` array) — fail-closed");
+        const next = rec["next"];
+        if (next !== null && (typeof next !== "string" || next === ""))
+            throw new SaihmTransportError("listVersionsPage: `next` is not stated as null or an id — not a listing, fail-closed");
+        const out = [];
+        for (const c of cells) {
+            const r = asRecord(c);
+            const id = r["cellId"], seq = r["seq"], commitment = r["commitment"];
+            if (typeof id !== "string" || id === "")
+                throw new SaihmTransportError("listVersionsPage: a listed cell has no cellId — fail-closed");
+            if (seq !== null && (typeof seq !== "string" || !DECIMAL.test(seq)))
+                throw new SaihmTransportError("listVersionsPage: a listed cell's seq is neither null nor decimal — fail-closed");
+            if (typeof commitment !== "string" || !HEX64.test(commitment))
+                throw new SaihmTransportError("listVersionsPage: a listed cell has no 64-hex commitment — fail-closed");
+            out.push({ cellId: id, seq, commitment });
+        }
+        return { cells: out, next: next, ...asOfOf(rec), ...servedByOf(rec) };
+    }
+    async readShared(sharerAgentIdHash, sharerRecord, cellId) {
+        const call = this.caller("readShared");
+        let raw;
+        try {
+            raw = await call("saihm_recall", { sharerPinnedAgentIdHashHex: sharerAgentIdHash, sharerRecord, cellId });
+        }
+        catch (e) {
+            throw new SaihmTransportError(`readShared: saihm_recall failed for ${cellId.slice(0, 12)}… from ${sharerAgentIdHash.slice(0, 8)}…`, e);
+        }
+        const mem = asRecord(raw)["memories"];
+        if (!Array.isArray(mem))
+            return undefined;
+        const hit = mem.map(asRecord).find((m) => m["cellId"] === cellId && typeof m["plaintext"] === "string");
+        return hit === undefined ? undefined : hit["plaintext"];
+    }
+    async remember(content) {
+        const text = guardContent(content, this.cfg.maxContentChars ?? 100_000);
+        const call = this.caller("remember");
+        let raw;
+        try {
+            raw = await call("saihm_remember", { content: text });
+        }
+        catch (e) {
+            throw new SaihmTransportError("remember: saihm_remember failed", e);
+        }
+        const r = asRecord(raw);
+        if (typeof r["cellId"] !== "string" || r["cellId"] === "") {
+            throw new SaihmTransportError("remember: saihm_remember returned no cellId — refusing to report a mint that cannot be referenced");
+        }
+        const commitment = typeof r["commitment"] === "string" && HEX64.test(r["commitment"]) ? r["commitment"]
+            : typeof r["commitmentHash"] === "string" && HEX64.test(r["commitmentHash"]) ? r["commitmentHash"] : undefined;
+        return {
+            cellId: r["cellId"],
+            ...(typeof r["shardId"] === "string" ? { shardId: r["shardId"] } : {}),
+            ...(typeof r["seq"] === "string" ? { seq: r["seq"] } : {}),
+            ...(typeof r["commitmentHash"] === "string" ? { commitmentHash: r["commitmentHash"] } : {}),
+            ...(commitment !== undefined ? { commitment } : {}),
+            ...(typeof r["at"] === "string" && ISO_UTC.test(r["at"]) ? { at: r["at"] } : {}),
+        };
+    }
+    async forget(cellId) {
+        if (typeof cellId !== "string" || cellId.trim() === "")
+            throw new SaihmTransportError("forget refused: empty cellId");
+        const call = this.caller("forget", false);
+        let raw;
+        try {
+            raw = await call("saihm_forget", { id: cellId });
+        }
+        catch (e) {
+            throw new SaihmTransportError(`forget: saihm_forget failed for ${cellId.slice(0, 12)}…`, e);
+        }
+        const r = asRecord(raw);
+        const complete = r["complete"], reason = r["reason"], anchor = r["destructionAnchor"], at = r["at"];
+        return {
+            ...(typeof complete === "boolean" ? { complete } : {}),
+            ...(typeof reason === "string" && /^[a-z][a-z-]{0,63}$/.test(reason) ? { reason } : {}),
+            ...(typeof anchor === "string" && anchor !== "" ? { destructionAnchor: anchor } : {}),
+            ...(typeof at === "string" && ISO_UTC.test(at) ? { at } : {}),
+        };
+    }
+    async share(cellId, recipient, scope, opts = {}) {
+        const id = guardShare(recipient, scope, opts);
+        if (recipient.record === undefined) {
+            throw new SaihmTransportError("share refused: the MCP share needs the recipient's published record (the cell key is re-wrapped to their ML-KEM key)");
+        }
+        const call = this.caller("share", false);
+        let raw;
+        try {
+            raw = await call("saihm_share", {
+                cellId,
+                recipientPinnedAgentIdHashHex: id,
+                recipientRecord: recipient.record,
+                scope,
+                ...(opts.expiryEpoch !== undefined ? { expiryEpoch: opts.expiryEpoch } : {}),
+            });
+        }
+        catch (e) {
+            throw new SaihmTransportError(`share: saihm_share failed for ${cellId.slice(0, 12)}… → ${id.slice(0, 8)}…`, e);
+        }
+        const r = asRecord(raw);
+        return { cellId, recipientAgentIdHash: id, scope, ...(typeof r["contractId"] === "string" ? { contractId: r["contractId"] } : {}) };
+    }
+}
+//# sourceMappingURL=mcp_client.js.map

package/dist/saihm_client/mcp_client.js.map

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

package/dist/saihm_client/server_features.d.ts

@@ -0,0 +1,112 @@
+export type FeatureName = "events" | "warmStart" | "replicas" | "capacity";
+export declare const SERVER_FEATURE_NAMES: readonly FeatureName[];
+export declare const READ_VERSION = 1;
+export declare const MAX_LIST_ENTRIES = 64;
+export declare const MAX_LABEL_LENGTH = 64;
+export declare const MAX_REPORT_PATH_LENGTH = 256;
+export declare const MAX_DURATION_LENGTH = 64;
+export declare const FAST_TIERS: readonly string[];
+export declare const OWN_CELL_EVENT_KINDS: readonly string[];
+export declare const WARM_START_TOKEN = "required";
+export type FeatureRead<T> = {
+    readonly kind: "available";
+    readonly value: T;
+} | {
+    readonly kind: "absent";
+    readonly reason: string;
+} | {
+    readonly kind: "unsupported-version";
+    readonly reason: string;
+} | {
+    readonly kind: "malformed";
+    readonly field: string;
+    readonly reason: string;
+};
+export type UnusableRule = "fast-tier-only" | "needs-own-cell-events" | "needs-token";
+export type GatedFeatureRead<T> = FeatureRead<T> | {
+    readonly kind: "unusable";
+    readonly rule: UnusableRule;
+    readonly reason: string;
+};
+export interface EventsFeature {
+    readonly v: readonly number[];
+    readonly kinds: readonly string[] | null;
+    readonly ownCellEvents: boolean;
+}
+export interface WarmStartFeature {
+    readonly v: readonly number[];
+    readonly token: typeof WARM_START_TOKEN;
+    readonly maxBytes: number;
+    readonly maxSnapshots: number;
+    readonly retentionS: number;
+}
+export type ErasureFence = "synchronous" | "bounded";
+export interface ReplicasFeature {
+    readonly v: readonly number[];
+    readonly maxStalenessMs: number;
+    readonly erasureFence: ErasureFence;
+}
+export type AttainmentEntry = {
+    readonly operation: string;
+    readonly percentile: number;
+    readonly thresholdMs: number;
+    readonly samples: number;
+    readonly observedMs: number;
+    readonly met: boolean;
+} | {
+    readonly operation: string;
+    readonly percentile: number;
+    readonly thresholdMs: number;
+    readonly samples: number;
+    readonly observedMs: null;
+    readonly met: null;
+};
+export interface AttainmentReport {
+    readonly v: number;
+    readonly window: string;
+    readonly windowMs: number;
+    readonly asOf: string;
+    readonly asOfMs: number;
+    readonly operations: readonly AttainmentEntry[];
+}
+export type CapacityFeature = {
+    readonly v: readonly number[];
+    readonly reserved: true;
+    readonly unit: string;
+    readonly rate: number;
+    readonly burst: number;
+    readonly objectiveApplies: boolean;
+    readonly attainment: FeatureRead<AttainmentReport>;
+} | {
+    readonly v: readonly number[];
+    readonly reserved: false;
+    readonly unit: string;
+    readonly rate: null;
+    readonly burst: null;
+    readonly objectiveApplies: false;
+    readonly attainment: FeatureRead<AttainmentReport>;
+};
+export interface ServerFeatures {
+    readonly events: FeatureRead<EventsFeature>;
+    readonly warmStart: GatedFeatureRead<WarmStartFeature>;
+    readonly replicas: GatedFeatureRead<ReplicasFeature>;
+    readonly capacity: GatedFeatureRead<CapacityFeature>;
+}
+export interface LatencyObjectiveEntry {
+    readonly operation: string;
+    readonly percentile: number;
+    readonly thresholdMs: number;
+}
+export interface LatencyObjective {
+    readonly v: readonly number[];
+    readonly window: string;
+    readonly windowMs: number;
+    readonly measured: "service";
+    readonly objectives: readonly LatencyObjectiveEntry[];
+    readonly tiers: readonly string[];
+    readonly reportPath: string | null;
+}
+export declare function isFeatureLabel(s: unknown): s is string;
+export declare function parseServerFeatures(statusResult: unknown): ServerFeatures;
+export declare function parseLatencyObjective(infoDocument: unknown): FeatureRead<LatencyObjective>;
+//# sourceMappingURL=server_features.d.ts.map

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

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