get_symbol

Every other tool returns context about code. get_symbol returns the code itself — the raw source bytes of a single indexed symbol with its exact start/end lines. It's the precise, bounded alternative to a full-file Read followed by offset arithmetic.

When to call

• You need one function or class body, not the whole file.
• After get_context — pipe the symbol_id from its symbol list straight in.
• To confirm a signature or implementation before editing, without pulling 800 unrelated lines into the context window.

Parameters

Returns

On a miss, returns { error: "Symbol not found …" } with the closest candidate ids so the agent can retry without another get_context call.

Example

get_symbol("src/auth/service.py::AuthService")

get_symbol(
    symbol_id="src/auth/service.py::login",
    context_lines=10,
)

Things worth knowing

• Deterministic on overloads. When a name resolves to more than one definition, resolution is stable — the same id always returns the same symbol.
• Separator-agnostic. file.py::Name, file.py.Name, and file.py/Name all resolve; use whatever get_context handed you.
• Bounded by design. The ~400-line cap keeps a single call from blowing the context window on a giant generated file; truncated tells you when that happened.