import type { RecallTool } from "./config.js";
/**
 * A recall is the agent going back to a stored full output. A whole-file read undoes the saving; a scoped search or a
 * ranged read keeps it. The footer under every excerpt names a search command that exists on this machine, detected
 * once at load. Detection never runs inside a tool_result handler.
 */
export type SearchTool = Exclude<RecallTool, "auto">;
/** First working tool in the chain, or `none`. A configured tool other than `auto` is trusted without a probe. */
export declare function detectSearchTool(configured?: RecallTool, timeoutMs?: number): Promise<SearchTool>;
/** Footer under an excerpt or duplicate note. Tells the agent how to get a part back without re-reading everything. */
export declare function recallInstruction(tool: SearchTool, path: string): string;
/** `full` when the call loads the entire stored file into context; `scoped` for searches, ranged reads, and sandboxed processing. */
export declare function classifyRecall(toolName: string, input: unknown, path: string): "full" | "scoped";