@compilr-dev/cli 0.4.0 → 0.5.1

package/dist/ui/live-region-facade.js

@@ -0,0 +1,205 @@
+/**
+ * LiveRegion facade.
+ *
+ * Extracted from TerminalUI — owns the LiveRegion instance and active
+ * bash tracking. Methods that need to commit items to the scrolling
+ * zone or emit events go through the host interface.
+ */
+import { formatTokens } from './base/index.js';
+import { LiveRegion } from './live-region.js';
+export class LiveRegionFacade {
+    /** The underlying LiveRegion (exposed for render pipeline). */
+    region = new LiveRegion();
+    /** Active bash command tracking (for Ctrl+B background feature). */
+    activeBashToolUseId = null;
+    host;
+    constructor(host) {
+        this.host = host;
+    }
+    // ===========================================================================
+    // Subagents
+    // ===========================================================================
+    addSubagent(id, agentType, description) {
+        const item = {
+            id,
+            type: 'subagent',
+            status: 'running',
+            startTime: Date.now(),
+            agentType,
+            description,
+            toolCount: 0,
+            tokenCount: 0,
+            lastAction: '',
+            lastActionDetails: [],
+        };
+        this.region.addItem(item);
+        this.host.requestRender();
+    }
+    updateSubagentTool(id, toolName, summary) {
+        const item = this.region.getItem(id);
+        if (item && item.type === 'subagent') {
+            const newAction = `${toolName}: ${summary}`;
+            const updatedDetails = item.lastAction
+                ? [...item.lastActionDetails, item.lastAction]
+                : [...item.lastActionDetails];
+            this.region.updateItem(id, {
+                toolCount: item.toolCount + 1,
+                lastAction: newAction,
+                lastActionDetails: updatedDetails,
+            });
+            this.host.requestRender();
+        }
+    }
+    completeSubagent(id, success, tokenCount, _error) {
+        const item = this.region.getItem(id);
+        if (item && item.type === 'subagent') {
+            this.region.updateItem(id, {
+                status: success ? 'done' : 'error',
+                tokenCount: tokenCount ?? item.tokenCount,
+                endTime: Date.now(),
+            });
+            this.region.completeItem(id, success ? 'done' : 'error');
+            this.host.requestRender();
+        }
+    }
+    removeSubagent(id) {
+        const item = this.region.removeItem(id);
+        this.host.requestRender();
+        return item;
+    }
+    commitSubagent(id, resultContent, success) {
+        const item = this.region.removeItem(id);
+        if (item && item.type === 'subagent') {
+            const toolCount = item.toolCount;
+            const tokenCount = item.tokenCount;
+            const duration = item.endTime
+                ? Math.round((item.endTime - item.startTime) / 1000)
+                : Math.round((Date.now() - item.startTime) / 1000);
+            const tokenStr = tokenCount > 0 ? `, ${formatTokens(tokenCount)} tokens` : '';
+            const summary = `${String(toolCount)} tool calls${tokenStr}, ${String(duration)}s`;
+            this.host.print({
+                type: 'tool-result',
+                name: item.agentType,
+                params: item.description,
+                summary,
+                content: resultContent || undefined,
+                success,
+            });
+            this.host.setSpinnerText(null);
+        }
+        this.host.requestRender();
+        return item;
+    }
+    // ===========================================================================
+    // Bash commands
+    // ===========================================================================
+    addBashCommand(id, command) {
+        const item = {
+            id,
+            type: 'bash',
+            status: 'running',
+            startTime: Date.now(),
+            command,
+            output: [],
+        };
+        this.region.addItem(item);
+        this.activeBashToolUseId = id;
+        this.host.requestRender();
+    }
+    updateBashOutput(id, line) {
+        const item = this.region.getItem(id);
+        if (item && item.type === 'bash') {
+            item.output.push(line);
+            this.region.updateItem(id, { output: [...item.output] });
+            this.host.requestRender();
+        }
+    }
+    completeBashCommand(id, exitCode) {
+        const item = this.region.getItem(id);
+        if (item && item.type === 'bash') {
+            this.region.updateItem(id, {
+                status: exitCode === 0 ? 'done' : 'error',
+                exitCode,
+                endTime: Date.now(),
+            });
+            this.region.completeItem(id, exitCode === 0 ? 'done' : 'error');
+            if (this.activeBashToolUseId === id) {
+                this.activeBashToolUseId = null;
+            }
+            this.host.requestRender();
+        }
+    }
+    commitBashCommand(id) {
+        if (this.activeBashToolUseId === id) {
+            this.activeBashToolUseId = null;
+        }
+        const item = this.region.removeItem(id);
+        if (item && item.type === 'bash') {
+            const output = item.output.join('\n') || '(no output)';
+            const exitCode = item.exitCode ?? 0;
+            this.host.print({
+                type: 'tool-result',
+                name: 'Bash',
+                params: item.command,
+                summary: exitCode === 0 ? 'Completed' : `Exit code ${String(exitCode)}`,
+                content: output,
+                success: exitCode === 0,
+            });
+        }
+        this.host.requestRender();
+    }
+    backgroundBashCommand() {
+        if (!this.activeBashToolUseId)
+            return;
+        const item = this.region.getItem(this.activeBashToolUseId);
+        if (!item || item.type !== 'bash')
+            return;
+        const bashItem = item;
+        const id = this.activeBashToolUseId;
+        this.region.updateItem(id, { background: true });
+        this.region.removeItem(id);
+        this.activeBashToolUseId = null;
+        this.host.print({
+            type: 'info',
+            message: `Task moved to background (id: ${id.slice(0, 8)}). Use /tasks or Ctrl+B to view.`,
+        });
+        this.host.emit('backgroundBash', {
+            toolUseId: id,
+            command: bashItem.command,
+            partialOutput: bashItem.output.join('\n'),
+            startTime: bashItem.startTime,
+        });
+        this.host.requestRender();
+    }
+    // ===========================================================================
+    // Queries
+    // ===========================================================================
+    hasActiveBash() {
+        return this.activeBashToolUseId !== null;
+    }
+    getActiveBashInfo() {
+        if (!this.activeBashToolUseId)
+            return null;
+        const item = this.region.getItem(this.activeBashToolUseId);
+        if (!item || item.type !== 'bash')
+            return null;
+        return {
+            toolUseId: this.activeBashToolUseId,
+            startTime: item.startTime,
+        };
+    }
+    clearLiveRegion() {
+        this.region.clear();
+        this.host.requestRender();
+    }
+    toggleLiveRegionExpanded() {
+        this.region.toggleExpanded();
+        this.host.requestRender();
+    }
+    hasLiveItems() {
+        return this.region.hasItems();
+    }
+    getLiveRegion() {
+        return this.region;
+    }
+}

package/dist/ui/live-region.d.ts

@@ -0,0 +1,157 @@
+/**
+ * LiveRegion - Unified Live-Updating Zone for Running Tools
+ *
+ * Manages the display of running tools (bash, subagents) that need live updates.
+ * Sits at the top of the footer, commits to scrolling zone on completion.
+ *
+ * Key features:
+ * - Single subagent: Full detail with tool history
+ * - Multiple subagents: Tree structure with summary header
+ * - Bash commands: Rolling output lines
+ * - Ephemeral notifications on completion
+ */
+/**
+ * Types of live items that can be displayed
+ */
+export type LiveItemType = 'bash' | 'subagent' | 'tool';
+/**
+ * Status of a live item
+ */
+export type LiveItemStatus = 'running' | 'done' | 'error' | 'cancelled';
+/**
+ * Base interface for all live items
+ */
+export interface LiveItemBase {
+    id: string;
+    type: LiveItemType;
+    status: LiveItemStatus;
+    startTime: number;
+    endTime?: number;
+    background?: boolean;
+}
+/**
+ * Bash command live item
+ */
+export interface BashLiveItem extends LiveItemBase {
+    type: 'bash';
+    command: string;
+    output: string[];
+    exitCode?: number;
+}
+/**
+ * Subagent live item
+ */
+export interface SubagentLiveItem extends LiveItemBase {
+    type: 'subagent';
+    agentType: string;
+    description: string;
+    toolCount: number;
+    tokenCount: number;
+    lastAction: string;
+    lastActionDetails: string[];
+}
+/**
+ * Generic tool live item
+ */
+export interface ToolLiveItem extends LiveItemBase {
+    type: 'tool';
+    name: string;
+    params: string;
+    progress?: string;
+}
+/**
+ * Union type for all live items
+ */
+export type LiveItem = BashLiveItem | SubagentLiveItem | ToolLiveItem;
+/**
+ * Render options for LiveRegion
+ */
+export interface LiveRegionRenderOptions {
+    width: number;
+    verbose: boolean;
+    showTokens: boolean;
+}
+export declare class LiveRegion {
+    private readonly items;
+    private ephemeralNotifications;
+    private maxOutputLines;
+    private verbose;
+    private expanded;
+    /**
+     * Add a new live item to the region.
+     */
+    addItem(item: LiveItem): void;
+    /**
+     * Update an existing live item.
+     */
+    updateItem(id: string, update: Partial<LiveItem>): void;
+    /**
+     * Mark an item as completed. Returns the final item for committing to scrolling zone.
+     */
+    completeItem(id: string, status?: LiveItemStatus): LiveItem | undefined;
+    /**
+     * Remove an item and return it (for committing to scrolling zone).
+     */
+    removeItem(id: string): LiveItem | undefined;
+    /**
+     * Get an item by ID.
+     */
+    getItem(id: string): LiveItem | undefined;
+    /**
+     * Get all current items.
+     */
+    getItems(): LiveItem[];
+    /**
+     * Check if there are any items.
+     */
+    hasItems(): boolean;
+    /**
+     * Get count of items.
+     */
+    getItemCount(): number;
+    /**
+     * Clear all items.
+     */
+    clear(): void;
+    /**
+     * Add an ephemeral notification that disappears after timeout.
+     */
+    addEphemeralNotification(message: string): void;
+    /**
+     * Clean up expired ephemeral notifications.
+     */
+    private cleanupEphemeralNotifications;
+    /**
+     * Set maximum output lines per item.
+     */
+    setMaxOutputLines(maxLines: number): void;
+    /**
+     * Set verbose mode.
+     */
+    setVerbose(verbose: boolean): void;
+    /**
+     * Toggle expanded view (Ctrl+O).
+     */
+    toggleExpanded(): void;
+    /**
+     * Get expanded state.
+     */
+    isExpanded(): boolean;
+    /**
+     * Render the live region content.
+     */
+    render(options: LiveRegionRenderOptions): string[];
+    private renderSingleSubagent;
+    private renderMultipleSubagents;
+    private renderBashItem;
+    private renderToolItem;
+    private renderEphemeralNotification;
+    /**
+     * Truncate a line to fit within width.
+     */
+    private truncateLine;
+    /**
+     * Format duration for display.
+     */
+    formatDuration(ms: number): string;
+}