Merge pull request #1035 from UiPath/feat/add-internal-tools

feat: add internal tool types [PC-3568]

Author: cristian-groza

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "uipath"
-version = "2.2.39"
+version = "2.2.40"
 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"

src/uipath/agent/models/agent.py

@@ -37,9 +37,16 @@ class AgentToolType(str, Enum):
     API = "Api"
     PROCESS_ORCHESTRATION = "ProcessOrchestration"
     INTEGRATION = "Integration"
+    INTERNAL = "Internal"
     UNKNOWN = "Unknown"  # fallback branch discriminator
 
 
+class AgentInternalToolType(str, Enum):
+    """Agent internal tool type enumeration."""
+
+    ANALYZE_FILES = "analyze-attachments"
+
+
 class AgentEscalationRecipientType(str, Enum):
     """Agent escalation recipient type enumeration."""
 
@@ -343,6 +350,14 @@ class AgentIntegrationToolProperties(BaseResourceProperties):
     )
 
 
+class AgentInternalToolProperties(BaseResourceProperties):
+    """Agent internal tool properties model."""
+
+    tool_type: Literal[AgentInternalToolType.ANALYZE_FILES] = Field(
+        ..., alias="toolType"
+    )
+
+
 class AgentIntegrationToolResourceConfig(BaseAgentToolResourceConfig):
     """Agent integration tool resource configuration model."""
 
@@ -355,6 +370,17 @@ class AgentIntegrationToolResourceConfig(BaseAgentToolResourceConfig):
     output_schema: Optional[Dict[str, Any]] = Field(None, alias="outputSchema")
 
 
+class AgentInternalToolResourceConfig(BaseAgentToolResourceConfig):
+    """Agent internal tool resource configuration model."""
+
+    type: Literal[AgentToolType.INTERNAL] = AgentToolType.INTERNAL
+    properties: AgentInternalToolProperties
+    settings: Optional[AgentToolSettings] = Field(None)
+    arguments: Optional[Dict[str, Any]] = Field(default_factory=dict)
+    is_enabled: Optional[bool] = Field(None, alias="isEnabled")
+    output_schema: Dict[str, Any] = Field(..., alias="outputSchema")
+
+
 class AgentUnknownToolResourceConfig(BaseAgentToolResourceConfig):
     """Fallback for unknown tool types (parent normalizer sets type='Unknown')."""
 
@@ -367,6 +393,7 @@ class AgentUnknownToolResourceConfig(BaseAgentToolResourceConfig):
     Union[
         AgentProcessToolResourceConfig,
         AgentIntegrationToolResourceConfig,
+        AgentInternalToolResourceConfig,
         AgentUnknownToolResourceConfig,  # when parent sets type="Unknown"
     ],
     Field(discriminator="type"),
@@ -699,6 +726,7 @@ def _normalize_resources(v: Dict[str, Any]) -> None:
             "api": "Api",
             "processorchestration": "ProcessOrchestration",
             "integration": "Integration",
+            "internal": "Internal",
             "unknown": "Unknown",
         }
         CONTEXT_MODE_MAP = {