byterover-cli 0.2.1 → 0.3.0

package/dist/core/domain/cipher/errors/file-system-error.d.ts

@@ -0,0 +1,211 @@
+/**
+ * Base error class for file system operations.
+ * All file system-specific errors extend this base class.
+ */
+export declare class FileSystemError extends Error {
+    readonly code: string;
+    readonly details?: Record<string, unknown>;
+    /**
+     * Creates a new file system error
+     * @param message - Error message describing what went wrong
+     * @param code - Error code for categorization
+     * @param details - Additional error context
+     */
+    constructor(message: string, code: string, details?: Record<string, unknown>);
+}
+/**
+ * Error thrown when a file is not found.
+ */
+export declare class FileNotFoundError extends FileSystemError {
+    /**
+     * Creates a new file not found error
+     * @param path - Path to the file that was not found
+     */
+    constructor(path: string);
+}
+/**
+ * Error thrown when a directory is not found.
+ */
+export declare class DirectoryNotFoundError extends FileSystemError {
+    /**
+     * Creates a new directory not found error
+     * @param path - Path to the directory that was not found
+     */
+    constructor(path: string);
+}
+/**
+ * Error thrown when a path is not in the allowed paths list.
+ */
+export declare class PathNotAllowedError extends FileSystemError {
+    /**
+     * Creates a new path not allowed error
+     * @param path - Path that was not allowed
+     * @param allowedPaths - List of allowed paths
+     */
+    constructor(path: string, allowedPaths: string[]);
+}
+/**
+ * Error thrown when a path is in the blocked paths list.
+ */
+export declare class PathBlockedError extends FileSystemError {
+    /**
+     * Creates a new path blocked error
+     * @param path - Path that was blocked
+     * @param reason - Reason why the path was blocked
+     */
+    constructor(path: string, reason: string);
+}
+/**
+ * Error thrown when path traversal is detected.
+ */
+export declare class PathTraversalError extends FileSystemError {
+    /**
+     * Creates a new path traversal error
+     * @param path - Path that contained traversal attempt
+     */
+    constructor(path: string);
+}
+/**
+ * Error thrown when a file has a blocked extension.
+ */
+export declare class InvalidExtensionError extends FileSystemError {
+    /**
+     * Creates a new invalid extension error
+     * @param path - Path with invalid extension
+     * @param extension - The blocked extension
+     */
+    constructor(path: string, extension: string);
+}
+/**
+ * Error thrown when a file exceeds the maximum size limit.
+ */
+export declare class FileTooLargeError extends FileSystemError {
+    /**
+     * Creates a new file too large error
+     * @param path - Path to the file that is too large
+     * @param size - Actual file size in bytes
+     * @param maxSize - Maximum allowed size in bytes
+     */
+    constructor(path: string, size: number, maxSize: number);
+}
+/**
+ * Error thrown when a read operation fails.
+ */
+export declare class ReadOperationError extends FileSystemError {
+    /**
+     * Creates a new read operation error
+     * @param path - Path to the file that failed to read
+     * @param originalError - The original error message
+     */
+    constructor(path: string, originalError: string);
+}
+/**
+ * Error thrown when a write operation fails.
+ */
+export declare class WriteOperationError extends FileSystemError {
+    /**
+     * Creates a new write operation error
+     * @param path - Path to the file that failed to write
+     * @param originalError - The original error message
+     */
+    constructor(path: string, originalError: string);
+}
+/**
+ * Error thrown when an edit operation fails.
+ */
+export declare class EditOperationError extends FileSystemError {
+    /**
+     * Creates a new edit operation error
+     * @param path - Path to the file that failed to edit
+     * @param originalError - The original error message
+     */
+    constructor(path: string, originalError: string);
+}
+/**
+ * Error thrown when a string to replace is not found in the file.
+ */
+export declare class StringNotFoundError extends FileSystemError {
+    /**
+     * Creates a new string not found error
+     * @param path - Path to the file
+     * @param searchString - The string that was not found
+     */
+    constructor(path: string, searchString: string);
+}
+/**
+ * Error thrown when a string to replace appears multiple times but replaceAll is false.
+ */
+export declare class StringNotUniqueError extends FileSystemError {
+    /**
+     * Creates a new string not unique error
+     * @param path - Path to the file
+     * @param searchString - The non-unique string
+     * @param occurrences - Number of times the string appears
+     */
+    constructor(path: string, searchString: string, occurrences: number);
+}
+/**
+ * Error thrown when a glob pattern is invalid.
+ */
+export declare class InvalidPatternError extends FileSystemError {
+    /**
+     * Creates a new invalid pattern error
+     * @param pattern - The invalid pattern
+     * @param originalError - The original error message
+     */
+    constructor(pattern: string, originalError: string);
+}
+/**
+ * Error thrown when glob operation fails.
+ */
+export declare class GlobOperationError extends FileSystemError {
+    /**
+     * Creates a new glob operation error
+     * @param pattern - The glob pattern that failed
+     * @param originalError - The original error message
+     */
+    constructor(pattern: string, originalError: string);
+}
+/**
+ * Error thrown when search operation fails.
+ */
+export declare class SearchOperationError extends FileSystemError {
+    /**
+     * Creates a new search operation error
+     * @param pattern - The search pattern that failed
+     * @param originalError - The original error message
+     */
+    constructor(pattern: string, originalError: string);
+}
+/**
+ * Error thrown when the service is not initialized.
+ */
+export declare class ServiceNotInitializedError extends FileSystemError {
+    /**
+     * Creates a new service not initialized error
+     */
+    constructor();
+}
+/**
+ * Error thrown when the path is empty or invalid.
+ */
+export declare class InvalidPathError extends FileSystemError {
+    /**
+     * Creates a new invalid path error
+     * @param path - The invalid path
+     * @param reason - Reason why the path is invalid
+     */
+    constructor(path: string, reason: string);
+}
+/**
+ * Error thrown when too many results are found.
+ */
+export declare class TooManyResultsError extends FileSystemError {
+    /**
+     * Creates a new too many results error
+     * @param operation - The operation that produced too many results
+     * @param count - Number of results found
+     * @param maxResults - Maximum allowed results
+     */
+    constructor(operation: string, count: number, maxResults: number);
+}

package/dist/core/domain/cipher/errors/file-system-error.js

@@ -0,0 +1,291 @@
+/**
+ * Base error class for file system operations.
+ * All file system-specific errors extend this base class.
+ */
+export class FileSystemError extends Error {
+    code;
+    details;
+    /**
+     * Creates a new file system error
+     * @param message - Error message describing what went wrong
+     * @param code - Error code for categorization
+     * @param details - Additional error context
+     */
+    constructor(message, code, details) {
+        super(message);
+        this.name = 'FileSystemError';
+        this.code = code;
+        this.details = details;
+    }
+}
+/**
+ * Error thrown when a file is not found.
+ */
+export class FileNotFoundError extends FileSystemError {
+    /**
+     * Creates a new file not found error
+     * @param path - Path to the file that was not found
+     */
+    constructor(path) {
+        super(`File not found: ${path}`, 'FILE_NOT_FOUND', { path });
+        this.name = 'FileNotFoundError';
+    }
+}
+/**
+ * Error thrown when a directory is not found.
+ */
+export class DirectoryNotFoundError extends FileSystemError {
+    /**
+     * Creates a new directory not found error
+     * @param path - Path to the directory that was not found
+     */
+    constructor(path) {
+        super(`Directory not found: ${path}`, 'DIRECTORY_NOT_FOUND', { path });
+        this.name = 'DirectoryNotFoundError';
+    }
+}
+/**
+ * Error thrown when a path is not in the allowed paths list.
+ */
+export class PathNotAllowedError extends FileSystemError {
+    /**
+     * Creates a new path not allowed error
+     * @param path - Path that was not allowed
+     * @param allowedPaths - List of allowed paths
+     */
+    constructor(path, allowedPaths) {
+        super(`Path not allowed: ${path}. Allowed paths: ${allowedPaths.join(', ')}`, 'PATH_NOT_ALLOWED', { allowedPaths, path });
+        this.name = 'PathNotAllowedError';
+    }
+}
+/**
+ * Error thrown when a path is in the blocked paths list.
+ */
+export class PathBlockedError extends FileSystemError {
+    /**
+     * Creates a new path blocked error
+     * @param path - Path that was blocked
+     * @param reason - Reason why the path was blocked
+     */
+    constructor(path, reason) {
+        super(`Path blocked: ${path}. Reason: ${reason}`, 'PATH_BLOCKED', { path, reason });
+        this.name = 'PathBlockedError';
+    }
+}
+/**
+ * Error thrown when path traversal is detected.
+ */
+export class PathTraversalError extends FileSystemError {
+    /**
+     * Creates a new path traversal error
+     * @param path - Path that contained traversal attempt
+     */
+    constructor(path) {
+        super(`Path traversal detected: ${path}. Relative paths with ".." are not allowed`, 'PATH_TRAVERSAL', { path });
+        this.name = 'PathTraversalError';
+    }
+}
+/**
+ * Error thrown when a file has a blocked extension.
+ */
+export class InvalidExtensionError extends FileSystemError {
+    /**
+     * Creates a new invalid extension error
+     * @param path - Path with invalid extension
+     * @param extension - The blocked extension
+     */
+    constructor(path, extension) {
+        super(`Invalid file extension: ${extension} in ${path}`, 'INVALID_EXTENSION', { extension, path });
+        this.name = 'InvalidExtensionError';
+    }
+}
+/**
+ * Error thrown when a file exceeds the maximum size limit.
+ */
+export class FileTooLargeError extends FileSystemError {
+    /**
+     * Creates a new file too large error
+     * @param path - Path to the file that is too large
+     * @param size - Actual file size in bytes
+     * @param maxSize - Maximum allowed size in bytes
+     */
+    constructor(path, size, maxSize) {
+        super(`File too large: ${path} (${size} bytes). Maximum allowed: ${maxSize} bytes`, 'FILE_TOO_LARGE', { maxSize, path, size });
+        this.name = 'FileTooLargeError';
+    }
+}
+/**
+ * Error thrown when a read operation fails.
+ */
+export class ReadOperationError extends FileSystemError {
+    /**
+     * Creates a new read operation error
+     * @param path - Path to the file that failed to read
+     * @param originalError - The original error message
+     */
+    constructor(path, originalError) {
+        super(`Failed to read file: ${path}. Error: ${originalError}`, 'READ_OPERATION_FAILED', {
+            originalError,
+            path,
+        });
+        this.name = 'ReadOperationError';
+    }
+}
+/**
+ * Error thrown when a write operation fails.
+ */
+export class WriteOperationError extends FileSystemError {
+    /**
+     * Creates a new write operation error
+     * @param path - Path to the file that failed to write
+     * @param originalError - The original error message
+     */
+    constructor(path, originalError) {
+        super(`Failed to write file: ${path}. Error: ${originalError}`, 'WRITE_OPERATION_FAILED', {
+            originalError,
+            path,
+        });
+        this.name = 'WriteOperationError';
+    }
+}
+/**
+ * Error thrown when an edit operation fails.
+ */
+export class EditOperationError extends FileSystemError {
+    /**
+     * Creates a new edit operation error
+     * @param path - Path to the file that failed to edit
+     * @param originalError - The original error message
+     */
+    constructor(path, originalError) {
+        super(`Failed to edit file: ${path}. Error: ${originalError}`, 'EDIT_OPERATION_FAILED', {
+            originalError,
+            path,
+        });
+        this.name = 'EditOperationError';
+    }
+}
+/**
+ * Error thrown when a string to replace is not found in the file.
+ */
+export class StringNotFoundError extends FileSystemError {
+    /**
+     * Creates a new string not found error
+     * @param path - Path to the file
+     * @param searchString - The string that was not found
+     */
+    constructor(path, searchString) {
+        super(`String not found in ${path}: "${searchString}"`, 'STRING_NOT_FOUND', {
+            path,
+            searchString,
+        });
+        this.name = 'StringNotFoundError';
+    }
+}
+/**
+ * Error thrown when a string to replace appears multiple times but replaceAll is false.
+ */
+export class StringNotUniqueError extends FileSystemError {
+    /**
+     * Creates a new string not unique error
+     * @param path - Path to the file
+     * @param searchString - The non-unique string
+     * @param occurrences - Number of times the string appears
+     */
+    constructor(path, searchString, occurrences) {
+        super(`String not unique in ${path}: "${searchString}" (found ${occurrences} times). Use replaceAll: true to replace all occurrences`, 'STRING_NOT_UNIQUE', { occurrences, path, searchString });
+        this.name = 'StringNotUniqueError';
+    }
+}
+/**
+ * Error thrown when a glob pattern is invalid.
+ */
+export class InvalidPatternError extends FileSystemError {
+    /**
+     * Creates a new invalid pattern error
+     * @param pattern - The invalid pattern
+     * @param originalError - The original error message
+     */
+    constructor(pattern, originalError) {
+        super(`Invalid pattern: ${pattern}. Error: ${originalError}`, 'INVALID_PATTERN', {
+            originalError,
+            pattern,
+        });
+        this.name = 'InvalidPatternError';
+    }
+}
+/**
+ * Error thrown when glob operation fails.
+ */
+export class GlobOperationError extends FileSystemError {
+    /**
+     * Creates a new glob operation error
+     * @param pattern - The glob pattern that failed
+     * @param originalError - The original error message
+     */
+    constructor(pattern, originalError) {
+        super(`Glob operation failed for pattern: ${pattern}. Error: ${originalError}`, 'GLOB_OPERATION_FAILED', {
+            originalError,
+            pattern,
+        });
+        this.name = 'GlobOperationError';
+    }
+}
+/**
+ * Error thrown when search operation fails.
+ */
+export class SearchOperationError extends FileSystemError {
+    /**
+     * Creates a new search operation error
+     * @param pattern - The search pattern that failed
+     * @param originalError - The original error message
+     */
+    constructor(pattern, originalError) {
+        super(`Search operation failed for pattern: ${pattern}. Error: ${originalError}`, 'SEARCH_OPERATION_FAILED', {
+            originalError,
+            pattern,
+        });
+        this.name = 'SearchOperationError';
+    }
+}
+/**
+ * Error thrown when the service is not initialized.
+ */
+export class ServiceNotInitializedError extends FileSystemError {
+    /**
+     * Creates a new service not initialized error
+     */
+    constructor() {
+        super('FileSystemService not initialized. Call initialize() before using the service', 'SERVICE_NOT_INITIALIZED');
+        this.name = 'ServiceNotInitializedError';
+    }
+}
+/**
+ * Error thrown when the path is empty or invalid.
+ */
+export class InvalidPathError extends FileSystemError {
+    /**
+     * Creates a new invalid path error
+     * @param path - The invalid path
+     * @param reason - Reason why the path is invalid
+     */
+    constructor(path, reason) {
+        super(`Invalid path: ${path}. Reason: ${reason}`, 'INVALID_PATH', { path, reason });
+        this.name = 'InvalidPathError';
+    }
+}
+/**
+ * Error thrown when too many results are found.
+ */
+export class TooManyResultsError extends FileSystemError {
+    /**
+     * Creates a new too many results error
+     * @param operation - The operation that produced too many results
+     * @param count - Number of results found
+     * @param maxResults - Maximum allowed results
+     */
+    constructor(operation, count, maxResults) {
+        super(`Too many results for ${operation}: found ${count}, maximum allowed: ${maxResults}. Narrow your search or increase maxResults`, 'TOO_MANY_RESULTS', { count, maxResults, operation });
+        this.name = 'TooManyResultsError';
+    }
+}

package/dist/core/domain/cipher/errors/llm-error.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Base error class for LLM-related operations.
+ * All LLM-specific errors extend this base class.
+ */
+export declare class LlmError extends Error {
+    readonly code?: string;
+    readonly details?: Record<string, unknown>;
+    readonly model?: string;
+    readonly provider?: string;
+    /**
+     * Creates a new LLM error
+     * @param message - Error message describing what went wrong
+     * @param code - Error code for categorization (e.g., 'LLM_GENERATION_FAILED')
+     * @param provider - LLM provider name (e.g., 'gemini', 'openai')
+     * @param model - Model name that was being used (e.g., 'gemini-2.5-flash')
+     */
+    constructor(message: string, code?: string, provider?: string, model?: string);
+}
+/**
+ * Error thrown when LLM generation fails.
+ * This can happen due to API errors, network issues, or model failures.
+ */
+export declare class LlmGenerationError extends LlmError {
+    readonly originalError: string;
+    /**
+     * Creates a new generation error
+     * @param error - The original error message from the LLM provider
+     * @param provider - LLM provider name
+     * @param model - Model name that was being used
+     */
+    constructor(error: string, provider: string, model: string);
+}
+/**
+ * Error thrown when rate limits are exceeded.
+ * Includes optional retry delay information.
+ */
+export declare class LlmRateLimitError extends LlmError {
+    readonly retryAfter?: number;
+    /**
+     * Creates a new rate limit error
+     * @param provider - LLM provider name
+     * @param retryAfter - Optional number of seconds to wait before retrying
+     */
+    constructor(provider: string, retryAfter?: number);
+    /**
+     * Gets the retry delay in milliseconds
+     * @returns Delay in milliseconds, or undefined if not specified
+     */
+    getRetryAfterMs(): number | undefined;
+}
+/**
+ * Error thrown when maximum iterations are exceeded in agentic loops.
+ * This prevents infinite loops when tool calling doesn't converge.
+ */
+export declare class LlmMaxIterationsError extends LlmError {
+    readonly maxIterations: number;
+    /**
+     * Creates a new max iterations error
+     * @param maxIterations - The maximum number of iterations that was configured
+     * @param provider - LLM provider name
+     * @param model - Model name that was being used
+     */
+    constructor(maxIterations: number, provider: string, model: string);
+}
+/**
+ * Error thrown when tool execution fails during LLM operations.
+ * This occurs when the LLM requests a tool call but the execution fails.
+ */
+export declare class LlmToolExecutionError extends LlmError {
+    readonly originalError: string;
+    readonly toolName: string;
+    /**
+     * Creates a new tool execution error
+     * @param toolName - Name of the tool that failed
+     * @param error - The original error message
+     * @param provider - LLM provider name
+     * @param model - Model name that was being used
+     */
+    constructor(toolName: string, error: string, provider: string, model: string);
+}
+/**
+ * Error thrown when LLM configuration is invalid or missing.
+ * This includes missing API keys, invalid settings, etc.
+ */
+export declare class LlmConfigurationError extends LlmError {
+    readonly configKey: string;
+    /**
+     * Creates a new configuration error
+     * @param configKey - The configuration key that is problematic
+     * @param message - Description of the configuration issue
+     * @param provider - LLM provider name
+     */
+    constructor(configKey: string, message: string, provider: string);
+}
+/**
+ * Error thrown when parsing LLM responses fails.
+ * This occurs when the response format is unexpected or malformed.
+ */
+export declare class LlmResponseParsingError extends LlmError {
+    readonly originalError: string;
+    /**
+     * Creates a new response parsing error
+     * @param error - Description of the parsing error
+     * @param provider - LLM provider name
+     * @param model - Model name that was being used
+     */
+    constructor(error: string, provider: string, model: string);
+}
+/**
+ * Error thrown when no tool executor is provided but tools are requested.
+ * This is a configuration issue where the LLM wants to call tools but can't.
+ */
+export declare class LlmMissingToolExecutorError extends LlmError {
+    /**
+     * Creates a new missing tool executor error
+     * @param provider - LLM provider name
+     * @param model - Model name that was being used
+     */
+    constructor(provider: string, model: string);
+}