centaurus-cli 2.7.3 → 2.8.1

package/dist/utils/conversation-logger.js

@@ -0,0 +1,283 @@
+/**
+ * Conversation Logger
+ *
+ * Comprehensive logging utility for AI conversation debugging.
+ * Logs all messages, tool calls, thoughts, and feedback to help
+ * debug issues like hallucination, looping, or getting stuck.
+ */
+import * as fs from 'fs';
+// Log levels
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel["DEBUG"] = "DEBUG";
+    LogLevel["INFO"] = "INFO";
+    LogLevel["WARN"] = "WARN";
+    LogLevel["ERROR"] = "ERROR";
+})(LogLevel || (LogLevel = {}));
+// Log categories for filtering
+export var LogCategory;
+(function (LogCategory) {
+    LogCategory["SESSION"] = "SESSION";
+    LogCategory["USER_MSG"] = "USER_MSG";
+    LogCategory["AI_TEXT"] = "AI_TEXT";
+    LogCategory["THOUGHT"] = "THOUGHT";
+    LogCategory["TOOL_CALL"] = "TOOL_CALL";
+    LogCategory["TOOL_EXEC"] = "TOOL_EXEC";
+    LogCategory["TOOL_RESULT"] = "TOOL_RESULT";
+    LogCategory["LOOP"] = "LOOP";
+    LogCategory["NARRATION"] = "NARRATION";
+    LogCategory["ERROR"] = "ERROR";
+    LogCategory["SYSTEM"] = "SYSTEM";
+})(LogCategory || (LogCategory = {}));
+/**
+ * ConversationLogger class for structured conversation logging
+ */
+export class ConversationLogger {
+    logFilePath;
+    sessionId = '';
+    currentTurn = 0;
+    accumulatedThought = '';
+    accumulatedAIText = '';
+    enabled = true;
+    constructor(logFilePath = 'cli_frontend_logs.txt') {
+        this.logFilePath = logFilePath;
+    }
+    /**
+     * Enable or disable logging
+     */
+    setEnabled(enabled) {
+        this.enabled = enabled;
+    }
+    /**
+     * Start a new conversation session
+     */
+    startSession() {
+        // Generate a short session ID
+        this.sessionId = `sess_${Date.now().toString(36)}`;
+        this.currentTurn = 0;
+        this.accumulatedThought = '';
+        this.accumulatedAIText = '';
+        this.log(LogLevel.INFO, LogCategory.SESSION, '═══════════════════════════════════════════════════════════════════════════════');
+        this.log(LogLevel.INFO, LogCategory.SESSION, `NEW CONVERSATION SESSION STARTED`);
+        this.log(LogLevel.INFO, LogCategory.SESSION, '═══════════════════════════════════════════════════════════════════════════════');
+    }
+    /**
+     * Log a user message
+     */
+    logUserMessage(message) {
+        this.log(LogLevel.INFO, LogCategory.USER_MSG, 'User message received', {
+            content: message,
+            length: message.length,
+        });
+    }
+    /**
+     * Log AI text chunk (streaming)
+     */
+    logAITextChunk(chunk) {
+        this.accumulatedAIText += chunk;
+        this.log(LogLevel.DEBUG, LogCategory.AI_TEXT, 'AI text chunk received', {
+            chunkLength: chunk.length,
+            totalLength: this.accumulatedAIText.length,
+            chunk: chunk.substring(0, 200) + (chunk.length > 200 ? '...' : ''),
+        });
+    }
+    /**
+     * Log completed AI text response
+     */
+    logAITextComplete() {
+        if (this.accumulatedAIText) {
+            this.log(LogLevel.INFO, LogCategory.AI_TEXT, 'AI text response complete', {
+                totalLength: this.accumulatedAIText.length,
+                preview: this.accumulatedAIText.substring(0, 500) + (this.accumulatedAIText.length > 500 ? '...' : ''),
+                fullContent: this.accumulatedAIText,
+            });
+        }
+        this.accumulatedAIText = '';
+    }
+    /**
+     * Log thought chunk (streaming)
+     */
+    logThoughtChunk(thought) {
+        this.accumulatedThought += thought;
+        this.log(LogLevel.DEBUG, LogCategory.THOUGHT, 'Thought chunk received', {
+            chunkLength: thought.length,
+            totalLength: this.accumulatedThought.length,
+            chunk: thought.substring(0, 200) + (thought.length > 200 ? '...' : ''),
+        });
+    }
+    /**
+     * Log thought completion with duration
+     */
+    logThoughtComplete(durationSeconds) {
+        this.log(LogLevel.INFO, LogCategory.THOUGHT, 'Thinking completed', {
+            durationSeconds,
+            totalLength: this.accumulatedThought.length,
+            preview: this.accumulatedThought.substring(0, 500) + (this.accumulatedThought.length > 500 ? '...' : ''),
+            fullThought: this.accumulatedThought,
+        });
+        this.accumulatedThought = '';
+    }
+    /**
+     * Log a tool call being received from AI
+     */
+    logToolCall(name, id, args) {
+        // Sanitize args to avoid logging huge content
+        const sanitizedArgs = {};
+        for (const [key, value] of Object.entries(args)) {
+            if (typeof value === 'string' && value.length > 1000) {
+                sanitizedArgs[key] = value.substring(0, 1000) + `... [truncated ${value.length - 1000} chars]`;
+            }
+            else {
+                sanitizedArgs[key] = value;
+            }
+        }
+        this.log(LogLevel.INFO, LogCategory.TOOL_CALL, `Tool call received: ${name}`, {
+            toolName: name,
+            toolCallId: id,
+            arguments: sanitizedArgs,
+        });
+    }
+    /**
+     * Log tool execution starting
+     */
+    logToolExecutionStart(name, id) {
+        this.log(LogLevel.INFO, LogCategory.TOOL_EXEC, `Executing tool: ${name}`, {
+            toolName: name,
+            toolCallId: id,
+        });
+    }
+    /**
+     * Log tool execution result
+     */
+    logToolResult(name, id, result, success, error) {
+        // Sanitize result to avoid logging huge content
+        let sanitizedResult = result;
+        if (typeof result === 'string' && result.length > 2000) {
+            sanitizedResult = result.substring(0, 2000) + `... [truncated ${result.length - 2000} chars]`;
+        }
+        this.log(success ? LogLevel.INFO : LogLevel.WARN, LogCategory.TOOL_RESULT, `Tool ${success ? 'completed' : 'failed'}: ${name}`, {
+            toolName: name,
+            toolCallId: id,
+            success,
+            result: sanitizedResult,
+            error: error,
+        });
+    }
+    /**
+     * Log loop state at turn boundaries
+     */
+    logLoopState(turn, state) {
+        this.currentTurn = turn;
+        this.log(LogLevel.INFO, LogCategory.LOOP, `Turn ${turn} state`, state);
+    }
+    /**
+     * Log when narration/completion detection triggers
+     */
+    logNarrationDetection(type, details) {
+        this.log(LogLevel.WARN, LogCategory.NARRATION, `Detection: ${type}`, details);
+    }
+    /**
+     * Log system prompts added to conversation
+     */
+    logSystemPrompt(promptType, content) {
+        this.log(LogLevel.INFO, LogCategory.SYSTEM, `System prompt: ${promptType}`, {
+            contentLength: content.length,
+            content: content.substring(0, 500) + (content.length > 500 ? '...' : ''),
+        });
+    }
+    /**
+     * Log an error
+     */
+    logError(context, error) {
+        const errorMessage = error instanceof Error ? error.message : error;
+        const errorStack = error instanceof Error ? error.stack : undefined;
+        this.log(LogLevel.ERROR, LogCategory.ERROR, `Error in ${context}`, {
+            message: errorMessage,
+            stack: errorStack,
+        });
+    }
+    /**
+     * Log stream completion
+     */
+    logStreamEnd(reason) {
+        this.log(LogLevel.INFO, LogCategory.LOOP, 'Stream ended', { reason });
+    }
+    /**
+     * Log task completion
+     */
+    logTaskComplete(summary) {
+        this.log(LogLevel.INFO, LogCategory.SESSION, 'Task completed', {
+            summaryLength: summary.length,
+            summary: summary.substring(0, 500) + (summary.length > 500 ? '...' : ''),
+        });
+    }
+    /**
+     * Log session end
+     */
+    endSession(finalMessage, turnCount) {
+        this.log(LogLevel.INFO, LogCategory.SESSION, '═══════════════════════════════════════════════════════════════════════════════');
+        this.log(LogLevel.INFO, LogCategory.SESSION, 'CONVERSATION SESSION ENDED', {
+            totalTurns: turnCount,
+            finalMessageLength: finalMessage.length,
+            finalMessagePreview: finalMessage.substring(0, 300) + (finalMessage.length > 300 ? '...' : ''),
+        });
+        this.log(LogLevel.INFO, LogCategory.SESSION, '═══════════════════════════════════════════════════════════════════════════════');
+        this.log(LogLevel.INFO, LogCategory.SESSION, ''); // Empty line for separation
+    }
+    /**
+     * Log messages array state (for debugging conversation history)
+     */
+    logConversationHistory(messages) {
+        this.log(LogLevel.DEBUG, LogCategory.LOOP, 'Current conversation history', {
+            messageCount: messages.length,
+            messages: messages.map((m, i) => ({
+                index: i,
+                role: m.role,
+                contentLength: m.content.length,
+                contentPreview: m.content.substring(0, 100) + (m.content.length > 100 ? '...' : ''),
+                hasToolCalls: !!(m.tool_calls && m.tool_calls.length > 0),
+                toolCallCount: m.tool_calls?.length || 0,
+            })),
+        });
+    }
+    /**
+     * Core logging function
+     */
+    log(level, category, message, details) {
+        if (!this.enabled)
+            return;
+        const timestamp = new Date().toISOString();
+        const sessionId = this.sessionId || 'no_session';
+        const entry = {
+            timestamp,
+            sessionId,
+            level,
+            category,
+            message,
+            details,
+        };
+        // Format the log line
+        let logLine = `[${timestamp}] [${sessionId}] [${level}] [${category}] ${message}`;
+        if (details) {
+            try {
+                const detailsStr = JSON.stringify(details, null, 2);
+                // Indent details for readability
+                const indentedDetails = detailsStr.split('\n').map(line => '  ' + line).join('\n');
+                logLine += '\n' + indentedDetails;
+            }
+            catch (e) {
+                logLine += '\n  [Details could not be serialized]';
+            }
+        }
+        logLine += '\n';
+        try {
+            fs.appendFileSync(this.logFilePath, logLine);
+        }
+        catch (e) {
+            // Silently fail if we can't write logs
+        }
+    }
+}
+// Export singleton instance
+export const conversationLogger = new ConversationLogger();
+//# sourceMappingURL=conversation-logger.js.map

package/dist/utils/conversation-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-logger.js","sourceRoot":"","sources":["../../src/utils/conversation-logger.ts"],"names":[],"mappings":"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"}

package/dist/utils/editor-utils.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Check if a command is an interactive editor that needs full terminal control
+ */
+export declare function isInteractiveEditorCommand(command: string): boolean;
+/**
+ * Check if the command is specifically for nano editor (the only remote-supported editor currently)
+ */
+export declare function isNanoEditor(command: string): boolean;
+/**
+ * Get the display name of an editor command for user-friendly messages
+ */
+export declare function getEditorName(command: string): string;
+/**
+ * Run an interactive editor with full terminal control (LOCAL mode).
+ * This function:
+ * 1. Clears the screen and enters alternate screen buffer
+ * 2. Spawns a PTY process
+ * 3. Pipes stdin directly to the PTY (raw mode)
+ * 4. Pipes PTY output directly to stdout
+ * 5. Handles cleanup on exit
+ *
+ * Uses alternate screen buffer to prevent chat history from showing through.
+ */
+export declare function runInteractiveEditor(command: string, cwd: string, onExit: (exitCode: number) => void): {
+    kill: () => void;
+};
+/**
+ * Run an interactive editor in WSL session via node-pty.
+ * Uses wsl.exe to execute the editor command in the specified distribution.
+ */
+export declare function runWSLEditor(distribution: string, command: string, cwd: string, onExit: (exitCode: number) => void): {
+    kill: () => void;
+};
+/**
+ * Interactive process interface for WSL PTY commands
+ */
+export interface WSLPtyProcess {
+    write: (data: string) => void;
+    kill: () => void;
+    resize: (cols: number, rows: number) => void;
+    isRunning: () => boolean;
+}
+/**
+ * Run a command in WSL session via node-pty with streaming output.
+ * Unlike runWSLEditor, this doesn't take over the terminal - it streams output to a callback.
+ * This is essential for sudo commands that need TTY for password prompts.
+ */
+export declare function runWSLCommand(distribution: string, command: string, cwd: string, onData: (data: string) => void, onExit: (exitCode: number) => void): WSLPtyProcess;
+/**
+ * Run a command in Docker container via node-pty with streaming output.
+ * Unlike runDockerEditor, this doesn't take over the terminal - it streams output to a callback.
+ * This is essential for sudo commands that need TTY for password prompts.
+ */
+export declare function runDockerCommand(containerId: string, command: string, cwd: string, onData: (data: string) => void, onExit: (exitCode: number) => void): WSLPtyProcess;
+/**
+ * Run an interactive editor in Docker container via node-pty.
+ * Uses docker exec -it to execute the editor command in the container.
+ */
+export declare function runDockerEditor(containerId: string, command: string, cwd: string, onExit: (exitCode: number) => void): {
+    kill: () => void;
+};
+/**
+ * Run an interactive editor in SSH session via ssh2's interactive shell.
+ * This is more complex as we need to use the ssh2 client's shell() method
+ * instead of exec() to get a proper interactive PTY.
+ */
+export declare function runSSHEditor(sshClient: any, // ssh2 Client
+command: string, cwd: string, onExit: (exitCode: number) => void): {
+    kill: () => void;
+};
+/**
+ * SSH PTY process interface for SSH commands with streaming output
+ */
+export interface SSHPtyProcess {
+    write: (data: string) => void;
+    kill: () => void;
+    resize: (cols: number, rows: number) => void;
+    isRunning: () => boolean;
+}
+/**
+ * Run a command in SSH session via ssh2's interactive shell with streaming output.
+ * Unlike runSSHEditor, this doesn't take over the terminal - it streams output to a callback.
+ * This is essential for sudo commands that need TTY for password prompts.
+ */
+export declare function runSSHCommand(sshClient: any, // ssh2 Client
+command: string, cwd: string, onData: (data: string) => void, onExit: (exitCode: number) => void): SSHPtyProcess;
+//# sourceMappingURL=editor-utils.d.ts.map

package/dist/utils/editor-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-utils.d.ts","sourceRoot":"","sources":["../../src/utils/editor-utils.ts"],"names":[],"mappings":"AA0BA;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAwBnE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAWrD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA2BrD;AAwKD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAChC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GACnC;IAAE,IAAI,EAAE,MAAM,IAAI,CAAA;CAAE,CA6GtB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CACxB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GACnC;IAAE,IAAI,EAAE,MAAM,IAAI,CAAA;CAAE,CA6BtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,SAAS,EAAE,MAAM,OAAO,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CACzB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAC9B,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GACnC,aAAa,CAoEf;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC5B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAC9B,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GACnC,aAAa,CAqEf;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC3B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GACnC;IAAE,IAAI,EAAE,MAAM,IAAI,CAAA;CAAE,CA8BtB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CACxB,SAAS,EAAE,GAAG,EAAE,cAAc;AAC9B,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GACnC;IAAE,IAAI,EAAE,MAAM,IAAI,CAAA;CAAE,CAwGtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,SAAS,EAAE,MAAM,OAAO,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CACzB,SAAS,EAAE,GAAG,EAAE,cAAc;AAC9B,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAC9B,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GACnC,aAAa,CAwEf"}