@nodetool-ai/websocket 0.8.4-a24.3 → 0.8.4

package/dist/examples/nodetool-base/Brand a UGC Product Video.json

@@ -0,0 +1,402 @@
+{
+  "id": "",
+  "access": "private",
+  "created_at": "2026-09-13T00:00:00.000Z",
+  "updated_at": "2026-09-13T00:00:00.000Z",
+  "name": "Brand a UGC Product Video",
+  "tool_name": null,
+  "description": "Turn one continuous vertical creator clip into a polished branded reel. The workflow extracts the native audio, transcribes it with word timestamps, groups the words into short animated phrases, builds an editable NodeTool timeline with MORROW motion graphics, and renders the finished video.",
+  "tags": [
+    "video",
+    "marketing",
+    "ugc",
+    "captions",
+    "motion-graphics",
+    "example"
+  ],
+  "thumbnail": null,
+  "thumbnail_url": null,
+  "graph": {
+    "nodes": [
+      {
+        "id": "intro",
+        "type": "nodetool.workflows.base_node.Comment",
+        "data": {
+          "comment": "# Brand a UGC Product Video\n\nTurns one continuous, native-audio vertical creator clip into a branded reel with animated captions and MORROW motion graphics. The result is an editable timeline as well as a rendered video.\n\n**How it works:** \"6 Keep the native track\" pulls the audio from \"1 Creator clip\", and \"7 Derive word timings\" transcribes it with OpenAI whisper-1 and word timestamps. \"Measure the clip\" reads the duration. \"8 Build the editable motion timeline\" is a Code node that groups the words into 3 to 5 word phrases with word highlighting, then adds an opening brand bug, a DAILY RITUAL callout and a closing lockup with \"2 Brand\" and \"3 Slogan\". It caps the cut at 15.083 s. \"4 Caption style\" picks Polished (soft forest plate) or Minimal (type and outline only), and \"5 Brand accent\" colors the active word. \"9 Render the finished reel\" renders an MP4 with audio for \"10 Branded UGC reel\". Add your own clip first. Transcription needs an OpenAI key.\n\n**Try this:** Set \"4 Caption style\" to Minimal and rerun to see the captions without the background plate."
+        },
+        "ui_properties": {
+          "position": {
+            "x": 0,
+            "y": 0
+          },
+          "zIndex": -1,
+          "width": 1860,
+          "height": 208,
+          "selectable": true,
+          "title": "MORROW motion finishing"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "creator-clip",
+        "type": "nodetool.input.VideoInput",
+        "data": {
+          "name": "creator_clip",
+          "value": {
+            "type": "video",
+            "uri": "package://nodetool-base/recipe-inputs/presenter.mp4"
+          },
+          "description": "One continuous 9:16 creator clip with its native audio"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 0,
+            "y": 288
+          },
+          "zIndex": 0,
+          "width": 280,
+          "selectable": true,
+          "title": "1  Creator clip"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "brand",
+        "type": "nodetool.input.StringInput",
+        "data": {
+          "name": "brand",
+          "value": "MORROW",
+          "description": "Brand name used by the opening bug and closing lockup"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 0,
+            "y": 504
+          },
+          "zIndex": 0,
+          "width": 280,
+          "selectable": true,
+          "title": "2  Brand"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "slogan",
+        "type": "nodetool.input.StringInput",
+        "data": {
+          "name": "slogan",
+          "value": "Carry the calm.",
+          "description": "Closing line under the brand"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 0,
+            "y": 729
+          },
+          "zIndex": 0,
+          "width": 280,
+          "selectable": true,
+          "title": "3  Slogan"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "caption-style",
+        "type": "nodetool.input.SelectInput",
+        "data": {
+          "name": "caption_style",
+          "value": "Polished",
+          "options": [
+            "Polished",
+            "Minimal"
+          ],
+          "enum_type_name": "",
+          "description": "Polished adds a restrained forest plate; Minimal keeps the outlined type"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 0,
+            "y": 954
+          },
+          "zIndex": 0,
+          "width": 280,
+          "selectable": true,
+          "title": "4  Caption style"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "brand-accent",
+        "type": "nodetool.input.ColorInput",
+        "data": {
+          "name": "brand_accent",
+          "value": {
+            "type": "color",
+            "value": "#C0D28C"
+          },
+          "description": "Active-word, underline, bracket, and closing-rule color"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 0,
+            "y": 1142
+          },
+          "zIndex": 0,
+          "width": 280,
+          "selectable": true,
+          "title": "5  Brand accent"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "extract-audio",
+        "type": "nodetool.video.ExtractAudio",
+        "data": {},
+        "ui_properties": {
+          "position": {
+            "x": 380,
+            "y": 451
+          },
+          "zIndex": 0,
+          "width": 280,
+          "selectable": true,
+          "title": "6  Keep the native track"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "clip-info",
+        "type": "nodetool.video.GetVideoInfo",
+        "data": {},
+        "ui_properties": {
+          "position": {
+            "x": 380,
+            "y": 619
+          },
+          "zIndex": 0,
+          "width": 280,
+          "selectable": true,
+          "title": "Measure the clip"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "transcribe",
+        "type": "openai.audio.Transcribe",
+        "data": {
+          "model": "whisper-1",
+          "language": "auto_detect",
+          "timestamps": true,
+          "prompt": "Return the creator's exact spoken words. Preserve product and brand terms.",
+          "temperature": 0
+        },
+        "ui_properties": {
+          "position": {
+            "x": 760,
+            "y": 577
+          },
+          "zIndex": 0,
+          "width": 300,
+          "selectable": true,
+          "title": "7  Derive word timings"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "build-timeline",
+        "type": "nodetool.code.Code",
+        "data": {
+          "code": "const creator = inputs.creator;\nconst rawWords = Array.isArray(inputs.words) ? inputs.words : [];\nconst brand = String(inputs.brand || 'MORROW').trim().toUpperCase();\nconst slogan = String(inputs.slogan || 'Carry the calm.').trim();\nconst captionStyleName = String(inputs.captionStyle || 'Polished');\nconst brandAccent = String((inputs.brandAccent && inputs.brandAccent.value) || inputs.brandAccent || '#C0D28C');\nconst IVORY = '#F6F4EC';\nconst FOREST = '#14241E';\n// The cut runs as long as the clip, up to the 15.083 s the design was timed\n// for. A clip that ends earlier leaves no frame to render past its end.\nconst clipMs = Math.round(Number(inputs.clipSeconds || 0) * 1000);\nconst DURATION_MS = clipMs > 0 ? Math.min(15_083, clipMs) : 15_083;\nconst closingStartMs = Math.max(0, DURATION_MS - 3_333);\nconst closingPanel = {riseStartMs: closingStartMs, riseEndMs: closingStartMs + 550, holdEndMs: DURATION_MS};\nconst openingBug = {startMs: 150, endMs: 2_700};\nconst dailyRitual = {startMs: 5_000, endMs: 7_000};\nif (!creator || typeof creator !== 'object') throw new Error('A creator clip is required.');\nif (rawWords.length === 0) throw new Error('The transcription returned no word timestamps. Use whisper-1 with timestamps enabled.');\nlet assetId = typeof creator.asset_id === 'string' ? creator.asset_id : '';\nif (!assetId) { const saveOptions = creator.uri ? {source: creator.uri, content_type: 'video/mp4'} : {content_base64: creator.data, content_type: 'video/mp4'}; const saved = await nodetool.assets.save(`${brand.toLowerCase()}-creator.mp4`, saveOptions); assetId = String(saved.asset_id || saved.id || ''); }\nif (!assetId) throw new Error('The creator clip could not be stored as a timeline asset.');\nconst words = rawWords.map((item) => { const stamp = Array.isArray(item.timestamp) ? item.timestamp : []; return {text: String(item.text || '').trim(), startMs: Math.max(0, Math.round(Number(stamp[0] || 0) * 1000)), endMs: Math.max(1, Math.round(Number(stamp[1] || stamp[0] || 0) * 1000))}; }).filter((item) => item.text && item.endMs > item.startMs).sort((a, b) => a.startMs - b.startMs);\nconst clauses = []; let clause = [];\nfor (const word of words) { const gap = clause.length ? word.startMs - clause[clause.length - 1].endMs : 0; if (clause.length && gap > 450) { clauses.push(clause); clause = []; } clause.push(word); if (/[.!?]$/.test(word.text)) { clauses.push(clause); clause = []; } }\nif (clause.length) clauses.push(clause);\nfunction countsFor(total) { const counts = []; let left = total; while (left > 5) { const take = left - 5 < 3 ? left - 3 : 5; counts.push(take); left -= take; } if (left > 0) counts.push(left); if (counts.length > 1 && counts[counts.length - 1] < 3) counts[counts.length - 2] += counts.pop(); return counts; }\nconst phrases = [];\nfor (const run of clauses) { let cursor = 0; for (const count of countsFor(run.length)) { const slice = run.slice(cursor, cursor + count); cursor += count; if (slice.length < 3 && phrases.length && phrases[phrases.length - 1].words.length + slice.length <= 5) phrases[phrases.length - 1].words.push(...slice); else phrases.push({words: slice}); } }\nconst clip = (overrides) => ({sourceType: 'imported', status: 'generated', locked: false, versions: [], ...overrides});\nconst pop = (id, durationMs = 250) => ({id, role: 'in', preset: 'pop', durationMs, easing: 'easeOutBack', params: {overshoot: 1.06}});\nconst slideUp = (id, durationMs = 550) => ({id, role: 'in', preset: 'slide', durationMs, easing: 'easeOut', params: {direction: 'down', distance: 0.34}});\nconst captionStyle = {fontFamily: 'Inter', fontSizeFrac: captionStyleName === 'Minimal' ? 0.043 : 0.048, color: IVORY, activeColor: brandAccent, outline: {color: FOREST, widthPx: 4}, bottomMarginFrac: 0.39};\nif (captionStyleName !== 'Minimal') captionStyle.background = {color: '#14241ECC', paddingPx: 16, radiusPx: 14};\nconst FPS = 24;\nconst frameToMs = (frame) => Math.round(frame * 1000 / FPS);\nconst msToFrame = (ms) => Math.max(0, Math.round(ms * FPS / 1000));\nconst phraseStartFrames = phrases.map((phrase) => msToFrame(phrase.words[0].startMs));\nconst captionClips = phrases.map((phrase, index) => { const last = phrase.words[phrase.words.length - 1]; const startFrame = phraseStartFrames[index]; const startMs = frameToMs(startFrame); const nextPhrase = phrases[index + 1]; const nextStartFrame = nextPhrase ? phraseStartFrames[index + 1] : msToFrame(DURATION_MS); const hasGenuinePause = Boolean(nextPhrase && nextPhrase.words[0].startMs - last.endMs > 450); const naturalEndFrame = Math.max(startFrame + 1, msToFrame(Math.min(DURATION_MS, last.endMs + 180))); const endFrame = nextPhrase ? (hasGenuinePause ? Math.min(nextStartFrame - 1, naturalEndFrame) : nextStartFrame) : Math.min(msToFrame(DURATION_MS), naturalEndFrame); const safeEndFrame = Math.max(startFrame + 1, endFrame); const endMs = frameToMs(safeEndFrame); const captionWords = phrase.words.map((word, wordIndex) => { const wordStartFrame = Math.max(startFrame, msToFrame(word.startMs)); const nextWord = phrase.words[wordIndex + 1]; const wordEndFrame = nextWord ? Math.max(wordStartFrame + 1, msToFrame(nextWord.startMs)) : Math.max(wordStartFrame + 1, safeEndFrame); return {word: word.text.toUpperCase(), startMs: frameToMs(wordStartFrame) - startMs, endMs: Math.min(frameToMs(wordEndFrame) - startMs, endMs - startMs)}; }); return clip({id: `caption-${index + 1}`, trackId: 'captions', name: `Phrase ${index + 1}`, startMs, durationMs: endMs - startMs, mediaType: 'text', caption: {words: captionWords, style: captionStyle}}); });\nconst clips = [\nclip({id: 'creator-video', trackId: 'video', name: 'Creator clip with native audio', startMs: 0, durationMs: DURATION_MS, mediaType: 'video', sourceType: 'imported', currentAssetId: assetId, volumeDb: 0}),\nclip({id: 'opening-bug-plate', trackId: 'motion-a', name: 'openingBug plate', startMs: openingBug.startMs, durationMs: openingBug.endMs - openingBug.startMs, mediaType: 'shape', shapeStyle: {kind: 'rect', x: 0.081, y: 0.116, width: 0.333, height: 0.054, fill: FOREST, cornerRadius: 0.012}, animations: [pop('opening-bug-pop')]}),\nclip({id: 'opening-bug-accent', trackId: 'motion-b', name: 'openingBug accent', startMs: openingBug.startMs + 80, durationMs: openingBug.endMs - openingBug.startMs - 80, mediaType: 'shape', shapeStyle: {kind: 'line', x: 0.107, y: 0.129, x2: 0.107, y2: 0.157, stroke: brandAccent, strokeWidthPx: 7, lineCap: 'round'}, animations: [pop('opening-accent-pop', 180)]}),\nclip({id: 'opening-bug-brand', trackId: 'motion-c', name: 'openingBug MORROW', startMs: openingBug.startMs + 120, durationMs: openingBug.endMs - openingBug.startMs - 120, mediaType: 'text', textStyle: {text: brand, fontFamily: 'Inter', fontSizePx: 34, fontWeight: 600, color: IVORY, align: 'center', letterSpacingPx: 3, stroke: {color: FOREST, widthPx: 1}}, transform: {position: {x: -194, y: -480}, scale: {x: 1, y: 1}, rotation: 0, anchor: {x: 0.5, y: 0.5}}, animations: [pop('opening-brand-pop', 180)]}),\nclip({id: 'daily-panel', trackId: 'motion-a', name: 'dailyRitual compact lower-left panel', startMs: dailyRitual.startMs, durationMs: dailyRitual.endMs - dailyRitual.startMs, mediaType: 'shape', shapeStyle: {kind: 'rect', x: 0.0625, y: 0.7403, width: 0.3281, height: 0.0476, fill: '#14241EE8', cornerRadius: 0}}),\nclip({id: 'daily-rule', trackId: 'motion-b', name: 'dailyRitual sage rule', startMs: dailyRitual.startMs, durationMs: dailyRitual.endMs - dailyRitual.startMs, mediaType: 'shape', shapeStyle: {kind: 'line', x: 0.067, y: 0.7403, x2: 0.067, y2: 0.7879, stroke: brandAccent, strokeWidthPx: 7, lineCap: 'butt'}}),\nclip({id: 'daily-label', trackId: 'motion-c', name: 'dailyRitual stable label', startMs: dailyRitual.startMs, durationMs: dailyRitual.endMs - dailyRitual.startMs, mediaType: 'text', textStyle: {text: 'DAILY RITUAL', fontFamily: 'Inter', fontSizePx: 20, fontWeight: 600, color: brandAccent, align: 'center', letterSpacingPx: 2, lineHeight: 1}, transform: {position: {x: -224, y: 354}, scale: {x: 1, y: 1}, rotation: 0, anchor: {x: 0.5, y: 0.5}}}),\nclip({id: 'daily-rule-tail', trackId: 'motion-d', name: 'dailyRitual sage rule tail', startMs: dailyRitual.startMs, durationMs: dailyRitual.endMs - dailyRitual.startMs, mediaType: 'shape', shapeStyle: {kind: 'line', x: 0.3906, y: 0.7645, x2: 0.5599, y2: 0.7645, stroke: brandAccent, strokeWidthPx: 3, lineCap: 'butt'}}),\nclip({id: 'closing-panel', trackId: 'motion-a', name: 'closingPanel deep-forest rise', startMs: closingPanel.riseStartMs, durationMs: closingPanel.holdEndMs - closingPanel.riseStartMs, mediaType: 'shape', shapeStyle: {kind: 'rect', x: 0, y: 0.715, width: 1, height: 0.285, fill: FOREST}, animations: [slideUp('closing-panel-rise', closingPanel.riseEndMs - closingPanel.riseStartMs)]}),\nclip({id: 'closing-rule', trackId: 'motion-b', name: 'closingPanel sage rule', startMs: closingPanel.riseStartMs + 470, durationMs: closingPanel.holdEndMs - closingPanel.riseStartMs - 470, mediaType: 'shape', shapeStyle: {kind: 'line', x: 0.095, y: 0.772, x2: 0.095, y2: 0.914, stroke: brandAccent, strokeWidthPx: 7, lineCap: 'round'}, animations: [{id: 'closing-rule-draw', role: 'in', preset: 'custom', durationMs: 320, custom: {curves: [{property: 'trimEnd', keyframes: [{t: 0, value: 0}, {t: 1, value: 1, easing: 'easeOut'}]}]}}]}),\nclip({id: 'closing-brand', trackId: 'motion-c', name: 'closingPanel MORROW', startMs: closingPanel.riseEndMs, durationMs: closingPanel.holdEndMs - closingPanel.riseEndMs, mediaType: 'text', textStyle: {text: brand, fontFamily: 'Inter', fontSizePx: 72, fontWeight: 600, color: IVORY, align: 'center', letterSpacingPx: 7, stroke: {color: FOREST, widthPx: 1}}, transform: {position: {x: 12, y: 365}, scale: {x: 1, y: 1}, rotation: 0, anchor: {x: 0.5, y: 0.5}}, animations: [slideUp('closing-brand-rise', 320)]}),\nclip({id: 'closing-slogan', trackId: 'motion-d', name: 'closingPanel slogan', startMs: closingPanel.riseStartMs + 770, durationMs: closingPanel.holdEndMs - closingPanel.riseStartMs - 770, mediaType: 'text', textStyle: {text: slogan, fontFamily: 'Inter', fontSizePx: 35, fontWeight: 500, color: IVORY, align: 'center', letterSpacingPx: 1, stroke: {color: FOREST, widthPx: 1}}, transform: {position: {x: 0, y: 455}, scale: {x: 1, y: 1}, rotation: 0, anchor: {x: 0.5, y: 0.5}}, animations: [slideUp('closing-slogan-rise', 280)]}),\n...captionClips];\n// A short clip ends before some of the timed graphics: drop the ones that\n// would start after it and trim the rest to its end.\nconst fittedClips = clips.filter((item) => item.startMs < DURATION_MS).map((item) => ({...item, durationMs: Math.min(item.durationMs, DURATION_MS - item.startMs)}));\nconst created = await nodetool.timelines.create(`${brand} UGC motion finish`, {fps: 24, width: 768, height: 1344});\nconst timelineId = String(created.timeline_id || created.id || '');\nif (!timelineId) throw new Error('Could not create the motion-design timeline.');\nconst document = {tracks: [{id: 'captions', name: 'Animated phrase captions', type: 'overlay', index: 0, visible: true, locked: false}, {id: 'motion-d', name: 'Motion D', type: 'overlay', index: 1, visible: true, locked: false}, {id: 'motion-c', name: 'Motion C', type: 'overlay', index: 2, visible: true, locked: false}, {id: 'motion-b', name: 'Motion B', type: 'overlay', index: 3, visible: true, locked: false}, {id: 'motion-a', name: 'Motion A', type: 'overlay', index: 4, visible: true, locked: false}, {id: 'video', name: 'Creator + native audio', type: 'video', index: 5, visible: true, locked: false}], clips: fittedClips, markers: [{id: 'opening', timeMs: openingBug.startMs, label: 'Opening bug', color: brandAccent}, {id: 'cup', timeMs: dailyRitual.startMs, label: 'Daily ritual', color: brandAccent}, {id: 'close', timeMs: closingPanel.riseStartMs, label: 'Closing panel', color: brandAccent}].filter((marker) => marker.timeMs < DURATION_MS)};\nconst written = await nodetool.timelines.setDocument(timelineId, document, {fps: 24, width: 768, height: 1344, snapshot_name: 'MORROW motion finish'});\nif (written && written.error) throw new Error(String(written.error));\nawait output('timeline', {type: 'timeline', id: timelineId});",
+          "timeout": 90,
+          "max_response_mb": 1,
+          "allow_local_network": false,
+          "allow_host_filesystem": false,
+          "secrets": [],
+          "script": {}
+        },
+        "ui_properties": {
+          "position": {
+            "x": 1160,
+            "y": 574
+          },
+          "zIndex": 0,
+          "width": 400,
+          "height": 520,
+          "selectable": true,
+          "title": "8  Build the editable motion timeline"
+        },
+        "dynamic_properties": {
+          "creator": null,
+          "words": [],
+          "brand": "",
+          "slogan": "",
+          "captionStyle": "Polished",
+          "brandAccent": {
+            "type": "color",
+            "value": "#C0D28C"
+          },
+          "clipSeconds": 0
+        },
+        "dynamic_outputs": {
+          "timeline": {
+            "type": "timeline",
+            "type_args": [],
+            "optional": false
+          }
+        }
+      },
+      {
+        "id": "render",
+        "type": "nodetool.timeline.RenderTimeline",
+        "data": {
+          "timeline": {
+            "type": "timeline",
+            "id": null,
+            "data": null
+          },
+          "include_audio": true,
+          "format": "mp4",
+          "alpha": false,
+          "video_codec": "",
+          "motion_blur_samples": 1,
+          "shutter_angle": 180,
+          "bitrate": 0,
+          "preview_scale": 1
+        },
+        "ui_properties": {
+          "position": {
+            "x": 1660,
+            "y": 828
+          },
+          "zIndex": 0,
+          "width": 300,
+          "selectable": true,
+          "title": "9  Render the finished reel"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "video-out",
+        "type": "nodetool.output.Output",
+        "data": {
+          "name": "video",
+          "description": "Polished vertical UGC reel with editable motion graphics and captions"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 2060,
+            "y": 863
+          },
+          "zIndex": 0,
+          "width": 260,
+          "selectable": true,
+          "title": "10  Branded UGC reel"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      }
+    ],
+    "edges": [
+      {
+        "id": "e1",
+        "source": "creator-clip",
+        "sourceHandle": "output",
+        "target": "extract-audio",
+        "targetHandle": "video"
+      },
+      {
+        "id": "e2",
+        "source": "extract-audio",
+        "sourceHandle": "output",
+        "target": "transcribe",
+        "targetHandle": "audio"
+      },
+      {
+        "id": "e3",
+        "source": "creator-clip",
+        "sourceHandle": "output",
+        "target": "build-timeline",
+        "targetHandle": "creator"
+      },
+      {
+        "id": "e4",
+        "source": "transcribe",
+        "sourceHandle": "words",
+        "target": "build-timeline",
+        "targetHandle": "words"
+      },
+      {
+        "id": "e5",
+        "source": "brand",
+        "sourceHandle": "output",
+        "target": "build-timeline",
+        "targetHandle": "brand"
+      },
+      {
+        "id": "e6",
+        "source": "slogan",
+        "sourceHandle": "output",
+        "target": "build-timeline",
+        "targetHandle": "slogan"
+      },
+      {
+        "id": "e7",
+        "source": "caption-style",
+        "sourceHandle": "output",
+        "target": "build-timeline",
+        "targetHandle": "captionStyle"
+      },
+      {
+        "id": "e8",
+        "source": "brand-accent",
+        "sourceHandle": "output",
+        "target": "build-timeline",
+        "targetHandle": "brandAccent"
+      },
+      {
+        "id": "e9",
+        "source": "build-timeline",
+        "sourceHandle": "timeline",
+        "target": "render",
+        "targetHandle": "timeline"
+      },
+      {
+        "id": "e10",
+        "source": "render",
+        "sourceHandle": "output",
+        "target": "video-out",
+        "targetHandle": "value"
+      },
+      {
+        "id": "e11",
+        "source": "creator-clip",
+        "sourceHandle": "output",
+        "target": "clip-info",
+        "targetHandle": "video"
+      },
+      {
+        "id": "e12",
+        "source": "clip-info",
+        "sourceHandle": "duration",
+        "target": "build-timeline",
+        "targetHandle": "clipSeconds"
+      }
+    ]
+  },
+  "input_schema": null,
+  "output_schema": null,
+  "settings": null,
+  "package_name": "nodetool-base",
+  "path": null,
+  "run_mode": null
+}

package/dist/examples/nodetool-base/Bring a Still to Life.json

@@ -0,0 +1,250 @@
+{
+  "id": "",
+  "access": "private",
+  "created_at": "2026-06-21T16:03:52.969Z",
+  "updated_at": "2026-06-21T16:55:51.256Z",
+  "name": "Bring a Still to Life",
+  "tool_name": null,
+  "description": "Turn one image into a short moving shot. The brief forbids restyling so the model may move the camera and add atmosphere but not redraw the subject - the same constraint the product templates rely on.",
+  "tags": [
+    "image",
+    "video",
+    "example"
+  ],
+  "thumbnail": "Bring a Still to Life.jpg",
+  "thumbnail_url": null,
+  "graph": {
+    "nodes": [
+      {
+        "id": "intro-comment",
+        "type": "nodetool.workflows.base_node.Comment",
+        "data": {
+          "comment": "# Bring a Still to Life\n\nTurns one image into a short moving shot. The brief lets the model move the camera and add atmosphere but tells it to keep the subject, framing and colour unchanged.\n\n**How it works:** \"1 Still\" takes the image and \"2 Motion\" describes the camera move. \"3 Motion brief\" inserts the motion into a fixed instruction. \"4 Animate\" makes a 6-second 16:9 clip at 1080p, with a negative prompt against warping. \"5 Clip\" shows the result.\n\n**Try this:** Pick a model on \"4 Animate\" and change \"2 Motion\" to \"slow orbit to the left\" to see a different camera path."
+        },
+        "ui_properties": {
+          "position": {
+            "x": 0,
+            "y": 0
+          },
+          "zIndex": 0,
+          "width": 560,
+          "selectable": true,
+          "height": 286
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "in",
+        "type": "nodetool.input.ImageInput",
+        "data": {
+          "name": "still",
+          "value": {
+            "type": "image",
+            "uri": "package://nodetool-base/recipe-inputs/coffee.jpg"
+          },
+          "description": "A still to bring to life"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 0,
+            "y": 366
+          },
+          "zIndex": 0,
+          "width": 280,
+          "selectable": true,
+          "title": "1  Still"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "mo",
+        "type": "nodetool.input.StringInput",
+        "data": {
+          "name": "motion",
+          "value": "Slow push in with a gentle parallax drift",
+          "description": "How the camera should move"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 0,
+            "y": 582
+          },
+          "zIndex": 0,
+          "width": 280,
+          "selectable": true,
+          "title": "2  Motion"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "tpl",
+        "type": "nodetool.text.Template",
+        "data": {
+          "string": "Animate this still. Camera: {{ motion }}. Preserve the subject, framing and colour exactly; add camera movement and subtle atmosphere only."
+        },
+        "ui_properties": {
+          "position": {
+            "x": 380,
+            "y": 527
+          },
+          "zIndex": 0,
+          "width": 320,
+          "selectable": true,
+          "title": "3  Motion brief"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "vid",
+        "type": "nodetool.video.ImageToVideo",
+        "data": {
+          "model": {
+            "type": "video_model",
+            "provider": "",
+            "id": "",
+            "name": "",
+            "path": null,
+            "supported_tasks": []
+          },
+          "negative_prompt": "warping, melting, drifting detail",
+          "aspect_ratio": "16:9",
+          "resolution": "1080p",
+          "duration": 6,
+          "timeout_seconds": 0
+        },
+        "ui_properties": {
+          "position": {
+            "x": 800,
+            "y": 434
+          },
+          "zIndex": 0,
+          "width": 280,
+          "selectable": true,
+          "title": "4  Animate"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "out",
+        "type": "nodetool.output.Output",
+        "data": {
+          "name": "animated"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 1180,
+            "y": 448
+          },
+          "zIndex": 0,
+          "width": 240,
+          "selectable": true,
+          "title": "5  Clip"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      }
+    ],
+    "edges": [
+      {
+        "id": "e1",
+        "source": "mo",
+        "sourceHandle": "output",
+        "target": "tpl",
+        "targetHandle": "motion"
+      },
+      {
+        "id": "e2",
+        "source": "in",
+        "sourceHandle": "output",
+        "target": "vid",
+        "targetHandle": "image"
+      },
+      {
+        "id": "e3",
+        "source": "tpl",
+        "sourceHandle": "output",
+        "target": "vid",
+        "targetHandle": "prompt"
+      },
+      {
+        "id": "e4",
+        "source": "vid",
+        "sourceHandle": "output",
+        "target": "out",
+        "targetHandle": "value"
+      }
+    ]
+  },
+  "input_schema": {
+    "type": "object",
+    "properties": {
+      "still": {
+        "type": "object",
+        "properties": {
+          "uri": {
+            "type": "string",
+            "format": "uri"
+          },
+          "type": {
+            "type": "string",
+            "const": "image"
+          }
+        },
+        "required": [
+          "uri",
+          "type"
+        ],
+        "label": ""
+      },
+      "motion": {
+        "type": "string",
+        "default": "Slow push in with a gentle parallax drift",
+        "label": ""
+      }
+    },
+    "required": [
+      "still",
+      "motion"
+    ]
+  },
+  "output_schema": {
+    "type": "object",
+    "properties": {
+      "animated": {
+        "type": "object",
+        "properties": {
+          "uri": {
+            "type": "string",
+            "format": "uri"
+          },
+          "type": {
+            "type": "string",
+            "const": "video"
+          }
+        },
+        "required": [
+          "uri",
+          "type"
+        ],
+        "label": ""
+      }
+    },
+    "required": [
+      "animated"
+    ]
+  },
+  "settings": {},
+  "package_name": "nodetool-base",
+  "path": null,
+  "run_mode": "workflow",
+  "workspace_id": null,
+  "required_providers": null,
+  "required_models": null,
+  "html_app": null,
+  "etag": "e31acfae86ee104dbf9df243c9ba6084"
+}