Module agent 

Shared compact responses for agent-facing MCP and CLI queries.

This module is the contract boundary between graph retrieval and agent presentation. Both interfaces must call these functions so ranking, ambiguity handling, and response budgets cannot drift.

Structs

AgentCallersResponse

AgentQueryOptions

AgentSearchResponse

AgentSubgraphResponse

AgentSymbolContextResponse

CallerEvidence

ConfidenceMix

Coverage

NeighborhoodCoverage

RelationEvidence

SearchCoverage

SearchEvidence

SymbolCandidate

Enums

AgentStatus

Functions

find_callers

Find callers for exactly one symbol and return a globally-budgeted response. Ambiguous short names return candidates without traversing the graph.

format_search

Format ranked search hits as compact implementation evidence shared by CLI and MCP. Retrieval may be lexical-only or RRF hybrid; presentation is stable.

get_subgraph

Return a compact, exact-ID neighborhood digest. Only direct relationships are serialized as evidence; deeper traversal contributes coverage counts.

symbol_context

360° view of exactly one resolved symbol: direct callers, callees, and type usages. Unlike the old name-based GraphStore::symbol_context, this goes through resolve_symbol first so an ambiguous short name (e.g. two unrelated beginArray methods) surfaces candidates instead of silently picking one — the same ambiguity handling find_callers/get_subgraph already have.