feat: agent slash menu backend (#37268)

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>

api/core/workflow/graph_topology.py

@@ -0,0 +1,86 @@
+"""Draft-workflow graph topology helper, shared by Agent v2 publish validation
+and the agent-composer candidates endpoint (ENG-615).
+
+Extracted from ``core/workflow/nodes/agent_v2/validators.py`` so both call sites
+parse the same ``Workflow.graph`` JSON shape (``nodes`` with string ids,
+``edges`` with ``source``/``target``).
+"""
+
+from __future__ import annotations
+
+from collections import defaultdict, deque
+from collections.abc import Mapping, Sequence
+from typing import Any
+
+
+class WorkflowGraphTopology:
+    def __init__(self, *, node_ids: set[str], incoming: Mapping[str, Sequence[str]]) -> None:
+        self._node_ids = node_ids
+        self._incoming = incoming
+
+    @classmethod
+    def from_graph(cls, graph: Mapping[str, Any]) -> WorkflowGraphTopology:
+        node_ids = cls._node_ids_from_graph(graph)
+        incoming: dict[str, list[str]] = defaultdict(list)
+        edges = graph.get("edges")
+        if isinstance(edges, list):
+            for edge in edges:
+                if not isinstance(edge, Mapping):
+                    continue
+                source = edge.get("source")
+                target = edge.get("target")
+                if isinstance(source, str) and isinstance(target, str):
+                    incoming[target].append(source)
+        return cls(node_ids=node_ids, incoming=incoming)
+
+    def has_node(self, node_id: str) -> bool:
+        return node_id in self._node_ids
+
+    def is_upstream(self, *, source_node_id: str, target_node_id: str) -> bool:
+        if source_node_id == target_node_id:
+            return False
+        visited: set[str] = set()
+        queue: deque[str] = deque(self._incoming.get(target_node_id, ()))
+        while queue:
+            candidate = queue.popleft()
+            if candidate == source_node_id:
+                return True
+            if candidate in visited:
+                continue
+            visited.add(candidate)
+            queue.extend(self._incoming.get(candidate, ()))
+        return False
+
+    def upstream_node_ids(self, target_node_id: str) -> set[str]:
+        """All graph nodes reachable upstream of ``target_node_id`` (excluding it).
+
+        Edges may reference ids missing from ``nodes`` (half-deleted graphs);
+        only real nodes are returned.
+        """
+        visited: set[str] = set()
+        queue: deque[str] = deque(self._incoming.get(target_node_id, ()))
+        while queue:
+            candidate = queue.popleft()
+            if candidate in visited:
+                continue
+            visited.add(candidate)
+            queue.extend(self._incoming.get(candidate, ()))
+        visited.discard(target_node_id)
+        return visited & self._node_ids
+
+    @staticmethod
+    def _node_ids_from_graph(graph: Mapping[str, Any]) -> set[str]:
+        node_ids: set[str] = set()
+        nodes = graph.get("nodes")
+        if not isinstance(nodes, list):
+            return node_ids
+        for node in nodes:
+            if not isinstance(node, Mapping):
+                continue
+            node_id = node.get("id")
+            if isinstance(node_id, str):
+                node_ids.add(node_id)
+        return node_ids
+
+
+__all__ = ["WorkflowGraphTopology"]

api/core/workflow/nodes/agent_v2/runtime_request_builder.py

@@ -45,6 +45,11 @@ from models.agent_config_entities import (
     effective_declared_outputs as _effective_declared_outputs,
 )
 from models.provider_ids import ModelProviderID
+from services.agent.prompt_mentions import (
+    build_node_job_mention_resolver,
+    build_soul_mention_resolver,
+    expand_prompt_mentions,
+)
 
 from .output_failure_orchestrator import retry_idempotency_key
 from .plugin_tools_builder import WorkflowAgentPluginToolsBuilder, WorkflowAgentPluginToolsBuildError
@@ -129,7 +134,16 @@ class WorkflowAgentRuntimeRequestBuilder:
 
         metadata = self._build_metadata(context, agent_soul, node_job)
         workflow_context_prompt = self._build_workflow_context_prompt(context, node_job)
-        workflow_job_prompt = node_job.workflow_prompt.strip() or "Run this workflow Agent Node for the current run."
+        # ENG-616: expand slash-menu mention tokens into model-readable names.
+        # node_output mentions expand to their reference name only — the value
+        # stays in the Workflow context block (user_prompt) below.
+        workflow_job_prompt = (
+            expand_prompt_mentions(node_job.workflow_prompt, build_node_job_mention_resolver(node_job)).strip()
+            or "Run this workflow Agent Node for the current run."
+        )
+        soul_prompt = expand_prompt_mentions(
+            agent_soul.prompt.system_prompt, build_soul_mention_resolver(agent_soul)
+        ).strip()
         user_prompt = workflow_context_prompt.strip() or "Use the current workflow context."
         credentials = self._credentials_provider.fetch(agent_soul.model.model_provider, agent_soul.model.model)
         try:
@@ -187,7 +201,7 @@ class WorkflowAgentRuntimeRequestBuilder:
                     agent_mode=self._agent_backend_agent_mode(context.dify_context.invoke_from),
                     invoke_from=cast(DifyExecutionContextInvokeFrom, context.dify_context.invoke_from.value),
                 ),
-                agent_soul_prompt=agent_soul.prompt.system_prompt or None,
+                agent_soul_prompt=soul_prompt or None,
                 workflow_node_job_prompt=workflow_job_prompt,
                 user_prompt=user_prompt,
                 output=self._build_output_config(node_job.declared_outputs),

api/core/workflow/nodes/agent_v2/validators.py

@@ -1,12 +1,12 @@
 from __future__ import annotations
 
-from collections import defaultdict, deque
-from collections.abc import Iterator, Mapping, Sequence
+from collections.abc import Iterator, Mapping
 from typing import Any
 
 from sqlalchemy import select
 from sqlalchemy.orm import Session
 
+from core.workflow.graph_topology import WorkflowGraphTopology
 from graphon.enums import BuiltinNodeTypes
 from models.agent import Agent, AgentConfigSnapshot, AgentStatus, WorkflowAgentNodeBinding
 from models.agent_config_entities import (
@@ -523,54 +523,6 @@ class WorkflowAgentNodeValidator:
         )
 
 
-class _WorkflowGraphTopology:
-    def __init__(self, *, node_ids: set[str], incoming: Mapping[str, Sequence[str]]) -> None:
-        self._node_ids = node_ids
-        self._incoming = incoming
-
-    @classmethod
-    def from_graph(cls, graph: Mapping[str, Any]) -> _WorkflowGraphTopology:
-        node_ids = cls._node_ids_from_graph(graph)
-        incoming: dict[str, list[str]] = defaultdict(list)
-        edges = graph.get("edges")
-        if isinstance(edges, list):
-            for edge in edges:
-                if not isinstance(edge, Mapping):
-                    continue
-                source = edge.get("source")
-                target = edge.get("target")
-                if isinstance(source, str) and isinstance(target, str):
-                    incoming[target].append(source)
-        return cls(node_ids=node_ids, incoming=incoming)
-
-    def has_node(self, node_id: str) -> bool:
-        return node_id in self._node_ids
-
-    def is_upstream(self, *, source_node_id: str, target_node_id: str) -> bool:
-        if source_node_id == target_node_id:
-            return False
-        visited: set[str] = set()
-        queue: deque[str] = deque(self._incoming.get(target_node_id, ()))
-        while queue:
-            candidate = queue.popleft()
-            if candidate == source_node_id:
-                return True
-            if candidate in visited:
-                continue
-            visited.add(candidate)
-            queue.extend(self._incoming.get(candidate, ()))
-        return False
-
-    @staticmethod
-    def _node_ids_from_graph(graph: Mapping[str, Any]) -> set[str]:
-        node_ids: set[str] = set()
-        nodes = graph.get("nodes")
-        if not isinstance(nodes, list):
-            return node_ids
-        for node in nodes:
-            if not isinstance(node, Mapping):
-                continue
-            node_id = node.get("id")
-            if isinstance(node_id, str):
-                node_ids.add(node_id)
-        return node_ids
+# Extracted to core/workflow/graph_topology.py (shared with the agent-composer
+# candidates endpoint, ENG-615); kept as a private alias for existing call sites.
+_WorkflowGraphTopology = WorkflowGraphTopology