@tscomfy/client 0.0.0-stage → 0.1.2

package/dist/job.js

@@ -0,0 +1,481 @@
+import { createDiagnostic, stringify, toApi, } from "@tscomfy/core";
+import { channelOf } from "./channel.js";
+import { ClientError } from "./client-error.js";
+import { EventQueue } from "./event-queue.js";
+import { isList, isObject, readObject, send, unexpected } from "./http.js";
+import { nodeIdOf, outputsInOrder, readNodeOutput } from "./read-outputs.js";
+import { serverDiagnostics } from "./server-errors.js";
+import { sleep } from "./timers.js";
+import { randomUuid } from "./uuid.js";
+/**
+ * Submits a workflow, or a prompt, to run on the server. A workflow is exported with `toApi`,
+ * which validates it and throws a `ValidationError` for errors (D21); a prompt is sent as given.
+ * The job is registered under a prompt id the client mints before anything is sent, so no event
+ * is missed. Throws a `TypeError` for invalid options or a closed connection.
+ */
+export function submit(connection, input, options = {}) {
+    const channel = channelOf(connection);
+    if (channel.closed)
+        throw new TypeError("submit: the connection is closed");
+    const prompt = isWorkflow(input) ? toApi(input) : input;
+    const body = requestBody(channel.clientId, prompt, options);
+    const run = new JobRun(channel, body.id, Object.keys(prompt), options.signal);
+    run.start(body.text);
+    return run.job;
+}
+/** A workflow has a schema and a graph of nodes; a prompt's entries are nodes with a class. */
+function isWorkflow(input) {
+    const graph = Reflect.get(input, "graph");
+    const nodes = typeof graph === "object" && graph !== null ? Reflect.get(graph, "nodes") : undefined;
+    return (Reflect.has(input, "schema") &&
+        typeof nodes === "object" &&
+        nodes !== null &&
+        typeof Reflect.get(nodes, "get") === "function");
+}
+const PREVIEW_METHODS = new Set(["auto", "latent2rgb", "taesd", "none"]);
+const RESERVED_EXTRA_DATA = ["client_id", "preview_method"];
+/** The body of `POST /prompt`, serialized losslessly, and the prompt id it carries. */
+function requestBody(clientId, prompt, options) {
+    if (options.previews !== undefined && !PREVIEW_METHODS.has(options.previews)) {
+        throw new TypeError(`submit: unknown preview method ${options.previews}`);
+    }
+    const extra = options.extraData ?? {};
+    for (const key of RESERVED_EXTRA_DATA) {
+        if (Object.hasOwn(extra, key))
+            throw new TypeError(`submit: extraData can't set ${key}`);
+    }
+    const id = randomUuid();
+    const body = {
+        client_id: clientId,
+        prompt_id: id,
+        prompt,
+        extra_data: {
+            ...extra,
+            ...(options.previews === undefined ? {} : { preview_method: options.previews }),
+        },
+        ...(options.front === true ? { front: true } : {}),
+        ...(options.targets === undefined
+            ? {}
+            : { partial_execution_targets: options.targets.map(nodeIdOf) }),
+    };
+    return { id, text: stringify(body) };
+}
+/** How often to poll the job record after a reconnect, when events may be lost for good. */
+const POLL_MS = [1000, 2000, 5000, 10_000];
+/** At most one record read per this many milliseconds on queue changes. */
+const QUEUE_CHECK_MS = 1000;
+/** Retries of a record read that couldn't reach the server. */
+const READ_RETRY_MS = [500, 1000, 2000, 4000, 8000];
+/** One job: its events, its record reads and its outcome. */
+class JobRun {
+    id;
+    job;
+    #channel;
+    #order;
+    #signal;
+    #events = new EventQueue();
+    #diagnostics = [];
+    #outputs = new Map();
+    /** The node a server node id is displayed as (they differ for nodes expanded at run time). */
+    #display = new Map();
+    #progress = new Map();
+    #accepted;
+    #accept = () => undefined;
+    #resolve = () => undefined;
+    #reject = () => undefined;
+    #settled = false;
+    #started = false;
+    #reading = false;
+    #readAgain = false;
+    #lastQueueCheck = 0;
+    #queueCheck;
+    #poll;
+    /** Aborted when the job settles: ends its waits, so no timer outlives it. */
+    #done = new AbortController();
+    #abort = () => {
+        this.#abandon(this.#signal?.reason);
+    };
+    constructor(channel, id, order, signal) {
+        this.#channel = channel;
+        this.id = id;
+        this.#order = order;
+        this.#signal = signal;
+        this.#accepted = new Promise((resolve) => {
+            this.#accept = resolve;
+        });
+        const outcome = new Promise((resolve, reject) => {
+            this.#resolve = resolve;
+            this.#reject = reject;
+        });
+        // Handled here so a rejection nobody awaits doesn't crash the process; awaiting still throws.
+        outcome.catch(() => undefined);
+        this.job = Object.freeze({
+            id,
+            events: this.#events,
+            outcome,
+            cancel: () => this.#cancel(),
+        });
+    }
+    start(body) {
+        if (this.#signal?.aborted === true) {
+            this.#abandon(this.#signal.reason);
+            return;
+        }
+        this.#signal?.addEventListener("abort", this.#abort, { once: true });
+        void this.#post(body);
+    }
+    async #post(body) {
+        try {
+            await this.#channel.ready(this.#signal);
+            if (this.#settled) {
+                this.#accept(false);
+                return;
+            }
+            this.#channel.register(this);
+            // Not abortable: once sent, the prompt may be queued, and only its answer says so. An
+            // abort meanwhile cancels the job after the answer (`#abandon`).
+            const response = await send(this.#channel.server, { method: "POST", path: "prompt", body });
+            if (response.status === 200) {
+                // Queued: from here on the job can be cancelled, whatever the body says.
+                this.#accept(true);
+                const answer = await readObject(response).catch(() => undefined);
+                const id = answer?.["prompt_id"];
+                if (typeof id === "string" && id !== this.id) {
+                    // A server or proxy that ignores the client's id: the record would never be found.
+                    void cancelJob(this.#channel.server, id);
+                    throw new ClientError(`The server queued the prompt as ${id}, not as the id the client chose (${this.id})`);
+                }
+                this.#diagnostics.push(...serverDiagnostics(undefined, answer?.["node_errors"]));
+                return;
+            }
+            if (response.status === 400) {
+                const answer = await readObject(response);
+                this.#accept(false);
+                this.#settle({
+                    status: "rejected",
+                    diagnostics: serverDiagnostics(answer["error"] ?? "", answer["node_errors"]),
+                });
+                return;
+            }
+            throw await unexpected(response);
+        }
+        catch (error) {
+            this.#accept(false);
+            this.fail(error);
+        }
+    }
+    message(type, data) {
+        if (this.#settled)
+            return;
+        switch (type) {
+            case "execution_start":
+                this.#started = true;
+                this.#events.push({ type: "started" });
+                return;
+            case "execution_cached":
+                this.#started = true;
+                this.#events.push({ type: "cached", nodes: Object.freeze(strings(data["nodes"])) });
+                return;
+            case "executing": {
+                const node = data["display_node"] ?? data["node"];
+                if (node === null) {
+                    this.#read();
+                }
+                else if (typeof node === "string") {
+                    this.#events.push({ type: "executing", node });
+                }
+                return;
+            }
+            case "progress_state":
+                this.#progressState(data["nodes"]);
+                return;
+            case "executed":
+                this.#executed(data);
+                return;
+            case "execution_error":
+                this.#executionError(data);
+                return;
+            default:
+                // execution_success, execution_interrupted: the record decides, read on the final
+                // `executing`. Anything else isn't ours to interpret.
+                return;
+        }
+    }
+    frame(frame) {
+        if (this.#settled)
+            return;
+        const node = this.#display.get(frame.node) ?? frame.node;
+        if (frame.kind === "preview") {
+            this.#events.push({ type: "preview", node, mime: frame.mime, bytes: frame.bytes });
+        }
+        else {
+            this.#events.push({ type: "text", node, text: frame.text });
+        }
+    }
+    queueChanged() {
+        // A job cancelled while queued sends no event; the record shows it.
+        if (this.#started || this.#settled)
+            return;
+        // At most one read per interval; a change inside it is read at its end, not dropped.
+        if (this.#queueCheck !== undefined)
+            return;
+        const wait = this.#lastQueueCheck + QUEUE_CHECK_MS - Date.now();
+        this.#queueCheck = setTimeout(() => {
+            this.#queueCheck = undefined;
+            this.#lastQueueCheck = Date.now();
+            this.#read();
+        }, Math.max(0, wait));
+    }
+    reconnected() {
+        // Events sent while the socket was down are gone, and a reconnect can leave the server
+        // sending none (two sockets with one id): poll the record until the job settles.
+        this.#read();
+        if (this.#poll === undefined)
+            this.#schedulePoll(0);
+    }
+    fail(error) {
+        if (this.#settled)
+            return;
+        this.#finish();
+        this.#reject(error);
+    }
+    #progressState(nodes) {
+        if (!isObject(nodes))
+            return;
+        for (const [key, entry] of Object.entries(nodes)) {
+            if (!isObject(entry))
+                continue;
+            const { value, max } = entry;
+            const display = entry["display_node_id"] ?? entry["node_id"] ?? key;
+            if (typeof value !== "number" || typeof max !== "number" || typeof display !== "string") {
+                continue;
+            }
+            const seen = `${String(value)}/${String(max)}`;
+            if (this.#progress.get(display) === seen)
+                continue;
+            this.#progress.set(display, seen);
+            this.#events.push({ type: "progress", node: display, value, max });
+        }
+    }
+    #executed(data) {
+        const node = data["node"];
+        const display = data["display_node"] ?? node;
+        if (typeof node !== "string" || typeof display !== "string")
+            return;
+        this.#display.set(node, display);
+        // A cached node without UI output reports `null`.
+        if (!isObject(data["output"]))
+            return;
+        const output = readNodeOutput(display, data["output"]);
+        this.#outputs.set(display, output);
+        this.#events.push({ type: "output", node: display, output });
+    }
+    #executionError(data) {
+        // Only a blocked node is reported here; a real error ends the run, and the record has it.
+        if (data["exception_type"] !== "ExecutionBlocked")
+            return;
+        const node = data["node_id"];
+        if (typeof node !== "string")
+            return;
+        const reported = data["exception_message"];
+        const message = typeof reported === "string" ? reported : "Execution blocked";
+        this.#diagnostics.push(createDiagnostic("W_NODE_BLOCKED", [node], message));
+        this.#events.push({ type: "blocked", node, message });
+    }
+    /** Reads the job record and settles from it; one read at a time, again if asked meanwhile. */
+    #read() {
+        if (this.#settled)
+            return;
+        if (this.#reading) {
+            this.#readAgain = true;
+            return;
+        }
+        this.#reading = true;
+        void this.#readRecord()
+            .catch((error) => {
+            this.fail(error);
+        })
+            .finally(() => {
+            this.#reading = false;
+            if (this.#readAgain && !this.#settled) {
+                this.#readAgain = false;
+                this.#read();
+            }
+        });
+    }
+    async #readRecord() {
+        if (!(await this.#accepted) || this.#settled)
+            return;
+        const response = await this.#retried(() => send(this.#channel.server, { method: "GET", path: `api/jobs/${this.id}` }));
+        // Settled meanwhile (aborted, closed): the answer comes too late.
+        if (this.#isSettled())
+            return;
+        if (response.status === 404) {
+            // An unknown job: cancelled while it was queued. A server without the job API answers
+            // with a 404 that isn't JSON.
+            const answer = await readObject(response).catch(() => undefined);
+            if (answer === undefined)
+                throw await unexpected(response);
+            if (this.#started) {
+                // It ran, and its record is gone: the server restarted, or its history moved on.
+                throw new ClientError(`The server has no record of job ${this.id} any more (restarted?); its outcome is unknown`, { status: 404 });
+            }
+            this.#settle({ status: "cancelled", outputs: this.#liveOutputs(), diagnostics: [] });
+            return;
+        }
+        if (!response.ok)
+            throw await unexpected(response);
+        const record = await readObject(response);
+        const status = record["status"];
+        if (status === "pending" || status === "in_progress")
+            return;
+        if (status === "completed") {
+            this.#settle({ status: "success", outputs: this.#recordOutputs(record), diagnostics: [] });
+        }
+        else if (status === "failed") {
+            this.#settle({
+                status: "failed",
+                error: executionError(record["execution_error"]),
+                outputs: this.#recordOutputs(record),
+                diagnostics: [],
+            });
+        }
+        else if (status === "cancelled") {
+            this.#settle({ status: "cancelled", outputs: this.#recordOutputs(record), diagnostics: [] });
+        }
+        else {
+            throw new ClientError(`The server reported job status ${stringify(status ?? null)}`);
+        }
+    }
+    #isSettled() {
+        return this.#settled;
+    }
+    /** Retries a request that couldn't reach the server, a few times, with growing waits. */
+    async #retried(request) {
+        for (const delay of READ_RETRY_MS) {
+            try {
+                // oxlint-disable-next-line no-await-in-loop -- retries are sequential, with growing waits
+                return await request();
+            }
+            catch (error) {
+                if (!(error instanceof ClientError) || this.#settled)
+                    throw error;
+                // oxlint-disable-next-line no-await-in-loop -- retries are sequential, with growing waits
+                await sleep(delay, this.#done.signal);
+                // Settled meanwhile: no more requests; the error goes nowhere.
+                if (this.#isSettled())
+                    throw error;
+            }
+        }
+        return request();
+    }
+    /**
+     * The record's outputs, by the nodes they are displayed as, in prompt order. A node whose
+     * output the client saw live keeps that one: the record rewrites some entries (any string
+     * with a 3D file extension becomes a file, `text` included), the live output is as the node
+     * reported it.
+     */
+    #recordOutputs(record) {
+        const outputs = new Map();
+        const recorded = record["outputs"];
+        if (isObject(recorded)) {
+            for (const [id, ui] of Object.entries(recorded)) {
+                if (!isObject(ui))
+                    continue;
+                const node = this.#display.get(id) ?? id;
+                outputs.set(node, this.#outputs.get(node) ?? readNodeOutput(node, ui));
+            }
+        }
+        return outputsInOrder(outputs, this.#order);
+    }
+    #liveOutputs() {
+        return outputsInOrder(this.#outputs, this.#order);
+    }
+    #settle(outcome) {
+        if (this.#settled)
+            return;
+        this.#finish();
+        const diagnostics = Object.freeze([...this.#diagnostics, ...outcome.diagnostics]);
+        this.#resolve(Object.freeze({ ...outcome, diagnostics }));
+    }
+    #finish() {
+        this.#settled = true;
+        this.#done.abort();
+        this.#signal?.removeEventListener("abort", this.#abort);
+        if (this.#poll !== undefined)
+            clearTimeout(this.#poll);
+        if (this.#queueCheck !== undefined)
+            clearTimeout(this.#queueCheck);
+        this.#channel.unregister(this);
+        this.#events.end();
+    }
+    #schedulePoll(step) {
+        if (this.#poll !== undefined)
+            clearTimeout(this.#poll);
+        if (this.#settled)
+            return;
+        const delay = POLL_MS[Math.min(step, POLL_MS.length - 1)] ?? 10_000;
+        this.#poll = setTimeout(() => {
+            this.#read();
+            this.#schedulePoll(step + 1);
+        }, delay);
+    }
+    async #cancel() {
+        if (this.#settled || !(await this.#accepted))
+            return;
+        const response = await send(this.#channel.server, {
+            method: "POST",
+            path: `api/jobs/${this.id}/cancel`,
+            body: "{}",
+        });
+        if (!response.ok)
+            throw await unexpected(response);
+        await response.body?.cancel();
+        this.#read();
+    }
+    /** The caller gave up: cancel on the server, best effort, and reject with the reason. */
+    #abandon(reason) {
+        if (this.#settled)
+            return;
+        const accepted = this.#accepted;
+        const server = this.#channel.server;
+        const id = this.id;
+        this.fail(reason);
+        void accepted.then((wasAccepted) => (wasAccepted ? cancelJob(server, id) : undefined));
+    }
+}
+/** Asks the server to cancel a job, best effort: for a caller who has already given up. */
+async function cancelJob(server, id) {
+    try {
+        const response = await send(server, {
+            method: "POST",
+            path: `api/jobs/${id}/cancel`,
+            body: "{}",
+        });
+        await response.body?.cancel();
+    }
+    catch {
+        // Nobody is left to tell.
+    }
+}
+/** The strings of a JSON list. */
+function strings(value) {
+    return isList(value) ? value.filter((item) => typeof item === "string") : [];
+}
+/** The record's `execution_error`, read leniently. */
+function executionError(value) {
+    const error = isObject(value) ? value : {};
+    const text = (key) => {
+        const item = error[key];
+        return typeof item === "string" ? item : "";
+    };
+    return Object.freeze({
+        node: text("node_id"),
+        classType: text("node_type"),
+        exceptionType: text("exception_type"),
+        message: text("exception_message"),
+        traceback: Object.freeze(strings(error["traceback"])),
+        executed: Object.freeze(strings(error["executed"])),
+    });
+}
+//# sourceMappingURL=job.js.map

package/dist/job.js.map

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

package/dist/outcome.d.ts

@@ -0,0 +1,47 @@
+import type { Diagnostic, NodeId } from "@tscomfy/core";
+import type { Outputs } from "./outputs.ts";
+/** The job ran to the end. Outputs left out by a partial acceptance are in `diagnostics`. */
+export interface SuccessOutcome {
+    readonly status: "success";
+    readonly outputs: Outputs;
+    /**
+     * `E_SERVER_VALIDATION` for outputs the server refused while running the others, and
+     * `W_NODE_BLOCKED` for nodes that blocked execution.
+     */
+    readonly diagnostics: readonly Diagnostic[];
+}
+/** The server refused the prompt: nothing ran. */
+export interface RejectedOutcome {
+    readonly status: "rejected";
+    /** `E_PROMPT_REJECTED` for the server's error, and `E_SERVER_VALIDATION` for each node error. */
+    readonly diagnostics: readonly Diagnostic[];
+}
+/** A node raised an error; the run stopped there. */
+export interface FailedOutcome {
+    readonly status: "failed";
+    readonly error: ExecutionError;
+    /** What the nodes that finished before the error reported. */
+    readonly outputs: Outputs;
+    readonly diagnostics: readonly Diagnostic[];
+}
+/** The job was cancelled or interrupted, by this client or another. */
+export interface CancelledOutcome {
+    readonly status: "cancelled";
+    /** What the nodes that finished before the cancel reported. */
+    readonly outputs: Outputs;
+    readonly diagnostics: readonly Diagnostic[];
+}
+/** How a job ended, as the server's record of it says. */
+export type Outcome = SuccessOutcome | RejectedOutcome | FailedOutcome | CancelledOutcome;
+/** The error a node raised. */
+export interface ExecutionError {
+    readonly node: NodeId;
+    readonly classType: string;
+    /** The exception's class, qualified: `torch.OutOfMemoryError`, `ValueError`. */
+    readonly exceptionType: string;
+    readonly message: string;
+    readonly traceback: readonly string[];
+    /** The nodes that had finished. */
+    readonly executed: readonly NodeId[];
+}
+//# sourceMappingURL=outcome.d.ts.map

package/dist/outcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outcome.d.ts","sourceRoot":"","sources":["../src/outcome.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,6FAA6F;AAC7F,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;CAC7C;AAED,kDAAkD;AAClD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,iGAAiG;IACjG,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;CAC7C;AAED,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;CAC7C;AAED,uEAAuE;AACvE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;CAC7C;AAED,0DAA0D;AAC1D,MAAM,MAAM,OAAO,GAAG,cAAc,GAAG,eAAe,GAAG,aAAa,GAAG,gBAAgB,CAAC;AAE1F,+BAA+B;AAC/B,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,gFAAgF;IAChF,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,mCAAmC;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC"}

package/dist/outcome.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=outcome.js.map

package/dist/outcome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outcome.js","sourceRoot":"","sources":["../src/outcome.ts"],"names":[],"mappings":""}

package/dist/outputs.d.ts

@@ -0,0 +1,53 @@
+import type { NodeHandle, NodeId, JsonObject, Out } from "@tscomfy/core";
+import type { Outcome } from "./outcome.ts";
+/** Which of the server's folders a file is in. */
+export type FolderType = "output" | "temp" | "input";
+/** A file on the server, as outputs name it and `/view` serves it. */
+export interface FileRef {
+    readonly filename: string;
+    /** The folder under {@link FileRef.type}'s directory; `""` for none. */
+    readonly subfolder: string;
+    readonly type: FolderType;
+}
+/** What a file holds, from the server's metadata, the file's extension, or its output key. */
+export type FileKind = "image" | "video" | "audio" | "3d" | "file";
+/** A file a node produced. */
+export interface OutputFile extends FileRef {
+    readonly kind: FileKind;
+    /**
+     * The node marked its images animated. Animated WEBP and PNG stay `image`; core's video nodes
+     * report their files under `images` with this flag, and their kind is `video`.
+     */
+    readonly animated: boolean;
+    /** The key of the node's UI output it was listed under: `images`, `audio`, `3d`, `gifs`, … */
+    readonly key: string;
+    /** Pixels, when the server measured the file. */
+    readonly width?: number;
+    readonly height?: number;
+}
+/** What one node reported when it ran: its files, its text, and the raw record. */
+export interface NodeOutput {
+    /** The node, by its id in the prompt (the builder's id for tscomfy workflows). */
+    readonly node: NodeId;
+    /** Every file entry under any key, in the order the node listed them. */
+    readonly files: readonly OutputFile[];
+    /** The strings under `text` (PreviewAny, text previews). */
+    readonly text: readonly string[];
+    /** The node's UI output as the server sent it: lists by key. */
+    readonly ui: JsonObject;
+}
+/** Every node's output, by node id, in prompt order. */
+export type Outputs = ReadonlyMap<NodeId, NodeOutput>;
+/** A node: its id, its handle (`n.SaveImage(…)`), or one of its outputs. */
+export type NodeRef = NodeId | NodeHandle | Out<string>;
+/**
+ * What a node (by id, handle or output) reported, or `undefined` when it reported nothing, didn't
+ * run, or the job was rejected.
+ */
+export declare function outputOf(outcome: Outcome, node: NodeRef): NodeOutput | undefined;
+/**
+ * The files of the given nodes (by id, handle or output), or of every node when none is given, in
+ * prompt order. Empty for a rejected job, which has no outputs.
+ */
+export declare function outputFiles(outcome: Outcome, ...nodes: readonly NodeRef[]): readonly OutputFile[];
+//# sourceMappingURL=outputs.d.ts.map

package/dist/outputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outputs.d.ts","sourceRoot":"","sources":["../src/outputs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG5C,kDAAkD;AAClD,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAErD,sEAAsE;AACtE,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,wEAAwE;IACxE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC3B;AAED,8FAA8F;AAC9F,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,CAAC;AAEnE,8BAA8B;AAC9B,MAAM,WAAW,UAAW,SAAQ,OAAO;IACzC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,8FAA8F;IAC9F,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,mFAAmF;AACnF,MAAM,WAAW,UAAU;IACzB,kFAAkF;IAClF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;IACtC,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,gEAAgE;IAChE,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;CACzB;AAED,wDAAwD;AACxD,MAAM,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAEtD,4EAA4E;AAC5E,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;AAExD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAEhF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,UAAU,EAAE,CAKjG"}

package/dist/outputs.js

@@ -0,0 +1,21 @@
+import { nodeIdOf } from "./read-outputs.js";
+/**
+ * What a node (by id, handle or output) reported, or `undefined` when it reported nothing, didn't
+ * run, or the job was rejected.
+ */
+export function outputOf(outcome, node) {
+    return outcome.status === "rejected" ? undefined : outcome.outputs.get(nodeIdOf(node));
+}
+/**
+ * The files of the given nodes (by id, handle or output), or of every node when none is given, in
+ * prompt order. Empty for a rejected job, which has no outputs.
+ */
+export function outputFiles(outcome, ...nodes) {
+    if (outcome.status === "rejected")
+        return [];
+    const outputs = outcome.outputs;
+    if (nodes.length === 0)
+        return [...outputs.values()].flatMap((output) => output.files);
+    return nodes.flatMap((node) => outputs.get(nodeIdOf(node))?.files ?? []);
+}
+//# sourceMappingURL=outputs.js.map

package/dist/outputs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outputs.js","sourceRoot":"","sources":["../src/outputs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAiD7C;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAgB,EAAE,IAAa;IACtD,OAAO,OAAO,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AACzF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAgB,EAAE,GAAG,KAAyB;IACxE,IAAI,OAAO,CAAC,MAAM,KAAK,UAAU;QAAE,OAAO,EAAE,CAAC;IAC7C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAChC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvF,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;AAC3E,CAAC"}