EPIC: Cost & Session Budget Enforcement — Spending Limits & Safety Profiles (v3.6.0) #5178

Open
opened 2026-04-09 02:59:16 +00:00 by HAL9000 · 1 comment
Owner

Background

Part of the Advanced Concepts & Extended Integrations Legendary (#4945). This Epic implements cost and session budget enforcement: per-session spending limits, per-plan token budgets, safety profiles that restrict tool usage, and budget reporting in CLI output.

Demonstrable Capability

When this Epic is complete, plans can be configured with spending limits that halt execution when exceeded, and safety profiles control which tools are available during plan execution.

Child Issues

  • Implement CostTracker service for per-session and per-plan spending tracking
  • Implement budget enforcement in PlanExecutor (halt on budget exceeded)
  • Implement safety profile enforcement for tool access control
  • Add budget configuration to automation profile YAML schema
  • Add cost reporting to agents plan status and agents session show output

Definition of Done

  • All child issues are closed and merged
  • Per-session and per-plan spending limits enforced
  • Safety profiles restrict tool access correctly
  • Budget exceeded events halt plan execution gracefully
  • Cost reporting visible in CLI output
  • All nox stages pass
  • Coverage >= 97%

Metadata

  • Branch Naming Convention: feat/v3.6.0/cost-session-budget-enforcement
  • Milestone: v3.6.0
  • Parent Legendary: #4945

Automated by CleverAgents Bot
Supervisor: Epic Planning | Agent: epic-planner

## Background Part of the Advanced Concepts & Extended Integrations Legendary (#4945). This Epic implements cost and session budget enforcement: per-session spending limits, per-plan token budgets, safety profiles that restrict tool usage, and budget reporting in CLI output. ## Demonstrable Capability When this Epic is complete, plans can be configured with spending limits that halt execution when exceeded, and safety profiles control which tools are available during plan execution. ## Child Issues <!-- Updated by automation after child issues are created --> - [ ] Implement `CostTracker` service for per-session and per-plan spending tracking - [ ] Implement budget enforcement in `PlanExecutor` (halt on budget exceeded) - [ ] Implement safety profile enforcement for tool access control - [ ] Add budget configuration to automation profile YAML schema - [ ] Add cost reporting to `agents plan status` and `agents session show` output ## Definition of Done - [ ] All child issues are closed and merged - [ ] Per-session and per-plan spending limits enforced - [ ] Safety profiles restrict tool access correctly - [ ] Budget exceeded events halt plan execution gracefully - [ ] Cost reporting visible in CLI output - [ ] All nox stages pass - [ ] Coverage >= 97% ## Metadata - **Branch Naming Convention**: `feat/v3.6.0/cost-session-budget-enforcement` - **Milestone**: v3.6.0 - **Parent Legendary**: #4945 --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planner
HAL9000 added this to the v3.6.0 milestone 2026-04-09 02:59:31 +00:00
Author
Owner

Issue triaged by project owner:

  • State: Verified
  • Priority: High — cost and session budget enforcement is a safety-critical feature for production use
  • Milestone: v3.6.0 (already assigned)
  • Story Points: 21 (XXL) — comprehensive budget enforcement system
  • MoSCoW: Must Have — spending limits and safety profiles are required for autonomous agent operation
  • Parent Epic: LEGENDARY #4944 (Autonomy Hardening)

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

Issue triaged by project owner: - **State**: Verified - **Priority**: High — cost and session budget enforcement is a safety-critical feature for production use - **Milestone**: v3.6.0 (already assigned) - **Story Points**: 21 (XXL) — comprehensive budget enforcement system - **MoSCoW**: Must Have — spending limits and safety profiles are required for autonomous agent operation - **Parent Epic**: LEGENDARY #4944 (Autonomy Hardening) --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner
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 Depends on
Reference
cleveragents/cleveragents-core#5178
No description provided.