{"generated_at":"2026-04-18T19:22:17.162Z","site":{"name":"Hostrail Docs","role":"documentation_corpus","canonical_url":"https://docs.hostrail.dev"},"intended_audiences":["ai_agents_reading_docs","tool_calling_runtimes","backend_integrators","human_developers","sandbox_evaluators"],"source_of_truth":{"docs_explanations":"docs_pages_and_markdown_exports","public_product_discovery":"https://hostrail.dev","execution_contract":"https://api.hostrail.dev","live_price_and_policy":"quote_output"},"machine_surfaces":{"llms_txt":"https://docs.hostrail.dev/llms.txt","llms_full_txt":"https://docs.hostrail.dev/llms-full.txt","capabilities_json":"https://docs.hostrail.dev/capabilities.json","graph_json":"https://docs.hostrail.dev/graph.json","per_page_markdown_pattern":"https://docs.hostrail.dev/llms.mdx/docs/<slug>/content.md","per_page_metadata_pattern":"https://docs.hostrail.dev/docs/meta/<slug>","docs_pages":"https://docs.hostrail.dev/docs"},"graph_semantics":{"edge_types":{"prerequisite":"read this page first before relying on the current page","next_recommended":"best next docs page after finishing the current page","deepens":"more detailed follow-up pages that extend the current topic","related":"topically similar pages that are useful but not required next","switches_to_surface":"external or machine-readable surfaces to fetch when docs alone are insufficient"}},"surface_inventory":[{"id":"docs_llms_txt","title":"Docs llms.txt","role":"docs_index","site":"docs","format":"markdown","url":"https://docs.hostrail.dev/llms.txt","audience":["ai_agents_reading_docs","retrieval_first_assistants"],"best_for":["first cheap fetch over the docs corpus"]},{"id":"docs_llms_full_txt","title":"Docs llms-full.txt","role":"docs_full_corpus","site":"docs","format":"markdown","url":"https://docs.hostrail.dev/llms-full.txt","audience":["ai_agents_reading_docs","retrieval_first_assistants"],"best_for":["broad semantic grounding across docs pages"]},{"id":"docs_capabilities_json","title":"Docs capabilities.json","role":"docs_capabilities","site":"docs","format":"json","url":"https://docs.hostrail.dev/capabilities.json","audience":["ai_agents_reading_docs","tool_calling_runtimes"],"best_for":["structured summary of the docs corpus"]},{"id":"docs_graph_json","title":"Docs graph.json","role":"docs_graph","site":"docs","format":"json","url":"https://docs.hostrail.dev/graph.json","audience":["ai_agents_reading_docs","tool_calling_runtimes"],"best_for":["whole-site offline docs traversal"]},{"id":"root_llms_txt","title":"Root llms.txt","role":"product_index","site":"root","format":"markdown","url":"https://hostrail.dev/llms.txt","audience":["retrieval_first_assistants","ai_agents"],"best_for":["public product discovery"]},{"id":"root_llms_full_txt","title":"Root llms-full.txt","role":"product_full_context","site":"root","format":"markdown","url":"https://hostrail.dev/llms-full.txt","audience":["retrieval_first_assistants","ai_agents"],"best_for":["expanded public product context"]},{"id":"root_capabilities_json","title":"Root capabilities.json","role":"product_capabilities","site":"root","format":"json","url":"https://hostrail.dev/capabilities.json","audience":["ai_agents","tool_calling_runtimes","backend_integrators"],"best_for":["supported flows, payment methods, and limitations"]},{"id":"root_coverage_json","title":"Root coverage.json","role":"coverage_surface","site":"root","format":"json","url":"https://hostrail.dev/coverage.json","audience":["ai_agents","backend_integrators"],"best_for":["city and hotel rollout coverage"]},{"id":"root_acp_json","title":"Root ACP discovery","role":"acp_discovery","site":"root","format":"json","url":"https://hostrail.dev/.well-known/acp.json","audience":["ai_agents","protocol_implementers"],"best_for":["Agentic Commerce Protocol discovery"]},{"id":"api_agent_card","title":"API Agent Card","role":"execution_manifest","site":"api","format":"json","url":"https://api.hostrail.dev/.well-known/agent-card.json","audience":["tool_calling_runtimes","backend_integrators","ai_agents"],"best_for":["machine-readable capability and auth contract"]},{"id":"api_openapi_json","title":"API OpenAPI","role":"execution_schema","site":"api","format":"json","url":"https://api.hostrail.dev/openapi.json","audience":["tool_calling_runtimes","backend_integrators","sdk_authors"],"best_for":["exact request and response schemas"]},{"id":"api_errors_json","title":"API Error Catalog JSON","role":"error_catalog","site":"api","format":"json","url":"https://api.hostrail.dev/.well-known/errors","audience":["ai_agents","backend_integrators","operator_tools"],"best_for":["exact machine-readable error list"]},{"id":"mcp_server","title":"MCP endpoint","role":"mcp_transport","site":"mcp","format":"http","url":"https://mcp.hostrail.dev/mcp","audience":["tool_calling_runtimes"],"best_for":["transport for MCP-native agent runtimes"]}],"recommended_entry_points":[{"audience":"ai_agents_reading_docs","first_fetch":"https://docs.hostrail.dev/llms.txt","then":["https://docs.hostrail.dev/capabilities.json","https://docs.hostrail.dev/graph.json","https://docs.hostrail.dev/docs/quickstart/for-docs-agents"]},{"audience":"tool_calling_runtimes","first_fetch":"https://hostrail.dev/capabilities.json","then":["https://api.hostrail.dev/.well-known/agent-card.json","https://api.hostrail.dev/openapi.json"]},{"audience":"retrieval_first_assistants","first_fetch":"https://hostrail.dev/llms.txt","then":["https://hostrail.dev/llms-full.txt","https://docs.hostrail.dev/docs/concepts/discovery"]}],"page_inventory":{"total_pages":17,"sections":["quickstart","discovery_and_concepts","execution_guides","api_reference","error_catalog","legal"],"priority_pages":[{"node_kind":"docs_page","id":"https://docs.hostrail.dev/docs/api-reference/overview","title":"API Reference","description":"Reference for Hostrail discovery and booking endpoints, generated from the current OpenAPI 3.1 specification.","url":"https://docs.hostrail.dev/docs/api-reference/overview","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/api-reference/overview/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/api-reference/overview","section":"api-reference","slugs":["api-reference","overview"],"full":false,"audience":["backend_integrators","sdk_authors","tool_calling_runtimes"],"best_for":["exact endpoint groups and base URLs","mapping discovery surfaces to execution surfaces"],"depends_on":["openapi"],"switch_to_surfaces":["https://api.hostrail.dev/openapi.json","https://api.hostrail.dev/openapi.yaml"],"prerequisite_pages":[],"next_recommended_pages":[{"title":"Developer Quickstart","url":"https://docs.hostrail.dev/docs/quickstart/for-developers","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/quickstart/for-developers/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/quickstart/for-developers","section":"quickstart"},{"title":"How do I book a room?","url":"https://docs.hostrail.dev/docs/guides/booking-flow","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/guides/booking-flow/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/guides/booking-flow","section":"guides"}],"deepens_pages":[{"title":"Developer Quickstart","url":"https://docs.hostrail.dev/docs/quickstart/for-developers","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/quickstart/for-developers/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/quickstart/for-developers","section":"quickstart"},{"title":"How do I book a room?","url":"https://docs.hostrail.dev/docs/guides/booking-flow","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/guides/booking-flow/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/guides/booking-flow","section":"guides"},{"title":"What is the envelope contract?","url":"https://docs.hostrail.dev/docs/concepts/envelope","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/envelope/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/envelope","section":"concepts"}],"related_pages":[{"title":"Hostrail Docs","url":"https://docs.hostrail.dev/docs","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/","section":null},{"title":"ACP discovery","url":"https://docs.hostrail.dev/docs/concepts/acp","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/acp/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/acp","section":"concepts"},{"title":"How does delegation work?","url":"https://docs.hostrail.dev/docs/concepts/delegation","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/delegation/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/delegation","section":"concepts"},{"title":"How do agents discover this API?","url":"https://docs.hostrail.dev/docs/concepts/discovery","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/discovery/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/discovery","section":"concepts"}],"switch_to_surface_links":[{"id":"api_openapi_json","title":"API OpenAPI","role":"execution_schema","site":"api","format":"json","url":"https://api.hostrail.dev/openapi.json","audience":["tool_calling_runtimes","backend_integrators","sdk_authors"],"best_for":["exact request and response schemas"]},{"id":"https://api.hostrail.dev/openapi.yaml","title":"https://api.hostrail.dev/openapi.yaml","role":"external_surface","site":"api","format":"json","url":"https://api.hostrail.dev/openapi.yaml","audience":[],"best_for":[]}]},{"node_kind":"docs_page","id":"https://docs.hostrail.dev/docs/concepts/discovery","title":"How do agents discover this API?","description":"Root-site machine surfaces, Agent Card, OpenAPI, and MCP server metadata — the discovery documents an agent fetches before making any business call.","url":"https://docs.hostrail.dev/docs/concepts/discovery","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/discovery/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/discovery","section":"concepts","slugs":["concepts","discovery"],"full":false,"audience":["ai_agents","retrieval_first_assistants","tool_calling_runtimes"],"best_for":["choosing the correct discovery surface","understanding the difference between docs, root, and api surfaces"],"depends_on":["root-site discovery surfaces"],"switch_to_surfaces":["https://hostrail.dev/llms.txt","https://hostrail.dev/capabilities.json","https://api.hostrail.dev/.well-known/agent-card.json","https://api.hostrail.dev/openapi.json"],"prerequisite_pages":[{"title":"Docs for AI Agents","url":"https://docs.hostrail.dev/docs/quickstart/for-docs-agents","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/quickstart/for-docs-agents/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/quickstart/for-docs-agents","section":"quickstart"}],"next_recommended_pages":[{"title":"Agent Quickstart","url":"https://docs.hostrail.dev/docs/quickstart/for-agents","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/quickstart/for-agents/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/quickstart/for-agents","section":"quickstart"},{"title":"API Reference","url":"https://docs.hostrail.dev/docs/api-reference/overview","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/api-reference/overview/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/api-reference/overview","section":"api-reference"},{"title":"How do I book a room?","url":"https://docs.hostrail.dev/docs/guides/booking-flow","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/guides/booking-flow/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/guides/booking-flow","section":"guides"}],"deepens_pages":[{"title":"ACP discovery","url":"https://docs.hostrail.dev/docs/concepts/acp","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/acp/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/acp","section":"concepts"},{"title":"API Reference","url":"https://docs.hostrail.dev/docs/api-reference/overview","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/api-reference/overview/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/api-reference/overview","section":"api-reference"},{"title":"How do I test in the sandbox?","url":"https://docs.hostrail.dev/docs/guides/sandbox-testing","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/guides/sandbox-testing/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/guides/sandbox-testing","section":"guides"}],"related_pages":[{"title":"How does delegation work?","url":"https://docs.hostrail.dev/docs/concepts/delegation","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/delegation/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/delegation","section":"concepts"},{"title":"What is the envelope contract?","url":"https://docs.hostrail.dev/docs/concepts/envelope","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/envelope/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/envelope","section":"concepts"},{"title":"How does error handling work?","url":"https://docs.hostrail.dev/docs/concepts/error-model","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/error-model/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/error-model","section":"concepts"},{"title":"How does idempotency work?","url":"https://docs.hostrail.dev/docs/concepts/idempotency","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/idempotency/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/idempotency","section":"concepts"}],"switch_to_surface_links":[{"id":"root_llms_txt","title":"Root llms.txt","role":"product_index","site":"root","format":"markdown","url":"https://hostrail.dev/llms.txt","audience":["retrieval_first_assistants","ai_agents"],"best_for":["public product discovery"]},{"id":"root_capabilities_json","title":"Root capabilities.json","role":"product_capabilities","site":"root","format":"json","url":"https://hostrail.dev/capabilities.json","audience":["ai_agents","tool_calling_runtimes","backend_integrators"],"best_for":["supported flows, payment methods, and limitations"]},{"id":"api_agent_card","title":"API Agent Card","role":"execution_manifest","site":"api","format":"json","url":"https://api.hostrail.dev/.well-known/agent-card.json","audience":["tool_calling_runtimes","backend_integrators","ai_agents"],"best_for":["machine-readable capability and auth contract"]},{"id":"api_openapi_json","title":"API OpenAPI","role":"execution_schema","site":"api","format":"json","url":"https://api.hostrail.dev/openapi.json","audience":["tool_calling_runtimes","backend_integrators","sdk_authors"],"best_for":["exact request and response schemas"]}]},{"node_kind":"docs_page","id":"https://docs.hostrail.dev/docs/concepts/error-model","title":"How does error handling work?","description":"44 stable error codes with structured detail, imperative remediation, and typed recovery actions for recovery-safe booking automation.","url":"https://docs.hostrail.dev/docs/concepts/error-model","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/error-model/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/error-model","section":"concepts","slugs":["concepts","error-model"],"full":false,"audience":["ai_agents","backend_integrators","operator_tools"],"best_for":["deciding how to recover from booking failures","understanding error.code, remediation, and next_actions"],"depends_on":["envelope contract"],"switch_to_surfaces":["https://api.hostrail.dev/.well-known/errors","https://docs.hostrail.dev/docs/errors/reference"],"prerequisite_pages":[{"title":"What is the envelope contract?","url":"https://docs.hostrail.dev/docs/concepts/envelope","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/envelope/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/envelope","section":"concepts"}],"next_recommended_pages":[{"title":"Error Catalog","url":"https://docs.hostrail.dev/docs/errors/reference","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/errors/reference/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/errors/reference","section":"errors"},{"title":"How do I handle errors?","url":"https://docs.hostrail.dev/docs/guides/error-handling","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/guides/error-handling/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/guides/error-handling","section":"guides"},{"title":"What is the envelope contract?","url":"https://docs.hostrail.dev/docs/concepts/envelope","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/envelope/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/envelope","section":"concepts"}],"deepens_pages":[{"title":"Error Catalog","url":"https://docs.hostrail.dev/docs/errors/reference","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/errors/reference/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/errors/reference","section":"errors"},{"title":"How do I handle errors?","url":"https://docs.hostrail.dev/docs/guides/error-handling","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/guides/error-handling/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/guides/error-handling","section":"guides"}],"related_pages":[{"title":"How do receipts work?","url":"https://docs.hostrail.dev/docs/concepts/receipts","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/receipts/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/receipts","section":"concepts"},{"title":"ACP discovery","url":"https://docs.hostrail.dev/docs/concepts/acp","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/acp/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/acp","section":"concepts"},{"title":"How does delegation work?","url":"https://docs.hostrail.dev/docs/concepts/delegation","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/delegation/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/delegation","section":"concepts"},{"title":"How does idempotency work?","url":"https://docs.hostrail.dev/docs/concepts/idempotency","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/idempotency/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/idempotency","section":"concepts"}],"switch_to_surface_links":[{"id":"api_errors_json","title":"API Error Catalog JSON","role":"error_catalog","site":"api","format":"json","url":"https://api.hostrail.dev/.well-known/errors","audience":["ai_agents","backend_integrators","operator_tools"],"best_for":["exact machine-readable error list"]},{"id":"https://docs.hostrail.dev/docs/errors/reference","title":"https://docs.hostrail.dev/docs/errors/reference","role":"external_surface","site":"api","format":"json","url":"https://docs.hostrail.dev/docs/errors/reference","audience":[],"best_for":[]}]},{"node_kind":"docs_page","id":"https://docs.hostrail.dev/docs/guides/booking-flow","title":"How do I book a room?","description":"Step-by-step guide through the canonical booking flow — search, quote, hold, confirm — with error recovery at each step.","url":"https://docs.hostrail.dev/docs/guides/booking-flow","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/guides/booking-flow/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/guides/booking-flow","section":"guides","slugs":["guides","booking-flow"],"full":false,"audience":["ai_agents","backend_integrators"],"best_for":["canonical booking execution flow","understanding quote to booking transitions"],"depends_on":["discovery","agent card or openapi"],"switch_to_surfaces":["https://api.hostrail.dev/.well-known/agent-card.json","https://api.hostrail.dev/openapi.json"],"prerequisite_pages":[{"title":"How do agents discover this API?","url":"https://docs.hostrail.dev/docs/concepts/discovery","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/discovery/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/discovery","section":"concepts"},{"title":"Agent Quickstart","url":"https://docs.hostrail.dev/docs/quickstart/for-agents","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/quickstart/for-agents/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/quickstart/for-agents","section":"quickstart"},{"title":"API Reference","url":"https://docs.hostrail.dev/docs/api-reference/overview","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/api-reference/overview/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/api-reference/overview","section":"api-reference"}],"next_recommended_pages":[{"title":"How does error handling work?","url":"https://docs.hostrail.dev/docs/concepts/error-model","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/error-model/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/error-model","section":"concepts"},{"title":"Error Catalog","url":"https://docs.hostrail.dev/docs/errors/reference","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/errors/reference/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/errors/reference","section":"errors"},{"title":"How does idempotency work?","url":"https://docs.hostrail.dev/docs/concepts/idempotency","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/idempotency/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/idempotency","section":"concepts"}],"deepens_pages":[{"title":"How does idempotency work?","url":"https://docs.hostrail.dev/docs/concepts/idempotency","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/idempotency/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/idempotency","section":"concepts"},{"title":"How does delegation work?","url":"https://docs.hostrail.dev/docs/concepts/delegation","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/delegation/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/delegation","section":"concepts"},{"title":"How do receipts work?","url":"https://docs.hostrail.dev/docs/concepts/receipts","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/receipts/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/receipts","section":"concepts"}],"related_pages":[{"title":"How do I handle errors?","url":"https://docs.hostrail.dev/docs/guides/error-handling","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/guides/error-handling/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/guides/error-handling","section":"guides"},{"title":"How do I test in the sandbox?","url":"https://docs.hostrail.dev/docs/guides/sandbox-testing","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/guides/sandbox-testing/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/guides/sandbox-testing","section":"guides"},{"title":"Hostrail Docs","url":"https://docs.hostrail.dev/docs","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/","section":null},{"title":"ACP discovery","url":"https://docs.hostrail.dev/docs/concepts/acp","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/acp/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/acp","section":"concepts"}],"switch_to_surface_links":[{"id":"api_agent_card","title":"API Agent Card","role":"execution_manifest","site":"api","format":"json","url":"https://api.hostrail.dev/.well-known/agent-card.json","audience":["tool_calling_runtimes","backend_integrators","ai_agents"],"best_for":["machine-readable capability and auth contract"]},{"id":"api_openapi_json","title":"API OpenAPI","role":"execution_schema","site":"api","format":"json","url":"https://api.hostrail.dev/openapi.json","audience":["tool_calling_runtimes","backend_integrators","sdk_authors"],"best_for":["exact request and response schemas"]}]},{"node_kind":"docs_page","id":"https://docs.hostrail.dev/docs/quickstart/for-agents","title":"Agent Quickstart","description":"How an AI agent discovers and uses Hostrail — from public machine surfaces to authenticated booking execution.","url":"https://docs.hostrail.dev/docs/quickstart/for-agents","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/quickstart/for-agents/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/quickstart/for-agents","section":"quickstart","slugs":["quickstart","for-agents"],"full":false,"audience":["ai_agents","tool_calling_runtimes"],"best_for":["end-to-end agent startup against the live booking platform","moving from discovery into authenticated booking execution"],"depends_on":["root-site machine surfaces","agent card","openapi"],"switch_to_surfaces":["https://hostrail.dev/llms.txt","https://hostrail.dev/capabilities.json","https://api.hostrail.dev/.well-known/agent-card.json","https://api.hostrail.dev/openapi.json"],"prerequisite_pages":[{"title":"How do agents discover this API?","url":"https://docs.hostrail.dev/docs/concepts/discovery","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/discovery/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/discovery","section":"concepts"},{"title":"Developer Quickstart","url":"https://docs.hostrail.dev/docs/quickstart/for-developers","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/quickstart/for-developers/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/quickstart/for-developers","section":"quickstart"},{"title":"API Reference","url":"https://docs.hostrail.dev/docs/api-reference/overview","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/api-reference/overview/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/api-reference/overview","section":"api-reference"}],"next_recommended_pages":[{"title":"How do I book a room?","url":"https://docs.hostrail.dev/docs/guides/booking-flow","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/guides/booking-flow/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/guides/booking-flow","section":"guides"},{"title":"How does error handling work?","url":"https://docs.hostrail.dev/docs/concepts/error-model","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/error-model/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/error-model","section":"concepts"},{"title":"API Reference","url":"https://docs.hostrail.dev/docs/api-reference/overview","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/api-reference/overview/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/api-reference/overview","section":"api-reference"}],"deepens_pages":[{"title":"How does delegation work?","url":"https://docs.hostrail.dev/docs/concepts/delegation","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/delegation/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/delegation","section":"concepts"},{"title":"How do I book a room?","url":"https://docs.hostrail.dev/docs/guides/booking-flow","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/guides/booking-flow/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/guides/booking-flow","section":"guides"},{"title":"How does error handling work?","url":"https://docs.hostrail.dev/docs/concepts/error-model","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/error-model/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/error-model","section":"concepts"}],"related_pages":[{"title":"Hostrail Docs","url":"https://docs.hostrail.dev/docs","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/","section":null},{"title":"ACP discovery","url":"https://docs.hostrail.dev/docs/concepts/acp","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/acp/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/acp","section":"concepts"},{"title":"What is the envelope contract?","url":"https://docs.hostrail.dev/docs/concepts/envelope","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/envelope/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/envelope","section":"concepts"},{"title":"How does idempotency work?","url":"https://docs.hostrail.dev/docs/concepts/idempotency","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/idempotency/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/idempotency","section":"concepts"}],"switch_to_surface_links":[{"id":"root_llms_txt","title":"Root llms.txt","role":"product_index","site":"root","format":"markdown","url":"https://hostrail.dev/llms.txt","audience":["retrieval_first_assistants","ai_agents"],"best_for":["public product discovery"]},{"id":"root_capabilities_json","title":"Root capabilities.json","role":"product_capabilities","site":"root","format":"json","url":"https://hostrail.dev/capabilities.json","audience":["ai_agents","tool_calling_runtimes","backend_integrators"],"best_for":["supported flows, payment methods, and limitations"]},{"id":"api_agent_card","title":"API Agent Card","role":"execution_manifest","site":"api","format":"json","url":"https://api.hostrail.dev/.well-known/agent-card.json","audience":["tool_calling_runtimes","backend_integrators","ai_agents"],"best_for":["machine-readable capability and auth contract"]},{"id":"api_openapi_json","title":"API OpenAPI","role":"execution_schema","site":"api","format":"json","url":"https://api.hostrail.dev/openapi.json","audience":["tool_calling_runtimes","backend_integrators","sdk_authors"],"best_for":["exact request and response schemas"]}]},{"node_kind":"docs_page","id":"https://docs.hostrail.dev/docs/quickstart/for-developers","title":"Developer Quickstart","description":"Integrate once, access bookable hotel supply, and make your first protected Hostrail call.","url":"https://docs.hostrail.dev/docs/quickstart/for-developers","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/quickstart/for-developers/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/quickstart/for-developers","section":"quickstart","slugs":["quickstart","for-developers"],"full":false,"audience":["backend_integrators","sdk_authors","human_developers"],"best_for":["backend integration setup","first protected API call"],"depends_on":["root-site machine surfaces","openapi"],"switch_to_surfaces":["https://hostrail.dev/capabilities.json","https://api.hostrail.dev/openapi.json","https://api.hostrail.dev/.well-known/agent-card.json"],"prerequisite_pages":[{"title":"How do agents discover this API?","url":"https://docs.hostrail.dev/docs/concepts/discovery","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/discovery/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/discovery","section":"concepts"},{"title":"Agent Quickstart","url":"https://docs.hostrail.dev/docs/quickstart/for-agents","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/quickstart/for-agents/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/quickstart/for-agents","section":"quickstart"},{"title":"API Reference","url":"https://docs.hostrail.dev/docs/api-reference/overview","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/api-reference/overview/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/api-reference/overview","section":"api-reference"}],"next_recommended_pages":[{"title":"API Reference","url":"https://docs.hostrail.dev/docs/api-reference/overview","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/api-reference/overview/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/api-reference/overview","section":"api-reference"},{"title":"How do I test in the sandbox?","url":"https://docs.hostrail.dev/docs/guides/sandbox-testing","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/guides/sandbox-testing/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/guides/sandbox-testing","section":"guides"},{"title":"How do I book a room?","url":"https://docs.hostrail.dev/docs/guides/booking-flow","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/guides/booking-flow/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/guides/booking-flow","section":"guides"}],"deepens_pages":[{"title":"API Reference","url":"https://docs.hostrail.dev/docs/api-reference/overview","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/api-reference/overview/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/api-reference/overview","section":"api-reference"},{"title":"How do I test in the sandbox?","url":"https://docs.hostrail.dev/docs/guides/sandbox-testing","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/guides/sandbox-testing/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/guides/sandbox-testing","section":"guides"}],"related_pages":[{"title":"Hostrail Docs","url":"https://docs.hostrail.dev/docs","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/","section":null},{"title":"What is the envelope contract?","url":"https://docs.hostrail.dev/docs/concepts/envelope","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/envelope/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/envelope","section":"concepts"},{"title":"Terms of Service","url":"https://docs.hostrail.dev/docs/legal/terms","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/legal/terms/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/legal/terms","section":"legal"},{"title":"ACP discovery","url":"https://docs.hostrail.dev/docs/concepts/acp","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/acp/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/acp","section":"concepts"}],"switch_to_surface_links":[{"id":"root_capabilities_json","title":"Root capabilities.json","role":"product_capabilities","site":"root","format":"json","url":"https://hostrail.dev/capabilities.json","audience":["ai_agents","tool_calling_runtimes","backend_integrators"],"best_for":["supported flows, payment methods, and limitations"]},{"id":"api_openapi_json","title":"API OpenAPI","role":"execution_schema","site":"api","format":"json","url":"https://api.hostrail.dev/openapi.json","audience":["tool_calling_runtimes","backend_integrators","sdk_authors"],"best_for":["exact request and response schemas"]},{"id":"api_agent_card","title":"API Agent Card","role":"execution_manifest","site":"api","format":"json","url":"https://api.hostrail.dev/.well-known/agent-card.json","audience":["tool_calling_runtimes","backend_integrators","ai_agents"],"best_for":["machine-readable capability and auth contract"]}]},{"node_kind":"docs_page","id":"https://docs.hostrail.dev/docs/quickstart/for-docs-agents","title":"Docs for AI Agents","description":"How an AI agent should read the Hostrail docs site itself using llms.txt, llms-full.txt, and per-page markdown routes.","url":"https://docs.hostrail.dev/docs/quickstart/for-docs-agents","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/quickstart/for-docs-agents/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/quickstart/for-docs-agents","section":"quickstart","slugs":["quickstart","for-docs-agents"],"full":false,"audience":["ai_agents_reading_docs","retrieval_first_assistants"],"best_for":["choosing the right docs surface before reading markdown","understanding docs corpus vs live product surface"],"depends_on":["docs-site machine surfaces"],"switch_to_surfaces":["https://docs.hostrail.dev/llms.txt","https://docs.hostrail.dev/capabilities.json","https://hostrail.dev/capabilities.json","https://api.hostrail.dev/.well-known/agent-card.json"],"prerequisite_pages":[{"title":"Hostrail Docs","url":"https://docs.hostrail.dev/docs","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/","section":null}],"next_recommended_pages":[{"title":"How do agents discover this API?","url":"https://docs.hostrail.dev/docs/concepts/discovery","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/discovery/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/discovery","section":"concepts"},{"title":"Agent Quickstart","url":"https://docs.hostrail.dev/docs/quickstart/for-agents","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/quickstart/for-agents/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/quickstart/for-agents","section":"quickstart"}],"deepens_pages":[{"title":"How do agents discover this API?","url":"https://docs.hostrail.dev/docs/concepts/discovery","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/concepts/discovery/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/concepts/discovery","section":"concepts"}],"related_pages":[{"title":"Developer Quickstart","url":"https://docs.hostrail.dev/docs/quickstart/for-developers","markdown_url":"https://docs.hostrail.dev/llms.mdx/docs/quickstart/for-developers/content.md","metadata_url":"https://docs.hostrail.dev/docs/meta/quickstart/for-developers","section":"quickstart"}],"switch_to_surface_links":[{"id":"docs_llms_txt","title":"Docs llms.txt","role":"docs_index","site":"docs","format":"markdown","url":"https://docs.hostrail.dev/llms.txt","audience":["ai_agents_reading_docs","retrieval_first_assistants"],"best_for":["first cheap fetch over the docs corpus"]},{"id":"docs_capabilities_json","title":"Docs capabilities.json","role":"docs_capabilities","site":"docs","format":"json","url":"https://docs.hostrail.dev/capabilities.json","audience":["ai_agents_reading_docs","tool_calling_runtimes"],"best_for":["structured summary of the docs corpus"]},{"id":"root_capabilities_json","title":"Root capabilities.json","role":"product_capabilities","site":"root","format":"json","url":"https://hostrail.dev/capabilities.json","audience":["ai_agents","tool_calling_runtimes","backend_integrators"],"best_for":["supported flows, payment methods, and limitations"]},{"id":"api_agent_card","title":"API Agent Card","role":"execution_manifest","site":"api","format":"json","url":"https://api.hostrail.dev/.well-known/agent-card.json","audience":["tool_calling_runtimes","backend_integrators","ai_agents"],"best_for":["machine-readable capability and auth contract"]}]}]},"limitations":["docs markdown explains intended behavior but is not the live booking contract by itself","live price and cancellation terms must be confirmed through quote output","root-site and api-site surfaces should be fetched for public discovery and exact execution details"]}