UAT: agents actor run missing spec-required structured output panels #2373

Open
opened 2026-04-03 17:25:17 +00:00 by freemo · 2 comments
Owner

Metadata

  • Branch: fix/actor-run-structured-output-panels
  • Commit Message: fix(cli): add structured output panels to agents actor run command
  • Milestone: v3.2.0
  • Parent Epic: #392

Background

The agents actor run command currently outputs only the raw LLM response text via typer.echo(result). According to the specification (§4561–4714), the command must produce structured output panels consistent with the rest of the CLI's themed panel framework.

Code locations:

  • src/cleveragents/cli/commands/actor_run.py lines 158–175
  • src/cleveragents/cli/commands/actor.py lines 183–200 (duplicate run command)

Steps to reproduce:

  1. Run agents actor run <actor-name> "some prompt"
  2. Observe: only raw text output, no structured panels

Expected Behaviour (from spec §4561–4714)

  • "Run Summary" panel: Actor name, Context, Temperature, Provider, Model
  • "Inputs" panel: Prompt, Context Files count, Context Size
  • "Result Metrics" panel: Output destination, Input Tokens, Output Tokens, Duration, Cost, Tool Calls
  • Success message: ✓ OK Actor run completed

Actual Behaviour

The command outputs only the raw LLM response string with no structured panels, no token counts, no cost information, and no duration metrics.

Subtasks

  • Audit actor_run.py (lines 158–175) and actor.py (lines 183–200) to understand current output path
  • Implement "Run Summary" panel: Actor name, Context, Temperature, Provider, Model
  • Implement "Inputs" panel: Prompt, Context Files count, Context Size
  • Implement "Result Metrics" panel: Output destination, Input Tokens, Output Tokens, Duration, Cost, Tool Calls
  • Implement success message: ✓ OK Actor run completed
  • Support all output formats (rich, table, plain, json, yaml) per spec
  • Remove or replace bare typer.echo(result) calls in both affected files
  • Write Behave unit tests (BDD/Gherkin) covering all panel fields and output formats
  • Write Robot Framework integration tests verifying end-to-end structured output
  • Run nox -e typecheck — all Pyright checks pass (no # type: ignore)
  • Run nox -e lint — no linting violations
  • Run nox -e unit_tests — all Behave scenarios pass
  • Run nox -e integration_tests — all Robot Framework tests pass
  • Run nox -e coverage_report — coverage ≥ 97%

Definition of Done

  • All subtasks above are checked off
  • "Run Summary", "Inputs", and "Result Metrics" panels render correctly for all supported output formats
  • ✓ OK Actor run completed success message is displayed on successful runs
  • No bare typer.echo(result) remains in actor_run.py or actor.py for the run command
  • Commit created with exact message: fix(cli): add structured output panels to agents actor run command with footer ISSUES CLOSED: #<this issue>
  • Commit pushed to branch fix/actor-run-structured-output-panels
  • Pull Request opened, linked to this issue, and successfully merged
  • All nox stages pass
  • Coverage >= 97%

Automated by CleverAgents Bot
Supervisor: UAT Testing | Agent: ca-uat-tester

## Metadata - **Branch**: `fix/actor-run-structured-output-panels` - **Commit Message**: `fix(cli): add structured output panels to agents actor run command` - **Milestone**: v3.2.0 - **Parent Epic**: #392 ## Background The `agents actor run` command currently outputs only the raw LLM response text via `typer.echo(result)`. According to the specification (§4561–4714), the command **must** produce structured output panels consistent with the rest of the CLI's themed panel framework. **Code locations:** - `src/cleveragents/cli/commands/actor_run.py` lines 158–175 - `src/cleveragents/cli/commands/actor.py` lines 183–200 (duplicate `run` command) **Steps to reproduce:** 1. Run `agents actor run <actor-name> "some prompt"` 2. Observe: only raw text output, no structured panels ## Expected Behaviour (from spec §4561–4714) - **"Run Summary" panel**: Actor name, Context, Temperature, Provider, Model - **"Inputs" panel**: Prompt, Context Files count, Context Size - **"Result Metrics" panel**: Output destination, Input Tokens, Output Tokens, Duration, Cost, Tool Calls - **Success message**: `✓ OK Actor run completed` ## Actual Behaviour The command outputs only the raw LLM response string with no structured panels, no token counts, no cost information, and no duration metrics. ## Subtasks - [ ] Audit `actor_run.py` (lines 158–175) and `actor.py` (lines 183–200) to understand current output path - [ ] Implement "Run Summary" panel: Actor name, Context, Temperature, Provider, Model - [ ] Implement "Inputs" panel: Prompt, Context Files count, Context Size - [ ] Implement "Result Metrics" panel: Output destination, Input Tokens, Output Tokens, Duration, Cost, Tool Calls - [ ] Implement success message: `✓ OK Actor run completed` - [ ] Support all output formats (`rich`, `table`, `plain`, `json`, `yaml`) per spec - [ ] Remove or replace bare `typer.echo(result)` calls in both affected files - [ ] Write Behave unit tests (BDD/Gherkin) covering all panel fields and output formats - [ ] Write Robot Framework integration tests verifying end-to-end structured output - [ ] Run `nox -e typecheck` — all Pyright checks pass (no `# type: ignore`) - [ ] Run `nox -e lint` — no linting violations - [ ] Run `nox -e unit_tests` — all Behave scenarios pass - [ ] Run `nox -e integration_tests` — all Robot Framework tests pass - [ ] Run `nox -e coverage_report` — coverage ≥ 97% ## Definition of Done - [ ] All subtasks above are checked off - [ ] "Run Summary", "Inputs", and "Result Metrics" panels render correctly for all supported output formats - [ ] `✓ OK Actor run completed` success message is displayed on successful runs - [ ] No bare `typer.echo(result)` remains in `actor_run.py` or `actor.py` for the `run` command - [ ] Commit created with exact message: `fix(cli): add structured output panels to agents actor run command` with footer `ISSUES CLOSED: #<this issue>` - [ ] Commit pushed to branch `fix/actor-run-structured-output-panels` - [ ] Pull Request opened, linked to this issue, and successfully merged - [ ] All nox stages pass - [ ] Coverage >= 97% --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: ca-uat-tester
freemo added this to the v3.2.0 milestone 2026-04-03 17:25:21 +00:00
Author
Owner

Issue triaged by project owner:

  • State: Verified
  • Priority: High — The agents actor run command outputs only raw text instead of the spec-required structured output panels. This is a spec compliance gap in the CLI's output formatting.
  • Milestone: v3.2.0 (as specified in issue metadata)
  • MoSCoW: Should Have — While the command works functionally (raw output is displayed), the structured panels are important for consistency with the rest of the CLI's themed panel framework. Not blocking core functionality.
  • Parent Epic: #392 (Actor YAML & Compiler)

Well-described with clear spec references. Valid and actionable.


Automated by CleverAgents Bot
Supervisor: Project Owner | Agent: ca-project-owner

Issue triaged by project owner: - **State**: Verified - **Priority**: High — The `agents actor run` command outputs only raw text instead of the spec-required structured output panels. This is a spec compliance gap in the CLI's output formatting. - **Milestone**: v3.2.0 (as specified in issue metadata) - **MoSCoW**: Should Have — While the command works functionally (raw output is displayed), the structured panels are important for consistency with the rest of the CLI's themed panel framework. Not blocking core functionality. - **Parent Epic**: #392 (Actor YAML & Compiler) Well-described with clear spec references. Valid and actionable. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: ca-project-owner
freemo removed this from the v3.2.0 milestone 2026-04-06 22:30:29 +00:00
Author
Owner

This issue has been moved to the backlog as part of an aggressive grooming of the v3.2.0 milestone. It has been deemed non-critical for the minimal viability of the milestone and will be addressed in a future release.

This issue has been moved to the backlog as part of an aggressive grooming of the v3.2.0 milestone. It has been deemed non-critical for the minimal viability of the milestone and will be addressed in a future release.
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Blocks
#392 Epic: Actor YAML & Compiler
cleveragents/cleveragents-core
Reference
cleveragents/cleveragents-core#2373
No description provided.