uipath-langchain 0.0.127__tar.gz → 0.0.128__tar.gz

{uipath_langchain-0.0.127 → uipath_langchain-0.0.128}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: uipath-langchain
-Version: 0.0.127
+Version: 0.0.128
 Summary: UiPath Langchain
 Project-URL: Homepage, https://uipath.com
 Project-URL: Repository, https://github.com/UiPath/uipath-langchain-python
@@ -25,7 +25,7 @@ Requires-Dist: openai>=1.65.5
 Requires-Dist: openinference-instrumentation-langchain>=0.1.50
 Requires-Dist: pydantic-settings>=2.6.0
 Requires-Dist: python-dotenv>=1.0.1
-Requires-Dist: uipath<2.2.0,>=2.1.41
+Requires-Dist: uipath<2.2.0,>=2.1.44
 Provides-Extra: langchain
 Description-Content-Type: text/markdown
 

{uipath_langchain-0.0.127 → uipath_langchain-0.0.128}/pyproject.toml

@@ -1,11 +1,11 @@
 [project]
 name = "uipath-langchain"
-version = "0.0.127"
+version = "0.0.128"
 description = "UiPath Langchain"
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.10"
 dependencies = [
-    "uipath>=2.1.41, <2.2.0",
+    "uipath>=2.1.44, <2.2.0",
     "langgraph>=0.5.0, <0.7.0",
     "langchain-core>=0.3.34",
     "langgraph-checkpoint-sqlite>=2.0.3",

uipath_langchain-0.0.128/src/uipath_langchain/_cli/_runtime/_context.py

@@ -0,0 +1,168 @@
+from typing import Any, Optional, Union
+from uuid import uuid4
+
+from langgraph.checkpoint.sqlite.aio import AsyncSqliteSaver
+from langgraph.graph import StateGraph
+from uipath._cli._runtime._contracts import UiPathRuntimeContext, UiPathTraceContext
+
+from .._utils._graph import LangGraphConfig
+
+
+class LangGraphRuntimeContext(UiPathRuntimeContext):
+    """Context information passed throughout the runtime execution."""
+
+    langgraph_config: Optional[LangGraphConfig] = None
+    state_graph: Optional[StateGraph[Any, Any]] = None
+    output: Optional[Any] = None
+    state: Optional[Any] = (
+        None  # TypedDict issue, the actual type is: Optional[langgraph.types.StateSnapshot]
+    )
+    memory: Optional[AsyncSqliteSaver] = None
+    langsmith_tracing_enabled: Union[str, bool, None] = False
+    resume_triggers_table: str = "__uipath_resume_triggers"
+
+
+class LangGraphRuntimeContextBuilder:
+    """Builder class for LangGraphRuntimeContext following the builder pattern."""
+
+    def __init__(self):
+        self._kwargs = {}
+
+    def with_defaults(
+        self, config_path: Optional[str] = None, **kwargs
+    ) -> "LangGraphRuntimeContextBuilder":
+        """Apply default configuration similar to LangGraphRuntimeContext.from_config().
+
+        Args:
+            config_path: Path to the configuration file (defaults to UIPATH_CONFIG_PATH env var or "uipath.json")
+            **kwargs: Additional keyword arguments to pass to with_defaults
+
+        Returns:
+            Self for method chaining
+        """
+        from os import environ as env
+
+        resolved_config_path = config_path or env.get(
+            "UIPATH_CONFIG_PATH", "uipath.json"
+        )
+        self._kwargs["config_path"] = resolved_config_path
+
+        bool_map = {"true": True, "false": False}
+        tracing = env.get("UIPATH_TRACING_ENABLED", True)
+        if isinstance(tracing, str) and tracing.lower() in bool_map:
+            tracing = bool_map[tracing.lower()]
+
+        self._kwargs.update(
+            {
+                "job_id": env.get("UIPATH_JOB_KEY"),
+                "execution_id": env.get("UIPATH_JOB_KEY"),
+                "trace_id": env.get("UIPATH_TRACE_ID"),
+                "tracing_enabled": tracing,
+                "logs_min_level": env.get("LOG_LEVEL", "INFO"),
+                "langsmith_tracing_enabled": env.get("LANGSMITH_TRACING", False),
+                **kwargs,  # Allow overriding defaults with provided kwargs
+            }
+        )
+
+        self._kwargs["trace_context"] = UiPathTraceContext(
+            trace_id=env.get("UIPATH_TRACE_ID"),
+            parent_span_id=env.get("UIPATH_PARENT_SPAN_ID"),
+            root_span_id=env.get("UIPATH_ROOT_SPAN_ID"),
+            enabled=tracing,
+            job_id=env.get("UIPATH_JOB_KEY"),
+            org_id=env.get("UIPATH_ORGANIZATION_ID"),
+            tenant_id=env.get("UIPATH_TENANT_ID"),
+            process_key=env.get("UIPATH_PROCESS_UUID"),
+            folder_key=env.get("UIPATH_FOLDER_KEY"),
+            reference_id=env.get("UIPATH_JOB_KEY") or str(uuid4()),
+        )
+
+        return self
+
+    def with_entrypoint(
+        self, entrypoint: Optional[str]
+    ) -> "LangGraphRuntimeContextBuilder":
+        """Set the entrypoint for the runtime context.
+
+        Args:
+            entrypoint: The entrypoint to execute
+
+        Returns:
+            Self for method chaining
+        """
+        if entrypoint is not None:
+            self._kwargs["entrypoint"] = entrypoint
+        return self
+
+    def with_input(
+        self, input_data: Optional[str] = None, input_file: Optional[str] = None
+    ) -> "LangGraphRuntimeContextBuilder":
+        """Set the input data for the runtime context.
+
+        Args:
+            input_data: The input data as a string
+            input_file: Path to the input file
+
+        Returns:
+            Self for method chaining
+        """
+        if input_data is not None:
+            self._kwargs["input"] = input_data
+        if input_file is not None:
+            self._kwargs["input_file"] = input_file
+        return self
+
+    def with_resume(self, enable: bool = True) -> "LangGraphRuntimeContextBuilder":
+        """Enable or disable resume mode for the runtime context.
+
+        Args:
+            enable: Whether to enable resume mode (defaults to True)
+
+        Returns:
+            Self for method chaining
+        """
+        self._kwargs["resume"] = enable
+        return self
+
+    def with_langgraph_config(
+        self, config: LangGraphConfig
+    ) -> "LangGraphRuntimeContextBuilder":
+        """Set the LangGraph configuration.
+
+        Args:
+            config: The LangGraph configuration
+
+        Returns:
+            Self for method chaining
+        """
+        self._kwargs["langgraph_config"] = config
+        return self
+
+    def mark_eval_run(self, enable: bool = True) -> "LangGraphRuntimeContextBuilder":
+        """Mark this as an evaluation run.
+
+        Args:
+            enable: Whether this is an eval run (defaults to True)
+
+        Returns:
+            Self for method chaining
+        """
+        self._kwargs["is_eval_run"] = enable
+        return self
+
+    def build(self) -> "LangGraphRuntimeContext":
+        """Build and return the LangGraphRuntimeContext instance.
+
+        Returns:
+            A configured LangGraphRuntimeContext instance
+        """
+        config_path = self._kwargs.pop("config_path", None)
+        if config_path:
+            # Create context from config first, then update with any additional kwargs
+            context = LangGraphRuntimeContext.from_config(config_path)
+            for key, value in self._kwargs.items():
+                if hasattr(context, key):
+                    setattr(context, key, value)
+            return context
+        else:
+            return LangGraphRuntimeContext(**self._kwargs)

uipath_langchain-0.0.128/src/uipath_langchain/_cli/cli_eval.py

@@ -0,0 +1,63 @@
+import asyncio
+from os import environ as env
+from typing import List, Optional
+
+from uipath._cli._evals._runtime import UiPathEvalContext, UiPathEvalRuntime
+from uipath._cli._runtime._contracts import (
+    UiPathRuntimeContextBuilder,
+    UiPathRuntimeFactory,
+)
+from uipath._cli.middlewares import MiddlewareResult
+
+from uipath_langchain._cli._runtime._context import (
+    LangGraphRuntimeContext,
+    LangGraphRuntimeContextBuilder,
+)
+from uipath_langchain._cli._runtime._runtime import LangGraphRuntime
+from uipath_langchain._cli._utils._graph import LangGraphConfig
+
+
+def langgraph_eval_middleware(
+    entrypoint: Optional[str], eval_set: Optional[str], eval_ids: List[str], **kwargs
+) -> MiddlewareResult:
+    def generate_eval_context(
+        runtime_context: LangGraphRuntimeContext,
+    ) -> UiPathEvalContext[LangGraphRuntimeContext]:
+        base_context = UiPathRuntimeContextBuilder().with_defaults().build()
+        return UiPathEvalContext(
+            runtime_context=runtime_context,
+            **kwargs,
+            **base_context.model_dump(),
+        )
+
+    try:
+        runtime_factory = UiPathRuntimeFactory(
+            LangGraphRuntime, LangGraphRuntimeContext
+        )
+        # Add default env variables
+        env["UIPATH_REQUESTING_PRODUCT"] = "uipath-python-sdk"
+        env["UIPATH_REQUESTING_FEATURE"] = "langgraph-agent"
+
+        context = (
+            LangGraphRuntimeContextBuilder()
+            .with_defaults(**kwargs)
+            .with_langgraph_config(LangGraphConfig())
+            .with_entrypoint(entrypoint)
+            .mark_eval_run()
+        ).build()
+
+        async def execute():
+            async with UiPathEvalRuntime[
+                LangGraphRuntime, LangGraphRuntimeContext
+            ].from_eval_context(
+                factory=runtime_factory, context=generate_eval_context(context)
+            ) as eval_runtime:
+                await eval_runtime.execute()
+
+        asyncio.run(execute())
+        return MiddlewareResult(should_continue=False)
+
+    except Exception as e:
+        return MiddlewareResult(
+            should_continue=False, error_message=f"Error running evaluation: {str(e)}"
+        )

uipath_langchain-0.0.128/src/uipath_langchain/_cli/cli_run.py

@@ -0,0 +1,67 @@
+import asyncio
+import os
+from os import environ as env
+from typing import Optional
+
+from dotenv import load_dotenv
+from uipath._cli.middlewares import MiddlewareResult
+
+from ._runtime._context import LangGraphRuntimeContextBuilder
+from ._runtime._exception import LangGraphRuntimeError
+from ._runtime._runtime import LangGraphRuntime
+from ._utils._graph import LangGraphConfig
+
+load_dotenv()
+
+
+def langgraph_run_middleware(
+    entrypoint: Optional[str], input: Optional[str], resume: bool, **kwargs
+) -> MiddlewareResult:
+    """Middleware to handle langgraph execution"""
+    config = LangGraphConfig()
+    if not config.exists:
+        return MiddlewareResult(
+            should_continue=True
+        )  # Continue with normal flow if no langgraph.json
+
+    try:
+        # Add default env variables
+        env["UIPATH_REQUESTING_PRODUCT"] = "uipath-python-sdk"
+        env["UIPATH_REQUESTING_FEATURE"] = "langgraph-agent"
+
+        context = (
+            LangGraphRuntimeContextBuilder()
+            .with_defaults(**kwargs)
+            .with_langgraph_config(config)
+            .with_entrypoint(entrypoint)
+            .with_input(input_data=input, input_file=kwargs.get("input_file"))
+            .with_resume(resume)
+        ).build()
+
+        async def execute():
+            async with LangGraphRuntime.from_context(context) as runtime:
+                if context.resume is False and context.job_id is None:
+                    # Delete the previous graph state file at debug time
+                    if os.path.exists(runtime.state_file_path):
+                        os.remove(runtime.state_file_path)
+                await runtime.execute()
+
+        asyncio.run(execute())
+
+        return MiddlewareResult(
+            should_continue=False,
+            error_message=None,
+        )
+
+    except LangGraphRuntimeError as e:
+        return MiddlewareResult(
+            should_continue=False,
+            error_message=e.error_info.detail,
+            should_include_stacktrace=True,
+        )
+    except Exception as e:
+        return MiddlewareResult(
+            should_continue=False,
+            error_message=f"Error: {str(e)}",
+            should_include_stacktrace=True,
+        )

{uipath_langchain-0.0.127 → uipath_langchain-0.0.128}/src/uipath_langchain/middlewares.py

@@ -1,6 +1,7 @@
 from uipath._cli.middlewares import Middlewares
 
 from ._cli.cli_dev import langgraph_dev_middleware
+from ._cli.cli_eval import langgraph_eval_middleware
 from ._cli.cli_init import langgraph_init_middleware
 from ._cli.cli_new import langgraph_new_middleware
 from ._cli.cli_run import langgraph_run_middleware
@@ -12,3 +13,4 @@ def register_middleware():
     Middlewares.register("run", langgraph_run_middleware)
     Middlewares.register("new", langgraph_new_middleware)
     Middlewares.register("dev", langgraph_dev_middleware)
+    Middlewares.register("eval", langgraph_eval_middleware)

{uipath_langchain-0.0.127 → uipath_langchain-0.0.128}/uv.lock

@@ -2746,7 +2746,7 @@ wheels = [
 
 [[package]]
 name = "uipath"
-version = "2.1.41"
+version = "2.1.44"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "azure-monitor-opentelemetry" },
@@ -2764,14 +2764,14 @@ dependencies = [
     { name = "tomli" },
     { name = "truststore" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/38/e6/2577f69ba8d64c959794f3028c44aa83bcc1d1d0dcd7529b5de684d1e866/uipath-2.1.41.tar.gz", hash = "sha256:0dd6b59b44f03bfedd6285eeac0ccaa4c84334bad4442241e770fe107b6d2bb4", size = 1987987, upload-time = "2025-09-11T16:29:32.878Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/09/62/c0d9d884c7b2b01eb78e9445874745eae0422673d9b89335ce890960eda5/uipath-2.1.44.tar.gz", hash = "sha256:4b544c467158d57f6f7b7ac001fa34b959e685830065bb717544b05b32ee237f", size = 1988099, upload-time = "2025-09-15T06:59:47.92Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/80/f2/1d2577a622cb20e6d4e9d86875034c5bf4fe16137bcbde9e409276238210/uipath-2.1.41-py3-none-any.whl", hash = "sha256:0cf4aeaf118e458163d20cad1d2b74faf1c8b6f2b6d4b0ee3926591fb39b2745", size = 214411, upload-time = "2025-09-11T16:29:30.896Z" },
+    { url = "https://files.pythonhosted.org/packages/51/fd/3ae9edea73f5a8223771924b90dbc390c43b70cebed101b27a05caad11fe/uipath-2.1.44-py3-none-any.whl", hash = "sha256:6988df9cac8a2b6bec505c7b816e5c1d80a990f36fe2e853997e8837e7572bfc", size = 215418, upload-time = "2025-09-15T06:59:46.071Z" },
 ]
 
 [[package]]
 name = "uipath-langchain"
-version = "0.0.127"
+version = "0.0.128"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },
@@ -2815,7 +2815,7 @@ requires-dist = [
     { name = "openinference-instrumentation-langchain", specifier = ">=0.1.50" },
     { name = "pydantic-settings", specifier = ">=2.6.0" },
     { name = "python-dotenv", specifier = ">=1.0.1" },
-    { name = "uipath", specifier = ">=2.1.41,<2.2.0" },
+    { name = "uipath", specifier = ">=2.1.44,<2.2.0" },
     { name = "uipath-langchain", marker = "extra == 'langchain'", specifier = ">=0.0.2" },
 ]
 provides-extras = ["langchain"]

uipath_langchain-0.0.127/src/uipath_langchain/_cli/_runtime/_context.py

@@ -1,21 +0,0 @@
-from typing import Any, Optional, Union
-
-from langgraph.checkpoint.sqlite.aio import AsyncSqliteSaver
-from langgraph.graph import StateGraph
-from uipath._cli._runtime._contracts import UiPathRuntimeContext
-
-from .._utils._graph import LangGraphConfig
-
-
-class LangGraphRuntimeContext(UiPathRuntimeContext):
-    """Context information passed throughout the runtime execution."""
-
-    langgraph_config: Optional[LangGraphConfig] = None
-    state_graph: Optional[StateGraph[Any, Any]] = None
-    output: Optional[Any] = None
-    state: Optional[Any] = (
-        None  # TypedDict issue, the actual type is: Optional[langgraph.types.StateSnapshot]
-    )
-    memory: Optional[AsyncSqliteSaver] = None
-    langsmith_tracing_enabled: Union[str, bool, None] = False
-    resume_triggers_table: str = "__uipath_resume_triggers"

uipath_langchain-0.0.127/src/uipath_langchain/_cli/cli_run.py

@@ -1,93 +0,0 @@
-import asyncio
-import os
-from os import environ as env
-from typing import Optional
-
-from dotenv import load_dotenv
-from uipath._cli._runtime._contracts import UiPathTraceContext
-from uipath._cli.middlewares import MiddlewareResult
-
-from ._runtime._context import LangGraphRuntimeContext
-from ._runtime._exception import LangGraphRuntimeError
-from ._runtime._runtime import LangGraphRuntime
-from ._utils._graph import LangGraphConfig
-
-load_dotenv()
-
-
-def langgraph_run_middleware(
-    entrypoint: Optional[str], input: Optional[str], resume: bool, **kwargs
-) -> MiddlewareResult:
-    """Middleware to handle langgraph execution"""
-    config = LangGraphConfig()
-    if not config.exists:
-        return MiddlewareResult(
-            should_continue=True
-        )  # Continue with normal flow if no langgraph.json
-
-    try:
-        bool_map = {"true": True, "false": False}
-        tracing = env.get("UIPATH_TRACING_ENABLED", True)
-        if isinstance(tracing, str) and tracing.lower() in bool_map:
-            tracing = bool_map[tracing.lower()]
-
-        async def execute():
-            context: LangGraphRuntimeContext = LangGraphRuntimeContext.from_config(
-                env.get("UIPATH_CONFIG_PATH", "uipath.json"), **kwargs
-            )
-            context.entrypoint = entrypoint
-            context.input = input
-            context.resume = resume
-            context.langgraph_config = config
-            context.debug = kwargs.get("debug", False)
-            context.logs_min_level = env.get("LOG_LEVEL", "INFO")
-            context.job_id = env.get("UIPATH_JOB_KEY", None)
-            context.execution_id = env.get("UIPATH_JOB_KEY", None)
-            context.trace_id = env.get("UIPATH_TRACE_ID")
-            context.is_eval_run = kwargs.get("is_eval_run", False)
-            context.tracing_enabled = tracing
-            context.input_file = kwargs.get("input_file", None)
-            context.execution_output_file = kwargs.get("execution_output_file", None)
-            context.trace_context = UiPathTraceContext(
-                enabled=tracing,
-                trace_id=env.get("UIPATH_TRACE_ID"),
-                parent_span_id=env.get("UIPATH_PARENT_SPAN_ID"),
-                root_span_id=env.get("UIPATH_ROOT_SPAN_ID"),
-                job_id=env.get("UIPATH_JOB_KEY"),
-                org_id=env.get("UIPATH_ORGANIZATION_ID"),
-                tenant_id=env.get("UIPATH_TENANT_ID"),
-                process_key=env.get("UIPATH_PROCESS_UUID"),
-                folder_key=env.get("UIPATH_FOLDER_KEY"),
-            )
-            context.langsmith_tracing_enabled = env.get("LANGSMITH_TRACING", False)
-
-            # Add default env variables
-            env["UIPATH_REQUESTING_PRODUCT"] = "uipath-python-sdk"
-            env["UIPATH_REQUESTING_FEATURE"] = "langgraph-agent"
-
-            async with LangGraphRuntime.from_context(context) as runtime:
-                if context.resume is False and context.job_id is None:
-                    # Delete the previous graph state file at debug time
-                    if os.path.exists(runtime.state_file_path):
-                        os.remove(runtime.state_file_path)
-                await runtime.execute()
-
-        asyncio.run(execute())
-
-        return MiddlewareResult(
-            should_continue=False,
-            error_message=None,
-        )
-
-    except LangGraphRuntimeError as e:
-        return MiddlewareResult(
-            should_continue=False,
-            error_message=e.error_info.detail,
-            should_include_stacktrace=True,
-        )
-    except Exception as e:
-        return MiddlewareResult(
-            should_continue=False,
-            error_message=f"Error: {str(e)}",
-            should_include_stacktrace=True,
-        )