Back to catalog / Agent workflows

Cap session spend and resume safely

Bound the cost of an unattended research session, inspect state at the cap, and resume only when authorized.

Goal

Goal: Bound the cost of an unattended research session, inspect state at the cap, and resume only when authorized.

Set budget={"type":"limit","max_list_cost":{"currency":"USD","amount":"10"}} when creating the session. [budget]
Monitor spend from session.usage; on budget_reached, stop automatic submissions and inspect session state and events. [budget]
After human approval, resume with sessions.update(session_id, budget={...higher cap...}); verify output and archive. [budget]

At the cap, verify the session is idle with recorded `list_cost`; after raising the budget, the same session resumes.

A request can finish slightly above the cap; a new cap cannot be below spend, so inspect `usage.list_cost` first.

Python 3.11+, Anthropic API key, Managed Agents beta header, and a budget approval policy.

Require authorization to raise caps; test with a small limit and restrict external search tools.

The cap applies to one session, not workspace/org quotas; the request crossing the limit can cause slight overage.

These values describe the upstream repository, not popularity or likes for an individual skill or playbook.

No metrics snapshot is available yet.

License: MIT