cloud-task-progress-visibility Specification

Purpose

Define how the Cloud Control Plane stores and exposes the latest bounded execution-progress summary reported by an active Host Agent assignment.

Requirements

Requirement: Cloud Control Plane exposes the latest in-progress step status for an active assignment

The Cloud Control Plane's existing task query surface SHALL include the latest reported step index, step status, and summary for any assignment that has an in-progress Host Agent execution, alongside the task's existing status fields.

Scenario: An assignment has reported progress

WHEN an operator queries a task that has an active, in-progress assignment with previously reported step progress
THEN the response includes that step's index, status, and summary alongside the task's existing fields

Scenario: An assignment has no reported progress yet

WHEN an operator queries a task whose active assignment has not yet reported any progress
THEN the response omits progress fields rather than showing stale or default values

Scenario: An assignment has reached a terminal state

WHEN an operator queries a task whose assignment has already completed (succeeded or failed)
THEN the response does not present the last in-progress step as current status; the task's terminal status and result take precedence

Requirement: Cloud Console renders live step progress for in-progress tasks

Cloud Console SHALL display the current step index, status, and summary for a task with an active, in-progress Host Agent execution, refreshed on its existing polling interval, without requiring a new push channel.

Scenario: Operator views an in-progress task

WHEN an operator opens a task detail view for a task with an active in-progress assignment
THEN Cloud Console shows the latest known step index, status, and summary, updating on subsequent polls as new progress is reported

Scenario: Operator views a task with no in-progress execution

WHEN an operator opens a task detail view for a queued, terminal, or otherwise not-currently-executing task
THEN Cloud Console does not display stale in-progress step information

Requirement: Cloud Console displays a task's full LLM interaction history

Cloud Console SHALL provide a view, for a given task, listing each persisted planner decision in step order, including its full prompt and resulting decision, sourced from the Cloud Control Plane's persisted planner-decision log.

Scenario: Task has persisted planner decisions

WHEN an operator opens the LLM interaction history view for a task that has one or more persisted planner decisions
THEN Cloud Console shows each decision in step order with its prompt and resulting tool call

Scenario: Task's Host used direct-to-provider transport

WHEN an operator opens the LLM interaction history view for a task whose Host used direct-to-provider transport
THEN Cloud Console indicates that no LLM interaction history is available because the Host does not report it, rather than showing an empty history with no explanation

3.1 KiB Raw Blame History