@reaatech/media-pipeline-mcp-comfyui 0.3.0

package/dist/index.d.cts

@@ -0,0 +1,76 @@
+import { MediaProvider, ProviderCacheConfig, ProviderHealth, ProviderInput, CostEstimate, ProviderOutput } from '@reaatech/media-pipeline-mcp-provider-core';
+
+interface ComfyUIConfig {
+    baseUrl?: string;
+    workflowsDir?: string;
+    downloadOutputs?: boolean;
+    pollIntervalMs?: number;
+    retentionMs?: number;
+}
+interface ComfyParamSpec {
+    path: string;
+    type: 'string' | 'number' | 'boolean' | 'enum';
+    enum?: string[];
+    default?: unknown;
+    required?: boolean;
+}
+interface ComfyUIWorkflow {
+    name: string;
+    apiFormat: object;
+    inputs: Record<string, ComfyParamSpec>;
+    outputs: Record<string, 'image' | 'video' | 'mask' | 'latent'>;
+}
+declare class ComfyUIProvider extends MediaProvider {
+    static readonly id = "comfyui";
+    readonly name = "comfyui";
+    readonly supportedOperations: string[];
+    /**
+     * §0.6 capability declarations. ComfyUI exposes per-node progress as it executes a
+     * workflow (we surface it via the F6 progress bridge during pollForCompletion), but
+     * does not push outbound webhooks.
+     */
+    readonly supportsStreaming: Set<string>;
+    readonly supportsWebhooks = false;
+    /**
+     * F2 cacheConfig per plan §F10 "Per-implementation features":
+     *   "det per fixed `seed`; cache enabled when seed is provided and non-negative"
+     *
+     * All workflow inputs are deterministic given a fixed seed. The non-det list is
+     * empty because there is no provider-side request id (ComfyUI's `prompt_id` is
+     * generated post-submit and is not user-supplied). Normalize trims string params.
+     */
+    static cacheConfig: ProviderCacheConfig;
+    private baseUrl;
+    private pollIntervalMs;
+    private retentionMs;
+    private downloadOutputs;
+    private workflows;
+    private workflowsDir?;
+    private workflowsDirLoaded;
+    constructor(config?: ComfyUIConfig);
+    /**
+     * Plan §F10 "Mechanism (ComfyUI) #1": load user workflows from `workflowsDir/*.json`
+     * at construction time. We do it lazily (first execute / explicit call) so that the
+     * constructor stays sync and tests can mock fs.
+     *
+     * Each file becomes `custom/<basename>` workflow. The JSON must declare `apiFormat`,
+     * `inputs`, and `outputs` keys (the ComfyUIWorkflow shape). Files that don't match
+     * the shape are skipped with a warning.
+     */
+    loadWorkflowsFromDir(): Promise<void>;
+    healthCheck(): Promise<ProviderHealth>;
+    estimateCost(_input: ProviderInput): Promise<CostEstimate>;
+    registerWorkflow(name: string, workflow: ComfyUIWorkflow): void;
+    getWorkflow(name: string): ComfyUIWorkflow | undefined;
+    listWorkflows(): string[];
+    execute(input: ProviderInput): Promise<ProviderOutput>;
+    private resolveWorkflowName;
+    private runWorkflow;
+    private pollForCompletion;
+    private setNestedValue;
+    private mimeTypeFromFilename;
+    private sleep;
+}
+declare function createComfyUIProvider(config?: ComfyUIConfig): ComfyUIProvider;
+
+export { type ComfyParamSpec, type ComfyUIConfig, ComfyUIProvider, type ComfyUIWorkflow, createComfyUIProvider };

package/dist/index.d.ts

@@ -0,0 +1,76 @@
+import { MediaProvider, ProviderCacheConfig, ProviderHealth, ProviderInput, CostEstimate, ProviderOutput } from '@reaatech/media-pipeline-mcp-provider-core';
+
+interface ComfyUIConfig {
+    baseUrl?: string;
+    workflowsDir?: string;
+    downloadOutputs?: boolean;
+    pollIntervalMs?: number;
+    retentionMs?: number;
+}
+interface ComfyParamSpec {
+    path: string;
+    type: 'string' | 'number' | 'boolean' | 'enum';
+    enum?: string[];
+    default?: unknown;
+    required?: boolean;
+}
+interface ComfyUIWorkflow {
+    name: string;
+    apiFormat: object;
+    inputs: Record<string, ComfyParamSpec>;
+    outputs: Record<string, 'image' | 'video' | 'mask' | 'latent'>;
+}
+declare class ComfyUIProvider extends MediaProvider {
+    static readonly id = "comfyui";
+    readonly name = "comfyui";
+    readonly supportedOperations: string[];
+    /**
+     * §0.6 capability declarations. ComfyUI exposes per-node progress as it executes a
+     * workflow (we surface it via the F6 progress bridge during pollForCompletion), but
+     * does not push outbound webhooks.
+     */
+    readonly supportsStreaming: Set<string>;
+    readonly supportsWebhooks = false;
+    /**
+     * F2 cacheConfig per plan §F10 "Per-implementation features":
+     *   "det per fixed `seed`; cache enabled when seed is provided and non-negative"
+     *
+     * All workflow inputs are deterministic given a fixed seed. The non-det list is
+     * empty because there is no provider-side request id (ComfyUI's `prompt_id` is
+     * generated post-submit and is not user-supplied). Normalize trims string params.
+     */
+    static cacheConfig: ProviderCacheConfig;
+    private baseUrl;
+    private pollIntervalMs;
+    private retentionMs;
+    private downloadOutputs;
+    private workflows;
+    private workflowsDir?;
+    private workflowsDirLoaded;
+    constructor(config?: ComfyUIConfig);
+    /**
+     * Plan §F10 "Mechanism (ComfyUI) #1": load user workflows from `workflowsDir/*.json`
+     * at construction time. We do it lazily (first execute / explicit call) so that the
+     * constructor stays sync and tests can mock fs.
+     *
+     * Each file becomes `custom/<basename>` workflow. The JSON must declare `apiFormat`,
+     * `inputs`, and `outputs` keys (the ComfyUIWorkflow shape). Files that don't match
+     * the shape are skipped with a warning.
+     */
+    loadWorkflowsFromDir(): Promise<void>;
+    healthCheck(): Promise<ProviderHealth>;
+    estimateCost(_input: ProviderInput): Promise<CostEstimate>;
+    registerWorkflow(name: string, workflow: ComfyUIWorkflow): void;
+    getWorkflow(name: string): ComfyUIWorkflow | undefined;
+    listWorkflows(): string[];
+    execute(input: ProviderInput): Promise<ProviderOutput>;
+    private resolveWorkflowName;
+    private runWorkflow;
+    private pollForCompletion;
+    private setNestedValue;
+    private mimeTypeFromFilename;
+    private sleep;
+}
+declare function createComfyUIProvider(config?: ComfyUIConfig): ComfyUIProvider;
+
+export { type ComfyParamSpec, type ComfyUIConfig, ComfyUIProvider, type ComfyUIWorkflow, createComfyUIProvider };