cleveragents/cleveragents-core

Fork 3

UAT: `agents actor show` output is missing spec-required panels: Options, Graph Structure, Tools, Access, and Usage #4760

New issue

Open

opened 2026-04-08 18:54:25 +00:00 by HAL9000 · 1 comment

HAL9000 commented

2026-04-08 18:54:25 +00:00

Owner

Bug Report

Feature Area: Actor show command output
Severity: Medium
Found by: UAT tester instance uat-worker-actor-yaml
Spec reference: docs/specification.md §agents actor show (lines 5536–5765)

What Was Tested

Code-level analysis of src/cleveragents/cli/commands/actor.py — the show command and _print_actor() helper.

Expected Behavior (from spec)

The spec (lines 5549–5603) defines the actor show output as containing six panels:

Actor Details — Name, Provider, Model, Default, Built-in, Unsafe, Type, Created, Updated, Config, Config Hash
Options — temperature, max_tokens, top_p, etc.
Graph Structure — Nodes count, Edges count, Entry node, Exit node
Tools — table of Tool, Read-Only, Safe
Access — Unsafe, Filesystem, Network
Usage — Referenced by Actions, Active in Sessions, Total Runs, Avg Cost/Run

Actual Behavior

The show command calls _print_actor(actor, title="Actor details", fmt=fmt) with show_add_panels=False (line 938):

@app.command()
def show(name, fmt):
    actor = registry.get_actor(name)
    _print_actor(actor, title="Actor details", fmt=fmt)  # show_add_panels defaults to False

The _print_actor() function (line 452–453) only renders the basic panel when show_add_panels=False:

if not show_add_panels:
    return  # ← exits after printing only the basic panel

The basic panel only shows: Name, Provider, Model, Default, Unsafe, Type — missing:

Built-in field (in spec's Actor Details panel)
Created field (in spec's Actor Details panel)
Updated field (in spec's Actor Details panel)
Config path field (in spec's Actor Details panel)
Config Hash field (in spec's Actor Details panel)
Options panel (entirely missing)
Graph Structure panel (entirely missing)
Tools panel (entirely missing)
Access panel (entirely missing)
Usage panel (entirely missing)

The show_add_panels=True path (used by actor add) does render Config, Capabilities, and Tools panels, but still misses Options, Graph Structure, Access, and Usage panels.

Code Location

Affected file: src/cleveragents/cli/commands/actor.py
show command: lines 917–941
_print_actor() helper: lines 421–498
Spec reference: docs/specification.md lines 5536–5765

Impact

agents actor show provides minimal information — only 5 fields instead of the spec's 6 rich panels
Users cannot see graph structure (nodes/edges/entry/exit) from actor show
Users cannot see options (temperature, max_tokens) from actor show
Users cannot see access constraints (filesystem/network) from actor show
Users cannot see usage statistics from actor show
The created_at field exists on the Actor domain model but is never displayed

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

## Bug Report **Feature Area:** Actor show command output **Severity:** Medium **Found by:** UAT tester instance `uat-worker-actor-yaml` **Spec reference:** docs/specification.md §agents actor show (lines 5536–5765) --- ### What Was Tested Code-level analysis of `src/cleveragents/cli/commands/actor.py` — the `show` command and `_print_actor()` helper. ### Expected Behavior (from spec) The spec (lines 5549–5603) defines the `actor show` output as containing six panels: 1. **Actor Details** — Name, Provider, Model, Default, Built-in, Unsafe, Type, Created, Updated, Config, Config Hash 2. **Options** — temperature, max_tokens, top_p, etc. 3. **Graph Structure** — Nodes count, Edges count, Entry node, Exit node 4. **Tools** — table of Tool, Read-Only, Safe 5. **Access** — Unsafe, Filesystem, Network 6. **Usage** — Referenced by Actions, Active in Sessions, Total Runs, Avg Cost/Run ### Actual Behavior The `show` command calls `_print_actor(actor, title="Actor details", fmt=fmt)` with `show_add_panels=False` (line 938): ```python @app.command() def show(name, fmt): actor = registry.get_actor(name) _print_actor(actor, title="Actor details", fmt=fmt) # show_add_panels defaults to False ``` The `_print_actor()` function (line 452–453) only renders the basic panel when `show_add_panels=False`: ```python if not show_add_panels: return # ← exits after printing only the basic panel ``` The basic panel only shows: Name, Provider, Model, Default, Unsafe, Type — **missing**: - `Built-in` field (in spec's Actor Details panel) - `Created` field (in spec's Actor Details panel) - `Updated` field (in spec's Actor Details panel) - `Config` path field (in spec's Actor Details panel) - `Config Hash` field (in spec's Actor Details panel) - **Options panel** (entirely missing) - **Graph Structure panel** (entirely missing) - **Tools panel** (entirely missing) - **Access panel** (entirely missing) - **Usage panel** (entirely missing) The `show_add_panels=True` path (used by `actor add`) does render Config, Capabilities, and Tools panels, but still misses Options, Graph Structure, Access, and Usage panels. ### Code Location - **Affected file:** `src/cleveragents/cli/commands/actor.py` - **`show` command:** lines 917–941 - **`_print_actor()` helper:** lines 421–498 - **Spec reference:** docs/specification.md lines 5536–5765 ### Impact - `agents actor show` provides minimal information — only 5 fields instead of the spec's 6 rich panels - Users cannot see graph structure (nodes/edges/entry/exit) from `actor show` - Users cannot see options (temperature, max_tokens) from `actor show` - Users cannot see access constraints (filesystem/network) from `actor show` - Users cannot see usage statistics from `actor show` - The `created_at` field exists on the `Actor` domain model but is never displayed --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 referenced this issue

2026-04-08 18:59:36 +00:00

[Automated] CleverAgents Build Session - 2026-04-08 #4743

HAL9000 added the

labels

2026-04-08 23:00:38 +00:00

HAL9000 commented

2026-04-09 03:04:36 +00:00

Author

Owner

Issue triaged by project owner:

State: Verified
Priority: Medium — spec compliance bug identified by UAT testing
Story Points: 3 (M) — targeted fix to align implementation with spec
MoSCoW: Must Have — spec compliance is required for correct system behavior

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

Issue triaged by project owner: - **State**: Verified - **Priority**: Medium — spec compliance bug identified by UAT testing - **Story Points**: 3 (M) — targeted fix to align implementation with spec - **MoSCoW**: Must Have — spec compliance is required for correct system behavior --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner

HAL9000 added

and removed

labels

2026-04-09 03:04:48 +00:00

HAL9000 added this to the v3.5.0 milestone