# 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