Skip to content

Callees

callees

CalleesTool — find functions called by a symbol.

CalleeEntry

Bases: TypedDict

Serialized callee record for ast_callees output.

Source code in packages/axm-ast/src/axm_ast/tools/callees.py
Python
18
19
20
21
22
23
class CalleeEntry(TypedDict):
    """Serialized callee record for ``ast_callees`` output."""

    module: str
    line: int
    call_expression: str

CalleesTool

Bases: AXMTool

Find all functions/methods called by a given symbol.

Registered as ast_callees via axm.tools entry point. This is the inverse of ast_callers: given a function name, returns all call-sites within that function body.

Source code in packages/axm-ast/src/axm_ast/tools/callees.py
Python
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
class CalleesTool(AXMTool):
    """Find all functions/methods called by a given symbol.

    Registered as ``ast_callees`` via axm.tools entry point.
    This is the inverse of ``ast_callers``: given a function name,
    returns all call-sites *within* that function body.
    """

    agent_hint: str = (
        "Find all functions called by a symbol"
        " — the inverse of ast_callers."
        " Returns call-sites with module, line, call_expression."
    )

    @property
    def name(self) -> str:
        """Return tool name for registry lookup."""
        return "ast_callees"

    @staticmethod
    def render_text(callees: list[CalleeEntry], *, symbol: str) -> str:
        """Render callees as compact text for token-efficient MCP responses."""
        header = f"ast_callees | {symbol} | {len(callees)} callees"
        if not callees:
            return header
        lines = [header]
        for c in callees:
            module = c["module"].removeprefix("src.")
            line = c["line"]
            call_expression = c["call_expression"]
            lines.append(f"{module}:{line} {call_expression}")
        return "\n".join(lines)

    @safe_execute
    def execute(
        self, *, path: str = ".", symbol: str | None = None, **kwargs: object
    ) -> ToolResult:
        """Find all callees of a symbol.

        Args:
            path: Path to package or workspace directory.
            symbol: Symbol name to search for (required).

        Returns:
            ToolResult with callee list.
        """
        if not symbol:
            return ToolResult(success=False, error="symbol parameter is required")

        project_path = Path(path).resolve()
        if not project_path.is_dir():
            return ToolResult(success=False, error=f"Not a directory: {project_path}")

        try:
            from axm_ast.core.flows import find_callees_workspace
            from axm_ast.core.workspace import analyze_workspace

            ws = analyze_workspace(project_path)
            callees = find_callees_workspace(ws, symbol)
        except ValueError:
            from axm_ast.core.cache import get_package
            from axm_ast.core.flows import find_callees

            pkg = get_package(project_path)
            callees = find_callees(pkg, symbol)

        callee_data: list[CalleeEntry] = [
            {
                "module": c.module,
                "line": c.line,
                "call_expression": c.call_expression,
            }
            for c in callees
        ]

        return ToolResult(
            success=True,
            data={"callees": callee_data, "count": len(callee_data)},
            text=CalleesTool.render_text(callee_data, symbol=symbol),
        )
name property

Return tool name for registry lookup.

execute(*, path='.', symbol=None, **kwargs)

Find all callees of a symbol.

Parameters:

Name Type Description Default
path str

Path to package or workspace directory.

 '.'
symbol str | None

Symbol name to search for (required).

 None

Returns:

Type Description
ToolResult

ToolResult with callee list.
Source code in packages/axm-ast/src/axm_ast/tools/callees.py
Python
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
@safe_execute
def execute(
    self, *, path: str = ".", symbol: str | None = None, **kwargs: object
) -> ToolResult:
    """Find all callees of a symbol.

    Args:
        path: Path to package or workspace directory.
        symbol: Symbol name to search for (required).

    Returns:
        ToolResult with callee list.
    """
    if not symbol:
        return ToolResult(success=False, error="symbol parameter is required")

    project_path = Path(path).resolve()
    if not project_path.is_dir():
        return ToolResult(success=False, error=f"Not a directory: {project_path}")

    try:
        from axm_ast.core.flows import find_callees_workspace
        from axm_ast.core.workspace import analyze_workspace

        ws = analyze_workspace(project_path)
        callees = find_callees_workspace(ws, symbol)
    except ValueError:
        from axm_ast.core.cache import get_package
        from axm_ast.core.flows import find_callees

        pkg = get_package(project_path)
        callees = find_callees(pkg, symbol)

    callee_data: list[CalleeEntry] = [
        {
            "module": c.module,
            "line": c.line,
            "call_expression": c.call_expression,
        }
        for c in callees
    ]

    return ToolResult(
        success=True,
        data={"callees": callee_data, "count": len(callee_data)},
        text=CalleesTool.render_text(callee_data, symbol=symbol),
    )
render_text(callees, *, symbol) staticmethod

Render callees as compact text for token-efficient MCP responses.

Source code in packages/axm-ast/src/axm_ast/tools/callees.py
Python
45
46
47
48
49
50
51
52
53
54
55
56
57
@staticmethod
def render_text(callees: list[CalleeEntry], *, symbol: str) -> str:
    """Render callees as compact text for token-efficient MCP responses."""
    header = f"ast_callees | {symbol} | {len(callees)} callees"
    if not callees:
        return header
    lines = [header]
    for c in callees:
        module = c["module"].removeprefix("src.")
        line = c["line"]
        call_expression = c["call_expression"]
        lines.append(f"{module}:{line} {call_expression}")
    return "\n".join(lines)