erosolar-cli 1.7.439 → 1.7.440

package/dist/ui/orchestration/StatusOrchestrator.d.ts

@@ -0,0 +1,156 @@
+/**
+ * StatusOrchestrator - Unified status management system
+ * Coordinates between tool execution, live status tracking, and overlay display
+ */
+import { EventEmitter } from 'events';
+import { ToolCallRequest } from '../../core/types.js';
+import { LiveStatusState, LiveStatusTone } from '../../shell/liveStatus.js';
+export type StatusEventType = 'status.base.changed' | 'status.override.pushed' | 'status.override.cleared' | 'tool.start' | 'tool.progress' | 'tool.complete' | 'tool.error' | 'animation.frame' | 'interrupt.received';
+export interface StatusEvent {
+    type: StatusEventType;
+    timestamp: number;
+    data: unknown;
+}
+export interface ToolStatus {
+    toolId: string;
+    tool: string;
+    status: 'starting' | 'running' | 'completing' | 'completed' | 'error';
+    description: string;
+    detail?: string;
+    progress?: {
+        current: number;
+        total: number;
+        percentage: number;
+    };
+    startedAt: number;
+    updatedAt: number;
+    tone: LiveStatusTone;
+}
+export interface StatusContext {
+    base: LiveStatusState | null;
+    overrides: Map<string, LiveStatusState>;
+    tools: Map<string, ToolStatus>;
+    animations: Map<string, AnimationState>;
+    interrupts: InterruptQueue;
+}
+export interface AnimationState {
+    id: string;
+    type: 'spinner' | 'progress' | 'pulse';
+    frame: number;
+    startedAt: number;
+    data?: unknown;
+}
+export interface InterruptQueue {
+    pending: Interrupt[];
+    active: Interrupt | null;
+}
+export interface Interrupt {
+    id: string;
+    priority: number;
+    type: string;
+    message: string;
+    timestamp: number;
+}
+export declare class StatusOrchestrator extends EventEmitter {
+    private context;
+    private statusListeners;
+    private priorityResolver;
+    constructor();
+    /**
+     * Set base status
+     */
+    setBaseStatus(status: LiveStatusState | null): void;
+    /**
+     * Push status override
+     */
+    pushOverride(id: string, status: LiveStatusState): void;
+    /**
+     * Clear status override
+     */
+    clearOverride(id: string): void;
+    /**
+     * Handle tool lifecycle events
+     */
+    onToolStart(toolCall: ToolCallRequest): void;
+    /**
+     * Update tool progress
+     */
+    onToolProgress(toolId: string, progress: {
+        current: number;
+        total: number;
+        message?: string;
+    }): void;
+    /**
+     * Handle tool completion
+     */
+    onToolComplete(toolId: string, result?: unknown): void;
+    /**
+     * Handle tool error
+     */
+    onToolError(toolId: string, error: unknown): void;
+    /**
+     * Queue an interrupt
+     */
+    queueInterrupt(interrupt: Omit<Interrupt, 'id' | 'timestamp'>): string;
+    /**
+     * Process pending interrupts
+     */
+    private processInterrupts;
+    /**
+     * Clear an active interrupt
+     */
+    clearInterrupt(id: string): void;
+    /**
+     * Get the current aggregated status
+     */
+    getCurrentStatus(): LiveStatusState | null;
+    /**
+     * Register animation
+     */
+    registerAnimation(id: string, type: AnimationState['type'], data?: unknown): void;
+    /**
+     * Update animation frame
+     */
+    updateAnimationFrame(id: string): void;
+    /**
+     * Clear animation
+     */
+    clearAnimation(id: string): void;
+    /**
+     * Subscribe to status events
+     */
+    subscribe(listener: (event: StatusEvent) => void): () => void;
+    /**
+     * Emit status event
+     */
+    private emitEvent;
+    /**
+     * Get tool operation description
+     */
+    private describeToolOperation;
+    /**
+     * Get tone for tool type
+     */
+    private getToolTone;
+    /**
+     * Helper to truncate paths
+     */
+    private truncatePath;
+    /**
+     * Helper to truncate commands
+     */
+    private truncateCommand;
+    /**
+     * Helper to truncate search queries
+     */
+    private truncateQuery;
+    /**
+     * Get full context for debugging
+     */
+    getContext(): StatusContext;
+    /**
+     * Reset all status
+     */
+    reset(): void;
+}
+//# sourceMappingURL=StatusOrchestrator.d.ts.map

package/dist/ui/orchestration/StatusOrchestrator.d.ts.map

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

package/dist/ui/orchestration/StatusOrchestrator.js

@@ -0,0 +1,406 @@
+/**
+ * StatusOrchestrator - Unified status management system
+ * Coordinates between tool execution, live status tracking, and overlay display
+ */
+import { EventEmitter } from 'events';
+export class StatusOrchestrator extends EventEmitter {
+    context;
+    statusListeners = new Set();
+    priorityResolver;
+    constructor() {
+        super();
+        this.context = {
+            base: null,
+            overrides: new Map(),
+            tools: new Map(),
+            animations: new Map(),
+            interrupts: {
+                pending: [],
+                active: null,
+            },
+        };
+        // Default priority resolver
+        this.priorityResolver = (a, b) => {
+            const tonePriority = {
+                danger: 4,
+                warning: 3,
+                success: 2,
+                info: 1,
+            };
+            const aPriority = tonePriority[a.tone || 'info'];
+            const bPriority = tonePriority[b.tone || 'info'];
+            return bPriority - aPriority;
+        };
+    }
+    /**
+     * Set base status
+     */
+    setBaseStatus(status) {
+        this.context.base = status;
+        this.emitEvent({
+            type: 'status.base.changed',
+            timestamp: Date.now(),
+            data: { status },
+        });
+    }
+    /**
+     * Push status override
+     */
+    pushOverride(id, status) {
+        this.context.overrides.set(id, status);
+        this.emitEvent({
+            type: 'status.override.pushed',
+            timestamp: Date.now(),
+            data: { id, status },
+        });
+    }
+    /**
+     * Clear status override
+     */
+    clearOverride(id) {
+        const removed = this.context.overrides.delete(id);
+        if (removed) {
+            this.emitEvent({
+                type: 'status.override.cleared',
+                timestamp: Date.now(),
+                data: { id },
+            });
+        }
+    }
+    /**
+     * Handle tool lifecycle events
+     */
+    onToolStart(toolCall) {
+        const toolStatus = {
+            toolId: toolCall.id,
+            tool: toolCall.name,
+            status: 'starting',
+            description: this.describeToolOperation(toolCall),
+            startedAt: Date.now(),
+            updatedAt: Date.now(),
+            tone: this.getToolTone(toolCall.name),
+        };
+        this.context.tools.set(toolCall.id, toolStatus);
+        this.emitEvent({
+            type: 'tool.start',
+            timestamp: Date.now(),
+            data: { toolCall, toolStatus },
+        });
+        // Update to running status after a brief delay
+        setTimeout(() => {
+            const status = this.context.tools.get(toolCall.id);
+            if (status && status.status === 'starting') {
+                status.status = 'running';
+                status.updatedAt = Date.now();
+                this.emitEvent({
+                    type: 'tool.progress',
+                    timestamp: Date.now(),
+                    data: { toolCall, toolStatus: status },
+                });
+            }
+        }, 100);
+    }
+    /**
+     * Update tool progress
+     */
+    onToolProgress(toolId, progress) {
+        const toolStatus = this.context.tools.get(toolId);
+        if (!toolStatus)
+            return;
+        toolStatus.progress = {
+            current: progress.current,
+            total: progress.total,
+            percentage: Math.round((progress.current / progress.total) * 100),
+        };
+        if (progress.message) {
+            toolStatus.detail = progress.message;
+        }
+        toolStatus.updatedAt = Date.now();
+        this.emitEvent({
+            type: 'tool.progress',
+            timestamp: Date.now(),
+            data: { toolId, toolStatus, progress },
+        });
+    }
+    /**
+     * Handle tool completion
+     */
+    onToolComplete(toolId, result) {
+        const toolStatus = this.context.tools.get(toolId);
+        if (!toolStatus)
+            return;
+        toolStatus.status = 'completed';
+        toolStatus.updatedAt = Date.now();
+        this.emitEvent({
+            type: 'tool.complete',
+            timestamp: Date.now(),
+            data: { toolId, toolStatus, result },
+        });
+        // Remove from active tools after animation
+        setTimeout(() => {
+            this.context.tools.delete(toolId);
+        }, 1000);
+    }
+    /**
+     * Handle tool error
+     */
+    onToolError(toolId, error) {
+        const toolStatus = this.context.tools.get(toolId);
+        if (!toolStatus)
+            return;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        toolStatus.status = 'error';
+        toolStatus.tone = 'danger';
+        toolStatus.detail = errorMessage || 'An error occurred';
+        toolStatus.updatedAt = Date.now();
+        this.emitEvent({
+            type: 'tool.error',
+            timestamp: Date.now(),
+            data: { toolId, toolStatus, error },
+        });
+        // Remove from active tools after delay
+        setTimeout(() => {
+            this.context.tools.delete(toolId);
+        }, 2000);
+    }
+    /**
+     * Queue an interrupt
+     */
+    queueInterrupt(interrupt) {
+        const id = `interrupt-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+        const fullInterrupt = {
+            ...interrupt,
+            id,
+            timestamp: Date.now(),
+        };
+        // Insert based on priority
+        const index = this.context.interrupts.pending.findIndex((i) => i.priority < interrupt.priority);
+        if (index === -1) {
+            this.context.interrupts.pending.push(fullInterrupt);
+        }
+        else {
+            this.context.interrupts.pending.splice(index, 0, fullInterrupt);
+        }
+        this.emitEvent({
+            type: 'interrupt.received',
+            timestamp: Date.now(),
+            data: { interrupt: fullInterrupt },
+        });
+        // Process interrupt queue
+        this.processInterrupts();
+        return id;
+    }
+    /**
+     * Process pending interrupts
+     */
+    processInterrupts() {
+        if (this.context.interrupts.active || this.context.interrupts.pending.length === 0) {
+            return;
+        }
+        const interrupt = this.context.interrupts.pending.shift();
+        if (!interrupt)
+            return;
+        this.context.interrupts.active = interrupt;
+        // Auto-clear interrupt after 3 seconds if not cleared manually
+        setTimeout(() => {
+            if (this.context.interrupts.active?.id === interrupt.id) {
+                this.clearInterrupt(interrupt.id);
+            }
+        }, 3000);
+    }
+    /**
+     * Clear an active interrupt
+     */
+    clearInterrupt(id) {
+        if (this.context.interrupts.active?.id === id) {
+            this.context.interrupts.active = null;
+            this.processInterrupts(); // Process next in queue
+        }
+    }
+    /**
+     * Get the current aggregated status
+     */
+    getCurrentStatus() {
+        // Priority order:
+        // 1. Active interrupt
+        // 2. Active tools
+        // 3. Overrides
+        // 4. Base status
+        if (this.context.interrupts.active) {
+            return {
+                text: this.context.interrupts.active.message,
+                tone: 'warning',
+                startedAt: this.context.interrupts.active.timestamp,
+            };
+        }
+        // Get most important tool status
+        if (this.context.tools.size > 0) {
+            const toolStatuses = Array.from(this.context.tools.values());
+            const activeTools = toolStatuses.filter((t) => t.status === 'running');
+            if (activeTools.length > 0) {
+                const mostRecent = activeTools.sort((a, b) => b.updatedAt - a.updatedAt)[0];
+                if (mostRecent) {
+                    return {
+                        text: mostRecent.description,
+                        detail: mostRecent.detail,
+                        tone: mostRecent.tone,
+                        startedAt: mostRecent.startedAt,
+                    };
+                }
+            }
+        }
+        // Get highest priority override
+        if (this.context.overrides.size > 0) {
+            const overrides = Array.from(this.context.overrides.values());
+            const sorted = overrides.sort(this.priorityResolver);
+            return sorted[0] || null;
+        }
+        return this.context.base;
+    }
+    /**
+     * Register animation
+     */
+    registerAnimation(id, type, data) {
+        this.context.animations.set(id, {
+            id,
+            type,
+            frame: 0,
+            startedAt: Date.now(),
+            data,
+        });
+    }
+    /**
+     * Update animation frame
+     */
+    updateAnimationFrame(id) {
+        const animation = this.context.animations.get(id);
+        if (animation) {
+            animation.frame++;
+            this.emitEvent({
+                type: 'animation.frame',
+                timestamp: Date.now(),
+                data: { animation },
+            });
+        }
+    }
+    /**
+     * Clear animation
+     */
+    clearAnimation(id) {
+        this.context.animations.delete(id);
+    }
+    /**
+     * Subscribe to status events
+     */
+    subscribe(listener) {
+        this.statusListeners.add(listener);
+        return () => this.statusListeners.delete(listener);
+    }
+    /**
+     * Emit status event
+     */
+    emitEvent(event) {
+        this.emit(event.type, event);
+        this.statusListeners.forEach((listener) => listener(event));
+    }
+    /**
+     * Get tool operation description
+     */
+    describeToolOperation(toolCall) {
+        const params = toolCall.arguments;
+        switch (toolCall.name) {
+            case 'read_file':
+                return `Reading ${this.truncatePath(params.path)}`;
+            case 'write_file':
+                return `Writing ${this.truncatePath(params.path)}`;
+            case 'edit_file':
+                return `Editing ${this.truncatePath(params.path)}`;
+            case 'bash':
+                return `Running: ${this.truncateCommand(params.command)}`;
+            case 'search_files':
+                return `Searching for: ${this.truncateQuery(params.query)}`;
+            case 'list_directory':
+                return `Listing ${this.truncatePath(params.path || '.')}`;
+            default:
+                return `Running ${toolCall.name}`;
+        }
+    }
+    /**
+     * Get tone for tool type
+     */
+    getToolTone(tool) {
+        const dangerousTools = ['bash', 'write_file', 'edit_file', 'delete_file'];
+        const warningTools = ['install', 'uninstall', 'update'];
+        if (dangerousTools.includes(tool)) {
+            return 'warning';
+        }
+        if (warningTools.includes(tool)) {
+            return 'warning';
+        }
+        return 'info';
+    }
+    /**
+     * Helper to truncate paths
+     */
+    truncatePath(path, maxLength = 40) {
+        if (!path)
+            return '';
+        if (path.length <= maxLength)
+            return path;
+        const parts = path.split('/');
+        if (parts.length <= 2) {
+            return '...' + path.slice(-(maxLength - 3));
+        }
+        // Keep first and last parts
+        const first = parts[0] || '';
+        const last = parts[parts.length - 1] || '';
+        const middle = '...';
+        const result = `${first}/${middle}/${last}`;
+        if (result.length > maxLength) {
+            return '...' + last.slice(-(maxLength - 3));
+        }
+        return result;
+    }
+    /**
+     * Helper to truncate commands
+     */
+    truncateCommand(command, maxLength = 40) {
+        if (!command)
+            return '';
+        if (command.length <= maxLength)
+            return command;
+        return command.slice(0, maxLength - 3) + '...';
+    }
+    /**
+     * Helper to truncate search queries
+     */
+    truncateQuery(query, maxLength = 30) {
+        if (!query)
+            return '';
+        if (query.length <= maxLength)
+            return query;
+        return query.slice(0, maxLength - 3) + '...';
+    }
+    /**
+     * Get full context for debugging
+     */
+    getContext() {
+        return { ...this.context };
+    }
+    /**
+     * Reset all status
+     */
+    reset() {
+        this.context = {
+            base: null,
+            overrides: new Map(),
+            tools: new Map(),
+            animations: new Map(),
+            interrupts: {
+                pending: [],
+                active: null,
+            },
+        };
+    }
+}
+//# sourceMappingURL=StatusOrchestrator.js.map

package/dist/ui/orchestration/StatusOrchestrator.js.map

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

package/dist/ui/orchestration/UIUpdateCoordinator.d.ts

@@ -0,0 +1,77 @@
+/**
+ * UIUpdateCoordinator
+ *
+ * Centralized queue for all UI updates (status line, overlays, prompts, streaming heartbeats).
+ * - Serializes writes so concurrent streams do not interleave.
+ * - Coalesces repeated updates by key (e.g., heartbeat ticks).
+ * - Expires stale work when UI mode changes (idle/streaming/tools/etc).
+ */
+export type UIMode = 'idle' | 'processing' | 'streaming' | 'tooling' | 'mcp' | 'external';
+export type UIUpdateLane = 'status' | 'prompt' | 'overlay' | 'stream' | 'heartbeat' | 'tool' | 'external';
+export type UIUpdatePriority = 'critical' | 'high' | 'normal' | 'low';
+export interface UIUpdateRequest {
+    lane: UIUpdateLane;
+    run: () => void | Promise<void>;
+    description?: string;
+    priority?: UIUpdatePriority;
+    coalesceKey?: string;
+    mode?: UIMode | UIMode[];
+    scope?: string;
+}
+export interface HeartbeatOptions extends Omit<UIUpdateRequest, 'lane'> {
+    intervalMs: number;
+    lane?: UIUpdateLane;
+    immediate?: boolean;
+}
+export declare class UIUpdateCoordinator {
+    private currentMode;
+    private modeEpoch;
+    private activeScope;
+    private readonly queue;
+    private readonly coalesced;
+    private readonly heartbeats;
+    private flushing;
+    private flushScheduled;
+    constructor(initialMode?: UIMode);
+    /**
+     * Switch UI mode (idle/streaming/tools/etc) and expire stale work tied to the previous scope.
+     */
+    setMode(mode: UIMode): string;
+    /**
+     * Enqueue a UI update. By default it is tied to the current scope/mode so it is dropped
+     * automatically when the UI switches modes.
+     */
+    enqueue(request: UIUpdateRequest): void;
+    /**
+     * Start a repeating UI update (e.g., streaming heartbeat). Automatically stops when
+     * the mode changes away from the allowed modes.
+     */
+    startHeartbeat(id: string, options: HeartbeatOptions): void;
+    /**
+     * Stop a heartbeat and remove any queued updates for its coalesce key.
+     */
+    stopHeartbeat(id: string): void;
+    /**
+     * Check if any heartbeat (or a specific one) is active.
+     */
+    isHeartbeatActive(id?: string): boolean;
+    /**
+     * Dispose all timers and queued updates.
+     */
+    dispose(): void;
+    private buildTask;
+    private normalizePriority;
+    private scheduleFlush;
+    private flushQueue;
+    private isTaskRunnable;
+    private sortQueue;
+    private invalidateScope;
+    private pruneHeartbeats;
+    private isModeAllowed;
+    private removeFromQueue;
+    private removeQueuedByKey;
+    private removeQueuedByScope;
+    private cleanupCoalesced;
+    private makeScope;
+}
+//# sourceMappingURL=UIUpdateCoordinator.d.ts.map

package/dist/ui/orchestration/UIUpdateCoordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UIUpdateCoordinator.d.ts","sourceRoot":"","sources":["../../../src/ui/orchestration/UIUpdateCoordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,YAAY,GAAG,WAAW,GAAG,SAAS,GAAG,KAAK,GAAG,UAAU,CAAC;AAE1F,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,WAAW,GACX,MAAM,GACN,UAAU,CAAC;AAEf,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEtE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,YAAY,CAAC;IACnB,GAAG,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAqBD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmC;IAC7D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgC;IAC3D,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,cAAc,CAAS;gBAEnB,WAAW,GAAE,MAAe;IAKxC;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAiB7B;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAevC;;;OAGG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAsC3D;;OAEG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAa/B;;OAEG;IACH,iBAAiB,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO;IAOvC;;OAEG;IACH,OAAO,IAAI,IAAI;IAUf,OAAO,CAAC,SAAS;IAejB,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,aAAa;YAQP,UAAU;IAiCxB,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,SAAS;CAGlB"}