/**
 * `codebase-incoming-calls` tool — find all callers/users of a symbol.
 *
 * Usage: codebase-incoming-calls({
 *   symbol: string,        // function/method/type name to look up
 *   file?: string,         // scope to one file when multiple symbols share a name
 *   limit?: number,        // max results (default 50, max 200)
 * })
 *
 * Returns: [{ symbol: { name, kind, file, line, signature }, callType, line }, ...]
 *
 * The query executes against the SQLite index's refs graph — it resolves the
 * symbol name to IDs, then finds every ref edge pointing TO those IDs. The
 * result carries the caller's full metadata so no second lookup is needed.
 */
import type { Tool } from '@wrongstack/core/types';
import type { CallSite } from './schema.js';
export declare const codebaseIncomingCallsTool: Tool<IncomingCallsInput, IncomingCallsOutput>;
export interface IncomingCallsInput {
    symbol: string;
    file?: string | undefined;
    limit?: number | undefined;
    transitive?: boolean | undefined;
}
export type CodebaseIncomingCallsInput = IncomingCallsInput;
export interface IncomingCallsOutput {
    symbol: string;
    calls: CallSite[];
    total: number;
    /**
     * True when the project server served a previous generation's cached
     * answer during a refresh. Results are internally consistent but may lag
     * the files currently being indexed.
     */
    stale?: boolean | undefined;
    /** Advisory note when the symbol was not found in the index. */
    note?: string | undefined;
}
export type CodebaseIncomingCallsOutput = IncomingCallsOutput;
//# sourceMappingURL=codebase-incoming-calls-tool.d.ts.map