chore: add docs url for integration nodes

api/services/integrations/paygent/node.py

@@ -25,6 +25,7 @@ from api.services.workflow.node_specs.model_spec import (
         "Paygent is a post-call usage-tracking and billing integration. "
         "It does not participate in the conversation graph and should not be connected to other nodes."
     ),
+    docs_url="https://docs.dograh.com/integrations/paygent",
     category=NodeCategory.integration,
     icon="CreditCard",
     examples=[

api/services/integrations/tuner/node.py

@@ -36,6 +36,7 @@ _COST_RATE_RENDERER_OPTIONS = PropertyRendererOptions(
         "Tuner is a post-call observability export. It does not participate in the "
         "conversation graph and should not be connected to other nodes."
     ),
+    docs_url="https://docs.dograh.com/integrations/tuner",
     category=NodeCategory.integration,
     icon="Activity",
     examples=[

api/services/pipecat/realtime/ultravox_realtime.py

@@ -241,9 +241,7 @@ class DograhUltravoxRealtimeLLMService(UltravoxRealtimeLLMService):
             "call(s) after bot turn ended"
         )
         for tool_name, invocation_id, parameters in invocations:
-            await super()._handle_tool_invocation(
-                tool_name, invocation_id, parameters
-            )
+            await super()._handle_tool_invocation(tool_name, invocation_id, parameters)
 
     async def _send_tool_result(self, tool_call_id: str, result: str):
         is_node_transition = tool_call_id in self._pending_node_transition_tool_call_ids

api/services/workflow/node_specs/_base.py

@@ -300,6 +300,10 @@ class NodeSpec(BaseModel):
         default=None,
         description="LLM-only guidance; omitted from the UI.",
     )
+    docs_url: Optional[str] = Field(
+        default=None,
+        description="Documentation URL shown in the node editor.",
+    )
     category: NodeCategory
     icon: str  # lucide-react icon name (e.g., "Play")
     version: str = "1.0.0"
@@ -312,8 +316,8 @@ class NodeSpec(BaseModel):
     def to_mcp_dict(self) -> dict[str, Any]:
         """Lean projection of this spec for the `get_node_type` MCP tool.
 
-        Drops node-level UI metadata (`display_name`, `category`, `icon`,
-        `version`) and the per-property rendering concerns trimmed by
+        Drops node-level UI metadata (`display_name`, `docs_url`, `category`,
+        `icon`, `version`) and the per-property rendering concerns trimmed by
         `PropertySpec.to_mcp_dict`, leaving just the authoring-relevant
         schema the LLM consumes when composing a workflow. The full spec is
         still served verbatim to the frontend renderer (REST `node-types`

api/services/workflow/node_specs/model_spec.py

@@ -33,6 +33,7 @@ class NodeSpecMetadata:
     category: NodeCategory
     icon: str
     llm_hint: str | None = None
+    docs_url: str | None = None
     version: str = "1.0.0"
     examples: tuple[NodeExample, ...] = ()
     graph_constraints: GraphConstraints | None = None
@@ -91,6 +92,7 @@ def node_spec(
     category: NodeCategory,
     icon: str,
     llm_hint: str | None = None,
+    docs_url: str | None = None,
     version: str = "1.0.0",
     examples: list[NodeExample] | tuple[NodeExample, ...] = (),
     graph_constraints: GraphConstraints | None = None,
@@ -104,6 +106,7 @@ def node_spec(
         category=category,
         icon=icon,
         llm_hint=llm_hint,
+        docs_url=docs_url,
         version=version,
         examples=tuple(examples),
         graph_constraints=graph_constraints,
@@ -137,6 +140,7 @@ def build_spec(model_cls: type[BaseModel]) -> NodeSpec:
         display_name=metadata.display_name,
         description=metadata.description,
         llm_hint=metadata.llm_hint,
+        docs_url=metadata.docs_url,
         category=metadata.category,
         icon=metadata.icon,
         version=metadata.version,

api/tests/test_node_specs.py

@@ -336,6 +336,18 @@ def test_tuner_cost_rate_fields_use_typed_renderer_options():
     )
 
 
+@pytest.mark.parametrize(
+    ("spec_name", "expected_docs_url"),
+    [
+        ("paygent", "https://docs.dograh.com/integrations/paygent"),
+        ("tuner", "https://docs.dograh.com/integrations/tuner"),
+    ],
+)
+def test_integration_node_docs_url(spec_name: str, expected_docs_url: str):
+    spec = next(spec for spec in all_specs() if spec.name == spec_name)
+    assert spec.docs_url == expected_docs_url
+
+
 def test_property_renderer_options_reject_unknown_hints():
     with pytest.raises(ValidationError):
         PropertyRendererOptions.model_validate({"layout": {"width": "half"}})
@@ -352,6 +364,7 @@ def test_property_renderer_options_reject_unknown_hints():
 _UI_ONLY_KEYS = frozenset(
     {
         "display_name",
+        "docs_url",
         "icon",
         "category",
         "version",