@jsonstudio/rcc 0.85.9

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

@@ -0,0 +1,435 @@
+/**
+ * Error Handler Registry
+ * Central registry for error messages and handling functions
+ * Provides standardized error handling across all modules
+ */
+// 在 dev/worktree 场景下，直接使用本仓库提供的 shim 实现，
+// 避免对 rcc-debugcenter / rcc-errorhandling 的运行时依赖。
+import { ErrorHandlingCenter } from 'rcc-errorhandling';
+/**
+ * Error Handler Registry class
+ * Centralized error handling system with registered handlers and message templates
+ */
+export class ErrorHandlerRegistry {
+    static instance;
+    errorHandlingCenter;
+    messageTemplates = new Map();
+    errorHandlers = new Map();
+    initialized = false;
+    constructor() {
+        this.errorHandlingCenter = new ErrorHandlingCenter();
+    }
+    /**
+     * Get singleton instance
+     */
+    static getInstance() {
+        if (!ErrorHandlerRegistry.instance) {
+            ErrorHandlerRegistry.instance = new ErrorHandlerRegistry();
+        }
+        return ErrorHandlerRegistry.instance;
+    }
+    /**
+     * Initialize the error handler registry
+     */
+    async initialize() {
+        if (this.initialized) {
+            return;
+        }
+        try {
+            await this.errorHandlingCenter.initialize();
+            await this.registerDefaultErrorMessages();
+            await this.registerDefaultErrorHandlers();
+            this.initialized = true;
+            this.logDebugEvent('error_handler_registry_initialized', {
+                messageTemplateCount: this.messageTemplates.size,
+                handlerCount: this.errorHandlers.size,
+            });
+        }
+        catch (error) {
+            console.error('Failed to initialize Error Handler Registry:', error);
+            throw error;
+        }
+    }
+    /**
+     * Register error message template
+     */
+    registerErrorMessage(template) {
+        // Check if already registered to avoid duplicates
+        if (this.messageTemplates.has(template.code)) {
+            return;
+        }
+        this.messageTemplates.set(template.code, template);
+        // Only publish debug events during normal operation (not during initialization)
+        if (this.initialized) {
+            this.logDebugEvent('error_message_registered', {
+                errorCode: template.code,
+                severity: template.severity,
+                category: template.category,
+            });
+        }
+    }
+    /**
+     * Register error handler function
+     */
+    registerErrorHandler(registration) {
+        if (!this.errorHandlers.has(registration.errorCode)) {
+            this.errorHandlers.set(registration.errorCode, []);
+        }
+        const handlers = this.errorHandlers.get(registration.errorCode);
+        // Check if this handler is already registered to avoid duplicates
+        const existingHandlerIndex = handlers.findIndex(h => h === registration.handler);
+        if (existingHandlerIndex !== -1) {
+            return;
+        }
+        handlers.push(registration.handler);
+        // Sort by priority (lower number = higher priority)
+        handlers.sort((a, b) => {
+            const priorityA = a._priority || 0;
+            const priorityB = b._priority || 0;
+            return priorityA - priorityB;
+        });
+        // Store priority on handler for future sorting
+        registration.handler._priority = registration.priority;
+        // Only publish debug events during normal operation (not during initialization)
+        if (this.initialized) {
+            this.logDebugEvent('error_handler_registered', {
+                errorCode: registration.errorCode,
+                priority: registration.priority,
+                description: registration.description,
+            });
+        }
+    }
+    /**
+     * Handle error with registered handlers
+     */
+    async handleError(error, context, moduleId, additionalContext) {
+        try {
+            // Get error message template
+            const template = this.getErrorMessageTemplate(error, context);
+            // Create error context
+            const errorContext = {
+                error: error,
+                source: `${moduleId}.${context}`,
+                severity: template.severity,
+                timestamp: Date.now(),
+                module: moduleId,
+                context: {
+                    ...additionalContext,
+                    stack: error.stack,
+                    name: error.name,
+                    errorCode: template.code,
+                    errorCategory: template.category,
+                    errorDescription: template.description,
+                    recovery: template.recovery,
+                },
+            };
+            // Use ErrorHandlingCenter for base error handling
+            await this.errorHandlingCenter.handleError(errorContext);
+            // Execute registered error handlers
+            await this.executeErrorHandlers(template.code, errorContext);
+        }
+        catch (handlerError) {
+            console.error('Failed to handle error:', handlerError);
+            console.error('Original error:', error);
+        }
+    }
+    /**
+     * Get error message template for error
+     */
+    getErrorMessageTemplate(error, context) {
+        // Try to find specific error template based on error type or message
+        const errorType = error.constructor.name;
+        const errorCode = this.generateErrorCode(errorType, context);
+        let template = this.messageTemplates.get(errorCode);
+        if (!template) {
+            // Try to find template by error type
+            for (const [code, tmpl] of this.messageTemplates.entries()) {
+                if (code.includes(errorType.toLowerCase()) || code.includes(context.toLowerCase())) {
+                    template = tmpl;
+                    break;
+                }
+            }
+        }
+        // Default template if no specific template found
+        if (!template) {
+            template = {
+                code: errorCode,
+                message: error.message,
+                severity: 'medium',
+                category: 'general',
+                description: 'General error occurred',
+                recovery: 'Retry the operation or contact support',
+            };
+        }
+        return template;
+    }
+    /**
+     * Generate error code based on error type and context
+     */
+    generateErrorCode(errorType, context) {
+        return `${errorType.toLowerCase()}_${context.toLowerCase()}`.replace(/\s+/g, '_');
+    }
+    /**
+     * Execute registered error handlers for specific error code
+     */
+    async executeErrorHandlers(errorCode, errorContext) {
+        const handlers = this.errorHandlers.get(errorCode);
+        if (!handlers || handlers.length === 0) {
+            return;
+        }
+        for (const handler of handlers) {
+            try {
+                await handler(errorContext);
+            }
+            catch (handlerError) {
+                console.error(`Error handler failed for error code ${errorCode}:`, handlerError);
+            }
+        }
+    }
+    /**
+     * Register default error messages
+     */
+    async registerDefaultErrorMessages() {
+        const defaultTemplates = [
+            {
+                code: 'sandbox_error',
+                message: 'Sandbox or permission policy denied the operation',
+                severity: 'high',
+                category: 'sandbox',
+                description: 'The runtime sandbox (OS or policy) blocked this action (e.g., EPERM/EACCES, MacOS Seatbelt).',
+                recovery: 'Grant required permissions, relax sandbox, or avoid restricted operations',
+            },
+            {
+                code: 'validation_error',
+                message: 'Request validation failed',
+                severity: 'medium',
+                category: 'validation',
+                description: 'The incoming request failed validation',
+                recovery: 'Check request parameters and format',
+            },
+            {
+                code: 'authentication_error',
+                message: 'Authentication failed',
+                severity: 'high',
+                category: 'security',
+                description: 'Authentication or authorization failed',
+                recovery: 'Check credentials and permissions',
+            },
+            {
+                code: 'provider_error',
+                message: 'Provider error occurred',
+                severity: 'medium',
+                category: 'provider',
+                description: 'AI provider returned an error',
+                recovery: 'Retry with different parameters or provider',
+            },
+            {
+                code: 'network_error',
+                message: 'Network connectivity error',
+                severity: 'medium',
+                category: 'network',
+                description: 'Failed to connect to external service',
+                recovery: 'Check network connection and retry',
+            },
+            {
+                code: 'timeout_error',
+                message: 'Request timeout',
+                severity: 'medium',
+                category: 'performance',
+                description: 'Request exceeded time limit',
+                recovery: 'Increase timeout or optimize request',
+            },
+            {
+                code: 'rate_limit_error',
+                message: 'Rate limit exceeded',
+                severity: 'medium',
+                category: 'performance',
+                description: 'Too many requests in time period',
+                recovery: 'Wait and retry with lower frequency',
+            },
+            {
+                code: 'configuration_error',
+                message: 'Configuration error',
+                severity: 'high',
+                category: 'configuration',
+                description: 'Invalid or missing configuration',
+                recovery: 'Check configuration files and environment',
+            },
+            {
+                code: 'initialization_error',
+                message: 'Service initialization failed',
+                severity: 'critical',
+                category: 'system',
+                description: 'Failed to initialize required service',
+                recovery: 'Check logs and restart service',
+            },
+            {
+                code: 'not_implemented_error',
+                message: 'Feature not implemented',
+                severity: 'low',
+                category: 'development',
+                description: 'Requested feature is not yet implemented',
+                recovery: 'Use different approach or wait for implementation',
+            },
+        ];
+        for (const template of defaultTemplates) {
+            this.registerErrorMessage(template);
+        }
+    }
+    /**
+     * Register default error handlers
+     */
+    async registerDefaultErrorHandlers() {
+        // Log error handler
+        this.registerErrorHandler({
+            errorCode: 'validation_error',
+            handler: async (context) => {
+                console.warn(`Validation Error in ${context.source}: ${context.error}`);
+            },
+            priority: 1,
+            description: 'Log validation errors',
+        });
+        // Network error handler
+        this.registerErrorHandler({
+            errorCode: 'network_error',
+            handler: async (context) => {
+                console.error(`Network Error in ${context.source}: ${context.error}`);
+                // Could implement automatic retry logic here
+            },
+            priority: 1,
+            description: 'Handle network connectivity errors',
+        });
+        // Provider error handler
+        this.registerErrorHandler({
+            errorCode: 'provider_error',
+            handler: async (context) => {
+                console.error(`Provider Error in ${context.source}: ${context.error}`);
+                // Could implement provider failover logic here
+            },
+            priority: 2,
+            description: 'Handle AI provider errors',
+        });
+        // Critical error handler
+        this.registerErrorHandler({
+            errorCode: 'initialization_error',
+            handler: async (context) => {
+                console.error(`Critical Error in ${context.source}: ${context.error}`);
+                // Could implement service restart logic here
+            },
+            priority: 0,
+            description: 'Handle critical system errors',
+        });
+        // 429 rate limit handler (delegates strategy to provided hooks; no hardcoded logic in caller)
+        this.registerErrorHandler({
+            errorCode: 'rate_limit_error',
+            handler: async (context) => {
+                try {
+                    const ctx = context.context || {};
+                    const hooks = ctx.hooks || {};
+                    const schedule = Array.isArray(ctx.schedule) ? ctx.schedule : [30000, 60000, 120000];
+                    const attempted = Array.isArray(ctx.attemptedPipelineIds) ? ctx.attemptedPipelineIds : [];
+                    const deferred = (ctx.deferred || {});
+                    // Try pipeline switch first if available
+                    const exclude = new Set(attempted);
+                    let candidates = [];
+                    try {
+                        candidates = hooks.getAvailablePipelines ? hooks.getAvailablePipelines(exclude) : [];
+                    }
+                    catch { }
+                    if (Array.isArray(candidates) && candidates.length > 0) {
+                        try {
+                            const next = hooks.selectNextRoundRobin ? hooks.selectNextRoundRobin(candidates) : candidates[0];
+                            const resp = await (hooks.processWithPipeline ? hooks.processWithPipeline(next) : Promise.reject(new Error('processWithPipeline not provided')));
+                            deferred.resolve(resp);
+                            return;
+                        }
+                        catch (e) {
+                            deferred.reject(e);
+                            return;
+                        }
+                    }
+                    // No candidates: backoff on last attempted pipeline
+                    const lastId = attempted.length ? attempted[attempted.length - 1] : undefined;
+                    const pipeline = lastId && hooks.getPipelineById ? hooks.getPipelineById(lastId) : undefined;
+                    if (!pipeline) {
+                        deferred.reject(context.error || new Error('No available pipelines for 429 handling'));
+                        return;
+                    }
+                    for (const delay of schedule) {
+                        try {
+                            // notify error center about backoff event (best-effort)
+                            try {
+                                await hooks.errorCenter?.handleError?.({ type: '429-backoff', timestamp: Date.now(), pipelineId: pipeline.pipelineId, delay, requestId: ctx.request?.route?.requestId });
+                            }
+                            catch { }
+                            await new Promise(resolve => setTimeout(resolve, delay));
+                            const resp = await (hooks.processWithPipeline ? hooks.processWithPipeline(pipeline) : Promise.reject(new Error('processWithPipeline not provided')));
+                            deferred.resolve(resp);
+                            return;
+                        }
+                        catch (e) {
+                            const code = e?.statusCode || e?.code || '';
+                            const is429 = (e?.statusCode === 429 || String(code).toUpperCase() === 'HTTP_429');
+                            if (!is429) {
+                                deferred.reject(e);
+                                return;
+                            }
+                            // else continue next delay
+                        }
+                    }
+                    // exhausted
+                    try {
+                        await hooks.errorCenter?.handleError?.({ type: '429-final-fail', timestamp: Date.now(), pipelineId: pipeline.pipelineId, requestId: ctx.request?.route?.requestId, message: context.error?.message });
+                    }
+                    catch { }
+                    deferred.reject(context.error || new Error('429 handling exhausted'));
+                }
+                catch (e) {
+                    // If the handler itself fails, reject via deferred if present
+                    try {
+                        context.context?.deferred?.reject?.(e);
+                    }
+                    catch { }
+                }
+            },
+            priority: 1,
+            description: 'Handle 429 rate limit via ErrorHandlingCenter hooks (switch or backoff)'
+        });
+    }
+    logDebugEvent(operationId, data) {
+        try {
+            console.debug('[error-handler-registry]', operationId, data);
+        }
+        catch {
+            // ignore logging failures
+        }
+    }
+    /**
+     * Get all registered error message templates
+     */
+    getRegisteredMessages() {
+        return Array.from(this.messageTemplates.values());
+    }
+    /**
+     * Get registered handlers for specific error code
+     */
+    getRegisteredHandlers(errorCode) {
+        return this.errorHandlers.get(errorCode) || [];
+    }
+    /**
+     * Destroy registry and cleanup resources
+     */
+    async destroy() {
+        try {
+            this.messageTemplates.clear();
+            this.errorHandlers.clear();
+            await this.errorHandlingCenter.destroy();
+            this.initialized = false;
+            this.logDebugEvent('error_handler_registry_destroyed', {});
+        }
+        catch (error) {
+            console.error('Failed to destroy Error Handler Registry:', error);
+        }
+    }
+}
+//# sourceMappingURL=error-handler-registry.js.map

package/dist/utils/error-handler-registry.js.map

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

package/dist/utils/error-handler.js

@@ -0,0 +1,3 @@
+"use strict";
+// 错误处理
+//# sourceMappingURL=error-handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":";AAAA,OAAO"}

package/dist/utils/error-handling-utils.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Error Handling Utilities
+ * Provides convenient utilities for modules to integrate with the enhanced error handling system
+ */
+import { /* ErrorHandlingCenter, */ type ErrorContext } from 'rcc-errorhandling';
+export declare function getErrorMessage(error: unknown): string;
+/**
+ * Error handling options
+ */
+export interface ErrorHandlingOptions {
+    severity?: 'low' | 'medium' | 'high' | 'critical';
+    category?: string;
+    recovery?: string;
+    additionalContext?: Record<string, unknown>;
+    suppressLogging?: boolean;
+}
+/**
+ * Error context builder interface
+ */
+export interface ErrorContextBuilder {
+    withSeverity(severity: 'low' | 'medium' | 'high' | 'critical'): ErrorContextBuilder;
+    withCategory(category: string): ErrorContextBuilder;
+    withRecovery(recovery: string): ErrorContextBuilder;
+    withAdditionalContext(context: Record<string, unknown>): ErrorContextBuilder;
+    withSuppressedLogging(): ErrorContextBuilder;
+    build(): ErrorContext;
+}
+/**
+ * Context-aware error class
+ */
+export declare class ContextualError extends Error {
+    readonly context: string;
+    readonly moduleId: string;
+    readonly severity: 'low' | 'medium' | 'high' | 'critical';
+    readonly category: string;
+    readonly additionalContext?: Record<string, unknown>;
+    constructor(message: string, context: string, moduleId: string, options?: ErrorHandlingOptions);
+}
+/**
+ * Error Handling Utilities class
+ * Provides convenient methods for error handling across all modules
+ */
+export declare class ErrorHandlingUtils {
+    private static registry;
+    /** Detect sandbox/permission-denied style errors */
+    static detectSandboxPermissionError(err: unknown): {
+        isSandbox: boolean;
+        reason: string;
+    };
+    /**
+     * Initialize error handling utilities
+     */
+    static initialize(): Promise<void>;
+    /**
+     * Handle error with enhanced context
+     */
+    static handleError(error: Error, context: string, moduleId: string, options?: ErrorHandlingOptions): Promise<void>;
+    /**
+     * Create error context builder
+     */
+    static createContextBuilder(error: Error, context: string, moduleId: string): ErrorContextBuilder;
+    /**
+     * Handle async function with error handling
+     */
+    static withErrorHandling<T>(fn: () => Promise<T>, context: string, moduleId: string, options?: ErrorHandlingOptions): Promise<T>;
+    /**
+     * Handle sync function with error handling
+     */
+    static withSyncErrorHandling<T>(fn: () => T, context: string, moduleId: string, options?: ErrorHandlingOptions): T;
+    /**
+     * Register custom error message
+     */
+    static registerErrorMessage(code: string, message: string, severity: 'low' | 'medium' | 'high' | 'critical', category: string, description?: string, recovery?: string): void;
+    /**
+     * Register custom error handler
+     */
+    static registerErrorHandler(errorCode: string, handler: (context: ErrorContext) => Promise<void>, priority?: number, description?: string): void;
+    /**
+     * Create module-specific error handler
+     */
+    static createModuleErrorHandler(moduleId: string): {
+        /**
+         * Handle error for this module
+         */
+        handle: (error: Error, context: string, options?: ErrorHandlingOptions) => Promise<void>;
+        /**
+         * Create contextual error for this module
+         */
+        createError: (message: string, context: string, options?: ErrorHandlingOptions) => ContextualError;
+        /**
+         * Register error message for this module
+         */
+        registerMessage: (code: string, message: string, severity: "low" | "medium" | "high" | "critical", category: string, description?: string, recovery?: string) => void;
+        /**
+         * Register error handler for this module
+         */
+        registerHandler: (errorCode: string, handler: (context: ErrorContext) => Promise<void>, priority?: number, description?: string) => void;
+        /**
+         * Wrap async function with error handling for this module
+         */
+        wrapAsync: <T>(fn: () => Promise<T>, context: string, options?: ErrorHandlingOptions) => (() => Promise<T>);
+        /**
+         * Wrap sync function with error handling for this module
+         */
+        wrapSync: <T>(fn: () => T, context: string, options?: ErrorHandlingOptions) => (() => T);
+    };
+    /**
+     * Log error with context
+     */
+    private static logError;
+    /**
+     * Get log level based on severity
+     */
+    private static getLogLevel;
+    /**
+     * Cleanup error handling utilities
+     */
+    static destroy(): Promise<void>;
+}