@astrosheep/keiyaku 2.9.13 → 4.0.0

package/build/core/projection/projection-execution-observer.js

@@ -1,270 +0,0 @@
-import { claimAllInbox, isTellLaunchAdmissionMember, listTellLaunchAdmissions, listTellIds, markTellSubmitted, bindTellLaunchReservation, recordTellReceiptCapabilities, recordTellReceipt, readTellSubmitted, readTellOriginal, isTellCausallyConsumed, appendGenerationEvent, } from "./projection-core.js";
-import { openProjectionTellObserver } from "./generation/database.js";
-const LIVE_TELL_DELIVERY_THROTTLE_MS = 200;
-export function renderProjectionTellFrame(tellId, text) {
-    void tellId;
-    return text;
-}
-function submitEligible(projectionDirectory, executionId, control, requireInbox, submitting, submissions, excludedTellIds, observer, pendingReceipts, pendingFenceReceipts) {
-    if (requireInbox && !observer?.hasInbox())
-        return;
-    claimAllInbox(projectionDirectory);
-    for (const tellId of listTellIds(projectionDirectory, "inflight")) {
-        if (excludedTellIds.has(tellId))
-            continue;
-        if (submitting.has(tellId))
-            continue;
-        // Construct before pin: a sync read/build failure must not leave submitting stuck.
-        const original = readTellOriginal(projectionDirectory, "inflight", tellId);
-        const tell = {
-            id: tellId,
-            text: renderProjectionTellFrame(tellId, original.text),
-            ...(original.effort ? { effort: original.effort } : {}),
-        };
-        submitting.add(tellId);
-        const submission = Promise.resolve()
-            .then(() => control.enqueue(tell))
-            .then((ack) => {
-            if (!ack)
-                throw new Error("provider enqueue resolved without TellSubmitAck");
-            markTellSubmitted(projectionDirectory, tellId, { executionId, fence: ack.fence });
-            reconcileAcknowledgedTell(projectionDirectory, executionId, tellId, ack.fence, pendingReceipts, pendingFenceReceipts);
-        })
-            .catch(() => {
-            // Leave in inflight for the next checkpoint or ingress opportunity.
-            // Reject means this crossing never accepted the tell; drop stale evidence.
-            pendingReceipts.delete(tellId);
-        })
-            .finally(() => submitting.delete(tellId));
-        submissions.add(submission);
-        void submission.finally(() => submissions.delete(submission));
-    }
-}
-/**
- * An acknowledgement establishes the submission fence. Native exact and fence
- * evidence may arrive on either side of that acknowledgement, so both buffers
- * reduce through this one monotonic path. Exact visibility runs first only to
- * supply the required heart predecessor for an already-buffered consumption.
- */
-function reconcileAcknowledgedTell(projectionDirectory, executionId, tellId, submissionFence, pendingExactReceipts, pendingFenceReceipts) {
-    for (const receipt of pendingExactReceipts.get(tellId) ?? []) {
-        const launchInput = "launchInput" in receipt ? receipt.launchInput : undefined;
-        recordTellReceipt(projectionDirectory, {
-            tellId,
-            executionId,
-            stage: receipt.stage,
-            correlation: launchInput ? "inherited" : "exact",
-            ...(launchInput ? { fence: launchInput.fence } : {}),
-        });
-    }
-    pendingExactReceipts.delete(tellId);
-    const submitted = readTellSubmitted(projectionDirectory, tellId);
-    if (isTellLaunchAdmissionMember(projectionDirectory, executionId, tellId))
-        return;
-    for (const receipt of pendingFenceReceipts) {
-        if (receipt.correlation.kind !== "fence")
-            continue;
-        if (!isTellCausallyConsumed(submissionFence, receipt.correlation.fence))
-            continue;
-        recordTellReceipt(projectionDirectory, {
-            tellId,
-            executionId,
-            stage: receipt.stage,
-            correlation: submitted.replayedFrom?.length ? "inherited" : "fence",
-            fence: receipt.correlation.fence,
-        });
-    }
-}
-export function createLiveTellDeliveryController(projectionDirectory, executionId, dependencies = {}) {
-    const now = dependencies.now ?? Date.now;
-    const setTimer = dependencies.setTimer ?? ((callback, delayMs) => setTimeout(callback, delayMs));
-    const clearTimer = dependencies.clearTimer ?? ((timer) => clearTimeout(timer));
-    const openObserver = dependencies.openObserver ?? openProjectionTellObserver;
-    const submitting = new Set();
-    const submissions = new Set();
-    // In-memory only: bridges a native exact receipt that races its enqueue ack.
-    const pendingReceipts = new Map();
-    // Native completion can race the steer RPC acknowledgement. The receipt is
-    // retained until each acknowledged fence can be reconciled causally.
-    const pendingFenceReceipts = [];
-    const initial = new Set(dependencies.reservedLaunchTellIds ?? []);
-    let observer;
-    let timer;
-    let nextOpportunityAt = 0;
-    let checking = false;
-    let dirty = false;
-    let closed = false;
-    let latestControl;
-    let opportunityEpoch = 0;
-    const scheduleTrailing = () => {
-        if (closed || timer !== undefined || !dirty)
-            return;
-        const delayMs = Math.max(0, nextOpportunityAt - now());
-        timer = setTimer(() => {
-            timer = undefined;
-            if (closed || !dirty)
-                return;
-            if (now() < nextOpportunityAt) {
-                scheduleTrailing();
-                return;
-            }
-            const control = latestControl;
-            if (control)
-                runOpportunity(control);
-        }, delayMs);
-    };
-    const discardObserver = () => {
-        try {
-            observer?.close();
-        }
-        catch {
-            // Observer close failures cannot change delivery policy.
-        }
-        observer = undefined;
-    };
-    const runOpportunity = (control) => {
-        if (closed)
-            return;
-        const epoch = opportunityEpoch;
-        dirty = false;
-        checking = true;
-        nextOpportunityAt = now() + LIVE_TELL_DELIVERY_THROTTLE_MS;
-        try {
-            observer ??= openObserver(projectionDirectory);
-            if (observer.hasDataVersionChanged()) {
-                submitEligible(projectionDirectory, executionId, control, true, submitting, submissions, initial, observer, pendingReceipts, pendingFenceReceipts);
-            }
-        }
-        catch {
-            // Observation and event delivery failures never terminate provider execution.
-            discardObserver();
-        }
-        finally {
-            checking = false;
-            if (epoch === opportunityEpoch && dirty)
-                scheduleTrailing();
-        }
-    };
-    const cancelOpportunity = () => {
-        opportunityEpoch += 1;
-        dirty = false;
-        if (timer !== undefined) {
-            clearTimer(timer);
-            timer = undefined;
-        }
-    };
-    return {
-        requestDelivery(control) {
-            if (closed)
-                return;
-            latestControl = control;
-            dirty = true;
-            if (checking || now() < nextOpportunityAt) {
-                scheduleTrailing();
-                return;
-            }
-            runOpportunity(control);
-        },
-        checkpoint(control, checkpoint) {
-            if (closed)
-                return;
-            latestControl = control;
-            cancelOpportunity();
-            submitEligible(projectionDirectory, executionId, control, false, submitting, submissions, initial, observer, pendingReceipts, pendingFenceReceipts);
-        },
-        receipt(receipt) {
-            if (closed)
-                return;
-            if (receipt.correlation.kind === "exact") {
-                const tellId = receipt.correlation.tellId;
-                const launchInput = "launchInput" in receipt ? receipt.launchInput : undefined;
-                if (submitting.has(tellId)) {
-                    const pending = pendingReceipts.get(tellId) ?? [];
-                    pending.push(receipt);
-                    pendingReceipts.set(tellId, pending);
-                    return;
-                }
-                recordTellReceipt(projectionDirectory, {
-                    tellId,
-                    executionId,
-                    stage: receipt.stage,
-                    correlation: launchInput ? "inherited" : "exact",
-                    ...(launchInput ? { fence: launchInput.fence } : {}),
-                });
-                return;
-            }
-            pendingFenceReceipts.push(receipt);
-            for (const state of ["submitted", "seen"]) {
-                for (const tellId of listTellIds(projectionDirectory, state)) {
-                    const submitted = readTellSubmitted(projectionDirectory, tellId);
-                    if (submitted.executionId !== executionId)
-                        continue;
-                    if (isTellLaunchAdmissionMember(projectionDirectory, executionId, tellId))
-                        continue;
-                    reconcileAcknowledgedTell(projectionDirectory, executionId, tellId, submitted.fence, pendingReceipts, pendingFenceReceipts);
-                }
-            }
-        },
-        async close() {
-            if (!closed) {
-                closed = true;
-                cancelOpportunity();
-                discardObserver();
-            }
-            // Do not drop pendingReceipts: in-flight acks may still persist a native receipt.
-            await Promise.all([...submissions]);
-        },
-    };
-}
-/**
- * Build an onSyncCheckpoint callback that claims all inbox tells
- * and delivers them via the given SteerControl.
- * Intended for use inside adapter start() calls as the onSyncCheckpoint callback.
- */
-export function buildSyncCheckpointCallback(projectionDirectory, executionId) {
-    const controller = createLiveTellDeliveryController(projectionDirectory, executionId);
-    return (control, checkpoint) => controller.checkpoint(control, checkpoint);
-}
-/**
- * Durable execution observer: appends prepared events, delivers live tells at
- * checkpoints, and exposes the public ExecutionObserver surface for harness call/revive.
- */
-export function createProjectionExecutionObserver(input, dependencies = {}) {
-    const appendEvent = dependencies.appendGenerationEvent ?? appendGenerationEvent;
-    const tellController = createLiveTellDeliveryController(input.projectionDirectory, input.executionId, { reservedLaunchTellIds: input.reservedLaunchTellIds });
-    let closePromise;
-    const observer = {
-        onEvent(event) {
-            appendEvent(input.projectionDirectory, input.executionId, event);
-        },
-        onCheckpoint(control, checkpoint) {
-            tellController.checkpoint(control, checkpoint);
-        },
-        async onTellReceiptCapabilities(capabilities) {
-            recordTellReceiptCapabilities(input.projectionDirectory, input.executionId, capabilities);
-        },
-        async onLaunchAdmission(admission) {
-            bindTellLaunchReservation(input.projectionDirectory, { executionId: input.executionId, ...admission });
-        },
-        listLaunchAdmissions() {
-            return listTellLaunchAdmissions(input.projectionDirectory, input.executionId);
-        },
-        onTellReceipt(receipt) {
-            tellController.receipt(receipt);
-        },
-        onDeliveryOpportunity(control) {
-            tellController.requestDelivery(control);
-        },
-    };
-    return {
-        observer,
-        close() {
-            if (closePromise)
-                return closePromise;
-            closePromise = tellController.close().catch(() => {
-                // Controller cleanup cannot change provider completion.
-            });
-            return closePromise;
-        },
-    };
-}