indusagi-coding-agent 0.1.38 → 0.1.39

package/dist/modes/interactive/components/bash-execution.d.ts

@@ -1,331 +1,24 @@
-/**
- * ============================================================================
- * BASH EXECUTION COMPONENT - REAL-TIME BASH OUTPUT RENDERER
- * ============================================================================
- *
- * PURPOSE:
- * ============================================================================
- * Renders live bash command execution in the interactive chat interface.
- * This component displays:
- *
- * - Command invocation with dynamic border styling
- * - Real-time streaming output (appended as chunks arrive)
- * - Loading animation while command runs
- * - Exit code and cancellation status
- * - Expandable output (collapsed preview vs full output)
- * - Truncation warnings (context limits, path to full output)
- * - Visual line truncation with width-aware caching
- *
- * DESIGN:
- * BashExecutionComponent is distinct from ToolExecutionComponent because:
- * 1. Streaming: Output arrives chunk-by-chunk (append, not replace)
- * 2. State: Maintains outputLines array during execution
- * 3. Loading: Shows spinner while running
- * 4. Borders: Dynamic borders with color based on context exclusion
- * 5. Visual wrapping: Line-based truncation respects terminal width
- *
- * DIFFERENCES FROM TOOL EXECUTION:
- * - Tool execution: Shows full tool state (args + result at once)
- * - Bash execution: Shows streaming output with real-time updates
- * - Tool has result.content structure, bash has outputLines array
- * - Bash shows loader during execution, tool shows pending background
- *
- * DATA FLOW:
- * ============================================================================
- * Bash Execution Pipeline:
- *   User types: !! command text
- *     ↓
- *   InteractiveMode.handleBashCommand() captures input
- *     ↓
- *   session.bash() starts async bash execution
- *     ↓
- *   BashExecutionComponent created
- *     ↓
- *   While running, agent streams stdout via session.on('bash_output')
- *     ↓
- *   component.appendOutput(chunk) called repeatedly
- *     ↓
- *   updateDisplay() called, adds new lines to content
- *     ↓
- *   TUI invalidate() and requestRender()
- *     ↓
- *   Terminal shows streaming output with loading spinner
- *   ↓
- *   Agent emits bash_complete event
- *     ↓
- *   component.setComplete(exitCode, cancelled, truncation, fullPath)
- *     ↓
- *   Loader stops, exit code/status displayed
- *     ↓
- *   TUI displays final output
- *
- * Component State Lifecycle:
- *   1. Constructor:
- *      - Initialize with command string
- *      - Create bordered container structure
- *      - Add command header with styling
- *      - Show loader with "Running..." text
- *   2. appendOutput() calls (while running):
- *      - Strip ANSI codes and normalize line endings
- *      - Split on newlines and append to outputLines
- *      - Call updateDisplay() to refresh
- *      - TUI invalidate() → render shows new content
- *   3. setComplete() call (when done):
- *      - Store exit code and status (error/cancelled/complete)
- *      - Stop loader animation
- *      - Call updateDisplay() final time
- *      - Display exit code or cancellation message
- *   4. invalidate() call (on theme change):
- *      - Re-render with new colors
- *      - Keep outputLines unchanged
- *      - Re-apply truncation and styling
- *
- * RENDERING PIPELINE:
- * ============================================================================
- * Layout Structure (ASCII):
- *   ┌─────────────────────────────────────────────┐
- *   │       [Spacer 1 line]                       │  ← Top margin
- *   ├─────────────────────────────────────────────┤
- *   │ ┌ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┐ │  ← DynamicBorder
- *   │ $ command text                              │  ← Command header
- *   │                                             │  ← (or content)
- *   │ [spinner] Running... (C-c to cancel)       │  ← Loader (if running)
- *   │                                             │
- *   │ output line 1                              │  ← Output lines
- *   │ output line 2                              │
- *   │ output line 3                              │
- *   │ ... (5 more lines, to expand)              │  ← Truncation hint (collapsed)
- *   │                                             │
- *   │ (exit 0) or (cancelled) or (exit 1)       │  ← Status (if complete)
- *   │ └ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┘ │  ← DynamicBorder
- *   └─────────────────────────────────────────────┘
- *
- * Rendering Rules:
- * 1. Top spacer: Always present
- * 2. Top border: DynamicBorder with colorKey (bashMode or dim)
- * 3. ContentContainer:
- *    - Command header: "$ command" (bold, colored)
- *    - Output lines (if available):
- *      a. If expanded: Show all outputLines
- *      b. If collapsed: Show last PREVIEW_LINES with visual truncation
- *    - Loader: Only if status="running"
- *    - Status: Only if status!="running" (complete/error/cancelled)
- * 4. Bottom border: Same style as top border
- *
- * Output Line Handling:
- *   - Raw output: Received with ANSI codes
- *   - Strip ANSI: stripAnsi() removes color codes (preserve structure)
- *   - Normalize newlines: \r\n → \n, \r → \n
- *   - Split/append: newLines split on \n, append to outputLines
- *   - Styling: Apply theme.fg("muted", line) to each line
- *   - Wrapping: Visual line truncation handles width changes
- *
- * Preview Truncation (collapsed state):
- *   - PREVIEW_LINES = 20 (max logical lines to show when collapsed)
- *   - hiddenLineCount = availableLines.length - previewLogicalLines.length
- *   - Visual truncation: truncateToVisualLines() respects terminal width
- *   - Shown: "... N more lines" hint with expand key hint
- *
- * Context Truncation (for LLM):
- *   - DEFAULT_MAX_LINES = 500
- *   - DEFAULT_MAX_BYTES = 50KB
- *   - Applied BEFORE preview truncation
- *   - Only tail of output kept (prevents explosion of context)
- *   - Warning message shows truncation occurred
- *
- * STYLING/FORMATTING:
- * ============================================================================
- * Color Scheme:
- *   - Command: theme.fg("bashMode", "$ command") [colored, bold]
- *   - Border: colorKey function (bashMode or dim)
- *   - Output: theme.fg("muted", line) [neutral/gray]
- *   - Error status: theme.fg("error", "(exit 1)") [red]
- *   - Cancelled: theme.fg("warning", "(cancelled)") [yellow]
- *   - Truncation: theme.fg("warning", "[Truncated...]") [yellow]
- *   - Hints: keyHint("expandTools", "...") [key binding text]
- *
- * Loader Styling:
- *   - Spinner: Animated loader component
- *   - Spinner color: theme.fg(colorKey, spinner)
- *   - Text: theme.fg("muted", "Running...")
- *   - Key hint: editorKey("selectCancel") + " to cancel"
- *
- * Border Styling:
- *   - DynamicBorder: Fills terminal width with box characters
- *   - Color: colorKey function (respects excludeFromContext flag)
- *   - excludeFromContext: Command prefixed with !! (dim border)
- *   - Normal: bashMode color (highlighted border)
- *
- * Component Nesting:
- *   - BashExecutionComponent (Container)
- *     ├── Spacer(1) ← Top margin
- *     ├── DynamicBorder ← Top border
- *     ├── contentContainer (Container)
- *     │   ├── Text: "$ command" header
- *     │   ├── Text or dynamic component: Output lines
- *     │   ├── Loader ← If running
- *     │   └── Text: Status message ← If complete
- *     └── DynamicBorder ← Bottom border
- *
- * EXAMPLES:
- * ============================================================================
- *
- * Example 1: Simple Command (Running)
- * ────────────────────────────────────
- * Command: "ls -la"
- * Rendered:
- *   <blank>
- *   ┌─────────────────────────────────────────┐
- *   $ ls -la
- *   [spinner] Running... (C-c to cancel)
- *   └─────────────────────────────────────────┘
- *
- * Example 2: Simple Command (Complete)
- * ──────────────────────────────────────
- * Command: "echo hello" completed successfully
- * Rendered:
- *   <blank>
- *   ┌─────────────────────────────────────────┐
- *   $ echo hello
- *
- *   hello
- *   └─────────────────────────────────────────┘
- *
- * Example 3: Large Output (Collapsed)
- * ────────────────────────────────────
- * Command: "find ." with 1000 results, collapsed
- * Rendered:
- *   <blank>
- *   ┌─────────────────────────────────────────┐
- *   $ find .
- *
- *   ... 980 more lines (to expand)
- *   ./src/index.ts
- *   ./src/main.ts
- *   ./dist/index.js
- *   (exit 0)
- *   └─────────────────────────────────────────┘
- *
- * Example 4: Error Exit Code
- * ──────────────────────────
- * Command: "rm /nonexistent" failed
- * Rendered:
- *   <blank>
- *   ┌─────────────────────────────────────────┐
- *   $ rm /nonexistent
- *
- *   Cannot remove: No such file or directory
- *   (exit 1)
- *   └─────────────────────────────────────────┘
- *
- * Example 5: Cancelled Command
- * ──────────────────────────────
- * User pressed Ctrl-C during execution
- * Rendered:
- *   <blank>
- *   ┌─────────────────────────────────────────┐
- *   $ long_running_command
- *
- *   Processing...
- *   ... 10 more lines (to expand)
- *   (cancelled)
- *   └─────────────────────────────────────────┘
- *
- * INTEGRATION:
- * ============================================================================
- * TUI Integration:
- *   - Extends Container (indusagi/tui base component)
- *   - Uses Text, Spacer, Loader, DynamicBorder components
- *   - Theme system: theme.fg(), theme.bold()
- *   - Loader component: Animated spinner from indusagi/tui
- *   - Terminal access: this.ui.terminal.columns for width
- *
- * Session Integration:
- *   - Created by InteractiveMode when !! command entered
- *   - Updates come from AgentSession.on('bash_output')
- *   - Completion from AgentSession.on('bash_complete')
- *   - Stored in chatContainer like other messages
- *   - Output exported via getOutput() for BashExecutionMessage
- *
- * Theme Integration:
- *   - bashMode color: Border and command header color
- *   - dim color: Used if excludeFromContext=true
- *   - muted color: Output lines rendered in muted color
- *   - invalidate(): Re-renders with new theme
- *   - Colors apply dynamically at render time
- *
- * Real-time Updates:
- *   - appendOutput(): Non-blocking append to array
- *   - updateDisplay(): Rebuilds contentContainer
- *   - TUI calls render() after requestRender()
- *   - Suitable for high-frequency updates (many lines/sec)
- *
- * Performance Notes:
- *   - outputLines stored as string array (efficient append)
- *   - Visual truncation cached (recomputed on width change)
- *   - Loader is simple spinner (minimal overhead)
- *   - PREVIEW_LINES limits rendered lines when collapsed
- *   - DEFAULT_MAX_LINES prevents context explosion (500 lines cap)
- *
- * API:
- * ============================================================================
- * Constructor(command, ui, excludeFromContext):
- *   - command: String to display in header (can be long)
- *   - ui: TUI instance for requestRender() and terminal access
- *   - excludeFromContext: Boolean, true if !! prefixed (dim border)
- *
- * setExpanded(expanded):
- *   - expanded: Boolean, toggle between full/preview output
- *   - Updates display immediately
- *
- * appendOutput(chunk):
- *   - chunk: String of output to append (can be partial line)
- *   - Strips ANSI, normalizes newlines, appends to outputLines
- *   - Calls updateDisplay() and requestRender()
- *
- * setComplete(exitCode, cancelled, truncationResult, fullOutputPath):
- *   - exitCode: Number or undefined (exit code from bash)
- *   - cancelled: Boolean, true if user cancelled
- *   - truncationResult: Optional truncation info for context limits
- *   - fullOutputPath: Path to file with full output (if truncated)
- *   - Stops loader, sets status, calls updateDisplay()
- *
- * getOutput():
- *   - Returns: String of all output lines joined with newlines
- *   - Used for creating BashExecutionMessage
- *
- * getCommand():
- *   - Returns: String of the command that was executed
- */
 import { Container, type TUI } from "indusagi/tui";
 import { type TruncationResult } from "indusagi/agent";
 export declare class BashExecutionComponent extends Container {
-    private command;
+    private readonly command;
+    private readonly ui;
+    private readonly contentContainer;
+    private readonly loader;
+    private readonly excludeFromContext;
     private outputLines;
     private status;
     private exitCode;
-    private loader;
     private truncationResult?;
     private fullOutputPath?;
     private expanded;
-    private contentContainer;
-    private ui;
     constructor(command: string, ui: TUI, excludeFromContext?: boolean);
-    /**
-     * Set whether the output is expanded (shows full output) or collapsed (preview only).
-     */
     setExpanded(expanded: boolean): void;
     invalidate(): void;
     appendOutput(chunk: string): void;
     setComplete(exitCode: number | undefined, cancelled: boolean, truncationResult?: TruncationResult, fullOutputPath?: string): void;
-    private updateDisplay;
-    /**
-     * Get the raw output for creating BashExecutionMessage.
-     */
     getOutput(): string;
-    /**
-     * Get the command that was executed.
-     */
     getCommand(): string;
+    private updateDisplay;
 }
 //# sourceMappingURL=bash-execution.d.ts.map

package/dist/modes/interactive/components/bash-execution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bash-execution.d.ts","sourceRoot":"","sources":["../../../../src/modes/interactive/components/bash-execution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0SG;AAEH,OAAO,EAAE,SAAS,EAAwB,KAAK,GAAG,EAAE,MAAM,cAAc,CAAC;AAEzE,OAAO,EAGN,KAAK,gBAAgB,EAErB,MAAM,gBAAgB,CAAC;AASxB,qBAAa,sBAAuB,SAAQ,SAAS;IACpD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,MAAM,CAA6D;IAC3E,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,gBAAgB,CAAC,CAAmB;IAC5C,OAAO,CAAC,cAAc,CAAC,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,gBAAgB,CAAY;IACpC,OAAO,CAAC,EAAE,CAAM;gBAEJ,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,kBAAkB,UAAQ;IAoChE;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAK3B,UAAU,IAAI,IAAI;IAK3B,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAkBjC,WAAW,CACV,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,SAAS,EAAE,OAAO,EAClB,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,cAAc,CAAC,EAAE,MAAM,GACrB,IAAI;IAgBP,OAAO,CAAC,aAAa;IA4ErB;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,UAAU,IAAI,MAAM;CAGpB"}
+{"version":3,"file":"bash-execution.d.ts","sourceRoot":"","sources":["../../../../src/modes/interactive/components/bash-execution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAwB,KAAK,GAAG,EAAE,MAAM,cAAc,CAAC;AAEzE,OAAO,EAAwC,KAAK,gBAAgB,EAAgB,MAAM,gBAAgB,CAAC;AAyF3G,qBAAa,sBAAuB,SAAQ,SAAS;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAM;IACzB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAY;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAU;IAC7C,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,gBAAgB,CAAC,CAAmB;IAC5C,OAAO,CAAC,cAAc,CAAC,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,kBAAkB,UAAQ;IAoBhE,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAK3B,UAAU,IAAI,IAAI;IAK3B,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKjC,WAAW,CACV,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,SAAS,EAAE,OAAO,EAClB,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,cAAc,CAAC,EAAE,MAAM,GACrB,IAAI;IASP,SAAS,IAAI,MAAM;IAInB,UAAU,IAAI,MAAM;IAIpB,OAAO,CAAC,aAAa;CAkCrB"}