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

package/dist/examples/nodetool-base/Put a Product on a Studio Backdrop.json

@@ -0,0 +1,252 @@
+{
+  "id": "",
+  "access": "private",
+  "created_at": "2026-07-30T16:00:00.000Z",
+  "updated_at": "2026-07-30T16:00:00.000Z",
+  "name": "Put a Product on a Studio Backdrop",
+  "tool_name": null,
+  "description": "Remove the background, soften the cutout edge, and place the product in a new studio scene.",
+  "tags": [
+    "image",
+    "example"
+  ],
+  "thumbnail": null,
+  "thumbnail_url": null,
+  "graph": {
+    "nodes": [
+      {
+        "id": "intro-comment",
+        "type": "nodetool.workflows.base_node.Comment",
+        "data": {
+          "comment": "# Put a Product on a Studio Backdrop\n\nCuts a product out of its photo and places it in a new studio scene. Use it to restyle product shots without a reshoot.\n\n**How it works:** \"Photo\" goes to \"Cut out\", which removes the background. \"Soften cutout edge\" blurs the mask by the \"Edge softness\" value, and \"Keep product detail\" puts that softer mask back on the product. \"Place on backdrop\" generates a concrete plinth scene around it, and \"Result\" shows the image.\n\n**Try this:** Pick a model on \"Place on backdrop\", then change its prompt to \"white marble countertop, morning window light\"."
+        },
+        "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": "photo",
+          "value": {
+            "type": "image",
+            "uri": "package://nodetool-base/recipe-inputs/coffee.jpg"
+          },
+          "description": "The product photo"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 0,
+            "y": 366
+          },
+          "zIndex": 0,
+          "width": 300,
+          "selectable": true,
+          "title": "1  Photo"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "bg",
+        "type": "nodetool.image.RemoveBackground",
+        "data": {
+          "model": {
+            "type": "image_model",
+            "provider": "",
+            "id": "",
+            "name": "",
+            "path": null,
+            "supported_tasks": []
+          }
+        },
+        "ui_properties": {
+          "position": {
+            "x": 400,
+            "y": 441
+          },
+          "zIndex": 0,
+          "width": 300,
+          "selectable": true,
+          "title": "2  Cut out"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "comp",
+        "type": "nodetool.image.ImageToImage",
+        "data": {
+          "model": {
+            "type": "image_model",
+            "provider": "",
+            "id": "",
+            "name": "",
+            "path": null,
+            "supported_tasks": []
+          },
+          "image": [],
+          "prompt": "Keep the product as it is. Change only what is around it: warm concrete plinth, soft studio key from upper left, blurred background.",
+          "negative_prompt": "",
+          "entities": [],
+          "aspect_ratio": "1:1",
+          "resolution": "1K"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 1600,
+            "y": 459
+          },
+          "zIndex": 0,
+          "width": 300,
+          "selectable": true,
+          "title": "3  Place on backdrop"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "out",
+        "type": "nodetool.output.Output",
+        "data": {
+          "name": "styled"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 2000,
+            "y": 468
+          },
+          "zIndex": 0,
+          "width": 300,
+          "selectable": true,
+          "title": "4  Result"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "edge-softness",
+        "type": "nodetool.input.FloatInput",
+        "data": {
+          "name": "edge_softness",
+          "value": 1,
+          "min": 0,
+          "max": 3,
+          "description": "Edge softness in pixels. Set to 0 for the original cutout."
+        },
+        "ui_properties": {
+          "position": {
+            "x": 0,
+            "y": 590
+          },
+          "width": 300,
+          "title": "Edge softness"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "soften-alpha",
+        "type": "lib.image.filter.GaussianBlur",
+        "data": {
+          "radius": 1,
+          "sigma": 0
+        },
+        "ui_properties": {
+          "position": {
+            "x": 800,
+            "y": 455
+          },
+          "width": 300,
+          "title": "Soften cutout edge"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "refine-cutout",
+        "type": "lib.image.channel.Merge",
+        "data": {
+          "alpha_channel": 3
+        },
+        "ui_properties": {
+          "position": {
+            "x": 1200,
+            "y": 465
+          },
+          "width": 300,
+          "title": "Keep product detail"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      }
+    ],
+    "edges": [
+      {
+        "id": "e1",
+        "source": "in",
+        "sourceHandle": "output",
+        "target": "bg",
+        "targetHandle": "image"
+      },
+      {
+        "id": "e3",
+        "source": "comp",
+        "sourceHandle": "output",
+        "target": "out",
+        "targetHandle": "value"
+      },
+      {
+        "id": "bg-soften-alpha-image",
+        "source": "bg",
+        "sourceHandle": "output",
+        "target": "soften-alpha",
+        "targetHandle": "image"
+      },
+      {
+        "id": "edge-softness-soften-alpha-radius",
+        "source": "edge-softness",
+        "sourceHandle": "output",
+        "target": "soften-alpha",
+        "targetHandle": "radius"
+      },
+      {
+        "id": "bg-refine-cutout-image",
+        "source": "bg",
+        "sourceHandle": "output",
+        "target": "refine-cutout",
+        "targetHandle": "image"
+      },
+      {
+        "id": "soften-alpha-refine-cutout-alpha",
+        "source": "soften-alpha",
+        "sourceHandle": "output",
+        "target": "refine-cutout",
+        "targetHandle": "alpha"
+      },
+      {
+        "id": "e2",
+        "source": "refine-cutout",
+        "sourceHandle": "output",
+        "target": "comp",
+        "targetHandle": "image"
+      }
+    ]
+  },
+  "input_schema": null,
+  "output_schema": null,
+  "settings": null,
+  "package_name": "nodetool-base",
+  "path": null,
+  "run_mode": null
+}

package/dist/examples/nodetool-base/Put a Voice Over a Music Bed.json

@@ -0,0 +1,358 @@
+{
+  "id": "",
+  "access": "private",
+  "created_at": "2026-07-30T12:00:00.000Z",
+  "updated_at": "2026-07-30T12:00:00.000Z",
+  "name": "Put a Voice Over a Music Bed",
+  "tool_name": null,
+  "description": "Voice a script over a quiet music bed. Match the music to the voiceover and fade the start and finish.",
+  "tags": [
+    "audio",
+    "example"
+  ],
+  "thumbnail": null,
+  "thumbnail_url": null,
+  "graph": {
+    "nodes": [
+      {
+        "id": "intro-comment",
+        "type": "nodetool.workflows.base_node.Comment",
+        "data": {
+          "comment": "# Put a Voice Over a Music Bed\n\nVoices a one-line script and mixes it over a generated music bed. Use it to make a short audio spot.\n\n**How it works:** \"Voice\" reads the \"Script\". \"Normalize\" and a \"Gain\" of -3 dB set the voice level, and \"GetAudioInfo\" measures its length. \"Music bed\" generates music, which \"Trim\" cuts to that length. A \"Gain\" of -18 dB, \"FadeIn\" and \"FadeOut\" place it under the voice. \"Overlay\" mixes both into the \"Spot\".\n\n**Try this:** Pick models on \"Voice\" and \"Music bed\", then rewrite \"Script\" with your own tagline."
+        },
+        "ui_properties": {
+          "position": {
+            "x": 0,
+            "y": 0
+          },
+          "zIndex": 0,
+          "width": 560,
+          "selectable": true,
+          "height": 286
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "t",
+        "type": "nodetool.constant.String",
+        "data": {
+          "value": "Built for people who would rather ship than configure."
+        },
+        "ui_properties": {
+          "position": {
+            "x": 0,
+            "y": 615
+          },
+          "zIndex": 0,
+          "width": 280,
+          "selectable": true,
+          "title": "1  Script"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "tts",
+        "type": "nodetool.audio.TextToSpeech",
+        "data": {
+          "model": {
+            "type": "tts_model",
+            "provider": "",
+            "id": "",
+            "name": "",
+            "path": null,
+            "voices": [],
+            "selected_voice": ""
+          },
+          "text": "",
+          "speed": 1.0
+        },
+        "ui_properties": {
+          "position": {
+            "x": 380,
+            "y": 567
+          },
+          "zIndex": 0,
+          "width": 280,
+          "selectable": true,
+          "title": "2  Voice"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "mus",
+        "type": "nodetool.audio.TextToMusic",
+        "data": {
+          "model": {
+            "type": "music_model",
+            "provider": "",
+            "id": "",
+            "name": "",
+            "path": null
+          },
+          "prompt": "calm ambient pad, no drums, soft and unobtrusive",
+          "lyrics": "",
+          "duration": 8.0
+        },
+        "ui_properties": {
+          "position": {
+            "x": 1140,
+            "y": 596
+          },
+          "zIndex": 0,
+          "width": 280,
+          "selectable": true,
+          "title": "3  Music bed"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "ov",
+        "type": "nodetool.audio.OverlayAudio",
+        "data": {},
+        "ui_properties": {
+          "position": {
+            "x": 3040,
+            "y": 473
+          },
+          "zIndex": 0,
+          "width": 280,
+          "selectable": true,
+          "title": "4  Overlay"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {},
+        "sync_mode": "on_all"
+      },
+      {
+        "id": "out",
+        "type": "nodetool.output.Output",
+        "data": {
+          "name": "spot"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 3420,
+            "y": 482
+          },
+          "zIndex": 0,
+          "width": 280,
+          "selectable": true,
+          "title": "5  Spot"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "voice-level",
+        "type": "nodetool.audio.Normalize",
+        "data": {},
+        "ui_properties": {
+          "position": {
+            "x": 760,
+            "y": 649
+          },
+          "width": 280
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {},
+        "sync_mode": "on_all"
+      },
+      {
+        "id": "voice-headroom",
+        "type": "lib.audio.Gain",
+        "data": {
+          "gain_db": -3
+        },
+        "ui_properties": {
+          "position": {
+            "x": 1140,
+            "y": 366
+          },
+          "width": 280
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {},
+        "sync_mode": "on_all"
+      },
+      {
+        "id": "voice-length",
+        "type": "nodetool.audio.GetAudioInfo",
+        "data": {},
+        "ui_properties": {
+          "position": {
+            "x": 1140,
+            "y": 913
+          },
+          "width": 280
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {},
+        "sync_mode": "on_all"
+      },
+      {
+        "id": "music-trim",
+        "type": "nodetool.audio.Trim",
+        "data": {
+          "start": 0
+        },
+        "ui_properties": {
+          "position": {
+            "x": 1520,
+            "y": 744
+          },
+          "width": 280
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {},
+        "sync_mode": "on_all"
+      },
+      {
+        "id": "music-level",
+        "type": "lib.audio.Gain",
+        "data": {
+          "gain_db": -18
+        },
+        "ui_properties": {
+          "position": {
+            "x": 1900,
+            "y": 636
+          },
+          "width": 280
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {},
+        "sync_mode": "on_all"
+      },
+      {
+        "id": "music-start",
+        "type": "nodetool.audio.FadeIn",
+        "data": {
+          "duration": 0.2
+        },
+        "ui_properties": {
+          "position": {
+            "x": 2280,
+            "y": 636
+          },
+          "width": 280
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {},
+        "sync_mode": "on_all"
+      },
+      {
+        "id": "music-end",
+        "type": "nodetool.audio.FadeOut",
+        "data": {
+          "duration": 0.6
+        },
+        "ui_properties": {
+          "position": {
+            "x": 2660,
+            "y": 582
+          },
+          "width": 280
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {},
+        "sync_mode": "on_all"
+      }
+    ],
+    "edges": [
+      {
+        "id": "e1",
+        "source": "t",
+        "sourceHandle": "output",
+        "target": "tts",
+        "targetHandle": "text"
+      },
+      {
+        "id": "e4",
+        "source": "ov",
+        "sourceHandle": "output",
+        "target": "out",
+        "targetHandle": "value"
+      },
+      {
+        "id": "tts-voice-level",
+        "source": "tts",
+        "sourceHandle": "audio",
+        "target": "voice-level",
+        "targetHandle": "audio"
+      },
+      {
+        "id": "voice-level-voice-headroom",
+        "source": "voice-level",
+        "sourceHandle": "output",
+        "target": "voice-headroom",
+        "targetHandle": "audio"
+      },
+      {
+        "id": "voice-level-voice-length",
+        "source": "voice-level",
+        "sourceHandle": "output",
+        "target": "voice-length",
+        "targetHandle": "audio"
+      },
+      {
+        "id": "voice-headroom-ov",
+        "source": "voice-headroom",
+        "sourceHandle": "output",
+        "target": "ov",
+        "targetHandle": "a"
+      },
+      {
+        "id": "mus-music-trim",
+        "source": "mus",
+        "sourceHandle": "audio",
+        "target": "music-trim",
+        "targetHandle": "audio"
+      },
+      {
+        "id": "voice-length-music-trim",
+        "source": "voice-length",
+        "sourceHandle": "duration",
+        "target": "music-trim",
+        "targetHandle": "end"
+      },
+      {
+        "id": "music-trim-music-level",
+        "source": "music-trim",
+        "sourceHandle": "output",
+        "target": "music-level",
+        "targetHandle": "audio"
+      },
+      {
+        "id": "music-level-music-start",
+        "source": "music-level",
+        "sourceHandle": "output",
+        "target": "music-start",
+        "targetHandle": "audio"
+      },
+      {
+        "id": "music-start-music-end",
+        "source": "music-start",
+        "sourceHandle": "output",
+        "target": "music-end",
+        "targetHandle": "audio"
+      },
+      {
+        "id": "music-end-ov",
+        "source": "music-end",
+        "sourceHandle": "output",
+        "target": "ov",
+        "targetHandle": "b"
+      }
+    ]
+  },
+  "input_schema": null,
+  "output_schema": null,
+  "settings": null,
+  "package_name": "nodetool-base",
+  "path": null,
+  "run_mode": null
+}

package/dist/examples/nodetool-base/README_EXAMPLES.md

@@ -0,0 +1,59 @@
+# nodetool-base Example Workflows
+
+Every `*.json` in this directory is a shipped example workflow. They are loaded
+into the in-app gallery, exposed to agents through `get_example_workflow`, and
+generate the public template pages under `marketing/src/routes/templates`.
+
+Because each file becomes a gallery card and a public page, a new example has to
+earn its place. The bar:
+
+- **It does work.** A graph whose only nodes are a constant and an output
+  teaches nothing the node reference does not.
+- **It is not a re-skin.** If an existing example has the same node types and
+  the same configuration, and only the prompt or the port names differ, edit
+  that one instead of adding a second.
+- **The description stands alone.** Under 80 characters and the marketing
+  generator marks the page `indexable: false`. Say what the graph does and why
+  the settings are what they are.
+- **A thumbnail exists.** `packages/base-nodes/nodetool/assets/nodetool-base/<name>.jpg`,
+  matched by workflow name. A missing thumbnail also drops the page from the
+  index.
+
+## Validating
+
+```bash
+npm run dev:nodetool -- validate "packages/base-nodes/nodetool/examples/nodetool-base/<name>.json"
+npm run test --workspace=packages/base-nodes   # example-workflows-validation, *-examples-run
+```
+
+`packages/base-nodes/tests/example-workflows-validation.test.ts` checks every
+file here against the live node registry — unknown node types, missing
+properties and dangling edges fail the suite.
+
+## After adding or removing a workflow
+
+The marketing catalog is generated and CI fails when it is stale:
+
+```bash
+cd marketing && npm run gen:templates    # regenerates templateEntries.generated.ts + public/templates
+```
+
+## Thumbnails
+
+`gallery_thumbnail_generator.ts` walks every `*.json` here, asks an LLM for an
+icon concept from the workflow's name, description, tags and node types, then
+renders it with FLUX.2 [klein] on fal.ai. Tint follows the gallery category
+(Image=violet, Video=magenta, Audio=amber, Multimodal=cyan, Agents=blue,
+Data & Web=green), mirroring `web/src/utils/templateCategories.ts`. Masters land
+as PNG in `../../assets/nodetool-base/`; `scripts/convert-thumbnails.ts` encodes
+the served 1280×720 `.jpg` cards.
+
+```bash
+# from repo root — only missing masters by default
+npx tsx packages/base-nodes/nodetool/examples/nodetool-base/gallery_thumbnail_generator.ts
+#   --all            regenerate every workflow
+#   --only "Color"   regenerate workflows whose name matches
+npx tsx packages/base-nodes/scripts/convert-thumbnails.ts
+```
+
+Requires `OPENAI_API_KEY` and `FAL_API_KEY` in the local secret store.