@dudousxd/nestjs-durable-dashboard 0.0.0-beta-20260702153047

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Davide Carvalho
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/client/durable-client.d.ts

@@ -0,0 +1,186 @@
+export type RunStatus = 'pending' | 'running' | 'suspended' | 'completed' | 'failed' | 'cancelling' | 'cancelled' | 'dead';
+export type StepKind = 'local' | 'remote' | 'sleep' | 'signal';
+export interface WorkflowRun {
+    id: string;
+    workflow: string;
+    workflowVersion: string;
+    status: RunStatus;
+    input?: unknown;
+    output?: unknown;
+    error?: {
+        message: string;
+        code?: string;
+    };
+    wakeAt?: number;
+    recoveryAttempts?: number;
+    tags?: string[];
+    searchAttributes?: Record<string, string | number | boolean>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface StepEvent {
+    at: number;
+    level: 'debug' | 'info' | 'warn' | 'error';
+    message: string;
+    /** Stable run identity for a sub-process; distinct invocations of the same `name` get distinct ids. */
+    subId?: string;
+    /** For a sub-step/sub-process within the step: its name. */
+    name?: string;
+    /** Open, consumer-defined grouping label for a sub-process (e.g. a handler/lane). */
+    group?: string;
+    /** For a sub-step: its terminal outcome. */
+    status?: 'ok' | 'failed' | 'skipped';
+    /** Open, consumer-defined intermediate phase label for a sub-process transition (no `status`). */
+    phase?: string;
+    /** @deprecated owning sub-process **name** for a log line — superseded by `subId`. */
+    process?: string;
+    data?: unknown;
+}
+export interface StepCheckpoint {
+    runId: string;
+    seq: number;
+    name: string;
+    kind: StepKind;
+    /**
+     * `pending` = a remote step dispatched and awaiting its worker result (in-flight).
+     * `running` = a local step whose body is executing right now (in-flight).
+     */
+    status: 'pending' | 'running' | 'completed' | 'failed';
+    /** What the step was called with (a remote step's `ctx.call` args). */
+    input?: unknown;
+    output?: unknown;
+    error?: {
+        message: string;
+    };
+    /** Structured events the step (or its worker) emitted — sub-process outcomes + debug/error logs. */
+    events?: StepEvent[];
+    /**
+     * Shared tag across the N siblings of one `ctx.gather`/`ctx.all` fan-out (e.g. `gather:1` /
+     * `all:1`). The prefix is cosmetic; every sibling of ONE fan shares the same exact string, so the
+     * dashboard groups by exact string to render them as same-level siblings. Absent for non-fan steps.
+     */
+    parallelGroup?: string;
+    attempts: number;
+    workerGroup?: string;
+    wakeAt?: number;
+    /** When the step was dispatched (remote) or began (local). Queue-wait = startedAt − enqueuedAt. */
+    enqueuedAt?: string;
+    /** When processing actually began: worker pickup for a remote step, execution start for a local one. */
+    startedAt: string;
+    finishedAt: string;
+}
+export interface RunDetail {
+    run: WorkflowRun;
+    timeline: StepCheckpoint[];
+    /** Ids of runs this run spawned (ctx.child / ctx.startChild) — the parent→children tree. */
+    children?: string[];
+}
+/** A run's status as shown to a human. The engine stores one generic `suspended` for any durably
+ *  parked run, but WHY it's parked reads very differently, so we refine it for display only. */
+export type RunDisplayStatus = RunStatus | 'sleeping' | 'awaiting';
+/**
+ * Refine a run's stored status for display. The engine keeps `suspended` for every durably-parked
+ * run (it's what drives recovery/timers/queries — we never change that), but to a human a run whose
+ * remote step is being executed by a worker right now is `running`, a durable sleep is `sleeping`,
+ * and a wait on a signal is `awaiting`. Pass `timeline` (the detail view has it) for full precision;
+ * without it (the run list) a non-timer suspend reads as `running` — open and in progress — rather
+ * than the catch-all `suspended`.
+ */
+export declare function runDisplayStatus(run: WorkflowRun, timeline?: StepCheckpoint[]): RunDisplayStatus;
+export interface EngineEvent {
+    type: 'run.started' | 'run.completed' | 'run.failed' | 'run.suspended' | 'step.started' | 'step.completed' | 'step.failed' | 'step.progress';
+    runId: string;
+    workflow?: string;
+    seq?: number;
+    name?: string;
+    kind?: StepKind;
+    durationMs?: number;
+    /** The live step event carried by a `step.progress` (a running step's just-emitted log/sub-process). */
+    event?: StepEvent;
+    at: string;
+}
+/** How a worker decides its concurrency (mirror of core `WorkerConcurrencyStatus`). */
+export interface WorkerConcurrencyStatus {
+    mode: 'fixed' | 'adaptive';
+    /** The concurrency ceiling in effect now (fixed: configured; adaptive: the live limit). */
+    limit: number;
+    /** Adaptive only — the floor the controller won't go below. */
+    min?: number;
+    /** Adaptive only — the ceiling the controller won't exceed. */
+    max?: number;
+}
+/** The adaptive controller's most recent limit change (mirror of core `WorkerAdjust`). */
+export interface WorkerAdjust {
+    at: number;
+    from: number;
+    to: number;
+    reason: 'ram_ceiling' | 'cpu_ceiling' | 'backpressure' | 'grow' | 'shrink';
+}
+/** A live snapshot of a worker's execution state riding the heartbeat (mirror of core
+ *  `WorkerStatus`). Every field beyond concurrency/inFlight is best-effort and may be omitted. */
+export interface WorkerStatus {
+    runtime?: 'node' | 'python';
+    concurrency: WorkerConcurrencyStatus;
+    inFlight: number;
+    rssBytes?: number;
+    rssLimitBytes?: number;
+    rssPct?: number;
+    cpuPct?: number;
+    throughputPerMin?: number;
+    p95Ms?: number;
+    lastAdjust?: WorkerAdjust;
+}
+/** One worker's liveness record (mirror of the engine's `WorkerHeartbeat`). */
+export interface WorkerHeartbeat {
+    group: string;
+    instanceId: string;
+    lastBeatAt: number;
+    /** Live execution snapshot, when the heartbeat carries one (older SDKs leave it undefined). */
+    status?: WorkerStatus;
+}
+/** Per-group worker health for the Workers panel: backlog vs. live workers. The alert state a row
+ *  turns red on is `depth > 0 && liveWorkers.length === 0` (work piling up with no consumer). */
+export interface GroupHealth {
+    group: string;
+    depth: number;
+    liveWorkers: WorkerHeartbeat[];
+}
+declare global {
+    interface Window {
+        /** UI mount base (e.g. `/durable`) injected by the UI controller; falls back to `/durable`. */
+        __DURABLE_BASE__?: string;
+        /** JSON API base (e.g. `/api/durable`) injected by the UI controller; falls back to `<base>/api`. */
+        __DURABLE_API__?: string;
+    }
+}
+export declare const durableClient: {
+    runs(status?: RunStatus, tag?: string, attr?: string[]): Promise<WorkflowRun[]>;
+    run(id: string): Promise<RunDetail>;
+    /** Per-group worker health (queue backlog + live worker heartbeats) for the Workers panel. */
+    workers(): Promise<GroupHealth[]>;
+    retry(id: string): Promise<WorkflowRun>;
+    /** Fix-and-replay: re-run a dead/failed run with a corrected input. Returns the new run's id. */
+    retryWithInput(id: string, input: unknown): Promise<{
+        runId: string;
+    }>;
+    /** Bulk retry/cancel every run matching a filter. Returns how many matched + were acted on. */
+    bulk(action: "retry" | "cancel", filter: {
+        status?: RunStatus | undefined;
+        tag?: string | undefined;
+        attr?: string[] | undefined;
+    }): Promise<{
+        matched: number;
+        applied: number;
+    }>;
+    cancel(id: string, opts?: {
+        compensate?: boolean;
+    }): Promise<WorkflowRun>;
+    continue(id: string): Promise<WorkflowRun>;
+    /**
+     * Live-tail a run's lifecycle events over SSE (replaces polling). Calls `onEvent` per event;
+     * returns a function to close the stream. Cross-pod when the server transport has a control plane.
+     */
+    streamRun(id: string, onEvent: (event: EngineEvent) => void): () => void;
+};
+export { type SubProcess, groupSubProcesses } from './group-subprocesses';
+//# sourceMappingURL=durable-client.d.ts.map

package/dist/client/durable-client.d.ts.map

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

package/dist/client/durable-client.js

@@ -0,0 +1,106 @@
+/**
+ * Refine a run's stored status for display. The engine keeps `suspended` for every durably-parked
+ * run (it's what drives recovery/timers/queries — we never change that), but to a human a run whose
+ * remote step is being executed by a worker right now is `running`, a durable sleep is `sleeping`,
+ * and a wait on a signal is `awaiting`. Pass `timeline` (the detail view has it) for full precision;
+ * without it (the run list) a non-timer suspend reads as `running` — open and in progress — rather
+ * than the catch-all `suspended`.
+ */
+export function runDisplayStatus(run, timeline) {
+    if (run.status !== 'suspended')
+        return run.status;
+    // a remote step is in flight (`pending`) or a local step body is executing (`running`)
+    if (timeline?.some((s) => s.status === 'pending' || s.status === 'running'))
+        return 'running';
+    if (run.wakeAt != null)
+        return 'sleeping'; // parked on a durable timer
+    if (timeline)
+        return 'awaiting'; // timeline known, nothing pending, no timer → waiting on a signal
+    return 'running'; // list view (no timeline): show open runs as in-progress, not the generic suspended
+}
+function apiBase() {
+    if (typeof window !== 'undefined' && window.__DURABLE_API__)
+        return window.__DURABLE_API__;
+    const base = (typeof window !== 'undefined' && window.__DURABLE_BASE__) || '/durable';
+    return `${base}/api`;
+}
+async function http(path, init) {
+    const res = await fetch(apiBase() + path, init);
+    if (!res.ok)
+        throw new Error(`${res.status} ${res.statusText}`);
+    return (await res.json());
+}
+export const durableClient = {
+    runs(status, tag, attr) {
+        const q = new URLSearchParams();
+        if (status)
+            q.set('status', status);
+        if (tag)
+            q.set('tag', tag);
+        // Each `attr` is a `key:op:value` predicate; repeated params are ANDed server-side.
+        for (const a of attr ?? [])
+            q.append('attr', a);
+        const qs = q.toString();
+        return http(qs ? `/runs?${qs}` : '/runs');
+    },
+    run(id) {
+        return http(`/runs/${encodeURIComponent(id)}`);
+    },
+    /** Per-group worker health (queue backlog + live worker heartbeats) for the Workers panel. */
+    workers() {
+        return http('/workers');
+    },
+    retry(id) {
+        return http(`/runs/${encodeURIComponent(id)}/retry`, { method: 'POST' });
+    },
+    /** Fix-and-replay: re-run a dead/failed run with a corrected input. Returns the new run's id. */
+    retryWithInput(id, input) {
+        return http(`/runs/${encodeURIComponent(id)}/retry-with-input`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ input }),
+        });
+    },
+    /** Bulk retry/cancel every run matching a filter. Returns how many matched + were acted on. */
+    bulk(action, filter) {
+        const q = new URLSearchParams();
+        if (filter.status)
+            q.set('status', filter.status);
+        if (filter.tag)
+            q.set('tag', filter.tag);
+        for (const a of filter.attr ?? [])
+            q.append('attr', a);
+        const qs = q.toString();
+        return http(`/bulk/${action}${qs ? `?${qs}` : ''}`, {
+            method: 'POST',
+        });
+    },
+    cancel(id, opts) {
+        const qs = opts?.compensate ? '?compensate=true' : '';
+        return http(`/runs/${encodeURIComponent(id)}/cancel${qs}`, { method: 'POST' });
+    },
+    continue(id) {
+        return http(`/runs/${encodeURIComponent(id)}/continue`, { method: 'POST' });
+    },
+    /**
+     * Live-tail a run's lifecycle events over SSE (replaces polling). Calls `onEvent` per event;
+     * returns a function to close the stream. Cross-pod when the server transport has a control plane.
+     */
+    streamRun(id, onEvent) {
+        const source = new EventSource(`${apiBase()}/runs/${encodeURIComponent(id)}/stream`);
+        source.onmessage = (msg) => {
+            try {
+                onEvent(JSON.parse(msg.data));
+            }
+            catch {
+                /* ignore malformed event */
+            }
+        };
+        return () => source.close();
+    },
+};
+// Re-export the canonical sub-process grouper so external consumers (e.g. flip's embedded
+// pipeline-runs view) reconstruct sub-processes from a step's events the exact same way the
+// dashboard does — by run identity (`subId`/`name`), treating `phase` events as a sub's lifecycle.
+export { groupSubProcesses } from './group-subprocesses';
+//# sourceMappingURL=durable-client.js.map

package/dist/client/durable-client.js.map

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

package/dist/client/group-parallel-spans.d.ts

@@ -0,0 +1,24 @@
+import type { StepCheckpoint } from './durable-client';
+/**
+ * A timeline rendered as a sequence of nodes: a plain `single` step, or a `fan` — N steps that the
+ * engine tagged with the same `parallelGroup` (a `ctx.gather`/`ctx.all` fan-out, e.g. processing's 7
+ * handlers) and that therefore ran as siblings, to be laid out at the same level rather than stacked.
+ */
+export type TimelineNode = {
+    kind: 'single';
+    step: StepCheckpoint;
+} | {
+    kind: 'fan';
+    group: string;
+    steps: StepCheckpoint[];
+    label: string;
+};
+/**
+ * Collapse consecutive steps that share a non-empty `parallelGroup` into one `fan` node (the engine
+ * tags every sibling of one `ctx.gather`/`ctx.all` fan with the SAME exact group string — the
+ * `gather:`/`all:` prefix is cosmetic, grouping is by exact string). A fan keeps its position where
+ * its first member sat; input order is preserved. Steps with no `parallelGroup`, or a group of one,
+ * stay `single`.
+ */
+export declare function groupParallelSpans(timeline: StepCheckpoint[]): TimelineNode[];
+//# sourceMappingURL=group-parallel-spans.d.ts.map

package/dist/client/group-parallel-spans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-parallel-spans.d.ts","sourceRoot":"","sources":["../../src/client/group-parallel-spans.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;;;GAIG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,cAAc,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,cAAc,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAuB3E;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,YAAY,EAAE,CAgC7E"}

package/dist/client/group-parallel-spans.js

@@ -0,0 +1,64 @@
+/** Longest shared leading word-ish prefix across names, trimmed of trailing separators. */
+function commonPrefix(names) {
+    if (names.length === 0)
+        return '';
+    let prefix = names[0] ?? '';
+    for (const name of names.slice(1)) {
+        let i = 0;
+        while (i < prefix.length && i < name.length && prefix[i] === name[i])
+            i += 1;
+        prefix = prefix.slice(0, i);
+    }
+    // Trim trailing separators (`handle_` → `handle`) so the label reads cleanly.
+    return prefix.replace(/[\s._:-]+$/, '');
+}
+/** A concise summary of a fan: a name-derived label like `handle ×7` (NOT the group prefix). */
+function fanLabel(steps) {
+    const prefix = commonPrefix(steps.map((s) => s.name));
+    // A single-character shared prefix (e.g. `a`/`b` → ``, but `fA`/`fB` → `f`) reads as noise, not a
+    // meaningful label — fall back to `parallel` unless the shared prefix is at least two chars.
+    return `${prefix.length >= 2 ? prefix : 'parallel'} ×${steps.length}`;
+}
+/**
+ * Collapse consecutive steps that share a non-empty `parallelGroup` into one `fan` node (the engine
+ * tags every sibling of one `ctx.gather`/`ctx.all` fan with the SAME exact group string — the
+ * `gather:`/`all:` prefix is cosmetic, grouping is by exact string). A fan keeps its position where
+ * its first member sat; input order is preserved. Steps with no `parallelGroup`, or a group of one,
+ * stay `single`.
+ */
+export function groupParallelSpans(timeline) {
+    const nodes = [];
+    let i = 0;
+    while (i < timeline.length) {
+        const step = timeline[i];
+        if (step === undefined) {
+            i += 1;
+            continue;
+        }
+        const group = step.parallelGroup;
+        if (group === undefined || group === '') {
+            nodes.push({ kind: 'single', step });
+            i += 1;
+            continue;
+        }
+        // Gather the consecutive run of steps sharing this exact group.
+        const steps = [];
+        let j = i;
+        while (j < timeline.length && timeline[j]?.parallelGroup === group) {
+            const s = timeline[j];
+            if (s !== undefined)
+                steps.push(s);
+            j += 1;
+        }
+        if (steps.length <= 1) {
+            // A lone member is not a fan — render it as an ordinary single row.
+            nodes.push({ kind: 'single', step: steps[0] ?? step });
+        }
+        else {
+            nodes.push({ kind: 'fan', group, steps, label: fanLabel(steps) });
+        }
+        i = j;
+    }
+    return nodes;
+}
+//# sourceMappingURL=group-parallel-spans.js.map

package/dist/client/group-parallel-spans.js.map

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

package/dist/client/group-subprocesses.d.ts

@@ -0,0 +1,28 @@
+import type { StepEvent } from './durable-client';
+/** A sub-process reconstructed from a step's events, keyed by run identity. */
+export interface SubProcess {
+    id: string;
+    name: string;
+    group?: string | undefined;
+    /** Intermediate transitions (events carrying a `phase`), in arrival order. */
+    phases: StepEvent[];
+    /** Log lines owned by this sub-process (no `phase`, no `status`), in arrival order. */
+    logs: StepEvent[];
+    /** The terminal event (carries a `status`), if the sub has finished. */
+    terminal?: StepEvent | undefined;
+    status?: 'ok' | 'failed' | 'skipped' | undefined;
+    /** Earliest `at` across this sub's events. */
+    startedAt?: number | undefined;
+    /** `data.durationMs` when provided, else `terminal.at − startedAt`. */
+    durationMs?: number | undefined;
+}
+/**
+ * Group a step's events into sub-processes by run identity (`subId`, falling back to `name` then the
+ * legacy `process` tag). Events with no owner (step-level logs) are returned separately. `Map`
+ * iteration preserves first-seen order, so subs come back in the order they first appeared.
+ */
+export declare function groupSubProcesses(events: StepEvent[]): {
+    subs: SubProcess[];
+    stepLogs: StepEvent[];
+};
+//# sourceMappingURL=group-subprocesses.d.ts.map

package/dist/client/group-subprocesses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-subprocesses.d.ts","sourceRoot":"","sources":["../../src/client/group-subprocesses.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,+EAA+E;AAC/E,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,8EAA8E;IAC9E,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,uFAAuF;IACvF,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IACjC,MAAM,CAAC,EAAE,IAAI,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;IACjD,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAUD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG;IACtD,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,QAAQ,EAAE,SAAS,EAAE,CAAC;CACvB,CA8CA"}

package/dist/client/group-subprocesses.js

@@ -0,0 +1,62 @@
+function durationFromData(data) {
+    if (typeof data === 'object' && data !== null && 'durationMs' in data) {
+        const value = data.durationMs;
+        if (typeof value === 'number')
+            return value;
+    }
+    return undefined;
+}
+/**
+ * Group a step's events into sub-processes by run identity (`subId`, falling back to `name` then the
+ * legacy `process` tag). Events with no owner (step-level logs) are returned separately. `Map`
+ * iteration preserves first-seen order, so subs come back in the order they first appeared.
+ */
+export function groupSubProcesses(events) {
+    const byId = new Map();
+    const stepLogs = [];
+    for (const event of events) {
+        // key === undefined iff the event carries none of subId/name/process — a step-level log.
+        const key = event.subId ?? event.name ?? event.process;
+        if (key === undefined) {
+            stepLogs.push(event);
+            continue;
+        }
+        const existing = byId.get(key);
+        const sub = existing ?? { id: key, name: event.name ?? key, phases: [], logs: [] };
+        if (!existing)
+            byId.set(key, sub);
+        if (event.name !== undefined)
+            sub.name = event.name;
+        if (event.group !== undefined)
+            sub.group = event.group;
+        if (event.status !== undefined) {
+            sub.terminal = event;
+            sub.status = event.status;
+        }
+        else if (event.phase !== undefined) {
+            sub.phases.push(event);
+        }
+        else {
+            sub.logs.push(event);
+        }
+    }
+    const subs = [...byId.values()].map((sub) => {
+        const nonTerminal = [...sub.phases, ...sub.logs];
+        const stamps = [...nonTerminal, ...(sub.terminal ? [sub.terminal] : [])].map((e) => e.at);
+        // reduce, not Math.min(...spread): a noisy sub can have tens of thousands of log events,
+        // which would overflow the call-stack argument limit.
+        const startedAt = stamps.length
+            ? stamps.reduce((a, b) => (b < a ? b : a), Number.POSITIVE_INFINITY)
+            : undefined;
+        const fromData = durationFromData(sub.terminal?.data);
+        // Duration is known only when there's a non-terminal stamp to measure from; a terminal-only
+        // sub (e.g. legacy `sub(name, status)` with no phases/logs) has an UNKNOWN duration, not 0.
+        const durationMs = fromData ??
+            (sub.terminal && startedAt !== undefined && nonTerminal.length > 0
+                ? sub.terminal.at - startedAt
+                : undefined);
+        return { ...sub, startedAt, durationMs };
+    });
+    return { subs, stepLogs };
+}
+//# sourceMappingURL=group-subprocesses.js.map

package/dist/client/group-subprocesses.js.map

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

package/dist/client/merge-live-events.d.ts

@@ -0,0 +1,15 @@
+import type { RunDetail } from './durable-client';
+/**
+ * Merge a freshly-fetched run with the previously-cached one, preserving the live event trail the SSE
+ * stream accumulated for in-flight steps.
+ *
+ * The store only persists a step's `events` at COMPLETION, so a poll/refetch returns a still-running
+ * step with empty `events`. The live-tail (`step.progress`) appends events into the cache as they
+ * arrive; replacing the cache wholesale on every 1.5s refetch would wipe that streamed trail — it
+ * then reappears on the next stream event, so sub-processes flicker (appear → vanish → reappear).
+ *
+ * Rule: a step still `pending`/`running` with no fetched events keeps the streamed copy; a
+ * `completed`/`failed` step is authoritative and always uses the fetched events (even if empty).
+ */
+export declare function mergeLiveEvents(prev: RunDetail | undefined, fresh: RunDetail): RunDetail;
+//# sourceMappingURL=merge-live-events.d.ts.map

package/dist/client/merge-live-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-live-events.d.ts","sourceRoot":"","sources":["../../src/client/merge-live-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,SAAS,CAcxF"}

package/dist/client/merge-live-events.js

@@ -0,0 +1,30 @@
+/**
+ * Merge a freshly-fetched run with the previously-cached one, preserving the live event trail the SSE
+ * stream accumulated for in-flight steps.
+ *
+ * The store only persists a step's `events` at COMPLETION, so a poll/refetch returns a still-running
+ * step with empty `events`. The live-tail (`step.progress`) appends events into the cache as they
+ * arrive; replacing the cache wholesale on every 1.5s refetch would wipe that streamed trail — it
+ * then reappears on the next stream event, so sub-processes flicker (appear → vanish → reappear).
+ *
+ * Rule: a step still `pending`/`running` with no fetched events keeps the streamed copy; a
+ * `completed`/`failed` step is authoritative and always uses the fetched events (even if empty).
+ */
+export function mergeLiveEvents(prev, fresh) {
+    if (!prev)
+        return fresh;
+    const prevBySeq = new Map(prev.timeline.map((step) => [step.seq, step]));
+    return {
+        ...fresh,
+        timeline: fresh.timeline.map((step) => {
+            const inFlight = step.status === 'pending' || step.status === 'running';
+            if (inFlight && (step.events?.length ?? 0) === 0) {
+                const streamed = prevBySeq.get(step.seq)?.events;
+                if (streamed?.length)
+                    return { ...step, events: streamed };
+            }
+            return step;
+        }),
+    };
+}
+//# sourceMappingURL=merge-live-events.js.map

package/dist/client/merge-live-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-live-events.js","sourceRoot":"","sources":["../../src/client/merge-live-events.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAC,IAA2B,EAAE,KAAgB;IAC3E,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACzE,OAAO;QACL,GAAG,KAAK;QACR,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC;YACxE,IAAI,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjD,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;gBACjD,IAAI,QAAQ,EAAE,MAAM;oBAAE,OAAO,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;YAC7D,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC,CAAC;KACH,CAAC;AACJ,CAAC"}