@riotprompt/riotprompt 0.0.8 → 0.0.9

package/dist/conversation-logger.d.ts

@@ -0,0 +1,283 @@
+import { ConversationMessage, ToolCall } from './conversation';
+/**
+ * Log format
+ */
+export type LogFormat = 'json' | 'markdown' | 'jsonl';
+/**
+ * Log configuration
+ */
+export interface LogConfig {
+    enabled: boolean;
+    outputPath?: string;
+    format?: LogFormat;
+    filenameTemplate?: string;
+    includeMetadata?: boolean;
+    includePrompt?: boolean;
+    redactSensitive?: boolean;
+    redactPatterns?: RegExp[];
+    onSaved?: (path: string) => void;
+    onError?: (error: Error) => void;
+}
+/**
+ * Logged conversation structure
+ */
+export interface LoggedConversation {
+    id: string;
+    metadata: ConversationLogMetadata;
+    prompt?: PromptSnapshot;
+    messages: LoggedMessage[];
+    summary: ConversationSummary;
+}
+/**
+ * Conversation metadata for logging
+ */
+export interface ConversationLogMetadata {
+    startTime: Date;
+    endTime?: Date;
+    duration?: number;
+    model: string;
+    template?: string;
+    userContext?: Record<string, any>;
+}
+/**
+ * Snapshot of prompt configuration
+ */
+export interface PromptSnapshot {
+    persona?: string;
+    instructions?: string;
+    content?: string[];
+    context?: string[];
+}
+/**
+ * Logged message with metadata
+ */
+export interface LoggedMessage {
+    index: number;
+    timestamp: string;
+    role: string;
+    content: string | null;
+    tool_calls?: ToolCall[];
+    tool_call_id?: string;
+    metadata?: MessageLogMetadata;
+}
+/**
+ * Message metadata for logging
+ */
+export interface MessageLogMetadata {
+    tokens?: number;
+    source?: string;
+    latency?: number;
+    tool?: string;
+    duration?: number;
+    success?: boolean;
+    [key: string]: any;
+}
+/**
+ * Conversation summary
+ */
+export interface ConversationSummary {
+    totalMessages: number;
+    totalTokens?: number;
+    toolCallsExecuted: number;
+    iterations: number;
+    finalOutput?: string;
+    success: boolean;
+}
+/**
+ * Tool call log entry
+ */
+export interface ToolCallLog {
+    callId: string;
+    toolName: string;
+    timestamp: string;
+    iteration: number;
+    arguments: any;
+    result: any;
+    duration: number;
+    success: boolean;
+    error?: string;
+}
+/**
+ * ConversationLogger logs conversations to various formats.
+ *
+ * Features:
+ * - Multiple formats (JSON, Markdown, JSONL)
+ * - Automatic timestamping
+ * - Metadata tracking
+ * - Sensitive data redaction
+ * - Streaming support (JSONL)
+ *
+ * @example
+ * ```typescript
+ * const logger = new ConversationLogger({
+ *   enabled: true,
+ *   outputPath: 'logs/conversations',
+ *   format: 'json',
+ *   includeMetadata: true
+ * });
+ *
+ * logger.onConversationStart({ model: 'gpt-4o', startTime: new Date() });
+ * logger.onMessageAdded(message);
+ * const path = await logger.save();
+ * ```
+ */
+export declare class ConversationLogger {
+    private config;
+    private conversationId;
+    private metadata;
+    private messages;
+    private toolCalls;
+    private startTime;
+    private logger;
+    private messageIndex;
+    constructor(config: LogConfig, logger?: any);
+    /**
+     * Start conversation logging
+     */
+    onConversationStart(metadata: Partial<ConversationLogMetadata>): void;
+    /**
+     * Log a message
+     */
+    onMessageAdded(message: ConversationMessage, metadata?: MessageLogMetadata): void;
+    /**
+     * Log a tool call
+     */
+    onToolCall(callId: string, toolName: string, iteration: number, args: any, result: any, duration: number, success: boolean, error?: string): void;
+    /**
+     * End conversation logging
+     */
+    onConversationEnd(_summary: ConversationSummary): void;
+    /**
+     * Save conversation to disk
+     */
+    save(): Promise<string>;
+    /**
+     * Get logged conversation object
+     */
+    getConversation(): LoggedConversation;
+    /**
+     * Generate unique conversation ID
+     */
+    private generateId;
+    /**
+     * Get output file path
+     */
+    private getOutputPath;
+    /**
+     * Save as JSON
+     */
+    private saveAsJSON;
+    /**
+     * Save as Markdown
+     */
+    private saveAsMarkdown;
+    /**
+     * Append to JSONL file (streaming)
+     */
+    private appendToJSONL;
+    /**
+     * Redact sensitive content
+     */
+    private redactContent;
+}
+/**
+ * Replay options
+ */
+export interface ReplayOptions {
+    model?: string;
+    maxIterations?: number;
+    retryFailedTools?: boolean;
+    toolTimeout?: number;
+    expectSimilarOutput?: boolean;
+}
+/**
+ * Replay result
+ */
+export interface ReplayResult {
+    success: boolean;
+    conversation: LoggedConversation;
+    errors?: Error[];
+}
+/**
+ * Comparison result
+ */
+export interface ComparisonResult {
+    messageDiff: number;
+    toolCallDiff: number;
+    tokenDiff?: number;
+    outputSimilarity: number;
+    costSavings?: number;
+}
+/**
+ * ConversationReplayer loads and replays logged conversations.
+ *
+ * Features:
+ * - Load from various formats
+ * - Replay conversations
+ * - Compare replays with originals
+ * - Export to different formats
+ *
+ * @example
+ * ```typescript
+ * const replayer = await ConversationReplayer.load('logs/conv.json');
+ *
+ * console.log('Messages:', replayer.messages.length);
+ * console.log('Tool calls:', replayer.getToolCalls().length);
+ *
+ * const timeline = replayer.getTimeline();
+ * console.log('Events:', timeline.length);
+ * ```
+ */
+export declare class ConversationReplayer {
+    private conversation;
+    private logger;
+    private constructor();
+    /**
+     * Load conversation from file
+     */
+    static load(filePath: string, logger?: any): Promise<ConversationReplayer>;
+    /**
+     * Load latest conversation from directory
+     */
+    static loadLatest(directory: string, logger?: any): Promise<ConversationReplayer>;
+    /**
+     * Get all messages
+     */
+    get messages(): LoggedMessage[];
+    /**
+     * Get conversation metadata
+     */
+    getMetadata(): ConversationLogMetadata;
+    /**
+     * Get tool calls
+     */
+    getToolCalls(): ToolCallLog[];
+    /**
+     * Get message at index
+     */
+    getMessageAt(index: number): LoggedMessage | undefined;
+    /**
+     * Get timeline of events
+     */
+    getTimeline(): TimelineEvent[];
+    /**
+     * Export to format
+     */
+    exportToFormat(format: LogFormat, outputPath: string): Promise<string>;
+    /**
+     * Export as markdown
+     */
+    private exportMarkdown;
+}
+/**
+ * Timeline event interface
+ */
+interface TimelineEvent {
+    timestamp: string;
+    iteration: number;
+    type: string;
+    description: string;
+    duration?: number;
+    success?: boolean;
+}
+export default ConversationLogger;