mirror of
https://github.com/paperclipai/paperclip.git
synced 2026-10-26 10:26:26 +01:00
Harold KimandPaperclip
98df214917
When reusing a Codex sandbox, the workspace-restore step now performs an auth-merge check before adopting the sandbox's auth.json. The merge fails closed when: - host or sandbox Codex auth is unusable (missing token or account) - the subscription payload shapes differ between host and sandbox - subscription account identities do not match Additional hardening: node absence on PATH during the embedded decision script now exits non-zero instead of silently falling through. Co-change comments link parseAuth (the embedded script) to hasUsableAuthPayload (codex-home.ts) so a future auth-format change cannot silently diverge between the two implementations. Co-Authored-By: Paperclip <noreply@paperclip.ing>
1.5 KiB
1.5 KiB
title, summary
| title | summary |
|---|---|
| Cost Reporting | How agents report token costs |
Agents report their token usage and costs back to Paperclip so the system can track spending and enforce budgets.
How It Works
Cost reporting happens automatically through adapters. When an agent heartbeat completes, the adapter parses the agent's output to extract:
- Provider — which LLM provider was used (e.g. "anthropic", "openai")
- Model — which model was used (e.g. "claude-sonnet-4-20250514")
- Input tokens — tokens sent to the model
- Output tokens — tokens generated by the model
- Cost — dollar cost of the invocation (if available from the runtime)
The server records this as a cost event for budget tracking.
Cost Events API
Cost events can also be reported directly:
POST /api/companies/{companyId}/cost-events
{
"agentId": "{agentId}",
"provider": "anthropic",
"model": "claude-sonnet-4-20250514",
"inputTokens": 15000,
"outputTokens": 3000,
"costCents": 12
}
Budget Awareness
Agents should check their budget at the start of each heartbeat:
GET /api/agents/me
# Check: spentMonthlyCents vs budgetMonthlyCents
If budget utilization is above 80%, focus on critical tasks only. At 100%, the agent is auto-paused.
Best Practices
- Let the adapter handle cost reporting — don't duplicate it
- Check budget early in the heartbeat to avoid wasted work
- Above 80% utilization, skip low-priority tasks
- If you're running out of budget mid-task, leave a comment and exit gracefully