@nodetool-ai/execution 0.8.1

package/dist/service/debug-sessions.js

@@ -0,0 +1,358 @@
+/**
+ * Interactive escalation sessions for the agent-facing run/debug endpoints.
+ *
+ * The supervisor design (docs/workflow-supervisor-design.md) puts an LLM agent
+ * on a run's failure path. This module puts the *calling* agent there instead:
+ * `InteractiveEscalationHandle` is a `SupervisorHandle` whose `decide()` parks
+ * the escalation until a verdict arrives over HTTP, so the tool that started
+ * the run gets the problem back as its result and answers with one of the
+ * same verdicts the supervisor vocabulary defines. The kernel's guarantees are
+ * untouched — the handle is wrapped in `BoundedHandle` (decision/retry caps,
+ * timeout, sticky verdicts) and the actor still enforces `allowedActions`.
+ *
+ * A session is one run: the parked escalations, the run's completion promise,
+ * and the final report. Sessions are owned by the user who started the run and
+ * are swept a few minutes after the run settles.
+ *
+ * Long-running work that is not a workflow run uses the same registry for its
+ * polling and cancel — `POST /api/applications/build` fronts a build this way,
+ * with a null `workflowId` and a handle nothing ever escalates to.
+ */
+import { randomUUID } from "node:crypto";
+import { createLogger } from "@nodetool-ai/config";
+import { validateSubstituteOutputs } from "@nodetool-ai/kernel";
+const log = createLogger("nodetool.execution.debug-sessions");
+/** How long an agent gets to answer one escalation before it fails closed. */
+export const INTERACTIVE_DECISION_TIMEOUT_MS = 10 * 60_000;
+/** How long a settled session's report stays fetchable. */
+const SESSION_DONE_TTL_MS = 10 * 60_000;
+/**
+ * Hard ceiling on a session's life. The TTL sweep only arms once a run
+ * settles, so a run whose `done` never resolves — a wedged bridge, a promise
+ * nobody rejects — used to hold its session (and the run behind it) forever.
+ */
+export const SESSION_MAX_LIFETIME_MS = 60 * 60_000;
+/** How long `cancel()` waits for the run to settle before answering anyway. */
+export const CANCEL_SETTLE_TIMEOUT_MS = 30_000;
+/** Live (unsettled) sessions one user may hold at once. */
+export const MAX_LIVE_SESSIONS_PER_USER = 8;
+const FAIL_CLOSED = {
+    verdict: { action: "fail" },
+    decidedBy: "default"
+};
+/**
+ * A `SupervisorHandle` that answers nothing itself: each `decide()` parks the
+ * escalation until `submit()` delivers a verdict (or the decision signal
+ * aborts, which fails closed). `BoundedHandle` serializes decisions, so at
+ * most one escalation is pending at a time.
+ */
+export class InteractiveEscalationHandle {
+    _pending = null;
+    _waiters = [];
+    _counter = 0;
+    _closed = false;
+    decide(e, signal) {
+        if (this._closed || signal.aborted)
+            return Promise.resolve(FAIL_CLOSED);
+        return new Promise((resolve) => {
+            let settled = false;
+            const entry = {
+                id: `esc-${++this._counter}`,
+                escalation: e,
+                settle: (outcome) => {
+                    if (settled)
+                        return;
+                    settled = true;
+                    if (this._pending === entry)
+                        this._pending = null;
+                    signal.removeEventListener("abort", onAbort);
+                    resolve(outcome);
+                }
+            };
+            const onAbort = () => entry.settle(FAIL_CLOSED);
+            signal.addEventListener("abort", onAbort, { once: true });
+            this._pending = entry;
+            const waiters = this._waiters;
+            this._waiters = [];
+            for (const waiter of waiters)
+                waiter(entry);
+        });
+    }
+    /** The escalation currently awaiting a verdict, if any. */
+    current() {
+        if (!this._pending)
+            return null;
+        return { id: this._pending.id, escalation: this._pending.escalation };
+    }
+    /**
+     * Subscribe to the next parked escalation. Returns an unsubscribe so a
+     * caller racing this against run completion can withdraw when the run wins
+     * — otherwise every verdict round trip would strand one waiter until the
+     * session is swept.
+     */
+    subscribe(waiter) {
+        this._waiters.push(waiter);
+        return () => {
+            const index = this._waiters.indexOf(waiter);
+            if (index !== -1)
+                this._waiters.splice(index, 1);
+        };
+    }
+    /**
+     * Deliver the agent's verdict for the parked escalation. Returns an error
+     * string instead of throwing so the HTTP layer can 400 with it; the verdict
+     * is checked against the escalation's `allowedActions` here so the agent can
+     * correct itself, and enforced again by the kernel regardless.
+     *
+     * A `substitute` payload is validated here too, against the same rules the
+     * actor applies. Accepting it and letting the kernel reject it fails the
+     * node with its *original* error and burns the decision — the agent never
+     * learns its repair was malformed. Rejecting here keeps the escalation
+     * parked, so it can answer again.
+     */
+    async submit(escalationId, verdict) {
+        const pending = this._pending;
+        if (!pending) {
+            return {
+                error: "No escalation is awaiting a verdict — the run may have moved on " +
+                    "(a timed-out decision fails closed) or finished."
+            };
+        }
+        if (pending.id !== escalationId) {
+            return {
+                error: `Escalation ${escalationId} is not pending (current: ${pending.id}).`
+            };
+        }
+        if (!pending.escalation.allowedActions.includes(verdict.action)) {
+            return {
+                error: `Verdict "${verdict.action}" is not allowed for this escalation. ` +
+                    `Allowed: ${pending.escalation.allowedActions.join(", ")}.`
+            };
+        }
+        if (verdict.action === "substitute") {
+            const result = await validateSubstituteOutputs(verdict.outputs, {
+                declaredOutputs: pending.escalation.declaredOutputs
+            });
+            if (!result.ok) {
+                return {
+                    error: "Substituted outputs are invalid, so the escalation is still " +
+                        `awaiting a verdict: ${result.issues.join("; ")}`
+                };
+            }
+            // Validation is async; the escalation may have failed closed meanwhile.
+            if (this._pending !== pending) {
+                return {
+                    error: "The escalation stopped awaiting a verdict while the substituted " +
+                        "outputs were being validated."
+                };
+            }
+        }
+        pending.settle({ verdict, decidedBy: "agent" });
+        return null;
+    }
+    close() {
+        this._closed = true;
+        this._pending?.settle(FAIL_CLOSED);
+    }
+}
+export class DebugSession {
+    id;
+    userId;
+    workflowId;
+    jobId;
+    _handle;
+    /** The run's own completion, raced with a forced settle. Never rejects. */
+    _done;
+    _cancel;
+    _cancelWaitMs;
+    _force = () => { };
+    _report = null;
+    constructor(options, onSettled) {
+        this.id = randomUUID();
+        this.userId = options.userId;
+        this.workflowId = options.workflowId;
+        this.jobId = options.jobId;
+        this._handle = options.handle;
+        this._cancel = options.cancel;
+        this._cancelWaitMs = options.cancelWaitMs ?? CANCEL_SETTLE_TIMEOUT_MS;
+        // A run that never settles must not hold the session — or its waiters —
+        // open forever, so every wait goes through this race rather than through
+        // the run's own promise.
+        const forced = new Promise((resolve) => {
+            this._force = resolve;
+        });
+        this._done = Promise.race([options.done, forced]);
+        void this._done.then((report) => {
+            this._report = report;
+            onSettled();
+        });
+    }
+    /** True until the run (or a forced settle) has produced a final report. */
+    isLive() {
+        return this._report === null;
+    }
+    /**
+     * Settle the session without the run: cancel what can be cancelled, fail the
+     * parked escalation closed, and hand every waiter a failed report. Used by
+     * the lifetime ceiling and by a cancel the run does not answer.
+     */
+    forceSettle(reason) {
+        try {
+            this._cancel();
+        }
+        catch (error) {
+            log.warn("cancel threw while force-settling a debug session", {
+                sessionId: this.id,
+                error: String(error)
+            });
+        }
+        this._handle.close();
+        this._force({
+            status: "failed",
+            error: reason,
+            job_id: this.jobId,
+            workflow_id: this.workflowId,
+            outputs: {}
+        });
+    }
+    /**
+     * Wait until the run either parks an escalation or settles. There is no
+     * wait cap of its own: the non-interactive endpoint awaits the whole run
+     * too, a parked decision fails closed on its own timeout, and the session's
+     * lifetime ceiling settles anything that outlives both.
+     */
+    async waitForEvent() {
+        const pending = this._handle.current();
+        if (pending) {
+            return {
+                kind: "escalated",
+                escalationId: pending.id,
+                escalation: pending.escalation
+            };
+        }
+        let unsubscribe = () => { };
+        try {
+            return await Promise.race([
+                this._done.then((report) => ({ kind: "done", report })),
+                new Promise((resolve) => {
+                    unsubscribe = this._handle.subscribe((entry) => resolve({
+                        kind: "escalated",
+                        escalationId: entry.id,
+                        escalation: entry.escalation
+                    }));
+                })
+            ]);
+        }
+        finally {
+            unsubscribe();
+        }
+    }
+    /** Current state without waiting. */
+    peek() {
+        if (this._report)
+            return { kind: "done", report: this._report };
+        const pending = this._handle.current();
+        if (pending) {
+            return {
+                kind: "escalated",
+                escalationId: pending.id,
+                escalation: pending.escalation
+            };
+        }
+        return { kind: "running" };
+    }
+    async submitVerdict(escalationId, verdict) {
+        if (this._report) {
+            return { error: "The run has already finished." };
+        }
+        return this._handle.submit(escalationId, verdict);
+    }
+    /**
+     * Cancel the run and return its final report. The wait is bounded: a run
+     * that ignores cancellation used to hang the cancel request itself, so past
+     * the deadline the session settles on its own and answers with that.
+     */
+    async cancel() {
+        try {
+            this._cancel();
+        }
+        catch (error) {
+            log.warn("cancel threw for a debug session", {
+                sessionId: this.id,
+                error: String(error)
+            });
+        }
+        let timer;
+        const deadline = new Promise((resolve) => {
+            timer = setTimeout(() => resolve("timeout"), this._cancelWaitMs);
+            timer.unref?.();
+        });
+        try {
+            const outcome = await Promise.race([this._done, deadline]);
+            if (outcome !== "timeout")
+                return outcome;
+        }
+        finally {
+            if (timer)
+                clearTimeout(timer);
+        }
+        this.forceSettle(`Cancel requested, but the run did not settle within ${this._cancelWaitMs}ms.`);
+        return this._done;
+    }
+}
+/** Thrown by `create()` when a user already holds the maximum live sessions. */
+export class TooManyDebugSessionsError extends Error {
+    constructor(limit) {
+        super(`Too many active debug sessions (limit ${limit}). Cancel or finish one ` +
+            "with POST /api/debug/sessions/:id/cancel before starting another.");
+        this.name = "TooManyDebugSessionsError";
+    }
+}
+class DebugSessionRegistry {
+    _sessions = new Map();
+    /** Live sessions this user holds. */
+    liveCount(userId) {
+        let count = 0;
+        for (const session of this._sessions.values()) {
+            if (session.userId === userId && session.isLive())
+                count += 1;
+        }
+        return count;
+    }
+    create(options) {
+        if (this.liveCount(options.userId) >= MAX_LIVE_SESSIONS_PER_USER) {
+            throw new TooManyDebugSessionsError(MAX_LIVE_SESSIONS_PER_USER);
+        }
+        const session = new DebugSession(options, () => {
+            clearTimeout(lifetime);
+            const timer = setTimeout(() => {
+                this._sessions.delete(session.id);
+            }, SESSION_DONE_TTL_MS);
+            timer.unref?.();
+        });
+        const lifetime = setTimeout(() => {
+            log.warn("debug session hit its lifetime ceiling", {
+                sessionId: session.id,
+                jobId: options.jobId
+            });
+            session.forceSettle("The run exceeded the maximum session lifetime and was force-settled.");
+        }, options.maxLifetimeMs ?? SESSION_MAX_LIFETIME_MS);
+        lifetime.unref?.();
+        this._sessions.set(session.id, session);
+        log.info("interactive debug session opened", {
+            sessionId: session.id,
+            jobId: options.jobId,
+            workflowId: options.workflowId
+        });
+        return session;
+    }
+    /** Ownership is part of the lookup: a foreign session id is a miss. */
+    get(sessionId, userId) {
+        const session = this._sessions.get(sessionId);
+        if (!session || session.userId !== userId)
+            return null;
+        return session;
+    }
+}
+export const debugSessions = new DebugSessionRegistry();
+//# sourceMappingURL=debug-sessions.js.map

package/dist/service/debug-sessions.js.map

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

package/dist/service/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `@nodetool-ai/execution/service` — workflow execution as a service.
+ *
+ * Everything the HTTP surface does *except* parse a Request and write a
+ * Response: running a saved workflow (plain, debug, or interactive), the
+ * in-memory escalation-session registry those interactive runs park in, the
+ * kernel runner every app simulation shares, and the app-debug engine.
+ *
+ * The websocket package keeps the Fastify routes and calls this. So do the
+ * agent tools — an agent runs a workflow in-process, never over HTTP.
+ */
+export { debugSessions, DebugSession, InteractiveEscalationHandle, TooManyDebugSessionsError, INTERACTIVE_DECISION_TIMEOUT_MS, SESSION_MAX_LIFETIME_MS, CANCEL_SETTLE_TIMEOUT_MS, MAX_LIVE_SESSIONS_PER_USER } from "./debug-sessions.js";
+export type { CreateDebugSessionOptions, DebugSessionEvent, ParkedEscalation } from "./debug-sessions.js";
+export { resolveWorkflowWorkspace, resolveWorkflowWorkspaceDir, workspaceFromRow, setWorkspaceCloudStorage, setWorkspaceChangeNotifier, usesCloudWorkspaces, buildWorkspaceExecutionContext } from "./workflow-workspace.js";
+export type { WorkspaceFileChange } from "./workflow-workspace.js";
+export { createAppServerRunner } from "./app-run-server.js";
+export type { AppServerRunnerOptions } from "./app-run-server.js";
+export { runWorkflow, peekDebugSession, submitEscalationVerdict, cancelDebugSession, buildWorkflowRunPayload, debugSessionEventPayload, boundedRunOption, persistableOutputs, withoutInlineAssetBytes, modelSelectionErrors, MAX_INTERACTIVE_DECISIONS, MAX_INTERACTIVE_RETRIES_PER_NODE, MAX_INTERACTIVE_DECISION_TIMEOUT_MS } from "./workflow-run.js";
+export type { RunModelCatalogs, RunWorkflowOptions, RunWorkflowOutcome, WorkflowRunEnvironment } from "./workflow-run.js";
+export { runApplicationDebug, AppServiceError } from "./app-debug-service.js";
+export type { AppDebugDeps, AppDebugRequest } from "./app-debug-service.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/service/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/service/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,aAAa,EACb,YAAY,EACZ,2BAA2B,EAC3B,yBAAyB,EACzB,+BAA+B,EAC/B,uBAAuB,EACvB,wBAAwB,EACxB,0BAA0B,EAC3B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,yBAAyB,EACzB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,gBAAgB,EAChB,wBAAwB,EACxB,0BAA0B,EAC1B,mBAAmB,EACnB,8BAA8B,EAC/B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACxB,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,yBAAyB,EACzB,gCAAgC,EAChC,mCAAmC,EACpC,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,mBAAmB,EACnB,eAAe,EAChB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/service/index.js

@@ -0,0 +1,17 @@
+/**
+ * `@nodetool-ai/execution/service` — workflow execution as a service.
+ *
+ * Everything the HTTP surface does *except* parse a Request and write a
+ * Response: running a saved workflow (plain, debug, or interactive), the
+ * in-memory escalation-session registry those interactive runs park in, the
+ * kernel runner every app simulation shares, and the app-debug engine.
+ *
+ * The websocket package keeps the Fastify routes and calls this. So do the
+ * agent tools — an agent runs a workflow in-process, never over HTTP.
+ */
+export { debugSessions, DebugSession, InteractiveEscalationHandle, TooManyDebugSessionsError, INTERACTIVE_DECISION_TIMEOUT_MS, SESSION_MAX_LIFETIME_MS, CANCEL_SETTLE_TIMEOUT_MS, MAX_LIVE_SESSIONS_PER_USER } from "./debug-sessions.js";
+export { resolveWorkflowWorkspace, resolveWorkflowWorkspaceDir, workspaceFromRow, setWorkspaceCloudStorage, setWorkspaceChangeNotifier, usesCloudWorkspaces, buildWorkspaceExecutionContext } from "./workflow-workspace.js";
+export { createAppServerRunner } from "./app-run-server.js";
+export { runWorkflow, peekDebugSession, submitEscalationVerdict, cancelDebugSession, buildWorkflowRunPayload, debugSessionEventPayload, boundedRunOption, persistableOutputs, withoutInlineAssetBytes, modelSelectionErrors, MAX_INTERACTIVE_DECISIONS, MAX_INTERACTIVE_RETRIES_PER_NODE, MAX_INTERACTIVE_DECISION_TIMEOUT_MS } from "./workflow-run.js";
+export { runApplicationDebug, AppServiceError } from "./app-debug-service.js";
+//# sourceMappingURL=index.js.map

package/dist/service/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/service/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,aAAa,EACb,YAAY,EACZ,2BAA2B,EAC3B,yBAAyB,EACzB,+BAA+B,EAC/B,uBAAuB,EACvB,wBAAwB,EACxB,0BAA0B,EAC3B,MAAM,qBAAqB,CAAC;AAO7B,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,gBAAgB,EAChB,wBAAwB,EACxB,0BAA0B,EAC1B,mBAAmB,EACnB,8BAA8B,EAC/B,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACxB,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,yBAAyB,EACzB,gCAAgC,EAChC,mCAAmC,EACpC,MAAM,mBAAmB,CAAC;AAQ3B,OAAO,EACL,mBAAmB,EACnB,eAAe,EAChB,MAAM,wBAAwB,CAAC"}

package/dist/service/job-progress.d.ts

@@ -0,0 +1,40 @@
+import type { ProcessingMessage } from "@nodetool-ai/protocol";
+/**
+ * Job progress on the job row.
+ *
+ * A node posts `node_progress` while it works — a render posts one per frame —
+ * and until now that message reached only the debug collector, which exists
+ * for a finished run. So `get_job` on a background render in its third minute
+ * answered "running" and nothing else, which is exactly the moment the caller
+ * needs a number. This folds the latest message onto the row.
+ *
+ * Throttled, because a 25fps two-minute render posts three thousand of them
+ * and each write is a database round trip: at most one write every
+ * `minIntervalMs`, with a jump of `minPercentStep` or the final frame going
+ * through immediately.
+ */
+/** The shape read off a `node_progress` message. */
+export interface JobProgress {
+    node_id: string;
+    progress: number;
+    total: number;
+    updated_at: string;
+}
+export interface JobProgressRecorderOptions {
+    /** Persist one progress value. Rejections are swallowed, not thrown. */
+    write: (progress: JobProgress) => Promise<void>;
+    /** Injected so the throttle is tested against a clock rather than a wait. */
+    now?: () => number;
+    minIntervalMs?: number;
+    /** Percent of `total` that goes through regardless of the interval. */
+    minPercentStep?: number;
+}
+/**
+ * A message listener that keeps the job row's progress current.
+ *
+ * Synchronous on purpose: it is called from the message bus, so it starts the
+ * write and returns. A write that fails is dropped — progress is a courtesy,
+ * and a database blip must not fail the run it is reporting on.
+ */
+export declare function createJobProgressRecorder(options: JobProgressRecorderOptions): (message: ProcessingMessage) => void;
+//# sourceMappingURL=job-progress.d.ts.map

package/dist/service/job-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-progress.d.ts","sourceRoot":"","sources":["../../src/service/job-progress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D;;;;;;;;;;;;;GAaG;AAEH,oDAAoD;AACpD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,wEAAwE;IACxE,KAAK,EAAE,CAAC,QAAQ,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,6EAA6E;IAC7E,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AASD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,0BAA0B,GAClC,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,CA0CtC"}

package/dist/service/job-progress.js

@@ -0,0 +1,53 @@
+const DEFAULT_MIN_INTERVAL_MS = 2000;
+const DEFAULT_MIN_PERCENT_STEP = 5;
+function num(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+/**
+ * A message listener that keeps the job row's progress current.
+ *
+ * Synchronous on purpose: it is called from the message bus, so it starts the
+ * write and returns. A write that fails is dropped — progress is a courtesy,
+ * and a database blip must not fail the run it is reporting on.
+ */
+export function createJobProgressRecorder(options) {
+    const now = options.now ?? Date.now;
+    const minIntervalMs = options.minIntervalMs ?? DEFAULT_MIN_INTERVAL_MS;
+    const minPercentStep = options.minPercentStep ?? DEFAULT_MIN_PERCENT_STEP;
+    let lastWriteAt = Number.NEGATIVE_INFINITY;
+    let lastProgress = null;
+    return (message) => {
+        if (message.type !== "node_progress")
+            return;
+        const nodeId = message.node_id;
+        const progress = num(message.progress);
+        const total = num(message.total);
+        if (typeof nodeId !== "string" || progress === null || total === null) {
+            return;
+        }
+        const at = now();
+        const stepPercent = total > 0 && lastProgress !== null
+            ? ((progress - lastProgress) / total) * 100
+            : Number.POSITIVE_INFINITY;
+        const finished = total > 0 && progress >= total;
+        const due = lastProgress === null ||
+            finished ||
+            at - lastWriteAt >= minIntervalMs ||
+            stepPercent >= minPercentStep;
+        if (!due)
+            return;
+        lastWriteAt = at;
+        lastProgress = progress;
+        void options
+            .write({
+            node_id: nodeId,
+            progress,
+            total,
+            updated_at: new Date(at).toISOString()
+        })
+            .catch(() => {
+            // Progress is a courtesy: a failed write must not fail the run.
+        });
+    };
+}
+//# sourceMappingURL=job-progress.js.map

package/dist/service/job-progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-progress.js","sourceRoot":"","sources":["../../src/service/job-progress.ts"],"names":[],"mappings":"AAmCA,MAAM,uBAAuB,GAAG,IAAI,CAAC;AACrC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAEnC,SAAS,GAAG,CAAC,KAAc;IACzB,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAAmC;IAEnC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACpC,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,uBAAuB,CAAC;IACvE,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,wBAAwB,CAAC;IAC1E,IAAI,WAAW,GAAG,MAAM,CAAC,iBAAiB,CAAC;IAC3C,IAAI,YAAY,GAAkB,IAAI,CAAC;IAEvC,OAAO,CAAC,OAA0B,EAAQ,EAAE;QAC1C,IAAI,OAAO,CAAC,IAAI,KAAK,eAAe;YAAE,OAAO;QAC7C,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACtE,OAAO;QACT,CAAC;QAED,MAAM,EAAE,GAAG,GAAG,EAAE,CAAC;QACjB,MAAM,WAAW,GACf,KAAK,GAAG,CAAC,IAAI,YAAY,KAAK,IAAI;YAChC,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,YAAY,CAAC,GAAG,KAAK,CAAC,GAAG,GAAG;YAC3C,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC;QAC/B,MAAM,QAAQ,GAAG,KAAK,GAAG,CAAC,IAAI,QAAQ,IAAI,KAAK,CAAC;QAChD,MAAM,GAAG,GACP,YAAY,KAAK,IAAI;YACrB,QAAQ;YACR,EAAE,GAAG,WAAW,IAAI,aAAa;YACjC,WAAW,IAAI,cAAc,CAAC;QAChC,IAAI,CAAC,GAAG;YAAE,OAAO;QAEjB,WAAW,GAAG,EAAE,CAAC;QACjB,YAAY,GAAG,QAAQ,CAAC;QACxB,KAAK,OAAO;aACT,KAAK,CAAC;YACL,OAAO,EAAE,MAAM;YACf,QAAQ;YACR,KAAK;YACL,UAAU,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE;SACvC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE;YACV,gEAAgE;QAClE,CAAC,CAAC,CAAC;IACP,CAAC,CAAC;AACJ,CAAC"}