/**
 * Best-effort WebSearch trace helpers.
 *
 * Writes opt-in JSONL trace records to ~/.ccs/logs/websearch-trace.jsonl so
 * CCS can explain launch intent, MCP exposure, provider selection, and likely
 * bypass scenarios without polluting Claude/MCP stdout.
 */
/// <reference types="node" />
/// <reference types="bun-types" />
export declare function resolveAllowedWebSearchTraceFile(env?: NodeJS.ProcessEnv): string | null;
export declare function isWebSearchTraceEnabled(env?: NodeJS.ProcessEnv): boolean;
export declare function appendWebSearchTrace(event: string, payload?: Record<string, unknown>, env?: NodeJS.ProcessEnv): void;
export declare function readWebSearchTraceRecords(launchId: string, env?: NodeJS.ProcessEnv): Array<Record<string, unknown>>;
export declare function createWebSearchTraceContext(params: {
    launcher: string;
    args: string[];
    cwd?: string;
    profile?: string;
    profileType?: string;
    settingsPath?: string;
    claudeConfigDir?: string;
    env?: NodeJS.ProcessEnv;
}): Record<string, string>;
//# sourceMappingURL=trace.d.ts.map