@jobshimo/browser-link 0.25.2 → 0.27.0

package/dist/extension/flow-registry.js

@@ -0,0 +1,638 @@
+/**
+ * In-flight flow registry + per-tab flow history + detached-flow records —
+ * the state behind the popup's Flows panel, behind `deps.shouldCancel` (see
+ * `flow.ts`), and behind the `flow_status` wire tool that backs
+ * `browser.flow_status`.
+ *
+ * Extracted out of `background.ts` for the same reason `idle-policy.ts`,
+ * `reconnect-policy.ts` and `flow-recording-policy.ts` were: the service
+ * worker itself is untestable (it reaches for `chrome.*` at import time),
+ * while THIS is the part with rules worth pinning down — the lifecycle of a
+ * running flow, what a cancel does to an id nobody recognises, the 20-entry
+ * history cap, the detached ceiling, and above all WHAT A HISTORY ENTRY IS
+ * ALLOWED TO CONTAIN.
+ *
+ * PRIVACY CONTRACT (same rule as the persistent map, enforced by
+ * `toHistoryEntry` and asserted in the tests): a history entry holds UI
+ * STRUCTURE AND OUTCOMES ONLY — counts, durations, a step index, a step
+ * KIND. Never page text, never a selector, never typed input, never a
+ * failure message. Flow error strings routinely quote the page (a
+ * `find: multiple-matches` error carries candidate labels), which is
+ * exactly why the failure message is dropped here rather than trimmed: the
+ * operator needs to know WHICH STEP died, not what the page said.
+ *
+ * The history lives in `chrome.storage.session` (written by
+ * `background.ts`, read by the popup through the same runtime-message
+ * channel) and therefore dies with the browser session BY DESIGN. This is
+ * an operator view, not an audit log.
+ *
+ * DETACHED-FLOW RECORDS ARE A DIFFERENT ANIMAL and the distinction matters.
+ * A record (`DetachedFlowRecord`, keyed `detached-flow:<flow_id>`) carries
+ * the flow's ACTION MANIFEST — the very `results[]` a synchronous flow
+ * returns to its caller — plus the failure message, so the agent that
+ * launched a detached run can still answer "which things did you just
+ * delete?" after the fact. That is page-derived data at rest in
+ * `chrome.storage.session`, deliberately, because a detached flow has no
+ * open tool call to return it through. It is NEVER shown in the popup, it
+ * is only ever handed back over the bridge to an agent that can already
+ * read the page, and it dies with the browser session like everything else
+ * here.
+ */
+/** How many completed flows are kept per tab. Small on purpose — this is a
+ * "what just happened on this tab" panel in a 320px-wide popup, not a log. */
+export const MAX_FLOW_HISTORY_PER_TAB = 20;
+/** `chrome.storage.session` key holding one tab's flow history. Keyed by
+ * the CHROME tab id (not the browser-link `tab_N` id) because the popup
+ * only ever knows the former, and a tab that reconnects under a new
+ * browser-link id is still the same tab to the human looking at it. */
+export function flowHistoryKey(tabId) {
+    return `flow-history:${tabId}`;
+}
+/** Absolute wall-clock ceiling on a DETACHED flow, from the moment it is
+ * registered. Mirrors `MAX_DETACHED_FLOW_TIMEOUT_MS` in the server's
+ * `browser-dispatch.ts` (which rejects an over-ceiling flow up front) and
+ * `cdp/detached-flows.ts` (the cdp-direct runner's own copy); kept in sync
+ * manually, since the three packages share no module for it.
+ *
+ * A detached flow escapes `MAX_FLOW_TIMEOUT_MS` — nothing is parked on it,
+ * so the 60s "do not hold a tool call open longer than this" rule simply
+ * does not apply. What it must NOT escape is having an end: a flow that
+ * keeps acting with no agent attached and no upper bound is exactly the
+ * runaway this whole program exists to make impossible. Past the ceiling
+ * the flow self-cancels and reports `stopped_by: 'expired'` — a distinct
+ * outcome from a human pressing Stop, because "I ran out of time" and
+ * "someone stopped me" are different facts about the same partial work.
+ *
+ * Enforced as a DEADLINE checked at the same points as the cancel flag
+ * (see `shouldStop`), never as a timer: a timer would fire while the
+ * runner is mid-step and could not stop anything anyway, and a
+ * request-derived `setTimeout` duration is a resource-exhaustion finding
+ * waiting to happen. */
+export const MAX_DETACHED_FLOW_MS = 30 * 60_000;
+export function createFlowRegistry() {
+    const flows = new Map();
+    /** Shared by `cancel` and `cancelForTab`: flip once, remember why. A
+     * second call never overwrites the first reason — the first thing that
+     * told the flow to stop is the thing that stopped it. */
+    function flip(entry, reason) {
+        if (entry.cancelled)
+            return false;
+        entry.cancelled = true;
+        entry.stopReason = reason;
+        return true;
+    }
+    return {
+        register({ flowId, tabId, steps, title, detached, expiresAt }) {
+            const entry = {
+                flowId,
+                tabId,
+                title: title ?? '',
+                startedAt: Date.now(),
+                steps,
+                cancelled: false,
+                // Step 0 of N until the runner reports its first step — "not
+                // started yet" rather than a fake "step 1".
+                progress: { step: 0, steps },
+                detached: detached === true,
+                ...(detached === true && expiresAt !== undefined ? { expiresAt } : {}),
+            };
+            flows.set(flowId, entry);
+            return entry;
+        },
+        get(flowId) {
+            return flows.get(flowId);
+        },
+        cancel(flowId, reason = 'cancelled') {
+            const entry = flows.get(flowId);
+            if (!entry)
+                return false;
+            return flip(entry, reason);
+        },
+        cancelForTab(tabId) {
+            let cancelled = 0;
+            for (const entry of flows.values()) {
+                if (entry.tabId !== tabId)
+                    continue;
+                if (flip(entry, 'cancelled'))
+                    cancelled += 1;
+            }
+            return cancelled;
+        },
+        detachedForTab(tabId) {
+            for (const entry of flows.values()) {
+                if (entry.tabId === tabId && entry.detached)
+                    return entry;
+            }
+            return undefined;
+        },
+        shouldStop(flowId, now) {
+            const entry = flows.get(flowId);
+            // An id the registry has forgotten is not "still allowed to run" —
+            // it is a flow whose bookkeeping is gone, and continuing to dispatch
+            // irreversible actions on behalf of something nobody can see or stop
+            // is the one outcome this module exists to prevent.
+            if (!entry)
+                return true;
+            if (entry.cancelled)
+                return true;
+            if (entry.expiresAt !== undefined && now >= entry.expiresAt) {
+                flip(entry, 'expired');
+                return true;
+            }
+            return false;
+        },
+        finish(flowId) {
+            const entry = flows.get(flowId);
+            flows.delete(flowId);
+            return entry;
+        },
+        listRunning(now) {
+            const views = [];
+            for (const entry of flows.values()) {
+                views.push({
+                    flowId: entry.flowId,
+                    tabId: entry.tabId,
+                    title: entry.title,
+                    // Clamped at 0: `now` is supplied by the caller and a clock that
+                    // stepped backwards should read "0s", never "-4s".
+                    elapsedMs: Math.max(0, now - entry.startedAt),
+                    steps: entry.steps,
+                    step: entry.progress.step,
+                    ...(entry.progress.iteration === undefined
+                        ? {}
+                        : { iteration: entry.progress.iteration }),
+                    ...(entry.progress.iterations === undefined
+                        ? {}
+                        : { iterations: entry.progress.iterations }),
+                    cancelling: entry.cancelled,
+                    detached: entry.detached,
+                });
+            }
+            // Insertion order is start order (Map preserves it and a flow is
+            // registered exactly once), so the oldest — the one most likely to
+            // be the runaway — sits at the top of the panel.
+            return views;
+        },
+    };
+}
+/** Sum the completed iterations of every `repeat` step in a finished
+ * flow's results. Reads ONLY the numeric `iterations_completed` field off
+ * entries that carry one; everything else in a result entry is ignored, so
+ * nothing page-derived can reach the history. */
+function countIterations(results) {
+    let total;
+    for (const entry of results) {
+        if (typeof entry !== 'object' || entry === null)
+            continue;
+        const value = entry.iterations_completed;
+        if (typeof value !== 'number' || !Number.isFinite(value))
+            continue;
+        total = (total ?? 0) + value;
+    }
+    return total;
+}
+/**
+ * Reduce a finished flow to its outcome. The ONE place a `FlowResult` is
+ * interpreted, so "what happened" has a single definition.
+ *
+ * `result === null` means the flow threw instead of returning (a detached
+ * debugger, a closed tab). That is a `failed` outcome with no step
+ * attribution, which is honest — the runner never got to report one.
+ *
+ * The runner only ever reports `stopped_by: 'cancelled'`: it flips when
+ * `shouldCancel` goes true and has no idea WHY it went true. The registry
+ * entry does (`stopReason`), which is what promotes a run that outlived
+ * its ceiling from `cancelled` to `expired` here.
+ */
+export function summarizeFlow(entry, result) {
+    if (result === null) {
+        // No result to read, so fall back to the last progress report: the
+        // runner had announced step N, which means N-1 finished.
+        return {
+            outcome: 'failed',
+            stepsCompleted: Math.max(0, entry.progress.step - 1),
+            ...(entry.stopReason === undefined ? {} : { stoppedBy: entry.stopReason }),
+        };
+    }
+    if (!result.ok) {
+        return {
+            outcome: 'failed',
+            stepsCompleted: result.steps_completed,
+            failedStep: result.failed_step,
+            // A fixed vocabulary from `stepKind()` ('click', 'wait_for',
+            // 'unknown', 'none'), never free text — see the privacy contract.
+            failedStepKind: result.step_kind,
+            error: result.error,
+        };
+    }
+    const iterations = countIterations(result.results);
+    const tail = iterations === undefined ? {} : { iterationsCompleted: iterations };
+    if (result.stopped_by !== 'cancelled') {
+        return { outcome: 'completed', stepsCompleted: result.steps_completed, ...tail };
+    }
+    const stoppedBy = entry.stopReason ?? 'cancelled';
+    return {
+        outcome: stoppedBy === 'expired' ? 'expired' : 'cancelled',
+        stepsCompleted: result.steps_completed,
+        ...tail,
+        stoppedBy,
+    };
+}
+/**
+ * Reduce a finished flow to a history entry — the ONE place a summary is
+ * allowed to turn into POPUP-visible stored state, and therefore the one
+ * place the privacy contract has to hold. Nothing is copied across by
+ * spread: every field is named, typed and numeric/enum, and the summary's
+ * `error` is deliberately not among them.
+ */
+export function toHistoryEntry(entry, result, endedAt) {
+    const summary = summarizeFlow(entry, result);
+    return {
+        flowId: entry.flowId,
+        startedAt: entry.startedAt,
+        durationMs: Math.max(0, endedAt - entry.startedAt),
+        steps: entry.steps,
+        outcome: summary.outcome,
+        stepsCompleted: summary.stepsCompleted,
+        ...(summary.iterationsCompleted === undefined
+            ? {}
+            : { iterationsCompleted: summary.iterationsCompleted }),
+        ...(summary.failedStep === undefined ? {} : { failedStep: summary.failedStep }),
+        ...(summary.failedStepKind === undefined ? {} : { failedStepKind: summary.failedStepKind }),
+        ...(entry.detached ? { detached: true } : {}),
+        ...(summary.stoppedBy === undefined ? {} : { stoppedBy: summary.stoppedBy }),
+    };
+}
+/** Prepend a finished flow to a tab's history and enforce the cap. Newest
+ * first — the panel shows the most recent flow at the top, and the cap
+ * drops the oldest. Pure so the cap is testable without touching
+ * `chrome.storage`. */
+export function appendFlowHistory(existing, entry) {
+    return [entry, ...existing].slice(0, MAX_FLOW_HISTORY_PER_TAB);
+}
+/** Narrow whatever `chrome.storage.session` hands back into a history
+ * list. Storage is not a trusted, typed channel (an older extension
+ * version may have written a different shape, and the value survives a
+ * service-worker restart), so an entry that does not carry the required
+ * primitives is dropped rather than rendered as `undefined`. */
+export function parseFlowHistory(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    const parsed = [];
+    for (const item of raw) {
+        if (typeof item !== 'object' || item === null)
+            continue;
+        const candidate = item;
+        if (typeof candidate.flowId !== 'string')
+            continue;
+        if (typeof candidate.startedAt !== 'number')
+            continue;
+        if (typeof candidate.durationMs !== 'number')
+            continue;
+        if (typeof candidate.steps !== 'number')
+            continue;
+        if (typeof candidate.stepsCompleted !== 'number')
+            continue;
+        if (!isFlowOutcome(candidate.outcome))
+            continue;
+        parsed.push({
+            flowId: candidate.flowId,
+            startedAt: candidate.startedAt,
+            durationMs: candidate.durationMs,
+            outcome: candidate.outcome,
+            steps: candidate.steps,
+            stepsCompleted: candidate.stepsCompleted,
+            ...(typeof candidate.iterationsCompleted === 'number'
+                ? { iterationsCompleted: candidate.iterationsCompleted }
+                : {}),
+            ...(typeof candidate.failedStep === 'number' ? { failedStep: candidate.failedStep } : {}),
+            ...(typeof candidate.failedStepKind === 'string'
+                ? { failedStepKind: candidate.failedStepKind }
+                : {}),
+            ...(candidate.detached === true ? { detached: true } : {}),
+            ...(isFlowStopReason(candidate.stoppedBy) ? { stoppedBy: candidate.stoppedBy } : {}),
+        });
+    }
+    return parsed.slice(0, MAX_FLOW_HISTORY_PER_TAB);
+}
+function isFlowOutcome(value) {
+    return (value === 'completed' || value === 'cancelled' || value === 'failed' || value === 'expired');
+}
+function isFlowStopReason(value) {
+    return value === 'cancelled' || value === 'expired' || value === 'worker-terminated';
+}
+/** Compact duration for the popup: "0.4s" under a second, "12s" under a
+ * minute, "3m 07s" beyond. Seconds are zero-padded in the minute form so
+ * the column does not jitter as a flow runs. */
+export function formatFlowDuration(ms) {
+    const safe = ms > 0 ? ms : 0;
+    if (safe < 1000)
+        return `${(safe / 1000).toFixed(1)}s`;
+    const totalSeconds = Math.floor(safe / 1000);
+    if (totalSeconds < 60)
+        return `${totalSeconds}s`;
+    const minutes = Math.floor(totalSeconds / 60);
+    const seconds = totalSeconds % 60;
+    return `${minutes}m ${String(seconds).padStart(2, '0')}s`;
+}
+/** What the popup calls a flow's tab. The title is best-effort (it is
+ * captured asynchronously at flow start and can legitimately be empty on
+ * a blank or still-loading tab), so the Chrome tab id is the fallback —
+ * an unlabelled Stop button next to an unlabelled flow would be exactly
+ * the wrong thing to hand someone trying to stop the right one. */
+export function flowTabLabel(view) {
+    const trimmed = view.title.trim();
+    return trimmed.length > 0 ? trimmed : `Tab ${view.tabId}`;
+}
+/** The progress line for one running flow: "step 2/5" outside a repeat,
+ * "step 2/5 · iteration 12/50" inside one, "starting…" before the runner
+ * has reported its first step. A detached flow is labelled as such: it is
+ * the one row where the human is the ONLY party still watching. */
+export function describeFlowProgress(view) {
+    const prefix = view.detached ? 'detached · ' : '';
+    if (view.step < 1)
+        return `${prefix}starting…`;
+    const base = `${prefix}step ${view.step}/${view.steps}`;
+    if (view.iteration === undefined || view.iterations === undefined)
+        return base;
+    return `${base} · iteration ${view.iteration}/${view.iterations}`;
+}
+/** How a stop reason reads in the panel. `worker-terminated` gets a real
+ * sentence because it is the one outcome a user cannot otherwise explain:
+ * Chrome killed the extension's service worker and the flow died with it. */
+const STOP_REASON_LABEL = {
+    cancelled: 'stopped by you',
+    expired: 'hit the 30-minute detached ceiling',
+    'worker-terminated': 'extension worker was terminated — not resumed',
+};
+/** The one-line summary for a finished flow: outcome, what it got through,
+ * and how long it took. Structure and counts only. */
+export function describeFlowHistoryEntry(entry) {
+    const progress = entry.iterationsCompleted === undefined
+        ? `${entry.stepsCompleted}/${entry.steps} steps`
+        : `${entry.stepsCompleted}/${entry.steps} steps · ${entry.iterationsCompleted} iterations`;
+    const failure = entry.outcome === 'failed' && entry.failedStep !== undefined
+        ? ` · failed at step ${entry.failedStep + 1}${entry.failedStepKind === undefined ? '' : ` (${entry.failedStepKind})`}`
+        : '';
+    // Only when it adds something: a `cancelled` entry already says
+    // "cancelled" in its own badge, so repeating "stopped by you" there
+    // would be noise.
+    const reason = entry.stoppedBy !== undefined && entry.stoppedBy !== 'cancelled'
+        ? ` · ${STOP_REASON_LABEL[entry.stoppedBy]}`
+        : '';
+    const detached = entry.detached === true ? 'detached · ' : '';
+    return `${detached}${progress} · ${formatFlowDuration(entry.durationMs)}${failure}${reason}`;
+}
+// === Detached-flow records ================================================
+/** `chrome.storage.session` key holding ONE detached flow's record. Keyed
+ * by `flow_id` (not by tab): the id is what `browser.flow_status` and
+ * `browser.flow_cancel` address, and it stays valid across a tab
+ * reconnecting under a new browser-link id. */
+export function detachedFlowKey(flowId) {
+    return `detached-flow:${flowId}`;
+}
+const DETACHED_FLOW_KEY_PREFIX = 'detached-flow:';
+/** Inverse of `detachedFlowKey`, for the worker-start sweep over
+ * `chrome.storage.session.get(null)`. Returns null for every other key. */
+export function flowIdFromDetachedFlowKey(key) {
+    if (!key.startsWith(DETACHED_FLOW_KEY_PREFIX))
+        return null;
+    const flowId = key.slice(DETACHED_FLOW_KEY_PREFIX.length);
+    return flowId.length > 0 ? flowId : null;
+}
+/** How many detached-flow records are kept at once, across every tab.
+ * Small on purpose: each terminal record carries a full action manifest,
+ * `chrome.storage.session` is a shared, quota-bounded store, and the
+ * realistic access pattern is "the agent that launched it polls it, reads
+ * the manifest once, and moves on". Oldest-first eviction. */
+export const MAX_DETACHED_FLOW_RECORDS = 10;
+/** Byte ceiling on ONE stored record's serialized manifest. A 500-iteration
+ * repeat over a 20-step body can produce a manifest far larger than
+ * anything a session store should hold, and losing the whole record to a
+ * quota rejection would be strictly worse than losing the manifest: the
+ * counts, the outcome and the failing step all still fit. Over the ceiling
+ * the manifest is dropped and `manifestTruncated` says so out loud, rather
+ * than a silently short array the agent would read as "that's all that
+ * happened". */
+export const MAX_DETACHED_MANIFEST_BYTES = 128_000;
+/** The record written the instant a detached flow is launched. Its whole
+ * job is to exist: a `running` record with no live registry entry behind it
+ * is the ONLY evidence that Chrome killed the service worker mid-flow. */
+export function startedDetachedFlowRecord(entry) {
+    return {
+        flowId: entry.flowId,
+        tabId: entry.tabId,
+        state: 'running',
+        startedAt: entry.startedAt,
+        steps: entry.steps,
+        stepsCompleted: 0,
+    };
+}
+/** The terminal record, manifest included. `endedAt` is passed in rather
+ * than read off the clock so the caller can use the same instant for the
+ * record, the history entry and the audit event. */
+export function finishedDetachedFlowRecord(entry, result, endedAt) {
+    const summary = summarizeFlow(entry, result);
+    const manifest = result !== null && result.ok ? result.results : [];
+    // Measured on the manifest alone: the rest of the record is a handful of
+    // numbers and a bounded error string, and charging them against the
+    // ceiling would make the cutoff depend on an error message's length.
+    const oversized = measureJsonBytes(manifest) > MAX_DETACHED_MANIFEST_BYTES;
+    return {
+        flowId: entry.flowId,
+        tabId: entry.tabId,
+        state: summary.outcome,
+        startedAt: entry.startedAt,
+        endedAt,
+        steps: entry.steps,
+        stepsCompleted: summary.stepsCompleted,
+        ...(summary.iterationsCompleted === undefined
+            ? {}
+            : { iterationsCompleted: summary.iterationsCompleted }),
+        ...(summary.stoppedBy === undefined ? {} : { stoppedBy: summary.stoppedBy }),
+        ...(summary.error === undefined ? {} : { error: summary.error }),
+        ...(oversized ? { manifestTruncated: true } : { manifest }),
+    };
+}
+/** Serialized size of a value, or `Infinity` when it cannot be serialized
+ * at all (a cycle, a BigInt). Unserializable is treated as over the
+ * ceiling: the alternative is letting `chrome.storage.session.set` throw
+ * and losing the entire record. */
+function measureJsonBytes(value) {
+    try {
+        const json = JSON.stringify(value);
+        return typeof json === 'string' ? json.length : Number.POSITIVE_INFINITY;
+    }
+    catch {
+        return Number.POSITIVE_INFINITY;
+    }
+}
+/**
+ * Reconcile a persisted record against the fact that this service worker
+ * has no live registry entry for it — i.e. Chrome terminated the worker
+ * while the flow was mid-run.
+ *
+ * THE RULE, and it is not negotiable: mark it `failed` /
+ * `'worker-terminated'` and NEVER resume. A detached flow exists to do
+ * irreversible bulk work; a resume that could not know how far the dead run
+ * actually got would double-act on some prefix of it. A loud, honest
+ * failure is strictly better than a silent second pass, and a phantom
+ * `running` state — a flow that looks alive while nothing is executing it —
+ * is worse than both.
+ *
+ * The manifest of the dead run is genuinely unrecoverable: it lived in the
+ * runner's closure, and there was never a per-step write that could have
+ * saved it. `manifestTruncated` says so rather than presenting an empty
+ * array as "nothing happened".
+ *
+ * Returns `null` for a record that is already terminal — a second worker
+ * restart must not rewrite an outcome, nor re-fire its audit event.
+ */
+export function terminatedDetachedFlowRecord(record, endedAt) {
+    if (record.state !== 'running')
+        return null;
+    const { manifest: _dropped, ...rest } = record;
+    return {
+        ...rest,
+        state: 'failed',
+        endedAt,
+        stoppedBy: 'worker-terminated',
+        manifestTruncated: true,
+        eventPending: true,
+    };
+}
+/** The same terminal record without its manifest — what gets written when
+ * storage refuses the full one. The manifest is the only part large enough
+ * to be refused; state, `stoppedBy`, the counters and the error are a few
+ * hundred bytes. Losing the manifest is a documented outcome; losing the
+ * write is not: the stale `running` record becomes `worker-terminated`. */
+export function minimalDetachedFlowRecord(record) {
+    const { manifest: _dropped, ...rest } = record;
+    return { ...rest, manifestTruncated: true };
+}
+/** The history entry for a flow the service worker was killed under. The
+ * live entry is gone, so this is reconstructed from the persisted record —
+ * counts and enums only, same privacy contract as every other entry. */
+export function terminatedFlowHistoryEntry(record) {
+    return {
+        flowId: record.flowId,
+        startedAt: record.startedAt,
+        durationMs: Math.max(0, (record.endedAt ?? record.startedAt) - record.startedAt),
+        steps: record.steps,
+        outcome: 'failed',
+        stepsCompleted: record.stepsCompleted,
+        detached: true,
+        stoppedBy: 'worker-terminated',
+    };
+}
+/** Narrow whatever `chrome.storage.session` hands back into a record.
+ * Same posture as `parseFlowHistory`: storage is not a typed channel, and a
+ * record written by an older extension version must be dropped rather than
+ * rendered as a half-`undefined` status payload. */
+export function parseDetachedFlowRecord(raw) {
+    if (typeof raw !== 'object' || raw === null)
+        return null;
+    const c = raw;
+    if (typeof c.flowId !== 'string' || c.flowId.length === 0)
+        return null;
+    if (typeof c.tabId !== 'number')
+        return null;
+    if (typeof c.startedAt !== 'number')
+        return null;
+    if (typeof c.steps !== 'number')
+        return null;
+    if (typeof c.stepsCompleted !== 'number')
+        return null;
+    if (c.state !== 'running' &&
+        c.state !== 'completed' &&
+        c.state !== 'cancelled' &&
+        c.state !== 'failed' &&
+        c.state !== 'expired') {
+        return null;
+    }
+    return {
+        flowId: c.flowId,
+        tabId: c.tabId,
+        state: c.state,
+        startedAt: c.startedAt,
+        steps: c.steps,
+        stepsCompleted: c.stepsCompleted,
+        ...(typeof c.endedAt === 'number' ? { endedAt: c.endedAt } : {}),
+        ...(typeof c.iterationsCompleted === 'number'
+            ? { iterationsCompleted: c.iterationsCompleted }
+            : {}),
+        ...(isFlowStopReason(c.stoppedBy) ? { stoppedBy: c.stoppedBy } : {}),
+        ...(typeof c.error === 'string' ? { error: c.error } : {}),
+        ...(Array.isArray(c.manifest) ? { manifest: c.manifest } : {}),
+        ...(c.manifestTruncated === true ? { manifestTruncated: true } : {}),
+        ...(c.eventPending === true ? { eventPending: true } : {}),
+    };
+}
+/** Which stored records to evict so `MAX_DETACHED_FLOW_RECORDS` holds,
+ * oldest-start first. RUNNING records are never evicted regardless of age:
+ * dropping one would erase the only evidence that a flow was in flight, and
+ * a worker restart would then have nothing to mark `worker-terminated`.
+ * Records still owing their summary event (`eventPending`) go LAST, reached
+ * only when nothing else is left: evicting one destroys an audit event no
+ * one has received, but a cap that can never be enforced would block every
+ * new record. The exemption lapses when the flush clears the flag. */
+export function detachedFlowRecordsToEvict(records) {
+    const terminal = records
+        .filter((r) => r.state !== 'running')
+        .sort((a, b) => a.startedAt - b.startedAt);
+    const keep = Math.max(0, MAX_DETACHED_FLOW_RECORDS - (records.length - terminal.length));
+    const excess = terminal.length - keep;
+    if (excess <= 0)
+        return [];
+    return [
+        ...terminal.filter((r) => r.eventPending !== true),
+        ...terminal.filter((r) => r.eventPending === true),
+    ].slice(0, excess);
+}
+/**
+ * Build the status payload for a flow id, from whichever source knows
+ * about it. The live registry entry wins for a running flow (it has
+ * up-to-the-step progress the twice-written record cannot), the persisted
+ * record answers for everything that already ended, and an id neither
+ * knows about comes back as `state: 'unknown'` rather than as an error.
+ */
+export function toFlowStatus(flowId, entry, record) {
+    if (entry) {
+        return {
+            flow_id: flowId,
+            state: 'running',
+            detached: entry.detached,
+            started_at: entry.startedAt,
+            steps: entry.steps,
+            // The runner reports the step it is ABOUT to dispatch, so N announced
+            // means N-1 finished. Same derivation the history uses for a flow
+            // that threw.
+            steps_completed: Math.max(0, entry.progress.step - 1),
+            ...(entry.progress.iteration === undefined
+                ? {}
+                : { iterations_completed: Math.max(0, entry.progress.iteration - 1) }),
+            ...(entry.cancelled ? { cancelling: true } : {}),
+            ...(entry.expiresAt === undefined ? {} : { expires_at: entry.expiresAt }),
+        };
+    }
+    if (record) {
+        return {
+            flow_id: flowId,
+            state: record.state,
+            detached: true,
+            started_at: record.startedAt,
+            ...(record.endedAt === undefined ? {} : { ended_at: record.endedAt }),
+            steps: record.steps,
+            steps_completed: record.stepsCompleted,
+            ...(record.iterationsCompleted === undefined
+                ? {}
+                : { iterations_completed: record.iterationsCompleted }),
+            ...(record.stoppedBy === undefined ? {} : { stopped_by: record.stoppedBy }),
+            ...(record.error === undefined ? {} : { error: record.error }),
+            ...(record.manifest === undefined ? {} : { manifest: record.manifest }),
+            ...(record.manifestTruncated === true ? { manifest_truncated: true } : {}),
+        };
+    }
+    return { flow_id: flowId, state: 'unknown', detached: false };
+}
+//# sourceMappingURL=flow-registry.js.map

package/dist/extension/flow-registry.js.map

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