@nodetool-ai/project-services 0.8.9-beta.2 → 0.8.9-beta.5

package/dist/examples/nodetool-base/Product URL to UGC Ad.json

@@ -0,0 +1,298 @@
+{
+  "id": "product-url-to-ugc-ad-0000000001",
+  "access": "public",
+  "created_at": "2026-10-26T12:00:00.000000",
+  "updated_at": "2026-10-26T12:00:00.000000",
+  "name": "Product URL to UGC Ad",
+  "description": "Paste a product page URL to extract its headline, value props, and proof points, write a 15-second spoken creator script, synthesize the voiceover, and lip-sync a creator portrait into a vertical UGC ad. Estimated cost is about $0.45 to $1.10 per ad on fal at provider list price.",
+  "tags": [
+    "video",
+    "marketing",
+    "advertising",
+    "ugc",
+    "higgsfield-pack",
+    "ads",
+    "example"
+  ],
+  "required_providers": [
+    "fal"
+  ],
+  "thumbnail": "Assemble a UGC Product Video.jpg",
+  "graph": {
+    "edges": [
+      {
+        "id": "e1",
+        "source": "product_url",
+        "sourceHandle": "output",
+        "target": "scrape_brief",
+        "targetHandle": "url"
+      },
+      {
+        "id": "e2",
+        "source": "persona",
+        "sourceHandle": "output",
+        "target": "scrape_brief",
+        "targetHandle": "persona"
+      },
+      {
+        "id": "e3",
+        "source": "scrape_brief",
+        "sourceHandle": "output",
+        "target": "product_researcher",
+        "targetHandle": "prompt"
+      },
+      {
+        "id": "e4",
+        "source": "product_researcher",
+        "sourceHandle": "text",
+        "target": "script_out",
+        "targetHandle": "value"
+      },
+      {
+        "id": "e5",
+        "source": "product_researcher",
+        "sourceHandle": "text",
+        "target": "voice",
+        "targetHandle": "text"
+      },
+      {
+        "id": "e6",
+        "source": "voice",
+        "sourceHandle": "audio",
+        "target": "norm_voice",
+        "targetHandle": "audio"
+      },
+      {
+        "id": "e7",
+        "source": "creator_photo",
+        "sourceHandle": "output",
+        "target": "avatar_base",
+        "targetHandle": "image"
+      },
+      {
+        "id": "e8",
+        "source": "persona",
+        "sourceHandle": "output",
+        "target": "avatar_base",
+        "targetHandle": "prompt"
+      },
+      {
+        "id": "e9",
+        "source": "avatar_base",
+        "sourceHandle": "output",
+        "target": "synced_ugc",
+        "targetHandle": "video"
+      },
+      {
+        "id": "e10",
+        "source": "norm_voice",
+        "sourceHandle": "output",
+        "target": "synced_ugc",
+        "targetHandle": "audio"
+      },
+      {
+        "id": "e11",
+        "source": "synced_ugc",
+        "sourceHandle": "output",
+        "target": "ugc_ad",
+        "targetHandle": "value"
+      }
+    ],
+    "nodes": [
+      {
+        "id": "intro",
+        "type": "nodetool.workflows.base_node.Comment",
+        "data": {
+          "comment": "# Product URL to UGC Ad\n\n**Product URL to UGC Ad** visits a live product page, writes a spoken creator hook, and renders a lip-synced vertical ad.\n\n1. **Product URL** and **Creator Persona** feed into **Agent** (with browser access) to extract product claims and draft a 15-second spoken script.\n2. **TextToSpeech** and **Normalize** produce the voice track while **ImageToVideo** animates the **Creator Photo**.\n3. **LipSync** locks the creator's mouth movements to the spoken script."
+        },
+        "position": {
+          "x": 80,
+          "y": -220
+        },
+        "width": 720,
+        "height": 180
+      },
+      {
+        "id": "product_url",
+        "type": "nodetool.input.StringInput",
+        "data": {
+          "name": "product_url",
+          "value": "https://nodetool.ai",
+          "description": "Landing page or store URL for the product being advertised.",
+          "line_mode": "single_line"
+        },
+        "position": {
+          "x": 80,
+          "y": 40
+        }
+      },
+      {
+        "id": "persona",
+        "type": "nodetool.input.StringInput",
+        "data": {
+          "name": "creator_persona",
+          "value": "Handheld vertical phone video of a warm, direct creator speaking naturally to camera in a sunlit apartment",
+          "description": "Delivery style and camera framing for the creator.",
+          "line_mode": "multi_line"
+        },
+        "position": {
+          "x": 80,
+          "y": 200
+        }
+      },
+      {
+        "id": "creator_photo",
+        "type": "nodetool.input.ImageInput",
+        "data": {
+          "name": "creator_photo",
+          "value": {
+            "type": "image",
+            "uri": "package://nodetool-base/recipe-inputs/ugc-creator-reference.png",
+            "asset_id": null,
+            "data": null,
+            "metadata": null
+          },
+          "description": "Portrait photo of the spokesperson or creator."
+        },
+        "position": {
+          "x": 80,
+          "y": 380
+        }
+      },
+      {
+        "id": "scrape_brief",
+        "type": "nodetool.text.Prompt",
+        "data": {
+          "template": "Open {{ url }} and read the product headline, core benefits, and pricing or proof points.\n\nWrite a 15-second spoken UGC ad script (35 to 42 words) matching this persona: {{ persona }}.\n\nReturn ONLY the spoken lines — no stage directions, no quotation marks, no headings."
+        },
+        "position": {
+          "x": 380,
+          "y": 80
+        }
+      },
+      {
+        "id": "product_researcher",
+        "type": "nodetool.agents.Agent",
+        "data": {
+          "model": {
+            "type": "language_model",
+            "provider": "",
+            "id": "",
+            "name": "",
+            "path": null
+          },
+          "system": "You are a direct-response UGC scriptwriter. Visit the URL using the browser tool, verify every claim against the page, and output only the spoken script.",
+          "tools": [
+            {
+              "type": "tool_name",
+              "name": "browser"
+            },
+            {
+              "type": "tool_name",
+              "name": "web_search"
+            }
+          ],
+          "max_tokens": 1024
+        },
+        "position": {
+          "x": 660,
+          "y": 80
+        }
+      },
+      {
+        "id": "voice",
+        "type": "nodetool.audio.TextToSpeech",
+        "data": {
+          "model": {
+            "type": "tts_model",
+            "provider": "",
+            "id": "",
+            "name": "",
+            "path": null
+          },
+          "speed": 1
+        },
+        "position": {
+          "x": 960,
+          "y": 140
+        }
+      },
+      {
+        "id": "norm_voice",
+        "type": "nodetool.audio.Normalize",
+        "data": {},
+        "position": {
+          "x": 1220,
+          "y": 140
+        }
+      },
+      {
+        "id": "avatar_base",
+        "type": "nodetool.video.ImageToVideo",
+        "data": {
+          "model": {
+            "type": "video_model",
+            "provider": "",
+            "id": "",
+            "name": "",
+            "path": null
+          },
+          "aspect_ratio": "9:16",
+          "resolution": "720p",
+          "duration": 5
+        },
+        "position": {
+          "x": 960,
+          "y": 380
+        }
+      },
+      {
+        "id": "synced_ugc",
+        "type": "nodetool.video.LipSync",
+        "data": {
+          "model": {
+            "type": "video_model",
+            "provider": "",
+            "id": "",
+            "name": "",
+            "path": null
+          }
+        },
+        "position": {
+          "x": 1460,
+          "y": 280
+        }
+      },
+      {
+        "id": "script_out",
+        "type": "nodetool.output.Output",
+        "data": {
+          "name": "spoken_script",
+          "description": "The 15-second spoken script grounded in the product page."
+        },
+        "position": {
+          "x": 960,
+          "y": -20
+        }
+      },
+      {
+        "id": "ugc_ad",
+        "type": "nodetool.output.Output",
+        "data": {
+          "name": "ugc_ad_video",
+          "description": "The lip-synced vertical UGC ad clip."
+        },
+        "position": {
+          "x": 1720,
+          "y": 280
+        }
+      }
+    ]
+  },
+  "input_schema": null,
+  "output_schema": null,
+  "settings": null,
+  "package_name": "nodetool-base",
+  "path": null,
+  "run_mode": null
+}

package/dist/examples/nodetool-base/Product Video Generator.json

@@ -0,0 +1,344 @@
+{
+  "id": "",
+  "access": "private",
+  "created_at": "2026-06-21T16:03:52.969Z",
+  "updated_at": "2026-06-21T16:55:51.256Z",
+  "name": "Product Video Generator",
+  "tool_name": null,
+  "description": "Turn a campaign brief, audience, features, and a product photo into a realistic 16:9 launch video — an agent writes the motion prompt, then an image-to-video model animates the shot. Cost note: the video step is a paid generation, so this run costs noticeably more than an image-only template.",
+  "tags": [
+    "business",
+    "data",
+    "video",
+    "example"
+  ],
+  "thumbnail": null,
+  "thumbnail_url": null,
+  "graph": {
+    "edges": [
+      {
+        "id": "01ff2dd6-973b-486d-aa3d-49047690ac60",
+        "source": "5",
+        "sourceHandle": "output",
+        "target": "4",
+        "targetHandle": "brief",
+        "ui_properties": {
+          "className": "str"
+        },
+        "edge_type": "data"
+      },
+      {
+        "id": "1bf29f21-70b9-46e1-895b-b0270b558090",
+        "source": "6",
+        "sourceHandle": "output",
+        "target": "4",
+        "targetHandle": "audience",
+        "ui_properties": {
+          "className": "str"
+        },
+        "edge_type": "data"
+      },
+      {
+        "id": "be968faa-0e7b-416f-b129-23e742d264bc",
+        "source": "7",
+        "sourceHandle": "output",
+        "target": "4",
+        "targetHandle": "features",
+        "ui_properties": {
+          "className": "str"
+        },
+        "edge_type": "data"
+      },
+      {
+        "id": "prompt-to-agent",
+        "source": "4",
+        "sourceHandle": "output",
+        "target": "3",
+        "targetHandle": "prompt",
+        "ui_properties": {
+          "className": "str"
+        },
+        "edge_type": "data"
+      },
+      {
+        "id": "68208701-a9b9-4f60-8666-9deed353a089",
+        "source": "ada8f51f-0155-4178-a07c-9415be82534a",
+        "sourceHandle": "output",
+        "target": "3",
+        "targetHandle": "image",
+        "ui_properties": {
+          "className": "image"
+        },
+        "edge_type": "data"
+      },
+      {
+        "id": "cba6ce0e-77cb-4f46-89f1-926d790d4d39",
+        "source": "3",
+        "sourceHandle": "text",
+        "target": "97f03868-da4f-4604-b57e-5f2118847956",
+        "targetHandle": "prompt",
+        "ui_properties": {
+          "className": "str"
+        },
+        "edge_type": "data"
+      },
+      {
+        "id": "12e3b210-b6b1-4503-9edf-7980c3613d23",
+        "source": "ada8f51f-0155-4178-a07c-9415be82534a",
+        "sourceHandle": "output",
+        "target": "97f03868-da4f-4604-b57e-5f2118847956",
+        "targetHandle": "image",
+        "ui_properties": {
+          "className": "image"
+        },
+        "edge_type": "data"
+      },
+      {
+        "id": "edge-output-product-video",
+        "source": "97f03868-da4f-4604-b57e-5f2118847956",
+        "sourceHandle": "output",
+        "target": "output-product-video",
+        "targetHandle": "value",
+        "ui_properties": null
+      }
+    ],
+    "nodes": [
+      {
+        "id": "comment-1",
+        "type": "nodetool.workflows.base_node.Comment",
+        "data": {
+          "comment": "# 🎬 Product Video Generator\n\nTurns a campaign brief and product image into a cinematic 16:9 launch clip. Use it when you already have a product photo and want a short animated shot.\n\n**How it works:** \"1️⃣ Campaign brief\", \"2️⃣ Target audience\" and \"3️⃣ Key features\" fill \"5️⃣ Build prompt\". \"6️⃣ Write video prompt\" is an Agent that reads that prompt together with \"4️⃣ Product image\" and writes one image-to-video paragraph. \"7️⃣ Animate product video\" animates the same product image with that prompt for 8 seconds at 720p. Pick a language model on \"6️⃣ Write video prompt\". The animation step uses your default video model, or the one you pick on the node. It is a paid video generation, so each run costs noticeably more than an image-only template.\n\n**Try this:** Change \"2️⃣ Target audience\" to \"retirees who walk daily\" and compare the setting and pace of the new clip."
+        },
+        "ui_properties": {
+          "position": {
+            "x": 0,
+            "y": 0
+          },
+          "zIndex": 0,
+          "width": 560,
+          "height": 362,
+          "selectable": true,
+          "bypassed": false
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "4",
+        "type": "nodetool.text.Prompt",
+        "data": {
+          "prompt": "Using the text and image inputs, write a video prompt for a single 16:9 product shot. Give clear instructions on the animations and movements in the video.\n\nRules:\n- Present tense, visually concrete; one clear camera move and one primary subject action.\n- Include: subject, setting, time-of-day, camera language (framing, angle, lens, movement), composition cues, lighting, 3–5 color anchors, atmosphere/texture, and realistic motion cues.\n- Emphasize the product and key features naturally within the scene for the target audience and tone.\n- Finish with constraints: no on-screen text, no logos, no watermarks, no glitches, no distorted anatomy.\n\nInputs:\n- Campaign brief: {{ brief }}\n- Target audience: {{ audience }}\n- Key features: {{ features }}"
+        },
+        "ui_properties": {
+          "selected": false,
+          "position": {
+            "x": 380,
+            "y": 500
+          },
+          "zIndex": 0,
+          "width": 486,
+          "height": 567,
+          "title": "5️⃣ Build prompt",
+          "selectable": true,
+          "bypassed": false
+        },
+        "dynamic_properties": {
+          "brief": "Launch video for the Aurora Trail smart fitness watch, highlighting outdoor adventure tracking.",
+          "audience": "active millennials who enjoy weekend hiking and fitness challenges",
+          "features": "GPS navigation, heart-rate analytics, adaptive coaching, water resistance"
+        },
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "3",
+        "type": "nodetool.agents.Agent",
+        "data": {
+          "model": {
+            "type": "language_model",
+            "provider": "",
+            "id": "",
+            "name": "",
+            "path": null,
+            "supported_tasks": []
+          },
+          "system": "You are a prompt engineer specializing in image-to-video generation models.\n\nTask: read the campaign brief, target audience, and key features, then rewrite them as a single production-ready image-to-video prompt for the attached product photo.\n\nOutput format: plain text, one paragraph, no markdown, no headers, no lists, no preamble. Return only the finished prompt.",
+          "audio": {
+            "type": "audio",
+            "uri": "",
+            "asset_id": null,
+            "data": null
+          },
+          "history": [],
+          "thread_id": null,
+          "max_tokens": 100000
+        },
+        "ui_properties": {
+          "selected": false,
+          "position": {
+            "x": 966,
+            "y": 780
+          },
+          "zIndex": 0,
+          "width": 457,
+          "height": 429,
+          "title": "6️⃣ Write video prompt",
+          "selectable": true,
+          "bypassed": false
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "5",
+        "type": "nodetool.input.StringInput",
+        "data": {
+          "name": "campaign_brief",
+          "value": "Launch video for the Aurora Trail smart fitness watch, highlighting outdoor adventure tracking.",
+          "description": "Short description of the campaign concept"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 0,
+            "y": 442
+          },
+          "zIndex": 0,
+          "width": 280,
+          "title": "1️⃣ Campaign brief",
+          "selectable": true,
+          "bypassed": false
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "6",
+        "type": "nodetool.input.StringInput",
+        "data": {
+          "name": "target_audience",
+          "value": "active millennials who enjoy weekend hiking and fitness challenges",
+          "description": "Primary audience for the marketing video"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 0,
+            "y": 667
+          },
+          "zIndex": 0,
+          "width": 280,
+          "title": "2️⃣ Target audience",
+          "selectable": true,
+          "bypassed": false
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "7",
+        "type": "nodetool.input.StringInput",
+        "data": {
+          "name": "key_features",
+          "value": "GPS navigation, heart-rate analytics, adaptive coaching, water resistance",
+          "description": "Key product features to highlight"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 0,
+            "y": 892
+          },
+          "zIndex": 0,
+          "width": 280,
+          "title": "3️⃣ Key features",
+          "selectable": true,
+          "bypassed": false
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "ada8f51f-0155-4178-a07c-9415be82534a",
+        "type": "nodetool.input.ImageInput",
+        "data": {
+          "name": "image_input_1",
+          "value": {
+            "type": "image",
+            "uri": "package://nodetool-base/recipe-inputs/coffee.jpg"
+          },
+          "description": "Product photo to animate into the launch video"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 0,
+            "y": 1117
+          },
+          "zIndex": 0,
+          "width": 280,
+          "title": "4️⃣ Product image",
+          "selectable": true,
+          "bypassed": false
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "97f03868-da4f-4604-b57e-5f2118847956",
+        "type": "nodetool.video.ImageToVideo",
+        "data": {
+          "model": {
+            "type": "video_model",
+            "provider": "",
+            "id": "",
+            "name": "",
+            "path": null,
+            "supported_tasks": []
+          },
+          "negative_prompt": "",
+          "aspect_ratio": "16:9",
+          "resolution": "720p",
+          "duration": 8,
+          "timeout_seconds": 0
+        },
+        "ui_properties": {
+          "selected": false,
+          "position": {
+            "x": 1523,
+            "y": 831
+          },
+          "zIndex": 0,
+          "width": 739,
+          "height": 453,
+          "title": "7️⃣ Animate product video",
+          "selectable": true,
+          "bypassed": false,
+          "selected_generation": "2059791e2f4e44e29db7d3424ab0ee18"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "output-product-video",
+        "type": "nodetool.output.Output",
+        "data": {
+          "name": "product_video"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 2362,
+            "y": 984
+          },
+          "selectable": true
+        }
+      }
+    ]
+  },
+  "input_schema": null,
+  "output_schema": null,
+  "settings": {},
+  "package_name": "nodetool-base",
+  "path": null,
+  "run_mode": "workflow",
+  "workspace_id": null,
+  "required_providers": null,
+  "required_models": null,
+  "html_app": null,
+  "etag": "e31acfae86ee104dbf9df243c9ba6084"
+}