@superbee/core 0.2.0-pre.3 → 0.2.0-pre.31

package/dist/governed-body-write.js

@@ -0,0 +1,251 @@
+/** Immutable delivery evidence for body-only updates whose authority owns document metadata. */
+import { parseMarkdown, normalizeDocumentBodyForStorage } from "./frontmatter.js";
+import { assertSafeConceptId, isReservedFile, pathFromConceptId } from "./paths.js";
+import { parseIsoInstant } from "./verification.js";
+import { isContentVersion, versionOfBytes } from "./versioning.js";
+import { isRequestIdentity, performUncertainWrite } from "./uncertain-write.js";
+/**
+ * One body update's bounds. `bodyBytes` is a library ceiling in UTF-8 bytes, equal to the hosted
+ * kernel's document write bound (983,040) in raw bytes; a host that measures differently (the
+ * kernel measures canonical JSON and keeps definition documents at 64 KiB) preflights its own
+ * measure. The envelope carries the body twice (the operation and the prepared content),
+ * JSON-escaped, so it is 4 MiB.
+ */
+export const BODY_DELIVERY_LIMITS = Object.freeze({ labelBytes: 2048, bodyBytes: 983_040, envelopeBytes: 4 * 1024 * 1024 });
+/** Complete journal reconciliation has a separate bound from each delivery envelope. */
+export const BODY_RECONCILIATION_BYTES = 32 * 1024 * 1024;
+function fail(message) { throw new Error(`Invalid body delivery: ${message}`); }
+function record(value, keys, optional = []) {
+    if (!value || typeof value !== "object" || Array.isArray(value) ||
+        ![Object.prototype, null].includes(Object.getPrototypeOf(value)))
+        fail("expected a plain record");
+    const descriptors = Object.getOwnPropertyDescriptors(value);
+    if (Reflect.ownKeys(value).some(key => typeof key !== "string" || !keys.includes(key) && !optional.includes(key)) ||
+        Object.values(descriptors).some(d => !d.enumerable || !("value" in d)) || keys.some(key => !Object.hasOwn(value, key)))
+        fail("unexpected or missing fields");
+    return value;
+}
+function string(value, max = BODY_DELIVERY_LIMITS.labelBytes, nonempty = true) {
+    if (typeof value !== "string" || nonempty && !value.trim() || new TextEncoder().encode(value).length > max)
+        fail("invalid string or size limit");
+    return value;
+}
+function version(value) { if (!isContentVersion(value))
+    fail("invalid version"); return value; }
+function request(value) { const id = string(value); if (!isRequestIdentity(id))
+    fail("invalid request identity"); return id; }
+function timestamp(value) { const text = string(value); if (parseIsoInstant(text) === null)
+    fail("invalid timestamp"); return text; }
+function integer(value) { if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0)
+    fail("invalid count"); return value; }
+function target(value) {
+    const id = string(value);
+    assertSafeConceptId(id);
+    if (isReservedFile(pathFromConceptId(id)))
+        fail("reserved target");
+    return id;
+}
+function bounded(value) { string(JSON.stringify(value), BODY_DELIVERY_LIMITS.envelopeBytes); return value; }
+function bodyContent(content, body, id, okfVersion) {
+    const raw = string(content, BODY_DELIVERY_LIMITS.envelopeBytes, false);
+    const parsed = parseMarkdown(raw, id, { okfVersion });
+    if (typeof parsed.frontmatter.type !== "string" || !parsed.frontmatter.type.trim())
+        fail("concept type required");
+    if (normalizeDocumentBodyForStorage(parsed.body) !== normalizeDocumentBodyForStorage(body))
+        fail("content body differs from operation");
+    return raw;
+}
+/** Capture a serialized envelope without changing its request identity or original history. */
+export function validatePreparedBodyDelivery(value) {
+    const raw = record(value, ["schema", "scope", "requestId", "target", "okfVersion", "operation", "expectedVersion", "local", "content", "createdAt"], ["predecessor"]);
+    if (raw.schema !== 1 || raw.okfVersion !== "0.1" && raw.okfVersion !== "0.2")
+        fail("unsupported schema or edition");
+    const op = record(raw.operation, ["kind", "body"]);
+    if (op.kind !== "document.body.update")
+        fail("unsupported operation");
+    const operation = Object.freeze({ kind: "document.body.update", body: string(op.body, BODY_DELIVERY_LIMITS.bodyBytes, false) });
+    const id = target(raw.target);
+    const content = bodyContent(raw.content, operation.body, id, raw.okfVersion);
+    const local = version(raw.local);
+    if (versionOfBytes(content) !== local)
+        fail("local content hash mismatch");
+    let predecessor;
+    if (Object.hasOwn(raw, "predecessor")) {
+        const p = record(raw.predecessor, ["requestId", "acknowledgedVersion"]);
+        predecessor = Object.freeze({ requestId: request(p.requestId), acknowledgedVersion: version(p.acknowledgedVersion) });
+        if (predecessor.requestId === raw.requestId || predecessor.acknowledgedVersion !== raw.expectedVersion)
+            fail("invalid predecessor");
+    }
+    return Object.freeze(bounded({ schema: 1, scope: string(raw.scope), requestId: request(raw.requestId), target: id,
+        okfVersion: raw.okfVersion, operation, expectedVersion: version(raw.expectedVersion), local, content,
+        createdAt: timestamp(raw.createdAt), ...(predecessor ? { predecessor } : {}) }));
+}
+/** Successors derive their premise only from a fully bound predecessor receipt. */
+export function prepareBodyDelivery(input, premise) {
+    const fields = record(input, ["scope", "requestId", "target", "okfVersion", "operation", "local", "content", "createdAt"]);
+    if (Object.hasOwn(premise, "expectedVersion")) {
+        const initial = record(premise, ["expectedVersion"]);
+        return validatePreparedBodyDelivery({ ...fields, schema: 1, expectedVersion: initial.expectedVersion });
+    }
+    const prior = record(premise, ["prepared", "receipt"]);
+    const prepared = validatePreparedBodyDelivery(prior.prepared);
+    const receipt = validateBodyReceipt(prepared, prior.receipt);
+    if (fields.scope !== prepared.scope || fields.target !== prepared.target || fields.okfVersion !== prepared.okfVersion || fields.requestId === prepared.requestId)
+        fail("successor identity mismatch");
+    return validatePreparedBodyDelivery({ ...fields, schema: 1, expectedVersion: receipt.version,
+        predecessor: { requestId: prepared.requestId, acknowledgedVersion: receipt.version } });
+}
+export function assertSameBodyDelivery(recorded, candidate) {
+    if (JSON.stringify(validatePreparedBodyDelivery(recorded)) !== JSON.stringify(validatePreparedBodyDelivery(candidate)))
+        fail("request identity reused with different input");
+}
+/** Content/version association is asserted by the trusted authority, not inferred from a later head. */
+export function validateBodyReceipt(prepared, value) {
+    const p = validatePreparedBodyDelivery(prepared);
+    const raw = record(value, ["scope", "requestId", "target", "expectedVersion", "body", "version", "content"]);
+    if (raw.scope !== p.scope || raw.requestId !== p.requestId || raw.target !== p.target ||
+        raw.expectedVersion !== p.expectedVersion || raw.body !== p.operation.body)
+        fail("receipt binding mismatch");
+    return Object.freeze(bounded({ scope: p.scope, requestId: p.requestId, target: p.target, expectedVersion: p.expectedVersion,
+        body: p.operation.body, version: version(raw.version), content: bodyContent(raw.content, p.operation.body, p.target, p.okfVersion) }));
+}
+function captureOutcome(prepared, value) {
+    try {
+        if (!value || typeof value !== "object")
+            fail("invalid outcome");
+        switch (value.kind) {
+            case "committed": {
+                const raw = record(value, ["kind", "receipt"]);
+                const receipt = validateBodyReceipt(prepared, raw.receipt);
+                return Object.freeze({ kind: "committed", version: receipt.version, receipt });
+            }
+            case "conflict": {
+                const raw = record(value, ["kind", "actual"]);
+                return { kind: "conflict", actual: raw.actual === null ? null : version(raw.actual) };
+            }
+            case "refused": {
+                const raw = record(value, ["kind", "code", "message"]);
+                return { kind: "refused", code: string(raw.code), message: string(raw.message) };
+            }
+            case "unknown":
+                record(value, ["kind"]);
+                return { kind: "unknown" };
+            default: fail("unknown outcome kind");
+        }
+    }
+    catch {
+        return { kind: "unknown", diagnostic: "Invalid or incomplete delivery evidence" };
+    }
+}
+/** Persist the envelope and attempted claim atomically BEFORE calling; this function does no persistence. */
+export async function performBodyDelivery(transport, prepared, attempts, options = {}) {
+    const p = validatePreparedBodyDelivery(prepared);
+    integer(attempts);
+    const raw = record(options, [], ["deadlineMs", "maxLookups", "lookupDelayMs", "maxSubmissions", "sleep"]);
+    for (const key of ["deadlineMs", "maxLookups", "lookupDelayMs", "maxSubmissions"])
+        if (Object.hasOwn(raw, key))
+            integer(raw[key]);
+    if (raw.sleep !== undefined && typeof raw.sleep !== "function")
+        fail("invalid timer");
+    if (attempts > Number.MAX_SAFE_INTEGER - Math.max(1, options.maxSubmissions ?? 2))
+        fail("attempt counter overflow");
+    const result = await performUncertainWrite({
+        submit: async (_intent, signal) => captureOutcome(p, await transport.submit(p, signal)),
+        lookup: async () => { const value = await transport.lookup(p); return value === null ? null : captureOutcome(p, value); },
+    }, { requestId: p.requestId, kind: p.operation.kind, target: p.target, base: p.expectedVersion, local: p.local,
+        content: p.content, createdAt: p.createdAt, attempts, state: "pending" }, { ...options, settlement: "recorded-only" });
+    // Evidence travels on the chosen outcome, so a deadline-late response cannot replace it.
+    const chosen = result.outcome;
+    const outcome = chosen.kind === "committed"
+        ? chosen.receipt && chosen.receipt.version === chosen.version ? { kind: "committed", receipt: chosen.receipt } : { kind: "unknown" }
+        : chosen.kind === "unknown" ? { kind: "unknown" } : chosen;
+    return Object.freeze({ prepared: p, attempts: result.intent.attempts, state: outcome.kind === "committed" ? "acknowledged" : outcome.kind,
+        lookups: result.lookups, outcome: Object.freeze(outcome), ...(chosen.diagnostic ? { diagnostic: chosen.diagnostic } : {}) });
+}
+function freezeDeep(value) {
+    if (value && typeof value === "object") {
+        for (const child of Object.values(value))
+            freezeDeep(child);
+        Object.freeze(value);
+    }
+    return value;
+}
+function captureIntent(value) {
+    const row = record(value, ["requestId", "kind", "target", "base", "local", "content", "createdAt", "attempts", "state", "sequence", "updatedAt", "baseContent"], ["after", "acknowledgedVersion", "remote", "refusal", "finding"]);
+    request(row.requestId);
+    string(row.kind);
+    target(row.target);
+    version(row.local);
+    if (row.base !== null)
+        version(row.base);
+    string(row.content, BODY_DELIVERY_LIMITS.envelopeBytes, false);
+    if (row.baseContent !== null)
+        string(row.baseContent, BODY_DELIVERY_LIMITS.envelopeBytes, false);
+    timestamp(row.createdAt);
+    timestamp(row.updatedAt);
+    integer(row.attempts);
+    integer(row.sequence);
+    if (!["pending", "in_flight", "acknowledged", "conflict", "refused", "unknown"].includes(row.state))
+        fail("invalid journal state");
+    if (Object.hasOwn(row, "after"))
+        request(row.after);
+    if (Object.hasOwn(row, "acknowledgedVersion"))
+        version(row.acknowledgedVersion);
+    if (Object.hasOwn(row, "finding"))
+        string(row.finding);
+    if (Object.hasOwn(row, "remote")) {
+        const remote = record(row.remote, ["version", "content"]);
+        if (remote.version !== null)
+            version(remote.version);
+        if (remote.content !== null)
+            string(remote.content, BODY_DELIVERY_LIMITS.envelopeBytes, false);
+    }
+    if (Object.hasOwn(row, "refusal")) {
+        const refusal = record(row.refusal, ["code", "message"]);
+        string(refusal.code);
+        string(refusal.message);
+    }
+    return JSON.parse(JSON.stringify(row));
+}
+/** Pure proposal only. Replacement requires an atomic full-journal, document AND shared-base CAS. */
+export function reconcileBodyReceipt(prepared, receipt, snapshot) {
+    const p = validatePreparedBodyDelivery(prepared), r = validateBodyReceipt(p, receipt);
+    record(snapshot, ["version", "intents", "shared"]);
+    if (snapshot.version !== null)
+        version(snapshot.version);
+    if (!Array.isArray(snapshot.intents))
+        fail("invalid journal snapshot");
+    if (Object.keys(snapshot.intents).length !== snapshot.intents.length)
+        fail("invalid journal list");
+    let shared = null;
+    if (snapshot.shared !== null) {
+        const raw = record(snapshot.shared, ["version", "content"]);
+        const content = string(raw.content, BODY_DELIVERY_LIMITS.envelopeBytes, false);
+        const parsed = parseMarkdown(content, p.target, { okfVersion: p.okfVersion });
+        if (typeof parsed.frontmatter.type !== "string" || !parsed.frontmatter.type.trim())
+            fail("shared concept type required");
+        shared = { version: version(raw.version), content };
+    }
+    // Shared refresh can advance independently of the document and journal; compare all three.
+    const expected = { version: snapshot.version, intents: snapshot.intents.map(captureIntent), shared };
+    string(JSON.stringify(expected), BODY_RECONCILIATION_BYTES);
+    const ids = new Set(), sequences = new Set();
+    for (const row of expected.intents) {
+        request(row.requestId);
+        integer(row.sequence);
+        if (ids.has(row.requestId) || sequences.has(row.sequence))
+            fail("ambiguous journal snapshot");
+        ids.add(row.requestId);
+        sequences.add(row.sequence);
+    }
+    const anchor = expected.intents.find(row => row.requestId === p.requestId);
+    const boundAnchor = anchor?.target === p.target && anchor.local === p.local && anchor.content === p.content && anchor.createdAt === p.createdAt;
+    const newer = anchor ? expected.intents.filter(row => row.target === p.target && row.sequence > anchor.sequence) : [];
+    const compatible = boundAnchor && !newer.some(row => row.state === "acknowledged");
+    const alreadyShared = shared?.version === r.version && shared.content === r.content;
+    const advanceShared = compatible && shared?.version === p.expectedVersion && shared.version !== r.version;
+    const replace = compatible && (advanceShared || alreadyShared) && expected.version === p.local && newer.length === 0;
+    return freezeDeep({ action: replace ? "replace-local-under-CAS" : "preserve-local", receipt: r,
+        shared: advanceShared ? { action: "replace-shared-under-CAS", version: r.version, content: r.content } : { action: "preserve-shared" }, expected });
+}
+//# sourceMappingURL=governed-body-write.js.map

package/dist/governed-body-write.js.map

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

package/dist/host-policy-snapshot.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Capture structural host policy: public fields, nested records/arrays, and prototype methods.
+ * Methods compose through the captured receiver, never through the caller's mutable object.
+ * Getters are evaluated once. Callbacks may still observe external OS facts. Policies must not
+ * require opaque internal slots/private fields or functions pre-bound to a mutable receiver;
+ * those cannot be reconstructed from a structural interface. Caller objects are never frozen.
+ */
+export declare function snapshotHostPolicy<T extends object>(input: T, seen?: WeakMap<object, object>): T;
+//# sourceMappingURL=host-policy-snapshot.d.ts.map

package/dist/host-policy-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-policy-snapshot.d.ts","sourceRoot":"","sources":["../src/host-policy-snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,0BAAgC,GAAG,CAAC,CAuBtG"}

package/dist/host-policy-snapshot.js

@@ -0,0 +1,33 @@
+/**
+ * Capture structural host policy: public fields, nested records/arrays, and prototype methods.
+ * Methods compose through the captured receiver, never through the caller's mutable object.
+ * Getters are evaluated once. Callbacks may still observe external OS facts. Policies must not
+ * require opaque internal slots/private fields or functions pre-bound to a mutable receiver;
+ * those cannot be reconstructed from a structural interface. Caller objects are never frozen.
+ */
+export function snapshotHostPolicy(input, seen = new WeakMap()) {
+    const existing = seen.get(input);
+    if (existing)
+        return existing;
+    const result = (Array.isArray(input) ? [] : {});
+    seen.set(input, result);
+    const keys = new Set();
+    for (let owner = input; owner && owner !== Object.prototype && owner !== Array.prototype; owner = Object.getPrototypeOf(owner)) {
+        for (const key of Reflect.ownKeys(owner)) {
+            if (key !== "constructor" && !(Array.isArray(input) && key === "length"))
+                keys.add(key);
+        }
+    }
+    for (const key of keys) {
+        const value = input[key];
+        Object.defineProperty(result, key, {
+            value: typeof value === "function" ? value.bind(result)
+                : value && typeof value === "object" ? snapshotHostPolicy(value, seen) : value,
+            enumerable: true,
+        });
+    }
+    if (Array.isArray(input))
+        result.length = input.length;
+    return Object.freeze(result);
+}
+//# sourceMappingURL=host-policy-snapshot.js.map

package/dist/host-policy-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-policy-snapshot.js","sourceRoot":"","sources":["../src/host-policy-snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAmB,KAAQ,EAAE,OAAO,IAAI,OAAO,EAAkB;IACjG,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,QAAQ;QAAE,OAAO,QAAa,CAAC;IACnC,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAiC,CAAC;IAChF,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACxB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAe,CAAC;IACpC,KAAK,IAAI,KAAK,GAAkB,KAAK,EACnC,KAAK,IAAI,KAAK,KAAK,MAAM,CAAC,SAAS,IAAI,KAAK,KAAK,KAAK,CAAC,SAAS,EAChE,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QACvC,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzC,IAAI,GAAG,KAAK,aAAa,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,QAAQ,CAAC;gBAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,KAAK,GAAI,KAAsC,CAAC,GAAG,CAAC,CAAC;QAC3D,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE;YACjC,KAAK,EAAE,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;gBACrD,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK;YAChF,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC;IACL,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAG,MAA+B,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IACjF,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAM,CAAC;AACpC,CAAC"}

package/dist/host-text.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Text that came from a host (a bundle's name, a person's name, a label) made safe to show a person
+ * or an agent: control and format characters removed (escape sequences, bidi overrides such as
+ * U+202E, zero-width characters), surrounding space trimmed, and at most `max` UTF-16 units kept,
+ * cut only between whole characters (never half a surrogate pair). The one rule every surface that
+ * shows host text uses.
+ */
+export declare function stripHostText(value: string, max: number): string;
+/**
+ * Host data (a result's keys and strings) with control and format characters and the line and
+ * paragraph separators (U+2028, U+2029) removed, except tab, newline and carriage return, with no
+ * length cap: the rule of {@link stripHostText} for text that is shown whole.
+ */
+export declare function stripHostControls(value: string): string;
+/**
+ * A copy of parsed JSON data with every key and string through {@link stripHostControls}, and
+ * whether anything was removed (a key that collides with an earlier one once stripped is dropped,
+ * and counts as removed). Iterative, so a deeply nested answer cannot exhaust the stack.
+ */
+export declare function stripHostData(input: unknown): {
+    value: unknown;
+    removed: boolean;
+};
+/**
+ * JSON text with every C1 control, U+2028, U+2029 and format character (bidi controls, zero-width
+ * characters, tag characters) escaped as `\uXXXX`, one escape per UTF-16 unit. `JSON.stringify`
+ * already escapes the C0 controls; these can occur only inside strings, so the text stays valid
+ * JSON and parses back to the same data.
+ */
+export declare function escapeHostJson(json: string): string;
+//# sourceMappingURL=host-text.d.ts.map

package/dist/host-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-text.d.ts","sourceRoot":"","sources":["../src/host-text.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAOhE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAiClF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAInD"}

package/dist/host-text.js

@@ -0,0 +1,77 @@
+/**
+ * Text that came from a host (a bundle's name, a person's name, a label) made safe to show a person
+ * or an agent: control and format characters removed (escape sequences, bidi overrides such as
+ * U+202E, zero-width characters), surrounding space trimmed, and at most `max` UTF-16 units kept,
+ * cut only between whole characters (never half a surrogate pair). The one rule every surface that
+ * shows host text uses.
+ */
+export function stripHostText(value, max) {
+    let out = "";
+    for (const char of value.replace(/[\p{Cc}\p{Cf}]/gu, "").trim()) {
+        if (out.length + char.length > max)
+            break;
+        out += char;
+    }
+    return out.trim();
+}
+/**
+ * Host data (a result's keys and strings) with control and format characters and the line and
+ * paragraph separators (U+2028, U+2029) removed, except tab, newline and carriage return, with no
+ * length cap: the rule of {@link stripHostText} for text that is shown whole.
+ */
+export function stripHostControls(value) {
+    return value.replace(/[\p{Cc}\p{Cf}\u2028\u2029]/gu, (char) => (char === "\t" || char === "\n" || char === "\r" ? char : ""));
+}
+/**
+ * A copy of parsed JSON data with every key and string through {@link stripHostControls}, and
+ * whether anything was removed (a key that collides with an earlier one once stripped is dropped,
+ * and counts as removed). Iterative, so a deeply nested answer cannot exhaust the stack.
+ */
+export function stripHostData(input) {
+    let removed = false;
+    const clean = (text) => {
+        const stripped = stripHostControls(text);
+        if (stripped !== text)
+            removed = true;
+        return stripped;
+    };
+    const stack = [];
+    const place = (item) => {
+        if (typeof item === "string")
+            return clean(item);
+        if (typeof item !== "object" || item === null)
+            return item;
+        const copy = Array.isArray(item) ? [] : {};
+        stack.push([item, copy]);
+        return copy;
+    };
+    const value = place(input);
+    while (stack.length > 0) {
+        const [source, copy] = stack.pop();
+        if (Array.isArray(source)) {
+            for (const item of source)
+                copy.push(place(item));
+            continue;
+        }
+        for (const [rawKey, item] of Object.entries(source)) {
+            const key = clean(rawKey);
+            if (Object.prototype.hasOwnProperty.call(copy, key)) {
+                removed = true;
+                continue;
+            }
+            // defineProperty: a `__proto__` key stays an own key, as JSON.parse made it.
+            Object.defineProperty(copy, key, { value: place(item), enumerable: true, writable: true, configurable: true });
+        }
+    }
+    return { value, removed };
+}
+/**
+ * JSON text with every C1 control, U+2028, U+2029 and format character (bidi controls, zero-width
+ * characters, tag characters) escaped as `\uXXXX`, one escape per UTF-16 unit. `JSON.stringify`
+ * already escapes the C0 controls; these can occur only inside strings, so the text stays valid
+ * JSON and parses back to the same data.
+ */
+export function escapeHostJson(json) {
+    return json.replace(/[\u007f-\u009f\u2028\u2029]|\p{Cf}/gu, (char) => Array.from({ length: char.length }, (_, index) => `\\u${char.charCodeAt(index).toString(16).padStart(4, "0")}`).join(""));
+}
+//# sourceMappingURL=host-text.js.map

package/dist/host-text.js.map

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

package/dist/hosted-client/binding.d.ts

@@ -0,0 +1,7 @@
+/**
+ * `sha256:<hex>` of a checkout's random id: the recovery binding (`X-Superbee-Checkout`) an
+ * identified write and its outcome lookup are pinned to, never the id itself. The CLI derives a
+ * checkout's binding with it, and a hosted client mints its own from a fresh id.
+ */
+export declare function checkoutBindingDigest(checkoutId: string): string;
+//# sourceMappingURL=binding.d.ts.map

package/dist/hosted-client/binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../../src/hosted-client/binding.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEhE"}

package/dist/hosted-client/binding.js

@@ -0,0 +1,10 @@
+import { sha256HexOfUtf8 } from "../sha256.js";
+/**
+ * `sha256:<hex>` of a checkout's random id: the recovery binding (`X-Superbee-Checkout`) an
+ * identified write and its outcome lookup are pinned to, never the id itself. The CLI derives a
+ * checkout's binding with it, and a hosted client mints its own from a fresh id.
+ */
+export function checkoutBindingDigest(checkoutId) {
+    return `sha256:${sha256HexOfUtf8(checkoutId)}`;
+}
+//# sourceMappingURL=binding.js.map

package/dist/hosted-client/binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding.js","sourceRoot":"","sources":["../../src/hosted-client/binding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAAkB;IACtD,OAAO,UAAU,eAAe,CAAC,UAAU,CAAC,EAAE,CAAC;AACjD,CAAC"}

package/dist/hosted-client/blob-delivery.d.ts

@@ -0,0 +1,67 @@
+/** Typed delivery of an existing frozen blob journal intent. Persistence, fresh claims and
+ * checkout locking belong to the caller; this composition owns no retry or authorization policy. */
+import { type BlobDeletionHold, type BlobIntentRecord, type BlobIntentPatch, type BlobReceipt, type BlobTargetScope } from "../blob-journal.js";
+import { type RecordedWriteOptions, type OperationState } from "../uncertain-write.js";
+import type { HostedBlobWriteAdapter } from "../hosted-transport/blob-write.js";
+export interface HostedBlobDeliveryContext {
+    /** Separately trusted current checkout target, never selected from a journal record. */
+    scope: BlobTargetScope;
+    /** Trusted caller contract: close over that fixed target, scoped carrier and fresh capability
+     * provider; create an adapter bound to the supplied lifetime. The record supplies no authority. */
+    adapterFor(signal: AbortSignal): HostedBlobWriteAdapter;
+}
+export type HostedBlobDeliveryOptions = Omit<RecordedWriteOptions, "settlement"> & {
+    /** Admission only, for this delete submission. Never persisted or sent on lookup. */
+    acceptDeletes?: number;
+};
+export type HostedBlobDeliveryOutcome = {
+    kind: "committed";
+    receipt: Extract<BlobReceipt, {
+        result: {
+            ok: true;
+        };
+    }>;
+} | {
+    kind: "conflict";
+    receipt: Extract<BlobReceipt, {
+        result: {
+            ok: false;
+        };
+    }>;
+} | {
+    kind: "refused";
+    code: string;
+    message: string;
+    receipt: Extract<BlobReceipt, {
+        result: {
+            ok: false;
+        };
+    }>;
+} | {
+    kind: "not-executed";
+    attempts: number;
+    details: BlobDeletionHold;
+} | {
+    kind: "unknown";
+};
+export interface HostedBlobDeliveryResult {
+    attempts: number;
+    state: OperationState;
+    lookups: number;
+    outcome: HostedBlobDeliveryOutcome;
+    /** Pass only this patch to the existing full-guard updateBlobIntent transaction. */
+    patch: BlobIntentPatch;
+}
+/**
+ * Refusals the host answers before dispatch and records under no identity (`recorded: "no"`): a
+ * grant without blob writes, a bundle the person cannot reach, and the sync quota. One of them on
+ * an attempt whose earlier attempts are all proven not applied settles the write as refused.
+ */
+export declare const BLOB_UNRECORDED_REFUSAL_CODES: readonly ["insufficient_scope", "bundle_not_found", "request_capacity"];
+/** A submit-claimed call requires a freshly durable in_flight CAS under the checkout lock.
+ * Reopened/unclear claims MUST use lookup; absence never proves an older delivery cannot commit.
+ * This function persists nothing. The caller subsequently applies patch under its full guard.
+ * deadlineMs bounds each lookup as well as the primitive's submission deadline; without it,
+ * the supplied wire carrier retains its own deadline. Caller cancellation ends either path. */
+export declare function performHostedBlobDelivery(context: HostedBlobDeliveryContext, record: BlobIntentRecord, options: HostedBlobDeliveryOptions): Promise<HostedBlobDeliveryResult>;
+//# sourceMappingURL=blob-delivery.d.ts.map

package/dist/hosted-client/blob-delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob-delivery.d.ts","sourceRoot":"","sources":["../../src/hosted-client/blob-delivery.ts"],"names":[],"mappings":"AAAA;oGACoG;AACpG,OAAO,EAAwC,KAAK,gBAAgB,EAAqD,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEzO,OAAO,EAAyB,KAAK,oBAAoB,EAAc,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG1H,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAEhF,MAAM,WAAW,yBAAyB;IACxC,wFAAwF;IACxF,KAAK,EAAE,eAAe,CAAC;IACvB;uGACmG;IACnG,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,sBAAsB,CAAC;CACzD;AACD,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAAC,oBAAoB,EAAE,YAAY,CAAC,GAAG;IACjF,qFAAqF;IACrF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AACF,MAAM,MAAM,yBAAyB,GACjC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC,WAAW,EAAE;QAAE,MAAM,EAAE;YAAE,EAAE,EAAE,IAAI,CAAA;SAAE,CAAA;KAAE,CAAC,CAAA;CAAE,GAC9E;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC,WAAW,EAAE;QAAE,MAAM,EAAE;YAAE,EAAE,EAAE,KAAK,CAAA;SAAE,CAAA;KAAE,CAAC,CAAA;CAAE,GAC9E;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC,WAAW,EAAE;QAAE,MAAM,EAAE;YAAE,EAAE,EAAE,KAAK,CAAA;SAAE,CAAA;KAAE,CAAC,CAAA;CAAE,GAC5G;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,gBAAgB,CAAA;CAAE,GACrE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AACxB,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,cAAc,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,yBAAyB,CAAC;IACnC,oFAAoF;IACpF,KAAK,EAAE,eAAe,CAAC;CACxB;AAED;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,yEAAyF,CAAC;AAapI;;;;+FAI+F;AAC/F,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,yBAAyB,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAqGnL"}