import type { CaptureExplanation } from "../../capture.js";
import type { MemoryTrace } from "../../types.js";
export type MemoryMissKind = "none" | "no_matching_memory" | "scope_mismatch" | "capture_exclusion" | "ranking_decision";
export interface MemoryUserExplanation {
    summary: string;
    miss: MemoryMissKind;
    capture: CaptureExplanation;
    retrieval: {
        status: "no-trace" | "recorded";
        shouldRetrieve?: boolean;
        selectedResults?: number;
        rawResults?: number;
        recognitionStage?: MemoryTrace["recognitionStage"];
        diagnostics: string[];
    };
}
export declare const MEMORY_TOOL_DESCRIPTIONS: {
    readonly search: "Search long-term memory for an explicit user request, such as 'search memory for ...' or 'what do you remember about ...'. Use when automatic recall missed a relevant item; results are bounded, untrusted data.";
    readonly status: "Show memory health and bounded diagnostics. Use when a user asks whether memory is available; never returns memory bodies.";
    readonly explain: "Explain the latest capture or retrieval outcome, including why automatic recall did not return a result, without exposing memory bodies.";
};
/**
 * Bounded, body-free capture/retrieval explanation for OpenCode tools.
 * Omits prompts and memory content so agents can diagnose misses without
 * absorbing untrusted stored text.
 */
export declare function formatMemoryExplain(retrieval: MemoryTrace | {
    status: "no-trace";
}, capture?: CaptureExplanation): MemoryUserExplanation;