@amalgm/shell 0.1.164-preview.36072132286 → 0.1.164-preview.36809057014

package/dist/wire-outbox.js

@@ -0,0 +1,127 @@
+/**
+ * One socket's outgoing messages, whole and in order. A message leaves as
+ * WebSocket fragments of at most WIRE_FRAGMENT_BYTES with a turn boundary
+ * (turns.ts) between them, so no send's framing, masking or encryption holds
+ * the main thread, and no other message lands between one message's
+ * fragments. The receiver joins the fragments back into the one message.
+ *
+ * One multiplexed socket carries every frame, so an unbounded queue would
+ * delay pongs and replies behind bulk cargo, and a slow uplink would be cut
+ * by the gateway's own heartbeat. Each fragment therefore waits until the
+ * socket holds at most MAX_QUEUED_WIRE_BYTES, so the socket never holds more
+ * than that allowance and one fragment, and a prompt frame (a pong, hello or
+ * reply) leaves before every waiting request, though never inside a message
+ * already begun.
+ */
+import { turnBoundary } from "./turns.js";
+/** One fragment's framing and masking stays far inside a turn's budget. */
+export const WIRE_FRAGMENT_BYTES = 64 * 1024;
+const MAX_QUEUED_WIRE_BYTES = 4 * 1024 * 1024;
+const QUEUE_POLL_MS = 20;
+const OPEN = 1;
+/** A prompt frame's failure is its socket's own close. */
+const unobserved = () => { };
+/** A message's fragments, each part cut to the bound without joining parts. */
+function* fragments(parts) {
+    let any = false;
+    for (const part of parts) {
+        // A string's UTF-8 form is at most three bytes per UTF-16 unit.
+        if (typeof part === "string" && part.length * 3 <= WIRE_FRAGMENT_BYTES) {
+            if (part.length) {
+                any = true;
+                yield part;
+            }
+            continue;
+        }
+        const bytes = typeof part === "string" ? Buffer.from(part, "utf8") : part;
+        for (let offset = 0; offset < bytes.byteLength; offset += WIRE_FRAGMENT_BYTES) {
+            any = true;
+            yield bytes.subarray(offset, offset + WIRE_FRAGMENT_BYTES);
+        }
+    }
+    if (!any)
+        yield Buffer.alloc(0);
+}
+export class WireOutbox {
+    #socket;
+    #prompt = [];
+    #requests = [];
+    #closed = null;
+    #sending = false;
+    constructor(socket) {
+        this.#socket = socket;
+    }
+    /** Queue one request behind every earlier one. A signal aborted before the
+     * message's first fragment drops it; once begun, a message always ends, or
+     * the stream would carry half of it. */
+    send(parts, binary, sent, signal) {
+        this.#queue(this.#requests, { parts, binary, sent, signal });
+    }
+    /** Queue one small text frame the gateway is waiting on ahead of every
+     * waiting request, behind only earlier prompt frames. */
+    prompt(frame) {
+        this.#queue(this.#prompt, { parts: [frame], binary: false, sent: unobserved, signal: undefined });
+    }
+    /** The socket is gone: every waiting message fails with its reason. */
+    close(error) {
+        this.#closed ??= error;
+        for (const message of [...this.#prompt.splice(0), ...this.#requests.splice(0)])
+            message.sent(error);
+    }
+    #queue(lane, message) {
+        if (this.#closed) {
+            message.sent(this.#closed);
+            return;
+        }
+        lane.push(message);
+        if (!this.#sending)
+            void this.#drain();
+    }
+    async #drain() {
+        this.#sending = true;
+        try {
+            for (;;) {
+                const message = this.#closed ? undefined : this.#prompt.shift() ?? this.#requests.shift();
+                if (!message)
+                    return;
+                try {
+                    await this.#transmit(message);
+                }
+                catch (error) {
+                    message.sent(error instanceof Error ? error : new Error(String(error)));
+                }
+            }
+        }
+        finally {
+            this.#sending = false;
+        }
+    }
+    async #transmit({ parts, binary, sent, signal }) {
+        const cut = fragments(parts);
+        let fragment = cut.next();
+        await this.#room(signal);
+        for (;;) {
+            // The next fragment is known before this one leaves, so the last carries fin.
+            const next = cut.next();
+            this.#socket.send(fragment.value, { binary, fin: next.done === true }, next.done ? sent : undefined);
+            if (next.done)
+                return;
+            fragment = next;
+            await turnBoundary();
+            await this.#room(undefined);
+        }
+    }
+    async #room(signal) {
+        for (;;) {
+            signal?.throwIfAborted();
+            if (this.#closed)
+                throw this.#closed;
+            if (this.#socket.readyState !== OPEN)
+                throw new Error("wire is not open");
+            if (this.#socket.bufferedAmount <= MAX_QUEUED_WIRE_BYTES)
+                return;
+            await new Promise((resolve) => setTimeout(resolve, QUEUE_POLL_MS));
+        }
+    }
+}
+//# sourceMappingURL=wire-outbox.js.map

package/dist/wire-outbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire-outbox.js","sourceRoot":"","sources":["../src/wire-outbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,2EAA2E;AAC3E,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,GAAG,IAAI,CAAC;AAC7C,MAAM,qBAAqB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAC9C,MAAM,aAAa,GAAG,EAAE,CAAC;AACzB,MAAM,IAAI,GAAG,CAAC,CAAC;AAMf,0DAA0D;AAC1D,MAAM,UAAU,GAAa,GAAG,EAAE,GAAE,CAAC,CAAC;AAStC,+EAA+E;AAC/E,QAAQ,CAAC,CAAC,SAAS,CAAC,KAAuC;IACzD,IAAI,GAAG,GAAG,KAAK,CAAC;IAChB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,gEAAgE;QAChE,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,mBAAmB,EAAE,CAAC;YACvE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAAC,GAAG,GAAG,IAAI,CAAC;gBAAC,MAAM,IAAI,CAAC;YAAC,CAAC;YAC5C,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC1E,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,UAAU,EAAE,MAAM,IAAI,mBAAmB,EAAE,CAAC;YAC9E,GAAG,GAAG,IAAI,CAAC;YACX,MAAM,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IACD,IAAI,CAAC,GAAG;QAAE,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,OAAO,UAAU;IACZ,OAAO,CAAY;IACnB,OAAO,GAAc,EAAE,CAAC;IACxB,SAAS,GAAc,EAAE,CAAC;IACnC,OAAO,GAAiB,IAAI,CAAC;IAC7B,QAAQ,GAAG,KAAK,CAAC;IAEjB,YAAY,MAAiB;QAC3B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAED;;4CAEwC;IACxC,IAAI,CAAC,KAAuC,EAAE,MAAe,EAAE,IAAc,EAAE,MAAoB;QACjG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED;6DACyD;IACzD,MAAM,CAAC,KAAa;QAClB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IACpG,CAAC;IAED,uEAAuE;IACvE,KAAK,CAAC,KAAY;QAChB,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC;QACvB,KAAK,MAAM,OAAO,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtG,CAAC;IAED,MAAM,CAAC,IAAe,EAAE,OAAgB;QACtC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC3B,OAAO;QACT,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnB,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,MAAM;QACV,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC;YACH,SAAS,CAAC;gBACR,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;gBAC1F,IAAI,CAAC,OAAO;oBAAE,OAAO;gBACrB,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;gBAChC,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,IAAI,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBAC1E,CAAC;YACH,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACxB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAW;QACtD,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,QAAQ,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QAC1B,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACzB,SAAS,CAAC;YACR,8EAA8E;YAC9E,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;YACxB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAM,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YACtG,IAAI,IAAI,CAAC,IAAI;gBAAE,OAAO;YACtB,QAAQ,GAAG,IAAI,CAAC;YAChB,MAAM,YAAY,EAAE,CAAC;YACrB,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAA+B;QACzC,SAAS,CAAC;YACR,MAAM,EAAE,cAAc,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,CAAC,OAAO,CAAC;YACrC,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,KAAK,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;YAC1E,IAAI,IAAI,CAAC,OAAO,CAAC,cAAc,IAAI,qBAAqB;gBAAE,OAAO;YACjE,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;CACF"}

package/dist/workspace-host.d.ts

@@ -1,6 +1,7 @@
 import { WorkspaceRegistry } from "@amalgm/live/workspace";
 import type { WorkspacePathPort } from "@amalgm/live/workspace";
 import type { StateRail } from "@amalgm/core/state";
+import type { WorkspaceScope } from "./agent-execution.js";
 import type { BrickMount } from "./gateway.js";
 /** Every runtime uses the same durable Live registry and Core UI projection. */
 export declare function createWorkspaceHost(options: {
@@ -11,6 +12,9 @@ export declare function createWorkspaceHost(options: {
 }): {
     registry: WorkspaceRegistry;
     mount: BrickMount;
+    scope: WorkspaceScope;
 };
+/** Each linked folder outside the root, with a group's folders listed one by one. */
+export declare function registeredFolders(registry: WorkspaceRegistry, workspaceRoot: string): string[];
 export declare const workspacePathHost: WorkspacePathPort;
 export declare function workspaceMount(registry: WorkspaceRegistry, workspaceRoot: string): BrickMount;

package/dist/workspace-host.js

@@ -21,7 +21,18 @@ export function createWorkspaceHost(options) {
     for (const resource of ["projects", "workspaces"]) {
         options.state.registerResource(resource, { snapshotDefault: true, read: () => registry.list() });
     }
-    return { registry, mount: workspaceMount(registry, options.workspaceRoot) };
+    return {
+        registry,
+        mount: workspaceMount(registry, options.workspaceRoot),
+        scope: { root: options.workspaceRoot, folders: () => registeredFolders(registry, options.workspaceRoot) },
+    };
+}
+/** Each linked folder outside the root, with a group's folders listed one by one. */
+export function registeredFolders(registry, workspaceRoot) {
+    const paths = registry.list().flatMap(entry => entry.kind === "group"
+        ? entry.folders.map(folder => folder.path)
+        : [entry.path]);
+    return [...new Set(paths)].filter(path => !workspacePathHost.isWithin(workspaceRoot, path));
 }
 export const workspacePathHost = {
     isAbsolute,

package/dist/workspace-host.js.map

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

package/examinations/fixtures/private-wire-authority.js

@@ -187,8 +187,44 @@ export function createPrivateWireAuthority({
   let contentFailureRetryable = contentPutFailureRetryable;
   let rejectMutationSubmits = false;
   let rejectEntityRecordSubmits = false;
+  let retryEntityRecordSubmits = false;
+  // Injected latency, off unless a test arms it: after durable acceptance and
+  // its doorbells, only the selected entity.record.ack waits; every other
+  // request and notification is still served. Times are epoch milliseconds.
+  let ackHoldPolicy = null;
+  const ackHolds = [];
+  const pendingAckReleases = new Set();
+  const epochNow = () => performance.timeOrigin + performance.now();
+  function holdAck(socket, ack, policy, evidence) {
+    const row = { ...evidence, policy, heldAt: epochNow(), releasedAt: null, releasedBy: null, heldMs: null, delivered: null };
+    ackHolds.push(row);
+    const release = (by) => {
+      if (row.releasedAt !== null) return;
+      clearTimeout(timer);
+      pendingAckReleases.delete(release);
+      row.releasedAt = epochNow();
+      row.releasedBy = by;
+      row.heldMs = row.releasedAt - row.heldAt;
+      row.delivered = socket.readyState === WebSocket.OPEN;
+      if (row.delivered) socket.send(ack);
+    };
+    const timer = setTimeout(() => release(policy.deadlineMs === undefined ? "delay" : "deadline"),
+      policy.deadlineMs ?? policy.delayMs);
+    timer.unref();
+    pendingAckReleases.add(release);
+  }
   let remainingMutationSubmitFailures = 0;
   let dropMutationAcks = 0;
+  // Examination holds on graph-head commits, off unless armed. A held submit
+  // parks before the authority reads it and replays, in arrival order, when
+  // released. A withheld acknowledgement is committed and never sent.
+  let holdGraphSubmits = false;
+  const heldGraphSubmits = [];
+  let withholdGraphAcks = false;
+  const withheldGraphAcks = [];
+  // Every answer to a mutation submit, in order: committed, duplicate, or
+  // the refusal code.
+  const graphAnswers = [];
   const committedMutationAcks = new Map();
   let deliverySequence = 0;
   const entityRecords = [];
@@ -304,13 +340,20 @@ export function createPrivateWireAuthority({
       entitySubscriptions.delete(socket);
       grantWatchers.delete(socket);
     });
-    socket.on("message", (data, isBinary) => {
+    const receive = (data, isBinary) => {
       const frame = isBinary
         ? (() => {
           const decoded = decodeBinaryFrame(data);
           return { ...decoded.frame, data_bin: decoded.bytes };
         })()
         : JSON.parse(data.toString("utf8"));
+      if (holdGraphSubmits && frame.type === "shared.mutation.submit"
+        && frame.envelope?.operationKind === GRAPH_HEAD_OPERATION_KIND) {
+        const { mutationId, deviceId, baseVersion, deliveryWatermark } = frame.envelope;
+        heldGraphSubmits.push({ mutationId, deviceId, baseVersion, deliveryWatermark, heldAt: epochNow(),
+          replay: () => receive(data, isBinary) });
+        return;
+      }
       if (frame.type === "private.entity-content.put"
         || frame.type === "private.entity-content.put-blocks"
         || frame.type === "private.entity-content.put-cargo") {
@@ -650,7 +693,10 @@ export function createPrivateWireAuthority({
           expires_in_seconds: 300,
         }));
       } else if (frame.type === "shared.mutation.submit") {
+        const answer = (value) => graphAnswers.push({ mutationId: frame.envelope?.mutationId,
+          deviceId: frame.envelope?.deviceId, answer: value, version: current?.version ?? null, at: epochNow() });
         if (rejectMutationSubmits) {
+          answer("shared_realtime_internal_error");
           socket.send(JSON.stringify({
             type: "shared.error",
             request_id: frame.request_id,
@@ -663,6 +709,7 @@ export function createPrivateWireAuthority({
         }
         if (remainingMutationSubmitFailures > 0) {
           remainingMutationSubmitFailures -= 1;
+          answer("shared_database_serialization_failure");
           socket.send(JSON.stringify({
             type: "shared.error",
             request_id: frame.request_id,
@@ -685,6 +732,7 @@ export function createPrivateWireAuthority({
         // instead of committing twice.
         const committed = committedMutationAcks.get(envelope.mutationId);
         if (committed) {
+          answer("duplicate");
           socket.send(JSON.stringify({
             ...committed,
             request_id: frame.request_id,
@@ -692,10 +740,25 @@ export function createPrivateWireAuthority({
           }));
           return;
         }
-        assert.equal(envelope.baseVersion, current.version);
         assert.equal(envelope.authorityEpoch, current.authorityEpoch);
-        assert.equal(envelope.deliveryWatermark, deliverySequence,
-          "a graph publication names the complete current delivery prefix");
+        // The production commit refuses a publication whose delivery prefix
+        // or graph head moved on, in that order; the gateway maps either
+        // refusal to its leading token, 400 and not retryable. The head
+        // comparison is the proposed strict CAS.
+        const moved = envelope.deliveryWatermark !== deliverySequence ? "entity_delivery_watermark_changed"
+          : envelope.baseVersion !== current.version ? "entity_graph_head_changed" : null;
+        if (moved) {
+          answer(moved);
+          socket.send(JSON.stringify({
+            type: "shared.error",
+            request_id: frame.request_id,
+            code: moved,
+            message: moved,
+            status: 400,
+            retryable: false,
+          }));
+          return;
+        }
         graphMutations.push(envelope);
         const base = Buffer.from(current.snapshotB64, "base64");
         const baseIsHead = base.toString("utf8", 0, 128).includes(`"kind":"${GRAPH_HEAD_KIND}"`);
@@ -759,6 +822,11 @@ export function createPrivateWireAuthority({
           duplicate: false,
         };
         committedMutationAcks.set(envelope.mutationId, ack);
+        answer("committed");
+        if (withholdGraphAcks && envelope.operationKind === GRAPH_HEAD_OPERATION_KIND) {
+          withheldGraphAcks.push(envelope.mutationId);
+          return;
+        }
         if (dropMutationAcks > 0) {
           // The commit landed; the acknowledgement is lost with the socket.
           dropMutationAcks -= 1;
@@ -767,10 +835,12 @@ export function createPrivateWireAuthority({
         }
         socket.send(JSON.stringify(ack));
       } else if (frame.type === "entity.record.submit") {
+        const receivedAt = epochNow();
         if (rejectEntityRecordSubmits) {
           socket.send(JSON.stringify({ type: 'shared.error', request_id: frame.request_id,
-            code: 'entity_record_authority_not_found', message: 'no entity authority exists at that id',
-            status: 404, retryable: false }));
+            code: retryEntityRecordSubmits ? 'examination_acceptance_held' : 'entity_record_authority_not_found',
+            message: retryEntityRecordSubmits ? 'local examination holds acceptance before append' : 'no entity authority exists at that id',
+            status: retryEntityRecordSubmits ? 503 : 404, retryable: retryEntityRecordSubmits }));
           return;
         }
         const submitted = decodeLocalEntityRecord(frame.record_json);
@@ -855,12 +925,26 @@ export function createPrivateWireAuthority({
             }));
           }
         }
-        socket.send(JSON.stringify({
+        const ack = JSON.stringify({
           type: "entity.record.ack",
           request_id: frame.request_id,
           record_json: encodeEntityRecord(decision.record),
           duplicate: decision.kind === "duplicate",
-        }));
+        });
+        const hold = decision.kind === "append" ? ackHoldPolicy : null;
+        if (hold === null) {
+          socket.send(ack);
+          return;
+        }
+        // A test-released hold selects exactly the next accepted record.
+        if (hold.deadlineMs !== undefined) ackHoldPolicy = null;
+        holdAck(socket, ack, hold, {
+          entityId: decision.record.entityId,
+          mutationId: decision.record.mutationId,
+          globalSequence: decision.record.globalSequence,
+          receivedAt,
+          acceptedAt: epochNow(),
+        });
       } else if (frame.type === "entity.record.subscribe") {
         entitySubscribeRequests += 1;
         entitySubscriptions.get(socket).set(frame.authority_id, null);
@@ -931,7 +1015,8 @@ export function createPrivateWireAuthority({
           request_id: frame.request_id,
         }));
       }
-    });
+    };
+    socket.on("message", receive);
   });
   return {
     server,
@@ -988,7 +1073,26 @@ export function createPrivateWireAuthority({
     rejectMutationSubmits(reject) {
       rejectMutationSubmits = reject;
     },
-    rejectEntityRecordSubmits(reject) { rejectEntityRecordSubmits = reject; },
+    rejectEntityRecordSubmits(reject, retryable = false) {
+      rejectEntityRecordSubmits = reject;
+      retryEntityRecordSubmits = retryable;
+    },
+    /** Injected latency for accepted records' acknowledgements: `{ delayMs }`
+     * holds every one for that interval; `{ deadlineMs }` holds only the
+     * next one until releaseEntityRecordAcks() or the deadline; null stops. */
+    holdEntityRecordAcks(policy) {
+      const positive = (value) => Number.isFinite(value) && value > 0;
+      assert.ok(policy === null || (positive(policy.delayMs) !== positive(policy.deadlineMs)
+        && Object.keys(policy).length === 1), "hold policy is null, { delayMs } or { deadlineMs }");
+      ackHoldPolicy = policy;
+    },
+    /** Release every held acknowledgement now; returns how many. */
+    releaseEntityRecordAcks() {
+      const releases = [...pendingAckReleases];
+      for (const release of releases) release("controller");
+      return releases.length;
+    },
+    get entityRecordAckHolds() { return ackHolds.map((row) => ({ ...row })); },
     interceptContentSealQueries(handler) {
       onContentSealQuery = handler;
     },
@@ -1124,6 +1228,25 @@ export function createPrivateWireAuthority({
     },
     get entitySubscribeRequests() { return entitySubscribeRequests; },
     get graphMutations() { return [...graphMutations]; },
+    /** Every mutation submit's answer, in order. */
+    get graphCommitAnswers() { return graphAnswers.map((row) => ({ ...row })); },
+    /** Park every graph-head submit until released. */
+    holdGraphCommits() {
+      holdGraphSubmits = true;
+    },
+    /** Stop holding and replay each parked submit in arrival order. */
+    releaseGraphCommits() {
+      holdGraphSubmits = false;
+      const held = heldGraphSubmits.splice(0);
+      for (const submit of held) submit.replay();
+      return held.map(({ replay, ...submit }) => submit);
+    },
+    get heldGraphCommits() { return heldGraphSubmits.map(({ replay, ...submit }) => submit); },
+    /** Commit graph heads but never send their acknowledgements while on. */
+    withholdGraphAcks(withhold) {
+      withholdGraphAcks = withhold;
+    },
+    get withheldGraphAcks() { return [...withheldGraphAcks]; },
     /** Every record of the committed registry graph. A head commit names its
      * roots as immutable pages, so this is what the authority actually holds
      * after assembling them — the honest replacement for reading records out

package/npm-shrinkwrap.json

@@ -1,22 +1,22 @@
 {
   "name": "@amalgm/shell",
-  "version": "0.1.164-preview.36072132286",
+  "version": "0.1.164-preview.36809057014",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@amalgm/shell",
-      "version": "0.1.164-preview.36072132286",
+      "version": "0.1.164-preview.36809057014",
       "license": "UNLICENSED",
       "dependencies": {
         "@amalgm/agents": "0.2.3-preview.35795493380",
         "@amalgm/apps": "0.1.3-preview.35541603008",
         "@amalgm/automations": "0.4.4-preview.35542563246",
         "@amalgm/browser": "0.1.2-preview.35541635545",
-        "@amalgm/channels": "0.1.5-preview.36059389034",
-        "@amalgm/chat": "0.2.9-preview.36070682526",
+        "@amalgm/channels": "0.1.5-preview.36777776173",
+        "@amalgm/chat": "0.2.9-preview.36777100786",
         "@amalgm/core": "0.5.1-preview.35541371724",
-        "@amalgm/live": "0.2.81-preview.35320889761",
+        "@amalgm/live": "0.2.81-preview.36771680084",
         "@amalgm/tools": "0.1.7-preview.35541586993",
         "@anthropic-ai/claude-agent-sdk": "^0.3.224",
         "@homebridge/node-pty-prebuilt-multiarch": "0.13.1",
@@ -40,15 +40,12 @@
       "engines": {
         "node": ">=24",
         "npm": ">=11.19.1 <12"
-      },
-      "optionalDependencies": {
-        "fsevents": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz"
       }
     },
     "node_modules/@agentclientprotocol/sdk": {
-      "version": "1.5.0",
-      "resolved": "https://registry.npmjs.org/@agentclientprotocol/sdk/-/sdk-1.5.0.tgz",
-      "integrity": "sha512-524jwbB2iYWA+kWWyv9fhKbhU89dH/lu9u5EXwVNmfYzopV8BujCDxByBDZhxRUkB7RWIJzISCnwivdDk+bdVg==",
+      "version": "1.5.1",
+      "resolved": "https://registry.npmjs.org/@agentclientprotocol/sdk/-/sdk-1.5.1.tgz",
+      "integrity": "sha512-nSUIrC1fOR9+ppKfx9KdwjBBND2sAPzFHo4yVQrGbXZHnayUYpwL8CDVR5LSxbapY/oKMOzNP0wvwfyx3PS2KA==",
       "license": "Apache-2.0",
       "peerDependencies": {
         "zod": "^3.25.0 || ^4.0.0"
@@ -177,9 +174,9 @@
       }
     },
     "node_modules/@amalgm/channels": {
-      "version": "0.1.5-preview.36059389034",
-      "resolved": "https://registry.npmjs.org/@amalgm/channels/-/channels-0.1.5-preview.36059389034.tgz",
-      "integrity": "sha512-fMAON0XvLsOb1ZrRw2q/fLQuMW3E5wu4t2VpJ4Xp1X04ES/Jh3CD1f/EMwI3sHzL9Lv+Z7ujQAzG9SfqivmClA==",
+      "version": "0.1.5-preview.36777776173",
+      "resolved": "https://registry.npmjs.org/@amalgm/channels/-/channels-0.1.5-preview.36777776173.tgz",
+      "integrity": "sha512-lsJ3LBrw9x3G5N39tPwC1dUc+2UXBXrCsuDc/kFJs1vllc0TZ6DzBIzeB143lkdURPAsrIzzU0PxKcBTRQ3RdQ==",
       "license": "UNLICENSED",
       "dependencies": {
         "@amalgm/core": "0.5.1-preview.35541371724",
@@ -197,9 +194,9 @@
       }
     },
     "node_modules/@amalgm/chat": {
-      "version": "0.2.9-preview.36070682526",
-      "resolved": "https://registry.npmjs.org/@amalgm/chat/-/chat-0.2.9-preview.36070682526.tgz",
-      "integrity": "sha512-tnzeY06l1/VGX1nwp3EUpwtChx4dURrkCV1wkFCs4Y9o2n8fe7fZud7D08+0vjAqWp/pCkxvacLzc0QwM1iKNQ==",
+      "version": "0.2.9-preview.36777100786",
+      "resolved": "https://registry.npmjs.org/@amalgm/chat/-/chat-0.2.9-preview.36777100786.tgz",
+      "integrity": "sha512-1O1XLuMmMCj56QkSlg0Eyu6VT4Til7ma68CjmAzONemzX9ZnyrZgz4IC+3MewtWu9i09hPC74HJ0vt/t3mxmUQ==",
       "license": "UNLICENSED",
       "dependencies": {
         "@agentclientprotocol/sdk": "^1.4.0",
@@ -224,9 +221,9 @@
       }
     },
     "node_modules/@amalgm/live": {
-      "version": "0.2.81-preview.35320889761",
-      "resolved": "https://registry.npmjs.org/@amalgm/live/-/live-0.2.81-preview.35320889761.tgz",
-      "integrity": "sha512-sGLYdh1xx1FuzUTf7wtPcSzYJ/Db6bx8KNljZ1ZF1gdbDahDKze//whaYq7mlRKYQznYTJLFrJnw+l0M2RIMpg==",
+      "version": "0.2.81-preview.36771680084",
+      "resolved": "https://registry.npmjs.org/@amalgm/live/-/live-0.2.81-preview.36771680084.tgz",
+      "integrity": "sha512-ETfSFsY3Ae2+84IfXesP/IBmREHxl4RbFJ+8kpdQv3LkI9kLCbExpCXsSe/fboaNooNhUpXTZ/9C/ESAkLfQGw==",
       "license": "UNLICENSED",
       "engines": {
         "node": ">=18"
@@ -866,9 +863,9 @@
       }
     },
     "node_modules/@opencode-ai/sdk": {
-      "version": "1.18.32",
-      "resolved": "https://registry.npmjs.org/@opencode-ai/sdk/-/sdk-1.18.32.tgz",
-      "integrity": "sha512-Wi3WtH/cLA3C0ga05lyDb7zac+SzbST9MPwCve1Ffod0xwzHdy9G2gnxvMAR4RBRhKJS32Rgk2cR+fxBhAVSQw==",
+      "version": "1.18.34",
+      "resolved": "https://registry.npmjs.org/@opencode-ai/sdk/-/sdk-1.18.34.tgz",
+      "integrity": "sha512-R9QWUpcngtdQ6FCixz7NC6n1WsSho6CEuRUzYHz/CzZcp3miSklDzXkm0oDwXVCnuEu+ANoeM0f6RDp51kOMzQ==",
       "license": "MIT",
       "dependencies": {
         "cross-spawn": "7.0.6"
@@ -1043,9 +1040,9 @@
       "license": "MIT"
     },
     "node_modules/@types/ws": {
-      "version": "8.18.1",
-      "resolved": "https://registry.npmjs.org/@types/ws/-/ws-8.18.1.tgz",
-      "integrity": "sha512-ThVF6DCVhA8kUGy+aazFQ4kXQ7E1Ty7A3ypFOe0IcJV8O/M511G99AW24irKrW56Wt44yG9+ij8FaqoBGkuBXg==",
+      "version": "8.18.2",
+      "resolved": "https://registry.npmjs.org/@types/ws/-/ws-8.18.2.tgz",
+      "integrity": "sha512-67MQl+fpWKVTT1NYdnmo3U4sc/xPo/zQBncVnI74qmQa0z/b+1g6iYqNmGCPbxO+zz2aklb08a0oHfegiVd0/w==",
       "license": "MIT",
       "dependencies": {
         "@types/node": "*"
@@ -1210,9 +1207,10 @@
       }
     },
     "node_modules/brace-expansion": {
-      "version": "5.0.9",
-      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.9.tgz",
-      "integrity": "sha512-ScQ4IuvIEF1TMlP7Zt+vjJ//9zlPb2SDcxWxM3bk8s6t6GGdJ7KO1dCcTidOPJKePW30LE/2cT7wCyPho9/Wxg==",
+      "version": "5.0.12",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.12.tgz",
+      "integrity": "sha512-YovQ3rzhaLMIrDjNDMkNS01tea93qhEhG5xy8f6+R0l+dw3Ki+5sCoIoI942iuLZTHWogWktgwVDhU09iNEimQ==",
+      "license": "MIT",
       "dependencies": {
         "balanced-match": "^4.0.2"
       },
@@ -1623,9 +1621,9 @@
       "peer": true
     },
     "node_modules/fast-uri": {
-      "version": "3.1.7",
-      "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.7.tgz",
-      "integrity": "sha512-dOvZVzjdZdz7phd9v6jCbwxrBW3fK6n8Rc0CtdmM4bumzMnxywBYhuph6J819RRw/ku+rLbelwfMunktuzVVHg==",
+      "version": "3.1.8",
+      "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.8.tgz",
+      "integrity": "sha512-GZMtZUTNRpOVIECoXwLNZS5xUGE+mVNbTB8h/7Rwh2TFWcBQiPzTgyZi05BF9UMZKkLJv8XBRJTlU7zg8+ZfMg==",
       "funding": [
         {
           "type": "github",
@@ -1635,7 +1633,8 @@
           "type": "opencollective",
           "url": "https://opencollective.com/fastify"
         }
-      ]
+      ],
+      "license": "BSD-3-Clause"
     },
     "node_modules/ffmpeg-static": {
       "version": "5.3.0",
@@ -1699,19 +1698,6 @@
       "resolved": "https://registry.npmjs.org/fs-constants/-/fs-constants-1.0.0.tgz",
       "integrity": "sha512-y6OAwoSIf7FyjMIv94u+b5rdheZEjzR63GTyZJm5qh4Bi+2YgwLCcI/fPFZkL5PSixOt6ZNKm+w+Hfp/Bciwow=="
     },
-    "node_modules/fsevents": {
-      "version": "2.3.3",
-      "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
-      "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==",
-      "hasInstallScript": true,
-      "optional": true,
-      "os": [
-        "darwin"
-      ],
-      "engines": {
-        "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
-      }
-    },
     "node_modules/function-bind": {
       "version": "1.1.2",
       "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz",
@@ -1894,9 +1880,10 @@
       "integrity": "sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew=="
     },
     "node_modules/ip-address": {
-      "version": "10.4.0",
-      "resolved": "https://registry.npmjs.org/ip-address/-/ip-address-10.4.0.tgz",
-      "integrity": "sha512-oSK96Grm3aP6OrS263xVxbNDGVL7rzBtYdpGqlDG8iQdoenDoTs/nkki+DflYbAEE8Xl6o5YxhxlrKvI3nqKXQ==",
+      "version": "10.7.2",
+      "resolved": "https://registry.npmjs.org/ip-address/-/ip-address-10.7.2.tgz",
+      "integrity": "sha512-7H/2gFSIitxc0hG3nOI1glS8QLo/EHBFFLk8vEUjXY/xu0AdL8jZ9U1IzO2PUm0d2D/ofQcAifb0g6OBkt8U7w==",
+      "license": "MIT",
       "engines": {
         "node": ">= 12"
       }
@@ -4403,18 +4390,18 @@
       }
     },
     "node_modules/tldts-core": {
-      "version": "7.4.15",
-      "resolved": "https://registry.npmjs.org/tldts-core/-/tldts-core-7.4.15.tgz",
-      "integrity": "sha512-ERuv0p98XgSzmlSLJr8vDNxX+uATGInlN97V3R+JpYWaSqn5IG3ewWgCwczk4bkOpgth/o8Nt5FOi4B4w0n/1A==",
+      "version": "7.4.16",
+      "resolved": "https://registry.npmjs.org/tldts-core/-/tldts-core-7.4.16.tgz",
+      "integrity": "sha512-MDolfaSJtlSK5Y0A1xl3277ekubZwobpBjugknDizI9O5Rm60a1m8k4ICK+MRsCDzPygT81mp3BBf5RKDlFRfA==",
       "license": "MIT"
     },
     "node_modules/tldts-experimental": {
-      "version": "7.4.15",
-      "resolved": "https://registry.npmjs.org/tldts-experimental/-/tldts-experimental-7.4.15.tgz",
-      "integrity": "sha512-IHFsr0juxP1k2JemWCefrfnHaVX1NHgpRApdnGvgItJSEZvhcEv2yOt2DVJ3j7aPbEEoxjN7dci7+mtZmfGIJw==",
+      "version": "7.4.16",
+      "resolved": "https://registry.npmjs.org/tldts-experimental/-/tldts-experimental-7.4.16.tgz",
+      "integrity": "sha512-H1gI3Toi/7PoMRmBIX9K2cyWIEdxjW0F4ygsVRtsCM1thOZwa3zFc8SowUttgd0UhVUR2ahRbgUHEKrxj7WZ3w==",
       "license": "MIT",
       "dependencies": {
-        "tldts-core": "^7.4.15"
+        "tldts-core": "^7.4.16"
       }
     },
     "node_modules/toidentifier": {