# Agent Economy OS 2047 — Agent API Skill

This skill provides a remote x402 v2 paid API that evaluates whether an AI agent's proposed action is within caller-provided policies. It is NOT a validator of external evidence, not a risk guarantee, and not permission to spend funds.

## Discovery
- Catalog: https://jzallxzbbdtelcpabfgr.supabase.co/functions/v1/agent-economy-commerce/catalog.json
- API reference: https://jzallxzbbdtelcpabfgr.supabase.co/functions/v1/agent-economy-commerce/openapi.json
- x402 manifest: https://jzallxzbbdtelcpabfgr.supabase.co/functions/v1/agent-economy-commerce/.well-known/x402
- Free demo: https://jzallxzbbdtelcpabfgr.supabase.co/functions/v1/agent-economy-commerce/api/v1/demo
- Free preflight: https://jzallxzbbdtelcpabfgr.supabase.co/functions/v1/agent-economy-commerce/api/v1/preflight
- Paid purchase-policy check: https://jzallxzbbdtelcpabfgr.supabase.co/functions/v1/agent-economy-commerce/api/v1/agent-purchase-policy-check
- Alternate paid endpoint: https://jzallxzbbdtelcpabfgr.supabase.co/functions/v1/agent-economy-commerce/api/v1/decision

## When to use
An agent can call this tool before an action such as a purchase, API call or data export, to compare a proposed action against its owner's explicit maximum budget, domain allowlist, and review threshold. Independent verification of the proposed counterparty is not provided.

## Payment
Price: 0.10 USDC per paid review. Chain: Base Mainnet (eip155:8453). Protocol: x402 v2.
Payment signer must be authorized by the wallet owner. Do not submit or sign a payment unless explicitly allowed by your agent's budget and instructions.
A valid unsigned POST returns HTTP 402 and the PAYMENT-REQUIRED header, which describes the actual chain, amount and payTo wallet. Clients supporting x402 v2 can sign and settle with the declared facilitator. Settlement end-to-end has NOT yet been independently proven, so inspect the payment status and do not retry uncertain transactions without checking the chain.

## Request
POST application/json to /api/v1/decision, or /api/v1/preflight for a free validation.
Example:
{
 "task_id":"agent-123",
 "action":{"kind":"purchase","target_url":"https://example.com/cart","estimated_cost_usdc":"9.99"},
 "policy":{"allowed_kinds":["purchase"],"allowed_domains":["example.com"],"max_cost_usdc":"10.00","review_above_usdc":"5.00","require_evidence":false}
}

## Result
The paid response evaluates only provided policy and returns policy_pass, review_required, or blocked with reason codes and a SHA-256 hash of the evaluation fields. A review_required result must not be treated as authorization to proceed.

## Safety
- Never send API keys, wallet private keys, seed phrases, or credentials.
- Reject URLs outside policies; this API does not fetch target pages.
- Follow the user's explicit spending limits.
- No assumption of endorsement, safety, profit, or regulatory compliance.