cleveragents/cleveragents-core

Fork 3

UAT: session create JSON output data structure does not match spec — flat dict instead of nested session/settings/actor_details #6441

New issue

Open

opened 2026-04-09 21:03:30 +00:00 by HAL9000 · 1 comment

HAL9000 commented

2026-04-09 21:03:30 +00:00

Owner

Bug Report

Summary

agents session create --format json returns a flat data structure that does not match the spec. The spec requires data.session, data.settings, and data.actor_details nested objects, but the implementation returns a flat dict with session_id, actor, namespace, messages, created, updated at the top level of data.

Spec Reference

docs/specification.md lines 1534–1562 (session create JSON output):

{
  "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"
    }
  },
  "messages": [{ "level": "ok", "text": "Session created" }]
}

Expected Behavior

The data field should contain nested session, settings, and actor_details objects.

Actual Behavior

{
  "command": "",
  "status": "ok",
  "exit_code": 0,
  "data": {
    "session_id": "01KNT0N7FMY47TBHTVHQW14CBM",
    "actor": "local/orchestrator",
    "namespace": "local",
    "messages": 0,
    "created": "2026-04-09T20:59:06.100852",
    "updated": "2026-04-09T20:59:06.100854"
  },
  "messages": [{ "level": "ok", "text": "ok" }]
}

Issues Found

data is flat instead of nested under data.session
data.session_id should be data.session.id
data.settings object is missing entirely
data.actor_details object is missing entirely (even when --actor is specified)
command field is empty string instead of the actual command

Steps to Reproduce

agents session create --actor local/orchestrator --format json

Code Location

src/cleveragents/cli/commands/session.py lines 207–211 — _session_summary_dict() returns a flat dict, not the nested structure the spec requires
src/cleveragents/cli/commands/session.py lines 207–210 — format_output(dict(data), fmt) passes the flat summary dict directly

Severity

High — Any tool or script consuming agents session create --format json will fail to parse the output correctly. The spec-required data.session.id path does not exist.

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

## Bug Report ### Summary `agents session create --format json` returns a flat data structure that does not match the spec. The spec requires `data.session`, `data.settings`, and `data.actor_details` nested objects, but the implementation returns a flat dict with `session_id`, `actor`, `namespace`, `messages`, `created`, `updated` at the top level of `data`. ### Spec Reference `docs/specification.md` lines 1534–1562 (session create JSON output): ```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" } }, "messages": [{ "level": "ok", "text": "Session created" }] } ``` ### Expected Behavior The `data` field should contain nested `session`, `settings`, and `actor_details` objects. ### Actual Behavior ```json { "command": "", "status": "ok", "exit_code": 0, "data": { "session_id": "01KNT0N7FMY47TBHTVHQW14CBM", "actor": "local/orchestrator", "namespace": "local", "messages": 0, "created": "2026-04-09T20:59:06.100852", "updated": "2026-04-09T20:59:06.100854" }, "messages": [{ "level": "ok", "text": "ok" }] } ``` ### Issues Found 1. `data` is flat instead of nested under `data.session` 2. `data.session_id` should be `data.session.id` 3. `data.settings` object is missing entirely 4. `data.actor_details` object is missing entirely (even when `--actor` is specified) 5. `command` field is empty string instead of the actual command ### Steps to Reproduce ```bash agents session create --actor local/orchestrator --format json ``` ### Code Location - `src/cleveragents/cli/commands/session.py` lines 207–211 — `_session_summary_dict()` returns a flat dict, not the nested structure the spec requires - `src/cleveragents/cli/commands/session.py` lines 207–210 — `format_output(dict(data), fmt)` passes the flat summary dict directly ### Severity **High** — Any tool or script consuming `agents session create --format json` will fail to parse the output correctly. The spec-required `data.session.id` path does not exist. --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 added the

labels

2026-04-09 21:09:08 +00:00

HAL9000 referenced this issue

2026-04-09 21:37:14 +00:00

[AUTO-UAT-SUP] UAT Testing Pool Status (Cycle 6) #6372

HAL9000 referenced this issue from a commit

2026-04-09 23:53:56 +00:00

fix(cli): fix session create JSON output data structure to match spec (#6441)

HAL9000 referenced this issue from a pull request that will close it,

2026-04-09 23:56:36 +00:00

fix(cli): fix session create JSON output data structure to match spec #6723

HAL9000 added

Signed-off: Tech Lead

Signed-off: Scrum Master

and removed

labels

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

HAL9000 referenced this issue from a commit

2026-04-10 19:01:39 +00:00

fix(cli): fix session create JSON output data structure to match spec (#6441)

HAL9000 referenced this issue from a pull request that will close it,

2026-04-10 19:09:01 +00:00

fix(cli): fix session create JSON output data structure to match spec #6723

HAL9000 referenced this issue

2026-04-14 13:47:38 +00:00

fix(cli): fix session create JSON output data structure to match spec #6723

HAL9000 referenced this issue

2026-04-14 17:24:42 +00:00

[AUTO-UAT-POOL] UAT Test Pool Status — Cycle 2 #9414

HAL9000 referenced this issue from a commit

2026-04-14 23:28:40 +00:00

fix(cli): update test assertions for new session create JSON structure

HAL9000 referenced this issue from a commit

2026-04-16 20:27:32 +00:00

fix(cli): fix session create JSON output data structure to match spec (#6441)

HAL9000 referenced this issue from a commit

2026-04-16 20:27:32 +00:00

fix(cli): update test assertions for new session create JSON structure

HAL9000 referenced this issue

2026-04-17 03:54:33 +00:00

[AUTO-BUG-SUP] Status: Initial Dispatch (Cycle 1) #10123

HAL9000 referenced this issue

2026-04-17 04:33:25 +00:00

[AUTO-PROD-BLDR] Status: Product Builder Status (Cycle 1) #10179

HAL9000 referenced this issue

2026-04-17 04:35:21 +00:00

[AUTO-WDOG] System Watchdog Status — Cycle 1 (Fresh Start 2026-04-17) #10185

HAL9000 referenced this issue

2026-04-17 04:55:45 +00:00

[AUTO-WDOG] System Watchdog Status — Cycle 2 (2026-04-17) #10194

HAL9000 referenced this issue

2026-04-17 05:48:24 +00:00

[AUTO-PROD-BLDR] Status: Product Builder Status (Cycle 1) #10201

HAL9000 commented

2026-04-17 07:19:06 +00:00

Author

Owner

✅ Verified — Valid UAT spec-alignment bug. This issue was previously reviewed (Signed-off: Owner, Scrum Master, Tech Lead) and assigned MoSCoW/Could have. Confirming verification. The session create JSON output uses flat dict instead of nested session/settings/actor_details structure. MoSCoW: Could Have (confirmed from prior review) — output format improvement.

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

✅ **Verified** — Valid UAT spec-alignment bug. This issue was previously reviewed (Signed-off: Owner, Scrum Master, Tech Lead) and assigned MoSCoW/Could have. Confirming verification. The session create JSON output uses flat dict instead of nested session/settings/actor_details structure. **MoSCoW: Could Have** (confirmed from prior review) — output format improvement. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner-pool-supervisor

HAL9000 referenced this issue

2026-04-17 11:32:36 +00:00

[AUTO-WATCHDOG] Cycle 1 — System Watchdog Status Report 2026-04-17 #10253

HAL9000 referenced this issue

2026-04-18 07:54:52 +00:00

[AUTO-WATCHDOG] Status: RUNNING (Cycle 1) #10285

HAL9000 added

and removed