ugcinc 3.70.0 → 3.73.0

package/dist/automations.js

@@ -602,6 +602,29 @@ function getAllNodes() {
             // - {branch-key}-{passthrough-id} (same type as input)
             outputs: [],
         },
+        {
+            type: "collect",
+            label: "Collect",
+            description: "Collect outputs from a for-each loop into an array",
+            category: "Control Flow",
+            nodeCategory: "generator",
+            // Input accepts any type from inside the loop
+            inputs: [
+                {
+                    id: "value",
+                    type: ["image", "video", "audio", "text", "object", "boolean", "number"],
+                    required: true,
+                },
+            ],
+            // Output is an array of the input type
+            outputs: [
+                {
+                    id: "array",
+                    type: ["image[]", "video[]", "audio[]", "text[]", "object[]"],
+                    required: true,
+                },
+            ],
+        },
         // === Terminal nodes ===
         {
             type: "auto-post",
@@ -682,7 +705,14 @@ function llmTypeToSchemaType(type) {
 function llmObjectSchemaToPropertySchema(fields) {
     const result = {};
     for (const field of fields) {
-        if (field.type === 'array' && field.items === 'object' && field.objectSchema) {
+        if (field.type === 'object' && field.objectSchema) {
+            // Top-level object with nested schema
+            result[field.name] = {
+                type: 'object',
+                itemSchema: llmObjectSchemaToPropertySchema(field.objectSchema),
+            };
+        }
+        else if (field.type === 'array' && field.items === 'object' && field.objectSchema) {
             // Nested array of objects
             result[field.name] = {
                 type: 'object',
@@ -733,6 +763,11 @@ function getOutputSchema(nodeType, nodeConfig, outputPortId) {
         const outputFields = llmConfig?.outputFields;
         if (outputFields) {
             const field = outputFields.find(f => f.name === outputPortId);
+            // Handle top-level object type
+            if (field?.type === 'object' && field.objectSchema) {
+                return llmObjectSchemaToPropertySchema(field.objectSchema);
+            }
+            // Handle array of objects
             if (field?.type === 'array' && field.items === 'object' && field.objectSchema) {
                 return llmObjectSchemaToPropertySchema(field.objectSchema);
             }

package/dist/index.d.ts

@@ -18,4 +18,4 @@ export { MediaClient } from './media';
 export { CommentsClient } from './comments';
 export type { RenderJobResponse, RenderJobStatus, SubmitImageRenderJobParams, SubmitVideoRenderJobParams, SubmitScreenshotAnimationRenderJobParams, SubmitInstagramDmRenderJobParams, SubmitIMessageDmRenderJobParams, IgDmMessage, ImDmMessage, RenderVideoEditorConfig, } from './render';
 export type { ClientConfig, } from './base';
-export type { SuccessResponse, ErrorResponse, ApiResponse, Account, AccountStat, AccountTask, EditProfileInfo, Task, TaskType, Post, PostType, PostStatus, PostStat, ApiKey, EditorConfig, VideoEditorNodeConfig, VideoEditorChannel, VideoEditorSegment, VideoEditorVideoSegment, VideoEditorAudioSegment, VideoEditorImageSegment, VideoEditorTextSegment, TimeMode, SegmentTimelinePosition, ImageEditorNodeConfig, ImageEditorElement, ImageEditorNodeInput, ImageEditorNodeOutput, DimensionPresetKey, EditorChannel, TimeValue, BaseSegmentProps, VisualSegmentProps, EditorSegment, VideoSegment, AudioSegment, ImageSegment, TextSegment, StaticSegment, PositionAnchor, RelativePositionConfig, GetAccountsParams, GetAccountStatsParams, GetAccountStatusParams, UpdateAccountInfoParams, UpdateAccountSocialParams, GetTasksParams, GetPostsParams, CreateSlideshowParams, GetPostStatsParams, GetPostStatusParams, CreateVideoParams, RefreshStatsParams, RefreshStatsResponse, RefreshStatsError, DailyAggregatedStat, GetDailyAggregatedStatsParams, DailyPostStat, GetDailyPostStatsParams, TopAccount, GetTopAccountsParams, TopPost, GetTopPostsParams, MediaType, NodePort, ResolvedPorts, NodeControlConfig, NodeTypeEnum, WorkflowNodeDefinition, WorkflowDefinition, CanvasState, TemplateNode, AutomationTemplate, AutomationRun, NodeRun, ExecutorNode, ExecutionEdge, OutputSchemaProperty, SelectionMode, ExhaustionBehavior, SelectionConfig, SelectionState, OutputMode, NodeOutputValues, OutputInput, OutputNodeConfig, ManualTriggerOutput, ManualTriggerNodeConfig, TriggerIterationMode, IterationExhaustionBehavior, CollectionSelectionMode, TriggerCollectionConfig, DayOfWeek, RecurrenceMediaOutput, RecurrenceMediaConfig, RecurrenceNodeConfig, AccountNodeConfig, MediaNodeEnabledType, RecurrenceMediaEnabledType, MediaNodeOutput, MediaNodeConfig, PostSchedulingMode, PostSchedulingConfig, AutoPostMode, AutoPostInputType, AutoPostInput, AutoPostNodeConfig, SaveToMediaInput, SaveToMediaNodeConfig, DeduplicateNodeConfig, ForEachOutputProperty, ForEachInputPort, ForEachNodeConfig, RandomValueType, RandomInputPort, RandomNodeMode, RandomNodeConfig, IfLogicOperator, IfBooleanInput, IfPassthroughInput, IfNodeConfig, RandomRouteBranch, RandomRoutePassthroughInput, RandomRouteObjectField, RandomRouteNodeConfig, BranchDefinition, BranchValueConfig, BranchPassthroughInput, BranchNodeConfig, VideoImportPlatform, VideoImportQuality, VideoImportNodeConfig, AutoCaptionPreset, AutoCaptionFontWeight, AutoCaptionPosition, AutoCaptionNodeConfig, ScreenshotAnimationNodeConfig, CreateDmMessage, CreateDmNodeConfig, VideoGenerationNodeConfig, ArrayType, PortType, LLMOutputField, LLMNodeConfig, UserMedia, SocialAudio, Media, MediaUse, GetMediaParams, CreateSocialAudioParams, UploadMediaParams, UploadMediaResponse, UpdateMediaTagParams, DeleteMediaParams, DeleteMediaResponse, CreateMediaFromUrlParams, ImportTextParams, ImportTextResponse, GetMediaUseParams, GetMediaUseResponse, Comment, CommentStatus, CreateCommentParams, CreateCommentResponse, GetCommentsParams, ValidationErrorType, ValidationError, ExportedNode, ExportedConnection, ExportedTemplate, AutomationExport, ExportedExecutor, ExportedEdge, ExportedRun, AutomationRunExport, } from './types';
+export type { SuccessResponse, ErrorResponse, ApiResponse, Account, AccountStat, AccountTask, EditProfileInfo, Task, TaskType, Post, PostType, PostStatus, PostStat, ApiKey, EditorConfig, VideoEditorNodeConfig, VideoEditorChannel, VideoEditorSegment, VideoEditorVideoSegment, VideoEditorAudioSegment, VideoEditorImageSegment, VideoEditorTextSegment, TimeMode, SegmentTimelinePosition, ImageEditorNodeConfig, ImageEditorElement, ImageEditorNodeInput, ImageEditorNodeOutput, DimensionPresetKey, EditorChannel, TimeValue, BaseSegmentProps, VisualSegmentProps, EditorSegment, VideoSegment, AudioSegment, ImageSegment, TextSegment, StaticSegment, PositionAnchor, RelativePositionConfig, GetAccountsParams, GetAccountStatsParams, GetAccountStatusParams, UpdateAccountInfoParams, UpdateAccountSocialParams, GetTasksParams, GetPostsParams, CreateSlideshowParams, GetPostStatsParams, GetPostStatusParams, CreateVideoParams, RefreshStatsParams, RefreshStatsResponse, RefreshStatsError, DailyAggregatedStat, GetDailyAggregatedStatsParams, DailyPostStat, GetDailyPostStatsParams, TopAccount, GetTopAccountsParams, TopPost, GetTopPostsParams, MediaType, NodePort, ResolvedPorts, NodeControlConfig, NodeTypeEnum, WorkflowNodeDefinition, WorkflowDefinition, CanvasState, TemplateNode, AutomationTemplate, AutomationRun, NodeRun, ExecutorNode, ExecutionEdge, OutputSchemaProperty, SelectionMode, ExhaustionBehavior, SelectionConfig, SelectionState, OutputMode, NodeOutputValues, OutputInput, OutputNodeConfig, ObjectSchemaField, ManualTriggerOutput, ManualTriggerNodeConfig, TriggerIterationMode, IterationExhaustionBehavior, CollectionSelectionMode, TriggerCollectionConfig, DayOfWeek, RecurrenceMediaOutput, RecurrenceMediaConfig, RecurrenceNodeConfig, AccountNodeConfig, MediaNodeEnabledType, RecurrenceMediaEnabledType, MediaNodeOutput, MediaNodeConfig, PostSchedulingMode, PostSchedulingConfig, AutoPostMode, AutoPostInputType, AutoPostInput, AutoPostNodeConfig, SaveToMediaInput, SaveToMediaNodeConfig, DeduplicateNodeConfig, ForEachOutputProperty, ForEachInputPort, ForEachNodeConfig, RandomValueType, RandomInputPort, RandomNodeMode, RandomNodeConfig, IfLogicOperator, IfBooleanInput, IfPassthroughInput, IfNodeConfig, RandomRouteBranch, RandomRoutePassthroughInput, RandomRouteObjectField, RandomRouteNodeConfig, BranchDefinition, BranchValueConfig, BranchPassthroughInput, BranchNodeConfig, VideoImportPlatform, VideoImportQuality, VideoImportNodeConfig, AutoCaptionPreset, AutoCaptionFontWeight, AutoCaptionPosition, AutoCaptionNodeConfig, ScreenshotAnimationNodeConfig, CreateDmMessage, CreateDmNodeConfig, VideoGenerationNodeConfig, ArrayType, PortType, LLMOutputField, LLMNodeConfig, UserMedia, SocialAudio, Media, MediaUse, GetMediaParams, CreateSocialAudioParams, UploadMediaParams, UploadMediaResponse, UpdateMediaTagParams, DeleteMediaParams, DeleteMediaResponse, CreateMediaFromUrlParams, ImportTextParams, ImportTextResponse, GetMediaUseParams, GetMediaUseResponse, Comment, CommentStatus, CreateCommentParams, CreateCommentResponse, GetCommentsParams, ValidationErrorType, ValidationError, ExportedNode, ExportedConnection, ExportedTemplate, AutomationExport, ExportedExecutor, ExportedEdge, ExportedRun, AutomationRunExport, } from './types';

package/dist/types.d.ts

@@ -846,7 +846,7 @@ export interface NodeControlConfig {
      */
     isInitializer?: boolean;
 }
-export type NodeTypeEnum = 'social-audio' | 'text' | 'media' | 'video-import' | 'image-composer' | 'video-composer' | 'generate-image' | 'generate-video' | 'custom-model' | 'llm' | 'output' | 'manual-trigger' | 'recurrence' | 'compose-workflow' | 'account' | 'auto-post' | 'save-to-media' | 'deduplicate' | 'for-each' | 'random' | 'random-route' | 'branch' | 'if' | 'not' | 'transcript' | 'auto-caption' | 'screenshot-animation' | 'create-dm';
+export type NodeTypeEnum = 'social-audio' | 'text' | 'media' | 'video-import' | 'image-composer' | 'video-composer' | 'generate-image' | 'generate-video' | 'custom-model' | 'llm' | 'output' | 'manual-trigger' | 'recurrence' | 'compose-workflow' | 'account' | 'auto-post' | 'save-to-media' | 'deduplicate' | 'for-each' | 'random' | 'random-route' | 'branch' | 'if' | 'not' | 'transcript' | 'auto-caption' | 'screenshot-animation' | 'create-dm' | 'collect';
 export interface OutputSchemaProperty {
     type: 'string' | 'number' | 'boolean' | 'array' | 'object';
     items?: 'string' | 'number' | 'boolean';
@@ -860,11 +860,11 @@ export interface LLMOutputField {
     name: string;
     /** Optional - guides LLM on expected content */
     description?: string;
-    /** Output type */
-    type: 'string' | 'number' | 'boolean' | 'array';
+    /** Output type (includes 'object' for top-level objects) */
+    type: 'string' | 'number' | 'boolean' | 'array' | 'object';
     /** For array types - the item type (including 'object' for arrays of objects) */
     items?: 'string' | 'number' | 'boolean' | 'object';
-    /** For array of objects - nested field definitions (max 3 levels of nesting) */
+    /** For array of objects or top-level objects - nested field definitions (max 3 levels of nesting) */
     objectSchema?: LLMOutputField[];
     /** Exact array length constraint */
     length?: number;
@@ -970,6 +970,7 @@ export interface WorkflowNodeDefinition {
         autoCaptionConfig?: AutoCaptionNodeConfig;
         screenshotAnimationConfig?: ScreenshotAnimationNodeConfig;
         createDmConfig?: CreateDmNodeConfig;
+        collectConfig?: CollectNodeConfig;
     };
 }
 export interface OutputInput {
@@ -982,13 +983,25 @@ export interface OutputInput {
 export interface OutputNodeConfig {
     inputs: OutputInput[];
 }
+/**
+ * Object schema field definition for manual trigger object outputs
+ * Simplified version without array/length constraints
+ */
+export interface ObjectSchemaField {
+    name: string;
+    type: 'string' | 'number' | 'boolean' | 'object';
+    /** For nested objects - nested field definitions (max 3 levels of nesting) */
+    objectSchema?: ObjectSchemaField[];
+}
 /**
  * Manual Trigger node output definition
  */
 export interface ManualTriggerOutput {
     id: string;
-    type: 'image' | 'video' | 'audio' | 'text' | 'social_audio' | 'account' | 'boolean';
+    type: 'image' | 'video' | 'audio' | 'text' | 'social_audio' | 'account' | 'boolean' | 'object';
     isArray?: boolean;
+    /** Schema for object types - describes the structure of the object */
+    objectSchema?: ObjectSchemaField[];
 }
 /**
  * Iteration mode for trigger nodes with account iteration
@@ -1542,6 +1555,16 @@ export interface CreateDmNodeConfig {
         userHasStory: boolean;
     };
 }
+/**
+ * Collect node configuration - collects outputs from for-each loop into an array
+ * Note: Most config is set during expansion, not by user
+ */
+export interface CollectNodeConfig {
+    /** Expected number of items to collect (set during for-each expansion) */
+    expectedCount?: number;
+    /** Template ID of the for-each loop this collects from (for validation) */
+    forEachTemplateId?: string;
+}
 /**
  * Video Generation Model IDs
  * Text-to-video models take just a prompt, image-to-video models require an image input

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ugcinc",
-  "version": "3.70.0",
+  "version": "3.73.0",
   "description": "TypeScript/JavaScript client for the UGC Inc API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",