{"id":"json-schema-instance-locate","version":"1.0.0","description":"Resolve RFC 6901 instance locations (string or URI fragment) from schema errors to values, or say why they fail.","supported_operations":["show the offending values at json schema error instance locations","resolve instance_location pointers from validation errors","convert json pointer to uri fragment identifier and resolve it","resolve percent-encoded json pointer uri fragment against a document","why does this json pointer not resolve in the llm output","look up several rfc 6901 pointers without failing on missing paths"],"unsupported_operations":["relative JSON Pointers","JSONPath or JMESPath queries","modifying the instance (patch, add, remove)","resolving pointers inside a schema through $ref"],"semantics":["Each location is a JSON Pointer in JSON string form (\"\" or starting with \"/\", RFC 6901 section 5) or in URI fragment form (starting with \"#\", section 6). Fragment form is percent-decoded as UTF-8; characters outside the RFC 3986 fragment rule must be percent-encoded. A malformed location (bad ~ escape, missing leading \"/\", bad percent-encoding, invalid UTF-8) is invalid_input.","Each result has location (as given), pointer (string form), uri_fragment (UTF-8 percent-encoding of every character outside unreserved, sub-delims, \":\", \"@\", \"/\", \"?\", uppercase hex) and found. When found, value is a copy of the referenced JSON value (-0 becomes 0).","When not found, reason is one of missing_member, index_out_of_range, invalid_array_index (leading zeros or non-digits on an array), end_of_array_token (\"-\", which names the nonexistent element after the last per RFC 6901 section 4) or not_a_container, and matched_pointer is the longest prefix that did resolve.","Results keep the order of locations; duplicates are resolved again. Object member names compare by exact code units (no Unicode normalization).","More than 64 locations, input over 65536 bytes, an instance nested deeper than 32 levels, or output over 262144 bytes is limit_exceeded."],"limits":{"max_input_bytes":65536,"max_locations":64,"max_json_depth":32,"max_output_bytes":262144},"pricing":{"status":"unpriced","charge_usd":null},"input_schema":{"type":"object","additionalProperties":false,"required":["instance","locations"],"properties":{"instance":{"description":"The JSON value the locations point into (for example the validated LLM output)"},"locations":{"type":"array","maxItems":64,"items":{"type":"string"}}}},"output_schema":{"type":"object","additionalProperties":false,"required":["results"],"properties":{"results":{"type":"array","maxItems":64,"items":{"type":"object","additionalProperties":false,"required":["location","pointer","uri_fragment","found"],"properties":{"location":{"type":"string"},"pointer":{"type":"string"},"uri_fragment":{"type":"string"},"found":{"type":"boolean"},"value":{},"reason":{"type":"string","enum":["missing_member","index_out_of_range","invalid_array_index","end_of_array_token","not_a_container"]},"matched_pointer":{"type":"string"}}}}}},"examples":[{"input":{"instance":{"items":[{"price":"12"}],"a/b":1},"locations":["/items/0/price","#/a~1b","/items/1"]},"output":{"results":[{"location":"/items/0/price","pointer":"/items/0/price","uri_fragment":"#/items/0/price","found":true,"value":"12"},{"location":"#/a~1b","pointer":"/a~1b","uri_fragment":"#/a~1b","found":true,"value":1},{"location":"/items/1","pointer":"/items/1","uri_fragment":"#/items/1","found":false,"reason":"index_out_of_range","matched_pointer":"/items"}]}},{"input":{"instance":{"c%d":2},"locations":["/c%d"]},"output":{"results":[{"location":"/c%d","pointer":"/c%d","uri_fragment":"#/c%25d","found":true,"value":2}]}}],"execute_url":"/v1/tools/json-schema-instance-locate/versions/1.0.0/execute"}