{"openapi":"3.1.0","info":{"title":"Agent-Ready Card — Agent API (starter)","version":"1.0.0-mvp","description":"Demo OpenAPI starter for Agent-Ready Card. Read-only endpoints return public business facts. State-changing and commercially sensitive endpoints are gated, demo-only, and always require human approval.","contact":{"name":"QuantumMind AI"}},"servers":[{"url":"/","description":"Demo MVP"}],"x-agent-doctrine":{"autonomous":false,"human_approval_required_for":["payments","bookings","contracts","outbound_communication","crm_writes","external_side_effects"],"note":"Agent-readable does not mean autonomous. Commercial and state-changing actions require human approval unless explicitly configured later.","disclaimers":["Demo data only. Not legal, tax, financial, medical, or compliance advice.","No guarantee of AI rankings, citations, visibility, or revenue.","Not affiliated with or certified by any third-party platform or standards body."]},"paths":{"/.well-known/agent-card.json":{"get":{"summary":"Public agent card","x-side-effect":"none","responses":{"200":{"description":"Business facts and capabilities"}}}},"/api/agent/capabilities":{"get":{"summary":"List capabilities and approval boundary","x-side-effect":"none","responses":{"200":{"description":"Capabilities document"}}}},"/api/agent/profile/demo":{"get":{"summary":"Full machine-readable demo profile","x-side-effect":"none","responses":{"200":{"description":"Demo profile"}}}},"/api/agent/quote":{"post":{"summary":"Request a non-binding indicative quote (gated, demo-only)","x-side-effect":"none-in-demo","x-requires-human-approval":true,"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"service":{"type":"string"},"notes":{"type":"string"}}}}}},"responses":{"200":{"description":"Agent envelope with non-binding indicative range","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentEnvelope"}}}}}}},"/api/agent/intake":{"post":{"summary":"Submit an intake request (gated, demo-only)","x-side-effect":"none-in-demo","x-requires-human-approval":true,"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"customer_name":{"type":"string"},"need":{"type":"string"},"preferred_window":{"type":"string"},"contact":{"type":"string"}}}}}},"responses":{"202":{"description":"Agent envelope acknowledging intake intent (no side effect)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentEnvelope"}}}}}}}},"components":{"schemas":{"AgentEnvelope":{"type":"object","required":["accepted","request_id","risk_level","requires_human_approval","report","next_safe_actions","evidence_receipt"],"properties":{"accepted":{"type":"boolean"},"request_id":{"type":"string","example":"req_demo_123"},"risk_level":{"type":"string","enum":["low","medium","high"]},"requires_human_approval":{"type":"boolean","example":true},"report":{"type":"object"},"next_safe_actions":{"type":"array","items":{"type":"string"}},"evidence_receipt":{"type":"object"}}}}}}