{"id":"commerce.pack-plan","version":"1.0.0","category":"commerce","description":"Choose the lowest-cost whole-pack combination for a required count with exact prices and explicit pack limits; up to 20 interchangeable offers.","priceMicroUsdc":800,"priceRevision":"2026-09-13-testnet","pricingStatus":"experimental-unbenchmarked","inputSchema":{"type":"object","properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"minorUnitDigits":{"type":"integer","minimum":0,"maximum":6},"requiredUnits":{"type":"integer","minimum":1,"maximum":1000},"offers":{"type":"array","minItems":1,"maxItems":20,"items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"unitsPerPack":{"type":"integer","minimum":1,"maximum":1000},"price":{"type":"string","pattern":"^(0|[1-9]\\d{0,11})(\\.\\d{1,6})?$","maxLength":19},"maxPacks":{"type":"integer","minimum":0,"maximum":1000}},"required":["id","unitsPerPack","price","maxPacks"],"additionalProperties":false}}},"required":["currency","minorUnitDigits","requiredUnits","offers"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"currency":{"type":"string"},"minorUnitDigits":{"type":"number"},"requiredUnits":{"type":"number"},"feasible":{"type":"boolean"},"totalUnits":{"type":["integer","null"]},"excessUnits":{"type":["integer","null"]},"itemSubtotal":{"type":["string","null"]},"packCount":{"type":["integer","null"]},"lines":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"packs":{"type":"number"},"units":{"type":"number"},"lineSubtotal":{"type":"string"}},"required":["id","packs","units","lineSubtotal"],"additionalProperties":false}},"scope":{"type":"string"}},"required":["currency","minorUnitDigits","requiredUnits","feasible","totalUnits","excessUnits","itemSubtotal","packCount","lines","scope"],"additionalProperties":false},"example":{"currency":"USD","minorUnitDigits":2,"requiredUnits":12,"offers":[{"id":"six-pack","unitsPerPack":6,"price":"7.99","maxPacks":10},{"id":"ten-pack","unitsPerPack":10,"price":"11.99","maxPacks":10}]},"limits":{"inputBytes":131072,"outputBytes":65536,"networkTimeoutMs":0},"network":false,"sensitive":false,"route":"/v1/tools/commerce.pack-plan","priceMicroUsd":800,"page":"https://agent-utilities.agent-utilities.workers.dev/tools/commerce.pack-plan","execution":{"method":"POST","url":"https://agent-utilities.agent-utilities.workers.dev/v1/tools/commerce.pack-plan","requiredHeaders":{"Authorization":"Bearer <private API key>","Idempotency-Key":"<Unix milliseconds>_<UUID>","Content-Type":"application/json"},"optionalHeaders":{"X-Max-Credit-Micro-Usd":"800"},"priceLimit":"Optional prepaid-credit ceiling, integer 0–999999999999. HTTP 412 rejects a new reservation above the ceiling without debit. Existing matching retries make no new reservation; zero permits recovery only. Applies to HTTP and MCP tools/call, not crypto.","recovery":"Retry the exact tool, input and request ID within ten minutes. Do not create a new ID after an uncertain result."}}