fix(platform): move interrupt models from common to resume_triggers

andreiancuta-uipath · claude · andreiancuta-uipath · commit e36cfb4961ab · 2026-07-14T14:30:28.000+03:00
common/interrupt_models.py imported action_center, attachments,
context_grounding, documents, and orchestrator at runtime, forming a
cycle cluster around common — the same layering inversion class that
broke 0.1.89 (only masked by import ordering). The models are HITL
suspend/resume payloads consumed solely by resume_triggers, so they move
into that package; all former upward edges now point downward and the
import-linter contract passes with zero ignores.

The models are importable from uipath.platform.resume_triggers. No
re-export shim in common — an eager one recreates the cycle and a lazy
one still violates the layering contract. Known external usages
(uipath-langchain-python docs/samples/test mocks, POC repos) import from
uipath.platform.common and need a coordinated update; none are published
package sources.

Co-Authored-By: Claude Fable 5 &lt;noreply@anthropic.com&gt;
diff --git a/packages/uipath-platform/src/uipath/platform/common/__init__.py b/packages/uipath-platform/src/uipath/platform/common/__init__.py
@@ -41,34 +41,6 @@
 from ._user_agent import user_agent_value
 from .auth import TokenData
 from .dynamic_schema import jsonschema_to_pydantic
-from .interrupt_models import (
-    CreateBatchTransform,
-    CreateDeepRag,
-    CreateDeepRagRaw,
-    CreateEphemeralIndex,
-    CreateEphemeralIndexRaw,
-    CreateEscalation,
-    CreateTask,
-    DocumentExtraction,
-    DocumentExtractionValidation,
-    InvokeProcess,
-    InvokeProcessRaw,
-    InvokeSystemAgent,
-    WaitBatchTransform,
-    WaitDeepRag,
-    WaitDeepRagRaw,
-    WaitDocumentExtraction,
-    WaitDocumentExtractionValidation,
-    WaitEphemeralIndex,
-    WaitEphemeralIndexRaw,
-    WaitEscalation,
-    WaitIntegrationEvent,
-    WaitJob,
-    WaitJobRaw,
-    WaitSystemAgent,
-    WaitTask,
-    WaitUntil,
-)
 from .paging import PagedResult
 from .timeout import (
     UiPathTimeoutError,
@@ -86,33 +58,7 @@
     "FolderContext",
     "TokenData",
     "UiPathConfig",
-    "CreateTask",
-    "CreateEscalation",
-    "WaitEscalation",
-    "InvokeProcess",
-    "InvokeProcessRaw",
-    "WaitTask",
-    "WaitJob",
-    "WaitJobRaw",
     "PagedResult",
-    "CreateDeepRag",
-    "CreateDeepRagRaw",
-    "WaitDeepRag",
-    "WaitDeepRagRaw",
-    "CreateBatchTransform",
-    "WaitBatchTransform",
-    "DocumentExtraction",
-    "WaitDocumentExtraction",
-    "InvokeSystemAgent",
-    "WaitSystemAgent",
-    "CreateEphemeralIndex",
-    "CreateEphemeralIndexRaw",
-    "WaitEphemeralIndex",
-    "WaitEphemeralIndexRaw",
-    "DocumentExtractionValidation",
-    "WaitDocumentExtractionValidation",
-    "WaitIntegrationEvent",
-    "WaitUntil",
     "RequestSpec",
     "Endpoint",
     "UiPathUrl",
diff --git a/packages/uipath-platform/src/uipath/platform/resume_triggers/__init__.py b/packages/uipath-platform/src/uipath/platform/resume_triggers/__init__.py
@@ -6,6 +6,34 @@
     UiPathResumeTriggerHandler,
     UiPathResumeTriggerReader,
 )
+from .interrupt_models import (
+    CreateBatchTransform,
+    CreateDeepRag,
+    CreateDeepRagRaw,
+    CreateEphemeralIndex,
+    CreateEphemeralIndexRaw,
+    CreateEscalation,
+    CreateTask,
+    DocumentExtraction,
+    DocumentExtractionValidation,
+    InvokeProcess,
+    InvokeProcessRaw,
+    InvokeSystemAgent,
+    WaitBatchTransform,
+    WaitDeepRag,
+    WaitDeepRagRaw,
+    WaitDocumentExtraction,
+    WaitDocumentExtractionValidation,
+    WaitEphemeralIndex,
+    WaitEphemeralIndexRaw,
+    WaitEscalation,
+    WaitIntegrationEvent,
+    WaitJob,
+    WaitJobRaw,
+    WaitSystemAgent,
+    WaitTask,
+    WaitUntil,
+)
 
 __all__ = [
     "UiPathResumeTriggerReader",
@@ -14,4 +42,30 @@
     "PropertyName",
     "TriggerMarker",
     "is_no_content_marker",
+    "CreateBatchTransform",
+    "CreateDeepRag",
+    "CreateDeepRagRaw",
+    "CreateEphemeralIndex",
+    "CreateEphemeralIndexRaw",
+    "CreateEscalation",
+    "CreateTask",
+    "DocumentExtraction",
+    "DocumentExtractionValidation",
+    "InvokeProcess",
+    "InvokeProcessRaw",
+    "InvokeSystemAgent",
+    "WaitBatchTransform",
+    "WaitDeepRag",
+    "WaitDeepRagRaw",
+    "WaitDocumentExtraction",
+    "WaitDocumentExtractionValidation",
+    "WaitEphemeralIndex",
+    "WaitEphemeralIndexRaw",
+    "WaitEscalation",
+    "WaitIntegrationEvent",
+    "WaitJob",
+    "WaitJobRaw",
+    "WaitSystemAgent",
+    "WaitTask",
+    "WaitUntil",
 ]
diff --git a/packages/uipath-platform/src/uipath/platform/resume_triggers/_protocol.py b/packages/uipath-platform/src/uipath/platform/resume_triggers/_protocol.py
@@ -24,7 +24,25 @@
 from uipath.platform.action_center import Task
 from uipath.platform.action_center.tasks import TaskStatus
 from uipath.platform.common._config import UiPathConfig
-from uipath.platform.common.interrupt_models import (
+from uipath.platform.connections import EventArguments
+from uipath.platform.context_grounding import DeepRagStatus, IndexStatus
+from uipath.platform.context_grounding.context_grounding_index import (
+    ContextGroundingIndex,
+)
+from uipath.platform.errors import (
+    BatchTransformFailedException,
+    BatchTransformNotCompleteException,
+    OperationNotCompleteException,
+)
+from uipath.platform.orchestrator.job import JobState
+from uipath.platform.resume_triggers._enums import (
+    ExternalTrigger,
+    ExternalTriggerType,
+    PropertyName,
+    TriggerMarker,
+)
+
+from .interrupt_models import (
     CreateBatchTransform,
     CreateDeepRag,
     CreateDeepRagRaw,
@@ -52,23 +70,6 @@
     WaitTask,
     WaitUntil,
 )
-from uipath.platform.connections import EventArguments
-from uipath.platform.context_grounding import DeepRagStatus, IndexStatus
-from uipath.platform.context_grounding.context_grounding_index import (
-    ContextGroundingIndex,
-)
-from uipath.platform.errors import (
-    BatchTransformFailedException,
-    BatchTransformNotCompleteException,
-    OperationNotCompleteException,
-)
-from uipath.platform.orchestrator.job import JobState
-from uipath.platform.resume_triggers._enums import (
-    ExternalTrigger,
-    ExternalTriggerType,
-    PropertyName,
-    TriggerMarker,
-)
 
 
 def _try_convert_to_json_format(value: str | None) -> Any:
diff --git a/packages/uipath-platform/src/uipath/platform/resume_triggers/interrupt_models.py b/packages/uipath-platform/src/uipath/platform/resume_triggers/interrupt_models.py
diff --git a/packages/uipath-platform/tests/services/test_hitl.py b/packages/uipath-platform/tests/services/test_hitl.py
@@ -18,31 +18,6 @@
 
 from uipath.platform.action_center import Task
 from uipath.platform.action_center.tasks import TaskStatus
-from uipath.platform.common import (
-    CreateBatchTransform,
-    CreateDeepRag,
-    CreateDeepRagRaw,
-    CreateEphemeralIndex,
-    CreateEphemeralIndexRaw,
-    CreateTask,
-    DocumentExtraction,
-    DocumentExtractionValidation,
-    InvokeProcess,
-    InvokeProcessRaw,
-    InvokeSystemAgent,
-    WaitBatchTransform,
-    WaitDeepRag,
-    WaitDeepRagRaw,
-    WaitDocumentExtractionValidation,
-    WaitEphemeralIndex,
-    WaitEphemeralIndexRaw,
-    WaitIntegrationEvent,
-    WaitJob,
-    WaitJobRaw,
-    WaitSystemAgent,
-    WaitTask,
-    WaitUntil,
-)
 from uipath.platform.connections import Connection
 from uipath.platform.context_grounding import (
     BatchTransformCreationResponse,
@@ -70,10 +45,33 @@
 from uipath.platform.orchestrator import Job, JobErrorInfo
 from uipath.platform.orchestrator.job import JobState
 from uipath.platform.resume_triggers import (
+    CreateBatchTransform,
+    CreateDeepRag,
+    CreateDeepRagRaw,
+    CreateEphemeralIndex,
+    CreateEphemeralIndexRaw,
+    CreateTask,
+    DocumentExtraction,
+    DocumentExtractionValidation,
+    InvokeProcess,
+    InvokeProcessRaw,
+    InvokeSystemAgent,
     PropertyName,
     TriggerMarker,
     UiPathResumeTriggerCreator,
     UiPathResumeTriggerReader,
+    WaitBatchTransform,
+    WaitDeepRag,
+    WaitDeepRagRaw,
+    WaitDocumentExtractionValidation,
+    WaitEphemeralIndex,
+    WaitEphemeralIndexRaw,
+    WaitIntegrationEvent,
+    WaitJob,
+    WaitJobRaw,
+    WaitSystemAgent,
+    WaitTask,
+    WaitUntil,
 )
 
 
diff --git a/packages/uipath/tests/cli/unit/test_runtime_protocol_compat.py b/packages/uipath/tests/cli/unit/test_runtime_protocol_compat.py
@@ -9,8 +9,7 @@
     UiPathResumeTriggerName,
     UiPathResumeTriggerType,
 )
-from uipath.platform.common import WaitUntil
-from uipath.platform.resume_triggers import UiPathResumeTriggerHandler
+from uipath.platform.resume_triggers import UiPathResumeTriggerHandler, WaitUntil
 from uipath.runtime import (
     UiPathExecuteOptions,
     UiPathResumableRuntime,
diff --git a/packages/uipath/uv.lock b/packages/uipath/uv.lock
