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": "Composite resolution status, target symbol metadata, optional body/packet, and direct relationships.",
+ "properties": {
+ "candidate_count": {
+ "description": "Number of matching candidates when status='ambiguous'.",
+ "type": "integer"
+ },
+ "candidates": {
+ "description": "Up to 5 disambiguation candidates when status='ambiguous'.",
+ "items": {
+ "additionalProperties": true,
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "content": {
+ "description": "Target symbol body in view='normal' (null if omitted/stale).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "message": {
+ "description": "Guidance message when status is 'not_found' or 'ambiguous'.",
+ "type": "string"
+ },
+ "packet": {
+ "additionalProperties": true,
+ "description": "Full context packet with target body, callers/callees, and tests when view='full'.",
+ "type": "object"
+ },
+ "query": {
+ "description": "Original symbol name or pattern query.",
+ "type": "string"
+ },
+ "relationship_count": {
+ "description": "Number of relationships included.",
+ "type": "integer"
+ },
+ "relationships": {
+ "description": "Direct 1-hop caller/callee entries (tuples in minimal, dicts in normal).",
+ "items": {},
+ "type": "array"
+ },
+ "relationships_filtered": {
+ "description": "Count of low-confidence or ambiguous edges excluded.",
+ "type": "integer"
+ },
+ "relationships_omitted": {
+ "description": "Count of relationships omitted due to budget.",
+ "type": "integer"
+ },
+ "retry_hint": {
+ "additionalProperties": true,
+ "description": "Follow-up get_symbol_context call parameters if body was clipped.",
+ "type": "object"
+ },
+ "status": {
+ "description": "Resolution outcome: 'resolved', 'ambiguous', or 'not_found'.",
+ "type": "string"
+ },
+ "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"
+ },
+ "target_symbol_id": {
+ "description": "Resolved canonical symbol_id (when status='resolved').",
+ "type": "string"
+ }
+ },
+ "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"
+}