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

package/dist/examples/nodetool-base/Revise an Accepted Campaign Hero.json

@@ -0,0 +1,486 @@
+{
+  "id": "directed-campaign-revision",
+  "access": "private",
+  "created_at": "2026-09-12T00:00:00.000Z",
+  "updated_at": "2026-09-12T00:00:00.000Z",
+  "name": "Revise an Accepted Campaign Hero",
+  "tool_name": null,
+  "description": "Apply one bounded revision to the accepted campaign hero while recording the exact change, preservation instructions, allowed response, and parent contract.",
+  "tags": [
+    "campaign",
+    "image",
+    "example"
+  ],
+  "thumbnail": null,
+  "thumbnail_url": null,
+  "graph": {
+    "nodes": [
+      {
+        "id": "intro",
+        "type": "nodetool.workflows.base_node.Comment",
+        "data": {
+          "comment": "# Revise an Accepted Campaign Hero\n\nMakes one bounded edit to an accepted campaign hero and records exactly what changed. Use it when a hero is approved but needs a single adjustment, such as a new time of day.\n\n**How it works:** \"Accepted hero\" passes through \"Normalize app image\", which turns an app value into an image reference. \"Capture revision request\" reads that image, the \"Accepted contract\", and the \"Change\", \"Preserve\" and \"Allow to respond\" texts, checks their length limits, and writes a prompt plus a child contract that keeps the parent. \"Make one revision\" edits the hero at strength 0.45 and 16:9, with a negative prompt against added text or a changed product. \"Finalize revision candidate\" waits for the image, then emits \"Revision candidate\", \"Revision contract\" and \"Review phase\". The edit step uses your default image model, or the one you pick on the node.\n\n**Try this:** Set \"Change\" to \"Add light rain on the stone surface\" and keep \"Preserve\" as it is. The candidate should change the weather and leave the cup and composition alone."
+        },
+        "ui_properties": {
+          "position": {
+            "x": 0,
+            "y": 0
+          },
+          "width": 560,
+          "height": 423,
+          "selectable": true
+        },
+        "dynamic_properties": {}
+      },
+      {
+        "id": "in-hero",
+        "type": "nodetool.input.ImageInput",
+        "data": {
+          "name": "hero",
+          "value": {
+            "type": "image",
+            "uri": ""
+          },
+          "description": "Accepted campaign hero. This is the primary and only editing source."
+        },
+        "ui_properties": {
+          "position": {
+            "x": 0,
+            "y": 503
+          },
+          "width": 280,
+          "title": "Accepted hero"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "in-contract",
+        "type": "nodetool.input.StringInput",
+        "data": {
+          "name": "contract",
+          "value": "",
+          "description": "Accepted hero contract.",
+          "line_mode": "multi_line"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 0,
+            "y": 759
+          },
+          "width": 280,
+          "title": "Accepted contract"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "in-change",
+        "type": "nodetool.input.StringInput",
+        "data": {
+          "name": "change",
+          "value": "Move the scene from late afternoon to blue hour.",
+          "description": "The requested change.",
+          "line_mode": "multi_line",
+          "max_length": 500
+        },
+        "ui_properties": {
+          "position": {
+            "x": 0,
+            "y": 984
+          },
+          "width": 280,
+          "title": "Change"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "in-preserve",
+        "type": "nodetool.input.StringInput",
+        "data": {
+          "name": "preserve",
+          "value": "Keep the cup, camera position, composition, stone surface, headline, CTA, and spacing.",
+          "description": "What must remain unchanged.",
+          "line_mode": "multi_line",
+          "max_length": 700
+        },
+        "ui_properties": {
+          "position": {
+            "x": 0,
+            "y": 1209
+          },
+          "width": 280,
+          "title": "Preserve"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "in-allow",
+        "type": "nodetool.input.StringInput",
+        "data": {
+          "name": "allow",
+          "value": "Let reflections, shadows, and the sky respond to the light.",
+          "description": "What may respond naturally to the change.",
+          "line_mode": "multi_line",
+          "max_length": 500
+        },
+        "ui_properties": {
+          "position": {
+            "x": 0,
+            "y": 1434
+          },
+          "width": 280,
+          "title": "Allow to respond"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "normalize-hero",
+        "type": "nodetool.code.Code",
+        "data": {
+          "code": "let value = inputs.value;\nif (typeof value === \"string\") {\n  const trimmed = value.trim();\n  if (trimmed.startsWith(\"{\")) {\n    try { value = JSON.parse(trimmed); } catch { value = { type: \"image\", uri: trimmed }; }\n  } else {\n    value = { type: \"image\", uri: trimmed };\n  }\n}\nif (!value || value.type !== \"image\" || (typeof value.uri !== \"string\" && typeof value.data !== \"string\" && typeof value.asset_id !== \"string\")) throw new Error(\"The accepted hero is not a valid image reference.\");\nawait output(\"image\", value);"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 380,
+            "y": 675
+          },
+          "width": 320,
+          "title": "Normalize app image"
+        },
+        "dynamic_properties": {
+          "value": null
+        },
+        "dynamic_inputs": {
+          "value": {
+            "type": {
+              "type": "any"
+            }
+          }
+        },
+        "dynamic_outputs": {
+          "image": {
+            "type": "image",
+            "type_args": [],
+            "optional": false
+          }
+        },
+        "sync_mode": "on_all"
+      },
+      {
+        "id": "revision-prepare",
+        "type": "nodetool.code.Code",
+        "data": {
+          "code": "const heroBytes = await media.bytes(inputs.hero);\nif (heroBytes.length === 0) throw new Error(\"The accepted hero is empty.\");\nlet parentContract;\ntry { parentContract = JSON.parse(String(inputs.contract ?? \"\")); } catch { throw new Error(\"The accepted hero contract is invalid.\"); }\nif (!parentContract || parentContract.schemaVersion !== 1 || !parentContract.copy || !parentContract.selectedDirection) throw new Error(\"The accepted hero contract is incomplete.\");\nconst bounded = (name, max) => {\n  const value = String(inputs[name] ?? \"\").trim();\n  if (!value) throw new Error(`${name} is required.`);\n  if (value.length > max) throw new Error(`${name} must be ${max} characters or fewer.`);\n  return value;\n};\nconst change = bounded(\"change\", 500);\nconst preserve = bounded(\"preserve\", 700);\nconst allow = bounded(\"allow\", 500);\nconst prompt = `Edit the accepted campaign hero supplied as Image 1.\\n\\nChange: ${change}\\nPreserve exactly: ${preserve}\\nAllow to respond: ${allow}\\n\\nThe accepted image remains the source of truth for product identity, geometry, camera, surface, composition, visible branding, and copy space. Do not add, rewrite, or render the headline or CTA. Do not introduce another product.`;\nconst revisedContract = { schemaVersion: 1, kind: \"revision\", parentContract, brief: parentContract.brief, selectedDirection: parentContract.selectedDirection, copy: parentContract.copy, revisionRequest: { change, preserve, allow }, sourceOrder: [\"accepted campaign hero\"], render: { aspectRatio: \"16:9\", resolution: \"1K\", prompt } };\nawait output(\"prompt\", prompt);\nawait output(\"images\", [inputs.hero]);\nawait output(\"contract\", JSON.stringify(revisedContract));"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 800,
+            "y": 887
+          },
+          "width": 440,
+          "title": "Capture revision request"
+        },
+        "dynamic_properties": {
+          "hero": {
+            "type": "image",
+            "uri": ""
+          },
+          "contract": "",
+          "change": "",
+          "preserve": "",
+          "allow": ""
+        },
+        "dynamic_inputs": {
+          "hero": {
+            "type": {
+              "type": "any"
+            }
+          },
+          "contract": {
+            "type": {
+              "type": "str"
+            }
+          },
+          "change": {
+            "type": {
+              "type": "str"
+            }
+          },
+          "preserve": {
+            "type": {
+              "type": "str"
+            }
+          },
+          "allow": {
+            "type": {
+              "type": "str"
+            }
+          }
+        },
+        "dynamic_outputs": {
+          "prompt": {
+            "type": "str",
+            "type_args": [],
+            "optional": false
+          },
+          "images": {
+            "type": "list",
+            "type_args": [
+              {
+                "type": "image",
+                "type_args": [],
+                "optional": false
+              }
+            ],
+            "optional": false
+          },
+          "contract": {
+            "type": "str",
+            "type_args": [],
+            "optional": false
+          }
+        },
+        "sync_mode": "on_all"
+      },
+      {
+        "id": "revision-edit",
+        "type": "nodetool.image.ImageToImage",
+        "data": {
+          "model": {
+            "type": "image_model",
+            "provider": "",
+            "id": "",
+            "name": "",
+            "path": null,
+            "supported_tasks": []
+          },
+          "image": [],
+          "prompt": "",
+          "negative_prompt": "added text, changed product, changed logo, changed camera, duplicate product",
+          "entities": [],
+          "strength": 0.45,
+          "aspect_ratio": "16:9",
+          "resolution": "1K",
+          "scheduler": ""
+        },
+        "ui_properties": {
+          "position": {
+            "x": 1340,
+            "y": 1025
+          },
+          "width": 320,
+          "title": "Make one revision"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {},
+        "sync_mode": "on_all"
+      },
+      {
+        "id": "revision-finalize",
+        "type": "nodetool.code.Code",
+        "data": {
+          "code": "if (!inputs.hero || inputs.hero.type !== \"image\" || (typeof inputs.hero.uri !== \"string\" && typeof inputs.hero.data !== \"string\")) throw new Error(\"The revision model did not return a valid image.\");\nlet contract;\ntry { contract = JSON.parse(String(inputs.contract ?? \"\")); } catch { throw new Error(\"The revised contract is invalid.\"); }\nif (!contract || contract.schemaVersion !== 1 || contract.kind !== \"revision\" || !contract.parentContract || !contract.revisionRequest) throw new Error(\"The revised contract is incomplete.\");\nawait output(\"hero\", inputs.hero);\nawait output(\"contract\", JSON.stringify(contract));\nawait output(\"phase\", \"revision_review\");"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 1760,
+            "y": 889
+          },
+          "width": 380,
+          "title": "Finalize revision candidate"
+        },
+        "dynamic_properties": {
+          "hero": {
+            "type": "image",
+            "uri": ""
+          },
+          "contract": ""
+        },
+        "dynamic_inputs": {
+          "hero": {
+            "type": {
+              "type": "image"
+            }
+          },
+          "contract": {
+            "type": {
+              "type": "str"
+            }
+          }
+        },
+        "dynamic_outputs": {
+          "hero": {
+            "type": "image",
+            "type_args": [],
+            "optional": false
+          },
+          "contract": {
+            "type": "str",
+            "type_args": [],
+            "optional": false
+          },
+          "phase": {
+            "type": "str",
+            "type_args": [],
+            "optional": false
+          }
+        },
+        "sync_mode": "on_all"
+      },
+      {
+        "id": "out-hero",
+        "type": "nodetool.output.Output",
+        "data": {
+          "name": "hero"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 2240,
+            "y": 834
+          },
+          "width": 250,
+          "title": "Revision candidate"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "out-contract",
+        "type": "nodetool.output.Output",
+        "data": {
+          "name": "contract"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 2240,
+            "y": 1034
+          },
+          "width": 250,
+          "title": "Revision contract"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "out-phase",
+        "type": "nodetool.output.Output",
+        "data": {
+          "name": "phase"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 2240,
+            "y": 1234
+          },
+          "width": 250,
+          "title": "Review phase"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      }
+    ],
+    "edges": [
+      {
+        "id": "hero-to-normalizer",
+        "source": "in-hero",
+        "sourceHandle": "output",
+        "target": "normalize-hero",
+        "targetHandle": "value"
+      },
+      {
+        "id": "hero-to-prepare",
+        "source": "normalize-hero",
+        "sourceHandle": "image",
+        "target": "revision-prepare",
+        "targetHandle": "hero"
+      },
+      {
+        "id": "contract-to-prepare",
+        "source": "in-contract",
+        "sourceHandle": "output",
+        "target": "revision-prepare",
+        "targetHandle": "contract"
+      },
+      {
+        "id": "change-to-prepare",
+        "source": "in-change",
+        "sourceHandle": "output",
+        "target": "revision-prepare",
+        "targetHandle": "change"
+      },
+      {
+        "id": "preserve-to-prepare",
+        "source": "in-preserve",
+        "sourceHandle": "output",
+        "target": "revision-prepare",
+        "targetHandle": "preserve"
+      },
+      {
+        "id": "allow-to-prepare",
+        "source": "in-allow",
+        "sourceHandle": "output",
+        "target": "revision-prepare",
+        "targetHandle": "allow"
+      },
+      {
+        "id": "prompt-to-edit",
+        "source": "revision-prepare",
+        "sourceHandle": "prompt",
+        "target": "revision-edit",
+        "targetHandle": "prompt"
+      },
+      {
+        "id": "images-to-edit",
+        "source": "revision-prepare",
+        "sourceHandle": "images",
+        "target": "revision-edit",
+        "targetHandle": "image"
+      },
+      {
+        "id": "edit-to-finalize",
+        "source": "revision-edit",
+        "sourceHandle": "output",
+        "target": "revision-finalize",
+        "targetHandle": "hero"
+      },
+      {
+        "id": "contract-to-finalize",
+        "source": "revision-prepare",
+        "sourceHandle": "contract",
+        "target": "revision-finalize",
+        "targetHandle": "contract"
+      },
+      {
+        "id": "hero-out",
+        "source": "revision-finalize",
+        "sourceHandle": "hero",
+        "target": "out-hero",
+        "targetHandle": "value"
+      },
+      {
+        "id": "contract-out",
+        "source": "revision-finalize",
+        "sourceHandle": "contract",
+        "target": "out-contract",
+        "targetHandle": "value"
+      },
+      {
+        "id": "phase-out",
+        "source": "revision-finalize",
+        "sourceHandle": "phase",
+        "target": "out-phase",
+        "targetHandle": "value"
+      }
+    ]
+  },
+  "input_schema": null,
+  "output_schema": null,
+  "settings": null,
+  "package_name": "nodetool-base",
+  "path": null,
+  "run_mode": null
+}

package/dist/examples/nodetool-base/Rewrite This So a Customer Understands It.json

@@ -0,0 +1,135 @@
+{
+  "id": "",
+  "access": "private",
+  "created_at": "2026-07-30T16:00:00.000Z",
+  "updated_at": "2026-07-30T16:00:00.000Z",
+  "name": "Rewrite This So a Customer Understands It",
+  "tool_name": null,
+  "description": "Jargon in, plain language out, at a stated reading level. The most common editing job there is, and the one most worth a repeatable workflow.",
+  "tags": [
+    "text",
+    "example"
+  ],
+  "thumbnail": null,
+  "thumbnail_url": null,
+  "graph": {
+    "nodes": [
+      {
+        "id": "intro-comment",
+        "type": "nodetool.workflows.base_node.Comment",
+        "data": {
+          "comment": "# Rewrite This So a Customer Understands It\n\nRewrites technical text in plain language for a general reader. Use it for help articles, release notes, or support replies that start full of jargon.\n\n**How it works:** \"Input\" takes the text to simplify. \"Agent\" rewrites it at roughly a UK Year 9 reading level, keeping every fact and explaining jargon inline. \"Output\" returns the plain-English version.\n\n**Try this:** Pick a model on \"Agent\", then change its system prompt to target a different reader, such as a new employee in finance."
+        },
+        "ui_properties": {
+          "position": {
+            "x": 0,
+            "y": 0
+          },
+          "zIndex": 0,
+          "width": 560,
+          "selectable": true,
+          "height": 266
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "in",
+        "type": "nodetool.input.StringInput",
+        "data": {
+          "name": "text",
+          "value": "",
+          "description": "The text to simplify"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 0,
+            "y": 365
+          },
+          "zIndex": 0,
+          "width": 300,
+          "selectable": true,
+          "title": "1  Input"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "ag",
+        "type": "nodetool.agents.Agent",
+        "data": {
+          "model": {
+            "type": "language_model",
+            "provider": "",
+            "id": "",
+            "name": "",
+            "path": null,
+            "supported_tasks": []
+          },
+          "system": "You rewrite technical text for a general reader at roughly a UK Year 9 reading level. Keep every fact. Replace jargon or explain it inline. Do not add new claims.",
+          "prompt": "",
+          "tools": [],
+          "image": [],
+          "audio": [],
+          "history": [],
+          "thread_id": "",
+          "max_tokens": 16384,
+          "max_turns": 100
+        },
+        "ui_properties": {
+          "position": {
+            "x": 400,
+            "y": 346
+          },
+          "zIndex": 0,
+          "width": 300,
+          "selectable": true,
+          "title": "2  Agent"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "out",
+        "type": "nodetool.output.Output",
+        "data": {
+          "name": "plain_english"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 800,
+            "y": 378
+          },
+          "zIndex": 0,
+          "width": 300,
+          "selectable": true,
+          "title": "3  Output"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      }
+    ],
+    "edges": [
+      {
+        "id": "e1",
+        "source": "in",
+        "sourceHandle": "output",
+        "target": "ag",
+        "targetHandle": "prompt"
+      },
+      {
+        "id": "e2",
+        "source": "ag",
+        "sourceHandle": "text",
+        "target": "out",
+        "targetHandle": "value"
+      }
+    ]
+  },
+  "input_schema": null,
+  "output_schema": null,
+  "settings": null,
+  "package_name": "nodetool-base",
+  "path": null,
+  "run_mode": null
+}