UAT: `agents tool list` table output missing spec-required `read_only` and `writes` capability columns #4460

New issue

Open

opened 2026-04-08 13:11:08 +00:00 by HAL9000 · 0 comments

HAL9000 commented

2026-04-08 13:11:08 +00:00

Owner

Metadata

Milestone: (none — backlog)
Parent Epic: (tool CLI / MCP tool integration)

Bug Report

What Was Tested

The agents tool list CLI command table output was analyzed against the spec's described output format in docs/specification.md.

Expected Behavior (from spec)

Per docs/specification.md (lines ~8052, ~8081), the agents tool list rich table output should include read_only and writes columns:

│ local/run-migrations       tool        custom   —          ✓            │

The plain-text output shows:

local/run-migrations       tool        custom   -          yes

The JSON output includes:

{ "name": "local/run-migrations", "type": "tool", "source": "custom", "read_only": false, "writes": true }

Actual Behavior

The list_tools() function in src/cleveragents/cli/commands/tool.py renders a table with these columns:

Name, Type, Source, Description, Timeout

The read_only and writes capability columns are completely absent from the table output. The Timeout column is shown instead, which is not present in the spec's table format.

Steps to Reproduce

Register a tool: agents tool add --config ./tools/run-migrations.yaml
Run agents tool list
Observe the table — no read_only or writes columns are shown
Run agents tool list --format json
Observe the JSON — read_only and writes fields are missing from list output

Code Location

src/cleveragents/cli/commands/tool.py — list_tools() function (line ~260-300): table columns defined as Name, Type, Source, Description, Timeout
The spec requires: Name, Type, Source, read_only (✓/—), writes (✓/—)

Impact

Users cannot quickly see the capability metadata (read_only/writes) of tools in the list view, which is critical for understanding tool safety characteristics and planning sandboxed execution. The Timeout column shown instead is less important for quick overview.

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

## Metadata - **Milestone**: *(none — backlog)* - **Parent Epic**: *(tool CLI / MCP tool integration)* ## Bug Report ### What Was Tested The `agents tool list` CLI command table output was analyzed against the spec's described output format in `docs/specification.md`. ### Expected Behavior (from spec) Per `docs/specification.md` (lines ~8052, ~8081), the `agents tool list` rich table output should include `read_only` and `writes` columns: ``` │ local/run-migrations tool custom — ✓ │ ``` The plain-text output shows: ``` local/run-migrations tool custom - yes ``` The JSON output includes: ```json { "name": "local/run-migrations", "type": "tool", "source": "custom", "read_only": false, "writes": true } ``` ### Actual Behavior The `list_tools()` function in `src/cleveragents/cli/commands/tool.py` renders a table with these columns: - **Name**, **Type**, **Source**, **Description**, **Timeout** The `read_only` and `writes` capability columns are **completely absent** from the table output. The `Timeout` column is shown instead, which is not present in the spec's table format. ### Steps to Reproduce 1. Register a tool: `agents tool add --config ./tools/run-migrations.yaml` 2. Run `agents tool list` 3. Observe the table — no `read_only` or `writes` columns are shown 4. Run `agents tool list --format json` 5. Observe the JSON — `read_only` and `writes` fields are missing from list output ### Code Location - `src/cleveragents/cli/commands/tool.py` — `list_tools()` function (line ~260-300): table columns defined as `Name`, `Type`, `Source`, `Description`, `Timeout` - The spec requires: `Name`, `Type`, `Source`, `read_only` (✓/—), `writes` (✓/—) ### Impact Users cannot quickly see the capability metadata (read_only/writes) of tools in the list view, which is critical for understanding tool safety characteristics and planning sandboxed execution. The `Timeout` column shown instead is less important for quick overview. --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 added this to the v3.5.0 milestone

2026-04-08 17:42:23 +00:00

HAL9000 added the