monty-autonomous-fullstack-dev-multillm 1.0.0

package/dist/utils/hooks-manager.js

@@ -0,0 +1,359 @@
+/**
+ * Hooks Manager
+ * Implements lifecycle hooks for the Claude Agent SDK.
+ * Hooks allow customization of agent behavior at key points.
+ *
+ * Copyright (c) 2025 Dobeu Tech Solutions LLC
+ * Licensed under CC BY-NC 4.0
+ */
+import { agentConfig } from '../config/agent-config.js';
+/**
+ * Default security hook configuration
+ */
+export const DEFAULT_SECURITY_CONFIG = {
+    blockSensitiveFiles: true,
+    sensitivePatterns: [
+        /\.env$/,
+        /\.env\.\w+$/,
+        /credentials\.(json|yaml|yml)$/,
+        /secrets?\.(json|yaml|yml)$/,
+        /private[_-]?key/i,
+        /\.pem$/,
+        /\.key$/,
+        /id_rsa/,
+        /\.ssh\//,
+    ],
+    blockDangerousCommands: true,
+    dangerousCommandPatterns: [
+        /rm\s+-rf\s+\//,
+        /rm\s+-rf\s+~\//,
+        /rm\s+-rf\s+\.\.\//,
+        /:\s*>\s*[^>]/,
+        /mkfs\./,
+        /dd\s+if=/,
+        /chmod\s+777/,
+        /curl\s+.*\|\s*(ba)?sh/,
+        /wget\s+.*\|\s*(ba)?sh/,
+    ],
+    requireConfirmation: false,
+    confirmationPatterns: [
+        /drop\s+database/i,
+        /drop\s+table/i,
+        /truncate/i,
+        /delete\s+from/i,
+        /git\s+reset\s+--hard/,
+        /git\s+push\s+.*--force/,
+    ],
+    auditAllActions: true,
+};
+/**
+ * Hooks Manager class
+ */
+export class HooksManager {
+    hooks = new Map();
+    securityConfig;
+    hookIdCounter = 0;
+    auditLog = [];
+    enabled;
+    constructor(securityConfig) {
+        this.securityConfig = { ...DEFAULT_SECURITY_CONFIG, ...securityConfig };
+        this.enabled = agentConfig.features.enableSecurityHooks;
+        // Register default security hooks
+        if (this.enabled) {
+            this.registerSecurityHooks();
+        }
+    }
+    /**
+     * Check if hooks are enabled
+     */
+    isEnabled() {
+        return this.enabled;
+    }
+    /**
+     * Enable or disable hooks
+     */
+    setEnabled(enabled) {
+        this.enabled = enabled;
+    }
+    /**
+     * Generate unique hook ID
+     */
+    generateId() {
+        return `hook_${++this.hookIdCounter}_${Date.now()}`;
+    }
+    /**
+     * Register a hook
+     */
+    register(event, handler, options) {
+        const hookId = this.generateId();
+        const registeredHook = {
+            id: hookId,
+            event,
+            handler,
+            priority: options?.priority ?? 50,
+            name: options?.name ?? `Hook ${hookId}`,
+            description: options?.description,
+            enabled: options?.enabled ?? true,
+        };
+        if (!this.hooks.has(event)) {
+            this.hooks.set(event, []);
+        }
+        const eventHooks = this.hooks.get(event);
+        eventHooks.push(registeredHook);
+        // Sort by priority (higher priority runs first)
+        eventHooks.sort((a, b) => b.priority - a.priority);
+        return hookId;
+    }
+    /**
+     * Unregister a hook
+     */
+    unregister(hookId) {
+        for (const [event, hooks] of this.hooks.entries()) {
+            const index = hooks.findIndex(h => h.id === hookId);
+            if (index !== -1) {
+                hooks.splice(index, 1);
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Enable a hook
+     */
+    enable(hookId) {
+        for (const hooks of this.hooks.values()) {
+            const hook = hooks.find(h => h.id === hookId);
+            if (hook) {
+                hook.enabled = true;
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Disable a hook
+     */
+    disable(hookId) {
+        for (const hooks of this.hooks.values()) {
+            const hook = hooks.find(h => h.id === hookId);
+            if (hook) {
+                hook.enabled = false;
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Trigger hooks for an event
+     */
+    async trigger(event, data) {
+        if (!this.enabled) {
+            return { continue: true };
+        }
+        const context = {
+            event,
+            timestamp: Date.now(),
+            data,
+        };
+        // Audit logging
+        if (this.securityConfig.auditAllActions) {
+            this.auditLog.push(context);
+        }
+        const eventHooks = this.hooks.get(event) || [];
+        const enabledHooks = eventHooks.filter(h => h.enabled);
+        const warnings = [];
+        let modified = {};
+        for (const hook of enabledHooks) {
+            try {
+                const result = await hook.handler(context);
+                if (!result.continue) {
+                    return result;
+                }
+                if (result.warnings) {
+                    warnings.push(...result.warnings);
+                }
+                if (result.modified) {
+                    modified = { ...modified, ...result.modified };
+                }
+            }
+            catch (error) {
+                console.error(`Hook ${hook.name} failed:`, error);
+                warnings.push(`Hook ${hook.name} threw an error`);
+            }
+        }
+        return {
+            continue: true,
+            modified: Object.keys(modified).length > 0 ? modified : undefined,
+            warnings: warnings.length > 0 ? warnings : undefined,
+        };
+    }
+    /**
+     * Register default security hooks
+     */
+    registerSecurityHooks() {
+        // File read security hook
+        this.register('file.read', async (context) => {
+            const filePath = context.data?.path;
+            if (!filePath)
+                return { continue: true };
+            for (const pattern of this.securityConfig.sensitivePatterns) {
+                if (pattern.test(filePath)) {
+                    return {
+                        continue: false,
+                        block: {
+                            reason: `Blocked read of sensitive file: ${filePath}`,
+                            suggestion: 'Use environment variables for sensitive data',
+                        },
+                    };
+                }
+            }
+            return { continue: true };
+        }, { name: 'Sensitive File Read Block', priority: 100 });
+        // File write security hook
+        this.register('file.write', async (context) => {
+            const filePath = context.data?.path;
+            if (!filePath)
+                return { continue: true };
+            for (const pattern of this.securityConfig.sensitivePatterns) {
+                if (pattern.test(filePath)) {
+                    return {
+                        continue: false,
+                        block: {
+                            reason: `Blocked write to sensitive file: ${filePath}`,
+                            suggestion: 'Use environment variables for sensitive data',
+                        },
+                    };
+                }
+            }
+            return { continue: true };
+        }, { name: 'Sensitive File Write Block', priority: 100 });
+        // Command execution security hook
+        this.register('tool.before', async (context) => {
+            const toolName = context.data?.tool;
+            const command = context.data?.command;
+            if (toolName !== 'Bash' || !command) {
+                return { continue: true };
+            }
+            // Check for dangerous commands
+            if (this.securityConfig.blockDangerousCommands) {
+                for (const pattern of this.securityConfig.dangerousCommandPatterns) {
+                    if (pattern.test(command)) {
+                        return {
+                            continue: false,
+                            block: {
+                                reason: `Blocked dangerous command: ${command}`,
+                                suggestion: 'Review command for safety before execution',
+                            },
+                        };
+                    }
+                }
+            }
+            // Check for commands requiring confirmation
+            if (this.securityConfig.requireConfirmation) {
+                for (const pattern of this.securityConfig.confirmationPatterns) {
+                    if (pattern.test(command)) {
+                        return {
+                            continue: true,
+                            warnings: [`Command requires user confirmation: ${command}`],
+                        };
+                    }
+                }
+            }
+            return { continue: true };
+        }, { name: 'Dangerous Command Block', priority: 100 });
+    }
+    /**
+     * Get audit log
+     */
+    getAuditLog() {
+        return [...this.auditLog];
+    }
+    /**
+     * Clear audit log
+     */
+    clearAuditLog() {
+        this.auditLog = [];
+    }
+    /**
+     * Get all registered hooks
+     */
+    listHooks() {
+        const result = [];
+        for (const [event, hooks] of this.hooks.entries()) {
+            for (const hook of hooks) {
+                result.push({
+                    event,
+                    name: hook.name,
+                    enabled: hook.enabled,
+                    priority: hook.priority,
+                });
+            }
+        }
+        return result;
+    }
+    /**
+     * Get hooks summary
+     */
+    getSummary() {
+        const total = this.listHooks().length;
+        const enabled = this.listHooks().filter(h => h.enabled).length;
+        const auditCount = this.auditLog.length;
+        return `Hooks: ${enabled}/${total} enabled, ${auditCount} audit entries`;
+    }
+    /**
+     * Update security configuration
+     */
+    updateSecurityConfig(config) {
+        this.securityConfig = { ...this.securityConfig, ...config };
+    }
+    /**
+     * Get current security configuration
+     */
+    getSecurityConfig() {
+        return { ...this.securityConfig };
+    }
+}
+// Convenience functions for common hooks
+/**
+ * Create a logging hook
+ */
+export function createLoggingHook(logFn) {
+    return async (context) => {
+        logFn(context);
+        return { continue: true };
+    };
+}
+/**
+ * Create a validation hook
+ */
+export function createValidationHook(validate) {
+    return async (context) => {
+        const result = validate(context);
+        if (result === true) {
+            return { continue: true };
+        }
+        return {
+            continue: false,
+            block: {
+                reason: typeof result === 'string' ? result : 'Validation failed',
+            },
+        };
+    };
+}
+/**
+ * Create a transformation hook
+ */
+export function createTransformationHook(transform) {
+    return async (context) => {
+        const modified = transform(context);
+        return { continue: true, modified };
+    };
+}
+/**
+ * Create a hooks manager instance
+ */
+export function createHooksManager(securityConfig) {
+    return new HooksManager(securityConfig);
+}
+export default HooksManager;
+//# sourceMappingURL=hooks-manager.js.map

package/dist/utils/hooks-manager.js.map

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

package/dist/utils/multi-auth-manager.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Multi-Provider Authentication Manager
+ * Unified credential management for all supported AI providers.
+ * Supports auto-migration from v1 credentials and provider-specific login flows.
+ *
+ * Copyright (c) 2025 Dobeu Tech Solutions LLC
+ * Licensed under CC BY-NC 4.0
+ */
+import { type ProviderCredentials, type MultiProviderCredentials, type AuthMethod, type AuthSource } from '../config/auth-config.js';
+import { type ProviderName } from '../config/provider-config.js';
+/**
+ * Provider display information
+ */
+interface ProviderDisplayInfo {
+    name: ProviderName;
+    displayName: string;
+    enabled: boolean;
+    authenticated: boolean;
+    method: AuthMethod | null;
+    source: AuthSource | null;
+    email: string | null;
+    keyPreview: string | null;
+    isDefault: boolean;
+}
+/**
+ * MultiAuthManager - Singleton for managing multi-provider authentication
+ */
+export declare class MultiAuthManager {
+    private static instance;
+    private credentials;
+    private constructor();
+    /**
+     * Get the singleton instance
+     */
+    static getInstance(): MultiAuthManager;
+    /**
+     * Ensure the config directory exists
+     */
+    private ensureConfigDir;
+    /**
+     * Load credentials from file (auto-migrates v1 to v2 format)
+     */
+    loadCredentials(): MultiProviderCredentials;
+    /**
+     * Save credentials to file
+     */
+    saveCredentials(credentials: MultiProviderCredentials): void;
+    /**
+     * Get credentials for a specific provider
+     */
+    getProviderCredentials(provider: ProviderName): ProviderCredentials | null;
+    /**
+     * Set credentials for a specific provider
+     */
+    setProviderCredentials(provider: ProviderName, creds: ProviderCredentials): void;
+    /**
+     * Remove credentials for a specific provider
+     */
+    removeProviderCredentials(provider: ProviderName): void;
+    /**
+     * Get API key for a provider (with token refresh if needed)
+     */
+    getApiKey(provider: ProviderName): Promise<string | null>;
+    /**
+     * Get API key synchronously (no refresh)
+     */
+    getApiKeySync(provider: ProviderName): string | null;
+    /**
+     * Check if a provider is authenticated
+     */
+    isProviderAuthenticated(provider: ProviderName): boolean;
+    /**
+     * Check if any provider is authenticated
+     */
+    isAnyProviderAuthenticated(): boolean;
+    /**
+     * Get all authenticated providers
+     */
+    getAuthenticatedProviders(): ProviderName[];
+    /**
+     * Get default provider
+     */
+    getDefaultProvider(): ProviderName;
+    /**
+     * Set default provider
+     */
+    setDefaultProvider(provider: ProviderName): void;
+    /**
+     * Get display info for all providers
+     */
+    getProviderDisplayInfo(): ProviderDisplayInfo[];
+    /**
+     * Validate a provider's API key
+     */
+    validateProviderKey(provider: ProviderName, key: string): Promise<boolean>;
+    /**
+     * Interactive login for a specific provider
+     */
+    loginProvider(provider: ProviderName, options?: {
+        key?: string;
+        method?: AuthMethod;
+    }): Promise<boolean>;
+    /**
+     * Interactive login for all providers
+     */
+    loginAll(): Promise<void>;
+    /**
+     * Logout from a specific provider
+     */
+    logoutProvider(provider: ProviderName): void;
+    /**
+     * Logout from all providers
+     */
+    logoutAll(): void;
+    /**
+     * Display current auth status (whoami)
+     */
+    whoami(): void;
+    /**
+     * Set environment variables for all authenticated providers
+     */
+    setEnvForChildProcess(): void;
+    /**
+     * Get preferences
+     */
+    getPreferences(): MultiProviderCredentials['preferences'];
+    /**
+     * Update preferences
+     */
+    setPreferences(prefs: Partial<MultiProviderCredentials['preferences']>): void;
+}
+export declare const multiAuthManager: MultiAuthManager;
+export declare function getApiKey(provider: ProviderName): Promise<string | null>;
+export declare function getApiKeySync(provider: ProviderName): string | null;
+export declare function isProviderAuthenticated(provider: ProviderName): boolean;
+export declare function getAuthenticatedProviders(): ProviderName[];
+export declare function loginProvider(provider: ProviderName): Promise<boolean>;
+export declare function loginAll(): Promise<void>;
+export declare function logoutProvider(provider: ProviderName): void;
+export declare function logoutAll(): void;
+export declare function whoami(): void;
+export declare function setEnvForChildProcess(): void;
+export default multiAuthManager;
+//# sourceMappingURL=multi-auth-manager.d.ts.map

package/dist/utils/multi-auth-manager.d.ts.map

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