Agent Spend Guard — owner-set purchasing guardrails

{'type': 'object', 'title': 'SpendGuardCheckPurchaseInput', 'required': ['merchant', 'amount_usd'], 'properties': {'tx_ref': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'title': 'Tx Ref', 'default': None, 'description': 'Optional idempotency key for this purchase; pass the same value to the record call afterwards. Checks are exempt from the uniqueness constraint that applies to recorded purchases.'}, 'category': {'anyOf': [{'type': 'string', 'maxLength': 100}, {'type': 'null'}], 'title': 'Category', 'default': None}, 'currency': {'type': 'string', 'title': 'Currency', 'default': 'USD', 'maxLength': 8, 'description': 'USD only. Kept for forward compatibility; any other value is rejected.'}, 'merchant': {'type': 'string', 'title': 'Merchant', 'maxLength': 200, 'minLength': 1}, 'amount_usd': {'anyOf': [{'type': 'number', 'maximum': 100000.0, 'exclusiveMinimum': 0.0}, {'type': 'string', 'pattern': '^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$'}], 'title': 'Amount Usd'}, 'description': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}], 'title': 'Description', 'default': None}}, 'description': 'Arguments for ``spend_guard_check_purchase`` (call BEFORE checkout).\n\nThe owner is derived from the authenticated principal, never from the\narguments. ``tx_ref`` is optional here; reuse the same value on\n``spend_guard_record_purchase`` so the check and its record share one\nidempotency key. ``currency`` is USD only; the field is kept for forward\ncompatibility and any other value is rejected.', 'additionalProperties': False}

{'type': 'object', 'title': 'SpendGuardRecordPurchaseInput', 'required': ['merchant', 'amount_usd', 'tx_ref'], 'properties': {'tx_ref': {'type': 'string', 'title': 'Tx Ref', 'maxLength': 200, 'minLength': 1, 'description': 'Caller idempotency key, unique across your recorded purchases; replays return the original record.'}, 'category': {'anyOf': [{'type': 'string', 'maxLength': 100}, {'type': 'null'}], 'title': 'Category', 'default': None}, 'check_id': {'anyOf': [{'type': 'string', 'format': 'uuid'}, {'type': 'null'}], 'title': 'Check Id', 'default': None, 'description': 'Optional id from spend_guard_check_purchase; at most one record may consume each check.'}, 'currency': {'type': 'string', 'title': 'Currency', 'default': 'USD', 'maxLength': 8, 'description': 'USD only. Kept for forward compatibility; any other value is rejected.'}, 'merchant': {'type': 'string', 'title': 'Merchant', 'maxLength': 200, 'minLength': 1}, 'amount_usd': {'anyOf': [{'type': 'number', 'maximum': 100000.0, 'exclusiveMinimum': 0.0}, {'type': 'string', 'pattern': '^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$'}], 'title': 'Amount Usd'}, 'description': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}], 'title': 'Description', 'default': None}}, 'description': "Arguments for ``spend_guard_record_purchase`` (call AFTER checkout).\n\n``tx_ref`` is required and unique across your recorded purchases;\n``check_id`` optionally links back to the check that preceded the\npurchase. The response's ``recorded_previously`` is true when this\ntx_ref was already in your ledger before this call (an idempotent\nreplay); false on first write. ``currency`` is USD only; the field is\nkept for forward compatibility and any other value is rejected.", 'additionalProperties': False}

{'type': 'object', 'title': 'SpendGuardReportInput', 'properties': {'month': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Month', 'default': None, 'description': 'Optional month filter (YYYY-MM); defaults to the current UTC month.'}}, 'description': 'Arguments for ``spend_guard_report`` (no required arguments).', 'additionalProperties': False}

{'type': 'object', 'title': 'SpendGuardSetRulesInput', 'properties': {'monthly_cap_usd': {'anyOf': [{'type': 'number', 'maximum': 100000.0, 'exclusiveMinimum': 0.0}, {'type': 'string', 'pattern': '^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$'}, {'type': 'null'}], 'title': 'Monthly Cap Usd', 'default': None, 'description': 'Cumulative recorded spend per UTC calendar month at or above which checks deny. Null clears the cap.'}, 'merchant_denylist': {'anyOf': [{'type': 'array', 'items': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'maxItems': 100}, {'type': 'null'}], 'title': 'Merchant Denylist', 'default': None, 'description': 'Exact-match merchant names (case-insensitive) whose purchases are denied, up to 100 entries. Null clears the list.'}, 'per_purchase_threshold_usd': {'anyOf': [{'type': 'number', 'maximum': 100000.0, 'exclusiveMinimum': 0.0}, {'type': 'string', 'pattern': '^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$'}, {'type': 'null'}], 'title': 'Per Purchase Threshold Usd', 'default': None, 'description': 'A single purchase strictly above this amount asks the user first. Null clears the threshold.'}}, 'description': 'Arguments for ``spend_guard_set_rules``.\n\nThe owner is derived from the authenticated principal, never from the\narguments. Full declaration: omit or null a field to clear that rule.', 'additionalProperties': False}