ugcinc 4.0.2 → 4.1.0

package/dist/index.js

@@ -5,7 +5,10 @@
  * Official TypeScript/JavaScript client for the UGC Inc API
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CommentsClient = exports.MediaClient = exports.PortIdSchema = exports.normalizeToPortId = exports.portIdToTitle = exports.isValidPortId = exports.portId = exports.normalizePortTypes = exports.normalizePortType = exports.toLegacyPortType = exports.fromLegacyPortType = exports.isLegacyPortType = exports.formatPortType = exports.portType = exports.isImageToVideoModel = exports.isEditModel = exports.isAsyncExecutor = exports.NodeTypes = exports.extractTemplateVariables = exports.isInputPortRequired = exports.computeOutputPorts = exports.computeInputPorts = exports.areTypesCompatible = exports.getOutputSchema = exports.getNodeByType = exports.getAllNodes = exports.AutomationsClient = exports.RenderClient = exports.OrganizationClient = exports.StatsClient = exports.PostsClient = exports.TasksClient = exports.AccountsClient = exports.UGCClient = void 0;
+exports.PortIdSchema = exports.normalizeToPortId = exports.portIdToTitle = exports.isValidPortId = exports.portId = exports.isImageToVideoModel = exports.isEditModel = exports.formatPortType = exports.isAsyncExecutor = exports.NodeTypes = exports.hasMissingTerminalError = exports.hasMissingTriggerError = exports.getPortErrorsForNode = exports.getErrorNodeIds = exports.validateWorkflow = exports.checkCrossContextViolation = exports.getForEachContext = exports.cleanupStaleConnections = exports.removeNodeConnections = exports.removeConnection = exports.addConnection = exports.deriveConnections = exports.getOutputSchema = exports.getNodeByType = exports.getAllNodes = exports.computePortsForNode = exports.areTypesCompatible = exports.CommentsClient = exports.MediaClient = exports.AutomationsClient = exports.RenderClient = exports.OrganizationClient = exports.StatsClient = exports.PostsClient = exports.TasksClient = exports.AccountsClient = exports.UGCClient = void 0;
+// =============================================================================
+// Client Exports
+// =============================================================================
 var client_1 = require("./client");
 Object.defineProperty(exports, "UGCClient", { enumerable: true, get: function () { return client_1.UGCClient; } });
 var accounts_1 = require("./accounts");
@@ -22,34 +25,51 @@ var render_1 = require("./render");
 Object.defineProperty(exports, "RenderClient", { enumerable: true, get: function () { return render_1.RenderClient; } });
 var automations_1 = require("./automations");
 Object.defineProperty(exports, "AutomationsClient", { enumerable: true, get: function () { return automations_1.AutomationsClient; } });
-Object.defineProperty(exports, "getAllNodes", { enumerable: true, get: function () { return automations_1.getAllNodes; } });
-Object.defineProperty(exports, "getNodeByType", { enumerable: true, get: function () { return automations_1.getNodeByType; } });
-Object.defineProperty(exports, "getOutputSchema", { enumerable: true, get: function () { return automations_1.getOutputSchema; } });
-Object.defineProperty(exports, "areTypesCompatible", { enumerable: true, get: function () { return automations_1.areTypesCompatible; } });
-var ports_1 = require("./ports");
-Object.defineProperty(exports, "computeInputPorts", { enumerable: true, get: function () { return ports_1.computeInputPorts; } });
-Object.defineProperty(exports, "computeOutputPorts", { enumerable: true, get: function () { return ports_1.computeOutputPorts; } });
-Object.defineProperty(exports, "isInputPortRequired", { enumerable: true, get: function () { return ports_1.isInputPortRequired; } });
-Object.defineProperty(exports, "extractTemplateVariables", { enumerable: true, get: function () { return ports_1.extractTemplateVariables; } });
-var types_1 = require("./types");
+var media_1 = require("./media");
+Object.defineProperty(exports, "MediaClient", { enumerable: true, get: function () { return media_1.MediaClient; } });
+var comments_1 = require("./comments");
+Object.defineProperty(exports, "CommentsClient", { enumerable: true, get: function () { return comments_1.CommentsClient; } });
+// =============================================================================
+// Graph Controller Exports
+// =============================================================================
+var graph_controller_1 = require("./graph-controller");
+// Type compatibility
+Object.defineProperty(exports, "areTypesCompatible", { enumerable: true, get: function () { return graph_controller_1.areTypesCompatible; } });
+// Port computation
+Object.defineProperty(exports, "computePortsForNode", { enumerable: true, get: function () { return graph_controller_1.computePortsForNode; } });
+Object.defineProperty(exports, "getAllNodes", { enumerable: true, get: function () { return graph_controller_1.getAllNodes; } });
+Object.defineProperty(exports, "getNodeByType", { enumerable: true, get: function () { return graph_controller_1.getNodeByType; } });
+// Output schema
+Object.defineProperty(exports, "getOutputSchema", { enumerable: true, get: function () { return graph_controller_1.getOutputSchema; } });
+// Connection management
+Object.defineProperty(exports, "deriveConnections", { enumerable: true, get: function () { return graph_controller_1.deriveConnections; } });
+Object.defineProperty(exports, "addConnection", { enumerable: true, get: function () { return graph_controller_1.addConnection; } });
+Object.defineProperty(exports, "removeConnection", { enumerable: true, get: function () { return graph_controller_1.removeConnection; } });
+Object.defineProperty(exports, "removeNodeConnections", { enumerable: true, get: function () { return graph_controller_1.removeNodeConnections; } });
+Object.defineProperty(exports, "cleanupStaleConnections", { enumerable: true, get: function () { return graph_controller_1.cleanupStaleConnections; } });
+// For-each context validation
+Object.defineProperty(exports, "getForEachContext", { enumerable: true, get: function () { return graph_controller_1.getForEachContext; } });
+Object.defineProperty(exports, "checkCrossContextViolation", { enumerable: true, get: function () { return graph_controller_1.checkCrossContextViolation; } });
+// Workflow validation
+Object.defineProperty(exports, "validateWorkflow", { enumerable: true, get: function () { return graph_controller_1.validateWorkflow; } });
+Object.defineProperty(exports, "getErrorNodeIds", { enumerable: true, get: function () { return graph_controller_1.getErrorNodeIds; } });
+Object.defineProperty(exports, "getPortErrorsForNode", { enumerable: true, get: function () { return graph_controller_1.getPortErrorsForNode; } });
+Object.defineProperty(exports, "hasMissingTriggerError", { enumerable: true, get: function () { return graph_controller_1.hasMissingTriggerError; } });
+Object.defineProperty(exports, "hasMissingTerminalError", { enumerable: true, get: function () { return graph_controller_1.hasMissingTerminalError; } });
+// =============================================================================
+// Utility Exports
+// =============================================================================
+var types_1 = require("./automations/types");
 Object.defineProperty(exports, "NodeTypes", { enumerable: true, get: function () { return types_1.NodeTypes; } });
 Object.defineProperty(exports, "isAsyncExecutor", { enumerable: true, get: function () { return types_1.isAsyncExecutor; } });
-Object.defineProperty(exports, "isEditModel", { enumerable: true, get: function () { return types_1.isEditModel; } });
-Object.defineProperty(exports, "isImageToVideoModel", { enumerable: true, get: function () { return types_1.isImageToVideoModel; } });
-Object.defineProperty(exports, "portType", { enumerable: true, get: function () { return types_1.portType; } });
 Object.defineProperty(exports, "formatPortType", { enumerable: true, get: function () { return types_1.formatPortType; } });
-Object.defineProperty(exports, "isLegacyPortType", { enumerable: true, get: function () { return types_1.isLegacyPortType; } });
-Object.defineProperty(exports, "fromLegacyPortType", { enumerable: true, get: function () { return types_1.fromLegacyPortType; } });
-Object.defineProperty(exports, "toLegacyPortType", { enumerable: true, get: function () { return types_1.toLegacyPortType; } });
-Object.defineProperty(exports, "normalizePortType", { enumerable: true, get: function () { return types_1.normalizePortType; } });
-Object.defineProperty(exports, "normalizePortTypes", { enumerable: true, get: function () { return types_1.normalizePortTypes; } });
+var generate_image_1 = require("./automations/nodes/generate-image");
+Object.defineProperty(exports, "isEditModel", { enumerable: true, get: function () { return generate_image_1.isEditModel; } });
+var generate_video_1 = require("./automations/nodes/generate-video");
+Object.defineProperty(exports, "isImageToVideoModel", { enumerable: true, get: function () { return generate_video_1.isImageToVideoModel; } });
 var port_id_1 = require("./port-id");
 Object.defineProperty(exports, "portId", { enumerable: true, get: function () { return port_id_1.portId; } });
 Object.defineProperty(exports, "isValidPortId", { enumerable: true, get: function () { return port_id_1.isValidPortId; } });
 Object.defineProperty(exports, "portIdToTitle", { enumerable: true, get: function () { return port_id_1.portIdToTitle; } });
 Object.defineProperty(exports, "normalizeToPortId", { enumerable: true, get: function () { return port_id_1.normalizeToPortId; } });
 Object.defineProperty(exports, "PortIdSchema", { enumerable: true, get: function () { return port_id_1.PortIdSchema; } });
-var media_1 = require("./media");
-Object.defineProperty(exports, "MediaClient", { enumerable: true, get: function () { return media_1.MediaClient; } });
-var comments_1 = require("./comments");
-Object.defineProperty(exports, "CommentsClient", { enumerable: true, get: function () { return comments_1.CommentsClient; } });

package/dist/internal-utils.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Internal utility functions shared between node definitions.
+ * These are NOT exported from the package.
+ */
+/**
+ * Extract template variables from text (e.g., "Hello {{name}}" -> ["name"])
+ */
+export declare function extractTemplateVariables(texts: string[]): string[];

package/dist/internal-utils.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Internal utility functions shared between node definitions.
+ * These are NOT exported from the package.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractTemplateVariables = extractTemplateVariables;
+/**
+ * Extract template variables from text (e.g., "Hello {{name}}" -> ["name"])
+ */
+function extractTemplateVariables(texts) {
+    const variables = new Set();
+    const regex = /\{\{(\w+)\}\}/g;
+    for (const text of texts) {
+        let match;
+        while ((match = regex.exec(text)) !== null) {
+            if (match[1])
+                variables.add(match[1]);
+        }
+    }
+    return Array.from(variables);
+}

package/dist/media.d.ts

@@ -1,5 +1,139 @@
 import { BaseClient } from './base';
-import type { Media, SocialAudio, GetMediaParams, GetSocialAudioParams, UploadMediaResponse, UpdateMediaTagParams, UpdateMediaTagsParams, UpdateMediaTagsResponse, DeleteMediaParams, DeleteMediaResponse, CreateMediaFromUrlParams, CreateSocialAudioParams, GetUploadTokenParams, UploadTokenResponse, ImportTextParams, ImportTextResponse, GetMediaUseParams, GetMediaUseResponse, FilterMediaParams, FilterMediaResponse, ApiResponse } from './types';
+import type { ApiResponse } from './types';
+export interface UserMedia {
+    id: string;
+    org_id: string;
+    name: string | null;
+    tag: string | null;
+    type: 'video' | 'image' | 'audio' | 'text' | null;
+    url: string | null;
+    preview_url: string | null;
+    content: string | null;
+    source_id: string | null;
+    created_at: string;
+    media_type: 'user_media';
+}
+export interface MediaUse {
+    id: string;
+    user_media_id: string;
+    name: string;
+    source_id: string | null;
+    created_at: string;
+}
+export interface SocialAudio {
+    id: string;
+    org_id: string;
+    name: string | null;
+    tag: string | null;
+    social_post_link: string | null;
+    social_audio_link: string | null;
+    platform_type: 'tiktok' | null;
+    preview_url: string | null;
+    audio_url: string | null;
+    created_at: string;
+    media_type: 'social_audio';
+    type: 'social_audio';
+}
+export type Media = UserMedia | SocialAudio;
+export interface GetMediaParams {
+    ids?: string[];
+    tag?: string;
+}
+export interface GetSocialAudioParams {
+    ids?: string[];
+    tag?: string;
+}
+export interface UploadMediaParams {
+    files: File[];
+    tag?: string;
+}
+export interface UploadMediaResponse {
+    data: UserMedia[];
+    failed?: Array<{
+        name: string;
+        error: string;
+    }>;
+    message: string;
+}
+export interface MediaTagUpdate {
+    id: string;
+    tag: string;
+}
+export interface UpdateMediaTagsParams {
+    updates: MediaTagUpdate[];
+}
+export interface MediaTagUpdateResult {
+    id: string;
+    success: boolean;
+    media?: Media;
+    error?: string;
+}
+export interface UpdateMediaTagsResponse {
+    results: MediaTagUpdateResult[];
+}
+/** @deprecated Use UpdateMediaTagsParams instead for bulk operations */
+export interface UpdateMediaTagParams {
+    id: string;
+    tag: string;
+}
+export interface DeleteMediaParams {
+    ids: string[];
+}
+export interface DeleteMediaResponse {
+    deleted: string[];
+    failed?: Array<{
+        id: string;
+        message: string;
+    }>;
+    message: string;
+}
+export interface CreateSocialAudioParams {
+    url: string;
+    tag?: string;
+}
+export interface ImportTextParams {
+    texts: Array<{
+        content: string;
+        name?: string;
+        tag?: string;
+    }>;
+}
+export interface ImportTextResponse {
+    data: UserMedia[];
+    message: string;
+}
+export interface CreateMediaFromUrlParams {
+    urls: string[];
+    names?: string[];
+    previewUrls?: (string | undefined)[];
+    tag?: string;
+    sourceIds?: string[];
+    useName?: string;
+}
+export interface GetMediaUseParams {
+    name: string;
+}
+export interface GetMediaUseResponse {
+    sourceIds: string[];
+    entries: MediaUse[];
+}
+export interface FilterMediaParams {
+    source_ids: string[];
+    name: string;
+}
+export interface FilterMediaResponse {
+    available: string[];
+    used_count: number;
+    available_count: number;
+}
+export interface GetUploadTokenParams {
+    filename: string;
+    contentType?: string;
+}
+export interface UploadTokenResponse {
+    clientToken: string;
+    pathname: string;
+}
 /**
  * Client for managing media files
  */

package/dist/nodes/account.d.ts

@@ -0,0 +1,7 @@
+declare const definition: import("./types").NodeDefinition<"source", {
+    accountIds: never[];
+    outputMode: "per-input";
+    selectionMode: "random";
+}>;
+export default definition;
+export type AccountConfig = typeof definition.defaults;

package/dist/nodes/account.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const types_1 = require("./types");
+const definition = (0, types_1.defineNode)({
+    nodeId: 'account',
+    label: 'Account',
+    description: 'Select accounts to post from',
+    type: 'source',
+    category: 'Sources',
+    outputModes: ['per-input', 'single'],
+    selectionModes: ['random', 'sequential'],
+    defaults: {
+        accountIds: [],
+        outputMode: 'per-input',
+        selectionMode: 'random',
+    },
+    computePorts: () => ({
+        inputs: [],
+        outputs: [
+            {
+                id: 'account',
+                type: 'account',
+                isArray: false,
+                required: true,
+            },
+        ],
+    }),
+});
+exports.default = definition;

package/dist/nodes/auto-caption.d.ts

@@ -0,0 +1,17 @@
+declare const definition: import("./types").NodeDefinition<"generator", {
+    fontName: string;
+    fontSize: number;
+    fontWeight: string;
+    fontColor: string;
+    highlightColor: string;
+    strokeColor: string;
+    strokeWidth: number;
+    position: string;
+    wordsPerSubtitle: number;
+    enableAnimation: boolean;
+    language: string;
+    outputMode: "per-input";
+    selectionMode: null;
+}>;
+export default definition;
+export type AutoCaptionConfig = typeof definition.defaults;

package/dist/nodes/auto-caption.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const types_1 = require("./types");
+const definition = (0, types_1.defineNode)({
+    nodeId: 'auto-caption',
+    label: 'Auto Caption',
+    description: 'Add TikTok-style captions to videos',
+    type: 'generator',
+    category: 'Generation',
+    outputModes: ['per-input', 'single'],
+    selectionModes: null,
+    defaults: {
+        fontName: 'Montserrat',
+        fontSize: 80,
+        fontWeight: 'bold',
+        fontColor: 'white',
+        highlightColor: 'yellow',
+        strokeColor: 'black',
+        strokeWidth: 3,
+        position: 'bottom',
+        wordsPerSubtitle: 3,
+        enableAnimation: true,
+        language: 'en',
+        outputMode: 'per-input',
+        selectionMode: null,
+    },
+    computePorts: () => ({
+        inputs: [
+            {
+                id: 'video',
+                type: 'video',
+                isArray: false,
+                required: true,
+            },
+        ],
+        outputs: [
+            {
+                id: 'output',
+                type: 'video',
+                isArray: false,
+                required: true,
+            },
+        ],
+    }),
+});
+exports.default = definition;

package/dist/nodes/auto-post.d.ts

@@ -0,0 +1,21 @@
+import type { InputType } from './types';
+type AutoPostMode = 'video' | 'slideshow';
+declare const definition: import("./types").NodeDefinition<"terminal", {
+    mode: AutoPostMode;
+    inputType: InputType;
+    inputs: Array<{
+        id: string;
+    }>;
+    socialAudioIsVariable: boolean;
+    schedulingMode: string;
+    minDistanceHours: number;
+    maxPostsPerDay: number;
+    randomWindowStart: string;
+    randomWindowEnd: string;
+    timezone: string;
+    requireApproval: boolean;
+    outputMode: null;
+    selectionMode: null;
+}>;
+export default definition;
+export type AutoPostConfig = typeof definition.defaults;

package/dist/nodes/auto-post.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const types_1 = require("./types");
+const definition = (0, types_1.defineNode)({
+    nodeId: 'auto-post',
+    label: 'Auto Post',
+    description: 'Publish a video or slideshow',
+    type: 'terminal',
+    category: 'Output',
+    outputModes: null,
+    selectionModes: null,
+    defaults: {
+        mode: 'video',
+        inputType: 'static',
+        inputs: [],
+        socialAudioIsVariable: false,
+        schedulingMode: 'scheduled',
+        minDistanceHours: 4,
+        maxPostsPerDay: 3,
+        randomWindowStart: '09:00',
+        randomWindowEnd: '21:00',
+        timezone: 'America/New_York',
+        requireApproval: false,
+        outputMode: null,
+        selectionMode: null,
+    },
+    computePorts: ({ config }) => {
+        const mode = config?.mode ?? 'video';
+        const inputs = [];
+        if (mode === 'video') {
+            inputs.push({ id: 'video', type: 'video', isArray: false, required: true });
+        }
+        else {
+            const inputType = config?.inputType ?? 'static';
+            if (inputType === 'variable') {
+                inputs.push({ id: 'images', type: 'object', isArray: false, required: true });
+            }
+            else {
+                const imageInputs = config?.inputs ?? [{ id: 'image1' }, { id: 'image2' }, { id: 'image3' }];
+                for (const input of imageInputs) {
+                    inputs.push({ id: input.id, type: 'image', isArray: false, required: true });
+                }
+            }
+        }
+        // Static inputs for both modes
+        inputs.push({ id: 'account', type: 'account', isArray: false, required: true }, { id: 'caption', type: 'text', isArray: false, required: false });
+        // Social audio variable input
+        if (config?.socialAudioIsVariable) {
+            inputs.push({ id: 'social-audio', type: 'audio', isArray: false, required: false });
+        }
+        return { inputs, outputs: [] };
+    },
+});
+exports.default = definition;

package/dist/nodes/branch.d.ts

@@ -0,0 +1,12 @@
+import type { PassthroughInput } from './types';
+declare const definition: import("./types").NodeDefinition<"generator", {
+    branches: {
+        key: string;
+    }[];
+    passthroughInputs: PassthroughInput[];
+    defaultBranchKey: string;
+    outputMode: "per-input";
+    selectionMode: null;
+}>;
+export default definition;
+export type BranchConfig = typeof definition.defaults;

package/dist/nodes/branch.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const types_1 = require("./types");
+const definition = (0, types_1.defineNode)({
+    nodeId: 'branch',
+    label: 'Branch',
+    description: 'Route inputs based on a key match',
+    type: 'generator',
+    category: 'Control Flow',
+    outputModes: ['per-input', 'single'],
+    selectionModes: null,
+    defaults: {
+        branches: [
+            { key: 'option-a' },
+            { key: 'option-b' },
+        ],
+        passthroughInputs: [{ id: 'input', type: 'image', isArray: false }],
+        defaultBranchKey: 'option-a',
+        outputMode: 'per-input',
+        selectionMode: null,
+    },
+    computePorts: ({ config }) => {
+        const branches = config?.branches ?? [];
+        const passthroughInputs = config?.passthroughInputs ?? [];
+        const inputs = [];
+        const outputs = [];
+        // Always add key input for branch selection
+        inputs.push({ id: 'key', type: 'text', isArray: false, required: true });
+        // Add input ports for each branch × passthrough where isVariable is true
+        for (const passthrough of passthroughInputs) {
+            const pType = passthrough.type;
+            const pIsArray = passthrough.isArray ?? false;
+            for (const branch of branches) {
+                const branchValue = passthrough.branchValues?.[branch.key];
+                if (branchValue?.inputType === 'variable') {
+                    inputs.push({
+                        id: `${branch.key}-${passthrough.id}`,
+                        type: pType,
+                        isArray: pIsArray,
+                        required: true,
+                    });
+                }
+            }
+            // One output per passthrough
+            outputs.push({ id: passthrough.id, type: pType, isArray: pIsArray, required: true });
+        }
+        return { inputs, outputs };
+    },
+});
+exports.default = definition;

package/dist/nodes/collect.d.ts

@@ -0,0 +1,6 @@
+declare const definition: import("./types").NodeDefinition<"generator", {
+    outputMode: "single";
+    selectionMode: null;
+}>;
+export default definition;
+export type CollectConfig = typeof definition.defaults;

package/dist/nodes/collect.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const types_1 = require("./types");
+const definition = (0, types_1.defineNode)({
+    nodeId: 'collect',
+    label: 'Collect',
+    description: 'Collect outputs from a for-each loop into an array',
+    type: 'generator',
+    category: 'Control Flow',
+    outputModes: ['per-input', 'single'],
+    selectionModes: null,
+    defaults: {
+        outputMode: 'single', // Collect produces a single output after all loop iterations complete
+        selectionMode: null,
+    },
+    computePorts: ({ getConnectedOutput }) => {
+        // Input: accepts any non-array type (union)
+        const inputTypes = ['image', 'video', 'audio', 'text', 'object', 'boolean', 'number'];
+        // Default output: union of all types (will be array)
+        const defaultOutputTypes = ['image', 'video', 'audio', 'text', 'object'];
+        // Determine output type from connected input (inverse of for-each pattern)
+        let outputType = defaultOutputTypes;
+        let outputIsArray = true;
+        if (getConnectedOutput) {
+            const connectedOutput = getConnectedOutput('value');
+            if (connectedOutput?.type) {
+                const connType = connectedOutput.type;
+                // Handle single type (not a union)
+                if (!Array.isArray(connType) && !connectedOutput.isArray) {
+                    // If connected to a non-array type, output is an array of that type
+                    outputType = connType;
+                    outputIsArray = true;
+                }
+                // If connected to a union type, can't narrow - keep default union
+            }
+        }
+        const inputs = [
+            {
+                id: 'value',
+                type: inputTypes,
+                isArray: false,
+                required: true,
+            },
+        ];
+        const outputs = [
+            {
+                id: 'array',
+                type: outputType,
+                isArray: outputIsArray,
+                required: true,
+            },
+        ];
+        return { inputs, outputs };
+    },
+});
+exports.default = definition;

package/dist/nodes/compose-workflow.d.ts

@@ -0,0 +1,21 @@
+import type { ResolvedPorts, EnumOption } from '../types';
+import { type ObjectSchemaField } from './types';
+declare const definition: import("./types").NodeDefinition<"generator", {
+    workflowTemplateId: string | undefined;
+    workflowVariableNodes: Array<{
+        id: string;
+        name?: string;
+        variableType?: "image" | "video" | "audio" | "text" | "enum";
+        enumOptions?: EnumOption[];
+    }>;
+    workflowOutputSchema: Record<string, {
+        type: string;
+        isArray?: boolean;
+        objectSchema?: ObjectSchemaField[];
+    }>;
+    resolvedPorts: ResolvedPorts | undefined;
+    outputMode: "per-input";
+    selectionMode: null;
+}>;
+export default definition;
+export type ComposeWorkflowConfig = typeof definition.defaults;

package/dist/nodes/compose-workflow.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const types_1 = require("./types");
+const definition = (0, types_1.defineNode)({
+    nodeId: 'compose-workflow',
+    label: 'Compose Workflow',
+    description: 'Embed other workflows',
+    type: 'generator',
+    category: 'Generation',
+    outputModes: ['per-input', 'single'],
+    selectionModes: null,
+    defaults: {
+        workflowTemplateId: undefined,
+        workflowVariableNodes: [],
+        workflowOutputSchema: {},
+        resolvedPorts: undefined,
+        outputMode: 'per-input',
+        selectionMode: null,
+    },
+    computePorts: ({ config }) => {
+        const variableNodes = config?.workflowVariableNodes ?? [];
+        const outputSchema = config?.workflowOutputSchema ?? {};
+        // Inputs from workflow variable nodes
+        const inputs = variableNodes.map(v => ({
+            id: v.id,
+            type: (v.variableType ?? 'text'),
+            isArray: false,
+            required: true,
+            ...(v.variableType === 'enum' && v.enumOptions ? { enumOptions: v.enumOptions } : {}),
+        }));
+        // Outputs from workflow output schema
+        const outputs = Object.entries(outputSchema).map(([id, schema]) => ({
+            id,
+            type: schema.type,
+            isArray: schema.isArray ?? false,
+            required: true,
+            ...(schema.objectSchema && { objectSchema: schema.objectSchema }),
+        }));
+        return { inputs, outputs };
+    },
+});
+exports.default = definition;