/**
 * chat.traces — retrieve the full execution trace of a chat by its id.
 *
 * Returns persisted messages (with executed tool calls), outbound LLM context
 * flow, chain-of-thought, and any agent threads + activity logs tied to the
 * session. Designed for an agent to inspect how a past chat ran — e.g. to
 * evaluate provider behaviour, diagnose loops, or audit tool usage.
 */
import type { ToolDefinition } from "./contracts.js";
import type { ChatTracesService } from "../services/chat-traces.js";
export interface ChatTracesToolInput {
    /** Chat (session) id to fetch traces for. */
    chatId: string;
    /** Include chat messages. Defaults to true. */
    includeMessages?: boolean;
    /** Include agent threads + their activities. Defaults to true. */
    includeThreads?: boolean;
    /** Include parsed tool-call payloads on assistant messages. Defaults to true. */
    includeToolCalls?: boolean;
    /** Include the full outbound LLM context-flow rounds. Verbose — defaults to false. */
    includeContextFlow?: boolean;
    /** Include chain-of-thought / reasoning content. Defaults to false. */
    includeThinking?: boolean;
    /** Max messages to return (most recent). Defaults to 200, capped at 1000. */
    messageLimit?: number;
    /** Max thread activities per thread. Defaults to 200, capped at 2000. */
    activityLimit?: number;
}
export declare function createChatTracesTool(tracesService: ChatTracesService): ToolDefinition<ChatTracesToolInput>;
//# sourceMappingURL=chat-traces-tools.d.ts.map