@nodetool-ai/project-services 0.8.9-beta.2 → 0.8.9-beta.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. It ships with the coffee photo and a sample contract, so Run works at once.\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 \"Dust the table with a little cocoa powder\" and keep \"Preserve\" as it is. The candidate should change the weather and leave the cup, the beans and the 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": "package://nodetool-base/recipe-inputs/coffee.jpg"
+          },
+          "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": "{\"schemaVersion\": 1, \"kind\": \"hero\", \"brief\": {\"productName\": \"House Blend Coffee\", \"campaignMessage\": \"A small-batch house blend, roasted every week and shipped within two days of roasting.\", \"audience\": \"Home coffee drinkers who grind their own beans.\", \"headline\": \"Roasted this week, brewed this morning\", \"cta\": \"Order a bag\", \"referenceRole\": \"none\", \"referenceUse\": \"\", \"referenceIgnore\": \"\"}, \"selectedDirection\": {\"id\": \"B\", \"title\": \"First light at the counter\", \"setting\": \"A pale stone kitchen counter beside a tall window, with a burr grinder and a scattering of fresh beans just out of focus.\", \"composition\": \"The mug sits on the right third at eye level. Beans lead the eye from the lower left. The upper left stays open for the headline.\", \"lighting\": \"Low golden sunrise light from the left, with soft steam backlit above the cup and long, warm shadows.\", \"palette\": \"Cream ceramic, roasted brown, warm amber and a deep green shadow tone.\", \"preservationInstructions\": \"Keep the white espresso cup, its crema, the moka pot of ground coffee and the bean shapes exactly as in the product photo.\"}, \"copy\": {\"productName\": \"House Blend Coffee\", \"headline\": \"Roasted this week, brewed this morning\", \"cta\": \"Order a bag\"}, \"sourceOrder\": [\"product identity\"], \"render\": {\"aspectRatio\": \"16:9\", \"resolution\": \"1K\", \"prompt\": \"Sample contract shipped with the example. Run Render a Directed Campaign Hero to capture your own.\"}}",
+          "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, the moka pot, the beans, the camera position, the composition and the wooden table.",
+          "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.\");\n// Inline bytes would cross the node boundary as one large value, so store\n// them once and pass the small reference on.\nif (typeof value.data === \"string\" && value.data.length > 0) {\n  const bytes = await media.bytes(value);\n  const info = await media.info(value);\n  value = await media.toImage(bytes, { mimeType: info.mimeType || undefined });\n}\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 and simple 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
+}