{"openapi":"3.1.0","info":{"title":"AgentRescue API","version":"0.2.1","description":"Rule-based, advisory HTTP/API/MCP failure diagnosis. Fixes are never executed. When x402 is enabled, POST /v1/diagnose requires $0.01 USDC."},"paths":{"/v1/diagnose":{"post":{"operationId":"diagnoseFailure","summary":"Diagnose a sanitized failure","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DiagnoseRequest"}}}},"responses":{"200":{"description":"Diagnosis with gated recovery guidance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Diagnosis"}}}},"400":{"description":"Invalid JSON, system, or missing error text"},"411":{"description":"Content-Length header required"},"413":{"description":"Body exceeds 16 KB or diagnostic text exceeds 8,000 characters"}}}},"/v1/feedback":{"post":{"operationId":"submitOptInFeedback","summary":"Submit minimized outcome feedback","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackRequest"}}}},"responses":{"201":{"description":"Feedback accepted; only category, outcome and timestamp are stored"},"400":{"description":"Explicit opt-in required or fields have invalid types"}}}}},"components":{"schemas":{"DiagnoseRequest":{"type":"object","properties":{"error":{"type":"string","minLength":1,"maxLength":8000},"system":{"type":"string","enum":["http","api","mcp"],"default":"http"}},"required":["error"],"additionalProperties":false},"Diagnosis":{"type":"object","properties":{"system":{"type":"string"},"category":{"type":"string"},"summary":{"type":"string","description":"Generated summary; does not repeat the submitted diagnostic excerpt."},"confidence":{"type":"string","enum":["low","medium","high"]},"confidence_basis":{"type":"string"},"recovery":{"type":"object","properties":{"guidance":{"type":"string"},"risk":{"type":"string","enum":["low","medium","high"]},"requires_human_approval":{"type":"boolean"},"execute_automatically":{"type":"boolean"}},"required":["guidance","risk","requires_human_approval","execute_automatically"]},"evidence":{"type":"object","properties":{"signals":{"type":"array","items":{"type":"string"}},"redacted":{"type":"boolean"}},"required":["signals","redacted"]},"payment":{"type":"object","properties":{"mode":{"type":"string","enum":["disabled","x402-testnet","x402-mainnet"]},"price_usd":{"type":"string","enum":["0.00","0.01"]}},"required":["mode","price_usd"]}},"required":["system","category","summary","confidence","confidence_basis","recovery","evidence","payment"]},"FeedbackRequest":{"type":"object","properties":{"opt_in":{"type":"boolean","const":true},"category":{"type":"string","enum":["authentication","authorization","bad_request","connectivity","dns","gateway","mcp_protocol","not_found","rate_limit","semantic_failure","server_error","timeout","tls","unavailable","unknown"]},"outcome":{"type":"string","enum":["not_resolved","resolved","unsure"]}},"required":["opt_in"],"additionalProperties":false}}},"servers":[{"url":"https://agentrescue-mcp.onrender.com"}]}