byterover-cli 2.5.1 → 2.6.0

package/dist/server/utils/error-handler.d.ts

@@ -1,51 +0,0 @@
-/**
- * Centralized error handling utility for CLI commands
- *
- * Provides user-friendly error messages based on error type:
- * - Network errors: Check internet connection
- * - Server errors: Retry later
- * - Billing errors: Check account/payment
- * - Auth errors: Re-login required
- * - Validation errors: Check input
- */
-export declare enum ErrorType {
-    AUTH = "AUTH",
-    BILLING = "BILLING",
-    NETWORK = "NETWORK",
-    SERVER = "SERVER",
-    UNKNOWN = "UNKNOWN",
-    VALIDATION = "VALIDATION"
-}
-export interface ClassifiedError {
-    message: string;
-    originalError: Error;
-    type: ErrorType;
-    userMessage: string;
-}
-/**
- * Classify error and return user-friendly message
- */
-export declare function classifyError(error: unknown): ClassifiedError;
-/**
- * Format error for display to user
- *
- * @param error - Error to format
- * @returns User-friendly error message
- */
-export declare function formatError(error: unknown): string;
-/**
- * Check if error is a network error
- */
-export declare function isNetworkError(error: unknown): boolean;
-/**
- * Check if error is a server error
- */
-export declare function isServerError(error: unknown): boolean;
-/**
- * Check if error is an authentication error
- */
-export declare function isAuthError(error: unknown): boolean;
-/**
- * Check if error is a billing error
- */
-export declare function isBillingError(error: unknown): boolean;

package/dist/server/utils/error-handler.js

@@ -1,169 +0,0 @@
-/**
- * Centralized error handling utility for CLI commands
- *
- * Provides user-friendly error messages based on error type:
- * - Network errors: Check internet connection
- * - Server errors: Retry later
- * - Billing errors: Check account/payment
- * - Auth errors: Re-login required
- * - Validation errors: Check input
- */
-import { isAxiosError } from 'axios';
-import { addErrorPrefix } from './emoji-helpers.js';
-export var ErrorType;
-(function (ErrorType) {
-    ErrorType["AUTH"] = "AUTH";
-    ErrorType["BILLING"] = "BILLING";
-    ErrorType["NETWORK"] = "NETWORK";
-    ErrorType["SERVER"] = "SERVER";
-    ErrorType["UNKNOWN"] = "UNKNOWN";
-    ErrorType["VALIDATION"] = "VALIDATION";
-})(ErrorType || (ErrorType = {}));
-/**
- * Helper to create a ClassifiedError object
- */
-function createClassifiedError(err, type, userMessage, customMessage) {
-    return {
-        message: customMessage || err.message,
-        originalError: err,
-        type,
-        userMessage,
-    };
-}
-/**
- * Classify axios-specific errors
- * Returns null if error is not an axios error
- */
-function classifyAxiosError(error, err) {
-    if (!isAxiosError(error)) {
-        return null;
-    }
-    // Network connectivity issues
-    if (error.code === 'ENOTFOUND' || error.code === 'ECONNREFUSED' || error.code === 'ETIMEDOUT') {
-        return createClassifiedError(err, ErrorType.NETWORK, '❌ Network error: Unable to connect to ByteRover servers. Please check your internet connection and try again.');
-    }
-    // DNS resolution failed
-    if (error.code === 'EAI_AGAIN') {
-        return createClassifiedError(err, ErrorType.NETWORK, '❌ Network error: DNS resolution failed. Please check your internet connection and DNS settings.');
-    }
-    // Server returned error response
-    if (error.response) {
-        const { status } = error.response;
-        // Authentication errors (401, 403)
-        if (status === 401 || status === 403) {
-            return createClassifiedError(err, ErrorType.AUTH, '❌ Authentication failed: Your session has expired or is invalid. Please run "brv login" to re-authenticate.');
-        }
-        // Billing/quota errors (402, 429)
-        if (status === 402 || status === 429) {
-            return createClassifiedError(err, ErrorType.BILLING, '❌ Billing error: Your ByteRover account may not have sufficient credits or has reached quota limits. Please check your account settings.');
-        }
-        // Server errors (500, 502, 503, 504)
-        if (status >= 500) {
-            return createClassifiedError(err, ErrorType.SERVER, '❌ Server error: ByteRover servers are experiencing issues. Please try again in a few moments.');
-        }
-        // Client errors (400, 404, etc.)
-        if (status >= 400 && status < 500) {
-            // Try to extract error message from response
-            const responseData = error.response.data;
-            const errorMessage = typeof responseData === 'string' ? responseData : responseData?.message || responseData?.error || err.message;
-            return createClassifiedError(err, ErrorType.VALIDATION, `❌ Request error: ${errorMessage}`, errorMessage);
-        }
-    }
-    // Request was made but no response received
-    if (error.request) {
-        return createClassifiedError(err, ErrorType.NETWORK, '❌ Network error: No response from ByteRover servers. Please check your internet connection and try again.');
-    }
-    return null;
-}
-/**
- * Classify error based on message keywords
- * Returns null if no keywords match
- */
-function classifyByMessageKeywords(err) {
-    const errorMessage = err.message.toLowerCase();
-    // Network-related keywords
-    if (errorMessage.includes('network') ||
-        errorMessage.includes('connection') ||
-        errorMessage.includes('timeout') ||
-        errorMessage.includes('enotfound') ||
-        errorMessage.includes('econnrefused')) {
-        return createClassifiedError(err, ErrorType.NETWORK, '❌ Network error: Unable to connect to ByteRover servers. Please check your internet connection and try again.');
-    }
-    // Authentication keywords
-    if (errorMessage.includes('authentication') ||
-        errorMessage.includes('unauthorized') ||
-        errorMessage.includes('forbidden') ||
-        errorMessage.includes('token') ||
-        errorMessage.includes('login')) {
-        return createClassifiedError(err, ErrorType.AUTH, '❌ Authentication failed: Your session has expired or is invalid. Please run "brv login" to re-authenticate.');
-    }
-    // Billing keywords
-    if (errorMessage.includes('billing') ||
-        errorMessage.includes('quota') ||
-        errorMessage.includes('limit') ||
-        errorMessage.includes('credits') ||
-        errorMessage.includes('payment')) {
-        return createClassifiedError(err, ErrorType.BILLING, '❌ Billing error: Your ByteRover account may not have sufficient credits or has reached quota limits. Please check your account settings.');
-    }
-    // Validation keywords
-    if (errorMessage.includes('invalid') ||
-        errorMessage.includes('required') ||
-        errorMessage.includes('missing') ||
-        errorMessage.includes('validation')) {
-        return createClassifiedError(err, ErrorType.VALIDATION, `❌ Validation error: ${err.message}`);
-    }
-    return null;
-}
-/**
- * Classify error and return user-friendly message
- */
-export function classifyError(error) {
-    const err = error instanceof Error ? error : new Error(String(error));
-    // Try axios error classification first
-    const axiosResult = classifyAxiosError(error, err);
-    if (axiosResult) {
-        return axiosResult;
-    }
-    // Try message-based classification
-    const messageResult = classifyByMessageKeywords(err);
-    if (messageResult) {
-        return messageResult;
-    }
-    // Default: unknown error
-    // Don't add prefix if error message already has emoji prefix
-    return createClassifiedError(err, ErrorType.UNKNOWN, addErrorPrefix(err.message));
-}
-/**
- * Format error for display to user
- *
- * @param error - Error to format
- * @returns User-friendly error message
- */
-export function formatError(error) {
-    const classified = classifyError(error);
-    return classified.userMessage;
-}
-/**
- * Check if error is a network error
- */
-export function isNetworkError(error) {
-    return classifyError(error).type === ErrorType.NETWORK;
-}
-/**
- * Check if error is a server error
- */
-export function isServerError(error) {
-    return classifyError(error).type === ErrorType.SERVER;
-}
-/**
- * Check if error is an authentication error
- */
-export function isAuthError(error) {
-    return classifyError(error).type === ErrorType.AUTH;
-}
-/**
- * Check if error is a billing error
- */
-export function isBillingError(error) {
-    return classifyError(error).type === ErrorType.BILLING;
-}

package/dist/server/utils/oclif-error-helpers.d.ts

@@ -1,40 +0,0 @@
-/**
- * Helper utilities for handling oclif-specific errors
- *
- * These utilities help avoid duplicating error handling logic across commands
- */
-/**
- * Handle oclif error exit codes
- *
- * If the error has an oclif.exit property (set by this.error()), exit the process
- * with that code. This prevents oclif from re-logging errors that were already displayed.
- *
- * @param error - Error with optional oclif metadata
- * @returns true if error was handled (process exited), false if error should be re-thrown
- *
- * @example
- * public async catch(error: Error & {oclif?: {exit: number}}): Promise<void> {
- *   if (handleOclifExit(error)) return
- *   // Handle other error cases...
- * }
- */
-export declare function handleOclifExit(error: Error & {
-    oclif?: {
-        exit: number;
-    };
-}): boolean;
-/**
- * Check if error is an oclif validation error
- *
- * Validation errors include missing arguments, unexpected arguments, and missing flags.
- * These should be re-thrown to let oclif's error handler display them properly.
- *
- * @param error - Error to check
- * @returns true if error is a validation error
- *
- * @example
- * if (isValidationError(error)) {
- *   throw error // Let oclif handle it
- * }
- */
-export declare function isValidationError(error: Error): boolean;

package/dist/server/utils/oclif-error-helpers.js

@@ -1,46 +0,0 @@
-/**
- * Helper utilities for handling oclif-specific errors
- *
- * These utilities help avoid duplicating error handling logic across commands
- */
-/**
- * Handle oclif error exit codes
- *
- * If the error has an oclif.exit property (set by this.error()), exit the process
- * with that code. This prevents oclif from re-logging errors that were already displayed.
- *
- * @param error - Error with optional oclif metadata
- * @returns true if error was handled (process exited), false if error should be re-thrown
- *
- * @example
- * public async catch(error: Error & {oclif?: {exit: number}}): Promise<void> {
- *   if (handleOclifExit(error)) return
- *   // Handle other error cases...
- * }
- */
-export function handleOclifExit(error) {
-    if (error.oclif?.exit !== undefined) {
-        // eslint-disable-next-line n/no-process-exit, unicorn/no-process-exit
-        process.exit(error.oclif.exit);
-    }
-    return false;
-}
-/**
- * Check if error is an oclif validation error
- *
- * Validation errors include missing arguments, unexpected arguments, and missing flags.
- * These should be re-thrown to let oclif's error handler display them properly.
- *
- * @param error - Error to check
- * @returns true if error is a validation error
- *
- * @example
- * if (isValidationError(error)) {
- *   throw error // Let oclif handle it
- * }
- */
-export function isValidationError(error) {
-    return (error.message.includes('Unexpected argument') ||
-        error.message.includes('Missing') ||
-        error.message.includes('required'));
-}

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

@@ -1,53 +0,0 @@
-/**
- * Tool Display Formatter
- *
- * Utilities for formatting tool call arguments and results in a concise,
- * readable format for CLI display.
- */
-/**
- * Format a tool call with its arguments for display.
- *
- * Creates a concise, single-line representation of a tool call:
- * - Truncates long strings with ellipsis
- * - Shows relative paths or basenames for file paths
- * - Omits undefined/null optional parameters
- * - Formats arrays and objects as summaries
- *
- * @param toolName - Name of the tool being called
- * @param args - Tool arguments object
- * @returns Formatted string like "tool_name(arg1: value1, arg2: value2)"
- *
- * @example
- * ```typescript
- * formatToolCall('read_file', { filePath: '/long/path/to/file.ts', limit: 100 })
- * // Returns: 'read_file(filePath: "file.ts", limit: 100)'
- *
- * formatToolCall('write_file', { filePath: 'test.ts', content: 'very long content...', createDirs: true })
- * // Returns: 'write_file(filePath: "test.ts", content: "very long conte...", createDirs: true)'
- * ```
- */
-export declare function formatToolCall(toolName: string, args: Record<string, unknown>): string;
-/**
- * Format a tool result for display.
- *
- * Creates a concise summary of the tool execution result:
- * - For success: shows relevant metrics (file size, match count, etc.)
- * - For errors: shows error message
- * - Truncates long values
- *
- * @param toolName - Name of the tool that was executed
- * @param success - Whether the tool execution succeeded
- * @param result - Tool result (if successful)
- * @param error - Error message (if failed)
- * @returns Formatted result string
- *
- * @example
- * ```typescript
- * formatToolResult('write_file', true, { bytesWritten: 245 })
- * // Returns: 'File written (245 bytes)'
- *
- * formatToolResult('read_file', false, undefined, 'ENOENT: no such file or directory')
- * // Returns: 'ENOENT: no such file or directory'
- * ```
- */
-export declare function formatToolResult(toolName: string, success: boolean, result?: unknown, error?: string): string;

package/dist/server/utils/tool-display-formatter.js

@@ -1,257 +0,0 @@
-/**
- * Tool Display Formatter
- *
- * Utilities for formatting tool call arguments and results in a concise,
- * readable format for CLI display.
- */
-/**
- * Maximum length for string values before truncation
- */
-const MAX_STRING_LENGTH = 50;
-/**
- * Maximum total line length for formatted output
- */
-const MAX_LINE_LENGTH = 100;
-/**
- * Format a tool call with its arguments for display.
- *
- * Creates a concise, single-line representation of a tool call:
- * - Truncates long strings with ellipsis
- * - Shows relative paths or basenames for file paths
- * - Omits undefined/null optional parameters
- * - Formats arrays and objects as summaries
- *
- * @param toolName - Name of the tool being called
- * @param args - Tool arguments object
- * @returns Formatted string like "tool_name(arg1: value1, arg2: value2)"
- *
- * @example
- * ```typescript
- * formatToolCall('read_file', { filePath: '/long/path/to/file.ts', limit: 100 })
- * // Returns: 'read_file(filePath: "file.ts", limit: 100)'
- *
- * formatToolCall('write_file', { filePath: 'test.ts', content: 'very long content...', createDirs: true })
- * // Returns: 'write_file(filePath: "test.ts", content: "very long conte...", createDirs: true)'
- * ```
- */
-export function formatToolCall(toolName, args) {
-    const formattedArgs = Object.entries(args)
-        .filter(([_, value]) => value !== undefined && value !== null)
-        .map(([key, value]) => `${key}: ${formatValue(value)}`)
-        .join(', ');
-    const result = `${toolName}(${formattedArgs})`;
-    // Truncate if too long
-    if (result.length > MAX_LINE_LENGTH) {
-        return result.slice(0, MAX_LINE_LENGTH - 3) + '...';
-    }
-    return result;
-}
-/**
- * Format a tool result for display.
- *
- * Creates a concise summary of the tool execution result:
- * - For success: shows relevant metrics (file size, match count, etc.)
- * - For errors: shows error message
- * - Truncates long values
- *
- * @param toolName - Name of the tool that was executed
- * @param success - Whether the tool execution succeeded
- * @param result - Tool result (if successful)
- * @param error - Error message (if failed)
- * @returns Formatted result string
- *
- * @example
- * ```typescript
- * formatToolResult('write_file', true, { bytesWritten: 245 })
- * // Returns: 'File written (245 bytes)'
- *
- * formatToolResult('read_file', false, undefined, 'ENOENT: no such file or directory')
- * // Returns: 'ENOENT: no such file or directory'
- * ```
- */
-export function formatToolResult(toolName, success, result, error) {
-    if (!success) {
-        return error ? truncateString(error, 80) : 'Unknown error';
-    }
-    // Tool-specific result formatting
-    switch (toolName) {
-        case 'edit_file': {
-            return formatEditFileResult(result);
-        }
-        case 'glob_files': {
-            return formatGlobFilesResult(result);
-        }
-        case 'grep_content': {
-            return formatGrepContentResult(result);
-        }
-        case 'read_file': {
-            return formatReadFileResult(result);
-        }
-        case 'search_history': {
-            return formatSearchHistoryResult(result);
-        }
-        case 'write_file': {
-            return formatWriteFileResult(result);
-        }
-        default: {
-            return formatGenericResult(result);
-        }
-    }
-}
-/**
- * Format a value for display based on its type.
- *
- * @param value - Value to format
- * @returns Formatted string representation
- */
-function formatValue(value) {
-    if (value === null) {
-        return 'null';
-    }
-    if (value === undefined) {
-        return 'undefined';
-    }
-    if (typeof value === 'string') {
-        // Special handling for file paths
-        if (value.includes('/') || value.includes('\\')) {
-            return `"${formatPath(value)}"`;
-        }
-        return `"${truncateString(value, MAX_STRING_LENGTH)}"`;
-    }
-    if (typeof value === 'number' || typeof value === 'boolean') {
-        return String(value);
-    }
-    if (Array.isArray(value)) {
-        return `[${value.length} items]`;
-    }
-    if (typeof value === 'object') {
-        const keys = Object.keys(value);
-        return `{${keys.length} fields}`;
-    }
-    return String(value);
-}
-/**
- * Format a file path for display.
- * Shows basename for long paths, or relative path if reasonable.
- *
- * @param path - File path to format
- * @returns Formatted path
- */
-function formatPath(path) {
-    // If path is already short, return as-is
-    if (path.length <= MAX_STRING_LENGTH) {
-        return path;
-    }
-    // Extract filename
-    const parts = path.split(/[/\\]/);
-    const filename = parts.at(-1) || path;
-    // If just filename is short enough, use it
-    if (filename.length <= MAX_STRING_LENGTH) {
-        return filename;
-    }
-    // Otherwise truncate
-    return truncateString(path, MAX_STRING_LENGTH);
-}
-/**
- * Truncate a string to a maximum length with ellipsis.
- *
- * @param str - String to truncate
- * @param maxLength - Maximum length
- * @returns Truncated string
- */
-function truncateString(str, maxLength) {
-    if (str.length <= maxLength) {
-        return str;
-    }
-    return str.slice(0, maxLength - 3) + '...';
-}
-// Tool-specific result formatters
-function formatReadFileResult(result) {
-    if (typeof result === 'object' && result !== null) {
-        const { lines } = result;
-        if (typeof lines === 'number') {
-            return `Read ${lines} lines`;
-        }
-    }
-    if (typeof result === 'string') {
-        const lineCount = result.split('\n').length;
-        const byteCount = new Blob([result]).size;
-        return `Read ${lineCount} lines (${byteCount} bytes)`;
-    }
-    return 'File read successfully';
-}
-function formatWriteFileResult(result) {
-    if (typeof result === 'object' && result !== null) {
-        const { bytesWritten: bytes } = result;
-        if (typeof bytes === 'number') {
-            return `File written (${bytes} bytes)`;
-        }
-    }
-    return 'File written successfully';
-}
-function formatEditFileResult(result) {
-    if (typeof result === 'object' && result !== null) {
-        const { changes } = result;
-        if (typeof changes === 'number') {
-            return `File edited (${changes} changes)`;
-        }
-    }
-    return 'File edited successfully';
-}
-function formatGlobFilesResult(result) {
-    if (Array.isArray(result)) {
-        return `Found ${result.length} files`;
-    }
-    if (typeof result === 'object' && result !== null) {
-        const { files } = result;
-        if (Array.isArray(files)) {
-            return `Found ${files.length} files`;
-        }
-    }
-    return 'Files found';
-}
-function formatGrepContentResult(result) {
-    if (Array.isArray(result)) {
-        return `Found ${result.length} matches`;
-    }
-    if (typeof result === 'object' && result !== null) {
-        const { matchCount: count, matches } = result;
-        if (Array.isArray(matches)) {
-            return `Found ${matches.length} matches`;
-        }
-        if (typeof count === 'number') {
-            return `Found ${count} matches`;
-        }
-    }
-    return 'Matches found';
-}
-function formatSearchHistoryResult(result) {
-    if (Array.isArray(result)) {
-        return `Found ${result.length} history items`;
-    }
-    if (typeof result === 'object' && result !== null) {
-        const { items } = result;
-        if (Array.isArray(items)) {
-            return `Found ${items.length} history items`;
-        }
-    }
-    return 'History searched';
-}
-function formatGenericResult(result) {
-    if (result === null || result === undefined) {
-        return 'Success';
-    }
-    if (typeof result === 'string') {
-        return truncateString(result, 60);
-    }
-    if (typeof result === 'number' || typeof result === 'boolean') {
-        return String(result);
-    }
-    if (Array.isArray(result)) {
-        return `Returned ${result.length} items`;
-    }
-    if (typeof result === 'object') {
-        return 'Success';
-    }
-    return 'Success';
-}