@phuetz/code-buddy 0.1.13 → 0.1.14

package/dist/auth/profile-manager.js

@@ -0,0 +1,484 @@
+/**
+ * Auth Profile Manager
+ *
+ * OpenClaw-inspired profile manager with round-robin rotation and
+ * session stickiness. Manages authentication profiles across multiple
+ * providers with exponential backoff cooldowns, billing-aware failure
+ * handling, and persistent state.
+ */
+import { EventEmitter } from 'events';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { logger } from '../utils/logger.js';
+/**
+ * Default configuration
+ */
+export const DEFAULT_AUTH_PROFILE_MANAGER_CONFIG = {
+    profiles: [],
+    rotationStrategy: 'round-robin',
+    sessionSticky: true,
+    cooldownMs: 60_000, // 1 minute
+    billingCooldownMs: 18_000_000, // 5 hours
+    maxCooldownMs: 86_400_000, // 24 hours
+    persistPath: path.join(os.homedir(), '.codebuddy', 'auth-profiles.json'),
+};
+// ============================================================================
+// Auth Profile Manager
+// ============================================================================
+/**
+ * Auth Profile Manager
+ *
+ * Manages authentication profiles with round-robin rotation, session
+ * stickiness, and exponential backoff cooldowns. Supports billing-aware
+ * failure handling with separate escalation.
+ *
+ * Events:
+ * - `profile:selected` - Emitted when a profile is selected (profileId, sessionId?)
+ * - `profile:failed` - Emitted when a profile fails (profileId, error)
+ * - `profile:cooldown` - Emitted when a profile enters cooldown (profileId, cooldownMs)
+ * - `profile:recovered` - Emitted when a profile exits cooldown (profileId)
+ */
+export class AuthProfileManager extends EventEmitter {
+    config;
+    profiles = new Map();
+    cooldownStates = new Map();
+    sessionBindings = new Map(); // sessionId -> profileId
+    roundRobinIndex = 0;
+    recoveryTimers = new Map();
+    constructor(config = {}) {
+        super();
+        this.config = { ...DEFAULT_AUTH_PROFILE_MANAGER_CONFIG, ...config };
+        // Register provided profiles
+        for (const profile of this.config.profiles) {
+            this.profiles.set(profile.id, profile);
+            this.cooldownStates.set(profile.id, {
+                profileId: profile.id,
+                inCooldown: false,
+                cooldownUntil: 0,
+                failureCount: 0,
+                lastFailureWasBilling: false,
+            });
+        }
+        // Load persisted state
+        this.loadState();
+    }
+    // ============================================================================
+    // Profile Management
+    // ============================================================================
+    /**
+     * Add a profile
+     */
+    addProfile(profile) {
+        this.profiles.set(profile.id, profile);
+        if (!this.cooldownStates.has(profile.id)) {
+            this.cooldownStates.set(profile.id, {
+                profileId: profile.id,
+                inCooldown: false,
+                cooldownUntil: 0,
+                failureCount: 0,
+                lastFailureWasBilling: false,
+            });
+        }
+    }
+    /**
+     * Remove a profile
+     */
+    removeProfile(profileId) {
+        const timer = this.recoveryTimers.get(profileId);
+        if (timer) {
+            clearTimeout(timer);
+            this.recoveryTimers.delete(profileId);
+        }
+        this.cooldownStates.delete(profileId);
+        // Remove session bindings pointing to this profile
+        for (const [sessionId, boundProfileId] of this.sessionBindings.entries()) {
+            if (boundProfileId === profileId) {
+                this.sessionBindings.delete(sessionId);
+            }
+        }
+        return this.profiles.delete(profileId);
+    }
+    /**
+     * Get a profile by ID
+     */
+    getProfile(profileId) {
+        return this.profiles.get(profileId);
+    }
+    /**
+     * Get all registered profiles
+     */
+    getAllProfiles() {
+        return Array.from(this.profiles.values());
+    }
+    // ============================================================================
+    // Profile Selection
+    // ============================================================================
+    /**
+     * Get the next available profile, optionally sticky to a session.
+     *
+     * If sessionSticky is enabled and a session already has a bound profile
+     * that is healthy, that profile is returned. Otherwise a new profile is
+     * selected using the configured rotation strategy.
+     */
+    getNextProfile(sessionId) {
+        // Session stickiness: return the bound profile if healthy
+        if (sessionId && this.config.sessionSticky) {
+            const boundProfileId = this.sessionBindings.get(sessionId);
+            if (boundProfileId) {
+                const profile = this.profiles.get(boundProfileId);
+                if (profile && !this.isInCooldown(boundProfileId)) {
+                    this.emit('profile:selected', boundProfileId, sessionId);
+                    return profile;
+                }
+                // Bound profile is unhealthy, unbind
+                this.sessionBindings.delete(sessionId);
+            }
+        }
+        const healthy = this.getHealthyProfiles();
+        if (healthy.length === 0) {
+            return null;
+        }
+        let selected;
+        switch (this.config.rotationStrategy) {
+            case 'round-robin':
+                selected = this.selectRoundRobin(healthy);
+                break;
+            case 'priority':
+                selected = this.selectByPriority(healthy);
+                break;
+            case 'random':
+                selected = this.selectRandom(healthy);
+                break;
+            default:
+                selected = this.selectRoundRobin(healthy);
+        }
+        // Bind to session if sticky
+        if (sessionId && this.config.sessionSticky) {
+            this.sessionBindings.set(sessionId, selected.id);
+        }
+        this.emit('profile:selected', selected.id, sessionId);
+        logger.debug(`Auth profile selected: ${selected.id} (${selected.provider})`);
+        return selected;
+    }
+    /**
+     * Get the sticky profile for a session (without selecting a new one)
+     */
+    getProfileForSession(sessionId) {
+        const boundProfileId = this.sessionBindings.get(sessionId);
+        if (!boundProfileId) {
+            return null;
+        }
+        return this.profiles.get(boundProfileId) ?? null;
+    }
+    /**
+     * Get all profiles not currently in cooldown
+     */
+    getHealthyProfiles() {
+        const now = Date.now();
+        const healthy = [];
+        for (const profile of this.profiles.values()) {
+            const state = this.cooldownStates.get(profile.id);
+            if (!state || !state.inCooldown || state.cooldownUntil <= now) {
+                // If cooldown has expired, mark as recovered
+                if (state && state.inCooldown && state.cooldownUntil <= now) {
+                    this.recoverProfile(profile.id);
+                }
+                healthy.push(profile);
+            }
+        }
+        // OAuth profiles are prioritized over API key profiles
+        healthy.sort((a, b) => {
+            if (a.type === 'oauth' && b.type !== 'oauth')
+                return -1;
+            if (a.type !== 'oauth' && b.type === 'oauth')
+                return 1;
+            return b.priority - a.priority;
+        });
+        return healthy;
+    }
+    // ============================================================================
+    // Failure & Recovery
+    // ============================================================================
+    /**
+     * Mark a profile as failed with exponential backoff cooldown.
+     *
+     * Normal failures: 1min -> 5min -> 25min -> 1h (max)
+     * Billing failures: 5h -> 10h -> 20h -> 24h (max)
+     *
+     * The backoff multiplier is 5x for normal and 2x for billing.
+     */
+    markFailed(profileId, error, isBilling = false) {
+        const state = this.cooldownStates.get(profileId);
+        if (!state) {
+            logger.warn(`markFailed called for unknown profile: ${profileId}`);
+            return;
+        }
+        state.failureCount++;
+        state.lastError = error;
+        state.lastFailureAt = Date.now();
+        state.lastFailureWasBilling = isBilling;
+        // Calculate cooldown with exponential backoff
+        let cooldownMs;
+        if (isBilling) {
+            // Billing: 5h initial, 2x escalation, capped at 24h
+            cooldownMs = this.config.billingCooldownMs * Math.pow(2, state.failureCount - 1);
+            cooldownMs = Math.min(cooldownMs, this.config.maxCooldownMs);
+        }
+        else {
+            // Normal: 1min initial, 5x escalation, capped at 1h (3_600_000 ms)
+            cooldownMs = this.config.cooldownMs * Math.pow(5, state.failureCount - 1);
+            cooldownMs = Math.min(cooldownMs, 3_600_000);
+        }
+        state.inCooldown = true;
+        state.cooldownUntil = Date.now() + cooldownMs;
+        this.emit('profile:failed', profileId, error);
+        this.emit('profile:cooldown', profileId, cooldownMs);
+        logger.warn(`Auth profile ${profileId} failed (${isBilling ? 'billing' : 'error'}), ` +
+            `cooldown ${Math.round(cooldownMs / 1000)}s, failures: ${state.failureCount}`);
+        // Schedule recovery timer
+        this.scheduleRecovery(profileId, cooldownMs);
+        // Persist state
+        this.saveState();
+    }
+    /**
+     * Mark a profile as successful, resetting its failure count
+     */
+    markSuccess(profileId) {
+        const state = this.cooldownStates.get(profileId);
+        if (!state)
+            return;
+        state.failureCount = 0;
+        state.inCooldown = false;
+        state.cooldownUntil = 0;
+        state.lastError = undefined;
+        state.lastFailureWasBilling = false;
+        // Cancel recovery timer since we're already healthy
+        const timer = this.recoveryTimers.get(profileId);
+        if (timer) {
+            clearTimeout(timer);
+            this.recoveryTimers.delete(profileId);
+        }
+        // Persist state
+        this.saveState();
+    }
+    /**
+     * Release a session's sticky profile binding
+     */
+    releaseSession(sessionId) {
+        this.sessionBindings.delete(sessionId);
+    }
+    // ============================================================================
+    // Internal Selection Strategies
+    // ============================================================================
+    /**
+     * Round-robin selection across healthy profiles
+     */
+    selectRoundRobin(healthy) {
+        if (this.roundRobinIndex >= healthy.length) {
+            this.roundRobinIndex = 0;
+        }
+        const selected = healthy[this.roundRobinIndex];
+        this.roundRobinIndex = (this.roundRobinIndex + 1) % healthy.length;
+        return selected;
+    }
+    /**
+     * Priority-based selection (highest priority first)
+     */
+    selectByPriority(healthy) {
+        // Already sorted by priority in getHealthyProfiles()
+        return healthy[0];
+    }
+    /**
+     * Random selection
+     */
+    selectRandom(healthy) {
+        const index = Math.floor(Math.random() * healthy.length);
+        return healthy[index];
+    }
+    // ============================================================================
+    // Cooldown Management
+    // ============================================================================
+    /**
+     * Check if a profile is currently in cooldown
+     */
+    isInCooldown(profileId) {
+        const state = this.cooldownStates.get(profileId);
+        if (!state || !state.inCooldown)
+            return false;
+        if (state.cooldownUntil <= Date.now()) {
+            // Cooldown expired, recover
+            this.recoverProfile(profileId);
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Recover a profile from cooldown
+     */
+    recoverProfile(profileId) {
+        const state = this.cooldownStates.get(profileId);
+        if (!state)
+            return;
+        state.inCooldown = false;
+        // Keep failureCount so next failure escalates appropriately
+        // Only markSuccess() fully resets
+        const timer = this.recoveryTimers.get(profileId);
+        if (timer) {
+            clearTimeout(timer);
+            this.recoveryTimers.delete(profileId);
+        }
+        this.emit('profile:recovered', profileId);
+        logger.info(`Auth profile ${profileId} recovered from cooldown`);
+        this.saveState();
+    }
+    /**
+     * Schedule automatic recovery after cooldown expires
+     */
+    scheduleRecovery(profileId, cooldownMs) {
+        // Cancel existing timer
+        const existing = this.recoveryTimers.get(profileId);
+        if (existing) {
+            clearTimeout(existing);
+        }
+        const timer = setTimeout(() => {
+            this.recoveryTimers.delete(profileId);
+            this.recoverProfile(profileId);
+        }, cooldownMs);
+        // Unref so it doesn't keep the process alive
+        if (timer.unref) {
+            timer.unref();
+        }
+        this.recoveryTimers.set(profileId, timer);
+    }
+    // ============================================================================
+    // Persistence
+    // ============================================================================
+    /**
+     * Save cooldown states to disk
+     */
+    saveState() {
+        try {
+            const persistDir = path.dirname(this.config.persistPath);
+            if (!fs.existsSync(persistDir)) {
+                fs.mkdirSync(persistDir, { recursive: true });
+            }
+            const state = {
+                cooldowns: {},
+                savedAt: Date.now(),
+            };
+            for (const [id, cooldownState] of this.cooldownStates.entries()) {
+                state.cooldowns[id] = {
+                    cooldownUntil: cooldownState.cooldownUntil,
+                    failureCount: cooldownState.failureCount,
+                    lastFailureWasBilling: cooldownState.lastFailureWasBilling,
+                    lastError: cooldownState.lastError,
+                    lastFailureAt: cooldownState.lastFailureAt,
+                };
+            }
+            fs.writeFileSync(this.config.persistPath, JSON.stringify(state, null, 2), 'utf-8');
+        }
+        catch (err) {
+            logger.warn(`Failed to save auth profile state: ${err}`);
+        }
+    }
+    /**
+     * Load cooldown states from disk
+     */
+    loadState() {
+        try {
+            if (!fs.existsSync(this.config.persistPath)) {
+                return;
+            }
+            const raw = fs.readFileSync(this.config.persistPath, 'utf-8');
+            const state = JSON.parse(raw);
+            if (!state || !state.cooldowns) {
+                return;
+            }
+            const now = Date.now();
+            for (const [id, saved] of Object.entries(state.cooldowns)) {
+                const existing = this.cooldownStates.get(id);
+                if (!existing)
+                    continue;
+                existing.failureCount = saved.failureCount;
+                existing.lastFailureWasBilling = saved.lastFailureWasBilling;
+                existing.lastError = saved.lastError;
+                existing.lastFailureAt = saved.lastFailureAt;
+                if (saved.cooldownUntil > now) {
+                    existing.inCooldown = true;
+                    existing.cooldownUntil = saved.cooldownUntil;
+                    // Schedule recovery for remaining time
+                    this.scheduleRecovery(id, saved.cooldownUntil - now);
+                }
+                else {
+                    // Cooldown already expired
+                    existing.inCooldown = false;
+                    existing.cooldownUntil = 0;
+                }
+            }
+            logger.debug('Auth profile state loaded from disk');
+        }
+        catch (err) {
+            logger.warn(`Failed to load auth profile state: ${err}`);
+        }
+    }
+    // ============================================================================
+    // Stats & Diagnostics
+    // ============================================================================
+    /**
+     * Get status of all profiles
+     */
+    getStatus() {
+        const now = Date.now();
+        return this.getAllProfiles().map(profile => {
+            const state = this.cooldownStates.get(profile.id);
+            const inCooldown = state?.inCooldown && (state.cooldownUntil > now);
+            return {
+                profileId: profile.id,
+                provider: profile.provider,
+                type: profile.type,
+                priority: profile.priority,
+                healthy: !inCooldown,
+                failureCount: state?.failureCount ?? 0,
+                inCooldown: !!inCooldown,
+                cooldownRemainingMs: inCooldown ? state.cooldownUntil - now : 0,
+                lastError: state?.lastError,
+            };
+        });
+    }
+    /**
+     * Shutdown - clear all timers
+     */
+    shutdown() {
+        for (const timer of this.recoveryTimers.values()) {
+            clearTimeout(timer);
+        }
+        this.recoveryTimers.clear();
+        this.sessionBindings.clear();
+        this.saveState();
+    }
+}
+// ============================================================================
+// Singleton
+// ============================================================================
+let authProfileManagerInstance = null;
+/**
+ * Get the auth profile manager singleton
+ */
+export function getAuthProfileManager(config) {
+    if (!authProfileManagerInstance) {
+        authProfileManagerInstance = new AuthProfileManager(config);
+    }
+    return authProfileManagerInstance;
+}
+/**
+ * Reset the auth profile manager singleton
+ */
+export function resetAuthProfileManager() {
+    if (authProfileManagerInstance) {
+        authProfileManagerInstance.shutdown();
+        authProfileManagerInstance = null;
+    }
+}
+export default AuthProfileManager;
+//# sourceMappingURL=profile-manager.js.map

package/dist/auth/profile-manager.js.map

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

package/dist/browser-automation/browser-manager.d.ts

@@ -10,7 +10,7 @@
  * - Device emulation
  */
 import { EventEmitter } from 'events';
-import { BrowserTab, WebElement, WebSnapshot, SnapshotOptions, ClickOptions, TypeOptions, FillOptions, ScrollOptions, SelectOptions, NavigateOptions, ScreenshotOptions, PDFOptions, Cookie, DeviceConfig, GeolocationConfig, EvaluateOptions, EvaluateResult, DialogAction, FileUploadOptions, BrowserConfig } from './types.js';
+import { BrowserTab, WebElement, WebSnapshot, SnapshotOptions, ClickOptions, TypeOptions, FillOptions, ScrollOptions, SelectOptions, NavigateOptions, ScreenshotOptions, PDFOptions, Cookie, DeviceConfig, GeolocationConfig, EvaluateOptions, EvaluateResult, DialogAction, FileUploadOptions, BrowserConfig, ConsoleEntry, RouteRule, ExtendedDeviceConfig } from './types.js';
 export declare class BrowserManager extends EventEmitter {
     private config;
     private browser;
@@ -20,6 +20,10 @@ export declare class BrowserManager extends EventEmitter {
     private currentSnapshot;
     private nextRef;
     private playwright;
+    private consoleBuffer;
+    private static readonly MAX_CONSOLE_ENTRIES;
+    private _routeInterceptor;
+    private _profileManager;
     constructor(config?: Partial<BrowserConfig>);
     /**
      * Launch browser
@@ -53,6 +57,10 @@ export declare class BrowserManager extends EventEmitter {
     /**
      * Take snapshot of current page
      */
+    /**
+     * Get next available ref number (for shared ref space with desktop)
+     */
+    getNextRef(): number;
     takeSnapshot(options?: SnapshotOptions): Promise<WebSnapshot>;
     /**
      * Extract elements from page
@@ -177,6 +185,76 @@ export declare class BrowserManager extends EventEmitter {
      * Check if browser is launched
      */
     isLaunched(): boolean;
+    /**
+     * Get console history buffer
+     */
+    getConsoleHistory(type?: string, limit?: number): ConsoleEntry[];
+    /**
+     * Clear console history buffer
+     */
+    clearConsoleHistory(): void;
+    /**
+     * Get localStorage for the current page's origin
+     */
+    getLocalStorage(): Promise<Record<string, string>>;
+    /**
+     * Set localStorage entries for the current page
+     */
+    setLocalStorage(data: Record<string, string>): Promise<void>;
+    /**
+     * Get sessionStorage for the current page's origin
+     */
+    getSessionStorage(): Promise<Record<string, string>>;
+    /**
+     * Set sessionStorage entries for the current page
+     */
+    setSessionStorage(data: Record<string, string>): Promise<void>;
+    /**
+     * Set timezone for the browser context
+     */
+    setTimezone(timezoneId: string): Promise<void>;
+    /**
+     * Set locale for the browser context
+     */
+    setLocale(locale: string): Promise<void>;
+    /**
+     * Set color scheme preference
+     */
+    setColorScheme(colorScheme: 'light' | 'dark' | 'no-preference'): Promise<void>;
+    /**
+     * Grant permissions to the browser context
+     */
+    grantPermissions(permissions: string[]): Promise<void>;
+    /**
+     * Extended device emulation with timezone, locale, colorScheme, permissions
+     */
+    emulateDeviceExtended(device: ExtendedDeviceConfig): Promise<void>;
+    private getProfileManager;
+    /**
+     * Save current browser state as a named profile
+     */
+    saveProfile(name: string): Promise<void>;
+    /**
+     * Load a named profile into the browser
+     */
+    loadProfile(name: string): Promise<boolean>;
+    private getRouteInterceptor;
+    /**
+     * Add a route interception rule
+     */
+    addRouteRule(rule: RouteRule): Promise<void>;
+    /**
+     * Remove a route interception rule
+     */
+    removeRouteRule(ruleId: string): Promise<void>;
+    /**
+     * List active route rules
+     */
+    listRouteRules(): RouteRule[];
+    /**
+     * Clear all route rules
+     */
+    clearRouteRules(): Promise<void>;
     /**
      * Get current snapshot
      */