@amalgm/live 0.2.26 → 0.2.28

package/dist-cjs/files/commands.js

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerFilesWorkspace = registerFilesWorkspace;
+exports.workspaceGraph = workspaceGraph;
+exports.addFilesWorkspace = addFilesWorkspace;
+const index_js_1 = require("../entities/index.js");
+function uuid(value, label) {
+    const normalized = typeof value === 'string' ? value.trim().toLowerCase() : '';
+    if (!index_js_1.UUID_PATTERN.test(normalized))
+        throw new Error(`${label} must be a UUID`);
+    return normalized;
+}
+function required(value, label) {
+    const normalized = typeof value === 'string' ? value.trim() : '';
+    if (!normalized)
+        throw new Error(`${label} is required`);
+    return normalized;
+}
+/**
+ * Declare one external workspace. Deliberately no scan, SQLite, content, or
+ * cloud port exists here: Watch observing the rendered reference owns all
+ * enrollment and publication.
+ */
+async function registerFilesWorkspace(path, ports) {
+    const requestedPath = required(path, 'workspace path');
+    const inspected = await ports.inspectExternalWorkspace(requestedPath);
+    const absolutePath = required(inspected.absolutePath, 'external workspace path');
+    const workspaceName = required(inspected.name, 'workspace name');
+    const workspaceId = inspected.workspaceId === null
+        ? uuid(ports.randomUuid(), 'generated workspace id')
+        : uuid(inspected.workspaceId, 'existing workspace id');
+    const declared = await ports.declareWorkspaceReference({
+        workspaceId,
+        workspaceName,
+        absolutePath,
+    });
+    return {
+        workspaceId,
+        workspaceName,
+        externalPath: absolutePath,
+        referenceName: required(declared.referenceName, 'reference name'),
+        referencePath: required(declared.referencePath, 'reference path'),
+        declared: true,
+        created: declared.created === true,
+    };
+}
+/** Select exactly one referenced materialization boundary. Its portable parent
+ * may live outside the selection; UUID, not parentlessness, is the boundary. */
+function workspaceGraph(records, workspaceId) {
+    const normalizedId = uuid(workspaceId, 'workspace id');
+    const snapshot = (0, index_js_1.snapshotFromRecords)(records);
+    const workspace = snapshot.records.find((record) => record.uuid === normalizedId);
+    if (!workspace || workspace.status !== 'active') {
+        throw new Error(`workspace ${normalizedId} does not exist in this user's cloud registry`);
+    }
+    if (!['workspace', 'folder', 'repo.git'].includes(workspace.type)) {
+        throw new Error(`entity ${normalizedId} is not a registered workspace boundary`);
+    }
+    const references = snapshot.records.filter((record) => record.status === 'active'
+        && record.type === 'reference' && record.payloadVersion === normalizedId);
+    if (references.length !== 1) {
+        throw new Error(`workspace ${normalizedId} must have exactly one durable reference`);
+    }
+    const included = new Set([normalizedId]);
+    let changed = true;
+    while (changed) {
+        changed = false;
+        for (const record of snapshot.records) {
+            if (record.parentUUID !== null && included.has(record.parentUUID) && !included.has(record.uuid)) {
+                included.add(record.uuid);
+                changed = true;
+            }
+        }
+    }
+    return {
+        workspace,
+        reference: references[0],
+        records: snapshot.records.filter((record) => included.has(record.uuid)),
+    };
+}
+/** Materialize one owned workspace root and establish Watch coverage for it. */
+async function addFilesWorkspace(workspaceId, destinationParent, ports) {
+    const normalizedId = uuid(workspaceId, 'workspace id');
+    const destination = required(destinationParent, 'destination directory');
+    const cloud = await ports.lookupRegistry();
+    const selected = workspaceGraph(cloud.snapshot.records, normalizedId);
+    const references = cloud.snapshot.records.filter((record) => record.status === 'active' && record.type === 'reference');
+    const installed = await ports.materializeWorkspace({
+        ...selected,
+        references,
+        destinationParent: destination,
+        cloudHead: required(cloud.checksum, 'cloud head'),
+    });
+    const installedRecords = (0, index_js_1.snapshotFromRecords)(installed.records || []).records;
+    if (!Number.isSafeInteger(installed.rows)
+        || installed.rows !== installedRecords.length
+        || !(0, index_js_1.sameRecords)((0, index_js_1.travelingRecords)(installedRecords), selected.records)
+        || !(0, index_js_1.sameRecords)([installed.reference], [selected.reference])
+        || !(0, index_js_1.sameRecords)(installed.references, references)) {
+        throw new Error('workspace materialization did not persist exactly the selected graph');
+    }
+    const coverage = await ports.coverWorkspace({
+        workspaceId: normalizedId,
+        baseline: installed.alreadyMaterialized === true ? 'existing' : 'authoritative-install',
+    });
+    if (coverage.active !== true || !Number.isSafeInteger(coverage.roots) || coverage.roots < 1) {
+        throw new Error('workspace watcher coverage is not active');
+    }
+    return {
+        workspaceId: normalizedId,
+        workspaceName: selected.workspace.name,
+        path: required(installed.path, 'materialized workspace path'),
+        rows: installed.rows,
+        cloudHead: cloud.checksum,
+        materialized: true,
+        alreadyMaterialized: installed.alreadyMaterialized === true,
+        watcherRoots: coverage.roots,
+    };
+}
+//# sourceMappingURL=commands.js.map

package/dist-cjs/files/commands.js.map

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

package/dist-cjs/files/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/** Files product operations. Hosts own effects; Live owns decisions. */
+__exportStar(require("./commands.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist-cjs/files/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/files/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wEAAwE;AACxE,gDAA8B"}

package/dist-cjs/index.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * @amalgm/live — the portable realtime SDK for the Amalgm platform.
+ *
+ * Portable layers, one rule each:
+ *
+ * - `contracts/`  every wire shape and identity rule, as types + validators
+ * - `machines/`   the protocol's behavior, as pure state machines
+ * - `records/`    the entity Record, local Outbox, authority, and Inbox laws
+ *
+ * Start at PURPOSE.md for the axioms; docs/ holds the normative specs.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./contracts/index.js"), exports);
+__exportStar(require("./machines/index.js"), exports);
+__exportStar(require("./entities/index.js"), exports);
+__exportStar(require("./watching/index.js"), exports);
+__exportStar(require("./detection/index.js"), exports);
+__exportStar(require("./records/index.js"), exports);
+__exportStar(require("./registration/index.js"), exports);
+__exportStar(require("./files/index.js"), exports);
+__exportStar(require("./transfer/index.js"), exports);
+__exportStar(require("./merge/index.js"), exports);
+__exportStar(require("./workspace/index.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist-cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;;;;;;;;;;;;;;AAEH,uDAAqC;AACrC,sDAAoC;AACpC,sDAAoC;AACpC,sDAAoC;AACpC,uDAAqC;AACrC,qDAAmC;AACnC,0DAAwC;AACxC,mDAAiC;AACjC,sDAAoC;AACpC,mDAAiC;AACjC,uDAAqC"}

package/dist-cjs/machines/arbitration.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * Tunnel slot arbitration — who owns `(computer_id, runtime_label)`.
+ *
+ * The gateway holds one slot per runtime identity; a newcomer's first
+ * identity-bearing hello decides the winner (local-live-protocol.md §5).
+ * This is the pure decision. The gateway supplies sockets and timers; the
+ * fencing rule — mark the loser superseded BEFORE closing it, drop its
+ * in-flight frames — is part of the contract and encoded in the verdict.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ARBITRATION_DEADLINE_MS = void 0;
+exports.decideSlot = decideSlot;
+const tunnel_js_1 = require("../contracts/frames/tunnel.js");
+/** A newcomer with a holder present buffers unrouted until its first identity-bearing hello, bounded by this deadline (AMALGM_TUNNEL_HELLO_ARBITRATION_MS). */
+exports.ARBITRATION_DEADLINE_MS = 3_000;
+/**
+ * Decide a contested slot.
+ *
+ * - same `instance_id`      → newer socket wins (the same process reconnecting)
+ * - different `instance_id` → strictly newer `boot_ts` wins; older or EQUAL loses
+ * - unusable identity on either side (or the deadline expired — pass
+ *   `holder: null` identity via `legacyFallback`) → last-connect-wins, logged as such by the caller
+ */
+function decideSlot(holder, newcomer) {
+    if (holder === null) {
+        return { install: true, fenceHolder: false, rule: 'free-slot' };
+    }
+    if (!(0, tunnel_js_1.hasUsableIdentity)(newcomer) || !(0, tunnel_js_1.hasUsableIdentity)(holder)) {
+        return { install: true, fenceHolder: true, rule: 'legacy-last-connect-wins' };
+    }
+    const contender = newcomer;
+    if (contender.instance_id === holder.instance_id) {
+        return { install: true, fenceHolder: true, rule: 'same-instance-reconnect' };
+    }
+    if (contender.boot_ts > holder.boot_ts) {
+        return { install: true, fenceHolder: true, rule: 'newer-boot' };
+    }
+    return { install: false, closeCode: tunnel_js_1.CLOSE_CODES.supersededInstance, rule: 'older-or-equal-boot' };
+}
+//# sourceMappingURL=arbitration.js.map

package/dist-cjs/machines/arbitration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arbitration.js","sourceRoot":"","sources":["../../src/machines/arbitration.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAuBH,gCAeC;AApCD,6DAAiG;AAEjG,+JAA+J;AAClJ,QAAA,uBAAuB,GAAG,KAAK,CAAC;AAU7C;;;;;;;GAOG;AACH,SAAgB,UAAU,CAAC,MAA2B,EAAE,QAA+B;IACrF,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAClE,CAAC;IACD,IAAI,CAAC,IAAA,6BAAiB,EAAC,QAAQ,CAAC,IAAI,CAAC,IAAA,6BAAiB,EAAC,MAAM,CAAC,EAAE,CAAC;QAC/D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,0BAA0B,EAAE,CAAC;IAChF,CAAC;IACD,MAAM,SAAS,GAAG,QAAwB,CAAC;IAC3C,IAAI,SAAS,CAAC,WAAW,KAAK,MAAM,CAAC,WAAW,EAAE,CAAC;QACjD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,yBAAyB,EAAE,CAAC;IAC/E,CAAC;IACD,IAAI,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;QACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;IAClE,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,uBAAW,CAAC,kBAAkB,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAC;AACpG,CAAC"}

package/dist-cjs/machines/backoff.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * Tunnel reconnect policy (local-live-protocol.md §5, runtime client
+ * behavior).
+ *
+ * Two rules keep a two-instance fight from becoming a reconnect war:
+ *
+ * 1. Exponential backoff resets to 1s only after a connection SURVIVED the
+ *    stable window; a connection that dies younger keeps (and grows) the
+ *    previous backoff.
+ * 2. A 4009 refusal ("superseded instance") retries after a fixed long
+ *    delay — never a full stop, because a wrongly-refused instance must
+ *    still recover once the true holder dies.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initialBackoff = exports.MAX_DELAY_MS = exports.BASE_DELAY_MS = exports.STABLE_RESET_MS = exports.SUPERSEDED_RETRY_MS = void 0;
+exports.planReconnect = planReconnect;
+const tunnel_js_1 = require("../contracts/frames/tunnel.js");
+/** AMALGM_TUNNEL_SUPERSEDED_RETRY_MS */
+exports.SUPERSEDED_RETRY_MS = 5 * 60_000;
+/** AMALGM_TUNNEL_STABLE_RESET_MS — survival time that earns a reset to the base delay. */
+exports.STABLE_RESET_MS = 30_000;
+exports.BASE_DELAY_MS = 1_000;
+exports.MAX_DELAY_MS = 60_000;
+exports.initialBackoff = { delayMs: exports.BASE_DELAY_MS };
+function planReconnect(state, disconnect) {
+    if (disconnect.closeCode === tunnel_js_1.CLOSE_CODES.supersededInstance) {
+        // Fixed, slow, and does not disturb the exponential state: an instance
+        // alternating between refusals and crashes must not launder its backoff.
+        return { waitMs: exports.SUPERSEDED_RETRY_MS, next: state, rule: 'superseded-fixed-retry' };
+    }
+    if (disconnect.connectedForMs >= exports.STABLE_RESET_MS) {
+        return { waitMs: exports.BASE_DELAY_MS, next: exports.initialBackoff, rule: 'stable-reset' };
+    }
+    const grown = Math.min(state.delayMs * 2, exports.MAX_DELAY_MS);
+    return { waitMs: state.delayMs, next: { delayMs: grown }, rule: 'exponential' };
+}
+//# sourceMappingURL=backoff.js.map

package/dist-cjs/machines/backoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backoff.js","sourceRoot":"","sources":["../../src/machines/backoff.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AA8BH,sCAWC;AAvCD,6DAA4D;AAE5D,wCAAwC;AAC3B,QAAA,mBAAmB,GAAG,CAAC,GAAG,MAAM,CAAC;AAC9C,0FAA0F;AAC7E,QAAA,eAAe,GAAG,MAAM,CAAC;AACzB,QAAA,aAAa,GAAG,KAAK,CAAC;AACtB,QAAA,YAAY,GAAG,MAAM,CAAC;AAOtB,QAAA,cAAc,GAAiB,EAAE,OAAO,EAAE,qBAAa,EAAE,CAAC;AAcvE,SAAgB,aAAa,CAAC,KAAmB,EAAE,UAAsB;IACvE,IAAI,UAAU,CAAC,SAAS,KAAK,uBAAW,CAAC,kBAAkB,EAAE,CAAC;QAC5D,uEAAuE;QACvE,yEAAyE;QACzE,OAAO,EAAE,MAAM,EAAE,2BAAmB,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,wBAAwB,EAAE,CAAC;IACtF,CAAC;IACD,IAAI,UAAU,CAAC,cAAc,IAAI,uBAAe,EAAE,CAAC;QACjD,OAAO,EAAE,MAAM,EAAE,qBAAa,EAAE,IAAI,EAAE,sBAAc,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;IAC/E,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,EAAE,oBAAY,CAAC,CAAC;IACxD,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;AAClF,CAAC"}

package/dist-cjs/machines/bootstrap.js

@@ -0,0 +1,110 @@
+"use strict";
+/**
+ * The bootstrap machine — how a client reaches `live` truthfully.
+ *
+ * Ordered-bootstrap mode (local-live-protocol.md §3): the snapshot is the
+ * first data frame and everything after it is ordered on the same channel,
+ * so the machine simply installs and follows. Legacy mode: the snapshot
+ * travels out-of-band, so the machine holds events while the snapshot body
+ * is in flight and replays only those past its seq — the full-snapshot
+ * barrier (§6).
+ *
+ * Feature detection (§3): a bootstrap request against a legacy engine
+ * yields no `snapshot` frame. The client falls back to the legacy path
+ * when the first data frame is a `state` event, a `ping` arrives, or the
+ * timeout passes — whichever comes first.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SnapshotBarrier = exports.BootstrapMachine = void 0;
+const stream_js_1 = require("../contracts/frames/stream.js");
+/** One instance per bootstrap-mode connection attempt; discard after it resolves. */
+class BootstrapMachine {
+    #held = [];
+    #resolved = false;
+    timeoutMs = stream_js_1.BOOTSTRAP_SNAPSHOT_TIMEOUT_MS;
+    /** Feed each stream frame until a command other than `none` resolves the machine. */
+    accept(frame) {
+        if (this.#resolved)
+            return { command: 'none' };
+        switch (frame.type) {
+            case 'snapshot': {
+                this.#resolved = true;
+                const snapshot = { seq: frame.seq, stable: frame.stable !== false, resources: frame.resources };
+                const replay = this.#held.filter((event) => event.seq > frame.seq);
+                this.#held = [];
+                return { command: 'install', snapshot, replay };
+            }
+            case 'state': {
+                if (this.#held.length === 0) {
+                    // First data frame is an event, not a snapshot: legacy peer.
+                    this.#resolved = true;
+                    return { command: 'fallback-legacy', held: [frame.event], reason: 'state-before-snapshot' };
+                }
+                this.#held.push(frame.event);
+                return { command: 'none' };
+            }
+            case 'ping': {
+                this.#resolved = true;
+                const held = this.#held;
+                this.#held = [];
+                return { command: 'fallback-legacy', held, reason: 'ping-before-snapshot' };
+            }
+            case 'error': {
+                this.#resolved = true;
+                this.#held = [];
+                return frame.status === undefined ? { command: 'fallback-error' } : { command: 'fallback-error', status: frame.status };
+            }
+            case 'reset':
+            case 'presence':
+                return { command: 'none' };
+        }
+    }
+    /** The host's timer fired without a snapshot frame. */
+    expire() {
+        if (this.#resolved)
+            return { command: 'none' };
+        this.#resolved = true;
+        const held = this.#held;
+        this.#held = [];
+        return { command: 'fallback-legacy', held, reason: 'timeout' };
+    }
+}
+exports.BootstrapMachine = BootstrapMachine;
+/**
+ * The legacy full-snapshot barrier (§6): hold events while a full snapshot
+ * body is in flight; on arrival, replay only those past its seq. Partial
+ * snapshots (resources added on a live connection) never pass through
+ * here — they hold per-resource and never bump the connection seq.
+ */
+class SnapshotBarrier {
+    #held = [];
+    #inFlight = false;
+    get inFlight() {
+        return this.#inFlight;
+    }
+    begin() {
+        this.#inFlight = true;
+        this.#held = [];
+    }
+    /** Returns true when the event was held (a snapshot body is in flight). */
+    hold(event) {
+        if (!this.#inFlight)
+            return false;
+        this.#held.push(event);
+        return true;
+    }
+    /** The snapshot body landed: install it, then apply the returned events in order. */
+    complete(snapshot) {
+        this.#inFlight = false;
+        const replay = this.#held.filter((event) => event.seq > snapshot.seq).sort((a, b) => a.seq - b.seq);
+        this.#held = [];
+        return replay;
+    }
+    /** The snapshot fetch failed: release nothing; the caller re-syncs. */
+    abandon() {
+        this.#inFlight = false;
+        this.#held = [];
+    }
+}
+exports.SnapshotBarrier = SnapshotBarrier;
+//# sourceMappingURL=bootstrap.js.map

package/dist-cjs/machines/bootstrap.js.map

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

package/dist-cjs/machines/chunks.js

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * Chunked response reassembly — the receiving half of §5's
+ * res_start / res_chunk / res_end train.
+ *
+ * Chunks reassemble by concatenating in index order; `res_end.chunks` must
+ * match the count received, else the whole response is treated as a 502
+ * for that request. Control frames interleaving between chunks is the
+ * feature, so the assembler tolerates any arrival interleaving across
+ * requests — but never within one (indexes must arrive 0,1,2,…).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChunkAssembler = void 0;
+exports.planChunks = planChunks;
+/**
+ * One assembler per tunnel connection. The host must call `abandon` when a
+ * request times out — the accumulator is memory, and §5 requires cleanup
+ * on the request timeout (AMALGM_TUNNEL_REQUEST_TIMEOUT_MS).
+ */
+class ChunkAssembler {
+    #pending = new Map();
+    /** In-flight accumulator count, exposed for diagnostics (§5 getTunnelDebugStats). */
+    get pending() {
+        return this.#pending.size;
+    }
+    accept(frame) {
+        switch (frame.type) {
+            case 'res_start': {
+                this.#pending.set(frame.req_id, { status: frame.status, headers: frame.headers, chunks: [] });
+                return { done: false };
+            }
+            case 'res_chunk': {
+                const acc = this.#pending.get(frame.req_id);
+                if (!acc)
+                    return { done: true, error: `res_chunk for unknown req_id ${frame.req_id}` };
+                if (frame.index !== acc.chunks.length) {
+                    this.#pending.delete(frame.req_id);
+                    return { done: true, error: `res_chunk index ${frame.index} arrived out of order (expected ${acc.chunks.length})` };
+                }
+                acc.chunks.push(frame.body_b64);
+                return { done: false };
+            }
+            case 'res_end': {
+                const acc = this.#pending.get(frame.req_id);
+                this.#pending.delete(frame.req_id);
+                if (!acc)
+                    return { done: true, error: `res_end for unknown req_id ${frame.req_id}` };
+                if (frame.chunks !== acc.chunks.length) {
+                    return { done: true, error: `res_end declared ${frame.chunks} chunks but ${acc.chunks.length} arrived` };
+                }
+                return { done: true, response: { status: acc.status, headers: acc.headers, bodyChunksB64: acc.chunks } };
+            }
+        }
+    }
+    /** Drop a timed-out request's accumulator. Returns whether one existed. */
+    abandon(reqId) {
+        return this.#pending.delete(reqId);
+    }
+}
+exports.ChunkAssembler = ChunkAssembler;
+/**
+ * Sender-side chunk plan for a raw body size: how many chunks a v2 peer
+ * will receive. The budget check happens BEFORE materializing any frame
+ * (§5): an over-budget response is dropped as a 503 without ever building
+ * its chunks — hence the plan is sizes only, never buffers.
+ */
+function planChunks(bodyBytes, chunkMaxBytes) {
+    if (bodyBytes < 0 || !Number.isSafeInteger(bodyBytes))
+        return { chunks: 0 };
+    return { chunks: bodyBytes === 0 ? 1 : Math.ceil(bodyBytes / chunkMaxBytes) };
+}
+//# sourceMappingURL=chunks.js.map

package/dist-cjs/machines/chunks.js.map

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

package/dist-cjs/machines/index.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * The machines layer: the protocol's behavior as pure, deterministic state
+ * machines. Every machine takes wire shapes in and returns decisions as
+ * data — the host performs the fetches, timers, and writes. Nothing in
+ * here opens a socket, reads a clock, or touches a disk.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./bootstrap.js"), exports);
+__exportStar(require("./presence.js"), exports);
+__exportStar(require("./arbitration.js"), exports);
+__exportStar(require("./chunks.js"), exports);
+__exportStar(require("./backoff.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist-cjs/machines/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/machines/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;AAEH,iDAA+B;AAC/B,gDAA8B;AAC9B,mDAAiC;AACjC,8CAA4B;AAC5B,+CAA6B"}

package/dist-cjs/machines/presence.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * Presence receiver — arrival-clock TTL over replace-not-merge frames.
+ *
+ * A presence frame carries the FULL peer list for one resource; receivers
+ * replace their view and treat absence as the default that publishing
+ * re-earns (local-live-protocol.md §2). The server already expires stale
+ * publishers, but receivers must apply their OWN arrival-clock TTL — a
+ * frozen stream must not preserve ghosts.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PresenceView = void 0;
+const presence_js_1 = require("../contracts/presence.js");
+class PresenceView {
+    ttlMs;
+    #byResource = new Map();
+    constructor(ttlMs = presence_js_1.SERVER_TTL_MS) {
+        this.ttlMs = ttlMs;
+    }
+    /** Replace one resource's peer view. `nowMs` is the receiver's clock (host-supplied — the SDK holds no clock). */
+    accept(frame, nowMs) {
+        const peers = new Map();
+        for (const peer of frame.peers) {
+            peers.set(peer.session, { ...peer, arrivedAtMs: nowMs });
+        }
+        if (peers.size === 0)
+            this.#byResource.delete(frame.resource);
+        else
+            this.#byResource.set(frame.resource, peers);
+    }
+    /** Live peers for a resource, with expired entries dropped as of `nowMs`. */
+    peers(resource, nowMs) {
+        const peers = this.#byResource.get(resource);
+        if (!peers)
+            return [];
+        const alive = [];
+        for (const [session, peer] of peers) {
+            if (nowMs - peer.arrivedAtMs > this.ttlMs)
+                peers.delete(session);
+            else
+                alive.push(peer);
+        }
+        if (peers.size === 0)
+            this.#byResource.delete(resource);
+        return alive;
+    }
+    /** Delivery was lost: presence is not replayed after a gap, so the view must not outlive its stream. */
+    clear() {
+        this.#byResource.clear();
+    }
+}
+exports.PresenceView = PresenceView;
+//# sourceMappingURL=presence.js.map

package/dist-cjs/machines/presence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence.js","sourceRoot":"","sources":["../../src/machines/presence.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,0DAAgG;AAOhG,MAAa,YAAY;IAGM;IAF7B,WAAW,GAAG,IAAI,GAAG,EAAiC,CAAC;IAEvD,YAA6B,QAAgB,2BAAa;QAA7B,UAAK,GAAL,KAAK,CAAwB;IAAG,CAAC;IAE9D,kHAAkH;IAClH,MAAM,CAAC,KAAoB,EAAE,KAAa;QACxC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAoB,CAAC;QAC1C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAC/B,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC;YAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;;YACzD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACnD,CAAC;IAED,6EAA6E;IAC7E,KAAK,CAAC,QAAgB,EAAE,KAAa;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,CAAC;QACtB,MAAM,KAAK,GAAe,EAAE,CAAC;QAC7B,KAAK,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC;YACpC,IAAI,KAAK,GAAG,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK;gBAAE,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;;gBAC5D,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC;YAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACxD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,wGAAwG;IACxG,KAAK;QACH,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;CACF;AAhCD,oCAgCC"}

package/dist-cjs/merge/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * The merge layer: the text-reconciliation engine behind live documents.
+ * `merge3` is the diff3 core; the doc-write decision policy
+ * (`decideDocWrite` — outcome selection, retention-ring base resolution,
+ * overwrite-deletes-text) joins it here as the next extraction slice
+ * (ROADMAP.md #1).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./merge3.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist-cjs/merge/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/merge/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;AAEH,8CAA4B"}