feat(agent): add Flow tool type for Maestro Flow processes (#1670)

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: cotovanu-cristian

packages/uipath/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "uipath"
-version = "2.10.68"
+version = "2.10.69"
 description = "Python SDK and CLI for UiPath Platform, enabling programmatic interaction with automation services, process management, and deployment tools."
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.11"

packages/uipath/src/uipath/agent/models/agent.py

@@ -112,6 +112,7 @@ class AgentToolType(str, CaseInsensitiveEnum):
     PROCESS = "Process"
     API = "Api"
     PROCESS_ORCHESTRATION = "ProcessOrchestration"
+    FLOW = "Flow"
     INTEGRATION = "Integration"
     INTERNAL = "Internal"
     IXP = "Ixp"
@@ -779,6 +780,7 @@ class AgentProcessToolResourceConfig(BaseAgentToolResourceConfig):
         AgentToolType.PROCESS,
         AgentToolType.API,
         AgentToolType.PROCESS_ORCHESTRATION,
+        AgentToolType.FLOW,
     ]
     output_schema: Dict[str, Any] = Field(EMPTY_SCHEMA, alias="outputSchema")
     properties: AgentProcessToolProperties
@@ -1322,6 +1324,7 @@ def _normalize_resources(v: Dict[str, Any]) -> None:
             "process": "Process",
             "api": "Api",
             "processorchestration": "ProcessOrchestration",
+            "flow": "Flow",
             "integration": "Integration",
             "internal": "Internal",
             "ixp": "Ixp",

packages/uipath/tests/agent/models/test_agent.py

@@ -3558,6 +3558,75 @@ def test_process_tool_missing_output_schema(self):
         assert isinstance(tool_resource, AgentProcessToolResourceConfig)
         assert tool_resource.output_schema == {"type": "object", "properties": {}}
 
+    def test_flow_tool_type_enum_value(self):
+        """AgentToolType.FLOW exists with the wire value 'Flow' and is case-insensitive."""
+        assert AgentToolType.FLOW.value == "Flow"
+        assert AgentToolType("flow") is AgentToolType.FLOW
+        assert AgentToolType("FLOW") is AgentToolType.FLOW
+
+    def test_flow_tool_resource_deserialization(self):
+        """A resource with type='Flow' is parsed as AgentProcessToolResourceConfig."""
+        resources = [
+            {
+                "$resourceType": "tool",
+                "type": "Flow",
+                "id": "flow-tool-1",
+                "inputSchema": {
+                    "type": "object",
+                    "properties": {"input": {"type": "string"}},
+                },
+                "outputSchema": {"type": "object", "properties": {}},
+                "arguments": {},
+                "settings": {"timeout": 0, "maxAttempts": 0, "retryDelay": 0},
+                "properties": {
+                    "processName": "MyFlow",
+                    "folderPath": "/Shared/Flows",
+                },
+                "name": "Flow Tool",
+                "description": "Test Flow tool",
+            }
+        ]
+
+        json_data = self._agent_dict_with_resources(resources)
+        config: AgentDefinition = TypeAdapter(AgentDefinition).validate_python(
+            json_data
+        )
+
+        tool_resource = config.resources[0]
+        assert isinstance(tool_resource, AgentProcessToolResourceConfig)
+        assert tool_resource.type == AgentToolType.FLOW
+        assert tool_resource.properties.process_name == "MyFlow"
+        assert tool_resource.properties.folder_path == "/Shared/Flows"
+
+    def test_flow_tool_resource_case_insensitive(self):
+        """A resource with lowercase type='flow' also deserializes via CaseInsensitiveEnum."""
+        resources = [
+            {
+                "$resourceType": "tool",
+                "type": "flow",
+                "id": "flow-tool-2",
+                "inputSchema": {"type": "object", "properties": {}},
+                "outputSchema": {"type": "object", "properties": {}},
+                "arguments": {},
+                "settings": {"timeout": 0, "maxAttempts": 0, "retryDelay": 0},
+                "properties": {
+                    "processName": "MyFlow",
+                    "folderPath": "/Shared/Flows",
+                },
+                "name": "Flow Tool",
+                "description": "Test Flow tool",
+            }
+        ]
+
+        json_data = self._agent_dict_with_resources(resources)
+        config: AgentDefinition = TypeAdapter(AgentDefinition).validate_python(
+            json_data
+        )
+
+        tool_resource = config.resources[0]
+        assert isinstance(tool_resource, AgentProcessToolResourceConfig)
+        assert tool_resource.type == AgentToolType.FLOW
+
     def test_escalation_missing_escalation_type_defaults_to_zero(self):
         """Test that missing escalationType defaults to 0."""
         resources = [