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

package/dist/examples/nodetool-base/Workflow As A Tool.json

@@ -0,0 +1,257 @@
+{
+  "id": "b098b88d-614a-4f74-8023-57a392fed616",
+  "access": "public",
+  "created_at": "2026-07-17T09:00:00.000Z",
+  "updated_at": "2026-07-17T09:00:00.000Z",
+  "name": "Workflow As A Tool",
+  "tool_name": null,
+  "description": "Composition demo: an orchestrator agent delegates to two specialist sub-agents wired in as callable tools via control edges — Research gathers the facts, Copy Editor polishes the draft, and the manager decides when to call each. Shows how a self-contained unit of work becomes a tool another agent can invoke, all inside one graph.",
+  "tags": [
+    "agents",
+    "composition",
+    "tools",
+    "orchestration"
+  ],
+  "thumbnail": null,
+  "thumbnail_url": null,
+  "graph": {
+    "nodes": [
+      {
+        "id": "comment-intro",
+        "parent_id": null,
+        "type": "nodetool.workflows.base_node.Comment",
+        "data": {
+          "comment": "# 🧩 Workflow As A Tool\n\nShows how one agent can call other agents as tools inside a single graph. Use this shape when a manager should decide whether and in what order specialists run, instead of a fixed pipeline.\n\n**How it works:** \"Topic\" fills \"Objective\", which asks for a 250 to 350 word explainer and tells the orchestrator to research, draft, then edit. \"Orchestrator\" receives it as its prompt. Control edges from its __control__ port into \"Tool: Research\" and \"Tool: Copy Editor\" turn those agents into tools it calls by name with a task string. The research agent returns a bulleted fact brief. The copy editor returns a tightened draft. The orchestrator's text goes to \"Final article\". Each agent uses your default language model, or the one you pick on the node.\n\n**Try this:** Change \"Topic\", or edit the orchestrator's system prompt to call only research_specialist and compare the unedited result."
+        },
+        "ui_properties": {
+          "selected": false,
+          "position": {
+            "x": 0,
+            "y": 0
+          },
+          "zIndex": 0,
+          "width": 560,
+          "height": 430,
+          "selectable": true
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "topic_input",
+        "parent_id": null,
+        "type": "nodetool.input.StringInput",
+        "data": {
+          "name": "topic",
+          "value": "The economics of home solar batteries",
+          "description": "Subject the orchestrator should research and write a short explainer about."
+        },
+        "ui_properties": {
+          "selected": false,
+          "title": "1️⃣ Topic",
+          "position": {
+            "x": 0,
+            "y": 782
+          },
+          "zIndex": 0,
+          "width": 280,
+          "selectable": true
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "brief",
+        "parent_id": null,
+        "type": "nodetool.text.Prompt",
+        "data": {
+          "prompt": "Write a concise, accurate explainer (250-350 words) about the following subject:\n\n{{ topic }}\n\nProcess:\n1. Call the research_specialist tool with a focused question about this subject to gather current facts, figures, and context.\n2. Draft the explainer yourself using those facts. Do not invent numbers — rely on what research returns.\n3. Call the copy_editor tool with your draft to tighten the prose and fix tone.\n4. Return the copy editor's polished version as the final answer, as Markdown."
+        },
+        "ui_properties": {
+          "selected": false,
+          "title": "2️⃣ Objective",
+          "position": {
+            "x": 380,
+            "y": 590
+          },
+          "zIndex": 0,
+          "width": 280,
+          "selectable": true
+        },
+        "dynamic_properties": {
+          "topic": null
+        },
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "orchestrator",
+        "parent_id": null,
+        "type": "nodetool.agents.Agent",
+        "data": {
+          "model": {
+            "type": "language_model",
+            "provider": "",
+            "id": "",
+            "name": "",
+            "path": null,
+            "supported_tasks": []
+          },
+          "tools": [],
+          "max_tokens": 16000,
+          "prompt": "",
+          "system": "You are an editorial manager who coordinates specialists rather than doing everything yourself.\n\nYou have two tools, each a specialist agent:\n- research_specialist — give it a single, focused question. It returns facts, figures, and context. Use it before drafting; never invent data.\n- copy_editor — give it a full draft. It returns a tighter, cleaner version. Use it once, on your finished draft.\n\nProcess for every task:\n1. Read the objective and decide what to research.\n2. Call research_specialist with one clear question (pass only the `prompt` argument).\n3. Draft the piece yourself from the returned facts.\n4. Call copy_editor with your draft (pass only the `prompt` argument).\n5. Return the copy editor's polished text verbatim as your final answer.\n\nKeep the final answer in Markdown. Do not describe your tool calls in the answer — just deliver the finished piece."
+        },
+        "ui_properties": {
+          "selected": false,
+          "title": "3️⃣ Orchestrator",
+          "position": {
+            "x": 760,
+            "y": 762
+          },
+          "zIndex": 0,
+          "width": 300,
+          "selectable": true
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "research_specialist",
+        "parent_id": null,
+        "type": "nodetool.agents.Agent",
+        "data": {
+          "model": {
+            "type": "language_model",
+            "provider": "",
+            "id": "",
+            "name": "",
+            "path": null,
+            "supported_tasks": []
+          },
+          "tools": [],
+          "max_tokens": 8000,
+          "prompt": "",
+          "system": "You are a research specialist. Given a question, return the most relevant facts, figures, comparisons, and context a writer would need — as a compact bulleted brief, not prose. State plainly when something is an estimate or varies by region. Do not write the final article; supply the raw material for it."
+        },
+        "ui_properties": {
+          "selected": false,
+          "title": "🔧 Tool: Research",
+          "position": {
+            "x": 1160,
+            "y": 510
+          },
+          "zIndex": 0,
+          "width": 300,
+          "selectable": true
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "copy_editor",
+        "parent_id": null,
+        "type": "nodetool.agents.Agent",
+        "data": {
+          "model": {
+            "type": "language_model",
+            "provider": "",
+            "id": "",
+            "name": "",
+            "path": null,
+            "supported_tasks": []
+          },
+          "tools": [],
+          "max_tokens": 8000,
+          "prompt": "",
+          "system": "You are a copy editor. Given a draft, return a polished version: tighten wording, fix grammar and flow, remove hedging and filler, and keep the author's meaning and facts unchanged. Do not add new claims or numbers. Return only the edited text in Markdown, nothing else."
+        },
+        "ui_properties": {
+          "selected": false,
+          "title": "🔧 Tool: Copy Editor",
+          "position": {
+            "x": 1160,
+            "y": 773
+          },
+          "zIndex": 0,
+          "width": 300,
+          "selectable": true
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "output-article",
+        "parent_id": null,
+        "type": "nodetool.output.Output",
+        "data": {
+          "name": "article"
+        },
+        "ui_properties": {
+          "selected": false,
+          "title": "4️⃣ Final article",
+          "position": {
+            "x": 1160,
+            "y": 1036
+          },
+          "zIndex": 0,
+          "width": 280,
+          "selectable": true
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      }
+    ],
+    "edges": [
+      {
+        "id": "edge-topic-brief",
+        "source": "topic_input",
+        "sourceHandle": "output",
+        "target": "brief",
+        "targetHandle": "topic",
+        "ui_properties": null
+      },
+      {
+        "id": "edge-brief-orchestrator",
+        "source": "brief",
+        "sourceHandle": "output",
+        "target": "orchestrator",
+        "targetHandle": "prompt",
+        "ui_properties": null
+      },
+      {
+        "id": "edge-control-research",
+        "source": "orchestrator",
+        "sourceHandle": "__control__",
+        "target": "research_specialist",
+        "targetHandle": "__control__",
+        "edge_type": "control",
+        "ui_properties": null
+      },
+      {
+        "id": "edge-control-editor",
+        "source": "orchestrator",
+        "sourceHandle": "__control__",
+        "target": "copy_editor",
+        "targetHandle": "__control__",
+        "edge_type": "control",
+        "ui_properties": null
+      },
+      {
+        "id": "edge-orchestrator-output",
+        "source": "orchestrator",
+        "sourceHandle": "text",
+        "target": "output-article",
+        "targetHandle": "value",
+        "ui_properties": null
+      }
+    ]
+  },
+  "input_schema": null,
+  "output_schema": null,
+  "settings": null,
+  "package_name": "nodetool-base",
+  "path": null,
+  "run_mode": null,
+  "required_providers": null,
+  "required_models": null
+}

package/dist/examples/nodetool-base/Write a Listing from the Product Photo.json

@@ -0,0 +1,139 @@
+{
+  "id": "",
+  "access": "private",
+  "created_at": "2026-07-30T16:00:00.000Z",
+  "updated_at": "2026-07-30T16:00:00.000Z",
+  "name": "Write a Listing from the Product Photo",
+  "tool_name": null,
+  "description": "Hand the model the photograph rather than a description of it. Marketplace copy written from the actual image catches details a spec sheet omits — finish, proportion, what it sits next to.",
+  "tags": [
+    "text",
+    "image",
+    "example"
+  ],
+  "thumbnail": null,
+  "thumbnail_url": null,
+  "graph": {
+    "nodes": [
+      {
+        "id": "intro-comment",
+        "type": "nodetool.workflows.base_node.Comment",
+        "data": {
+          "comment": "# Write a Listing from the Product Photo\n\nWrites a marketplace listing from the product photo itself. Working from the image catches details a spec sheet leaves out, such as finish and proportion.\n\n**How it works:** Drop the photo into \"1 Photo\". \"2 Copywriter\" looks at it and writes a title under 70 characters and a description of about 80 words, without superlatives or invented specs. \"3 Listing\" returns the text.\n\n**Try this:** Pick a vision-capable model on \"2 Copywriter\" and change its prompt to ask for five bullet points instead."
+        },
+        "ui_properties": {
+          "position": {
+            "x": 0,
+            "y": 0
+          },
+          "zIndex": 0,
+          "width": 560,
+          "selectable": true,
+          "height": 266
+        },
+        "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": 370
+          },
+          "zIndex": 0,
+          "width": 300,
+          "selectable": true,
+          "title": "1  Photo"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "ag",
+        "type": "nodetool.agents.Agent",
+        "data": {
+          "model": {
+            "type": "language_model",
+            "provider": "",
+            "id": "",
+            "name": "",
+            "path": null,
+            "supported_tasks": []
+          },
+          "system": "You write marketplace listings. Lead with the concrete: material, size cues, finish. No superlatives, no invented specifications.",
+          "prompt": "Write a product title under 70 characters and a description of about 80 words for the product in this image.",
+          "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  Copywriter"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "out",
+        "type": "nodetool.output.Output",
+        "data": {
+          "name": "listing"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 800,
+            "y": 378
+          },
+          "zIndex": 0,
+          "width": 300,
+          "selectable": true,
+          "title": "3  Listing"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      }
+    ],
+    "edges": [
+      {
+        "id": "e1",
+        "source": "in",
+        "sourceHandle": "output",
+        "target": "ag",
+        "targetHandle": "image"
+      },
+      {
+        "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
+}

package/dist/examples/nodetool-base/Write the Prompt, Then Make the Image.json

@@ -0,0 +1,200 @@
+{
+  "id": "",
+  "access": "private",
+  "created_at": "2026-07-30T16:00:00.000Z",
+  "updated_at": "2026-07-30T16:00:00.000Z",
+  "name": "Write the Prompt, Then Make the Image",
+  "tool_name": null,
+  "description": "The model writes its own image prompt from a plain description. Useful when the person with the idea does not want to learn prompt craft — and the intermediate prompt stays visible, so it can be corrected rather than guessed at.",
+  "tags": [
+    "image",
+    "text",
+    "example"
+  ],
+  "thumbnail": null,
+  "thumbnail_url": null,
+  "graph": {
+    "nodes": [
+      {
+        "id": "intro-comment",
+        "type": "nodetool.workflows.base_node.Comment",
+        "data": {
+          "comment": "# Write the Prompt, Then Make the Image\n\nTurns a plain-language idea into an image prompt, then generates the image. The written prompt stays visible, so you can correct it instead of guessing.\n\n**How it works:** Type the idea into \"1 Idea\". \"2 Write the prompt\" writes one sentence naming subject, lighting, lens and palette. It goes to \"3 Generate\" for a square image and to \"4 Prompt used\", and the picture appears in \"5 Image\".\n\n**Try this:** Pick models on \"2 Write the prompt\" and \"3 Generate\", then change aspect_ratio on \"3 Generate\" to 16:9."
+        },
+        "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": "idea",
+          "value": "",
+          "description": "The idea, in plain words"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 0,
+            "y": 463
+          },
+          "zIndex": 0,
+          "width": 300,
+          "selectable": true,
+          "title": "1  Idea"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "ag",
+        "type": "nodetool.agents.Agent",
+        "data": {
+          "model": {
+            "type": "language_model",
+            "provider": "",
+            "id": "",
+            "name": "",
+            "path": null,
+            "supported_tasks": []
+          },
+          "system": "You write prompts for an image generation model. One sentence. Name the subject, the lighting, the lens and the palette. No style-artist names, no quality boilerplate.",
+          "prompt": "",
+          "tools": [],
+          "image": [],
+          "audio": [],
+          "history": [],
+          "thread_id": "",
+          "max_tokens": 16384,
+          "max_turns": 100
+        },
+        "ui_properties": {
+          "position": {
+            "x": 400,
+            "y": 444
+          },
+          "zIndex": 0,
+          "width": 300,
+          "selectable": true,
+          "title": "2  Write the prompt"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "gen",
+        "type": "nodetool.image.TextToImage",
+        "data": {
+          "model": {
+            "type": "image_model",
+            "provider": "",
+            "id": "",
+            "name": "",
+            "path": null,
+            "supported_tasks": []
+          },
+          "prompt": "",
+          "negative_prompt": "",
+          "entities": [],
+          "aspect_ratio": "1:1",
+          "resolution": "1K"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 800,
+            "y": 346
+          },
+          "zIndex": 0,
+          "width": 300,
+          "selectable": true,
+          "title": "3  Generate"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "op",
+        "type": "nodetool.output.Output",
+        "data": {
+          "name": "prompt_used"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 800,
+            "y": 572
+          },
+          "zIndex": 0,
+          "width": 300,
+          "selectable": true,
+          "title": "4  Prompt used"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      },
+      {
+        "id": "out",
+        "type": "nodetool.output.Output",
+        "data": {
+          "name": "image"
+        },
+        "ui_properties": {
+          "position": {
+            "x": 1200,
+            "y": 378
+          },
+          "zIndex": 0,
+          "width": 300,
+          "selectable": true,
+          "title": "5  Image"
+        },
+        "dynamic_properties": {},
+        "dynamic_outputs": {}
+      }
+    ],
+    "edges": [
+      {
+        "id": "e1",
+        "source": "in",
+        "sourceHandle": "output",
+        "target": "ag",
+        "targetHandle": "prompt"
+      },
+      {
+        "id": "e2",
+        "source": "ag",
+        "sourceHandle": "text",
+        "target": "gen",
+        "targetHandle": "prompt"
+      },
+      {
+        "id": "e3",
+        "source": "ag",
+        "sourceHandle": "text",
+        "target": "op",
+        "targetHandle": "value"
+      },
+      {
+        "id": "e4",
+        "source": "gen",
+        "sourceHandle": "output",
+        "target": "out",
+        "targetHandle": "value"
+      }
+    ]
+  },
+  "input_schema": null,
+  "output_schema": null,
+  "settings": null,
+  "package_name": "nodetool-base",
+  "path": null,
+  "run_mode": null
+}