@phuetz/code-buddy 1.6.0 → 2.0.0

package/dist/media/comfyui-recipe-contract.d.ts

@@ -0,0 +1,696 @@
+import { z } from 'zod';
+export declare const COMFYUI_RECIPE_SCHEMA_VERSION: 1;
+export declare const MAX_COMFYUI_RECIPE_BYTES: number;
+export declare const MAX_COMFYUI_WORKFLOW_NODES = 512;
+export type ComfyUIModality = 'text' | 'image' | 'mask' | 'audio' | 'video' | '3d';
+export type ComfyUIOutputType = 'image' | 'video' | 'audio' | 'glb';
+export type ComfyUIResourceTier = 'low' | 'balanced' | 'high' | 'extreme';
+declare const bindingTargetSchema: z.ZodObject<{
+    nodeId: z.ZodString;
+    input: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    input: string;
+    nodeId: string;
+}, {
+    input: string;
+    nodeId: string;
+}>;
+declare const workflowNodeSchema: z.ZodObject<{
+    class_type: z.ZodString;
+    inputs: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strict", z.ZodTypeAny, {
+    class_type: string;
+    inputs: Record<string, unknown>;
+    _meta?: Record<string, unknown> | undefined;
+}, {
+    class_type: string;
+    inputs: Record<string, unknown>;
+    _meta?: Record<string, unknown> | undefined;
+}>;
+export declare const comfyUIRecipeSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    id: z.ZodString;
+    version: z.ZodString;
+    title: z.ZodString;
+    modalities: z.ZodArray<z.ZodEnum<["text", "image", "mask", "audio", "video", "3d"]>, "many">;
+    license: z.ZodObject<{
+        spdx: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    }, "strict", z.ZodTypeAny, {
+        spdx: string;
+        name?: string | undefined;
+        url?: string | undefined;
+    }, {
+        spdx: string;
+        name?: string | undefined;
+        url?: string | undefined;
+    }>;
+    commercialAllowed: z.ZodBoolean;
+    workflow: z.ZodObject<{
+        format: z.ZodLiteral<"comfyui-api">;
+        nodes: z.ZodRecord<z.ZodString, z.ZodObject<{
+            class_type: z.ZodString;
+            inputs: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strict", z.ZodTypeAny, {
+            class_type: string;
+            inputs: Record<string, unknown>;
+            _meta?: Record<string, unknown> | undefined;
+        }, {
+            class_type: string;
+            inputs: Record<string, unknown>;
+            _meta?: Record<string, unknown> | undefined;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        format: "comfyui-api";
+        nodes: Record<string, {
+            class_type: string;
+            inputs: Record<string, unknown>;
+            _meta?: Record<string, unknown> | undefined;
+        }>;
+    }, {
+        format: "comfyui-api";
+        nodes: Record<string, {
+            class_type: string;
+            inputs: Record<string, unknown>;
+            _meta?: Record<string, unknown> | undefined;
+        }>;
+    }>;
+    requirements: z.ZodObject<{
+        nodes: z.ZodArray<z.ZodObject<{
+            classType: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            classType: string;
+        }, {
+            classType: string;
+        }>, "many">;
+        models: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            relativePath: z.ZodString;
+            minBytes: z.ZodNumber;
+            sha256: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            id: string;
+            minBytes: number;
+            relativePath: string;
+            sha256?: string | undefined;
+        }, {
+            id: string;
+            minBytes: number;
+            relativePath: string;
+            sha256?: string | undefined;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        models: {
+            id: string;
+            minBytes: number;
+            relativePath: string;
+            sha256?: string | undefined;
+        }[];
+        nodes: {
+            classType: string;
+        }[];
+    }, {
+        models: {
+            id: string;
+            minBytes: number;
+            relativePath: string;
+            sha256?: string | undefined;
+        }[];
+        nodes: {
+            classType: string;
+        }[];
+    }>;
+    bindings: z.ZodObject<{
+        prompt: z.ZodObject<{
+            nodeId: z.ZodString;
+            input: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            input: string;
+            nodeId: string;
+        }, {
+            input: string;
+            nodeId: string;
+        }>;
+        negativePrompt: z.ZodOptional<z.ZodObject<{
+            nodeId: z.ZodString;
+            input: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            input: string;
+            nodeId: string;
+        }, {
+            input: string;
+            nodeId: string;
+        }>>;
+        seed: z.ZodOptional<z.ZodObject<{
+            nodeId: z.ZodString;
+            input: z.ZodString;
+        } & {
+            default: z.ZodOptional<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            input: string;
+            nodeId: string;
+            default?: number | undefined;
+        }, {
+            input: string;
+            nodeId: string;
+            default?: number | undefined;
+        }>>;
+        dimensions: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+            width: z.ZodObject<{
+                nodeId: z.ZodString;
+                input: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                input: string;
+                nodeId: string;
+            }, {
+                input: string;
+                nodeId: string;
+            }>;
+            height: z.ZodObject<{
+                nodeId: z.ZodString;
+                input: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                input: string;
+                nodeId: string;
+            }, {
+                input: string;
+                nodeId: string;
+            }>;
+            default: z.ZodObject<{
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, "strict", z.ZodTypeAny, {
+                width: number;
+                height: number;
+            }, {
+                width: number;
+                height: number;
+            }>;
+            min: z.ZodDefault<z.ZodNumber>;
+            max: z.ZodDefault<z.ZodNumber>;
+            multipleOf: z.ZodDefault<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            default: {
+                width: number;
+                height: number;
+            };
+            max: number;
+            multipleOf: number;
+            min: number;
+            width: {
+                input: string;
+                nodeId: string;
+            };
+            height: {
+                input: string;
+                nodeId: string;
+            };
+        }, {
+            default: {
+                width: number;
+                height: number;
+            };
+            width: {
+                input: string;
+                nodeId: string;
+            };
+            height: {
+                input: string;
+                nodeId: string;
+            };
+            max?: number | undefined;
+            multipleOf?: number | undefined;
+            min?: number | undefined;
+        }>, {
+            default: {
+                width: number;
+                height: number;
+            };
+            max: number;
+            multipleOf: number;
+            min: number;
+            width: {
+                input: string;
+                nodeId: string;
+            };
+            height: {
+                input: string;
+                nodeId: string;
+            };
+        }, {
+            default: {
+                width: number;
+                height: number;
+            };
+            width: {
+                input: string;
+                nodeId: string;
+            };
+            height: {
+                input: string;
+                nodeId: string;
+            };
+            max?: number | undefined;
+            multipleOf?: number | undefined;
+            min?: number | undefined;
+        }>>;
+        images: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            nodeId: z.ZodString;
+            input: z.ZodString;
+        } & {
+            required: z.ZodDefault<z.ZodBoolean>;
+        } & {
+            id: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            required: boolean;
+            id: string;
+            input: string;
+            nodeId: string;
+        }, {
+            id: string;
+            input: string;
+            nodeId: string;
+            required?: boolean | undefined;
+        }>, "many">>;
+        mask: z.ZodOptional<z.ZodObject<{
+            nodeId: z.ZodString;
+            input: z.ZodString;
+        } & {
+            required: z.ZodDefault<z.ZodBoolean>;
+        }, "strict", z.ZodTypeAny, {
+            required: boolean;
+            input: string;
+            nodeId: string;
+        }, {
+            input: string;
+            nodeId: string;
+            required?: boolean | undefined;
+        }>>;
+        audio: z.ZodOptional<z.ZodObject<{
+            nodeId: z.ZodString;
+            input: z.ZodString;
+        } & {
+            required: z.ZodDefault<z.ZodBoolean>;
+        }, "strict", z.ZodTypeAny, {
+            required: boolean;
+            input: string;
+            nodeId: string;
+        }, {
+            input: string;
+            nodeId: string;
+            required?: boolean | undefined;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        prompt: {
+            input: string;
+            nodeId: string;
+        };
+        images: {
+            required: boolean;
+            id: string;
+            input: string;
+            nodeId: string;
+        }[];
+        audio?: {
+            required: boolean;
+            input: string;
+            nodeId: string;
+        } | undefined;
+        seed?: {
+            input: string;
+            nodeId: string;
+            default?: number | undefined;
+        } | undefined;
+        dimensions?: {
+            default: {
+                width: number;
+                height: number;
+            };
+            max: number;
+            multipleOf: number;
+            min: number;
+            width: {
+                input: string;
+                nodeId: string;
+            };
+            height: {
+                input: string;
+                nodeId: string;
+            };
+        } | undefined;
+        mask?: {
+            required: boolean;
+            input: string;
+            nodeId: string;
+        } | undefined;
+        negativePrompt?: {
+            input: string;
+            nodeId: string;
+        } | undefined;
+    }, {
+        prompt: {
+            input: string;
+            nodeId: string;
+        };
+        audio?: {
+            input: string;
+            nodeId: string;
+            required?: boolean | undefined;
+        } | undefined;
+        seed?: {
+            input: string;
+            nodeId: string;
+            default?: number | undefined;
+        } | undefined;
+        dimensions?: {
+            default: {
+                width: number;
+                height: number;
+            };
+            width: {
+                input: string;
+                nodeId: string;
+            };
+            height: {
+                input: string;
+                nodeId: string;
+            };
+            max?: number | undefined;
+            multipleOf?: number | undefined;
+            min?: number | undefined;
+        } | undefined;
+        images?: {
+            id: string;
+            input: string;
+            nodeId: string;
+            required?: boolean | undefined;
+        }[] | undefined;
+        mask?: {
+            input: string;
+            nodeId: string;
+            required?: boolean | undefined;
+        } | undefined;
+        negativePrompt?: {
+            input: string;
+            nodeId: string;
+        } | undefined;
+    }>;
+    outputs: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodEnum<["image", "video", "audio", "glb"]>;
+        nodeId: z.ZodString;
+        field: z.ZodEnum<["images", "videos", "audio", "gifs", "files", "glbs"]>;
+        required: z.ZodDefault<z.ZodBoolean>;
+        maxItems: z.ZodDefault<z.ZodNumber>;
+        maxBytes: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        type: "audio" | "image" | "video" | "glb";
+        required: boolean;
+        id: string;
+        field: "audio" | "files" | "images" | "videos" | "gifs" | "glbs";
+        nodeId: string;
+        maxItems: number;
+        maxBytes?: number | undefined;
+    }, {
+        type: "audio" | "image" | "video" | "glb";
+        id: string;
+        field: "audio" | "files" | "images" | "videos" | "gifs" | "glbs";
+        nodeId: string;
+        required?: boolean | undefined;
+        maxBytes?: number | undefined;
+        maxItems?: number | undefined;
+    }>, "many">;
+    resources: z.ZodObject<{
+        tier: z.ZodEnum<["low", "balanced", "high", "extreme"]>;
+        minVramMiB: z.ZodNumber;
+        minRamMiB: z.ZodNumber;
+        estimatedSeconds: z.ZodOptional<z.ZodNumber>;
+        maxConcurrency: z.ZodDefault<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        tier: "high" | "low" | "balanced" | "extreme";
+        maxConcurrency: number;
+        minVramMiB: number;
+        minRamMiB: number;
+        estimatedSeconds?: number | undefined;
+    }, {
+        tier: "high" | "low" | "balanced" | "extreme";
+        minVramMiB: number;
+        minRamMiB: number;
+        maxConcurrency?: number | undefined;
+        estimatedSeconds?: number | undefined;
+    }>;
+    fallback: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        reason?: string | undefined;
+        version?: string | undefined;
+    }, {
+        id: string;
+        reason?: string | undefined;
+        version?: string | undefined;
+    }>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    title: string;
+    id: string;
+    version: string;
+    modalities: ("text" | "audio" | "image" | "video" | "3d" | "mask")[];
+    workflow: {
+        format: "comfyui-api";
+        nodes: Record<string, {
+            class_type: string;
+            inputs: Record<string, unknown>;
+            _meta?: Record<string, unknown> | undefined;
+        }>;
+    };
+    license: {
+        spdx: string;
+        name?: string | undefined;
+        url?: string | undefined;
+    };
+    schemaVersion: 1;
+    fallback: {
+        id: string;
+        reason?: string | undefined;
+        version?: string | undefined;
+    }[];
+    resources: {
+        tier: "high" | "low" | "balanced" | "extreme";
+        maxConcurrency: number;
+        minVramMiB: number;
+        minRamMiB: number;
+        estimatedSeconds?: number | undefined;
+    };
+    bindings: {
+        prompt: {
+            input: string;
+            nodeId: string;
+        };
+        images: {
+            required: boolean;
+            id: string;
+            input: string;
+            nodeId: string;
+        }[];
+        audio?: {
+            required: boolean;
+            input: string;
+            nodeId: string;
+        } | undefined;
+        seed?: {
+            input: string;
+            nodeId: string;
+            default?: number | undefined;
+        } | undefined;
+        dimensions?: {
+            default: {
+                width: number;
+                height: number;
+            };
+            max: number;
+            multipleOf: number;
+            min: number;
+            width: {
+                input: string;
+                nodeId: string;
+            };
+            height: {
+                input: string;
+                nodeId: string;
+            };
+        } | undefined;
+        mask?: {
+            required: boolean;
+            input: string;
+            nodeId: string;
+        } | undefined;
+        negativePrompt?: {
+            input: string;
+            nodeId: string;
+        } | undefined;
+    };
+    outputs: {
+        type: "audio" | "image" | "video" | "glb";
+        required: boolean;
+        id: string;
+        field: "audio" | "files" | "images" | "videos" | "gifs" | "glbs";
+        nodeId: string;
+        maxItems: number;
+        maxBytes?: number | undefined;
+    }[];
+    requirements: {
+        models: {
+            id: string;
+            minBytes: number;
+            relativePath: string;
+            sha256?: string | undefined;
+        }[];
+        nodes: {
+            classType: string;
+        }[];
+    };
+    commercialAllowed: boolean;
+}, {
+    title: string;
+    id: string;
+    version: string;
+    modalities: ("text" | "audio" | "image" | "video" | "3d" | "mask")[];
+    workflow: {
+        format: "comfyui-api";
+        nodes: Record<string, {
+            class_type: string;
+            inputs: Record<string, unknown>;
+            _meta?: Record<string, unknown> | undefined;
+        }>;
+    };
+    license: {
+        spdx: string;
+        name?: string | undefined;
+        url?: string | undefined;
+    };
+    schemaVersion: 1;
+    resources: {
+        tier: "high" | "low" | "balanced" | "extreme";
+        minVramMiB: number;
+        minRamMiB: number;
+        maxConcurrency?: number | undefined;
+        estimatedSeconds?: number | undefined;
+    };
+    bindings: {
+        prompt: {
+            input: string;
+            nodeId: string;
+        };
+        audio?: {
+            input: string;
+            nodeId: string;
+            required?: boolean | undefined;
+        } | undefined;
+        seed?: {
+            input: string;
+            nodeId: string;
+            default?: number | undefined;
+        } | undefined;
+        dimensions?: {
+            default: {
+                width: number;
+                height: number;
+            };
+            width: {
+                input: string;
+                nodeId: string;
+            };
+            height: {
+                input: string;
+                nodeId: string;
+            };
+            max?: number | undefined;
+            multipleOf?: number | undefined;
+            min?: number | undefined;
+        } | undefined;
+        images?: {
+            id: string;
+            input: string;
+            nodeId: string;
+            required?: boolean | undefined;
+        }[] | undefined;
+        mask?: {
+            input: string;
+            nodeId: string;
+            required?: boolean | undefined;
+        } | undefined;
+        negativePrompt?: {
+            input: string;
+            nodeId: string;
+        } | undefined;
+    };
+    outputs: {
+        type: "audio" | "image" | "video" | "glb";
+        id: string;
+        field: "audio" | "files" | "images" | "videos" | "gifs" | "glbs";
+        nodeId: string;
+        required?: boolean | undefined;
+        maxBytes?: number | undefined;
+        maxItems?: number | undefined;
+    }[];
+    requirements: {
+        models: {
+            id: string;
+            minBytes: number;
+            relativePath: string;
+            sha256?: string | undefined;
+        }[];
+        nodes: {
+            classType: string;
+        }[];
+    };
+    commercialAllowed: boolean;
+    fallback?: {
+        id: string;
+        reason?: string | undefined;
+        version?: string | undefined;
+    }[] | undefined;
+}>;
+export type ComfyUIRecipe = z.infer<typeof comfyUIRecipeSchema>;
+export type ComfyUIWorkflowNode = z.infer<typeof workflowNodeSchema>;
+export type ComfyUIBindingTarget = z.infer<typeof bindingTargetSchema>;
+export interface ComfyUIRecipeSelector {
+    id: string;
+    version?: string;
+}
+export interface ComfyUIRecipeRunInputs {
+    prompt: string;
+    negativePrompt?: string;
+    seed?: number;
+    dimensions?: {
+        width: number;
+        height: number;
+    };
+    images?: Record<string, string>;
+    mask?: string;
+    audio?: string;
+}
+export interface MaterializedComfyUIWorkflow {
+    workflow: Record<string, ComfyUIWorkflowNode>;
+    seed?: number;
+    dimensions?: {
+        width: number;
+        height: number;
+    };
+}
+export declare class ComfyUIRecipeValidationError extends Error {
+    readonly issues: readonly string[];
+    constructor(message: string, issues?: readonly string[]);
+}
+/** Validate and clone an untrusted declarative recipe. */
+export declare function validateComfyUIRecipe(value: unknown): ComfyUIRecipe;
+/** Replace only exact, contract-declared placeholders with typed input values. */
+export declare function materializeComfyUIWorkflow(recipe: ComfyUIRecipe, inputs: ComfyUIRecipeRunInputs, seedFactory?: () => number): MaterializedComfyUIWorkflow;
+export declare function isSafeComfyUIRelativePath(value: string): boolean;
+export declare function isSafeComfyUIAssetReference(value: string): boolean;
+export {};