UAT: `agents session tell` missing `--format` option — spec requires JSON/YAML/plain output support #4874

New issue

Open

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

HAL9000 commented

2026-04-08 20:11:24 +00:00

Owner

Bug Report

Feature Area: Session Management — agents session tell
Severity: Medium
Found by: UAT tester, code analysis

What Was Tested

The agents session tell command's output format options were compared against the specification.

Expected Behavior (from spec)

Per docs/specification.md §agents session tell, the command supports multiple output formats. The spec shows JSON output:

{
  "command": "agents session tell --session 01HXM2A6K1 --stream \"What files were changed in the last plan?\"",
  "status": "ok",
  "exit_code": 0,
  "data": {
    "session": { "id": "...", "actor": "local/orchestrator", "mode": "streaming" },
    "response": "...",
    "usage": { "tokens": 1240, "duration_s": 3.1, "tool_calls": 2 }
  },
  "timing": { "duration_ms": 3100 },
  "messages": [{ "level": "ok", "text": "Stream complete" }]
}

All other agents session subcommands (create, list, show, delete, export) support --format json|yaml|plain|table|rich.

Actual Behavior

The tell command signature in src/cleveragents/cli/commands/session.py (lines 792–864):

def tell(
    prompt: str,
    session_id: str,
    actor: str | None = None,
    stream: bool = False,
) -> None:

There is no --format option. The command always outputs in rich/plain format and cannot produce machine-readable JSON or YAML output. This breaks scripting and automation use cases.

Code Location

src/cleveragents/cli/commands/session.py, lines 792–864 (tell function)

Steps to Reproduce

# Try to get JSON output from session tell
agents session tell --session <ID> --format json "Hello"
# Error: No such option: --format

Impact

Breaks automation scripts that parse session tell output
Inconsistent with all other session subcommands which support --format
Cannot integrate session tell into CI/CD pipelines that expect structured output

Definition of Done

session tell accepts --format json|yaml|plain|rich option
JSON output matches the spec structure: data.session, data.response, data.usage
YAML output matches the spec structure
Plain output matches the spec structure

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

## Bug Report **Feature Area:** Session Management — `agents session tell` **Severity:** Medium **Found by:** UAT tester, code analysis --- ### What Was Tested The `agents session tell` command's output format options were compared against the specification. ### Expected Behavior (from spec) Per `docs/specification.md` §`agents session tell`, the command supports multiple output formats. The spec shows JSON output: ```json { "command": "agents session tell --session 01HXM2A6K1 --stream \"What files were changed in the last plan?\"", "status": "ok", "exit_code": 0, "data": { "session": { "id": "...", "actor": "local/orchestrator", "mode": "streaming" }, "response": "...", "usage": { "tokens": 1240, "duration_s": 3.1, "tool_calls": 2 } }, "timing": { "duration_ms": 3100 }, "messages": [{ "level": "ok", "text": "Stream complete" }] } ``` All other `agents session` subcommands (`create`, `list`, `show`, `delete`, `export`) support `--format json|yaml|plain|table|rich`. ### Actual Behavior The `tell` command signature in `src/cleveragents/cli/commands/session.py` (lines 792–864): ```python def tell( prompt: str, session_id: str, actor: str | None = None, stream: bool = False, ) -> None: ``` There is **no `--format` option**. The command always outputs in rich/plain format and cannot produce machine-readable JSON or YAML output. This breaks scripting and automation use cases. ### Code Location `src/cleveragents/cli/commands/session.py`, lines 792–864 (`tell` function) ### Steps to Reproduce ```bash # Try to get JSON output from session tell agents session tell --session <ID> --format json "Hello" # Error: No such option: --format ``` ### Impact - Breaks automation scripts that parse `session tell` output - Inconsistent with all other `session` subcommands which support `--format` - Cannot integrate `session tell` into CI/CD pipelines that expect structured output ### Definition of Done - [ ] `session tell` accepts `--format json|yaml|plain|rich` option - [ ] JSON output matches the spec structure: `data.session`, `data.response`, `data.usage` - [ ] YAML output matches the spec structure - [ ] Plain output matches the spec structure --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 referenced this issue

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

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

HAL9000 referenced this issue

2026-04-08 20:16:04 +00:00

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

HAL9000 added this to the v3.3.0 milestone

2026-04-08 20:17:17 +00:00

HAL9000 referenced this issue

2026-04-08 20:19:20 +00:00

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

HAL9000 referenced this issue