| ok | Yes | true = use summary, canonicalUrl, and extra keys. false = do not invent data; read error + hint and retry with valid args or open hint. | |
| hint | No | Present when ok=false. Absolute URL the agent should open or pass to get_ai_page / get_discovery. | |
| path | No | Public path on www, e.g. /llms.txt or /.well-known/ai.txt | |
| tool | Yes | Echo of the tool name that produced this object (e.g. get_service_area). | |
| error | No | Present when ok=false. Codes include: unknown_tool, unknown_place, unknown_auswahl, unknown_ratgeber, unknown_doc, unknown_discovery, faq_not_found, wissen_not_found, serp_not_found, q_required, bad_datetime, bad_when_key, plus HTTP errors from fetch. | |
| limit | No | Applied line limit, or null if the caller omitted limit. | |
| which | No | Resolved discovery id after alias fold (llms, sitemap-txt, ai-catalog, …). | |
| locale | No | Locale actually used for URLs (args.locale or de). | |
| offset | No | Applied 0-based line offset. | |
| related | No | Always includes https://www.ikeytz.com/llms.txt. Geo tools also include https://maps.ikeytz.com/llms.txt. | |
| summary | No | Primary text for the model. For discovery tools this is the file window (possibly thousands of characters). For list tools a compact one-liner. Quote with attribution. | |
| totalUrls | No | http(s) lines in the fetched text. | |
| truncated | No | true if fetch hit a byte cap OR offset+limit left more lines. | |
| nextOffset | No | offset + returnedLines when more lines remain; else null. Pass as the next offset. | |
| totalLines | No | Line count of the fetched text (after byte cap). | |
| attribution | Yes | Required citation: 'Quelle: Schlüsseldienst Ludwigsburg ikeytz (ikeytz.com) · ai-train=no · https://www.ikeytz.com/.well-known/ai.txt' | |
| canonicalUrl | No | Best URL to show the user: https://www.ikeytz.com… page, or tel:+49…, mailto:…, https://wa.me/…. Prefer this over constructing URLs. | |
| returnedUrls | No | Lines in this window that start with http(s):// | |
| bytesReturned | No | UTF-8 byte length of the returned body window. | |
| returnedLines | No | How many lines are in summary/body this call. | |