claude-threads 0.15.0 → 0.16.3

package/dist/utils/logger.js

@@ -1,42 +0,0 @@
-/**
- * Simple debug logging utility
- *
- * Provides consistent logging across the codebase with:
- * - Configurable prefix for different components
- * - DEBUG environment variable check
- * - stdout vs stderr routing option
- */
-/**
- * Create a logger with a specific prefix
- *
- * @param prefix - Prefix to add to all messages (e.g., '[MCP]', '[ws]')
- * @param useStderr - If true, use stderr for all output (default: false)
- * @returns Logger object with debug, info, and error methods
- */
-export function createLogger(prefix, useStderr = false) {
-    const isDebug = () => process.env.DEBUG === '1';
-    const log = useStderr ? console.error : console.log;
-    return {
-        debug: (msg) => {
-            if (isDebug()) {
-                log(`${prefix} ${msg}`);
-            }
-        },
-        info: (msg) => {
-            log(`${prefix} ${msg}`);
-        },
-        error: (msg) => {
-            console.error(`${prefix} ${msg}`);
-        },
-    };
-}
-/**
- * Pre-configured logger for MCP permission server
- * Uses stderr (required for MCP stdio communication)
- */
-export const mcpLogger = createLogger('[MCP]', true);
-/**
- * Pre-configured logger for WebSocket client
- * Uses stdout with indentation for visual hierarchy
- */
-export const wsLogger = createLogger('  [ws]', false);

package/dist/utils/logger.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/utils/logger.test.js

@@ -1,121 +0,0 @@
-import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
-import { createLogger, mcpLogger, wsLogger } from './logger.js';
-describe('createLogger', () => {
-    let consoleLogSpy;
-    let consoleErrorSpy;
-    const originalEnv = process.env.DEBUG;
-    beforeEach(() => {
-        consoleLogSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
-        consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
-        delete process.env.DEBUG;
-    });
-    afterEach(() => {
-        consoleLogSpy.mockRestore();
-        consoleErrorSpy.mockRestore();
-        if (originalEnv !== undefined) {
-            process.env.DEBUG = originalEnv;
-        }
-        else {
-            delete process.env.DEBUG;
-        }
-    });
-    describe('debug', () => {
-        it('does not log when DEBUG is not set', () => {
-            const logger = createLogger('[test]');
-            logger.debug('test message');
-            expect(consoleLogSpy).not.toHaveBeenCalled();
-            expect(consoleErrorSpy).not.toHaveBeenCalled();
-        });
-        it('logs to stdout when DEBUG=1 and useStderr=false', () => {
-            process.env.DEBUG = '1';
-            const logger = createLogger('[test]');
-            logger.debug('test message');
-            expect(consoleLogSpy).toHaveBeenCalledWith('[test] test message');
-            expect(consoleErrorSpy).not.toHaveBeenCalled();
-        });
-        it('logs to stderr when DEBUG=1 and useStderr=true', () => {
-            process.env.DEBUG = '1';
-            const logger = createLogger('[test]', true);
-            logger.debug('test message');
-            expect(consoleErrorSpy).toHaveBeenCalledWith('[test] test message');
-            expect(consoleLogSpy).not.toHaveBeenCalled();
-        });
-        it('does not log when DEBUG is set to something other than 1', () => {
-            process.env.DEBUG = 'true';
-            const logger = createLogger('[test]');
-            logger.debug('test message');
-            expect(consoleLogSpy).not.toHaveBeenCalled();
-        });
-    });
-    describe('info', () => {
-        it('always logs to stdout when useStderr=false', () => {
-            const logger = createLogger('[test]');
-            logger.info('info message');
-            expect(consoleLogSpy).toHaveBeenCalledWith('[test] info message');
-        });
-        it('logs to stderr when useStderr=true', () => {
-            const logger = createLogger('[test]', true);
-            logger.info('info message');
-            expect(consoleErrorSpy).toHaveBeenCalledWith('[test] info message');
-        });
-        it('logs even when DEBUG is not set', () => {
-            const logger = createLogger('[test]');
-            logger.info('info message');
-            expect(consoleLogSpy).toHaveBeenCalled();
-        });
-    });
-    describe('error', () => {
-        it('always logs to stderr', () => {
-            const logger = createLogger('[test]');
-            logger.error('error message');
-            expect(consoleErrorSpy).toHaveBeenCalledWith('[test] error message');
-        });
-        it('logs to stderr even when useStderr=false', () => {
-            const logger = createLogger('[test]', false);
-            logger.error('error message');
-            expect(consoleErrorSpy).toHaveBeenCalledWith('[test] error message');
-        });
-        it('logs even when DEBUG is not set', () => {
-            const logger = createLogger('[test]');
-            logger.error('error message');
-            expect(consoleErrorSpy).toHaveBeenCalled();
-        });
-    });
-    describe('prefix formatting', () => {
-        it('includes prefix in debug messages', () => {
-            process.env.DEBUG = '1';
-            const logger = createLogger('[MyPrefix]');
-            logger.debug('my message');
-            expect(consoleLogSpy).toHaveBeenCalledWith('[MyPrefix] my message');
-        });
-        it('includes prefix in info messages', () => {
-            const logger = createLogger('[MyPrefix]');
-            logger.info('my message');
-            expect(consoleLogSpy).toHaveBeenCalledWith('[MyPrefix] my message');
-        });
-        it('includes prefix in error messages', () => {
-            const logger = createLogger('[MyPrefix]');
-            logger.error('my message');
-            expect(consoleErrorSpy).toHaveBeenCalledWith('[MyPrefix] my message');
-        });
-    });
-});
-describe('pre-configured loggers', () => {
-    // Note: mcpLogger and wsLogger are module-level singletons created at import time.
-    // Since they capture console.log/error at creation, we test their behavior by
-    // verifying they have the expected interface and configuration.
-    describe('mcpLogger', () => {
-        it('has debug, info, and error methods', () => {
-            expect(typeof mcpLogger.debug).toBe('function');
-            expect(typeof mcpLogger.info).toBe('function');
-            expect(typeof mcpLogger.error).toBe('function');
-        });
-    });
-    describe('wsLogger', () => {
-        it('has debug, info, and error methods', () => {
-            expect(typeof wsLogger.debug).toBe('function');
-            expect(typeof wsLogger.info).toBe('function');
-            expect(typeof wsLogger.error).toBe('function');
-        });
-    });
-});

package/dist/utils/tool-formatter.d.ts

@@ -1,53 +0,0 @@
-/**
- * Tool formatting utilities for displaying Claude tool calls in chat platforms
- *
- * This module provides shared formatting logic used by both:
- * - src/session/events.ts (main bot)
- * - src/mcp/permission-server.ts (MCP permission handler)
- *
- * Uses PlatformFormatter abstraction to support different markdown dialects
- * (e.g., Mattermost standard markdown vs Slack mrkdwn).
- */
-import type { PlatformFormatter } from '../platform/formatter.js';
-export interface ToolInput {
-    [key: string]: unknown;
-}
-export interface FormatOptions {
-    /** Include detailed previews (diffs, file content). Default: false */
-    detailed?: boolean;
-    /** Max command length for Bash. Default: 50 */
-    maxCommandLength?: number;
-    /** Max path display length. Default: 60 */
-    maxPathLength?: number;
-    /** Max lines to show in previews. Default: 20 for diff, 6 for content */
-    maxPreviewLines?: number;
-}
-/**
- * Shorten a file path for display by replacing home directory with ~
- */
-export declare function shortenPath(path: string, homeDir?: string): string;
-/**
- * Check if a tool name is an MCP tool and extract server/tool parts
- */
-export declare function parseMcpToolName(toolName: string): {
-    server: string;
-    tool: string;
-} | null;
-/**
- * Format a tool use for display in chat platforms
- *
- * @param toolName - The name of the tool being called
- * @param input - The tool input parameters
- * @param options - Formatting options
- * @returns Formatted string or null if the tool should not be displayed
- */
-export declare function formatToolUse(toolName: string, input: ToolInput, formatter: PlatformFormatter, options?: FormatOptions): string | null;
-/**
- * Format tool info for permission prompts (simpler format)
- *
- * @param toolName - The name of the tool
- * @param input - The tool input parameters
- * @param formatter - Platform-specific markdown formatter
- * @returns Formatted string for permission prompts
- */
-export declare function formatToolForPermission(toolName: string, input: ToolInput, formatter: PlatformFormatter): string;

package/dist/utils/tool-formatter.js

@@ -1,252 +0,0 @@
-/**
- * Tool formatting utilities for displaying Claude tool calls in chat platforms
- *
- * This module provides shared formatting logic used by both:
- * - src/session/events.ts (main bot)
- * - src/mcp/permission-server.ts (MCP permission handler)
- *
- * Uses PlatformFormatter abstraction to support different markdown dialects
- * (e.g., Mattermost standard markdown vs Slack mrkdwn).
- */
-import * as Diff from 'diff';
-const DEFAULT_OPTIONS = {
-    detailed: false,
-    maxCommandLength: 50,
-    maxPathLength: 60,
-    maxPreviewLines: 20,
-};
-/**
- * Shorten a file path for display by replacing home directory with ~
- */
-export function shortenPath(path, homeDir) {
-    if (!path)
-        return '';
-    const home = homeDir ?? process.env.HOME ?? '';
-    if (home && path.startsWith(home)) {
-        return '~' + path.slice(home.length);
-    }
-    return path;
-}
-/**
- * Check if a tool name is an MCP tool and extract server/tool parts
- */
-export function parseMcpToolName(toolName) {
-    if (!toolName.startsWith('mcp__'))
-        return null;
-    const parts = toolName.split('__');
-    if (parts.length < 3)
-        return null;
-    return {
-        server: parts[1],
-        tool: parts.slice(2).join('__'),
-    };
-}
-/**
- * Format a tool use for display in chat platforms
- *
- * @param toolName - The name of the tool being called
- * @param input - The tool input parameters
- * @param options - Formatting options
- * @returns Formatted string or null if the tool should not be displayed
- */
-export function formatToolUse(toolName, input, formatter, options = {}) {
-    const opts = { ...DEFAULT_OPTIONS, ...options };
-    const short = (p) => shortenPath(p);
-    switch (toolName) {
-        case 'Read':
-            return `📄 ${formatter.formatBold('Read')} ${formatter.formatCode(short(input.file_path))}`;
-        case 'Edit': {
-            const filePath = short(input.file_path);
-            const oldStr = input.old_string || '';
-            const newStr = input.new_string || '';
-            // Show diff if detailed mode and we have old/new strings
-            if (opts.detailed && (oldStr || newStr)) {
-                const changes = Diff.diffLines(oldStr, newStr);
-                const maxLines = opts.maxPreviewLines;
-                let lineCount = 0;
-                const diffLines = [];
-                for (const change of changes) {
-                    const lines = change.value.replace(/\n$/, '').split('\n');
-                    for (const line of lines) {
-                        if (lineCount >= maxLines)
-                            break;
-                        if (change.added) {
-                            diffLines.push(`+ ${line}`);
-                            lineCount++;
-                        }
-                        else if (change.removed) {
-                            diffLines.push(`- ${line}`);
-                            lineCount++;
-                        }
-                        else {
-                            diffLines.push(`  ${line}`);
-                            lineCount++;
-                        }
-                    }
-                    if (lineCount >= maxLines)
-                        break;
-                }
-                const totalLines = changes.reduce((sum, c) => sum + c.value.split('\n').length - 1, 0);
-                let diff = `✏️ ${formatter.formatBold('Edit')} ${formatter.formatCode(filePath)}\n${formatter.formatCodeBlock(diffLines.join('\n'), 'diff')}`;
-                if (totalLines > maxLines) {
-                    diff = `✏️ ${formatter.formatBold('Edit')} ${formatter.formatCode(filePath)}\n`;
-                    diff += formatter.formatCodeBlock(diffLines.join('\n') + `\n... (+${totalLines - maxLines} more lines)`, 'diff');
-                }
-                return diff;
-            }
-            return `✏️ ${formatter.formatBold('Edit')} ${formatter.formatCode(filePath)}`;
-        }
-        case 'Write': {
-            const filePath = short(input.file_path);
-            const content = input.content || '';
-            const lines = content.split('\n');
-            const lineCount = lines.length;
-            // Show preview if detailed mode
-            if (opts.detailed && content && lineCount > 0) {
-                const maxLines = 6;
-                const previewLines = lines.slice(0, maxLines);
-                let preview = `📝 ${formatter.formatBold('Write')} ${formatter.formatCode(filePath)} ${formatter.formatItalic(`(${lineCount} lines)`)}\n`;
-                if (lineCount > maxLines) {
-                    preview += formatter.formatCodeBlock(previewLines.join('\n') + `\n... (${lineCount - maxLines} more lines)`);
-                }
-                else {
-                    preview += formatter.formatCodeBlock(previewLines.join('\n'));
-                }
-                return preview;
-            }
-            return `📝 ${formatter.formatBold('Write')} ${formatter.formatCode(filePath)}`;
-        }
-        case 'Bash': {
-            const cmd = (input.command || '').substring(0, opts.maxCommandLength);
-            const truncated = cmd.length >= opts.maxCommandLength;
-            return `💻 ${formatter.formatBold('Bash')} ${formatter.formatCode(cmd + (truncated ? '...' : ''))}`;
-        }
-        case 'Glob':
-            return `🔍 ${formatter.formatBold('Glob')} ${formatter.formatCode(input.pattern)}`;
-        case 'Grep':
-            return `🔎 ${formatter.formatBold('Grep')} ${formatter.formatCode(input.pattern)}`;
-        case 'Task':
-            return null; // Handled specially with subagent display
-        case 'EnterPlanMode':
-            return `📋 ${formatter.formatBold('Planning...')}`;
-        case 'ExitPlanMode':
-            return null; // Handled specially with approval buttons
-        case 'AskUserQuestion':
-            return null; // Don't show, the question text follows
-        case 'TodoWrite':
-            return null; // Handled specially with task list display
-        case 'WebFetch': {
-            const url = (input.url || '').substring(0, 40);
-            return `🌐 ${formatter.formatBold('Fetching')} ${formatter.formatCode(url)}`;
-        }
-        case 'WebSearch':
-            return `🔍 ${formatter.formatBold('Searching')} ${formatter.formatCode(input.query)}`;
-        default: {
-            // Handle MCP tools: mcp__server__tool
-            const mcpParts = parseMcpToolName(toolName);
-            if (mcpParts) {
-                // Special formatting for Claude in Chrome tools
-                if (mcpParts.server === 'claude-in-chrome') {
-                    return formatChromeToolUse(mcpParts.tool, input, formatter);
-                }
-                return `🔌 ${formatter.formatBold(mcpParts.tool)} ${formatter.formatItalic(`(${mcpParts.server})`)}`;
-            }
-            return `● ${formatter.formatBold(toolName)}`;
-        }
-    }
-}
-/**
- * Format tool info for permission prompts (simpler format)
- *
- * @param toolName - The name of the tool
- * @param input - The tool input parameters
- * @param formatter - Platform-specific markdown formatter
- * @returns Formatted string for permission prompts
- */
-export function formatToolForPermission(toolName, input, formatter) {
-    const short = (p) => shortenPath(p);
-    switch (toolName) {
-        case 'Read':
-            return `📄 ${formatter.formatBold('Read')} ${formatter.formatCode(short(input.file_path))}`;
-        case 'Write':
-            return `📝 ${formatter.formatBold('Write')} ${formatter.formatCode(short(input.file_path))}`;
-        case 'Edit':
-            return `✏️ ${formatter.formatBold('Edit')} ${formatter.formatCode(short(input.file_path))}`;
-        case 'Bash': {
-            const cmd = (input.command || '').substring(0, 100);
-            return `💻 ${formatter.formatBold('Bash')} ${formatter.formatCode(cmd + (cmd.length >= 100 ? '...' : ''))}`;
-        }
-        default: {
-            const mcpParts = parseMcpToolName(toolName);
-            if (mcpParts) {
-                return `🔌 ${formatter.formatBold(mcpParts.tool)} ${formatter.formatItalic(`(${mcpParts.server})`)}`;
-            }
-            return `● ${formatter.formatBold(toolName)}`;
-        }
-    }
-}
-/**
- * Format Claude in Chrome tool calls
- *
- * @param tool - The Chrome tool name (after mcp__claude-in-chrome__)
- * @param input - The tool input parameters
- * @param formatter - Platform-specific markdown formatter
- * @returns Formatted string for display
- */
-function formatChromeToolUse(tool, input, formatter) {
-    const action = input.action || '';
-    const coord = input.coordinate;
-    const url = input.url || '';
-    const text = input.text || '';
-    switch (tool) {
-        case 'computer': {
-            let detail = '';
-            switch (action) {
-                case 'screenshot':
-                    detail = 'screenshot';
-                    break;
-                case 'left_click':
-                case 'right_click':
-                case 'double_click':
-                case 'triple_click':
-                    detail = coord ? `${action} at (${coord[0]}, ${coord[1]})` : action;
-                    break;
-                case 'type':
-                    detail = `type "${text.substring(0, 30)}${text.length > 30 ? '...' : ''}"`;
-                    break;
-                case 'key':
-                    detail = `key ${text}`;
-                    break;
-                case 'scroll':
-                    detail = `scroll ${input.scroll_direction || 'down'}`;
-                    break;
-                case 'wait':
-                    detail = `wait ${input.duration}s`;
-                    break;
-                default:
-                    detail = action || 'action';
-            }
-            return `🌐 ${formatter.formatBold('Chrome')}[computer] ${formatter.formatCode(detail)}`;
-        }
-        case 'navigate':
-            return `🌐 ${formatter.formatBold('Chrome')}[navigate] ${formatter.formatCode(url.substring(0, 50) + (url.length > 50 ? '...' : ''))}`;
-        case 'tabs_context_mcp':
-            return `🌐 ${formatter.formatBold('Chrome')}[tabs] reading context`;
-        case 'tabs_create_mcp':
-            return `🌐 ${formatter.formatBold('Chrome')}[tabs] creating new tab`;
-        case 'read_page':
-            return `🌐 ${formatter.formatBold('Chrome')}[read_page] ${input.filter === 'interactive' ? 'interactive elements' : 'accessibility tree'}`;
-        case 'find':
-            return `🌐 ${formatter.formatBold('Chrome')}[find] ${formatter.formatCode(input.query || '')}`;
-        case 'form_input':
-            return `🌐 ${formatter.formatBold('Chrome')}[form_input] setting value`;
-        case 'get_page_text':
-            return `🌐 ${formatter.formatBold('Chrome')}[get_page_text] extracting content`;
-        case 'javascript_tool':
-            return `🌐 ${formatter.formatBold('Chrome')}[javascript] executing script`;
-        case 'gif_creator':
-            return `🌐 ${formatter.formatBold('Chrome')}[gif] ${action}`;
-        default:
-            return `🌐 ${formatter.formatBold('Chrome')}[${tool}]`;
-    }
-}

package/dist/utils/tool-formatter.test.d.ts

@@ -1 +0,0 @@
-export {};