tongflow 0.2.0 → 1.0.0

package/dist/canvas.d.cts

@@ -4,7 +4,7 @@ import { Edge, EdgeTypes, Node, NodeTypes, OnConnect, OnEdgesChange, OnNodesChan
 import { JSONSchema7 } from "json-schema";
 import { FromSchema } from "json-schema-to-ts";
 import "zustand/vanilla";
-import "zod";
+import { z } from "zod";
 import { ClassValue } from "clsx";
 import * as AlertDialogPrimitive from "@radix-ui/react-alert-dialog";
 import { VariantProps } from "class-variance-authority";
@@ -777,6 +777,41 @@ declare const _slot_gen_music_inputs: {
   readonly additionalProperties: false;
 };
 type GenMusicInput = FromSchema<typeof _slot_gen_music_inputs>;
+declare const _slot_text_gen_audio_inputs: {
+  readonly type: "object";
+  readonly required: readonly ["text"];
+  readonly properties: {
+    readonly text: {
+      readonly type: "string";
+      readonly minLength: 1;
+    };
+    readonly ref_audios: {
+      readonly type: "array";
+      readonly items: {
+        readonly type: "object";
+        readonly required: readonly ["bytesBase64"];
+        readonly properties: {
+          readonly bytesBase64: {
+            readonly type: "string";
+            readonly minLength: 1;
+          };
+          readonly filename: {
+            readonly type: "string";
+          };
+          readonly mime: {
+            readonly type: "string";
+          };
+        };
+        readonly additionalProperties: false;
+      };
+    };
+    readonly seed: {
+      readonly type: "integer";
+    };
+  };
+  readonly additionalProperties: false;
+};
+type TextGenAudioInput = FromSchema<typeof _slot_text_gen_audio_inputs>;
 declare const _slot_text_gen_speech_preset_inputs: {
   readonly type: "object";
   readonly required: readonly ["text"];
@@ -2026,9 +2061,9 @@ declare const _slot_denoise_audio_inputs: {
 type DenoiseAudioInput = FromSchema<typeof _slot_denoise_audio_inputs>;
 declare const _slot_convert_voice_inputs: {
   readonly type: "object";
-  readonly required: readonly ["sourceKey", "targetKey"];
+  readonly required: readonly ["audio", "ref_audio"];
   readonly properties: {
-    readonly sourceKey: {
+    readonly audio: {
       readonly type: "object";
       readonly required: readonly ["bytesBase64"];
       readonly properties: {
@@ -2045,8 +2080,22 @@ declare const _slot_convert_voice_inputs: {
       };
       readonly additionalProperties: false;
     };
-    readonly targetKey: {
-      readonly type: "string";
+    readonly ref_audio: {
+      readonly type: "object";
+      readonly required: readonly ["bytesBase64"];
+      readonly properties: {
+        readonly bytesBase64: {
+          readonly type: "string";
+          readonly minLength: 1;
+        };
+        readonly filename: {
+          readonly type: "string";
+        };
+        readonly mime: {
+          readonly type: "string";
+        };
+      };
+      readonly additionalProperties: false;
     };
   };
   readonly additionalProperties: false;
@@ -2262,7 +2311,7 @@ declare const _slot_video_gen_model_inputs: {
   readonly additionalProperties: false;
 };
 type VideoGenModelInput = FromSchema<typeof _slot_video_gen_model_inputs>;
-type NodeSlot = "gen-text" | "split-text" | "combine-text" | "image-fusion" | "images-gen-video" | "refs-gen-video" | "image-gen-text" | "video-gen-text" | "transcribe" | "concat-videos" | "extract-audio" | "remove-video-audio" | "merge-video-audio" | "audio-video-lip-sync" | "get-first-frame" | "get-last-frame" | "parse-document" | "split-video" | "link" | "image-gen" | "gen-music" | "text-gen-speech-preset" | "image-gen-video" | "image-edit" | "image-upscale" | "video-upscale" | "video-edit" | "image-describe" | "video-describe" | "audio-describe" | "music-repaint" | "music-cover" | "music-extract" | "separate-sound" | "music-lego" | "music-complete" | "music-brief" | "audio-image-gen-video" | "speech-text-gen-video" | "video-image-gen-video-mix" | "video-image-gen-video-move" | "image-image-gen-video" | "text-gen-video" | "image-gen-model" | "speech-video-gen-video" | "text-gen-speech-clone" | "transcribe-timestamp" | "text-gen-speech-instruct" | "drop-video" | "arrange-group" | "separate_speaker" | "separate_audio_track" | "denoise_audio" | "convert_voice" | "remove_watermark" | "subtitle_remove" | "text-audio-gen-speech" | "image-pose" | "image-body-seg" | "image-normal" | "image-matting" | "video-gen-model";
+type NodeSlot = "gen-text" | "split-text" | "combine-text" | "image-fusion" | "images-gen-video" | "refs-gen-video" | "image-gen-text" | "video-gen-text" | "transcribe" | "concat-videos" | "extract-audio" | "remove-video-audio" | "merge-video-audio" | "audio-video-lip-sync" | "get-first-frame" | "get-last-frame" | "parse-document" | "split-video" | "link" | "image-gen" | "gen-music" | "text-gen-audio" | "text-gen-speech-preset" | "image-gen-video" | "image-edit" | "image-upscale" | "video-upscale" | "video-edit" | "image-describe" | "video-describe" | "audio-describe" | "music-repaint" | "music-cover" | "music-extract" | "separate-sound" | "music-lego" | "music-complete" | "music-brief" | "audio-image-gen-video" | "speech-text-gen-video" | "video-image-gen-video-mix" | "video-image-gen-video-move" | "image-image-gen-video" | "text-gen-video" | "image-gen-model" | "speech-video-gen-video" | "text-gen-speech-clone" | "transcribe-timestamp" | "text-gen-speech-instruct" | "drop-video" | "arrange-group" | "separate_speaker" | "separate_audio_track" | "denoise_audio" | "convert_voice" | "remove_watermark" | "subtitle_remove" | "text-audio-gen-speech" | "image-pose" | "image-body-seg" | "image-normal" | "image-matting" | "video-gen-model";
 type SlotInputsMap = {
   "gen-text": GenTextInput;
   "split-text": SplitTextInput;
@@ -2285,6 +2334,7 @@ type SlotInputsMap = {
   link: LinkInput;
   "image-gen": ImageGenInput;
   "gen-music": GenMusicInput;
+  "text-gen-audio": TextGenAudioInput;
   "text-gen-speech-preset": TextGenSpeechPresetInput;
   "image-gen-video": ImageGenVideoInput;
   "image-edit": ImageEditInput;
@@ -2487,9 +2537,15 @@ interface FlowCoreState {
    */
   expands: (nodeId: string | null, possibleNodes: PossibleNode[]) => string[];
   /** Create a node fed by every combo-selected node; returns the new id. */
+  /**
+   * Create a node from the combo selection and wire every selected node into
+   * it. `sourceOrder` overrides the selection order used to assign handles
+   * (sources are matched to target fields in ABI input order).
+   */
   compose: (newNode: {
     type: string;
     data: unknown;
+    sourceOrder?: string[];
   }) => string;
   /** Replace a node's `data`. `history: false` skips the undo snapshot. */
   updates: (nodeId: string, data: Record<string, unknown>, opts?: {
@@ -2585,6 +2641,54 @@ type TaskStatusType = (typeof TaskStatus)[keyof typeof TaskStatus];
 type WorkflowStatusType = (typeof WorkflowStatus)[keyof typeof WorkflowStatus];
 type NodeStatusType = (typeof NodeStatus)[keyof typeof NodeStatus];
 //#endregion
+//#region src/core/registry/plugins-registry-schema.d.ts
+declare const PluginParamSpecSchema: z.ZodObject<{
+  type: z.ZodEnum<{
+    number: "number";
+    boolean: "boolean";
+    select: "select";
+    text: "text";
+    integer: "integer";
+  }>;
+  label: z.ZodOptional<z.ZodString>;
+  description: z.ZodOptional<z.ZodString>;
+  default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+  options: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+  min: z.ZodOptional<z.ZodNumber>;
+  max: z.ZodOptional<z.ZodNumber>;
+  step: z.ZodOptional<z.ZodNumber>;
+  models: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Optional live model catalog (`TONGFLOW_MODEL_CATALOG` in the plugin source).
+ * The canvas GETs `url` in the browser (public, CORS-enabled, no auth) — or,
+ * when `authEnv` names the env key holding a bearer token, through the app's
+ * `/api/plugins/model-catalog` route, which injects the stored key server-side
+ * — reads the record array at dot-path `items`, each model id at dot-path `id`, drops
+ * records where an `exclude` field equals its literal, and keeps a record for
+ * a slot when every `slots[slot]` token is a substring of the named field
+ * (arrays/objects are JSON-serialized before matching; a token prefixed with
+ * `!` must be absent instead). Matching ids extend
+ * that slot's dropdown after the static `models` shortlist.
+ */
+declare const PluginModelCatalogSchema: z.ZodObject<{
+  url: z.ZodString;
+  authEnv: z.ZodOptional<z.ZodString>;
+  items: z.ZodDefault<z.ZodString>;
+  id: z.ZodDefault<z.ZodString>;
+  exclude: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodBoolean, z.ZodNumber]>>>;
+  slots: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>>;
+}, z.core.$strip>;
+type PluginModelCatalog = z.infer<typeof PluginModelCatalogSchema>;
+type PluginParamSpec = z.infer<typeof PluginParamSpecSchema>;
+//#endregion
+//#region src/core/registry/plugin-params.d.ts
+/** A plugin's declared params for one slot, in declaration order. */
+type PluginParamEntry = {
+  name: string;
+  spec: PluginParamSpec;
+};
+//#endregion
 //#region src/core/schema/tongflow-abi.d.ts
 interface ResolvedOutputRoute {
   sourceField: string;
@@ -2613,6 +2717,10 @@ interface BaseNodeData extends Record<string, unknown> {
   /** Selected model for router-style plugins that declare per-slot model
    * lists; empty/absent means the plugin's default. */
   pluginModel?: string;
+  /** Advanced parameters chosen for the active plugin (keys from its
+   * `TONGFLOW_SLOT_PARAMS`); only values differing from the declared default
+   * are kept, so absent means the plugin's own default. */
+  pluginParams?: Record<string, unknown>;
   /** Composition linkage (`useNodesData`) */
   ids?: string[];
   texts?: string[];
@@ -2678,6 +2786,7 @@ declare function useNodePluginResolver(feature: string | undefined): {
   defaultPluginIdFromRegistry: string;
   resolveActivePluginId: () => string;
   resolveActiveModel: () => string | undefined;
+  resolveActiveParams: () => Record<string, unknown> | undefined;
 };
 //#endregion
 //#region src/canvas/hooks/use-task.d.ts
@@ -2728,6 +2837,9 @@ interface TaskCreationConfig {
   pluginId: string;
   /** Selected model for router-style plugins; omitted otherwise. */
   model?: string;
+  /** Advanced parameters (plugin's `TONGFLOW_SLOT_PARAMS` keys); omitted
+   * when the node runs on plugin defaults. */
+  params?: Record<string, unknown>;
   prompt: Record<string, unknown>;
   nodeId: string;
   workflowId?: number;
@@ -2749,7 +2861,7 @@ declare const useTaskStore: import("zustand").UseBoundStore<import("zustand").St
  * Handles connection lifecycle, reconnect, and parsing.
  */
 declare function useTaskSubscription(taskId?: string, options?: TaskSubscriptionOptions): {
-  status: "error" | "connecting" | "connected" | "reconnecting" | "disconnected";
+  status: "connecting" | "connected" | "reconnecting" | "disconnected" | "error";
 };
 /**
  * Create a task and automatically attach SSE streaming.
@@ -2931,7 +3043,11 @@ type PluginsRegistryPayload = {
     methodsByNodeSlot?: Record<string, {
       methodName: string;
       models?: string[];
+      /** Advanced params declared via `TONGFLOW_SLOT_PARAMS`. */
+      params?: Record<string, PluginParamSpec>;
     }>;
+    /** Live model catalog declared via `TONGFLOW_MODEL_CATALOG`. */
+    modelCatalog?: PluginModelCatalog;
     /** Presentation metadata merged from `tongflow.plugin.json`. */
     name?: string;
     description?: string;
@@ -2961,11 +3077,38 @@ declare function usePluginsRegistry(): {
 declare function refreshPluginsRegistry(): Promise<void>;
 /** Plugin directory names registered for a single ABI `nodeSlot`. */
 declare function useNodePluginIds(nodeSlot: string): string[];
+type LiveModelsEntry = {
+  fetchedAt: number;
+  bySlot: Record<string, string[]>;
+};
+type LiveModelsState = {
+  byPlugin: Record<string, LiveModelsEntry>;
+};
+declare const useLiveModelsStore: import("zustand").UseBoundStore<import("zustand").StoreApi<LiveModelsState>>;
+/**
+ * Fetch (or refresh, once the TTL elapsed) a plugin's live model catalog. Safe
+ * to call eagerly — it is a no-op for plugins without a catalog and while a
+ * fresh result is cached.
+ */
+declare function loadPluginModelCatalog(pluginId: string): Promise<void>;
 /**
- * Model ids a plugin declares for one ABI `nodeSlot` (empty for single-model
- * plugins — the model dropdown is hidden in that case).
+ * Synchronous read of a plugin's model ids for one slot: the static shortlist
+ * (declared order, first = default) followed by any live-catalog extras.
+ */
+declare function getNodePluginModels(nodeSlot: string, pluginId: string): string[];
+/**
+ * Model ids a plugin offers for one ABI `nodeSlot` (empty for single-model
+ * plugins — the model dropdown is hidden in that case): the static shortlist
+ * plus live-catalog extras, which this hook fetches on first use.
  */
 declare function useNodePluginModels(nodeSlot: string, pluginId: string): string[];
+/**
+ * Synchronous read of the params a plugin offers for one slot given the
+ * selected model, in declaration order.
+ */
+declare function getNodePluginParams(nodeSlot: string, pluginId: string, model: string | undefined): PluginParamEntry[];
+/** Reactive form of {@link getNodePluginParams}. */
+declare function useNodePluginParams(nodeSlot: string, pluginId: string, model: string | undefined): PluginParamEntry[];
 type PluginMeta = {
   name?: string;
   description?: string;
@@ -3286,6 +3429,9 @@ interface CreateTaskRequest {
   pluginId: string;
   /** Selected model for router-style plugins; omitted otherwise. */
   model?: string;
+  /** Advanced parameters (plugin's `TONGFLOW_SLOT_PARAMS` keys); omitted
+   * when the node runs on plugin defaults. */
+  params?: Record<string, unknown>;
   prompt: Record<string, unknown>;
   nodeId: string;
   workflowId?: number;
@@ -3534,7 +3680,7 @@ type NodeType = keyof typeof NODE_TYPES;
 declare const NODE_CATEGORIES: {
   readonly DATA: readonly ["imageNode", "textNode", "videoNode", "audioNode", "fileNode", "modelNode", "linkNode"];
   readonly ADD: readonly ["addImageNode", "addTextNode", "addAudioNode", "addVideoNode", "addLinkNode", "addFileNode", "addModelNode"];
-  readonly TRANSFORM: readonly ["imageGenVideoNode", "textGenVideoNode", "imageGenModelNode", "imagePoseNode", "imageBodySegNode", "imageNormalNode", "imageMattingNode", "videoGenModelNode", "speechGenVideoNode", "imageGenImageNode", "imageGenImageUpscaleNode", "genTextNode", "textGenImageNode", "textGenMusicNode", "textGenSpeechCloneNode", "textGenSpeechPresetNode", "textGenSpeechInstructNode", "removeVideoSubtitleNode", "removeWatermarkNode", "videoUpscaleNode", "videoEditNode", "extractAudioNode", "removeVideoAudioNode", "denoiseAudioSubtitleNode", "separateAudioTrackNode", "separateSpeakerNode", "convertVoiceNode", "audioDescribeNode", "imageGenTextNode", "videoGenTextNode", "videoGenTextSpeechRecognizeNode", "audioGenTextSpeechRecognizeNode", "fileGenTextNode", "linkGenTextNode", "getFirstFrameNode", "getLastFrameNode", "musicRepaintNode", "musicExtractNode", "musicLegoNode", "musicCompleteNode"];
+  readonly TRANSFORM: readonly ["imageGenVideoNode", "textGenVideoNode", "imageGenModelNode", "imagePoseNode", "imageBodySegNode", "imageNormalNode", "imageMattingNode", "videoGenModelNode", "speechGenVideoNode", "imageGenImageNode", "imageGenImageUpscaleNode", "genTextNode", "textGenImageNode", "textGenMusicNode", "textGenAudioNode", "textGenSpeechCloneNode", "textGenSpeechPresetNode", "textGenSpeechInstructNode", "removeVideoSubtitleNode", "removeWatermarkNode", "videoUpscaleNode", "videoEditNode", "extractAudioNode", "removeVideoAudioNode", "denoiseAudioSubtitleNode", "separateAudioTrackNode", "separateSpeakerNode", "convertVoiceNode", "audioDescribeNode", "imageGenTextNode", "videoGenTextNode", "videoGenTextSpeechRecognizeNode", "audioGenTextSpeechRecognizeNode", "fileGenTextNode", "linkGenTextNode", "getFirstFrameNode", "getLastFrameNode", "musicRepaintNode", "musicExtractNode", "musicLegoNode", "musicCompleteNode"];
   readonly BATCH: readonly ["dropVideoNode", "arrangeNode", "concatVideoNode"];
   readonly COMPOSE: readonly ["mergeVideoAudioNode", "audioVideoLipSyncNode", "imageFusionNode", "imagesGenVideoNode", "refsGenVideoNode", "speechImageGenVideoNode", "speechTextGenVideoNode", "speechVideoGenVideoNode", "videoImageGenVideoMoveNode", "videoImageGenVideoMixNode", "imageImageGenVideoNode", "textAudioGenSpeechNode", "textGenSpeechCloneComposeNode", "imageGenVideoComposeNode", "textsGenTextNode", "concatVideoComposeNode", "musicCoverNode"];
   readonly DECOMPOSE: readonly ["splitVideoNode", "splitTextNode", "musicBriefNode", "separateSoundNode"];
@@ -3954,7 +4100,7 @@ declare class ErrorBoundary extends Component<Props, State> {
   static getDerivedStateFromError(error: Error): State;
   componentDidCatch(error: Error, info: ErrorInfo): void;
   handleReset: () => void;
-  render(): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react/jsx-runtime").JSX.Element | null | undefined;
+  render(): string | number | bigint | boolean | import("react/jsx-runtime").JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | null | undefined;
 }
 //#endregion
 //#region src/canvas/ui/error-toast.d.ts
@@ -4118,4 +4264,4 @@ interface WhiteBoardProps {
 }
 declare const WhiteBoard: React$1.ForwardRefExoticComponent<WhiteBoardProps & React$1.RefAttributes<WhiteBoardRef>>;
 //#endregion
-export { AbiOutputChannel, AbiOutputView, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AudioRecorderWithVisualizer, Badge, BatchTaskConfig, Button, CANVAS_LOCALES, CanvasHostConfig, CanvasLocale, CanvasProvider, CanvasProviderProps, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, ClientTranslator, ConfigState, CreateMaterialRequest, CreateMaterialResponse, CreateTaskRequest, CreateTaskResponse, DEFAULT_QWEN_SPEAKER, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EDGE_TYPES, ErrorBoundary, FORMAT_CATEGORIES, FileValidationResult, FlowCanvas, FlowCanvasHandle, FlowCanvasProps, FlowReactBindings, FlowState, Input, Label, LibInput, ListMaterialsResponse, ListTasksResponse, LoadPriority, LoadTask, Material, MaterialType, NODE_CATEGORIES, NODE_TYPES, NodePluginIdSelect, NodeTaskHandler, NodeType, PluginMeta, PluginsRegistryPayload, type PossibleNode, PresignedUrlResponse, Progress, QWEN_SPEAKERS, QwenSpeaker, QwenSpeakerGender, RECOMMENDATIONS, SSEMessage, SSEMessageData, SSENodeInfo, SSEStatus, SSE_TASK_MESSAGE_EVENT, SUPPORTED_FORMATS, SaveFromTaskRequest, SaveFromTaskResponse, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, ShowErrorToastOptions, Skeleton, Slider, SpeakerVoiceRecorder, Switch, TASK_CANCEL_REQUEST_EVENT, TROUBLESHOOTING, Tabs, TabsContent, TabsList, TabsTrigger, Task, TaskCancelRequestDetail, TaskCreationConfig, TaskRecord, TaskState, TaskSubscriptionOptions, Textarea, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TraceMaterialWorkflowResponse, UpdateStatusRequest, UpdateStatusResponse, UploadResponse, UploadState, UploadValidationError, UseAbiExecutionOptions, UseAbiExecutionReturn, UseAbiFormReturn, UseFileAsyncLoaderOptions, UseMultipleUploadOptions, UseUploadOptions, ValidationResult, VideoRecorder, WORKSPACE_MODE_KEY, Waterfall, WaterfallProps, WaterfallRenderProps, WhiteBoard, WhiteBoardRef, WorkflowExecutionStatus, WorkspaceMode, apiClient, apiDelete, apiGet, apiPatch, apiPost, apiPut, apiUrl, applyResolvedOutputRoutes, assetUrl, badgeVariants, buttonVariants, canvasMessages, cn, computeOutputView, configureCanvasHost, createMaterial, createTask, deleteMaterial, emitSSEConnected, emitSSETaskMessage, emitTaskCancelRequest, getCanvasHost, getCanvasLocale, getClientTranslator, getFileUrl, getGlobalFileCache, getGlobalFileQueue, getImageDimensions, getMaterialFileUrls, getPresignedUploadUrl, getPrivateFileUrl, getSharedFileUrl, getTaskStopUrl, getTaskWaitUrl, getVideoMetadata, hostFetch, isCanvasLocale, isImageFile, isVideoFile, listMaterials, listTasks, normalizeTaskPayloadData, pluginDisplayName, refreshPluginsRegistry, saveFromTask, setCanvasLocale, showErrorToast, toggleFavorite, traceMaterialWorkflow, updateTaskStatus, useAbiExecution, useAbiForm, useBatchTaskManager, useCreateTask, useDropzone, useFileAsyncLoader, useFileAsyncLoaderBatch, useFileLoaderStats, useFileUrl, useFlow, useMultipleUpload, useNodeAbiSpec, useNodePluginIds, useNodePluginIdsUnion, useNodePluginModels, useNodePluginResolver, useNodeState, useNodeTaskUpdate, useNodeType, usePluginMeta, usePluginsRegistry, usePluginsRegistryStore, useResolvedPluginId, useTask, useTaskStore, useTaskSubscription, useUpload, useUpstreamNodeIds, validateFile };
+export { AbiOutputChannel, AbiOutputView, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AudioRecorderWithVisualizer, Badge, BatchTaskConfig, Button, CANVAS_LOCALES, CanvasHostConfig, CanvasLocale, CanvasProvider, CanvasProviderProps, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, ClientTranslator, ConfigState, CreateMaterialRequest, CreateMaterialResponse, CreateTaskRequest, CreateTaskResponse, DEFAULT_QWEN_SPEAKER, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EDGE_TYPES, ErrorBoundary, FORMAT_CATEGORIES, FileValidationResult, FlowCanvas, FlowCanvasHandle, FlowCanvasProps, FlowReactBindings, FlowState, Input, Label, LibInput, ListMaterialsResponse, ListTasksResponse, LoadPriority, LoadTask, Material, MaterialType, NODE_CATEGORIES, NODE_TYPES, NodePluginIdSelect, NodeTaskHandler, NodeType, PluginMeta, PluginsRegistryPayload, type PossibleNode, PresignedUrlResponse, Progress, QWEN_SPEAKERS, QwenSpeaker, QwenSpeakerGender, RECOMMENDATIONS, SSEMessage, SSEMessageData, SSENodeInfo, SSEStatus, SSE_TASK_MESSAGE_EVENT, SUPPORTED_FORMATS, SaveFromTaskRequest, SaveFromTaskResponse, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, ShowErrorToastOptions, Skeleton, Slider, SpeakerVoiceRecorder, Switch, TASK_CANCEL_REQUEST_EVENT, TROUBLESHOOTING, Tabs, TabsContent, TabsList, TabsTrigger, Task, TaskCancelRequestDetail, TaskCreationConfig, TaskRecord, TaskState, TaskSubscriptionOptions, Textarea, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TraceMaterialWorkflowResponse, UpdateStatusRequest, UpdateStatusResponse, UploadResponse, UploadState, UploadValidationError, UseAbiExecutionOptions, UseAbiExecutionReturn, UseAbiFormReturn, UseFileAsyncLoaderOptions, UseMultipleUploadOptions, UseUploadOptions, ValidationResult, VideoRecorder, WORKSPACE_MODE_KEY, Waterfall, WaterfallProps, WaterfallRenderProps, WhiteBoard, WhiteBoardRef, WorkflowExecutionStatus, WorkspaceMode, apiClient, apiDelete, apiGet, apiPatch, apiPost, apiPut, apiUrl, applyResolvedOutputRoutes, assetUrl, badgeVariants, buttonVariants, canvasMessages, cn, computeOutputView, configureCanvasHost, createMaterial, createTask, deleteMaterial, emitSSEConnected, emitSSETaskMessage, emitTaskCancelRequest, getCanvasHost, getCanvasLocale, getClientTranslator, getFileUrl, getGlobalFileCache, getGlobalFileQueue, getImageDimensions, getMaterialFileUrls, getNodePluginModels, getNodePluginParams, getPresignedUploadUrl, getPrivateFileUrl, getSharedFileUrl, getTaskStopUrl, getTaskWaitUrl, getVideoMetadata, hostFetch, isCanvasLocale, isImageFile, isVideoFile, listMaterials, listTasks, loadPluginModelCatalog, normalizeTaskPayloadData, pluginDisplayName, refreshPluginsRegistry, saveFromTask, setCanvasLocale, showErrorToast, toggleFavorite, traceMaterialWorkflow, updateTaskStatus, useAbiExecution, useAbiForm, useBatchTaskManager, useCreateTask, useDropzone, useFileAsyncLoader, useFileAsyncLoaderBatch, useFileLoaderStats, useFileUrl, useFlow, useLiveModelsStore, useMultipleUpload, useNodeAbiSpec, useNodePluginIds, useNodePluginIdsUnion, useNodePluginModels, useNodePluginParams, useNodePluginResolver, useNodeState, useNodeTaskUpdate, useNodeType, usePluginMeta, usePluginsRegistry, usePluginsRegistryStore, useResolvedPluginId, useTask, useTaskStore, useTaskSubscription, useUpload, useUpstreamNodeIds, validateFile };

package/dist/canvas.d.ts

@@ -12,9 +12,9 @@ import * as TabsPrimitive from "@radix-ui/react-tabs";
 import * as AlertDialogPrimitive from "@radix-ui/react-alert-dialog";
 import * as DropdownMenuPrimitive from "@radix-ui/react-dropdown-menu";
 import * as LabelPrimitive from "@radix-ui/react-label";
+import * as SwitchPrimitive from "@radix-ui/react-switch";
 import * as ProgressPrimitive from "@radix-ui/react-progress";
 import * as SliderPrimitive from "@radix-ui/react-slider";
-import * as SwitchPrimitive from "@radix-ui/react-switch";
 import * as CheckboxPrimitive from "@radix-ui/react-checkbox";
 import * as SeparatorPrimitive from "@radix-ui/react-separator";
 import { JSONSchema7 } from "json-schema";
@@ -777,6 +777,41 @@ declare const _slot_gen_music_inputs: {
   readonly additionalProperties: false;
 };
 type GenMusicInput = FromSchema<typeof _slot_gen_music_inputs>;
+declare const _slot_text_gen_audio_inputs: {
+  readonly type: "object";
+  readonly required: readonly ["text"];
+  readonly properties: {
+    readonly text: {
+      readonly type: "string";
+      readonly minLength: 1;
+    };
+    readonly ref_audios: {
+      readonly type: "array";
+      readonly items: {
+        readonly type: "object";
+        readonly required: readonly ["bytesBase64"];
+        readonly properties: {
+          readonly bytesBase64: {
+            readonly type: "string";
+            readonly minLength: 1;
+          };
+          readonly filename: {
+            readonly type: "string";
+          };
+          readonly mime: {
+            readonly type: "string";
+          };
+        };
+        readonly additionalProperties: false;
+      };
+    };
+    readonly seed: {
+      readonly type: "integer";
+    };
+  };
+  readonly additionalProperties: false;
+};
+type TextGenAudioInput = FromSchema<typeof _slot_text_gen_audio_inputs>;
 declare const _slot_text_gen_speech_preset_inputs: {
   readonly type: "object";
   readonly required: readonly ["text"];
@@ -2026,9 +2061,9 @@ declare const _slot_denoise_audio_inputs: {
 type DenoiseAudioInput = FromSchema<typeof _slot_denoise_audio_inputs>;
 declare const _slot_convert_voice_inputs: {
   readonly type: "object";
-  readonly required: readonly ["sourceKey", "targetKey"];
+  readonly required: readonly ["audio", "ref_audio"];
   readonly properties: {
-    readonly sourceKey: {
+    readonly audio: {
       readonly type: "object";
       readonly required: readonly ["bytesBase64"];
       readonly properties: {
@@ -2045,8 +2080,22 @@ declare const _slot_convert_voice_inputs: {
       };
       readonly additionalProperties: false;
     };
-    readonly targetKey: {
-      readonly type: "string";
+    readonly ref_audio: {
+      readonly type: "object";
+      readonly required: readonly ["bytesBase64"];
+      readonly properties: {
+        readonly bytesBase64: {
+          readonly type: "string";
+          readonly minLength: 1;
+        };
+        readonly filename: {
+          readonly type: "string";
+        };
+        readonly mime: {
+          readonly type: "string";
+        };
+      };
+      readonly additionalProperties: false;
     };
   };
   readonly additionalProperties: false;
@@ -2262,7 +2311,7 @@ declare const _slot_video_gen_model_inputs: {
   readonly additionalProperties: false;
 };
 type VideoGenModelInput = FromSchema<typeof _slot_video_gen_model_inputs>;
-type NodeSlot = "gen-text" | "split-text" | "combine-text" | "image-fusion" | "images-gen-video" | "refs-gen-video" | "image-gen-text" | "video-gen-text" | "transcribe" | "concat-videos" | "extract-audio" | "remove-video-audio" | "merge-video-audio" | "audio-video-lip-sync" | "get-first-frame" | "get-last-frame" | "parse-document" | "split-video" | "link" | "image-gen" | "gen-music" | "text-gen-speech-preset" | "image-gen-video" | "image-edit" | "image-upscale" | "video-upscale" | "video-edit" | "image-describe" | "video-describe" | "audio-describe" | "music-repaint" | "music-cover" | "music-extract" | "separate-sound" | "music-lego" | "music-complete" | "music-brief" | "audio-image-gen-video" | "speech-text-gen-video" | "video-image-gen-video-mix" | "video-image-gen-video-move" | "image-image-gen-video" | "text-gen-video" | "image-gen-model" | "speech-video-gen-video" | "text-gen-speech-clone" | "transcribe-timestamp" | "text-gen-speech-instruct" | "drop-video" | "arrange-group" | "separate_speaker" | "separate_audio_track" | "denoise_audio" | "convert_voice" | "remove_watermark" | "subtitle_remove" | "text-audio-gen-speech" | "image-pose" | "image-body-seg" | "image-normal" | "image-matting" | "video-gen-model";
+type NodeSlot = "gen-text" | "split-text" | "combine-text" | "image-fusion" | "images-gen-video" | "refs-gen-video" | "image-gen-text" | "video-gen-text" | "transcribe" | "concat-videos" | "extract-audio" | "remove-video-audio" | "merge-video-audio" | "audio-video-lip-sync" | "get-first-frame" | "get-last-frame" | "parse-document" | "split-video" | "link" | "image-gen" | "gen-music" | "text-gen-audio" | "text-gen-speech-preset" | "image-gen-video" | "image-edit" | "image-upscale" | "video-upscale" | "video-edit" | "image-describe" | "video-describe" | "audio-describe" | "music-repaint" | "music-cover" | "music-extract" | "separate-sound" | "music-lego" | "music-complete" | "music-brief" | "audio-image-gen-video" | "speech-text-gen-video" | "video-image-gen-video-mix" | "video-image-gen-video-move" | "image-image-gen-video" | "text-gen-video" | "image-gen-model" | "speech-video-gen-video" | "text-gen-speech-clone" | "transcribe-timestamp" | "text-gen-speech-instruct" | "drop-video" | "arrange-group" | "separate_speaker" | "separate_audio_track" | "denoise_audio" | "convert_voice" | "remove_watermark" | "subtitle_remove" | "text-audio-gen-speech" | "image-pose" | "image-body-seg" | "image-normal" | "image-matting" | "video-gen-model";
 type SlotInputsMap = {
   "gen-text": GenTextInput;
   "split-text": SplitTextInput;
@@ -2285,6 +2334,7 @@ type SlotInputsMap = {
   link: LinkInput;
   "image-gen": ImageGenInput;
   "gen-music": GenMusicInput;
+  "text-gen-audio": TextGenAudioInput;
   "text-gen-speech-preset": TextGenSpeechPresetInput;
   "image-gen-video": ImageGenVideoInput;
   "image-edit": ImageEditInput;
@@ -2487,9 +2537,15 @@ interface FlowCoreState {
    */
   expands: (nodeId: string | null, possibleNodes: PossibleNode[]) => string[];
   /** Create a node fed by every combo-selected node; returns the new id. */
+  /**
+   * Create a node from the combo selection and wire every selected node into
+   * it. `sourceOrder` overrides the selection order used to assign handles
+   * (sources are matched to target fields in ABI input order).
+   */
   compose: (newNode: {
     type: string;
     data: unknown;
+    sourceOrder?: string[];
   }) => string;
   /** Replace a node's `data`. `history: false` skips the undo snapshot. */
   updates: (nodeId: string, data: Record<string, unknown>, opts?: {
@@ -2585,6 +2641,54 @@ type TaskStatusType = (typeof TaskStatus)[keyof typeof TaskStatus];
 type WorkflowStatusType = (typeof WorkflowStatus)[keyof typeof WorkflowStatus];
 type NodeStatusType = (typeof NodeStatus)[keyof typeof NodeStatus];
 //#endregion
+//#region src/core/registry/plugins-registry-schema.d.ts
+declare const PluginParamSpecSchema: z.ZodObject<{
+  type: z.ZodEnum<{
+    number: "number";
+    boolean: "boolean";
+    select: "select";
+    text: "text";
+    integer: "integer";
+  }>;
+  label: z.ZodOptional<z.ZodString>;
+  description: z.ZodOptional<z.ZodString>;
+  default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+  options: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+  min: z.ZodOptional<z.ZodNumber>;
+  max: z.ZodOptional<z.ZodNumber>;
+  step: z.ZodOptional<z.ZodNumber>;
+  models: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Optional live model catalog (`TONGFLOW_MODEL_CATALOG` in the plugin source).
+ * The canvas GETs `url` in the browser (public, CORS-enabled, no auth) — or,
+ * when `authEnv` names the env key holding a bearer token, through the app's
+ * `/api/plugins/model-catalog` route, which injects the stored key server-side
+ * — reads the record array at dot-path `items`, each model id at dot-path `id`, drops
+ * records where an `exclude` field equals its literal, and keeps a record for
+ * a slot when every `slots[slot]` token is a substring of the named field
+ * (arrays/objects are JSON-serialized before matching; a token prefixed with
+ * `!` must be absent instead). Matching ids extend
+ * that slot's dropdown after the static `models` shortlist.
+ */
+declare const PluginModelCatalogSchema: z.ZodObject<{
+  url: z.ZodString;
+  authEnv: z.ZodOptional<z.ZodString>;
+  items: z.ZodDefault<z.ZodString>;
+  id: z.ZodDefault<z.ZodString>;
+  exclude: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodBoolean, z.ZodNumber]>>>;
+  slots: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>>;
+}, z.core.$strip>;
+type PluginModelCatalog = z.infer<typeof PluginModelCatalogSchema>;
+type PluginParamSpec = z.infer<typeof PluginParamSpecSchema>;
+//#endregion
+//#region src/core/registry/plugin-params.d.ts
+/** A plugin's declared params for one slot, in declaration order. */
+type PluginParamEntry = {
+  name: string;
+  spec: PluginParamSpec;
+};
+//#endregion
 //#region src/core/schema/tongflow-abi.d.ts
 interface ResolvedOutputRoute {
   sourceField: string;
@@ -2613,6 +2717,10 @@ interface BaseNodeData extends Record<string, unknown> {
   /** Selected model for router-style plugins that declare per-slot model
    * lists; empty/absent means the plugin's default. */
   pluginModel?: string;
+  /** Advanced parameters chosen for the active plugin (keys from its
+   * `TONGFLOW_SLOT_PARAMS`); only values differing from the declared default
+   * are kept, so absent means the plugin's own default. */
+  pluginParams?: Record<string, unknown>;
   /** Composition linkage (`useNodesData`) */
   ids?: string[];
   texts?: string[];
@@ -2678,6 +2786,7 @@ declare function useNodePluginResolver(feature: string | undefined): {
   defaultPluginIdFromRegistry: string;
   resolveActivePluginId: () => string;
   resolveActiveModel: () => string | undefined;
+  resolveActiveParams: () => Record<string, unknown> | undefined;
 };
 //#endregion
 //#region src/canvas/hooks/use-task.d.ts
@@ -2728,6 +2837,9 @@ interface TaskCreationConfig {
   pluginId: string;
   /** Selected model for router-style plugins; omitted otherwise. */
   model?: string;
+  /** Advanced parameters (plugin's `TONGFLOW_SLOT_PARAMS` keys); omitted
+   * when the node runs on plugin defaults. */
+  params?: Record<string, unknown>;
   prompt: Record<string, unknown>;
   nodeId: string;
   workflowId?: number;
@@ -2749,7 +2861,7 @@ declare const useTaskStore: import("zustand").UseBoundStore<import("zustand").St
  * Handles connection lifecycle, reconnect, and parsing.
  */
 declare function useTaskSubscription(taskId?: string, options?: TaskSubscriptionOptions): {
-  status: "error" | "connecting" | "connected" | "reconnecting" | "disconnected";
+  status: "connecting" | "connected" | "reconnecting" | "disconnected" | "error";
 };
 /**
  * Create a task and automatically attach SSE streaming.
@@ -2931,7 +3043,11 @@ type PluginsRegistryPayload = {
     methodsByNodeSlot?: Record<string, {
       methodName: string;
       models?: string[];
+      /** Advanced params declared via `TONGFLOW_SLOT_PARAMS`. */
+      params?: Record<string, PluginParamSpec>;
     }>;
+    /** Live model catalog declared via `TONGFLOW_MODEL_CATALOG`. */
+    modelCatalog?: PluginModelCatalog;
     /** Presentation metadata merged from `tongflow.plugin.json`. */
     name?: string;
     description?: string;
@@ -2961,11 +3077,38 @@ declare function usePluginsRegistry(): {
 declare function refreshPluginsRegistry(): Promise<void>;
 /** Plugin directory names registered for a single ABI `nodeSlot`. */
 declare function useNodePluginIds(nodeSlot: string): string[];
+type LiveModelsEntry = {
+  fetchedAt: number;
+  bySlot: Record<string, string[]>;
+};
+type LiveModelsState = {
+  byPlugin: Record<string, LiveModelsEntry>;
+};
+declare const useLiveModelsStore: import("zustand").UseBoundStore<import("zustand").StoreApi<LiveModelsState>>;
+/**
+ * Fetch (or refresh, once the TTL elapsed) a plugin's live model catalog. Safe
+ * to call eagerly — it is a no-op for plugins without a catalog and while a
+ * fresh result is cached.
+ */
+declare function loadPluginModelCatalog(pluginId: string): Promise<void>;
 /**
- * Model ids a plugin declares for one ABI `nodeSlot` (empty for single-model
- * plugins — the model dropdown is hidden in that case).
+ * Synchronous read of a plugin's model ids for one slot: the static shortlist
+ * (declared order, first = default) followed by any live-catalog extras.
+ */
+declare function getNodePluginModels(nodeSlot: string, pluginId: string): string[];
+/**
+ * Model ids a plugin offers for one ABI `nodeSlot` (empty for single-model
+ * plugins — the model dropdown is hidden in that case): the static shortlist
+ * plus live-catalog extras, which this hook fetches on first use.
  */
 declare function useNodePluginModels(nodeSlot: string, pluginId: string): string[];
+/**
+ * Synchronous read of the params a plugin offers for one slot given the
+ * selected model, in declaration order.
+ */
+declare function getNodePluginParams(nodeSlot: string, pluginId: string, model: string | undefined): PluginParamEntry[];
+/** Reactive form of {@link getNodePluginParams}. */
+declare function useNodePluginParams(nodeSlot: string, pluginId: string, model: string | undefined): PluginParamEntry[];
 type PluginMeta = {
   name?: string;
   description?: string;
@@ -3286,6 +3429,9 @@ interface CreateTaskRequest {
   pluginId: string;
   /** Selected model for router-style plugins; omitted otherwise. */
   model?: string;
+  /** Advanced parameters (plugin's `TONGFLOW_SLOT_PARAMS` keys); omitted
+   * when the node runs on plugin defaults. */
+  params?: Record<string, unknown>;
   prompt: Record<string, unknown>;
   nodeId: string;
   workflowId?: number;
@@ -3534,7 +3680,7 @@ type NodeType = keyof typeof NODE_TYPES;
 declare const NODE_CATEGORIES: {
   readonly DATA: readonly ["imageNode", "textNode", "videoNode", "audioNode", "fileNode", "modelNode", "linkNode"];
   readonly ADD: readonly ["addImageNode", "addTextNode", "addAudioNode", "addVideoNode", "addLinkNode", "addFileNode", "addModelNode"];
-  readonly TRANSFORM: readonly ["imageGenVideoNode", "textGenVideoNode", "imageGenModelNode", "imagePoseNode", "imageBodySegNode", "imageNormalNode", "imageMattingNode", "videoGenModelNode", "speechGenVideoNode", "imageGenImageNode", "imageGenImageUpscaleNode", "genTextNode", "textGenImageNode", "textGenMusicNode", "textGenSpeechCloneNode", "textGenSpeechPresetNode", "textGenSpeechInstructNode", "removeVideoSubtitleNode", "removeWatermarkNode", "videoUpscaleNode", "videoEditNode", "extractAudioNode", "removeVideoAudioNode", "denoiseAudioSubtitleNode", "separateAudioTrackNode", "separateSpeakerNode", "convertVoiceNode", "audioDescribeNode", "imageGenTextNode", "videoGenTextNode", "videoGenTextSpeechRecognizeNode", "audioGenTextSpeechRecognizeNode", "fileGenTextNode", "linkGenTextNode", "getFirstFrameNode", "getLastFrameNode", "musicRepaintNode", "musicExtractNode", "musicLegoNode", "musicCompleteNode"];
+  readonly TRANSFORM: readonly ["imageGenVideoNode", "textGenVideoNode", "imageGenModelNode", "imagePoseNode", "imageBodySegNode", "imageNormalNode", "imageMattingNode", "videoGenModelNode", "speechGenVideoNode", "imageGenImageNode", "imageGenImageUpscaleNode", "genTextNode", "textGenImageNode", "textGenMusicNode", "textGenAudioNode", "textGenSpeechCloneNode", "textGenSpeechPresetNode", "textGenSpeechInstructNode", "removeVideoSubtitleNode", "removeWatermarkNode", "videoUpscaleNode", "videoEditNode", "extractAudioNode", "removeVideoAudioNode", "denoiseAudioSubtitleNode", "separateAudioTrackNode", "separateSpeakerNode", "convertVoiceNode", "audioDescribeNode", "imageGenTextNode", "videoGenTextNode", "videoGenTextSpeechRecognizeNode", "audioGenTextSpeechRecognizeNode", "fileGenTextNode", "linkGenTextNode", "getFirstFrameNode", "getLastFrameNode", "musicRepaintNode", "musicExtractNode", "musicLegoNode", "musicCompleteNode"];
   readonly BATCH: readonly ["dropVideoNode", "arrangeNode", "concatVideoNode"];
   readonly COMPOSE: readonly ["mergeVideoAudioNode", "audioVideoLipSyncNode", "imageFusionNode", "imagesGenVideoNode", "refsGenVideoNode", "speechImageGenVideoNode", "speechTextGenVideoNode", "speechVideoGenVideoNode", "videoImageGenVideoMoveNode", "videoImageGenVideoMixNode", "imageImageGenVideoNode", "textAudioGenSpeechNode", "textGenSpeechCloneComposeNode", "imageGenVideoComposeNode", "textsGenTextNode", "concatVideoComposeNode", "musicCoverNode"];
   readonly DECOMPOSE: readonly ["splitVideoNode", "splitTextNode", "musicBriefNode", "separateSoundNode"];
@@ -3954,7 +4100,7 @@ declare class ErrorBoundary extends Component<Props, State> {
   static getDerivedStateFromError(error: Error): State;
   componentDidCatch(error: Error, info: ErrorInfo): void;
   handleReset: () => void;
-  render(): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react/jsx-runtime").JSX.Element | null | undefined;
+  render(): string | number | bigint | boolean | import("react/jsx-runtime").JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | null | undefined;
 }
 //#endregion
 //#region src/canvas/ui/error-toast.d.ts
@@ -4118,4 +4264,4 @@ interface WhiteBoardProps {
 }
 declare const WhiteBoard: React$1.ForwardRefExoticComponent<WhiteBoardProps & React$1.RefAttributes<WhiteBoardRef>>;
 //#endregion
-export { AbiOutputChannel, AbiOutputView, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AudioRecorderWithVisualizer, Badge, BatchTaskConfig, Button, CANVAS_LOCALES, CanvasHostConfig, CanvasLocale, CanvasProvider, CanvasProviderProps, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, ClientTranslator, ConfigState, CreateMaterialRequest, CreateMaterialResponse, CreateTaskRequest, CreateTaskResponse, DEFAULT_QWEN_SPEAKER, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EDGE_TYPES, ErrorBoundary, FORMAT_CATEGORIES, FileValidationResult, FlowCanvas, FlowCanvasHandle, FlowCanvasProps, FlowReactBindings, FlowState, Input, Label, LibInput, ListMaterialsResponse, ListTasksResponse, LoadPriority, LoadTask, Material, MaterialType, NODE_CATEGORIES, NODE_TYPES, NodePluginIdSelect, NodeTaskHandler, NodeType, PluginMeta, PluginsRegistryPayload, type PossibleNode, PresignedUrlResponse, Progress, QWEN_SPEAKERS, QwenSpeaker, QwenSpeakerGender, RECOMMENDATIONS, SSEMessage, SSEMessageData, SSENodeInfo, SSEStatus, SSE_TASK_MESSAGE_EVENT, SUPPORTED_FORMATS, SaveFromTaskRequest, SaveFromTaskResponse, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, ShowErrorToastOptions, Skeleton, Slider, SpeakerVoiceRecorder, Switch, TASK_CANCEL_REQUEST_EVENT, TROUBLESHOOTING, Tabs, TabsContent, TabsList, TabsTrigger, Task, TaskCancelRequestDetail, TaskCreationConfig, TaskRecord, TaskState, TaskSubscriptionOptions, Textarea, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TraceMaterialWorkflowResponse, UpdateStatusRequest, UpdateStatusResponse, UploadResponse, UploadState, UploadValidationError, UseAbiExecutionOptions, UseAbiExecutionReturn, UseAbiFormReturn, UseFileAsyncLoaderOptions, UseMultipleUploadOptions, UseUploadOptions, ValidationResult, VideoRecorder, WORKSPACE_MODE_KEY, Waterfall, WaterfallProps, WaterfallRenderProps, WhiteBoard, WhiteBoardRef, WorkflowExecutionStatus, WorkspaceMode, apiClient, apiDelete, apiGet, apiPatch, apiPost, apiPut, apiUrl, applyResolvedOutputRoutes, assetUrl, badgeVariants, buttonVariants, canvasMessages, cn, computeOutputView, configureCanvasHost, createMaterial, createTask, deleteMaterial, emitSSEConnected, emitSSETaskMessage, emitTaskCancelRequest, getCanvasHost, getCanvasLocale, getClientTranslator, getFileUrl, getGlobalFileCache, getGlobalFileQueue, getImageDimensions, getMaterialFileUrls, getPresignedUploadUrl, getPrivateFileUrl, getSharedFileUrl, getTaskStopUrl, getTaskWaitUrl, getVideoMetadata, hostFetch, isCanvasLocale, isImageFile, isVideoFile, listMaterials, listTasks, normalizeTaskPayloadData, pluginDisplayName, refreshPluginsRegistry, saveFromTask, setCanvasLocale, showErrorToast, toggleFavorite, traceMaterialWorkflow, updateTaskStatus, useAbiExecution, useAbiForm, useBatchTaskManager, useCreateTask, useDropzone, useFileAsyncLoader, useFileAsyncLoaderBatch, useFileLoaderStats, useFileUrl, useFlow, useMultipleUpload, useNodeAbiSpec, useNodePluginIds, useNodePluginIdsUnion, useNodePluginModels, useNodePluginResolver, useNodeState, useNodeTaskUpdate, useNodeType, usePluginMeta, usePluginsRegistry, usePluginsRegistryStore, useResolvedPluginId, useTask, useTaskStore, useTaskSubscription, useUpload, useUpstreamNodeIds, validateFile };
+export { AbiOutputChannel, AbiOutputView, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AudioRecorderWithVisualizer, Badge, BatchTaskConfig, Button, CANVAS_LOCALES, CanvasHostConfig, CanvasLocale, CanvasProvider, CanvasProviderProps, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, ClientTranslator, ConfigState, CreateMaterialRequest, CreateMaterialResponse, CreateTaskRequest, CreateTaskResponse, DEFAULT_QWEN_SPEAKER, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EDGE_TYPES, ErrorBoundary, FORMAT_CATEGORIES, FileValidationResult, FlowCanvas, FlowCanvasHandle, FlowCanvasProps, FlowReactBindings, FlowState, Input, Label, LibInput, ListMaterialsResponse, ListTasksResponse, LoadPriority, LoadTask, Material, MaterialType, NODE_CATEGORIES, NODE_TYPES, NodePluginIdSelect, NodeTaskHandler, NodeType, PluginMeta, PluginsRegistryPayload, type PossibleNode, PresignedUrlResponse, Progress, QWEN_SPEAKERS, QwenSpeaker, QwenSpeakerGender, RECOMMENDATIONS, SSEMessage, SSEMessageData, SSENodeInfo, SSEStatus, SSE_TASK_MESSAGE_EVENT, SUPPORTED_FORMATS, SaveFromTaskRequest, SaveFromTaskResponse, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, ShowErrorToastOptions, Skeleton, Slider, SpeakerVoiceRecorder, Switch, TASK_CANCEL_REQUEST_EVENT, TROUBLESHOOTING, Tabs, TabsContent, TabsList, TabsTrigger, Task, TaskCancelRequestDetail, TaskCreationConfig, TaskRecord, TaskState, TaskSubscriptionOptions, Textarea, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TraceMaterialWorkflowResponse, UpdateStatusRequest, UpdateStatusResponse, UploadResponse, UploadState, UploadValidationError, UseAbiExecutionOptions, UseAbiExecutionReturn, UseAbiFormReturn, UseFileAsyncLoaderOptions, UseMultipleUploadOptions, UseUploadOptions, ValidationResult, VideoRecorder, WORKSPACE_MODE_KEY, Waterfall, WaterfallProps, WaterfallRenderProps, WhiteBoard, WhiteBoardRef, WorkflowExecutionStatus, WorkspaceMode, apiClient, apiDelete, apiGet, apiPatch, apiPost, apiPut, apiUrl, applyResolvedOutputRoutes, assetUrl, badgeVariants, buttonVariants, canvasMessages, cn, computeOutputView, configureCanvasHost, createMaterial, createTask, deleteMaterial, emitSSEConnected, emitSSETaskMessage, emitTaskCancelRequest, getCanvasHost, getCanvasLocale, getClientTranslator, getFileUrl, getGlobalFileCache, getGlobalFileQueue, getImageDimensions, getMaterialFileUrls, getNodePluginModels, getNodePluginParams, getPresignedUploadUrl, getPrivateFileUrl, getSharedFileUrl, getTaskStopUrl, getTaskWaitUrl, getVideoMetadata, hostFetch, isCanvasLocale, isImageFile, isVideoFile, listMaterials, listTasks, loadPluginModelCatalog, normalizeTaskPayloadData, pluginDisplayName, refreshPluginsRegistry, saveFromTask, setCanvasLocale, showErrorToast, toggleFavorite, traceMaterialWorkflow, updateTaskStatus, useAbiExecution, useAbiForm, useBatchTaskManager, useCreateTask, useDropzone, useFileAsyncLoader, useFileAsyncLoaderBatch, useFileLoaderStats, useFileUrl, useFlow, useLiveModelsStore, useMultipleUpload, useNodeAbiSpec, useNodePluginIds, useNodePluginIdsUnion, useNodePluginModels, useNodePluginParams, useNodePluginResolver, useNodeState, useNodeTaskUpdate, useNodeType, usePluginMeta, usePluginsRegistry, usePluginsRegistryStore, useResolvedPluginId, useTask, useTaskStore, useTaskSubscription, useUpload, useUpstreamNodeIds, validateFile };