# Mini Fast Agent Capacity API

> Permissionless, Seatbelt-isolated AI agent, web/on-chain intelligence, and automated SaaS demo video studio (Playwright + ElevenLabs + FFmpeg) on Apple Silicon M4, payable per call via x402 v2 (USDC on Base or Solana).

## Discovery & Machine Schemas
- x402 Manifest: https://x402.octopio.ai/.well-known/x402
- OpenAPI 3.1 Spec: https://x402.octopio.ai/openapi.json
- Live Capacity Check (free): https://x402.octopio.ai/capacity
- Accepted Settlement Rails: USDC on eip155:8453 -> 0xc80AA89Ede4F63718b433f14Bf3A79EcF00D7FFd; USDC on solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp -> BaaWJ5V6oHjqRSuLXFFKuV1nudyhayY2PvrWrnigD9C6

## How to Call & Pay (x402 Protocol)
1. Send your HTTP request without credentials.
2. Read the `402 Payment Required` response and decode the `PAYMENT-REQUIRED` header.
3. Sign the USDC micropayment with your x402 wallet (AgentCash, @x402/fetch, Coinbase AgentKit) and retry the request with the `PAYMENT-SIGNATURE` header.
4. If spare capacity is temporarily unavailable (`503`), the server rejects BEFORE settlement so you are never charged.

## Paid Capabilities

### Production $0.001 smoke-test agent with live Seatbelt isolation attestation (`POST /v1/smoke-agent`)
- **Price:** $0.001 USDC per call
- **Description:** Ultra-cheap $0.001 USDC end-to-end test agent for verifying x402 payment settlement, deterministic AST tool execution, and real-time macOS XNU Seatbelt sandbox isolation.
- **Example Input:** `{"task":"Verify production readiness and run calc check"}`
- **Example Output:** `{"agent":"pollux-x402-agent-v1","mode":"smoke","engine":"deterministic-react-v1","answer":"Smoke test agent operational (calc check=1017.0, fsJailed=True, localhostBlocked=True).","isolationProof":{"filesystemJailed":true,"localhostBlocked":true,"nicePriority":19}}`

### Isolated multi-tool AI task agent (math, JSON validation, public HTTPS, LLM synthesis) (`POST /v1/agent-task`)
- **Price:** $0.03 USDC per call
- **Description:** Executes structured analytical tasks inside a macOS Seatbelt jail using safe AST math/stats, text/entity extraction, JSON validation, SSRF-hardened HTTPS inspection, and optional LLM synthesis.
- **Example Input:** `{"task":"Compute annualized yield and summarize metrics. calc: round((1250 / 10000) * 100, 2)","data":{"principalUsdc":10000,"netProfitUsdc":1250}}`
- **Example Output:** `{"agent":"pollux-x402-agent-v1","mode":"task","engine":"deterministic-react-v1","answer":"Processed task (11 words). Calculation `round((1250 / 10000) * 100, 2)` = 12.5. JSON valid=True (object).","isolationProof":{"filesystemJailed":true,"localhostBlocked":true,"nicePriority":19}}`

### Fast security & bug audit for code snippets (`POST /v1/code-audit`)
- **Price:** $0.02 USDC per call
- **Description:** Runs an isolated static + heuristic security/bug audit on Python, TypeScript/JS, or SQL snippets inside an offline macOS Seatbelt sandbox.
- **Example Input:** `{"language":"python","code":"def get_user(conn, uid):\n    return conn.execute(f'SELECT * FROM users WHERE id = {uid}').fetchall()"}`
- **Example Output:** `{"riskScore":45,"findings":[{"severity":"high","rule":"sql-injection-interpolation","line":2,"detail":"Interpolated SQL string passed to query execution; use parameterized queries."}],"summary":"1 finding(s) detected (risk score 45/100)."}`

### Extract structured metrics, entities, and clean markdown from raw text (`POST /v1/structured-extract`)
- **Price:** $0.01 USDC per call
- **Description:** Normalizes messy text/HTML/logs and extracts URLs, emails, ISO dates, monetary amounts, and key-value pairs inside an offline Seatbelt jail.
- **Example Input:** `{"text":"Invoice #INV-2049 dated 2026-11-10 for $1,250.00 USD. Contact billing@acme.example or visit https://acme.example/pay."}`
- **Example Output:** `{"wordCount":16,"amounts":["$1,250.00"],"dates":["2026-11-10"],"emails":["billing@acme.example"],"urls":["https://acme.example/pay"],"cleanText":"Invoice #INV-2049 dated 2026-11-10 for $1,250.00 USD. Contact billing@acme.example or visit https://acme.example/pay."}`

### Pre-trade Base (EVM) & Solana (SPL) token security, authority & DEX liquidity scanner (`POST /v1/token-risk-scan`)
- **Price:** $0.005 USDC per call
- **Description:** Performs real-time on-chain RPC inspection (Base bytecode/proxy slots, Solana mint/freeze authorities, top-10 holder concentration) plus live DEX liquidity & volume analysis inside an SSRF-hardened Seatbelt jail.
- **Example Input:** `{"address":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","chain":"solana"}`
- **Example Output:** `{"chain":"solana","address":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","canonicalAsset":"Circle Native USDC (Solana)","riskScore":0,"riskLevel":"low","flags":[{"severity":"info","code":"canonical_token","detail":"Verified canonical asset: Circle Native USDC (Solana)."}]}`

### SSRF-hardened public URL to clean Markdown, metadata, JSON-LD & structured fields (`POST /v1/url-extract`)
- **Price:** $0.01 USDC per call
- **Description:** Fetches any public https:// URL inside a DNS-rebinding-proof Seatbelt jail, strips scripts/ads, and returns clean Markdown, headings, links, JSON-LD metadata, dates, amounts, and requested fields.
- **Example Input:** `{"url":"https://x402.octopio.ai/.well-known/x402","fields":["name","x402Version"],"maxChars":6000}`
- **Example Output:** `{"finalUrl":"https://x402.octopio.ai/.well-known/x402","httpStatus":200,"contentType":"application/json","requestedFields":{"name":"Mini Fast Agent Capacity API","x402Version":2}}`

### Live x402 v2 endpoint readiness, CORS, discovery & PAYMENT-REQUIRED auditor (`POST /v1/x402-probe`)
- **Price:** $0.002 USDC per call
- **Description:** Probes an x402 service or endpoint to verify /.well-known/x402, /openapi.json, CORS exposed headers, live HTTP 402 PAYMENT-REQUIRED challenge decoding, HTTPS resource URL consistency, Solana gasless feePayer, and Bazaar indexing.
- **Example Input:** `{"url":"https://x402.octopio.ai"}`
- **Example Output:** `{"targetOrigin":"https://x402.octopio.ai","readinessScore":100,"grade":"A","recommendations":[]}`