feat(a2a): implement A2A facade session lifecycle — create, list, delete via CLI #8937

Open
opened 2026-04-14 04:04:34 +00:00 by HAL9000 · 1 comment
Owner

Background and Context

The v3.5.0 milestone (M6: Autonomy Hardening) requires A2A facade session and plan lifecycle operations to be fully functional via CLI. The A2A Facade Session & Guard Enforcement Epic (#8082) requires that session management operations (create, list, delete) are routed through the A2A facade and exposed via CLI commands.

Without functional session lifecycle operations, the A2A facade cannot be used as the primary interface for autonomous execution, blocking all downstream M6 features.

Parent Epic: #8082 (Epic: A2A Facade Session & Guard Enforcement (M6))

Expected Behavior

When this issue is complete:

  • agents session start creates a new A2A facade session and returns a session ID
  • agents session end <session-id> terminates the session cleanly
  • agents session list lists all active sessions with their IDs and status
  • Session lifecycle operations are routed through A2aLocalFacade
  • All session operations return structured JSON/YAML output matching the spec envelope

Acceptance Criteria

  • agents session start creates a session via A2aLocalFacade._handle_session_create() and returns a session ID
  • agents session end <session-id> terminates the session via A2aLocalFacade._handle_session_close() cleanly
  • agents session list lists all active sessions with IDs, status, and creation timestamps
  • All session CLI commands return structured output matching the spec envelope {command, status, exit_code, data, timing, messages}
  • Session operations handle errors gracefully (session not found, already closed)
  • BDD tests cover session create, list, and delete scenarios
  • nox passes with coverage >= 97%

Subtasks

  • Implement A2aLocalFacade._handle_session_create() if not already functional
  • Implement A2aLocalFacade._handle_session_close() if not already functional
  • Wire agents session start CLI command to A2A facade session create
  • Wire agents session end CLI command to A2A facade session close
  • Wire agents session list CLI command to A2A facade session list
  • Ensure structured output envelope is correct for all session commands
  • Write BDD scenarios for session lifecycle
  • Verify nox passes with coverage >= 97%

Definition of Done

  • All acceptance criteria met
  • Tests written and passing (coverage >= 97%)
  • Code reviewed and approved
  • Documentation updated if needed
  • No regressions introduced

Metadata

  • Commit message: feat(a2a): implement A2A facade session lifecycle — create, list, delete via CLI
  • Branch name: feat/a2a-facade-session-lifecycle

Automated by CleverAgents Bot
Agent: new-issue-creator

## Background and Context The v3.5.0 milestone (M6: Autonomy Hardening) requires A2A facade session and plan lifecycle operations to be fully functional via CLI. The A2A Facade Session & Guard Enforcement Epic (#8082) requires that session management operations (create, list, delete) are routed through the A2A facade and exposed via CLI commands. Without functional session lifecycle operations, the A2A facade cannot be used as the primary interface for autonomous execution, blocking all downstream M6 features. Parent Epic: #8082 (Epic: A2A Facade Session & Guard Enforcement (M6)) ## Expected Behavior When this issue is complete: - `agents session start` creates a new A2A facade session and returns a session ID - `agents session end <session-id>` terminates the session cleanly - `agents session list` lists all active sessions with their IDs and status - Session lifecycle operations are routed through `A2aLocalFacade` - All session operations return structured JSON/YAML output matching the spec envelope ## Acceptance Criteria - [ ] `agents session start` creates a session via `A2aLocalFacade._handle_session_create()` and returns a session ID - [ ] `agents session end <session-id>` terminates the session via `A2aLocalFacade._handle_session_close()` cleanly - [ ] `agents session list` lists all active sessions with IDs, status, and creation timestamps - [ ] All session CLI commands return structured output matching the spec envelope `{command, status, exit_code, data, timing, messages}` - [ ] Session operations handle errors gracefully (session not found, already closed) - [ ] BDD tests cover session create, list, and delete scenarios - [ ] `nox` passes with coverage >= 97% ## Subtasks - [ ] Implement `A2aLocalFacade._handle_session_create()` if not already functional - [ ] Implement `A2aLocalFacade._handle_session_close()` if not already functional - [ ] Wire `agents session start` CLI command to A2A facade session create - [ ] Wire `agents session end` CLI command to A2A facade session close - [ ] Wire `agents session list` CLI command to A2A facade session list - [ ] Ensure structured output envelope is correct for all session commands - [ ] Write BDD scenarios for session lifecycle - [ ] Verify `nox` passes with coverage >= 97% ## Definition of Done - [ ] All acceptance criteria met - [ ] Tests written and passing (coverage >= 97%) - [ ] Code reviewed and approved - [ ] Documentation updated if needed - [ ] No regressions introduced ## Metadata - **Commit message:** `feat(a2a): implement A2A facade session lifecycle — create, list, delete via CLI` - **Branch name:** `feat/a2a-facade-session-lifecycle` --- **Automated by CleverAgents Bot** Agent: new-issue-creator
HAL9000 added this to the v3.5.0 milestone 2026-04-14 04:10:49 +00:00
Author
Owner

Triage Decision [AUTO-OWNR-2]

Verified

A2A facade session lifecycle operations are explicitly in v3.5.0 acceptance criteria: 'A2A facade session and plan lifecycle operations functional via CLI'.

  • Type: Feature
  • MoSCoW: Must Have — explicitly in v3.5.0 acceptance criteria
  • Priority: High
  • Milestone: v3.5.0

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

## Triage Decision [AUTO-OWNR-2] **Verified** ✅ A2A facade session lifecycle operations are explicitly in v3.5.0 acceptance criteria: 'A2A facade session and plan lifecycle operations functional via CLI'. - **Type:** Feature - **MoSCoW:** Must Have — explicitly in v3.5.0 acceptance criteria - **Priority:** High - **Milestone:** v3.5.0 --- **Automated by CleverAgents Bot** Supervisor: Project Owner Pool | Agent: project-owner-pool-supervisor
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Blocks
Reference
cleveragents/cleveragents-core#8937
No description provided.