changedOutput schema / (root)
Previous value: -nullNew value: +{
+ "additionalProperties": true,
+ "properties": {
+ "budget": {
+ "additionalProperties": true,
+ "description": "Token budget accounting for this response.",
+ "properties": {
+ "envelope_reserve": {
+ "description": "Wire-framing token reserve when budget >= 512.",
+ "type": "integer"
+ },
+ "estimated_tokens": {
+ "description": "Estimated serialized response tokens.",
+ "type": "integer"
+ },
+ "requested_tokens": {
+ "description": "Requested or profile-default token budget.",
+ "type": "integer"
+ }
+ },
+ "type": "object"
+ },
+ "completeness": {
+ "additionalProperties": true,
+ "description": "Coverage/resolution completeness indicator.",
+ "properties": {
+ "basis": {
+ "description": "How completeness was computed.",
+ "type": "string"
+ },
+ "value": {
+ "description": "Completeness ratio in [0.0, 1.0], or null if N/A.",
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "data": {
+ "additionalProperties": true,
+ "description": "Ranked source hits and optional 1-2 hop graph neighbors.",
+ "properties": {
+ "estimator_version": {
+ "description": "Token estimator version.",
+ "type": "string"
+ },
+ "matches": {
+ "description": "Matched symbol snippets ordered by FTS5 relevance.",
+ "items": {
+ "additionalProperties": true,
+ "properties": {
+ "end_line": {
+ "description": "1-based end line of the match.",
+ "type": "integer"
+ },
+ "lines": {
+ "description": "Pairs of [line_number, text].",
+ "items": {
+ "type": "array"
+ },
+ "type": "array"
+ },
+ "path": {
+ "description": "Repository-relative file path.",
+ "type": "string"
+ },
+ "redacted_lines": {
+ "description": "Number of redacted lines if secrets were masked.",
+ "type": "integer"
+ },
+ "snippet": {
+ "description": "Matched source line (secret-redacted).",
+ "type": "string"
+ },
+ "start_line": {
+ "description": "1-based line number of the match.",
+ "type": "integer"
+ },
+ "symbol_id": {
+ "description": "Enclosing symbol ID, or null for module-level hits.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "neighbors": {
+ "description": "Expanded caller/callee neighbor tuples when expand='graph'.",
+ "items": {
+ "type": "array"
+ },
+ "type": "array"
+ },
+ "omitted_count": {
+ "description": "Number of search matches omitted due to limit or budget.",
+ "type": "integer"
+ },
+ "prior_evidence": {
+ "additionalProperties": true,
+ "description": "Matching verified evidence card from the repo ledger when available.",
+ "properties": {
+ "card_id": {
+ "description": "Ledger card identifier.",
+ "type": "integer"
+ },
+ "recheck_from": {
+ "description": "Stale anchor paths requiring re-verification when VERIFY_FAILED.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "status": {
+ "description": "Ledger verification status ('confirmed', 'valid', or 'VERIFY_FAILED').",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "query": {
+ "description": "Search query string.",
+ "type": "string"
+ },
+ "retrieval": {
+ "additionalProperties": true,
+ "description": "Graph expansion diagnostics when expand='graph'.",
+ "properties": {
+ "anchors": {
+ "description": "Number of anchor symbols expanded.",
+ "type": "integer"
+ },
+ "expand_effective": {
+ "description": "Effective expansion mode used.",
+ "type": "string"
+ },
+ "expand_hops": {
+ "description": "Graph traversal depth applied.",
+ "type": "integer"
+ },
+ "expand_k": {
+ "description": "Top-k anchors limit applied.",
+ "type": "integer"
+ },
+ "min_confidence": {
+ "description": "Minimum edge confidence filter applied.",
+ "type": "number"
+ },
+ "neighbors": {
+ "description": "Number of neighbor rows returned.",
+ "type": "integer"
+ },
+ "profile_effective": {
+ "description": "Active budget profile.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "type": "object"
+ },
+ "error": {
+ "additionalProperties": true,
+ "description": "Present when the tool call fails (either a structured {code, message, details} object or a diagnostic string).",
+ "properties": {
+ "code": {
+ "description": "Machine-readable error code.",
+ "type": "string"
+ },
+ "details": {
+ "description": "Optional structured metadata for the error.",
+ "type": "object"
+ },
+ "message": {
+ "description": "Human-readable error explanation.",
+ "type": "string"
+ }
+ },
+ "type": [
+ "object",
+ "string"
+ ]
+ },
+ "evidence": {
+ "description": "Source-verified file line spans and SHA-256 hashes backing the response.",
+ "items": {
+ "additionalProperties": true,
+ "properties": {
+ "end_line": {
+ "description": "1-based end line in source.",
+ "type": "integer"
+ },
+ "path": {
+ "description": "Repository-relative file path.",
+ "type": "string"
+ },
+ "sha256": {
+ "description": "12-character hex prefix of indexed file SHA-256.",
+ "type": "string"
+ },
+ "start_line": {
+ "description": "1-based start line in source.",
+ "type": "integer"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "freshness": {
+ "description": "Index freshness state ('fresh', 'pending', 'stale', or 'unknown').",
+ "type": "string"
+ },
+ "index_run_id": {
+ "description": "Identifier of the active index snapshot run.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ledger_rev": {
+ "description": "Current evidence ledger revision for repo_id.",
+ "type": "integer"
+ },
+ "repo_id": {
+ "description": "Registered repository identifier.",
+ "type": "string"
+ },
+ "schema_version": {
+ "description": "Envelope schema version ('1.0').",
+ "type": "string"
+ },
+ "truncated": {
+ "description": "True if items were omitted due to budget or node limits.",
+ "type": "boolean"
+ },
+ "untrusted_repository_content": {
+ "description": "True when payload embeds raw repository text.",
+ "type": "boolean"
+ },
+ "warnings": {
+ "description": "Freshness, ambiguity, redaction, or security warnings.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "type": "object"
+}