comfyui-node 1.5.0 → 1.6.1

package/dist/multipool/multi-workflow-pool.js

@@ -0,0 +1,73 @@
+import { ClientRegistry } from "src/multipool/client-registry.js";
+import { PoolEventManager } from "src/multipool/pool-event-manager.js";
+import { JobStateRegistry } from "src/multipool/tests/job-state-registry.js";
+import { JobQueueProcessor } from "src/multipool/job-queue-processor.js";
+/**
+ * MultiWorkflowPool class to manage heterogeneous clusters of ComfyUI workers with different workflow capabilities.
+ * Using a fully event driven architecture to handle client connections, job submissions, and failover strategies.
+ * Zero polling is used; all operations are event driven. Maximizes responsiveness and scalability.
+ */
+export class MultiWorkflowPool {
+    // Event manager for handling pool events
+    events;
+    // Registry for managing clients in the pool
+    clientRegistry;
+    // Registry for managing job state
+    jobRegistry;
+    // Multi queue map, one per workflow based on the workflow hash
+    queues = new Map();
+    constructor() {
+        this.events = new PoolEventManager(this);
+        this.clientRegistry = new ClientRegistry(this);
+        this.jobRegistry = new JobStateRegistry(this);
+    }
+    // PUBLIC API
+    async init() {
+    }
+    async shutdown() {
+    }
+    addClient(clientUrl) {
+        this.clientRegistry.addClient(clientUrl);
+    }
+    removeClient(clientUrl) {
+        this.clientRegistry.removeClient(clientUrl);
+    }
+    async submitJob(workflow) {
+        let workflowHash = workflow.structureHash;
+        if (!workflowHash) {
+            workflow.updateHash();
+            workflowHash = workflow.structureHash;
+        }
+        const queue = this.assertQueue(workflowHash);
+        if (!queue) {
+            throw new Error("Failed to create or retrieve job queue for workflow.");
+        }
+        const newJobId = this.jobRegistry.addJob(workflow);
+        queue.enqueueJob(newJobId, workflow);
+        return newJobId;
+    }
+    getJobStatus(jobId) {
+        return this.jobRegistry.getJobStatus(jobId);
+    }
+    async cancelJob(jobId) {
+        this.jobRegistry.cancelJob(jobId);
+    }
+    attachEventHook(event, listener) {
+        if (event && listener) {
+            this.events.attachHook(event, listener);
+        }
+    }
+    // PRIVATE METHODS
+    assertQueue(workflowHash) {
+        if (!workflowHash) {
+            return null;
+        }
+        let queue = this.queues.get(workflowHash);
+        if (!queue) {
+            queue = new JobQueueProcessor(this);
+            this.queues.set(workflowHash, queue);
+        }
+        return queue;
+    }
+}
+//# sourceMappingURL=multi-workflow-pool.js.map

package/dist/multipool/multi-workflow-pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-workflow-pool.js","sourceRoot":"","sources":["../../src/multipool/multi-workflow-pool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAIzE;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IAE5B,yCAAyC;IACjC,MAAM,CAAmB;IAEjC,4CAA4C;IACpC,cAAc,CAAiB;IAEvC,kCAAkC;IAC1B,WAAW,CAAmB;IAEtC,+DAA+D;IACvD,MAAM,GAAmC,IAAI,GAAG,EAAE,CAAC;IAE3D;QACE,IAAI,CAAC,MAAM,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,cAAc,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,CAAC,WAAW,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,aAAa;IACb,KAAK,CAAC,IAAI;IACV,CAAC;IAED,KAAK,CAAC,QAAQ;IACd,CAAC;IAED,SAAS,CAAC,SAAiB;QACzB,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC;IAED,YAAY,CAAC,SAAiB;QAC5B,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,QAAkB;QAChC,IAAI,YAAY,GAAG,QAAQ,CAAC,aAAa,CAAC;QAC1C,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,QAAQ,CAAC,UAAU,EAAE,CAAC;YACtB,YAAY,GAAG,QAAQ,CAAC,aAAa,CAAC;QACxC,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACnD,KAAK,CAAC,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACrC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,YAAY,CAAC,KAAa;QACxB,OAAO,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAa;QAC3B,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,eAAe,CAAC,KAAa,EAAE,QAAgC;QAC7D,IAAI,KAAK,IAAI,QAAQ,EAAE,CAAC;YACtB,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,kBAAkB;IACV,WAAW,CAAC,YAAgC;QAClD,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC;YACpC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/multipool/pool-event-manager.d.ts

@@ -0,0 +1,11 @@
+import { MultiWorkflowPool } from "src/multipool/multi-workflow-pool.js";
+import { PoolEvent } from "src/multipool/interfaces.js";
+export declare class PoolEventManager {
+    pool: MultiWorkflowPool;
+    hooks: Map<string, Array<Function>>;
+    constructor(pool: MultiWorkflowPool);
+    attachHook(event: string, listener: (e: PoolEvent) => void): void;
+    emitEvent(event: PoolEvent): void;
+    detachHook(event: string, listener: (e: PoolEvent) => void): void;
+}
+//# sourceMappingURL=pool-event-manager.d.ts.map

package/dist/multipool/pool-event-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool-event-manager.d.ts","sourceRoot":"","sources":["../../src/multipool/pool-event-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAExD,qBAAa,gBAAgB;IAE3B,IAAI,EAAE,iBAAiB,CAAC;IAExB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAa;gBAEpC,IAAI,EAAE,iBAAiB;IAInC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,SAAS,KAAK,IAAI;IAO1D,SAAS,CAAC,KAAK,EAAE,SAAS;IAS1B,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,SAAS,KAAK,IAAI;CAM3D"}

package/dist/multipool/pool-event-manager.js

@@ -0,0 +1,28 @@
+export class PoolEventManager {
+    pool;
+    hooks = new Map();
+    constructor(pool) {
+        this.pool = pool;
+    }
+    attachHook(event, listener) {
+        if (!this.hooks.has(event)) {
+            this.hooks.set(event, []);
+        }
+        this.hooks.get(event).push(listener);
+    }
+    emitEvent(event) {
+        const listeners = this.hooks.get(event.type);
+        if (listeners) {
+            for (const listener of listeners) {
+                listener(event);
+            }
+        }
+    }
+    detachHook(event, listener) {
+        const listeners = this.hooks.get(event);
+        if (listeners) {
+            this.hooks.set(event, listeners.filter(l => l !== listener));
+        }
+    }
+}
+//# sourceMappingURL=pool-event-manager.js.map

package/dist/multipool/pool-event-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool-event-manager.js","sourceRoot":"","sources":["../../src/multipool/pool-event-manager.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,gBAAgB;IAE3B,IAAI,CAAoB;IAExB,KAAK,GAAiC,IAAI,GAAG,EAAE,CAAC;IAEhD,YAAY,IAAuB;QACjC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,UAAU,CAAC,KAAa,EAAE,QAAgC;QACxD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC5B,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,SAAS,CAAC,KAAgB;QACxB,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,SAAS,EAAE,CAAC;YACd,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACjC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC;IAED,UAAU,CAAC,KAAa,EAAE,QAAgC;QACxD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;CACF"}

package/dist/multipool/tests/job-state-registry.d.ts

@@ -0,0 +1,17 @@
+import { MultiWorkflowPool } from "src/multipool/multi-workflow-pool.js";
+import { Workflow } from "src/multipool/workflow.js";
+interface JobState {
+    jobId: string;
+    workflow: Workflow;
+    status: 'pending' | 'running' | 'completed' | 'failed' | 'canceled';
+}
+export declare class JobStateRegistry {
+    pool: MultiWorkflowPool;
+    jobs: Map<string, JobState>;
+    constructor(pool: MultiWorkflowPool);
+    addJob(workflow: Workflow): `${string}-${string}-${string}-${string}-${string}`;
+    getJobStatus(jobId: string): void;
+    cancelJob(jobId: string): void;
+}
+export {};
+//# sourceMappingURL=job-state-registry.d.ts.map

package/dist/multipool/tests/job-state-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-state-registry.d.ts","sourceRoot":"","sources":["../../../src/multipool/tests/job-state-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAGrD,UAAU,QAAQ;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;CACrE;AAED,qBAAa,gBAAgB;IAE3B,IAAI,EAAE,iBAAiB,CAAC;IAExB,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAa;gBAE5B,IAAI,EAAE,iBAAiB;IAInC,MAAM,CAAC,QAAQ,EAAE,QAAQ;IAYzB,YAAY,CAAC,KAAK,EAAE,MAAM;IAI1B,SAAS,CAAC,KAAK,EAAE,MAAM;CAGxB"}

package/dist/multipool/tests/job-state-registry.js

@@ -0,0 +1,24 @@
+import { randomUUID } from "node:crypto";
+export class JobStateRegistry {
+    pool;
+    jobs = new Map();
+    constructor(pool) {
+        this.pool = pool;
+    }
+    addJob(workflow) {
+        // Create new job id
+        const jobId = randomUUID();
+        const jobState = {
+            jobId,
+            workflow,
+            status: 'pending',
+        };
+        this.jobs.set(jobId, jobState);
+        return jobId;
+    }
+    getJobStatus(jobId) {
+    }
+    cancelJob(jobId) {
+    }
+}
+//# sourceMappingURL=job-state-registry.js.map

package/dist/multipool/tests/job-state-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-state-registry.js","sourceRoot":"","sources":["../../../src/multipool/tests/job-state-registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAQzC,MAAM,OAAO,gBAAgB;IAE3B,IAAI,CAAoB;IAExB,IAAI,GAA0B,IAAI,GAAG,EAAE,CAAC;IAExC,YAAY,IAAuB;QACjC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,QAAkB;QACvB,oBAAoB;QACpB,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAa;YACzB,KAAK;YACL,QAAQ;YACR,MAAM,EAAE,SAAS;SAClB,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,YAAY,CAAC,KAAa;IAE1B,CAAC;IAED,SAAS,CAAC,KAAa;IAEvB,CAAC;CACF"}

package/dist/multipool/tests/multipool-basic.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=multipool-basic.d.ts.map

package/dist/multipool/tests/multipool-basic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multipool-basic.d.ts","sourceRoot":"","sources":["../../../src/multipool/tests/multipool-basic.ts"],"names":[],"mappings":""}

package/dist/multipool/tests/multipool-basic.js

@@ -0,0 +1,4 @@
+import { MultiWorkflowPool } from "src/multipool/multi-workflow-pool.js";
+const pool = new MultiWorkflowPool();
+console.log(pool);
+//# sourceMappingURL=multipool-basic.js.map

package/dist/multipool/tests/multipool-basic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multipool-basic.js","sourceRoot":"","sources":["../../../src/multipool/tests/multipool-basic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAEzE,MAAM,IAAI,GAAG,IAAI,iBAAiB,EAAE,CAAC;AAErC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC"}

package/dist/multipool/workflow.d.ts

@@ -0,0 +1,174 @@
+import type { AugmentNodes } from '../node-type-hints.js';
+type WorkflowJSON = Record<string, any>;
+export interface WorkflowResultMeta {
+    _promptId?: string;
+    _nodes?: string[];
+    _aliases?: Record<string, string>;
+    _autoSeeds?: Record<string, number>;
+}
+export type WorkflowResult = WorkflowResultMeta & Record<string, any>;
+export interface WorkflowRunOptions {
+    includeOutputs?: string[];
+}
+export interface WorkflowJobEvents<R extends WorkflowResult = WorkflowResult> {
+    progress: (info: {
+        value: number;
+        max: number;
+        prompt_id: string;
+        node: string;
+    }) => void;
+    progress_pct: (pct: number, info: any) => void;
+    preview: (blob: Blob) => void;
+    preview_meta: (data: {
+        blob: Blob;
+        metadata: any;
+    }) => void;
+    pending: (promptId: string) => void;
+    start: (promptId: string) => void;
+    output: (key: string, data: any) => void;
+    finished: (data: R, promptId: string) => void;
+    failed: (err: Error, promptId?: string) => void;
+}
+type EventKey<R extends WorkflowResult> = keyof WorkflowJobEvents<R>;
+export declare class WorkflowJob<R extends WorkflowResult = WorkflowResult> {
+    private emitter;
+    private donePromise;
+    private doneResolve;
+    private doneReject;
+    lastProgressPct: number;
+    constructor();
+    on<K extends EventKey<R>>(evt: K, fn: WorkflowJobEvents<R>[K]): this;
+    off<K extends EventKey<R>>(evt: K, fn: WorkflowJobEvents<R>[K]): this;
+    /** Await final mapped outputs */
+    done(): Promise<R>;
+    _emit<K extends EventKey<R>>(evt: K, ...args: Parameters<WorkflowJobEvents<R>[K]>): void;
+    _finish(data: R): void;
+    _fail(err: Error, promptId?: string): void;
+}
+type NodeInputs<T> = T extends {
+    inputs: infer I;
+} ? I : never;
+type OutputMap = Record<string, any>;
+type OutputShapeFor<C extends string> = C extends 'SaveImage' | 'SaveImageAdvanced' ? {
+    images?: any[];
+} : C extends 'KSampler' ? {
+    samples?: any;
+} : any;
+type NodeOutputFor<T extends WorkflowJSON, K extends keyof T & string> = T[K] extends {
+    class_type: infer C;
+} ? C extends string ? OutputShapeFor<C> : any : any;
+export declare class Workflow<T extends WorkflowJSON = WorkflowJSON, O extends OutputMap = {}> {
+    private json;
+    private outputNodeIds;
+    private outputAliases;
+    private bypassedNodes;
+    private _pendingImageInputs;
+    private _pendingFolderFiles;
+    /** Structural hash of the workflow JSON for compatibility tracking in failover scenarios */
+    structureHash?: string;
+    static from<TD extends WorkflowJSON>(data: TD, opts?: {
+        autoHash?: boolean;
+    }): Workflow<TD, {}>;
+    static from(data: string, opts?: {
+        autoHash?: boolean;
+    }): Workflow;
+    constructor(json: T, opts?: {
+        autoHash?: boolean;
+    });
+    /**
+     * Like from(), but augments known node types (e.g., KSampler) with soft union hints
+     * for inputs such as sampler_name & scheduler while still allowing arbitrary strings.
+     */
+    static fromAugmented<TD extends WorkflowJSON>(data: TD, opts?: {
+        autoHash?: boolean;
+    }): Workflow<AugmentNodes<TD>, {}>;
+    /** Set a nested input path on a node e.g. set('9.inputs.text','hello') */
+    set(path: string, value: any): this;
+    /** Attach a single image buffer to a node input (e.g., LoadImage.image). Will upload on run() then set the input to the filename. */
+    attachImage(nodeId: keyof T & string, inputName: string, data: Blob | Buffer | ArrayBuffer | Uint8Array, fileName: string, opts?: {
+        subfolder?: string;
+        override?: boolean;
+    }): this;
+    /** Attach multiple files into a server subfolder (useful for LoadImageSetFromFolderNode). */
+    attachFolderFiles(subfolder: string, files: Array<{
+        data: Blob | Buffer | ArrayBuffer | Uint8Array;
+        fileName: string;
+    }>, opts?: {
+        override?: boolean;
+    }): this;
+    /**
+     * Sugar for setting a node's input: wf.input('SAMPLER','steps',30)
+     * Equivalent to set('SAMPLER.inputs.steps', 30).
+     * Performs a light existence check to aid DX (doesn't throw if missing by design unless strict parameter is passed).
+     */
+    input<K extends keyof T, P extends keyof NodeInputs<T[K]> & string>(nodeId: K, inputName: P, value: NodeInputs<T[K]>[P], opts?: {
+        strict?: boolean;
+    }): this;
+    /**
+     * Batch variant:
+     *  - wf.inputs('SAMPLER', { steps: 30, cfg: 7 })
+     *  - wf.inputs({ SAMPLER: { steps: 30 }, CLIP: { text: 'hello' } })
+     * Honors strict mode (throws if node missing when strict:true).
+     */
+    batchInputs<K extends keyof T>(nodeId: K, values: Partial<NodeInputs<T[K]>>, opts?: {
+        strict?: boolean;
+    }): this;
+    batchInputs<M extends {
+        [N in keyof T]?: Partial<NodeInputs<T[N]>>;
+    }>(batch: M, opts?: {
+        strict?: boolean;
+    }): this;
+    /**
+     * Mark a node to be bypassed during execution.
+     * The node will be removed and its connections automatically rewired.
+     *
+     * @param node - Node ID to bypass
+     * @returns This workflow instance for chaining
+     */
+    bypass(node: keyof T & string): this;
+    /**
+     * Mark multiple nodes to be bypassed during execution.
+     *
+     * @param nodes - Array of node IDs to bypass
+     * @returns This workflow instance for chaining
+     */
+    bypass(nodes: (keyof T & string)[]): this;
+    /**
+     * Remove a node from the bypass list, re-enabling it.
+     *
+     * @param node - Node ID to reinstate
+     * @returns This workflow instance for chaining
+     */
+    reinstate(node: keyof T & string): this;
+    /**
+     * Remove multiple nodes from the bypass list.
+     *
+     * @param nodes - Array of node IDs to reinstate
+     * @returns This workflow instance for chaining
+     */
+    reinstate(nodes: (keyof T & string)[]): this;
+    /**
+     * Update the structural hash after making non-dynamic changes to the workflow.
+     * Call this if you modify the workflow structure after initialization and the autoHash was disabled,
+     * or if you want to recalculate the hash after making structural changes.
+     *
+     * Example:
+     * ```
+     * const wf = Workflow.from(data, { autoHash: false });
+     * wf.input('SAMPLER', 'ckpt_name', 'model_v1.safetensors');
+     * wf.updateHash(); // Recompute hash after structural change
+     * ```
+     */
+    updateHash(): this;
+    /** IDE helper returning empty object typed as final result (aliases + metadata). */
+    typedResult(): WorkflowResult & O;
+}
+export interface Workflow<T extends WorkflowJSON = WorkflowJSON, O extends OutputMap = {}> {
+    output<NodeId extends keyof T & string>(nodeId: NodeId): Workflow<T, O & Record<NodeId, NodeOutputFor<T, NodeId>>>;
+    output<Spec extends `${string}:${keyof T & string}`>(spec: Spec): Workflow<T, O & (Spec extends `${infer Alias}:${infer Node}` ? (Node extends keyof T & string ? Record<Alias, NodeOutputFor<T, Node>> : Record<Alias, any>) : {})>;
+    output<Alias extends string, NodeId extends keyof T & string>(alias: Alias, nodeId: NodeId): Workflow<T, O & Record<Alias, NodeOutputFor<T, NodeId>>>;
+    output<A extends string>(single: A): Workflow<T, O & Record<A, any>>;
+    output<Alias extends string, NodeId extends string>(alias: Alias, nodeId: NodeId): Workflow<T, O & Record<Alias, any>>;
+}
+export {};
+//# sourceMappingURL=workflow.d.ts.map

package/dist/multipool/workflow.d.ts.map

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

package/dist/multipool/workflow.js

@@ -0,0 +1,272 @@
+import { hashWorkflow } from '../pool/utils/hash.js';
+class TinyEmitter {
+    listeners = new Map();
+    on(evt, fn) {
+        if (!this.listeners.has(evt))
+            this.listeners.set(evt, new Set());
+        this.listeners.get(evt).add(fn);
+        return () => this.off(evt, fn);
+    }
+    off(evt, fn) { this.listeners.get(evt)?.delete(fn); }
+    emit(evt, ...args) { this.listeners.get(evt)?.forEach(fn => { try {
+        fn(...args);
+    }
+    catch { } }); }
+    removeAll() { this.listeners.clear(); }
+}
+export class WorkflowJob {
+    emitter = new TinyEmitter();
+    donePromise;
+    doneResolve;
+    doneReject;
+    lastProgressPct = -1;
+    constructor() {
+        this.donePromise = new Promise((res, rej) => { this.doneResolve = res; this.doneReject = rej; });
+        // Prevent unhandled rejection warnings by attaching a catch handler
+        // The actual error handling happens when user calls done()
+        this.donePromise.catch(() => { });
+    }
+    on(evt, fn) { this.emitter.on(evt, fn); return this; }
+    off(evt, fn) { this.emitter.off(evt, fn); return this; }
+    /** Await final mapped outputs */
+    done() { return this.donePromise; }
+    _emit(evt, ...args) { this.emitter.emit(evt, ...args); }
+    _finish(data) { this.doneResolve(data); this.emitter.emit('finished', data, data._promptId); }
+    _fail(err, promptId) { this.doneReject(err); this.emitter.emit('failed', err, promptId); }
+}
+export class Workflow {
+    json;
+    outputNodeIds = [];
+    outputAliases = {}; // nodeId -> alias
+    bypassedNodes = []; // nodes to bypass during execution
+    // Pending assets to upload before execution
+    _pendingImageInputs = [];
+    _pendingFolderFiles = [];
+    /** Structural hash of the workflow JSON for compatibility tracking in failover scenarios */
+    structureHash;
+    static from(data, opts) {
+        if (typeof data === 'string') {
+            try {
+                const parsed = JSON.parse(data);
+                return new Workflow(parsed, opts);
+            }
+            catch (e) {
+                throw new Error('Failed to parse workflow JSON string', { cause: e });
+            }
+        }
+        return new Workflow(structuredClone(data), opts);
+    }
+    constructor(json, opts) {
+        this.json = structuredClone(json);
+        // Compute structural hash by default unless explicitly disabled
+        if (opts?.autoHash !== false) {
+            this.structureHash = hashWorkflow(this.json);
+        }
+    }
+    /**
+     * Like from(), but augments known node types (e.g., KSampler) with soft union hints
+     * for inputs such as sampler_name & scheduler while still allowing arbitrary strings.
+     */
+    static fromAugmented(data, opts) {
+        return Workflow.from(data, opts);
+    }
+    /** Set a nested input path on a node e.g. set('9.inputs.text','hello') */
+    set(path, value) {
+        const keys = path.split('.');
+        let cur = this.json;
+        for (let i = 0; i < keys.length - 1; i++) {
+            if (cur[keys[i]] === undefined)
+                cur[keys[i]] = {};
+            cur = cur[keys[i]];
+        }
+        cur[keys[keys.length - 1]] = value;
+        return this;
+    }
+    /** Attach a single image buffer to a node input (e.g., LoadImage.image). Will upload on run() then set the input to the filename. */
+    attachImage(nodeId, inputName, data, fileName, opts) {
+        const blob = toBlob(data, fileName);
+        this._pendingImageInputs.push({ nodeId: String(nodeId), inputName, blob, fileName, subfolder: opts?.subfolder, override: opts?.override });
+        return this;
+    }
+    /** Attach multiple files into a server subfolder (useful for LoadImageSetFromFolderNode). */
+    attachFolderFiles(subfolder, files, opts) {
+        for (const f of files) {
+            const blob = toBlob(f.data, f.fileName);
+            this._pendingFolderFiles.push({ subfolder, blob, fileName: f.fileName, override: opts?.override });
+        }
+        return this;
+    }
+    /**
+     * Sugar for setting a node's input: wf.input('SAMPLER','steps',30)
+     * Equivalent to set('SAMPLER.inputs.steps', 30).
+     * Performs a light existence check to aid DX (doesn't throw if missing by design unless strict parameter is passed).
+     */
+    input(nodeId, inputName, value, opts) {
+        const nodeKey = String(nodeId);
+        const node = this.json[nodeKey];
+        if (!node) {
+            if (opts?.strict)
+                throw new Error(`Workflow.input: node '${String(nodeId)}' not found`);
+            // create minimal node shell if non-strict (lets users build up dynamically)
+            this.json[nodeKey] = { inputs: { [inputName]: value } };
+            return this;
+        }
+        if (!node.inputs) {
+            if (opts?.strict)
+                throw new Error(`Workflow.input: node '${String(nodeId)}' missing inputs object`);
+            node.inputs = {};
+        }
+        node.inputs[inputName] = value;
+        return this;
+    }
+    batchInputs(a, b, c) {
+        // Form 1: (nodeId, values, opts)
+        if (typeof a === 'string') {
+            const nodeId = a;
+            const values = b || {};
+            const opts = c || {};
+            for (const [k, v] of Object.entries(values)) {
+                this.input(nodeId, k, v, opts);
+            }
+            return this;
+        }
+        // Form 2: (batchObject, opts)
+        const batch = a || {};
+        const opts = b || {};
+        for (const [nodeId, values] of Object.entries(batch)) {
+            if (!values)
+                continue;
+            for (const [k, v] of Object.entries(values)) {
+                this.input(nodeId, k, v, opts);
+            }
+        }
+        return this;
+    }
+    /**
+     * Mark a node id whose outputs we want collected.
+     * Supports aliasing in two forms:
+     *  - output('alias','9')
+     *  - output('alias:9')
+     *  - output('9') (no alias, raw node id key)
+     */
+    output(a, b) {
+        let alias;
+        let nodeId;
+        if (b) {
+            // Heuristic: if first arg looks like a node id and second arg looks like an alias, swap
+            // Node ids are often numeric strings (e.g., '2'); aliases are non-numeric labels.
+            const looksLikeNodeId = (s) => /^\d+$/.test(s) || this.json[s];
+            if (looksLikeNodeId(String(a)) && !looksLikeNodeId(String(b))) {
+                nodeId = String(a);
+                alias = String(b);
+                try {
+                    console.warn(`Workflow.output called as output(nodeId, alias). Interpreting as output(alias,nodeId): '${alias}:${nodeId}'`);
+                }
+                catch { }
+            }
+            else {
+                alias = String(a);
+                nodeId = String(b);
+            }
+        }
+        else {
+            // single param variant: maybe "alias:node" or just node
+            if (a.includes(':')) {
+                const [al, id] = a.split(':');
+                if (al && id) {
+                    alias = al;
+                    nodeId = id;
+                }
+                else {
+                    nodeId = a;
+                }
+            }
+            else {
+                nodeId = a;
+            }
+        }
+        if (!this.outputNodeIds.includes(nodeId))
+            this.outputNodeIds.push(nodeId);
+        if (alias) {
+            this.outputAliases[nodeId] = alias;
+        }
+        return this; // typed refinement handled via declaration merging below
+    }
+    bypass(nodes) {
+        if (!Array.isArray(nodes)) {
+            nodes = [nodes];
+        }
+        for (const node of nodes) {
+            if (!this.bypassedNodes.includes(node)) {
+                this.bypassedNodes.push(node);
+            }
+        }
+        return this;
+    }
+    reinstate(nodes) {
+        if (!Array.isArray(nodes)) {
+            nodes = [nodes];
+        }
+        for (const node of nodes) {
+            const idx = this.bypassedNodes.indexOf(node);
+            if (idx !== -1) {
+                this.bypassedNodes.splice(idx, 1);
+            }
+        }
+        return this;
+    }
+    /**
+     * Update the structural hash after making non-dynamic changes to the workflow.
+     * Call this if you modify the workflow structure after initialization and the autoHash was disabled,
+     * or if you want to recalculate the hash after making structural changes.
+     *
+     * Example:
+     * ```
+     * const wf = Workflow.from(data, { autoHash: false });
+     * wf.input('SAMPLER', 'ckpt_name', 'model_v1.safetensors');
+     * wf.updateHash(); // Recompute hash after structural change
+     * ```
+     */
+    updateHash() {
+        this.structureHash = hashWorkflow(this.json);
+        return this;
+    }
+    /** IDE helper returning empty object typed as final result (aliases + metadata). */
+    typedResult() { return {}; }
+}
+// Helper: normalize to Blob for upload
+function toBlob(src, fileName) {
+    if (src instanceof Blob)
+        return src;
+    // Normalize everything to a plain ArrayBuffer for reliable BlobPart typing
+    let ab;
+    if (typeof Buffer !== 'undefined' && src instanceof Buffer) {
+        const u8 = new Uint8Array(src);
+        ab = u8.slice(0).buffer;
+    }
+    else if (src instanceof Uint8Array) {
+        const u8 = new Uint8Array(src.byteLength);
+        u8.set(src);
+        ab = u8.buffer;
+    }
+    else if (src instanceof ArrayBuffer) {
+        ab = src;
+    }
+    else {
+        ab = new ArrayBuffer(0);
+    }
+    return new Blob([ab], { type: mimeFromName(fileName) });
+}
+function mimeFromName(name) {
+    if (!name)
+        return undefined;
+    const n = name.toLowerCase();
+    if (n.endsWith('.png'))
+        return 'image/png';
+    if (n.endsWith('.jpg') || n.endsWith('.jpeg'))
+        return 'image/jpeg';
+    if (n.endsWith('.webp'))
+        return 'image/webp';
+    return undefined;
+}
+//# sourceMappingURL=workflow.js.map