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": "Target symbol packet (with optional windowed body) and neighborhood edges.",
+ "properties": {
+ "edges": {
+ "description": "Observed caller/callee edges within depth.",
+ "items": {
+ "additionalProperties": true,
+ "description": "Observed AST/lexical call or reference edge between symbols.",
+ "properties": {
+ "backend": {
+ "description": "Extractor backend producing this edge.",
+ "type": "string"
+ },
+ "confidence": {
+ "description": "Edge resolution confidence in [0.0, 1.0].",
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "edge_kind": {
+ "description": "Relationship kind (e.g. calls, instantiates, inherits).",
+ "type": "string"
+ },
+ "source_line": {
+ "description": "1-based line number of the edge.",
+ "type": "integer"
+ },
+ "source_path": {
+ "description": "File path where the edge occurs.",
+ "type": "string"
+ },
+ "source_symbol_id": {
+ "description": "Caller or source symbol ID.",
+ "type": "string"
+ },
+ "status": {
+ "description": "Resolution status ('resolved', 'ambiguous', or 'unresolved').",
+ "type": "string"
+ },
+ "target_name": {
+ "description": "Target symbol name at call site.",
+ "type": "string"
+ },
+ "target_symbol_id": {
+ "description": "Resolved target symbol ID, or null if external/unresolved.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "estimator_version": {
+ "description": "Token estimator version.",
+ "type": "string"
+ },
+ "external_stubs": {
+ "additionalProperties": true,
+ "description": "External library stub metadata for cross-package calls.",
+ "type": "object"
+ },
+ "omitted_count": {
+ "description": "Count of neighbor symbols omitted due to budget.",
+ "type": "integer"
+ },
+ "omitted_edge_count": {
+ "description": "Count of edges omitted due to budget.",
+ "type": "integer"
+ },
+ "omitted_symbol_ids": {
+ "description": "Up to 10 omitted neighbor symbol IDs when include_omitted_ids=True.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "root_body_hint": {
+ "description": "Paging instruction when body exceeds max_tokens.",
+ "type": "string"
+ },
+ "root_body_lines": {
+ "description": "Line count of target symbol when body was omitted.",
+ "type": "integer"
+ },
+ "root_body_tokens_needed": {
+ "description": "Estimated tokens needed if body was omitted due to budget.",
+ "type": "integer"
+ },
+ "root_symbol_id": {
+ "description": "Canonical symbol_id of the target symbol.",
+ "type": "string"
+ },
+ "symbols": {
+ "description": "Root and neighbor symbol packets.",
+ "items": {
+ "additionalProperties": true,
+ "properties": {
+ "body_included": {
+ "description": "True if full/windowed body is included.",
+ "type": "boolean"
+ },
+ "body_window": {
+ "additionalProperties": true,
+ "description": "Paging window metadata when body_offset_line is used.",
+ "properties": {
+ "end_line": {
+ "description": "1-based last line in this window.",
+ "type": "integer"
+ },
+ "next_offset": {
+ "description": "Next body_offset_line to read, or null at EOF.",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "start_line": {
+ "description": "1-based first line in this window.",
+ "type": "integer"
+ },
+ "total_lines": {
+ "description": "Total lines in symbol body.",
+ "type": "integer"
+ }
+ },
+ "type": "object"
+ },
+ "content": {
+ "description": "Source code body or signature header (null if stale).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "redacted_lines": {
+ "description": "Number of secret-redacted lines.",
+ "type": "integer"
+ },
+ "symbol": {
+ "additionalProperties": true,
+ "description": "Indexed symbol definition metadata.",
+ "properties": {
+ "end_line": {
+ "description": "1-based declaration end line.",
+ "type": "integer"
+ },
+ "kind": {
+ "description": "Symbol kind (function, class, method, interface, etc.).",
+ "type": "string"
+ },
+ "name": {
+ "description": "Short symbol name.",
+ "type": "string"
+ },
+ "path": {
+ "description": "Repository-relative file path.",
+ "type": "string"
+ },
+ "qualified_name": {
+ "description": "Qualified symbol name.",
+ "type": "string"
+ },
+ "roles": {
+ "description": "Detected semantic/architectural roles.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "signature": {
+ "description": "Declaration signature header.",
+ "type": "string"
+ },
+ "start_line": {
+ "description": "1-based declaration start line.",
+ "type": "integer"
+ },
+ "symbol_id": {
+ "description": "Canonical repository-scoped symbol identifier.",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "warnings": {
+ "description": "Per-symbol warnings.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "edge_precision": {
+ "additionalProperties": true,
+ "description": "Resolved vs. ambiguous edge ratio summary.",
+ "properties": {
+ "ambiguous_rate": {
+ "description": "Fraction of edges marked ambiguous.",
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "basis": {
+ "description": "Measurement basis.",
+ "type": "string"
+ },
+ "resolved_rate": {
+ "description": "Fraction of edges resolved unambiguously.",
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ },
+ "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"
+}