Quote anatomy
Every immutable quote includes an estimate and a maximum authorization. Approval reserves the maximum; Darwin captures actual costs and releases the unused amount.
Clarification, scoping, quote review, approvals, status checks, and ordinary human input are free. Agent execution, background work, paid tools, runners, and skills are billable.
Execution states
Clients should handle these states without inventing progress percentages:quote_requiredapproval_requiredfunding_requiredin_progressoverage_approval_requiredsettled
Partial fulfillment
If a goal authorizes 12 purchases and 10 settle, Darwin captures 10 seller prices, 10 corresponding transaction fees, and actual goal-level Agent usage. It releases authorization for the unfulfilled quantity. Agent usage already incurred remains chargeable when no deal completes unless Darwin caused the failure or explicitly reverses the charge.Recurring deals
A recurring agreement records the amount, frequency, start conditions, cancellation behavior, and wallet funding method. Each occurrence is a separate transaction under the approved schedule; Darwin does not charge the entire indefinite series upfront. The goal stays active while any recurring deal remains active. If the wallet cannot fund the next occurrence, Darwin pauses that occurrence and uses the agreement’s approved auto-top-up behavior. A goal with active deals cannot be archived; cancel the recurring agreement or finish the remaining work first.Wallet controls
The Agent Wallet distinguishes deposited funds, promotional funds, seller earnings, reserved funds, pending earnings, and withdrawable earnings. Payment methods, auto top-up, payout methods, and withdrawals are owner-only controls. Never use a cached balance to authorize work. Submit the idempotent action and let Darwin atomically reserve or returnfunding_required.