/**
 * Debug telemetry for teams-api.
 *
 * Intended for developer use only — not a user-facing feature.
 * Logs complete tool inputs, raw API results, formatted outputs, and errors
 * to a local JSONL file so you can replay, inspect, and debug any interaction.
 *
 * OFF by default. Enable with the environment variable:
 *   TEAMS_TELEMETRY=true
 *
 * Storage paths (directory created automatically):
 *   macOS:   ~/Library/Application Support/teams-api/telemetry.jsonl
 *   Linux:   $XDG_DATA_HOME/teams-api/telemetry.jsonl  (default: ~/.local/share/teams-api/telemetry.jsonl)
 *   Windows: %APPDATA%\teams-api\telemetry.jsonl
 *
 * Override the output path entirely with TEAMS_TELEMETRY_PATH (useful for testing).
 *
 * Each line in the file is a self-contained JSON object (JSONL).
 * Clear the file manually to start fresh.
 */
import type { Platform } from "./platform.js";
/** Returns a stable session ID for this process lifetime (random UUID). */
export declare function getSessionId(): string;
/** Returns the platform-appropriate directory for telemetry data. */
export declare function getTelemetryDir(platform?: Platform): string;
/** Returns the full path to the telemetry JSONL file. */
export declare function getTelemetryPath(platform?: Platform): string;
/** Returns true when telemetry is enabled via TEAMS_TELEMETRY=true. */
export declare function isTelemetryEnabled(): boolean;
/**
 * Record a completed tool call with its full input, raw API result,
 * formatted output string, and timing.
 */
export declare function recordToolCall(opts: {
    tool: string;
    format: string;
    parameters: Record<string, unknown>;
    result: unknown;
    output: string;
    durationMs: number;
}): void;
/**
 * Record a failed tool call with the full error.
 */
export declare function recordToolError(opts: {
    tool: string;
    format: string;
    parameters: Record<string, unknown>;
    error: unknown;
    durationMs: number;
}): void;
/**
 * Record an authentication attempt.
 */
export declare function recordAuth(opts: {
    strategy: "auto" | "login" | "debug" | "token";
    success: boolean;
    error?: unknown;
}): void;
//# sourceMappingURL=telemetry.d.ts.map