refactor(runtime): add run DDD boundary skeleton

backend/packages/harness/deerflow/runtime/runs/execution/__init__.py

@@ -0,0 +1,12 @@
+"""Execution contracts for run lifecycle orchestration."""
+
+from .executor import RunExecutor
+from .scheduler import RunExecutionHandle, RunExecutionScheduler
+from .supervisor import RunSupervisor
+
+__all__ = [
+    "RunExecutionHandle",
+    "RunExecutionScheduler",
+    "RunExecutor",
+    "RunSupervisor",
+]

backend/packages/harness/deerflow/runtime/runs/execution/executor.py

@@ -0,0 +1,18 @@
+"""Run executor contract."""
+
+from __future__ import annotations
+
+from typing import Protocol
+
+from ..domain import Run
+
+
+class RunExecutor(Protocol):
+    """Executes one run against the underlying agent or graph runtime."""
+
+    async def execute(self, run: Run) -> None: ...
+
+
+__all__ = [
+    "RunExecutor",
+]

backend/packages/harness/deerflow/runtime/runs/execution/scheduler.py

@@ -0,0 +1,25 @@
+"""Run execution scheduler contract."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Protocol
+
+from ..domain import RunId
+
+
+@dataclass(frozen=True)
+class RunExecutionHandle:
+    run_id: RunId
+
+
+class RunExecutionScheduler(Protocol):
+    """Starts background execution for an accepted run."""
+
+    async def start(self, run_id: RunId) -> RunExecutionHandle: ...
+
+
+__all__ = [
+    "RunExecutionHandle",
+    "RunExecutionScheduler",
+]

backend/packages/harness/deerflow/runtime/runs/execution/supervisor.py

@@ -0,0 +1,18 @@
+"""Run execution supervision contract."""
+
+from __future__ import annotations
+
+from typing import Protocol
+
+from ..domain import CancelAction, RunId
+
+
+class RunSupervisor(Protocol):
+    """Controls lifecycle operations for already scheduled runs."""
+
+    async def cancel(self, run_id: RunId, *, action: CancelAction = CancelAction.interrupt) -> bool: ...
+
+
+__all__ = [
+    "RunSupervisor",
+]