Skip to content

armgit / dify

Public Imported from GitHub
0

Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype to production without rebuilding the stack.

30.1 KB
Raw Blame
from __future__ import annotations

import copy
from collections.abc import Mapping
from typing import Any, cast

from pydantic import ValidationError
from sqlalchemy import select
from sqlalchemy.orm import Session

from core.agent.publish_visibility import workflow_callable_active_snapshot_filter
from core.workflow.nodes.agent_v2.validators import WorkflowAgentNodeValidationError, WorkflowAgentNodeValidator
from models.agent import (
    Agent,
    AgentConfigSnapshot,
    AgentScope,
    AgentStatus,
    WorkflowAgentBindingType,
    WorkflowAgentNodeBinding,
)
from models.agent_config_entities import (
    AgentSoulConfig,
    WorkflowNodeJobConfig,
    WorkflowOutputRoutes,
    WorkflowPreviousNodeOutputRef,
)
from models.workflow import Workflow
from services.agent.composer_validator import ComposerConfigValidator
from services.agent.prompt_mentions import (
    extract_workflow_node_output_selectors,
    workflow_previous_node_output_refs_from_selectors,
)
from services.entities.agent_entities import (
    ComposerSavePayload,
    ComposerSaveStrategy,
    ComposerSoulLockPayload,
    ComposerVariant,
)


class _InlineAgentUnavailableError(ValueError):
    pass


class _InlineAgentOwnershipError(ValueError):
    pass


class _InlineAgentSnapshotError(ValueError):
    pass


class WorkflowAgentPublishService:
    """Validate and freeze Workflow Agent v2 bindings during workflow publish."""

    _DRAFT_WORKFLOW_VERSION = Workflow.VERSION_DRAFT
    _AGENT_BINDING_KEY = "agent_binding"
    _AGENT_TASK_KEY = "agent_task"
    _AGENT_DECLARED_OUTPUTS_KEY = "agent_declared_outputs"
    _AGENT_OUTPUT_ROUTES_KEY = "agent_output_routes"

    @classmethod
    def project_draft_bindings_to_graph(
        cls, *, session: Session, draft_workflow: Workflow, binding_version: str = Workflow.VERSION_DRAFT
    ) -> dict[str, Any]:
        """Return the workflow graph with persisted Agent binding fields projected into node data.

        Reads the binding rows of ``binding_version``. The default is the draft;
        a DSL export passes the exported workflow's own version.

        Workflow draft graph is the front-end's editing source of truth, while
        runtime/publish reads WorkflowAgentNodeBinding. This
        response-only projection keeps reads aligned without writing binding
        details back into the stored graph JSON.
        """
        graph = cast(dict[str, Any], copy.deepcopy(draft_workflow.graph_dict))
        agent_nodes = dict(WorkflowAgentNodeValidator.iter_agent_v2_nodes(graph))
        if not agent_nodes:
            return graph

        bindings = session.scalars(
            select(WorkflowAgentNodeBinding).where(
                WorkflowAgentNodeBinding.tenant_id == draft_workflow.tenant_id,
                WorkflowAgentNodeBinding.app_id == draft_workflow.app_id,
                WorkflowAgentNodeBinding.workflow_id == draft_workflow.id,
                WorkflowAgentNodeBinding.workflow_version == binding_version,
                WorkflowAgentNodeBinding.node_id.in_(list(agent_nodes.keys())),
            )
        ).all()
        for binding in bindings:
            node_data = agent_nodes.get(binding.node_id)
            if not isinstance(node_data, dict):
                continue
            graph_binding = node_data.get(cls._AGENT_BINDING_KEY)
            is_pending_inline_graph_binding = (
                isinstance(graph_binding, Mapping)
                and graph_binding.get("binding_type") == WorkflowAgentBindingType.INLINE_AGENT.value
                and (not graph_binding.get("agent_id") or not graph_binding.get("current_snapshot_id"))
            )
            if not is_pending_inline_graph_binding or binding.binding_type == WorkflowAgentBindingType.INLINE_AGENT:
                node_data[cls._AGENT_BINDING_KEY] = {
                    "binding_type": binding.binding_type.value,
                    "agent_id": binding.agent_id,
                    "current_snapshot_id": binding.current_snapshot_id,
                }
            node_job = WorkflowNodeJobConfig.model_validate(binding.node_job_config_dict)
            if node_job.workflow_prompt is not None:
                node_data[cls._AGENT_TASK_KEY] = node_job.workflow_prompt
            node_data[cls._AGENT_OUTPUT_ROUTES_KEY] = node_job.output_routes.model_dump(mode="json")
            node_data[cls._AGENT_DECLARED_OUTPUTS_KEY] = [
                output.model_dump(mode="json") for output in node_job.declared_outputs
            ]
        return graph

    @classmethod
    def validate_agent_nodes_for_publish(cls, *, session: Session, draft_workflow: Workflow) -> None:
        WorkflowAgentNodeValidator.validate_published_workflow(session=session, workflow=draft_workflow)
        cls._validate_composer_configs_for_publish(session=session, draft_workflow=draft_workflow)

    @classmethod
    def validate_agent_nodes_for_draft_sync(cls, *, session: Session, draft_workflow: Workflow) -> None:
        WorkflowAgentNodeValidator.validate_draft_workflow(session=session, workflow=draft_workflow)

    @classmethod
    def _validate_composer_configs_for_publish(cls, *, session: Session, draft_workflow: Workflow) -> None:
        node_ids = {
            node_id for node_id, _node_data in WorkflowAgentNodeValidator.iter_agent_v2_nodes(draft_workflow.graph_dict)
        }
        if not node_ids:
            return

        bindings = session.scalars(
            select(WorkflowAgentNodeBinding).where(
                WorkflowAgentNodeBinding.tenant_id == draft_workflow.tenant_id,
                WorkflowAgentNodeBinding.app_id == draft_workflow.app_id,
                WorkflowAgentNodeBinding.workflow_id == draft_workflow.id,
                WorkflowAgentNodeBinding.workflow_version == draft_workflow.version,
                WorkflowAgentNodeBinding.node_id.in_(node_ids),
            )
        ).all()
        for binding in bindings:
            cls._validate_binding_composer_config_for_publish(session=session, binding=binding)

    @classmethod
    def _validate_binding_composer_config_for_publish(
        cls,
        *,
        session: Session,
        binding: WorkflowAgentNodeBinding,
    ) -> None:
        if not binding.agent_id:
            return

        agent = session.scalar(
            select(Agent)
            .where(
                Agent.tenant_id == binding.tenant_id,
                Agent.id == binding.agent_id,
            )
            .limit(1)
        )
        if agent is None:
            return

        snapshot_id = (
            agent.active_config_snapshot_id
            if binding.binding_type == WorkflowAgentBindingType.ROSTER_AGENT
            else binding.current_snapshot_id
        )
        if snapshot_id is None:
            return

        snapshot = session.scalar(
            select(AgentConfigSnapshot)
            .where(
                AgentConfigSnapshot.tenant_id == binding.tenant_id,
                AgentConfigSnapshot.agent_id == agent.id,
                AgentConfigSnapshot.id == snapshot_id,
            )
            .limit(1)
        )
        if snapshot is None:
            return

        agent_soul = AgentSoulConfig.model_validate(snapshot.config_snapshot_dict)
        node_job = WorkflowNodeJobConfig.model_validate(binding.node_job_config_dict)
        payload = ComposerSavePayload.model_construct(
            variant=ComposerVariant.WORKFLOW,
            save_strategy=ComposerSaveStrategy.NODE_JOB_ONLY,
            soul_lock=ComposerSoulLockPayload(locked=False),
            agent_soul=agent_soul,
            node_job=node_job,
        )
        ComposerConfigValidator.validate_publish_payload(payload)
        cls._require_config_asset_refs_resolved_for_publish(
            session=session,
            binding=binding,
            snapshot_id=snapshot_id,
            agent_soul=agent_soul,
        )

    @classmethod
    def _require_config_asset_refs_resolved_for_publish(
        cls,
        *,
        session: Session,
        binding: WorkflowAgentNodeBinding,
        snapshot_id: str,
        agent_soul: AgentSoulConfig,
    ) -> None:
        from services.agent.prompt_mentions import MentionKind, parse_prompt_mentions
        from services.skill_management_service import SkillManagementService

        mentions = parse_prompt_mentions(agent_soul.prompt.system_prompt)
        configured_skill_names = {item.name for item in agent_soul.config_skills if not item.is_missing}
        has_unresolved_skill_ref = any(
            mention.kind == MentionKind.SKILL and mention.ref_id not in configured_skill_names for mention in mentions
        )
        if has_unresolved_skill_ref and binding.agent_id is not None:
            configured_skill_names.update(
                str(item["name"])
                for item in SkillManagementService(session=session).list_runtime_agent_skills(
                    tenant_id=binding.tenant_id,
                    agent_id=binding.agent_id,
                    config_snapshot_id=snapshot_id,
                )
            )
        configured_file_names = {item.name for item in agent_soul.config_files if not item.is_missing}
        missing_refs: list[str] = []
        for mention in mentions:
            if mention.kind not in {MentionKind.SKILL, MentionKind.FILE}:
                continue
            ref_name = mention.ref_id
            if mention.kind == MentionKind.SKILL and ref_name not in configured_skill_names:
                missing_refs.append(f"skill_ref_dangling: skill '{mention.label or ref_name}' is not configured.")
            if mention.kind == MentionKind.FILE and ref_name not in configured_file_names:
                missing_refs.append(f"file_ref_dangling: file '{mention.label or ref_name}' is not configured.")
        if missing_refs:
            raise WorkflowAgentNodeValidationError(
                f"Workflow Agent node {binding.node_id} has invalid Agent Soul config refs: {'; '.join(missing_refs)}"
            )

    @classmethod
    def sync_agent_bindings_for_draft(
        cls,
        *,
        session: Session,
        draft_workflow: Workflow,
        account_id: str,
    ) -> set[str]:
        agent_nodes = dict(WorkflowAgentNodeValidator.iter_agent_v2_nodes(draft_workflow.graph_dict))
        existing_bindings = list(
            session.scalars(
                select(WorkflowAgentNodeBinding).where(
                    WorkflowAgentNodeBinding.tenant_id == draft_workflow.tenant_id,
                    WorkflowAgentNodeBinding.app_id == draft_workflow.app_id,
                    WorkflowAgentNodeBinding.workflow_id == draft_workflow.id,
                    WorkflowAgentNodeBinding.workflow_version == cls._DRAFT_WORKFLOW_VERSION,
                )
            ).all()
        )
        existing_by_node_id = {binding.node_id: binding for binding in existing_bindings}
        retirement_candidates: set[str] = set()

        for binding in existing_bindings:
            if binding.node_id not in agent_nodes:
                if binding.binding_type == WorkflowAgentBindingType.INLINE_AGENT and binding.agent_id:
                    retirement_candidates.add(binding.agent_id)
                session.delete(binding)

        for node_id, node_data in agent_nodes.items():
            binding_payload = node_data.get(cls._AGENT_BINDING_KEY)
            if binding_payload is None:
                continue
            if not isinstance(binding_payload, Mapping):
                raise ValueError(f"Workflow Agent node {node_id} has invalid agent_binding.")
            if binding_payload.get("binding_type") == WorkflowAgentBindingType.INLINE_AGENT.value and (
                not binding_payload.get("agent_id") or not binding_payload.get("current_snapshot_id")
            ):
                continue
            existing_binding = existing_by_node_id.get(node_id)
            replaced_inline_agent_id = (
                existing_binding.agent_id
                if existing_binding is not None
                and existing_binding.binding_type == WorkflowAgentBindingType.INLINE_AGENT
                and existing_binding.agent_id
                else None
            )
            cls._sync_agent_binding_for_node(
                session=session,
                draft_workflow=draft_workflow,
                node_id=node_id,
                node_data=node_data,
                node_binding=binding_payload,
                existing_binding=existing_binding,
                account_id=account_id,
            )
            if (
                replaced_inline_agent_id
                and existing_binding is not None
                and (
                    existing_binding.binding_type != WorkflowAgentBindingType.INLINE_AGENT
                    or existing_binding.agent_id != replaced_inline_agent_id
                )
            ):
                retirement_candidates.add(replaced_inline_agent_id)
        session.flush()
        return retirement_candidates

    @classmethod
    def sync_roster_agent_bindings_for_draft(
        cls,
        *,
        session: Session,
        draft_workflow: Workflow,
        account_id: str,
    ) -> set[str]:
        return cls.sync_agent_bindings_for_draft(
            session=session,
            draft_workflow=draft_workflow,
            account_id=account_id,
        )

    @classmethod
    def _sync_agent_binding_for_node(
        cls,
        *,
        session: Session,
        draft_workflow: Workflow,
        node_id: str,
        node_data: Mapping[str, Any],
        node_binding: Mapping[str, Any],
        existing_binding: WorkflowAgentNodeBinding | None,
        account_id: str,
    ) -> None:
        binding_type = node_binding.get("binding_type")
        agent_id = node_binding.get("agent_id")
        if not isinstance(agent_id, str) or not agent_id:
            raise ValueError(f"Workflow Agent node {node_id} agent binding requires agent_id.")

        node_job_config = cls._node_job_config_from_node_data(
            existing_binding=existing_binding,
            node_data=node_data,
        )

        if binding_type == WorkflowAgentBindingType.ROSTER_AGENT.value:
            agent, current_snapshot_id = cls._resolve_roster_agent_graph_binding(
                session=session,
                draft_workflow=draft_workflow,
                node_id=node_id,
                agent_id=agent_id,
            )
            resolved_binding_type = WorkflowAgentBindingType.ROSTER_AGENT
        elif binding_type == WorkflowAgentBindingType.INLINE_AGENT.value:
            raw_current_snapshot_id = node_binding.get("current_snapshot_id")
            if not isinstance(raw_current_snapshot_id, str) or not raw_current_snapshot_id:
                raise ValueError(f"Workflow Agent node {node_id} inline_agent binding requires current_snapshot_id.")
            current_snapshot_id = raw_current_snapshot_id
            try:
                agent = cls._resolve_inline_agent_graph_binding(
                    session=session,
                    draft_workflow=draft_workflow,
                    node_id=node_id,
                    agent_id=agent_id,
                    current_snapshot_id=current_snapshot_id,
                )
            except (_InlineAgentUnavailableError, _InlineAgentOwnershipError):
                existing_agent = cls._resolve_existing_inline_binding_agent(
                    session=session,
                    draft_workflow=draft_workflow,
                    node_id=node_id,
                    existing_binding=existing_binding,
                )
                if existing_agent is not None and existing_binding is not None:
                    agent = existing_agent
                    current_snapshot_id = existing_binding.current_snapshot_id or current_snapshot_id
                else:
                    agent, current_snapshot_id = cls._clone_inline_graph_binding_for_node(
                        session=session,
                        draft_workflow=draft_workflow,
                        node_id=node_id,
                        source_agent_id=agent_id,
                        source_snapshot_id=current_snapshot_id,
                        account_id=account_id,
                    )
            resolved_binding_type = WorkflowAgentBindingType.INLINE_AGENT
        else:
            raise ValueError(f"Workflow Agent node {node_id} has unsupported agent_binding type.")

        binding = existing_binding
        if binding is None:
            binding = WorkflowAgentNodeBinding(
                tenant_id=draft_workflow.tenant_id,
                app_id=draft_workflow.app_id,
                workflow_id=draft_workflow.id,
                workflow_version=cls._DRAFT_WORKFLOW_VERSION,
                node_id=node_id,
                binding_type=resolved_binding_type,
                node_job_config=node_job_config,
                created_by=account_id,
            )
            session.add(binding)
        else:
            binding.node_job_config = node_job_config

        binding.binding_type = resolved_binding_type
        binding.agent_id = agent.id
        binding.current_snapshot_id = current_snapshot_id
        binding.updated_by = account_id

    @classmethod
    def _resolve_existing_inline_binding_agent(
        cls,
        *,
        session: Session,
        draft_workflow: Workflow,
        node_id: str,
        existing_binding: WorkflowAgentNodeBinding | None,
    ) -> Agent | None:
        if (
            existing_binding is None
            or existing_binding.binding_type != WorkflowAgentBindingType.INLINE_AGENT
            or not existing_binding.agent_id
            or not existing_binding.current_snapshot_id
        ):
            return None
        try:
            return cls._resolve_inline_agent_graph_binding(
                session=session,
                draft_workflow=draft_workflow,
                node_id=node_id,
                agent_id=existing_binding.agent_id,
                current_snapshot_id=existing_binding.current_snapshot_id,
            )
        except ValueError:
            return None

    @classmethod
    def _clone_inline_graph_binding_for_node(
        cls,
        *,
        session: Session,
        draft_workflow: Workflow,
        node_id: str,
        source_agent_id: str,
        source_snapshot_id: str,
        account_id: str,
    ) -> tuple[Agent, str]:
        source_agent = session.scalar(
            select(Agent)
            .where(
                Agent.tenant_id == draft_workflow.tenant_id,
                Agent.id == source_agent_id,
                Agent.scope == AgentScope.WORKFLOW_ONLY,
                Agent.status == AgentStatus.ACTIVE,
            )
            .limit(1)
        )
        if source_agent is None:
            raise ValueError(f"Workflow Agent node {node_id} references an unavailable inline agent.")
        source_snapshot = session.scalar(
            select(AgentConfigSnapshot)
            .where(
                AgentConfigSnapshot.tenant_id == draft_workflow.tenant_id,
                AgentConfigSnapshot.agent_id == source_agent.id,
                AgentConfigSnapshot.id == source_snapshot_id,
            )
            .limit(1)
        )
        if source_snapshot is None:
            raise ValueError(f"Workflow Agent node {node_id} references a missing inline agent config snapshot.")

        from services.agent.dsl_service import AgentDslService

        agent, snapshot = AgentDslService(session).clone_inline_binding_for_node(
            workflow=draft_workflow,
            node_id=node_id,
            source_agent=source_agent,
            source_snapshot=source_snapshot,
            account_id=account_id,
        )
        return agent, snapshot.id

    @classmethod
    def _resolve_roster_agent_graph_binding(
        cls,
        *,
        session: Session,
        draft_workflow: Workflow,
        node_id: str,
        agent_id: str,
    ) -> tuple[Agent, str]:
        """Resolve an active roster Agent whose published snapshot is callable."""

        agent = session.scalar(
            select(Agent)
            .where(
                Agent.tenant_id == draft_workflow.tenant_id,
                Agent.id == agent_id,
                Agent.scope == AgentScope.ROSTER,
                Agent.status == AgentStatus.ACTIVE,
                workflow_callable_active_snapshot_filter(),
            )
            .limit(1)
        )
        if agent is None:
            raise ValueError(f"Workflow Agent node {node_id} references an unavailable or unpublished roster agent.")
        if agent.scope != AgentScope.ROSTER:
            raise ValueError(f"Workflow Agent node {node_id} roster_agent binding must reference a roster agent.")
        if not agent.active_config_snapshot_id:
            raise ValueError(f"Workflow Agent node {node_id} roster agent has no active config snapshot.")
        return agent, agent.active_config_snapshot_id

    @classmethod
    def _resolve_inline_agent_graph_binding(
        cls,
        *,
        session: Session,
        draft_workflow: Workflow,
        node_id: str,
        agent_id: str,
        current_snapshot_id: str,
    ) -> Agent:
        agent = session.scalar(
            select(Agent)
            .where(
                Agent.tenant_id == draft_workflow.tenant_id,
                Agent.id == agent_id,
                Agent.scope == AgentScope.WORKFLOW_ONLY,
                Agent.app_id == draft_workflow.app_id,
                Agent.workflow_id == draft_workflow.id,
                Agent.workflow_node_id == node_id,
                Agent.status == AgentStatus.ACTIVE,
            )
            .limit(1)
        )
        if agent is None:
            raise _InlineAgentUnavailableError(f"Workflow Agent node {node_id} references an unavailable inline agent.")
        if (
            agent.scope != AgentScope.WORKFLOW_ONLY
            or agent.app_id != draft_workflow.app_id
            or agent.workflow_id != draft_workflow.id
            or agent.workflow_node_id != node_id
        ):
            raise _InlineAgentOwnershipError(
                f"Workflow Agent node {node_id} inline_agent binding does not belong to this node."
            )

        snapshot = session.scalar(
            select(AgentConfigSnapshot)
            .where(
                AgentConfigSnapshot.tenant_id == draft_workflow.tenant_id,
                AgentConfigSnapshot.agent_id == agent.id,
                AgentConfigSnapshot.id == current_snapshot_id,
            )
            .limit(1)
        )
        if snapshot is None or snapshot.agent_id != agent.id:
            raise _InlineAgentSnapshotError(
                f"Workflow Agent node {node_id} references a missing inline agent config snapshot."
            )
        return agent

    @classmethod
    def _node_job_config_from_node_data(
        cls,
        *,
        existing_binding: WorkflowAgentNodeBinding | None,
        node_data: Mapping[str, Any],
    ) -> WorkflowNodeJobConfig:
        if existing_binding and existing_binding.node_job_config:
            node_job = WorkflowNodeJobConfig.model_validate(existing_binding.node_job_config_dict)
        else:
            node_job = WorkflowNodeJobConfig()

        agent_task = node_data.get(cls._AGENT_TASK_KEY)
        if isinstance(agent_task, str):
            node_job.workflow_prompt = agent_task
            node_job.previous_node_output_refs = cls._previous_node_output_refs_from_prompt(agent_task)

        declared_outputs_payload = node_data.get(cls._AGENT_DECLARED_OUTPUTS_KEY)
        if declared_outputs_payload is not None:
            if not isinstance(declared_outputs_payload, list):
                raise ValueError("Workflow Agent node agent_declared_outputs must be a list.")
            try:
                node_job = WorkflowNodeJobConfig.model_validate(
                    {
                        **node_job.model_dump(mode="python"),
                        "declared_outputs": declared_outputs_payload,
                    }
                )
            except ValidationError as exc:
                raise ValueError("Workflow Agent node has invalid agent_declared_outputs.") from exc

        node_job.output_routes = WorkflowOutputRoutes.model_validate(node_data.get(cls._AGENT_OUTPUT_ROUTES_KEY, {}))
        return node_job

    @classmethod
    def _previous_node_output_refs_from_prompt(cls, prompt: str) -> list[WorkflowPreviousNodeOutputRef]:
        """Derive persisted refs from the current frontend workflow markers only."""
        return workflow_previous_node_output_refs_from_selectors(extract_workflow_node_output_selectors(prompt))

    @classmethod
    def copy_agent_node_bindings_to_published(
        cls,
        *,
        session: Session,
        draft_workflow: Workflow,
        published_workflow: Workflow,
    ) -> None:
        """Copy all draft Roster and inline bindings to a published version.

        Only copied inline bindings add owners for workflow-only Agents.
        Publishing does not release existing draft or historical inline owners,
        produces no retirement candidates.
        """
        node_ids = {
            node_id for node_id, _node_data in WorkflowAgentNodeValidator.iter_agent_v2_nodes(draft_workflow.graph_dict)
        }
        if not node_ids:
            return

        bindings = session.scalars(
            select(WorkflowAgentNodeBinding).where(
                WorkflowAgentNodeBinding.tenant_id == draft_workflow.tenant_id,
                WorkflowAgentNodeBinding.app_id == draft_workflow.app_id,
                WorkflowAgentNodeBinding.workflow_id == draft_workflow.id,
                WorkflowAgentNodeBinding.workflow_version == draft_workflow.version,
                WorkflowAgentNodeBinding.node_id.in_(node_ids),
            )
        ).all()
        if not bindings:
            return

        for binding in bindings:
            current_snapshot_id = binding.current_snapshot_id
            if binding.binding_type == WorkflowAgentBindingType.ROSTER_AGENT and binding.agent_id:
                _, current_snapshot_id = cls._resolve_roster_agent_graph_binding(
                    session=session,
                    draft_workflow=draft_workflow,
                    node_id=binding.node_id,
                    agent_id=binding.agent_id,
                )
            copied = WorkflowAgentNodeBinding(
                tenant_id=binding.tenant_id,
                app_id=binding.app_id,
                workflow_id=published_workflow.id,
                workflow_version=published_workflow.version,
                node_id=binding.node_id,
                binding_type=binding.binding_type,
                agent_id=binding.agent_id,
                current_snapshot_id=current_snapshot_id,
                node_job_config=WorkflowNodeJobConfig.model_validate(binding.node_job_config_dict),
                created_by=binding.created_by,
                updated_by=binding.updated_by,
            )
            session.add(copied)

    @classmethod
    def restore_agent_node_bindings_to_draft(
        cls,
        *,
        session: Session,
        source_workflow: Workflow,
        draft_workflow: Workflow,
        account_id: str,
    ) -> set[str]:
        """Replace draft bindings with the frozen bindings of a published workflow."""

        existing = session.scalars(
            select(WorkflowAgentNodeBinding).where(
                WorkflowAgentNodeBinding.tenant_id == draft_workflow.tenant_id,
                WorkflowAgentNodeBinding.app_id == draft_workflow.app_id,
                WorkflowAgentNodeBinding.workflow_id == draft_workflow.id,
                WorkflowAgentNodeBinding.workflow_version == cls._DRAFT_WORKFLOW_VERSION,
            )
        ).all()
        retirement_candidates = {
            binding.agent_id
            for binding in existing
            if binding.binding_type == WorkflowAgentBindingType.INLINE_AGENT and binding.agent_id
        }
        source_bindings = session.scalars(
            select(WorkflowAgentNodeBinding).where(
                WorkflowAgentNodeBinding.tenant_id == source_workflow.tenant_id,
                WorkflowAgentNodeBinding.app_id == source_workflow.app_id,
                WorkflowAgentNodeBinding.workflow_id == source_workflow.id,
                WorkflowAgentNodeBinding.workflow_version == source_workflow.version,
            )
        ).all()
        for source in source_bindings:
            if source.binding_type == WorkflowAgentBindingType.ROSTER_AGENT and source.agent_id:
                cls._resolve_roster_agent_graph_binding(
                    session=session,
                    draft_workflow=draft_workflow,
                    node_id=source.node_id,
                    agent_id=source.agent_id,
                )

        for binding in existing:
            session.delete(binding)
        session.flush()

        for source in source_bindings:
            agent_id = source.agent_id
            snapshot_id = source.current_snapshot_id
            if source.binding_type == WorkflowAgentBindingType.INLINE_AGENT and agent_id and snapshot_id:
                try:
                    cls._resolve_inline_agent_graph_binding(
                        session=session,
                        draft_workflow=draft_workflow,
                        node_id=source.node_id,
                        agent_id=agent_id,
                        current_snapshot_id=snapshot_id,
                    )
                except ValueError:
                    agent, snapshot_id = cls._clone_inline_graph_binding_for_node(
                        session=session,
                        draft_workflow=draft_workflow,
                        node_id=source.node_id,
                        source_agent_id=agent_id,
                        source_snapshot_id=snapshot_id,
                        account_id=account_id,
                    )
                    agent_id = agent.id
            session.add(
                WorkflowAgentNodeBinding(
                    tenant_id=draft_workflow.tenant_id,
                    app_id=draft_workflow.app_id,
                    workflow_id=draft_workflow.id,
                    workflow_version=cls._DRAFT_WORKFLOW_VERSION,
                    node_id=source.node_id,
                    binding_type=source.binding_type,
                    agent_id=agent_id,
                    current_snapshot_id=snapshot_id,
                    node_job_config=WorkflowNodeJobConfig.model_validate(source.node_job_config_dict),
                    created_by=account_id,
                    updated_by=account_id,
                )
            )
        session.flush()
        return retirement_candidates