comfyui-node 1.3.1 → 1.4.1

package/dist/pool/client/ClientManager.js

@@ -0,0 +1,167 @@
+import { TypedEventTarget } from "../../typed-event-target.js";
+export class ClientManager extends TypedEventTarget {
+    clients = [];
+    strategy;
+    healthCheckInterval = null;
+    healthCheckIntervalMs;
+    /**
+     * Create a new ClientManager for managing ComfyUI client connections.
+     *
+     * @param strategy - Failover strategy for handling client failures
+     * @param opts - Configuration options
+     * @param opts.healthCheckIntervalMs - Interval (ms) for health check pings to keep connections alive.
+     *   Set to 0 to disable. Default: 30000 (30 seconds).
+     */
+    constructor(strategy, opts) {
+        super();
+        this.strategy = strategy;
+        this.healthCheckIntervalMs = opts?.healthCheckIntervalMs ?? 30000; // Default: 30 seconds
+    }
+    emitBlocked(clientId, workflowHash) {
+        this.dispatchEvent(new CustomEvent("client:blocked_workflow", { detail: { clientId, workflowHash } }));
+    }
+    emitUnblocked(clientId, workflowHash) {
+        this.dispatchEvent(new CustomEvent("client:unblocked_workflow", { detail: { clientId, workflowHash } }));
+    }
+    async initialize(clients) {
+        for (const client of clients) {
+            await this.addClient(client);
+        }
+        this.startHealthCheck();
+    }
+    async addClient(client) {
+        await client.init();
+        const managed = {
+            client,
+            id: client.id,
+            online: true,
+            busy: false,
+            lastSeenAt: Date.now(),
+            supportedWorkflows: new Set()
+        };
+        this.clients.push(managed);
+        client.on("disconnected", () => {
+            managed.online = false;
+            managed.busy = false;
+            managed.lastSeenAt = Date.now();
+            this.dispatchEvent(new CustomEvent("client:state", {
+                detail: { clientId: managed.id, online: false, busy: false, lastError: managed.lastError }
+            }));
+        });
+        client.on("reconnected", () => {
+            managed.online = true;
+            managed.lastSeenAt = Date.now();
+            this.dispatchEvent(new CustomEvent("client:state", {
+                detail: { clientId: managed.id, online: true, busy: managed.busy }
+            }));
+        });
+    }
+    list() {
+        return [...this.clients];
+    }
+    getClient(clientId) {
+        return this.clients.find((c) => c.id === clientId);
+    }
+    claim(job) {
+        const candidates = this.clients.filter((c) => c.online && !c.busy);
+        const preferred = job.options.preferredClientIds?.length
+            ? candidates.filter((c) => job.options.preferredClientIds?.includes(c.id))
+            : candidates;
+        const filtered = preferred
+            .filter((client) => !job.options.excludeClientIds?.includes(client.id))
+            .filter((client) => !this.strategy.shouldSkipClient(client, job));
+        const chosen = filtered[0];
+        if (!chosen) {
+            return null;
+        }
+        chosen.busy = true;
+        chosen.lastSeenAt = Date.now();
+        return {
+            client: chosen.client,
+            clientId: chosen.id,
+            release: (opts) => {
+                chosen.busy = false;
+                if (opts?.success) {
+                    const wasBlocked = this.strategy.isWorkflowBlocked?.(chosen, job.workflowHash) ?? false;
+                    this.strategy.recordSuccess(chosen, job);
+                    const stillBlocked = this.strategy.isWorkflowBlocked?.(chosen, job.workflowHash) ?? false;
+                    if (wasBlocked && !stillBlocked) {
+                        this.emitUnblocked(chosen.id, job.workflowHash);
+                    }
+                }
+                this.dispatchEvent(new CustomEvent("client:state", {
+                    detail: { clientId: chosen.id, online: chosen.online, busy: chosen.busy }
+                }));
+            }
+        };
+    }
+    recordFailure(clientId, job, error) {
+        const client = this.clients.find((c) => c.id === clientId);
+        if (!client) {
+            return;
+        }
+        client.lastError = error;
+        client.busy = false;
+        const wasBlocked = this.strategy.isWorkflowBlocked?.(client, job.workflowHash) ?? false;
+        this.strategy.recordFailure(client, job, error);
+        const isBlocked = this.strategy.isWorkflowBlocked?.(client, job.workflowHash) ?? false;
+        if (!wasBlocked && isBlocked) {
+            this.emitBlocked(client.id, job.workflowHash);
+        }
+        this.dispatchEvent(new CustomEvent("client:state", {
+            detail: { clientId: client.id, online: client.online, busy: client.busy, lastError: error }
+        }));
+    }
+    /**
+     * Start periodic health check to keep connections alive and detect issues early.
+     * Pings idle clients by polling their queue status.
+     */
+    startHealthCheck() {
+        if (this.healthCheckInterval) {
+            return; // Already running
+        }
+        this.healthCheckInterval = setInterval(() => {
+            this.performHealthCheck().catch((error) => {
+                console.error("[ClientManager] Health check error:", error);
+            });
+        }, this.healthCheckIntervalMs);
+    }
+    /**
+     * Perform health check on all clients.
+     * For idle clients, polls queue status to keep WebSocket alive and detect connection issues.
+     */
+    async performHealthCheck() {
+        for (const managed of this.clients) {
+            // Only ping idle (non-busy) clients to avoid interfering with active operations
+            if (!managed.busy && managed.online) {
+                try {
+                    // Lightweight ping: poll queue status (triggers WebSocket activity)
+                    await managed.client.getQueue();
+                    managed.lastSeenAt = Date.now();
+                }
+                catch (error) {
+                    // Health check failed - client may have connection issues
+                    console.warn(`[ClientManager] Health check failed for client ${managed.id}:`, error);
+                    // Don't mark as offline here - let the WebSocket disconnect event handle that
+                    // This prevents false positives from temporary network hiccups
+                }
+            }
+        }
+    }
+    /**
+     * Stop health check interval (called during shutdown).
+     */
+    stopHealthCheck() {
+        if (this.healthCheckInterval) {
+            clearInterval(this.healthCheckInterval);
+            this.healthCheckInterval = null;
+        }
+    }
+    /**
+     * Cleanup resources when destroying the manager.
+     */
+    destroy() {
+        this.stopHealthCheck();
+    }
+}
+//# sourceMappingURL=ClientManager.js.map

package/dist/pool/client/ClientManager.js.map

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

package/dist/pool/failover/SmartFailoverStrategy.d.ts

@@ -0,0 +1,18 @@
+import type { ManagedClient } from "../client/ClientManager.js";
+import type { JobRecord } from "../types/job.js";
+import type { FailoverStrategy } from "./Strategy.js";
+export declare class SmartFailoverStrategy implements FailoverStrategy {
+    private workflowFailures;
+    private cooldownMs;
+    private maxFailuresBeforeBlock;
+    constructor(opts?: {
+        cooldownMs?: number;
+        maxFailuresBeforeBlock?: number;
+    });
+    shouldSkipClient(client: ManagedClient, job: JobRecord): boolean;
+    recordFailure(client: ManagedClient, job: JobRecord, error: unknown): void;
+    recordSuccess(client: ManagedClient, job: JobRecord): void;
+    resetForWorkflow(workflowHash: string): void;
+    isWorkflowBlocked(client: ManagedClient, workflowHash: string): boolean;
+}
+//# sourceMappingURL=SmartFailoverStrategy.d.ts.map

package/dist/pool/failover/SmartFailoverStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SmartFailoverStrategy.d.ts","sourceRoot":"","sources":["../../../src/pool/failover/SmartFailoverStrategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAOtD,qBAAa,qBAAsB,YAAW,gBAAgB;IAC5D,OAAO,CAAC,gBAAgB,CAA6D;IACrF,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,sBAAsB,CAAS;gBAE3B,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,sBAAsB,CAAC,EAAE,MAAM,CAAA;KAAE;IAK3E,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO;IAgBhE,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAe1E,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI;IAW1D,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAM5C,iBAAiB,CAAC,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO;CAWxE"}

package/dist/pool/failover/SmartFailoverStrategy.js

@@ -0,0 +1,65 @@
+export class SmartFailoverStrategy {
+    workflowFailures = new Map();
+    cooldownMs;
+    maxFailuresBeforeBlock;
+    constructor(opts) {
+        this.cooldownMs = opts?.cooldownMs ?? 60_000;
+        this.maxFailuresBeforeBlock = opts?.maxFailuresBeforeBlock ?? 1;
+    }
+    shouldSkipClient(client, job) {
+        const workflowMap = this.workflowFailures.get(client.id);
+        if (!workflowMap) {
+            return false;
+        }
+        const entry = workflowMap.get(job.workflowHash);
+        if (!entry) {
+            return false;
+        }
+        if (entry.blockedUntil > Date.now()) {
+            return true;
+        }
+        workflowMap.delete(job.workflowHash);
+        return false;
+    }
+    recordFailure(client, job, error) {
+        let workflowMap = this.workflowFailures.get(client.id);
+        if (!workflowMap) {
+            workflowMap = new Map();
+            this.workflowFailures.set(client.id, workflowMap);
+        }
+        const existing = workflowMap.get(job.workflowHash);
+        const failureCount = (existing?.failureCount ?? 0) + 1;
+        const blocked = failureCount >= this.maxFailuresBeforeBlock;
+        workflowMap.set(job.workflowHash, {
+            failureCount,
+            blockedUntil: blocked ? Date.now() + this.cooldownMs : Date.now()
+        });
+    }
+    recordSuccess(client, job) {
+        const workflowMap = this.workflowFailures.get(client.id);
+        if (!workflowMap) {
+            return;
+        }
+        workflowMap.delete(job.workflowHash);
+        if (workflowMap.size === 0) {
+            this.workflowFailures.delete(client.id);
+        }
+    }
+    resetForWorkflow(workflowHash) {
+        for (const [, map] of this.workflowFailures) {
+            map.delete(workflowHash);
+        }
+    }
+    isWorkflowBlocked(client, workflowHash) {
+        const workflowMap = this.workflowFailures.get(client.id);
+        if (!workflowMap) {
+            return false;
+        }
+        const entry = workflowMap.get(workflowHash);
+        if (!entry) {
+            return false;
+        }
+        return entry.blockedUntil > Date.now();
+    }
+}
+//# sourceMappingURL=SmartFailoverStrategy.js.map

package/dist/pool/failover/SmartFailoverStrategy.js.map

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

package/dist/pool/failover/Strategy.d.ts

@@ -0,0 +1,10 @@
+import { ManagedClient } from "../client/ClientManager.js";
+import type { JobRecord } from "../types/job.js";
+export interface FailoverStrategy {
+    shouldSkipClient(client: ManagedClient, job: JobRecord): boolean;
+    recordFailure(client: ManagedClient, job: JobRecord, error: unknown): void;
+    recordSuccess(client: ManagedClient, job: JobRecord): void;
+    resetForWorkflow?(workflowHash: string): void;
+    isWorkflowBlocked?(client: ManagedClient, workflowHash: string): boolean;
+}
+//# sourceMappingURL=Strategy.d.ts.map

package/dist/pool/failover/Strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Strategy.d.ts","sourceRoot":"","sources":["../../../src/pool/failover/Strategy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC;IACjE,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3E,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CAAC;IAC3D,gBAAgB,CAAC,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9C,iBAAiB,CAAC,CAAC,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1E"}

package/dist/pool/failover/Strategy.js

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

package/dist/pool/failover/Strategy.js.map

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

package/dist/pool/index.d.ts

@@ -0,0 +1,9 @@
+export { WorkflowPool } from "./WorkflowPool.js";
+export type { WorkflowPoolOpts } from "./WorkflowPool.js";
+export type { WorkflowPoolEventMap } from "./types/events.js";
+export type { JobRecord, JobStatus, WorkflowJobOptions } from "./types/job.js";
+export type { QueueAdapter, QueueReservation, QueueStats } from "./queue/QueueAdapter.js";
+export { MemoryQueueAdapter } from "./queue/adapters/memory.js";
+export type { FailoverStrategy } from "./failover/Strategy.js";
+export { SmartFailoverStrategy } from "./failover/SmartFailoverStrategy.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pool/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC/E,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1F,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/pool/index.js

@@ -0,0 +1,4 @@
+export { WorkflowPool } from "./WorkflowPool.js";
+export { MemoryQueueAdapter } from "./queue/adapters/memory.js";
+export { SmartFailoverStrategy } from "./failover/SmartFailoverStrategy.js";
+//# sourceMappingURL=index.js.map

package/dist/pool/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pool/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAKjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/pool/queue/QueueAdapter.d.ts

@@ -0,0 +1,31 @@
+import type { WorkflowJobPayload } from "../types/job.js";
+export interface QueueStats {
+    waiting: number;
+    inFlight: number;
+    delayed: number;
+    failed: number;
+}
+export interface QueueReservation {
+    /** Unique reservation identifier (often equals the jobId for in-memory implementation). */
+    reservationId: string;
+    payload: WorkflowJobPayload;
+    attempt: number;
+    /** Optional timestamp when the item becomes visible again (for delayed retries). */
+    availableAt?: number;
+}
+export interface QueueAdapter {
+    enqueue(payload: WorkflowJobPayload, opts?: {
+        priority?: number;
+        delayMs?: number;
+    }): Promise<void>;
+    reserve(): Promise<QueueReservation | null>;
+    commit(reservationId: string): Promise<void>;
+    retry(reservationId: string, opts?: {
+        delayMs?: number;
+    }): Promise<void>;
+    discard(reservationId: string, reason?: unknown): Promise<void>;
+    remove(jobId: string): Promise<boolean>;
+    stats(): Promise<QueueStats>;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=QueueAdapter.d.ts.map

package/dist/pool/queue/QueueAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueueAdapter.d.ts","sourceRoot":"","sources":["../../../src/pool/queue/QueueAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,2FAA2F;IAC3F,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,OAAO,EAAE,kBAAkB,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpG,OAAO,IAAI,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAC5C,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,KAAK,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B"}

package/dist/pool/queue/QueueAdapter.js

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

package/dist/pool/queue/QueueAdapter.js.map

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

package/dist/pool/queue/adapters/memory.d.ts

@@ -0,0 +1,21 @@
+import { QueueAdapter, QueueReservation, QueueStats } from "../QueueAdapter.js";
+import type { WorkflowJobPayload } from "../../types/job.js";
+export declare class MemoryQueueAdapter implements QueueAdapter {
+    private waiting;
+    private inFlight;
+    private failed;
+    enqueue(payload: WorkflowJobPayload, opts?: {
+        priority?: number;
+        delayMs?: number;
+    }): Promise<void>;
+    reserve(): Promise<QueueReservation | null>;
+    commit(reservationId: string): Promise<void>;
+    retry(reservationId: string, opts?: {
+        delayMs?: number;
+    }): Promise<void>;
+    discard(reservationId: string, reason?: unknown): Promise<void>;
+    remove(jobId: string): Promise<boolean>;
+    stats(): Promise<QueueStats>;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/pool/queue/adapters/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../../src/pool/queue/adapters/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAS7D,qBAAa,kBAAmB,YAAW,YAAY;IACrD,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,QAAQ,CAA4C;IAC5D,OAAO,CAAC,MAAM,CAAyE;IAEjF,OAAO,CAAC,OAAO,EAAE,kBAAkB,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBnG,OAAO,IAAI,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAgB3C,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5C,KAAK,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBxE,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/D,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYvC,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC;IAS5B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAKhC"}

package/dist/pool/queue/adapters/memory.js

@@ -0,0 +1,96 @@
+export class MemoryQueueAdapter {
+    waiting = [];
+    inFlight = new Map();
+    failed = new Map();
+    async enqueue(payload, opts) {
+        const priority = opts?.priority ?? 0;
+        const availableAt = opts?.delayMs ? Date.now() + opts.delayMs : Date.now();
+        const existingFlight = this.inFlight.get(payload.jobId);
+        if (existingFlight) {
+            // If job is re-enqueued while still marked in-flight, treat as retry (replace entry)
+            this.inFlight.delete(payload.jobId);
+        }
+        const entry = {
+            payload,
+            attempt: payload.attempts,
+            priority,
+            availableAt
+        };
+        this.waiting.push(entry);
+        this.waiting.sort((a, b) => {
+            if (a.priority === b.priority) {
+                return a.availableAt - b.availableAt;
+            }
+            return b.priority - a.priority;
+        });
+    }
+    async reserve() {
+        const now = Date.now();
+        const idx = this.waiting.findIndex((entry) => entry.availableAt <= now);
+        if (idx === -1) {
+            return null;
+        }
+        const [entry] = this.waiting.splice(idx, 1);
+        this.inFlight.set(entry.payload.jobId, entry);
+        return {
+            reservationId: entry.payload.jobId,
+            payload: entry.payload,
+            attempt: entry.payload.attempts,
+            availableAt: entry.availableAt
+        };
+    }
+    async commit(reservationId) {
+        this.inFlight.delete(reservationId);
+        this.failed.delete(reservationId);
+    }
+    async retry(reservationId, opts) {
+        const entry = this.inFlight.get(reservationId);
+        if (!entry) {
+            return;
+        }
+        this.inFlight.delete(reservationId);
+        entry.payload.attempts += 1;
+        entry.attempt = entry.payload.attempts;
+        entry.availableAt = opts?.delayMs ? Date.now() + opts.delayMs : Date.now();
+        this.waiting.push(entry);
+        this.waiting.sort((a, b) => {
+            if (a.priority === b.priority) {
+                return a.availableAt - b.availableAt;
+            }
+            return b.priority - a.priority;
+        });
+    }
+    async discard(reservationId, reason) {
+        const entry = this.inFlight.get(reservationId);
+        if (!entry) {
+            return;
+        }
+        this.inFlight.delete(reservationId);
+        this.failed.set(reservationId, { entry, reason });
+    }
+    async remove(jobId) {
+        const waitingIdx = this.waiting.findIndex((entry) => entry.payload.jobId === jobId);
+        if (waitingIdx !== -1) {
+            this.waiting.splice(waitingIdx, 1);
+            return true;
+        }
+        if (this.inFlight.has(jobId)) {
+            return false;
+        }
+        return this.failed.delete(jobId);
+    }
+    async stats() {
+        return {
+            waiting: this.waiting.length,
+            inFlight: this.inFlight.size,
+            delayed: this.waiting.filter((entry) => entry.availableAt > Date.now()).length,
+            failed: this.failed.size
+        };
+    }
+    async shutdown() {
+        this.waiting = [];
+        this.inFlight.clear();
+        this.failed.clear();
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/pool/queue/adapters/memory.js.map

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

package/dist/pool/types/events.d.ts

@@ -0,0 +1,75 @@
+import type { TypedEventTarget } from "../../typed-event-target.js";
+import type { JobRecord } from "./job.js";
+export interface WorkflowPoolEventMap extends Record<string, CustomEvent<any>> {
+    "pool:ready": CustomEvent<{
+        clientIds: string[];
+    }>;
+    "pool:error": CustomEvent<{
+        error: unknown;
+    }>;
+    "job:queued": CustomEvent<{
+        job: JobRecord;
+    }>;
+    "job:accepted": CustomEvent<{
+        job: JobRecord;
+    }>;
+    "job:started": CustomEvent<{
+        job: JobRecord;
+    }>;
+    "job:progress": CustomEvent<{
+        jobId: string;
+        clientId: string;
+        progress: any;
+    }>;
+    "job:preview": CustomEvent<{
+        jobId: string;
+        clientId: string;
+        blob: Blob;
+    }>;
+    "job:preview_meta": CustomEvent<{
+        jobId: string;
+        clientId: string;
+        payload: {
+            blob: Blob;
+            metadata: any;
+        };
+    }>;
+    "job:output": CustomEvent<{
+        jobId: string;
+        clientId: string;
+        key: string;
+        data: any;
+    }>;
+    "job:completed": CustomEvent<{
+        job: JobRecord;
+    }>;
+    "job:failed": CustomEvent<{
+        job: JobRecord;
+        willRetry: boolean;
+    }>;
+    "job:cancelled": CustomEvent<{
+        job: JobRecord;
+    }>;
+    "job:retrying": CustomEvent<{
+        job: JobRecord;
+        delayMs: number;
+    }>;
+    "client:state": CustomEvent<{
+        clientId: string;
+        online: boolean;
+        busy: boolean;
+        lastError?: unknown;
+    }>;
+    "client:blocked_workflow": CustomEvent<{
+        clientId: string;
+        workflowHash: string;
+    }>;
+    "client:unblocked_workflow": CustomEvent<{
+        clientId: string;
+        workflowHash: string;
+    }>;
+}
+export type WorkflowPoolEventTarget = TypedEventTarget<WorkflowPoolEventMap>;
+export type WorkflowPoolEventName = keyof WorkflowPoolEventMap;
+export type WorkflowPoolListener<K extends WorkflowPoolEventName> = (event: WorkflowPoolEventMap[K]) => void;
+//# sourceMappingURL=events.d.ts.map

package/dist/pool/types/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/pool/types/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,MAAM,WAAW,oBAAqB,SAAQ,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC;IAC5E,YAAY,EAAE,WAAW,CAAC;QAAE,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACnD,YAAY,EAAE,WAAW,CAAC;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC9C,YAAY,EAAE,WAAW,CAAC;QAAE,GAAG,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IAC9C,cAAc,EAAE,WAAW,CAAC;QAAE,GAAG,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IAChD,aAAa,EAAE,WAAW,CAAC;QAAE,GAAG,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IAC/C,cAAc,EAAE,WAAW,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IAChF,aAAa,EAAE,WAAW,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC,CAAC;IAC5E,kBAAkB,EAAE,WAAW,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE;YAAE,IAAI,EAAE,IAAI,CAAC;YAAC,QAAQ,EAAE,GAAG,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;IAC7G,YAAY,EAAE,WAAW,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IACvF,eAAe,EAAE,WAAW,CAAC;QAAE,GAAG,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IACjD,YAAY,EAAE,WAAW,CAAC;QAAE,GAAG,EAAE,SAAS,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAClE,eAAe,EAAE,WAAW,CAAC;QAAE,GAAG,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IACjD,cAAc,EAAE,WAAW,CAAC;QAAE,GAAG,EAAE,SAAS,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,cAAc,EAAE,WAAW,CAAC;QAC1B,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,OAAO,CAAC;QAChB,IAAI,EAAE,OAAO,CAAC;QACd,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,CAAC,CAAC;IACH,yBAAyB,EAAE,WAAW,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnF,2BAA2B,EAAE,WAAW,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtF;AAED,MAAM,MAAM,uBAAuB,GAAG,gBAAgB,CAAC,oBAAoB,CAAC,CAAC;AAE7E,MAAM,MAAM,qBAAqB,GAAG,MAAM,oBAAoB,CAAC;AAE/D,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,qBAAqB,IAAI,CAClE,KAAK,EAAE,oBAAoB,CAAC,CAAC,CAAC,KAC3B,IAAI,CAAC"}

package/dist/pool/types/events.js

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

package/dist/pool/types/events.js.map

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

package/dist/pool/types/job.d.ts

@@ -0,0 +1,56 @@
+import type { Workflow, WorkflowResult } from "../../workflow.js";
+export type JobId = string;
+export type WorkflowInput = Workflow | object | string | {
+    toJSON(): object;
+};
+export interface WorkflowJobAttachment {
+    nodeId: string;
+    inputName: string;
+    file: Blob | Buffer;
+    filename?: string;
+}
+export interface WorkflowJobOptions {
+    /** Optional priority (higher executes first). Defaults to 0. */
+    priority?: number;
+    /** Explicit job id to reuse. Random UUID generated when omitted. */
+    jobId?: JobId;
+    /** Maximum retry attempts across clients. Defaults to 3. */
+    maxAttempts?: number;
+    /** Milliseconds to wait before retrying a failed job. Defaults to 1000. */
+    retryDelayMs?: number;
+    /** Optional list of preferred client ids. */
+    preferredClientIds?: string[];
+    /** Optional list of client ids to exclude. */
+    excludeClientIds?: string[];
+    /** Arbitrary user metadata persisted alongside the job. */
+    metadata?: Record<string, unknown>;
+    /** Include node ids when collecting outputs from the workflow. */
+    includeOutputs?: string[];
+    /** File attachments for the workflow. */
+    attachments?: WorkflowJobAttachment[];
+}
+export type JobStatus = "queued" | "running" | "completed" | "failed" | "cancelled";
+export interface WorkflowJobPayload {
+    jobId: JobId;
+    workflow: object;
+    workflowHash: string;
+    options: Required<Pick<WorkflowJobOptions, "maxAttempts" | "retryDelayMs">> & Omit<WorkflowJobOptions, "maxAttempts" | "retryDelayMs" | "jobId" | "attachments">;
+    attempts: number;
+    enqueuedAt: number;
+    /** Workflow metadata (outputAliases, outputNodeIds) preserved from Workflow instance */
+    workflowMeta?: {
+        outputNodeIds?: string[];
+        outputAliases?: Record<string, string>;
+    };
+}
+export interface JobRecord extends WorkflowJobPayload {
+    attachments?: WorkflowJobAttachment[];
+    status: JobStatus;
+    lastError?: unknown;
+    clientId?: string;
+    promptId?: string;
+    result?: WorkflowResult | Record<string, unknown>;
+    startedAt?: number;
+    completedAt?: number;
+}
+//# sourceMappingURL=job.d.ts.map