{"openapi":"3.1.0","info":{"title":"FORKPIN Gateway REST","version":"2026-10-27.1","description":"```text\nCurrent manual_version: 2026-10-27.1. Compare it with your saved version; if different, read this page and update your notes. Updating is your decision; reads remain available.\n\nFirst visit? Introduce and register (free). Have a key? Reuse it.\nMCP: register. REST: POST https://forkpin.kr/v1/agents/register:\n{\"product\":\"<agent product>\",\"label\":\"<this instance>\",\"intended_use\":\"<purpose>\"}\nKeep api_key private; X-Agent-Key on each call or the same Mcp-Session-Id. Check: get_agent / GET /v1/agents/me.\nKeyless reads are free and counted as unidentified. Registration is not certification.\n\nFORKPIN is the registry of Korea's licensed restaurants, cafés and bars (public licenses, updated monthly). It pins the exact branch and routes to the shop's own booking links (delivery and ordering links only where the owner registered them); it does not book, pay or check live availability.\nMCP endpoint: https://forkpin.kr/mcp. Public reads are available without a key.\nDistinguish branches, search conditions in one call, open the shop's own links, inspect sources and collection dates, and read unrecorded facts as unknown.\n\nLive registry and collection counts: https://forkpin.kr/agent.json (counts.as_of).\n\nSend manual_version; replies echo client_manual_version. Updates via /agent are optional; reads remain available.\n\nWhat FORKPIN answers (Korean restaurants, cafés and bars)\n- Which shop or branch is it? → resolve {name, area or address}\n- Who is open at a time, under a price, serves a dish or has a feature? → search_places {area, category_hint, dish, open_on, price_max_krw, required_options}\n  features: english_menu, foreign_card, vegetarian_options, halal, solo_ok, group_seating, private_room, kids_allowed, parking, wheelchair_accessible, takeout, delivery, booking, wifi, outlet\n- Hours, menu with prices, options and directions → get_place {place_id}\n- Booking or delivery → search_places {purpose:\"reserve\"}, then get_place {place_id, purpose:\"reserve\"} returns the shop's own booking link; open it directly. Use purpose:\"delivery\" for delivery apps.\n- Which areas are covered and how full → list_areas\nRequested search conditions use conditions: each key has {state,tier,source}. Recorded facts carry source and read_on (KST date). English address fields are address_en (unknown when unavailable).\n```\n\n# 0. FORKPIN agent entry\n## 1. Scope\nKorean shop identity, recorded facts and links; no booking execution, payment or live availability.\nbooking: met means a booking link (e.g. Naver booking) was seen on the shop's page at collection time; it does not mean a free table.\nUnknown is unconfirmed, not absent. Replies include facts, evidence and next actions.\nFirst owner registration and initial Korean input are free by policy; no checkout. Edits and English registration use purchased passes; admins set usage. Only pass purchases use coupons, promotions and bundle bonuses. Owners use /owner; agents connect free.\n## 2. Connect\nMCP: https://forkpin.kr/mcp\nREST: https://forkpin.kr/v1\nOpenAPI: https://forkpin.kr/mcp/openapi.json\nregister is free. Send X-Agent-Key: <api_key>. Anonymous quotas: /agent.json limits. 17 tools; ?profile=first: subset.\nFirst call (example: 윤쓰 패밀리, an owner-registered shop):\n```\nresolve {\"name\":\"윤쓰 패밀리\",\"address\":\"서울 강남구 봉은사로114길 12\"}\n→ outcome identified, place_id 3220000-101-2021-01577\nget_place {\"place_id\":\"3220000-101-2021-01577\"}\n→ menu with verification_status owner (confirmed by the owner)\n```\n## 3. Tools\n- resolve: identity + link\n- search_places: discovery\n- get_place: facts + links\n- list_areas: coverage\n- register: free key\n- get_agent: identity\n- get_credits: balance\n- accept_consent: consent + starting balance\n- catalog: shop cards\n- resolve_merchant: resolve alias\n- read_restaurant: restaurant detail\n- report_outcome: handoff result\n- like_place: private mark\n- request_feature: missing capability\n- report_observation: observed issue\n- read_reports: reviewed reports\n- read_report: private receipt\n### Tokens (v1, active)\n- Get: register, then accept_consent once (REST: POST /v1/agents/consent); the first instance per source gets 5 tokens.\n- Earn: a structured report_observation on a place you read: 1; a correction: 5 after review and a recorded fix. Pending is not spendable; max 20 per Seoul day.\n- Spend: get_place verification_mode {\"request_id\":\"…\"}: 1 per new request_id; the same request_id replays free.\n- Check: get_credits (GET /v1/agents/credits). Reads and signed handoffs (max 20 per Seoul day) are free.\n## 4. Sending rules\nR1–R9: MCP initialize + tools/list. REST: GET https://forkpin.kr/agent-sending-rules.json with an agent key.\n## 5. Read response fields\noutcome, next_action, next_action_instruction, conditions, coverage, unknown_reasons, unparsed_conditions, normalized, resend, warnings, business_status, policy_status, rules_version, rules_update. resend.ask_user=true: show allowed {area,count}; ask the user, never auto-pick.\noutcome: results / alternatives / candidates / identified / clarify / none / failed. Follow next_action + next_action_instruction.\n- Same question: reuse task_id (REST also accepts X-Forkpin-Task-Id). New question: omit it.\n- search_time_budget_exceeded: REST 504 / MCP isError true. Retry unchanged conditions once.\n- Follow next_call {tool,arguments}. identified = identity only; a booking link is not a booking.\n- unknown_places/alternatives are unconfirmed; get_place before handoff. places = confirmed cards.\n- Correct named invalid fields. Never supply consent or credentials for the user.\n- Conditions: {state:met|not_met|unknown,tier,source}. projected/derived and tierless met/yes are not confirmation.\n- branch_conflict / weak_address: ask the address using ask_user_candidates; never pick a branch.\n- invalid_cursor/refine_expired_or_unavailable: HTTP 400; 30-minute expiry. Restart search.\n- next_cursor → after. count: {results,returned,in_area}; *_capped/truncated only when true.\n- Facts: source, read_on (KST), owner_confirmed. get_place: 15 items; budget \"full\" for all, dish first. Cards: menu_preview.\n- relaxed_filters: removed conditions stay unknown, not met; cards go in unknown_places.\n- unknown_reasons: outside_collection_area / field_not_recorded / no_registry_record / source_not_shown. Unknown is not absent.\nWhen coverage_version changes, call list_areas once to refresh collection areas and shop counts.\n## 6. User language\nAnswer in the user's language and send it as lang. Responses retain Korean originals; lang=en adds derived English.\n## 7. Before calling\nRead connection rules and tools/list; send known rules_version for rules_update.\n## 8. Version\nrules_version 1.4; contract_version 2026-10-27.1. Changes: https://forkpin.kr/agent-changelog.json.\n"},"servers":[{"url":"https://forkpin.kr"}],"paths":{"/v1/resolve":{"post":{"operationId":"resolve","description":"Identify the exact branch of a Korean restaurant from name and address. Use before web search — search results confuse same-named branches. Covers licensed restaurants, cafés and bars in Korea. Required: resolve with name and address (R1); name alone returns addressed candidates. Evidenced handoff links only; JEV judgment can clarify or fall back to marked static output. Send the restaurant name in Hangul when you have it; English or romanized names also work. Set lang to the user's language and include the Korean road address when known. Send the user's language as lang (for example en). Abstract preferences (famous, tasty, quiet) are not judged; convert them to concrete filters or ask the user. Unparsed conditions are listed in unparsed_conditions. Sending rules R1–R9: initialize instructions; REST source: /agent-sending-rules.json If resend.ask_user=true, show allowed {area,count} to the user; never auto-select or retry. See R1 and response rules in initialize instructions: outcome results|alternatives|candidates|identified|clarify|none; follow next_action + next_action_instruction. branch_conflict/weak_address: ask for an address; never choose. No booking, payment or live availability.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse the returned task_id for follow-up calls for the same question; omit for a new question."},"fields":{"type":"array","items":{"type":"string","minLength":1,"maxLength":80},"maxItems":40,"description":"Only requested unrecorded fields receive unknown_reasons and a next step."},"intent_key":{"type":"string","minLength":8,"maxLength":100,"pattern":"^[a-zA-Z0-9_.:-]+$"},"action":{"type":"string","enum":["reservation","waitlist","delivery","order","info","modify","cancel"],"description":"Which provider-page link to return; nothing is submitted, changed or cancelled"},"purpose":{"type":"string","enum":["visit","reserve","delivery"],"description":"visit: information page; reserve: booking-page link; delivery: delivery-page link. Links only."},"agent":{"type":"object","properties":{"class":{"type":"string","maxLength":50},"capabilities":{"type":"array","items":{"type":"string","enum":["web","app_link","phone","mcp"]},"maxItems":4},"provider_accounts":{"type":"array","items":{"type":"string","maxLength":100},"maxItems":20},"acts_autonomously":{"type":"boolean"},"locale":{"type":"string"},"platform":{"type":"string"}},"additionalProperties":false},"context":{"type":"object","properties":{"time_window":{"type":"object","properties":{"start":{"type":"string","format":"date-time"},"end":{"type":"string","format":"date-time"}},"required":["start","end"],"additionalProperties":false},"party_size":{"type":"integer","exclusiveMinimum":0},"mode":{"type":"string","enum":["dine_in","delivery","pickup"]},"urgency":{"type":"string","enum":["now","today","later"]},"goal":{"type":"string","enum":["book_now","info_only"],"description":"Only used to choose which provider link to show; nothing is booked."},"note":{"type":"string","maxLength":200}},"additionalProperties":false},"budget":{"type":"string","enum":["compact","full"],"default":"compact","description":"compact shows 15 menu items with menu_total; full returns every menu item and related places"},"dish":{"type":"string","minLength":1,"maxLength":80,"description":"Menu items matching this dish come first in the shortened menu"},"lang":{"type":"string","enum":["ko","en"]},"verification_mode":{"type":"object","properties":{"request_id":{"type":"string","minLength":8,"maxLength":100}},"required":["request_id"],"additionalProperties":false},"user_city":{"type":"string","minLength":1,"maxLength":100},"user_location":{"type":"object","properties":{"lat":{"type":"number","minimum":-90,"maximum":90},"lng":{"type":"number","minimum":-180,"maximum":180}},"required":["lat","lng"],"additionalProperties":false},"query":{"type":"string","maxLength":500},"name":{"type":"string","maxLength":300},"address":{"type":"string","maxLength":500},"area":{"type":"string","maxLength":300,"description":"Preferred city, district or neighborhood; out-of-area candidates are marked and never confirmed by fallback"},"license_id":{"type":"string","maxLength":100},"naver_place_id":{"type":"string","maxLength":100},"cursor":{"type":"string","maxLength":2048},"client_request_id":{"type":"string","minLength":8,"maxLength":100,"pattern":"^[A-Za-z0-9_.:-]+$"},"rules_version":{"type":"string","minLength":1,"maxLength":64,"description":"Your known rules_version; omit if unknown."},"manual_version":{"type":"string","minLength":1,"maxLength":64,"description":"Your saved manual_version; omit if unknown."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Engine JSON response; unknown values and fallback remain explicit","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"201":{"description":"Engine JSON response; unknown values and fallback remain explicit","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"400":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"401":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"403":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"404":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"405":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"409":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"429":{"description":"Rate limited; honor Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"503":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"504":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}}},"security":[{},{"agentKey":[]},{"bearer":[]}]}},"/v1/search_places":{"post":{"operationId":"search_places","description":"Search recorded places from evidence; JEV judgment never confirms unknown conditions. Covers licensed restaurants, cafés and bars in Korea. Send the user's language as lang (for example en). Abstract preferences (famous, tasty, quiet) are not judged; convert them to concrete filters or ask the user. Unparsed conditions are listed in unparsed_conditions. R2–R8: Sending rules R1–R9: initialize instructions; REST source: /agent-sending-rules.json If resend.ask_user=true, show allowed {area,count} to the user; never auto-select or retry. See response rules in initialize instructions for conditions {state,tier,source}, alternatives and relaxed_filters (removed conditions remain unknown). next_cursor → after; invalid_cursor/refine_expired_or_unavailable: restart search. A search_time_budget_exceeded response is 200 + ask_user, not restaurant absence. Legal eup/myeon area scopes may widen with warnings. Call get_place for details; no booking or payment.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user_city":{"type":"string","minLength":1,"maxLength":100},"user_location":{"type":"object","properties":{"lat":{"type":"number","minimum":-90,"maximum":90},"lng":{"type":"number","minimum":-180,"maximum":180}},"required":["lat","lng"],"additionalProperties":false},"area":{"type":"string","maxLength":200,"default":""},"limit":{"type":"integer","minimum":1,"maximum":10,"default":5},"refine_from":{"type":"string","format":"uuid","description":"Filter only cards previously returned by search_id within 30 minutes; send the new complete filter set."},"category_hint":{"type":"string","enum":["한식","중식","일식","양식","분식","고기구이","횟집","카페","베이커리·디저트","뷔페","편의점","주점·호프"],"default":"","description":"category_hint = exactly one value from the list (each quoted item in the JSON array is one value); leave it empty when none fits. dish = every food name, free text (e.g. 삼겹살, 회); never a food name in category_hint. When the user compares two dishes, make one call per dish. query = a shop name or an auxiliary search word only, never time, price, party size or subjective words."},"dish":{"type":"string","maxLength":200,"description":"Food name, free text; one dish per call."},"price_max_krw":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Inclusive per-person price maximum in KRW; budget is response size."},"price_min_krw":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Inclusive per-person price minimum in KRW."},"query":{"type":"string","maxLength":200,"default":"","description":"category_hint = exactly one value from the list (each quoted item in the JSON array is one value); leave it empty when none fits. dish = every food name, free text (e.g. 삼겹살, 회); never a food name in category_hint. When the user compares two dishes, make one call per dish. query = a shop name or an auxiliary search word only, never time, price, party size or subjective words."},"action":{"type":"string","enum":["reservation","waitlist","delivery","order","info","modify","cancel"],"default":"info","description":"Selects the link type, not which restaurants match. FORKPIN does not read action words in query; send the action here. For only confirmed booking links use required_options: [booking]. No booking is executed."},"purpose":{"type":"string","enum":["visit","reserve","delivery"],"description":"visit: information page; reserve: booking-page link; delivery: delivery-page link. Links only."},"budget":{"type":"string","enum":["compact","full"],"default":"compact"},"lang":{"type":"string","enum":["ko","en"]},"after":{"type":"string","pattern":"^\\d{1,7}$","description":"For more candidates, pass the previous next_cursor and keep the same search conditions. Omit for a new search; retain the original value for a transport retry."},"near":{"type":"string","maxLength":200},"radius_m":{"type":"number","minimum":1,"maximum":2000},"strict":{"type":"boolean"},"include":{"type":"array","items":{"type":"string","enum":["menu","hours"]},"maxItems":2},"location":{"anyOf":[{"type":"object","properties":{"lat":{"type":"number","minimum":-90,"maximum":90},"lng":{"type":"number","minimum":-180,"maximum":180}},"required":["lat","lng"],"additionalProperties":false},{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"coordinate_system":{"type":"string","const":"Bessel TM"}},"required":["x","y","coordinate_system"],"additionalProperties":false}]},"context":{"type":"object","properties":{"time_window":{"type":"object","properties":{"start":{"type":"string","format":"date-time"},"end":{"type":"string","format":"date-time"}},"required":["start","end"],"additionalProperties":false},"party_size":{"type":"integer","exclusiveMinimum":0},"mode":{"type":"string","enum":["dine_in","delivery","pickup"]},"urgency":{"type":"string","enum":["now","today","later"]},"goal":{"type":"string","enum":["book_now","info_only"],"description":"Only used to choose which provider link to show; nothing is booked."},"note":{"type":"string","maxLength":200}},"additionalProperties":false},"missing_information":{"type":"array","items":{"type":"string","maxLength":100},"maxItems":10,"default":[]},"required_options":{"type":"array","items":{"type":"string","enum":["parking","valet_parking","kids_allowed","baby_chair","private_room","group_seating","pets_allowed","wheelchair_accessible","wifi","separate_restrooms","reservation","takeout","delivery","english_menu","foreign_card","solo_ok","remote_waitlist","vegetarian_options","halal","allergy_accommodation","spice_adjustment","booking","laptop","outlet"]},"maxItems":20,"default":[],"description":"context.party_size = number of people; required_options = values from vocabularies.required_options only. The canonical list is the tools/list inputSchema enum; it wins on mismatch. Occasion words (occasion_words, e.g. 회식) are not interpreted: map them to party size, options, time, or ask the user. Capacity comes back unknown.\nR6: canonical tools/list inputSchema enum. REST rules: /agent-sending-rules.json.\nFilters restaurants. booking requires a confirmed reservation link; other keys use projected source or owner facts. action only selects link type. Unknown never matches."},"open_on":{"type":"object","properties":{"day":{"type":"string","enum":["mon","tue","wed","thu","fri","sat","sun"],"description":"Weekday code: mon, tue, wed, thu, fri, sat or sun."},"time":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"}},"required":["day"],"additionalProperties":false,"description":"Time goes only in open_on {day: mon..sun, time: HH:MM}, KST, relative to the agent's send time. Map: 아침 일찍 (early morning) 07:00, 아침 (morning) 08:00, 점심 (lunch) 12:00, 저녁 (dinner) 18:30, 늦게까지 (late) 22:00, 심야 (late night) 23:30, 새벽 (small hours) 04:00, 지금 (now) = send time. Send a stated time ('새벽 2시', '7시 반') as HH:MM instead of the map. Past midnight, use the next day. Never put time words in query."},"task_id":{"type":"string","format":"uuid","description":"Reuse the returned task_id for follow-up calls for the same question; omit for a new question."},"client_request_id":{"type":"string","minLength":8,"maxLength":100,"pattern":"^[A-Za-z0-9_.:-]+$"},"rules_version":{"type":"string","minLength":1,"maxLength":64,"description":"Your known rules_version; omit if unknown."},"manual_version":{"type":"string","minLength":1,"maxLength":64,"description":"Your saved manual_version; omit if unknown."}},"additionalProperties":true,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Engine JSON response; unknown values and fallback remain explicit","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}},"places":{"type":"array","items":{"type":"object","properties":{"conditions":{"type":"object","description":"search_places cards carry conditions per key as {state,tier,source}; hours_weekly.<day> adds the day's hours. unknown is not met; unparsed_conditions were not judged.","additionalProperties":{"type":"object","properties":{"state":{"type":"string","enum":["met","not_met","unknown"]},"tier":{"type":"string"},"source":{"type":["string","null"]}}}}}}},"unknown_places":{"type":"array","items":{"type":"object","properties":{"conditions":{"type":"object","description":"search_places cards carry conditions per key as {state,tier,source}; hours_weekly.<day> adds the day's hours. unknown is not met; unparsed_conditions were not judged.","additionalProperties":{"type":"object","properties":{"state":{"type":"string","enum":["met","not_met","unknown"]},"tier":{"type":"string"},"source":{"type":["string","null"]}}}}}}}}}}}},"201":{"description":"Engine JSON response; unknown values and fallback remain explicit","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}},"places":{"type":"array","items":{"type":"object","properties":{"conditions":{"type":"object","description":"search_places cards carry conditions per key as {state,tier,source}; hours_weekly.<day> adds the day's hours. unknown is not met; unparsed_conditions were not judged.","additionalProperties":{"type":"object","properties":{"state":{"type":"string","enum":["met","not_met","unknown"]},"tier":{"type":"string"},"source":{"type":["string","null"]}}}}}}},"unknown_places":{"type":"array","items":{"type":"object","properties":{"conditions":{"type":"object","description":"search_places cards carry conditions per key as {state,tier,source}; hours_weekly.<day> adds the day's hours. unknown is not met; unparsed_conditions were not judged.","additionalProperties":{"type":"object","properties":{"state":{"type":"string","enum":["met","not_met","unknown"]},"tier":{"type":"string"},"source":{"type":["string","null"]}}}}}}}}}}}},"400":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"401":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"403":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"404":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"405":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"409":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"429":{"description":"Rate limited; honor Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"503":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"504":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}}},"security":[{},{"agentKey":[]},{"bearer":[]}]}},"/v1/get_place":{"post":{"operationId":"get_place","description":"Sourced facts and the provider's own booking/info URLs for an identified place. URLs are returned only when observed — never invent a link. Covers licensed restaurants, cafés and bars in Korea. Use place_id or place_ids for handoff paths and provenance. Optional fields lists the unrecorded fields you want checked. Recorded facts come first in summary; each fact carries source and read_on (KST date). menu shows 15 items with menu_total; budget \"full\" returns every item and dish lists matching items first. See tool selection in initialize instructions and response rules in initialize instructions; read conditions {state,tier,source}; tierless met/yes is not evidence. Unknown is not met. No booking or payment.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"fields":{"type":"array","items":{"type":"string","minLength":1,"maxLength":80},"maxItems":40,"description":"Only requested unrecorded fields receive unknown_reasons and a next step."},"place_id":{"type":"string"},"place_ids":{"type":"array","items":{"type":"string"}},"lang":{"type":"string","enum":["ko","en"]},"intent_key":{"type":"string","minLength":8,"maxLength":100,"pattern":"^[a-zA-Z0-9_.:-]+$"},"action":{"type":"string","enum":["reservation","waitlist","delivery","order","info","modify","cancel"],"description":"Which provider-page link to return; nothing is submitted, changed or cancelled"},"purpose":{"type":"string","enum":["visit","reserve","delivery"],"description":"visit: information page; reserve: booking-page link; delivery: delivery-page link. Links only."},"agent":{"type":"object","properties":{"class":{"type":"string","maxLength":50},"capabilities":{"type":"array","items":{"type":"string","enum":["web","app_link","phone","mcp"]},"maxItems":4},"provider_accounts":{"type":"array","items":{"type":"string","maxLength":100},"maxItems":20},"acts_autonomously":{"type":"boolean"},"locale":{"type":"string"},"platform":{"type":"string"}},"additionalProperties":false},"context":{"type":"object","properties":{"time_window":{"type":"object","properties":{"start":{"type":"string","format":"date-time"},"end":{"type":"string","format":"date-time"}},"required":["start","end"],"additionalProperties":false},"party_size":{"type":"integer","exclusiveMinimum":0},"mode":{"type":"string","enum":["dine_in","delivery","pickup"]},"urgency":{"type":"string","enum":["now","today","later"]},"goal":{"type":"string","enum":["book_now","info_only"],"description":"Only used to choose which provider link to show; nothing is booked."},"note":{"type":"string","maxLength":200}},"additionalProperties":false},"budget":{"type":"string","enum":["compact","full"],"description":"compact shows 15 menu items with menu_total; full returns every menu item and related places"},"dish":{"type":"string","minLength":1,"maxLength":80,"description":"Menu items matching this dish come first in the shortened menu"},"verification_mode":{"type":"object","properties":{"request_id":{"type":"string","minLength":8,"maxLength":100}},"required":["request_id"],"additionalProperties":false,"description":"Costs 1 token per new request_id (after accept_consent) and adds per-field sources, read dates and verification status; the same request_id replays the saved reply free. Ordinary reads are free."},"task_id":{"type":"string","format":"uuid","description":"Reuse the returned task_id for follow-up calls for the same question; omit for a new question."},"client_request_id":{"type":"string","minLength":8,"maxLength":100,"pattern":"^[A-Za-z0-9_.:-]+$"},"rules_version":{"type":"string","minLength":1,"maxLength":64,"description":"Your known rules_version; omit if unknown."},"manual_version":{"type":"string","minLength":1,"maxLength":64,"description":"Your saved manual_version; omit if unknown."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Engine JSON response; unknown values and fallback remain explicit","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"201":{"description":"Engine JSON response; unknown values and fallback remain explicit","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"400":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"401":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"403":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"404":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"405":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"409":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"429":{"description":"Rate limited; honor Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"503":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"504":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}}},"security":[{},{"agentKey":[]},{"bearer":[]}]}},"/v1/public/areas":{"get":{"operationId":"list_areas","description":"List all registered coverage areas and their collection counts from the same snapshot as /agent.json. Follow next_action + next_action_instruction; coverage is observed progress, not a restaurant recommendation.","parameters":[{"name":"task_id","in":"query","required":false,"schema":{"type":"string","format":"uuid","description":"Reuse the returned task_id for follow-up calls for the same question; omit for a new question."}},{"name":"client_request_id","in":"query","required":false,"schema":{"type":"string","minLength":8,"maxLength":100,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"rules_version","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":64,"description":"Your known rules_version; omit if unknown."}},{"name":"manual_version","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":64,"description":"Your saved manual_version; omit if unknown."}}],"responses":{"200":{"description":"Engine JSON response; unknown values and fallback remain explicit","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"201":{"description":"Engine JSON response; unknown values and fallback remain explicit","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"400":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"401":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"403":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"404":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"405":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"409":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"429":{"description":"Rate limited; honor Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"503":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"504":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}}},"security":[{},{"agentKey":[]},{"bearer":[]}]}},"/v1/agents/me":{"get":{"operationId":"get_agent","description":"[account] Read this authenticated agent instance identity, linked-owner status, scopes and consent state. No credential is returned.","parameters":[{"name":"task_id","in":"query","required":false,"schema":{"type":"string","format":"uuid","description":"Reuse the returned task_id for follow-up calls for the same question; omit for a new question."}},{"name":"client_request_id","in":"query","required":false,"schema":{"type":"string","minLength":8,"maxLength":100,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"rules_version","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":64,"description":"Your known rules_version; omit if unknown."}},{"name":"manual_version","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":64,"description":"Your saved manual_version; omit if unknown."}}],"responses":{"200":{"description":"Engine JSON response; unknown values and fallback remain explicit","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"201":{"description":"Engine JSON response; unknown values and fallback remain explicit","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"400":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"401":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"403":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"404":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"405":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"409":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"429":{"description":"Rate limited; honor Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"503":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"504":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}}},"security":[{"agentKey":[]},{"bearer":[]}]}},"/v1/agents/register":{"post":{"operationId":"register","description":"[account] Register this agent instance without prior authentication. Read scope is granted first; write scopes and tokens need agent-consent-v1: send consent here or call accept_consent later. The first instance per registration source in 30 days gets 5 tokens once consented. Send X-Agent-Key on every call or reuse the same Mcp-Session-Id; a new session does not inherit identity. The API key is shown only in this response.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":"string","minLength":1,"maxLength":100},"label":{"type":"string","minLength":1,"maxLength":100},"intended_use":{"type":"string","minLength":1,"maxLength":300},"consent":{"type":"object","properties":{"version":{"type":"string","const":"agent-consent-v1"},"routed_via_cooksup":{"type":"boolean","const":true},"signed_handoff":{"type":"boolean","const":true},"outcome_telemetry":{"type":"boolean","const":true}},"required":["version","routed_via_cooksup","signed_handoff","outcome_telemetry"],"additionalProperties":false},"task_id":{"type":"string","format":"uuid","description":"Reuse the returned task_id for follow-up calls for the same question; omit for a new question."},"client_request_id":{"type":"string","minLength":8,"maxLength":100,"pattern":"^[A-Za-z0-9_.:-]+$"},"rules_version":{"type":"string","minLength":1,"maxLength":64,"description":"Your known rules_version; omit if unknown."},"manual_version":{"type":"string","minLength":1,"maxLength":64,"description":"Your saved manual_version; omit if unknown."}},"required":["product","label","intended_use"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Engine JSON response; unknown values and fallback remain explicit","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"201":{"description":"Engine JSON response; unknown values and fallback remain explicit","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"400":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"401":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"403":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"404":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"405":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"409":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"429":{"description":"Rate limited; honor Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"503":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"504":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}}},"security":[{"agentKey":[]},{"bearer":[]}]}},"/v1/agents/credits":{"get":{"operationId":"get_credits","description":"[account] Read this instance's token balance and latest 50 ledger entries; pass next_cursor as after. Before agent-consent-v1: balance 0, consent_required and next_action accept_consent. Tokens v1 active: earn through reviewed report_observation; get_place verification_mode costs 1. Not payment currency.","parameters":[{"name":"after","in":"query","required":false,"schema":{"type":"string","maxLength":300}},{"name":"task_id","in":"query","required":false,"schema":{"type":"string","format":"uuid","description":"Reuse the returned task_id for follow-up calls for the same question; omit for a new question."}},{"name":"client_request_id","in":"query","required":false,"schema":{"type":"string","minLength":8,"maxLength":100,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"rules_version","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":64,"description":"Your known rules_version; omit if unknown."}},{"name":"manual_version","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":64,"description":"Your saved manual_version; omit if unknown."}}],"responses":{"200":{"description":"Engine JSON response; unknown values and fallback remain explicit","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"201":{"description":"Engine JSON response; unknown values and fallback remain explicit","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"400":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"401":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"403":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"404":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"405":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"409":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"429":{"description":"Rate limited; honor Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"503":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"504":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}}},"security":[{"agentKey":[]},{"bearer":[]}]}},"/v1/agents/consent":{"post":{"operationId":"accept_consent","description":"[account] Accept agent-consent-v1 once for this registered instance (send X-Agent-Key or reuse the register session): handoffs are prepared through FORKPIN, FORKPIN issues signed handoff tokens without customer identity, and you report structured attempt outcomes without customer identity. Grants write scopes; returns the starting balance and next step. Tokens v1 active: the first instance per source gets 5 tokens.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"version":{"type":"string","const":"agent-consent-v1"},"routed_via_cooksup":{"type":"boolean","const":true},"signed_handoff":{"type":"boolean","const":true},"outcome_telemetry":{"type":"boolean","const":true},"task_id":{"type":"string","format":"uuid","description":"Reuse the returned task_id for follow-up calls for the same question; omit for a new question."},"client_request_id":{"type":"string","minLength":8,"maxLength":100,"pattern":"^[A-Za-z0-9_.:-]+$"},"rules_version":{"type":"string","minLength":1,"maxLength":64,"description":"Your known rules_version; omit if unknown."},"manual_version":{"type":"string","minLength":1,"maxLength":64,"description":"Your saved manual_version; omit if unknown."}},"required":["version","routed_via_cooksup","signed_handoff","outcome_telemetry"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Engine JSON response; unknown values and fallback remain explicit","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"201":{"description":"Engine JSON response; unknown values and fallback remain explicit","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"400":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"401":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"403":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"404":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"405":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"409":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"429":{"description":"Rate limited; honor Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"503":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"504":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}}},"security":[{"agentKey":[]},{"bearer":[]}]}},"/catalog.json":{"get":{"operationId":"catalog","description":"[legacy] Read one page of public shop cards, subject to anonymous page limits. Without name or area, returns the first page and total merchant counts, not every shop. Pass next_cursor.after and next_cursor.part as after and part to continue; cards do not prove live availability.","parameters":[{"name":"name","in":"query","required":false,"schema":{"type":"string","description":"Shop name filter"}},{"name":"area","in":"query","required":false,"schema":{"type":"string","description":"Area, district, or street as written in the address"}},{"name":"after","in":"query","required":false,"schema":{"type":"string","description":"Pass next_cursor.after from the previous response"}},{"name":"part","in":"query","required":false,"schema":{"type":"string","enum":["link","rest"],"description":"Pass next_cursor.part from the previous response"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","enum":["ko","en"]}},{"name":"task_id","in":"query","required":false,"schema":{"type":"string","format":"uuid","description":"Reuse the returned task_id for follow-up calls for the same question; omit for a new question."}},{"name":"client_request_id","in":"query","required":false,"schema":{"type":"string","minLength":8,"maxLength":100,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"rules_version","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":64,"description":"Your known rules_version; omit if unknown."}},{"name":"manual_version","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":64,"description":"Your saved manual_version; omit if unknown."}}],"responses":{"200":{"description":"Engine JSON response; unknown values and fallback remain explicit","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"201":{"description":"Engine JSON response; unknown values and fallback remain explicit","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"400":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"401":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"403":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"404":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"405":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"409":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"429":{"description":"Rate limited; honor Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"503":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"504":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}}},"security":[{},{"agentKey":[]},{"bearer":[]}]}},"/v1/resolve_merchant":{"post":{"operationId":"resolve_merchant","description":"[legacy] Identify the exact branch of a Korean restaurant from name and address. Use before web search — search results confuse same-named branches. Covers licensed restaurants, cafés and bars in Korea. Required: resolve with name and address (R1); name alone returns addressed candidates. Evidenced handoff links only; JEV judgment can clarify or fall back to marked static output. Send the restaurant name in Hangul when you have it; English or romanized names also work. Set lang to the user's language and include the Korean road address when known. Send the user's language as lang (for example en). Abstract preferences (famous, tasty, quiet) are not judged; convert them to concrete filters or ask the user. Unparsed conditions are listed in unparsed_conditions. Sending rules R1–R9: initialize instructions; REST source: /agent-sending-rules.json If resend.ask_user=true, show allowed {area,count} to the user; never auto-select or retry. See R1 and response rules in initialize instructions: outcome results|alternatives|candidates|identified|clarify|none; follow next_action + next_action_instruction. branch_conflict/weak_address: ask for an address; never choose. No booking, payment or live availability.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse the returned task_id for follow-up calls for the same question; omit for a new question."},"fields":{"type":"array","items":{"type":"string","minLength":1,"maxLength":80},"maxItems":40,"description":"Only requested unrecorded fields receive unknown_reasons and a next step."},"intent_key":{"type":"string","minLength":8,"maxLength":100,"pattern":"^[a-zA-Z0-9_.:-]+$"},"action":{"type":"string","enum":["reservation","waitlist","delivery","order","info","modify","cancel"],"description":"Which provider-page link to return; nothing is submitted, changed or cancelled"},"purpose":{"type":"string","enum":["visit","reserve","delivery"],"description":"visit: information page; reserve: booking-page link; delivery: delivery-page link. Links only."},"agent":{"type":"object","properties":{"class":{"type":"string","maxLength":50},"capabilities":{"type":"array","items":{"type":"string","enum":["web","app_link","phone","mcp"]},"maxItems":4},"provider_accounts":{"type":"array","items":{"type":"string","maxLength":100},"maxItems":20},"acts_autonomously":{"type":"boolean"},"locale":{"type":"string"},"platform":{"type":"string"}},"additionalProperties":false},"context":{"type":"object","properties":{"time_window":{"type":"object","properties":{"start":{"type":"string","format":"date-time"},"end":{"type":"string","format":"date-time"}},"required":["start","end"],"additionalProperties":false},"party_size":{"type":"integer","exclusiveMinimum":0},"mode":{"type":"string","enum":["dine_in","delivery","pickup"]},"urgency":{"type":"string","enum":["now","today","later"]},"goal":{"type":"string","enum":["book_now","info_only"],"description":"Only used to choose which provider link to show; nothing is booked."},"note":{"type":"string","maxLength":200}},"additionalProperties":false},"budget":{"type":"string","enum":["compact","full"],"default":"compact","description":"compact shows 15 menu items with menu_total; full returns every menu item and related places"},"dish":{"type":"string","minLength":1,"maxLength":80,"description":"Menu items matching this dish come first in the shortened menu"},"lang":{"type":"string","enum":["ko","en"]},"verification_mode":{"type":"object","properties":{"request_id":{"type":"string","minLength":8,"maxLength":100}},"required":["request_id"],"additionalProperties":false},"user_city":{"type":"string","minLength":1,"maxLength":100},"user_location":{"type":"object","properties":{"lat":{"type":"number","minimum":-90,"maximum":90},"lng":{"type":"number","minimum":-180,"maximum":180}},"required":["lat","lng"],"additionalProperties":false},"query":{"type":"string","maxLength":500},"name":{"type":"string","maxLength":300},"address":{"type":"string","maxLength":500},"area":{"type":"string","maxLength":300,"description":"Preferred city, district or neighborhood; out-of-area candidates are marked and never confirmed by fallback"},"license_id":{"type":"string","maxLength":100},"naver_place_id":{"type":"string","maxLength":100},"cursor":{"type":"string","maxLength":2048},"client_request_id":{"type":"string","minLength":8,"maxLength":100,"pattern":"^[A-Za-z0-9_.:-]+$"},"rules_version":{"type":"string","minLength":1,"maxLength":64,"description":"Your known rules_version; omit if unknown."},"manual_version":{"type":"string","minLength":1,"maxLength":64,"description":"Your saved manual_version; omit if unknown."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Engine JSON response; unknown values and fallback remain explicit","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"201":{"description":"Engine JSON response; unknown values and fallback remain explicit","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"400":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"401":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"403":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"404":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"405":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"409":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"429":{"description":"Rate limited; honor Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"503":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"504":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}}},"security":[{},{"agentKey":[]},{"bearer":[]}]}},"/v1/restaurants/{restaurant_id}":{"get":{"operationId":"read_restaurant","description":"[legacy] Read one restaurant's identity, evidence, observed facts and action handoff routes. A URL requires fresh declared policy, collector check or screen-reach evidence. Hours text is what the page showed at source_read_at, not current opening status. Unknown facts stay unknown; executable.hard=true means only the agent capability gate passed, while executable.noul=null means no model execution judgment was made. Neither confirms booking availability. This tool does not judge or invent menus, availability or provider URLs.","parameters":[{"name":"restaurant_id","in":"path","required":true,"schema":{"type":"string","description":"Stable restaurant id"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","enum":["ko","en"]}},{"name":"task_id","in":"query","required":false,"schema":{"type":"string","format":"uuid","description":"Reuse the returned task_id for follow-up calls for the same question; omit for a new question."}},{"name":"client_request_id","in":"query","required":false,"schema":{"type":"string","minLength":8,"maxLength":100,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"rules_version","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":64,"description":"Your known rules_version; omit if unknown."}},{"name":"manual_version","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":64,"description":"Your saved manual_version; omit if unknown."}}],"responses":{"200":{"description":"Engine JSON response; unknown values and fallback remain explicit","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"201":{"description":"Engine JSON response; unknown values and fallback remain explicit","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"400":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"401":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"403":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"404":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"405":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"409":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"429":{"description":"Rate limited; honor Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"503":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"504":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}}},"security":[{},{"agentKey":[]},{"bearer":[]}]}},"/v1/requests":{"post":{"operationId":"request_feature","description":"[report] Record missing restaurant information or a desired capability. Requires requests:write; data only, with no delivery promise.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"feature":{"type":"string","maxLength":300,"default":""},"missing_information":{"type":"string","maxLength":300,"default":""},"place_id":{"type":"string","maxLength":100},"task_id":{"type":"string","format":"uuid","description":"Reuse the returned task_id for follow-up calls for the same question; omit for a new question."},"client_request_id":{"type":"string","minLength":8,"maxLength":100,"pattern":"^[A-Za-z0-9_.:-]+$"},"rules_version":{"type":"string","minLength":1,"maxLength":64,"description":"Your known rules_version; omit if unknown."},"manual_version":{"type":"string","minLength":1,"maxLength":64,"description":"Your saved manual_version; omit if unknown."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Engine JSON response; unknown values and fallback remain explicit","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"201":{"description":"Engine JSON response; unknown values and fallback remain explicit","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"400":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"401":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"403":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"404":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"405":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"409":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"429":{"description":"Rate limited; honor Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"503":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"504":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}}},"security":[{"agentKey":[]},{"bearer":[]}]}},"/v1/reports":{"post":{"operationId":"report_observation","description":"[report] Submit an observed identity or routing report and receive a private receipt. Requires reports:write; review is required before public reuse. Reports do not verify links or edit facts. Tokens v1: structured checks (correct_place, link_opened or arrived_at_channel) on a place you read within 7 days earn 1; a correction with field_errors earns 5 after review and a recorded fix. Pending until operator review; max 20 per Seoul day; the same place again after 7 days.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"request_id":{"type":"string","minLength":8,"maxLength":100},"place_id":{"type":["string","null"]},"query":{"anyOf":[{"type":"object","properties":{"name":{"type":"string","maxLength":100},"area":{"type":"string","maxLength":200}},"additionalProperties":false},{"type":"null"}]},"report_type":{"type":"string","enum":["reachability","identity","correction","data_request","input_limit","not_found","policy_correction"]},"action":{"type":"string","enum":["reservation","waitlist","delivery","order","info","modify","cancel"]},"observed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"checks":{"type":"object","properties":{"data_correctness":{"type":"object","properties":{"correct_place":{"anyOf":[{"type":"boolean"},{"type":"string","const":"unknown"}]},"field_errors":{"anyOf":[{"type":"string","const":"unknown"},{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","enum":["name","address","phone","category","hours"]},"observed_value":{"type":"string","minLength":1,"maxLength":200},"comparison_source":{"type":"string","minLength":1,"maxLength":200}},"required":["field","observed_value","comparison_source"],"additionalProperties":false},"maxItems":5}]}},"required":["correct_place","field_errors"],"additionalProperties":false},"route_reachability":{"type":"object","properties":{"link_opened":{"$ref":"#/properties/checks/properties/data_correctness/properties/correct_place"},"arrived_at_channel":{"$ref":"#/properties/checks/properties/data_correctness/properties/correct_place"}},"required":["link_opened","arrived_at_channel"],"additionalProperties":false},"execution":{"type":"object","properties":{"confirmed":{"$ref":"#/properties/checks/properties/data_correctness/properties/correct_place"}},"required":["confirmed"],"additionalProperties":false}},"required":["data_correctness","route_reachability","execution"],"additionalProperties":false},"route_snapshot":{"anyOf":[{"type":"object","properties":{"route_id":{"type":"string"},"action":{"type":"string","enum":["reservation","waitlist","delivery","order","info","modify","cancel"]},"provider":{"type":"string","maxLength":100},"url":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}]},"last_verified":{"type":["string","null"]}},"required":["action","provider"],"additionalProperties":false},{"type":"null"}]},"platform_result":{"anyOf":[{"type":"string","enum":["completed","canceled_by_venue","link_broken","wrong_shop","needs_login","no_slot_shown"]},{"type":"null"}]},"rating_scope":{"type":"string","const":"identity_and_routing","default":"identity_and_routing"},"rating":{"anyOf":[{"type":"integer","minimum":1,"maximum":5},{"type":"null"}],"default":null},"evidence":{"type":"string","maxLength":1000},"request":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}]},"task_id":{"type":"string","format":"uuid","description":"Reuse the returned task_id for follow-up calls for the same question; omit for a new question."},"client_request_id":{"type":"string","minLength":8,"maxLength":100,"pattern":"^[A-Za-z0-9_.:-]+$"},"rules_version":{"type":"string","minLength":1,"maxLength":64,"description":"Your known rules_version; omit if unknown."},"manual_version":{"type":"string","minLength":1,"maxLength":64,"description":"Your saved manual_version; omit if unknown."}},"required":["request_id","place_id","report_type","action","observed_at","checks","evidence"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Engine JSON response; unknown values and fallback remain explicit","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"201":{"description":"Engine JSON response; unknown values and fallback remain explicit","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"400":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"401":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"403":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"404":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"405":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"409":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"429":{"description":"Rate limited; honor Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"503":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"504":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}}},"security":[{"agentKey":[]},{"bearer":[]}]}},"/v1/reports/{report_id}":{"get":{"operationId":"read_report","description":"[report] Read your observation receipt and review status. Requires reports:write. This does not edit restaurant facts.","parameters":[{"name":"report_id","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"task_id","in":"query","required":false,"schema":{"type":"string","format":"uuid","description":"Reuse the returned task_id for follow-up calls for the same question; omit for a new question."}},{"name":"client_request_id","in":"query","required":false,"schema":{"type":"string","minLength":8,"maxLength":100,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"rules_version","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":64,"description":"Your known rules_version; omit if unknown."}},{"name":"manual_version","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":64,"description":"Your saved manual_version; omit if unknown."}}],"responses":{"200":{"description":"Engine JSON response; unknown values and fallback remain explicit","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"201":{"description":"Engine JSON response; unknown values and fallback remain explicit","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"400":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"401":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"403":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"404":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"405":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"409":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"429":{"description":"Rate limited; honor Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"503":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"504":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}}},"security":[{},{"agentKey":[]},{"bearer":[]}]}},"/v1/places/{place_id}/reports":{"get":{"operationId":"read_reports","description":"[report] Read only reviewed public identity/routing observations for a place; unreviewed reports stay private. These are not food-quality ratings.","parameters":[{"name":"place_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"task_id","in":"query","required":false,"schema":{"type":"string","format":"uuid","description":"Reuse the returned task_id for follow-up calls for the same question; omit for a new question."}},{"name":"client_request_id","in":"query","required":false,"schema":{"type":"string","minLength":8,"maxLength":100,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"rules_version","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":64,"description":"Your known rules_version; omit if unknown."}},{"name":"manual_version","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":64,"description":"Your saved manual_version; omit if unknown."}}],"responses":{"200":{"description":"Engine JSON response; unknown values and fallback remain explicit","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"201":{"description":"Engine JSON response; unknown values and fallback remain explicit","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"400":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"401":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"403":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"404":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"405":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"409":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"429":{"description":"Rate limited; honor Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"503":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"504":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}}},"security":[{},{"agentKey":[]},{"bearer":[]}]}},"/v1/outcomes":{"post":{"operationId":"report_outcome","description":"[report] Report what happened after an existing handoff; requires outcomes:write. A report is not proof that FORKPIN completed a reservation. The note is stored as data. Outcomes earn no tokens; report_observation does.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"request_id":{"type":"string","minLength":8,"maxLength":100},"handoff_id":{"type":"string","minLength":1},"result":{"type":"string","enum":["completed","opened_not_completed","wrong_shop","wrong_link","closed","info_wrong","other"]},"platform_requests":{"type":"integer","minimum":0,"maximum":10000},"polling":{"type":"boolean"},"policy_channel_attempted":{"type":"boolean"},"policy_result":{"type":"string","enum":["success","blocked","info_mismatch"]},"note":{"type":"string","maxLength":200},"task_id":{"type":"string","format":"uuid","description":"Reuse the returned task_id for follow-up calls for the same question; omit for a new question."},"client_request_id":{"type":"string","minLength":8,"maxLength":100,"pattern":"^[A-Za-z0-9_.:-]+$"},"rules_version":{"type":"string","minLength":1,"maxLength":64,"description":"Your known rules_version; omit if unknown."},"manual_version":{"type":"string","minLength":1,"maxLength":64,"description":"Your saved manual_version; omit if unknown."}},"required":["request_id","handoff_id","result"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Engine JSON response; unknown values and fallback remain explicit","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"201":{"description":"Engine JSON response; unknown values and fallback remain explicit","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"400":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"401":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"403":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"404":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"405":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"409":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"429":{"description":"Rate limited; honor Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"503":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"504":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}}},"security":[{"agentKey":[]},{"bearer":[]}]}},"/v1/likes":{"post":{"operationId":"like_place","description":"[report] Record one private aggregate like per caller and Seoul calendar day; requires likes:write. It does not rank restaurants.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"place_id":{"type":"string","minLength":1},"event_id":{"type":"string","minLength":8,"maxLength":100},"task_id":{"type":"string","format":"uuid","description":"Reuse the returned task_id for follow-up calls for the same question; omit for a new question."},"client_request_id":{"type":"string","minLength":8,"maxLength":100,"pattern":"^[A-Za-z0-9_.:-]+$"},"rules_version":{"type":"string","minLength":1,"maxLength":64,"description":"Your known rules_version; omit if unknown."},"manual_version":{"type":"string","minLength":1,"maxLength":64,"description":"Your saved manual_version; omit if unknown."}},"required":["place_id","event_id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Engine JSON response; unknown values and fallback remain explicit","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"201":{"description":"Engine JSON response; unknown values and fallback remain explicit","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"400":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"401":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"403":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"404":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"405":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"409":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"429":{"description":"Rate limited; honor Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"503":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}},"504":{"description":"Gateway error code in JSON","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid","description":"Reuse for follow-up calls for this question; omit for a new question."},"next_call":{"type":"object","description":"Next tool and arguments; preserve the request meaning. No credentials are included."},"summary":{"type":"object","description":"Recorded shop identity, channel links, hours, up to five menu items and known options; missing facts are omitted."},"recorded_fields":{"type":"integer"},"unrecorded_fields":{"type":"integer"},"manual_version":{"type":"string"},"manual_update":{"type":"object","required":["from","to","changes","action","changelog"],"properties":{"from":{"type":["string","null"]},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"},"maxItems":5},"action":{"type":"string"},"changelog":{"type":"string"}}},"guidance_version":{"type":"string","description":"Served guidance version; code-default when no resolver is registered."},"coverage_version":{"type":"string","description":"Collection-area and recorded hours/menu counts snapshot; call list_areas once when it changes."},"rules_version":{"type":"string"},"rules_update":{"type":"object","required":["from","to","changes"],"properties":{"from":{"type":"string"},"to":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}}}}}}},"security":[{"agentKey":[]},{"bearer":[]}]}}},"components":{"securitySchemes":{"agentKey":{"type":"apiKey","in":"header","name":"X-Agent-Key"},"bearer":{"type":"http","scheme":"bearer"}}}}