Files
agentic-mobile-control/apps/device-host-agent/host_agent/assignment.py
T
q792602257andClaude Opus 4.6 ec261d57c2 feat: surface task execution progress across Host Agent and Cloud
Host Agent now persists step-level execution detail locally (via a real
TaskMetadataStore/Timeline wired into TaskRunner) and reports a bounded
in-progress snapshot piggybacked on lease renewal. Cloud persists that
snapshot per active assignment and exposes it through the existing task
list/detail query path; Cloud Console renders it as a live badge. Host
Agent's local console gains authenticated, read-only task list and
detail/timeline pages (same-origin, server-rendered) with inlined
screenshots.

Also fixes a pre-existing gap in the shared Timeline: the actual
per-step LLM prompt is now recorded instead of the task goal, benefiting
both Runtime and Host Agent consoles. When a host uses the cloud planner
transport, each decide call's prompt and resulting tool decision are
durably logged in a new planner_decision_log table (with bounded
retention) and browsable from Cloud Console; direct-transport hosts
explicitly surface a "not reported" state.

Includes Alembic migrations 0008 (progress columns on scheduled_tasks)
and 0009 (planner_decision_log), bounded Host-Agent-local retention,
dual-backend repository parity, and Vitest + pytest coverage. Task 6.5
(manual end-to-end device verification) remains.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-07-14 12:47:49 +08:00

106 lines
3.9 KiB
Python

from __future__ import annotations
from collections.abc import Callable
from dataclasses import dataclass, field
from typing import Any
from cloud.internal_api.models import AssignmentModel
from core.models import Task
from host_agent.execution import ExecutionFactories
from host_agent.planner_context import bind_planner_execution_context
from host_agent.progress import TaskProgressHolder, TaskProgressSnapshot
@dataclass(frozen=True)
class AssignmentExecutionResult:
status: str
failure_reason: str | None = None
metadata: dict[str, Any] = field(default_factory=dict)
class AssignmentExecutor:
def __init__(self, factories: ExecutionFactories) -> None:
self.factories = factories
self._progress = TaskProgressHolder()
def latest_progress(self) -> TaskProgressSnapshot | None:
"""Latest step progress reported by the currently-running assignment."""
return self._progress.snapshot()
def execute(
self,
assignment: AssignmentModel,
*,
should_stop: Callable[[], bool] | None = None,
) -> AssignmentExecutionResult:
self._progress.clear()
with bind_planner_execution_context(assignment):
if should_stop is not None and should_stop():
return AssignmentExecutionResult(
status="failed",
failure_reason="execution interrupted",
)
if assignment.workflow_definition_id is not None:
return self._execute_workflow(assignment, should_stop=should_stop)
if assignment.goal is not None:
return self._execute_goal(assignment, should_stop=should_stop)
return AssignmentExecutionResult(
status="failed",
failure_reason="assignment has neither goal nor workflow definition",
)
def _execute_goal(
self,
assignment: AssignmentModel,
*,
should_stop: Callable[[], bool] | None,
) -> AssignmentExecutionResult:
task = Task(goal=assignment.goal or "", device_id=assignment.device_id)
runner = self.factories.task_runner_factory()
runner.on_step_progress = self._progress.update
if should_stop is None:
completed = runner.run(task)
else:
completed = runner.run(task, should_stop=should_stop)
return AssignmentExecutionResult(
status="done" if completed.status == "completed" else "failed",
failure_reason=completed.failure_reason,
metadata={
"runtime_task_id": completed.id,
"runtime_status": completed.status,
},
)
def _execute_workflow(
self,
assignment: AssignmentModel,
*,
should_stop: Callable[[], bool] | None,
) -> AssignmentExecutionResult:
definition_id = assignment.workflow_definition_id or ""
definition = self.factories.workflow_store.get_definition(definition_id)
if definition is None:
return AssignmentExecutionResult(
status="failed",
failure_reason=f"unknown workflow definition {definition_id!r}",
)
runner = self.factories.workflow_runner_factory()
if should_stop is None:
run = runner.run(definition, device_id=assignment.device_id)
else:
run = runner.run(
definition,
device_id=assignment.device_id,
should_stop=should_stop,
)
return AssignmentExecutionResult(
status="done" if run.status == "completed" else "failed",
failure_reason=(
None if run.status == "completed" else f"workflow ended as {run.status}"
),
metadata={
"workflow_run_id": run.id,
"workflow_status": run.status,
},
)