refactor(api): rename dify_graph to graphon (#34095)

api/graphon/node_events/__init__.py

@@ -0,0 +1,48 @@
+from .agent import AgentLogEvent
+from .base import NodeEventBase, NodeRunResult
+from .iteration import (
+    IterationFailedEvent,
+    IterationNextEvent,
+    IterationStartedEvent,
+    IterationSucceededEvent,
+)
+from .loop import (
+    LoopFailedEvent,
+    LoopNextEvent,
+    LoopStartedEvent,
+    LoopSucceededEvent,
+)
+from .node import (
+    HumanInputFormFilledEvent,
+    HumanInputFormTimeoutEvent,
+    ModelInvokeCompletedEvent,
+    PauseRequestedEvent,
+    RunRetrieverResourceEvent,
+    RunRetryEvent,
+    StreamChunkEvent,
+    StreamCompletedEvent,
+    VariableUpdatedEvent,
+)
+
+__all__ = [
+    "AgentLogEvent",
+    "HumanInputFormFilledEvent",
+    "HumanInputFormTimeoutEvent",
+    "IterationFailedEvent",
+    "IterationNextEvent",
+    "IterationStartedEvent",
+    "IterationSucceededEvent",
+    "LoopFailedEvent",
+    "LoopNextEvent",
+    "LoopStartedEvent",
+    "LoopSucceededEvent",
+    "ModelInvokeCompletedEvent",
+    "NodeEventBase",
+    "NodeRunResult",
+    "PauseRequestedEvent",
+    "RunRetrieverResourceEvent",
+    "RunRetryEvent",
+    "StreamChunkEvent",
+    "StreamCompletedEvent",
+    "VariableUpdatedEvent",
+]

api/graphon/node_events/agent.py

@@ -0,0 +1,18 @@
+from collections.abc import Mapping
+from typing import Any
+
+from pydantic import Field
+
+from .base import NodeEventBase
+
+
+class AgentLogEvent(NodeEventBase):
+    message_id: str = Field(..., description="id")
+    label: str = Field(..., description="label")
+    node_execution_id: str = Field(..., description="node execution id")
+    parent_id: str | None = Field(..., description="parent id")
+    error: str | None = Field(..., description="error")
+    status: str = Field(..., description="status")
+    data: Mapping[str, Any] = Field(..., description="data")
+    metadata: Mapping[str, Any] = Field(default_factory=dict, description="metadata")
+    node_id: str = Field(..., description="node id")

api/graphon/node_events/base.py

@@ -0,0 +1,40 @@
+from collections.abc import Mapping
+from typing import Any
+
+from pydantic import BaseModel, Field
+
+from graphon.enums import WorkflowNodeExecutionMetadataKey, WorkflowNodeExecutionStatus
+from graphon.model_runtime.entities.llm_entities import LLMUsage
+
+
+class NodeEventBase(BaseModel):
+    """Base class for all node events"""
+
+    pass
+
+
+def _default_metadata():
+    v: Mapping[WorkflowNodeExecutionMetadataKey, Any] = {}
+    return v
+
+
+class NodeRunResult(BaseModel):
+    """
+    Node Run Result.
+    """
+
+    status: WorkflowNodeExecutionStatus = WorkflowNodeExecutionStatus.PENDING
+
+    inputs: Mapping[str, Any] = Field(default_factory=dict)
+    process_data: Mapping[str, Any] = Field(default_factory=dict)
+    outputs: Mapping[str, Any] = Field(default_factory=dict)
+    metadata: Mapping[WorkflowNodeExecutionMetadataKey, Any] = Field(default_factory=_default_metadata)
+    llm_usage: LLMUsage = Field(default_factory=LLMUsage.empty_usage)
+
+    edge_source_handle: str = "source"  # source handle id of node with multiple branches
+
+    error: str = ""
+    error_type: str = ""
+
+    # single step node run retry
+    retry_index: int = 0

api/graphon/node_events/iteration.py

@@ -0,0 +1,36 @@
+from collections.abc import Mapping
+from datetime import datetime
+from typing import Any
+
+from pydantic import Field
+
+from .base import NodeEventBase
+
+
+class IterationStartedEvent(NodeEventBase):
+    start_at: datetime = Field(..., description="start at")
+    inputs: Mapping[str, object] = Field(default_factory=dict)
+    metadata: Mapping[str, object] = Field(default_factory=dict)
+    predecessor_node_id: str | None = None
+
+
+class IterationNextEvent(NodeEventBase):
+    index: int = Field(..., description="index")
+    pre_iteration_output: Any = None
+
+
+class IterationSucceededEvent(NodeEventBase):
+    start_at: datetime = Field(..., description="start at")
+    inputs: Mapping[str, object] = Field(default_factory=dict)
+    outputs: Mapping[str, object] = Field(default_factory=dict)
+    metadata: Mapping[str, object] = Field(default_factory=dict)
+    steps: int = 0
+
+
+class IterationFailedEvent(NodeEventBase):
+    start_at: datetime = Field(..., description="start at")
+    inputs: Mapping[str, object] = Field(default_factory=dict)
+    outputs: Mapping[str, object] = Field(default_factory=dict)
+    metadata: Mapping[str, object] = Field(default_factory=dict)
+    steps: int = 0
+    error: str = Field(..., description="failed reason")

api/graphon/node_events/loop.py

@@ -0,0 +1,36 @@
+from collections.abc import Mapping
+from datetime import datetime
+from typing import Any
+
+from pydantic import Field
+
+from .base import NodeEventBase
+
+
+class LoopStartedEvent(NodeEventBase):
+    start_at: datetime = Field(..., description="start at")
+    inputs: Mapping[str, object] = Field(default_factory=dict)
+    metadata: Mapping[str, object] = Field(default_factory=dict)
+    predecessor_node_id: str | None = None
+
+
+class LoopNextEvent(NodeEventBase):
+    index: int = Field(..., description="index")
+    pre_loop_output: Any = None
+
+
+class LoopSucceededEvent(NodeEventBase):
+    start_at: datetime = Field(..., description="start at")
+    inputs: Mapping[str, object] = Field(default_factory=dict)
+    outputs: Mapping[str, object] = Field(default_factory=dict)
+    metadata: Mapping[str, object] = Field(default_factory=dict)
+    steps: int = 0
+
+
+class LoopFailedEvent(NodeEventBase):
+    start_at: datetime = Field(..., description="start at")
+    inputs: Mapping[str, object] = Field(default_factory=dict)
+    outputs: Mapping[str, object] = Field(default_factory=dict)
+    metadata: Mapping[str, object] = Field(default_factory=dict)
+    steps: int = 0
+    error: str = Field(..., description="failed reason")

api/graphon/node_events/node.py

@@ -0,0 +1,72 @@
+from collections.abc import Mapping, Sequence
+from datetime import datetime
+from typing import Any
+
+from pydantic import Field
+
+from graphon.entities.pause_reason import PauseReason
+from graphon.file import File
+from graphon.model_runtime.entities.llm_entities import LLMUsage
+from graphon.node_events import NodeRunResult
+from graphon.variables.variables import Variable
+
+from .base import NodeEventBase
+
+
+class RunRetrieverResourceEvent(NodeEventBase):
+    retriever_resources: Sequence[Mapping[str, Any]] = Field(..., description="retriever resources")
+    context: str = Field(..., description="context")
+    context_files: list[File] | None = Field(default=None, description="context files")
+
+
+class ModelInvokeCompletedEvent(NodeEventBase):
+    text: str
+    usage: LLMUsage
+    finish_reason: str | None = None
+    reasoning_content: str | None = None
+    structured_output: dict | None = None
+
+
+class RunRetryEvent(NodeEventBase):
+    error: str = Field(..., description="error")
+    retry_index: int = Field(..., description="Retry attempt number")
+    start_at: datetime = Field(..., description="Retry start time")
+
+
+class StreamChunkEvent(NodeEventBase):
+    # Spec-compliant fields
+    selector: Sequence[str] = Field(
+        ..., description="selector identifying the output location (e.g., ['nodeA', 'text'])"
+    )
+    chunk: str = Field(..., description="the actual chunk content")
+    is_final: bool = Field(default=False, description="indicates if this is the last chunk")
+
+
+class StreamCompletedEvent(NodeEventBase):
+    node_run_result: NodeRunResult = Field(..., description="run result")
+
+
+class VariableUpdatedEvent(NodeEventBase):
+    """Notify the engine that a single variable should be applied to the shared pool."""
+
+    variable: Variable = Field(..., description="Updated variable payload to apply.")
+
+
+class PauseRequestedEvent(NodeEventBase):
+    reason: PauseReason = Field(..., description="pause reason")
+
+
+class HumanInputFormFilledEvent(NodeEventBase):
+    """Event emitted when a human input form is submitted."""
+
+    node_title: str
+    rendered_content: str
+    action_id: str
+    action_text: str
+
+
+class HumanInputFormTimeoutEvent(NodeEventBase):
+    """Event emitted when a human input form times out."""
+
+    node_title: str
+    expiration_time: datetime