graphon 0.2.1__tar.gz → 0.2.2__tar.gz

{graphon-0.2.1 → graphon-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: graphon
-Version: 0.2.1
+Version: 0.2.2
 Summary: Graph execution engine for agentic AI workflows.
 License-Expression: Apache-2.0
 License-File: LICENSE

{graphon-0.2.1 → graphon-0.2.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = 'graphon'
-version = "0.2.1"
+version = "0.2.2"
 description = 'Graph execution engine for agentic AI workflows.'
 readme = 'README.md'
 license = 'Apache-2.0'

{graphon-0.2.1 → graphon-0.2.2}/src/graphon/nodes/base/node.py

@@ -174,6 +174,23 @@ class _NodeRegistryMixin[NodeDataT: BaseNodeData]:
 class _NodeDataModelMixin[NodeDataT: BaseNodeData]:
     """Typed node-data hydration helpers."""
 
+    @classmethod
+    def node_data_from_mapping(
+        cls: type[Node[NodeDataT]],
+        node_data: Mapping[str, Any],
+    ) -> NodeDataT:
+        """Build the concrete node-data instance from a Python mapping.
+
+        This convenience wrapper keeps direct node construction ergonomic for
+        callers that naturally start from plain dictionaries while preserving the
+        stricter `Node.__init__(..., config=NodeDataT, ...)` contract.
+
+        Returns:
+            The validated node data instance for the concrete node subclass.
+
+        """
+        return cls.validate_node_data(node_data)
+
     @classmethod
     def validate_node_data(
         cls: type[Node[NodeDataT]],
@@ -523,10 +540,15 @@ class Node[NodeDataT: BaseNodeData](
     def __init__(
         self,
         node_id: str,
-        config: NodeConfigDict,
+        config: NodeDataT,
+        *,
         graph_init_params: GraphInitParams,
         graph_runtime_state: GraphRuntimeState,
     ) -> None:
+        if not node_id:
+            msg = "node_id is required"
+            raise ValueError(msg)
+
         self._graph_init_params = graph_init_params
         self._run_context = MappingProxyType(dict(graph_init_params.run_context))
         self.id = node_id
@@ -536,19 +558,11 @@ class Node[NodeDataT: BaseNodeData](
         self.graph_runtime_state = graph_runtime_state
         self.state: NodeState = NodeState.UNKNOWN  # node execution state
 
-        config_node_id = config["id"]
-        if node_id != config_node_id:
-            msg = (
-                "node_id must match config['id'], "
-                f"got node_id={node_id!r}, config['id']={config_node_id!r}"
-            )
-            raise ValueError(msg)
-
-        self._node_id = config_node_id
+        self._node_id = node_id
         self._node_execution_id: str = ""
         self._start_at = datetime.now(UTC).replace(tzinfo=None)
 
-        self._node_data = self.validate_node_data(config["data"])
+        self._node_data = self.validate_node_data(config)
 
         self.post_init()
 

{graphon-0.2.1 → graphon-0.2.2}/src/graphon/nodes/code/code_node.py

@@ -3,7 +3,6 @@ from decimal import Decimal
 from textwrap import dedent
 from typing import TYPE_CHECKING, Any, Protocol, cast, override
 
-from graphon.entities.graph_config import NodeConfigDict
 from graphon.enums import BuiltinNodeTypes, WorkflowNodeExecutionStatus
 from graphon.node_events.base import NodeRunResult
 from graphon.nodes.base.node import Node
@@ -83,10 +82,10 @@ class CodeNode(Node[CodeNodeData]):
     def __init__(
         self,
         node_id: str,
-        config: NodeConfigDict,
+        config: CodeNodeData,
+        *,
         graph_init_params: "GraphInitParams",
         graph_runtime_state: "GraphRuntimeState",
-        *,
         code_executor: WorkflowCodeExecutor,
         code_limits: CodeNodeLimits,
     ) -> None:

{graphon-0.2.1 → graphon-0.2.2}/src/graphon/nodes/document_extractor/node.py

@@ -21,7 +21,6 @@ from docx.oxml.text.paragraph import CT_P
 from docx.table import Table
 from docx.text.paragraph import Paragraph
 
-from graphon.entities.graph_config import NodeConfigDict
 from graphon.enums import BuiltinNodeTypes, WorkflowNodeExecutionStatus
 from graphon.file import file_manager
 from graphon.file.enums import FileTransferMethod
@@ -193,10 +192,10 @@ class DocumentExtractorNode(Node[DocumentExtractorNodeData]):
     def __init__(
         self,
         node_id: str,
-        config: NodeConfigDict,
+        config: DocumentExtractorNodeData,
+        *,
         graph_init_params: "GraphInitParams",
         graph_runtime_state: "GraphRuntimeState",
-        *,
         unstructured_api_config: UnstructuredApiConfig | None = None,
         http_client: HttpClientProtocol | None = None,
     ) -> None:

{graphon-0.2.1 → graphon-0.2.2}/src/graphon/nodes/http_request/node.py

@@ -3,7 +3,6 @@ import mimetypes
 from collections.abc import Callable, Mapping, Sequence
 from typing import TYPE_CHECKING, Any, override
 
-from graphon.entities.graph_config import NodeConfigDict
 from graphon.enums import BuiltinNodeTypes, WorkflowNodeExecutionStatus
 from graphon.file.enums import FileTransferMethod
 from graphon.file.models import File
@@ -45,10 +44,10 @@ class HttpRequestNode(Node[HttpRequestNodeData]):
     def __init__(
         self,
         node_id: str,
-        config: NodeConfigDict,
+        config: HttpRequestNodeData,
+        *,
         graph_init_params: "GraphInitParams",
         graph_runtime_state: "GraphRuntimeState",
-        *,
         http_request_config: HttpRequestNodeConfig,
         http_client: HttpClientProtocol | None = None,
         tool_file_manager_factory: Callable[[], ToolFileManagerProtocol],

{graphon-0.2.1 → graphon-0.2.2}/src/graphon/nodes/human_input/human_input_node.py

@@ -4,7 +4,6 @@ from collections.abc import Generator, Mapping, Sequence
 from datetime import UTC, datetime
 from typing import TYPE_CHECKING, Any, override
 
-from graphon.entities.graph_config import NodeConfigDict
 from graphon.entities.pause_reason import HumanInputRequired
 from graphon.enums import (
     BuiltinNodeTypes,
@@ -64,10 +63,14 @@ class HumanInputNode(Node[HumanInputNodeData]):
     def __init__(
         self,
         node_id: str,
-        config: NodeConfigDict,
+        config: HumanInputNodeData,
+        *,
         graph_init_params: "GraphInitParams",
         graph_runtime_state: "GraphRuntimeState",
-        runtime: HumanInputNodeRuntimeProtocol | None = None,
+        # TODO @-LAN: See https://github.com/langgenius/graphon/issues/new/choose.  # noqa: FIX002
+        # Make `runtime` optional once Graphon provides a default human-input
+        # runtime adapter instead of requiring an embedding-specific implementation.
+        runtime: HumanInputNodeRuntimeProtocol,
         form_repository: object | None = None,
     ) -> None:
         super().__init__(
@@ -76,13 +79,9 @@ class HumanInputNode(Node[HumanInputNodeData]):
             graph_init_params=graph_init_params,
             graph_runtime_state=graph_runtime_state,
         )
-        resolved_runtime = runtime
-        if resolved_runtime is None:
-            msg = "runtime is required"
-            raise ValueError(msg)
         if form_repository is not None:
             with_form_repository = getattr(
-                resolved_runtime,
+                runtime,
                 "with_form_repository",
                 None,
             )
@@ -91,8 +90,8 @@ class HumanInputNode(Node[HumanInputNodeData]):
                 if not isinstance(updated_runtime, HumanInputNodeRuntimeProtocol):
                     msg = "with_form_repository() must return a HumanInput runtime"
                     raise TypeError(msg)
-                resolved_runtime = updated_runtime
-        self._runtime: HumanInputNodeRuntimeProtocol = resolved_runtime
+                runtime = updated_runtime
+        self._runtime: HumanInputNodeRuntimeProtocol = runtime
 
     @classmethod
     @override

{graphon-0.2.1 → graphon-0.2.2}/src/graphon/nodes/if_else/entities.py

@@ -25,7 +25,7 @@ class IfElseNodeData(BaseNodeData):
     cases: list[Case] | None = None
 
     def iter_cases(self) -> list[Case]:
-        if self.cases:
+        if self.cases is not None:
             return list(self.cases)
         legacy_conditions = self.__dict__.get("conditions") or []
         return [

{graphon-0.2.1 → graphon-0.2.2}/src/graphon/nodes/if_else/if_else_node.py

@@ -1,7 +1,5 @@
 from collections.abc import Mapping, Sequence
-from typing import Any, Literal, override
-
-from typing_extensions import deprecated
+from typing import Any, override
 
 from graphon.enums import (
     BuiltinNodeTypes,
@@ -11,9 +9,7 @@ from graphon.enums import (
 from graphon.node_events.base import NodeRunResult
 from graphon.nodes.base.node import Node
 from graphon.nodes.if_else.entities import IfElseNodeData
-from graphon.runtime.variable_pool import VariablePool
-from graphon.utils.condition.entities import Condition
-from graphon.utils.condition.processor import ConditionCheckResult, ConditionProcessor
+from graphon.utils.condition.processor import ConditionProcessor
 
 
 class IfElseNode(Node[IfElseNodeData]):
@@ -37,7 +33,7 @@ class IfElseNode(Node[IfElseNodeData]):
         selected_case_id = "false"
         condition_processor = ConditionProcessor()
         try:
-            uses_legacy_shape = not self.node_data.cases
+            uses_legacy_shape = self.node_data.cases is None
             for case in self.node_data.iter_cases():
                 input_conditions, group_result, final_result = (
                     condition_processor.process_conditions(
@@ -58,25 +54,6 @@ class IfElseNode(Node[IfElseNodeData]):
                     selected_case_id = "true" if uses_legacy_shape else case.case_id
                     break
 
-            else:
-                # Keep the legacy fallback until all graph definitions use `cases`.
-                input_conditions, group_result, final_result = (
-                    _should_not_use_old_function(
-                        condition_processor=condition_processor,
-                        variable_pool=self.graph_runtime_state.variable_pool,
-                        conditions=self.node_data.conditions or [],
-                        operator=self.node_data.logical_operator or "and",
-                    )
-                )
-
-                selected_case_id = "true" if final_result else "false"
-
-                process_data["condition_results"].append({
-                    "group": "default",
-                    "results": group_result,
-                    "final_result": final_result,
-                })
-
             node_inputs["conditions"] = input_conditions
 
         except (TypeError, ValueError) as e:
@@ -93,7 +70,7 @@ class IfElseNode(Node[IfElseNodeData]):
             status=WorkflowNodeExecutionStatus.SUCCEEDED,
             inputs=node_inputs,
             process_data=process_data,
-            edge_source_handle=selected_case_id or "false",  # Use case ID or 'default'
+            edge_source_handle=selected_case_id or "false",
             outputs=outputs,
         )
 
@@ -114,18 +91,3 @@ class IfElseNode(Node[IfElseNodeData]):
                 var_mapping[key] = condition.variable_selector
 
         return var_mapping
-
-
-@deprecated("This function is deprecated. You should use the new cases structure.")
-def _should_not_use_old_function(
-    *,
-    condition_processor: ConditionProcessor,
-    variable_pool: VariablePool,
-    conditions: list[Condition],
-    operator: Literal["and", "or"],
-) -> ConditionCheckResult:
-    return condition_processor.process_conditions(
-        variable_pool=variable_pool,
-        conditions=conditions,
-        operator=operator,
-    )

{graphon-0.2.1 → graphon-0.2.2}/src/graphon/nodes/llm/node.py

@@ -10,7 +10,6 @@ from collections.abc import Generator, Mapping, Sequence
 from dataclasses import dataclass, field
 from typing import TYPE_CHECKING, Any, Literal, override
 
-from graphon.entities.graph_config import NodeConfigDict
 from graphon.entities.graph_init_params import GraphInitParams
 from graphon.enums import (
     BuiltinNodeTypes,
@@ -132,10 +131,10 @@ class LLMNode(Node[LLMNodeData]):
     def __init__(
         self,
         node_id: str,
-        config: NodeConfigDict,
+        config: LLMNodeData,
+        *,
         graph_init_params: GraphInitParams,
         graph_runtime_state: GraphRuntimeState,
-        *,
         credentials_provider: object | None = None,
         model_factory: object | None = None,
         model_instance: PreparedLLMProtocol,

{graphon-0.2.1 → graphon-0.2.2}/src/graphon/nodes/parameter_extractor/parameter_extractor_node.py

@@ -6,7 +6,6 @@ from collections.abc import Mapping, Sequence
 from dataclasses import dataclass
 from typing import TYPE_CHECKING, Any, override
 
-from graphon.entities.graph_config import NodeConfigDict
 from graphon.enums import (
     BuiltinNodeTypes,
     WorkflowNodeExecutionMetadataKey,
@@ -139,10 +138,10 @@ class ParameterExtractorNode(Node[ParameterExtractorNodeData]):
     def __init__(
         self,
         node_id: str,
-        config: NodeConfigDict,
+        config: ParameterExtractorNodeData,
+        *,
         graph_init_params: "GraphInitParams",
         graph_runtime_state: "GraphRuntimeState",
-        *,
         credentials_provider: object | None = None,
         model_factory: object | None = None,
         model_instance: PreparedLLMProtocol,

{graphon-0.2.1 → graphon-0.2.2}/src/graphon/nodes/question_classifier/question_classifier_node.py

@@ -4,7 +4,6 @@ from collections.abc import Mapping, Sequence
 from dataclasses import dataclass
 from typing import TYPE_CHECKING, Any, override
 
-from graphon.entities.graph_config import NodeConfigDict
 from graphon.entities.graph_init_params import GraphInitParams
 from graphon.enums import (
     BuiltinNodeTypes,
@@ -87,10 +86,10 @@ class QuestionClassifierNode(Node[QuestionClassifierNodeData]):
     def __init__(
         self,
         node_id: str,
-        config: NodeConfigDict,
+        config: QuestionClassifierNodeData,
+        *,
         graph_init_params: "GraphInitParams",
         graph_runtime_state: "GraphRuntimeState",
-        *,
         credentials_provider: object | None = None,
         model_factory: object | None = None,
         model_instance: PreparedLLMProtocol,

{graphon-0.2.1 → graphon-0.2.2}/src/graphon/nodes/template_transform/template_transform_node.py

@@ -1,7 +1,6 @@
 from collections.abc import Mapping, Sequence
 from typing import TYPE_CHECKING, Any, cast, override
 
-from graphon.entities.graph_config import NodeConfigDict
 from graphon.enums import BuiltinNodeTypes, WorkflowNodeExecutionStatus
 from graphon.node_events.base import NodeRunResult
 from graphon.nodes.base.entities import VariableSelector
@@ -28,10 +27,10 @@ class TemplateTransformNode(Node[TemplateTransformNodeData]):
     def __init__(
         self,
         node_id: str,
-        config: NodeConfigDict,
+        config: TemplateTransformNodeData,
+        *,
         graph_init_params: "GraphInitParams",
         graph_runtime_state: "GraphRuntimeState",
-        *,
         jinja2_template_renderer: Jinja2TemplateRenderer,
         max_output_length: int | None = None,
     ) -> None:

{graphon-0.2.1 → graphon-0.2.2}/src/graphon/nodes/tool/tool_node.py

@@ -2,7 +2,6 @@ from collections.abc import Generator, Mapping, Sequence
 from dataclasses import dataclass, field
 from typing import TYPE_CHECKING, Any, override
 
-from graphon.entities.graph_config import NodeConfigDict
 from graphon.enums import (
     BuiltinNodeTypes,
     WorkflowNodeExecutionMetadataKey,
@@ -61,12 +60,15 @@ class ToolNode(Node[ToolNodeData]):
     def __init__(
         self,
         node_id: str,
-        config: NodeConfigDict,
+        config: ToolNodeData,
+        *,
         graph_init_params: "GraphInitParams",
         graph_runtime_state: "GraphRuntimeState",
-        *,
         tool_file_manager_factory: ToolFileManagerProtocol,
-        runtime: ToolNodeRuntimeProtocol | None = None,
+        # TODO @-LAN: See https://github.com/langgenius/graphon/issues/new/choose.  # noqa: FIX002
+        # Make `runtime` optional once Graphon provides a default tool runtime
+        # adapter at the workflow boundary.
+        runtime: ToolNodeRuntimeProtocol,
     ) -> None:
         super().__init__(
             node_id=node_id,
@@ -75,9 +77,6 @@ class ToolNode(Node[ToolNodeData]):
             graph_runtime_state=graph_runtime_state,
         )
         self._tool_file_manager_factory = tool_file_manager_factory
-        if runtime is None:
-            msg = "runtime is required"
-            raise ValueError(msg)
         self._runtime = runtime
 
     def init_tool_runtime(

{graphon-0.2.1 → graphon-0.2.2}/src/graphon/nodes/variable_assigner/v1/node.py

@@ -1,7 +1,6 @@
 from collections.abc import Generator, Mapping, Sequence
 from typing import TYPE_CHECKING, Any, cast, override
 
-from graphon.entities.graph_config import NodeConfigDict
 from graphon.entities.graph_init_params import GraphInitParams
 from graphon.enums import BuiltinNodeTypes, WorkflowNodeExecutionStatus
 from graphon.node_events.base import (
@@ -34,7 +33,8 @@ class VariableAssignerNode(Node[VariableAssignerData]):
     def __init__(
         self,
         node_id: str,
-        config: NodeConfigDict,
+        config: VariableAssignerData,
+        *,
         graph_init_params: "GraphInitParams",
         graph_runtime_state: "GraphRuntimeState",
     ) -> None:

{graphon-0.2.1 → graphon-0.2.2}/src/graphon/nodes/variable_assigner/v2/node.py

@@ -2,7 +2,6 @@ import json
 from collections.abc import Generator, Mapping, MutableMapping, Sequence
 from typing import TYPE_CHECKING, Any, cast, override
 
-from graphon.entities.graph_config import NodeConfigDict
 from graphon.enums import BuiltinNodeTypes, WorkflowNodeExecutionStatus
 from graphon.node_events.base import (
     NodeEventBase,
@@ -84,7 +83,8 @@ class VariableAssignerNode(Node[VariableAssignerNodeData]):
     def __init__(
         self,
         node_id: str,
-        config: NodeConfigDict,
+        config: VariableAssignerNodeData,
+        *,
         graph_init_params: "GraphInitParams",
         graph_runtime_state: "GraphRuntimeState",
     ) -> None: