UAT: `agents session create --format json` produces wrong `data` schema #6764

New issue

Open

opened 2026-04-10 02:03:54 +00:00 by HAL9000 · 1 comment

HAL9000 commented

2026-04-10 02:03:54 +00:00

Owner

Background and Context

UAT code analysis of src/cleveragents/cli/commands/session.py for the Session Management feature area revealed that the JSON/YAML output of agents session create does not match the schema defined in docs/specification.md.

Current Behavior

When running agents session create --format json, the implementation calls format_output(dict(_session_summary_dict(session)), fmt). The _session_summary_dict function (lines 113–122 of session.py) builds a flat dict with these keys:

{
  "command": "",
  "status": "ok",
  "exit_code": 0,
  "data": {
    "session_id": "01HXYZ...",
    "actor": "(none)",
    "namespace": "local",
    "messages": 0,
    "created": "2026-...",
    "updated": "2026-..."
  },
  "timing": { "duration_ms": 0 },
  "messages": [...]
}

Key problems:

data.session_id instead of data.session.id
The data section is a flat dict, not nested under data.session
Missing data.settings sub-object (automation, streaming, context, memory, max_history)
Missing data.actor_details sub-object (provider, model, temperature, context_window)

Expected Behavior (from Spec)

Per docs/specification.md §"agents session create" JSON example:

{
  "command": "agents session create --actor local/orchestrator",
  "status": "ok",
  "exit_code": 0,
  "data": {
    "session": {
      "id": "01HXM2A6K1P2E9Q9D4GQ7J4S7Z",
      "actor": "local/orchestrator",
      "created": "2026-02-08T12:44:00Z",
      "namespace": "local"
    },
    "settings": {
      "automation": "review",
      "streaming": "off",
      "context": "default",
      "memory": "enabled",
      "max_history": 50
    },
    "actor_details": {
      "provider": "anthropic",
      "model": "claude-3.5",
      "temperature": 0.7,
      "context_window": "200K tokens"
    }
  },
  "timing": { "duration_ms": 120 },
  "messages": [{ "level": "ok", "text": "Session created" }]
}

Steps to Reproduce

Clone the repository
Run agents init
Run agents session create --format json
Observe: data.session_id (flat key) instead of data.session.id (nested)

Acceptance Criteria

agents session create --format json produces a data object with three sub-keys: session, settings, and actor_details
data.session.id contains the session ULID (not data.session_id)
data.settings contains the five keys: automation, streaming, context, memory, max_history
data.actor_details is present when an actor is bound
Same fix applies to YAML format output

Supporting Information

Source file: src/cleveragents/cli/commands/session.py, function create() (line 170) and _session_summary_dict() (line 113)
Spec reference: docs/specification.md §"agents session create" JSON tab
The format_output() function in formatting.py correctly wraps in an envelope; the issue is the shape of the data dict passed to it

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

## Background and Context UAT code analysis of `src/cleveragents/cli/commands/session.py` for the Session Management feature area revealed that the JSON/YAML output of `agents session create` does not match the schema defined in `docs/specification.md`. ## Current Behavior When running `agents session create --format json`, the implementation calls `format_output(dict(_session_summary_dict(session)), fmt)`. The `_session_summary_dict` function (lines 113–122 of `session.py`) builds a flat dict with these keys: ```json { "command": "", "status": "ok", "exit_code": 0, "data": { "session_id": "01HXYZ...", "actor": "(none)", "namespace": "local", "messages": 0, "created": "2026-...", "updated": "2026-..." }, "timing": { "duration_ms": 0 }, "messages": [...] } ``` Key problems: - `data.session_id` instead of `data.session.id` - The `data` section is a flat dict, not nested under `data.session` - Missing `data.settings` sub-object (`automation`, `streaming`, `context`, `memory`, `max_history`) - Missing `data.actor_details` sub-object (`provider`, `model`, `temperature`, `context_window`) ## Expected Behavior (from Spec) Per `docs/specification.md` §"agents session create" JSON example: ```json { "command": "agents session create --actor local/orchestrator", "status": "ok", "exit_code": 0, "data": { "session": { "id": "01HXM2A6K1P2E9Q9D4GQ7J4S7Z", "actor": "local/orchestrator", "created": "2026-02-08T12:44:00Z", "namespace": "local" }, "settings": { "automation": "review", "streaming": "off", "context": "default", "memory": "enabled", "max_history": 50 }, "actor_details": { "provider": "anthropic", "model": "claude-3.5", "temperature": 0.7, "context_window": "200K tokens" } }, "timing": { "duration_ms": 120 }, "messages": [{ "level": "ok", "text": "Session created" }] } ``` ## Steps to Reproduce 1. Clone the repository 2. Run `agents init` 3. Run `agents session create --format json` 4. Observe: `data.session_id` (flat key) instead of `data.session.id` (nested) ## Acceptance Criteria - `agents session create --format json` produces a `data` object with three sub-keys: `session`, `settings`, and `actor_details` - `data.session.id` contains the session ULID (not `data.session_id`) - `data.settings` contains the five keys: `automation`, `streaming`, `context`, `memory`, `max_history` - `data.actor_details` is present when an actor is bound - Same fix applies to YAML format output ## Supporting Information - Source file: `src/cleveragents/cli/commands/session.py`, function `create()` (line 170) and `_session_summary_dict()` (line 113) - Spec reference: `docs/specification.md` §"agents session create" JSON tab - The `format_output()` function in `formatting.py` correctly wraps in an envelope; the issue is the shape of the `data` dict passed to it --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 added the

labels

2026-04-10 02:04:12 +00:00

HAL9000 added this to the v3.4.0 milestone

2026-04-10 02:04:22 +00:00

HAL9000 referenced this issue

2026-04-10 02:08:40 +00:00

[AUTO-UAT-POOL] UAT Testing Report (Cycle 4) #6758

HAL9000 added

and removed

labels

2026-04-14 07:19:53 +00:00

HAL9000 commented

2026-04-14 07:19:53 +00:00

Author

Owner

✅ Verified — UAT bug: session create JSON output has wrong data schema. MoSCoW: Should-have. Priority: Medium.

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

✅ **Verified** — UAT bug: session create JSON output has wrong data schema. MoSCoW: Should-have. Priority: Medium. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner-pool-supervisor