indusagi-coding-agent 0.1.23 → 0.1.25

package/dist/modes/interactive/components/assistant-message.js

@@ -1,7 +1,170 @@
 import { Container, Markdown, Spacer, Text } from "indusagi/tui";
 import { getMarkdownTheme, theme } from "../theme/theme.js";
 /**
- * Component that renders a complete assistant message
+ * ============================================================================
+ * ASSISTANT MESSAGE COMPONENT - RENDERING MODULE
+ * ============================================================================
+ *
+ * PURPOSE:
+ * ============================================================================
+ * Renders complete assistant messages with support for streaming text content,
+ * thinking blocks, and error states. This component is the core renderer for
+ * all AI assistant responses in the interactive chat interface.
+ *
+ * MESSAGE TYPES:
+ * - Text: Regular assistant responses with markdown formatting
+ * - Thinking: Internal reasoning traces (collapsible, italicized)
+ * - Errors: Graceful rendering of aborted/failed operations
+ * - Mixed: Multiple content types in sequence (text + thinking)
+ *
+ * DATA FLOW:
+ * ============================================================================
+ * Session Event Flow:
+ *   AgentSession.prompt() emits message_streamed events
+ *     ↓
+ *   InteractiveMode.subscribeToAgent() receives event
+ *     ↓
+ *   AssistantMessage extracted from event.message
+ *     ↓
+ *   AssistantMessageComponent created or updateContent() called
+ *     ↓
+ *   contentContainer cleared and rebuilt
+ *     ↓
+ *   Markdown/Text components added for each content block
+ *     ↓
+ *   TUI invalidate() and requestRender()
+ *     ↓
+ *   Terminal renders styled markdown
+ *
+ * Component State Lifecycle:
+ *   1. Constructor: Initialize empty container, apply theme
+ *   2. updateContent(): Parse message.content array
+ *   3. For each content item:
+ *      - Check if visible (non-empty text/thinking)
+ *      - Apply appropriate styling and formatting
+ *      - Add to contentContainer with spacing
+ *   4. Check for error/abort states
+ *   5. invalidate() on theme change: re-render preserving message
+ *
+ * RENDERING PIPELINE:
+ * ============================================================================
+ * Layout Structure (ASCII):
+ *   ┌─────────────────────────────────────┐
+ *   │         [Spacer 1 line]             │  ← Top spacing
+ *   ├─────────────────────────────────────┤
+ *   │ Markdown: Regular assistant text    │  ← Text content (if present)
+ *   │ with code blocks, lists, etc.       │
+ *   ├─────────────────────────────────────┤
+ *   │ [Thinking...] (or full thinking)    │  ← Thinking block (if present)
+ *   │ Italic, dimmed color                │
+ *   ├─────────────────────────────────────┤
+ *   │ Error: Operation aborted           │  ← Error message (if error)
+ *   └─────────────────────────────────────┘
+ *
+ * Rendering Rules:
+ * 1. Only show spacer if content is visible (non-empty text/thinking)
+ * 2. Text content: full markdown rendering with syntax highlight
+ * 3. Thinking blocks:
+ *    - If hideThinkingBlock=true: show compact "Thinking..." label
+ *    - If hideThinkingBlock=false: show full thinking text in italic
+ * 4. Spacing: Spacer(1) between thinking and following text
+ * 5. Errors: Only shown if no tool calls in message (tools show their own errors)
+ *
+ * STYLING/FORMATTING:
+ * ============================================================================
+ * Color Scheme (from theme):
+ *   - Text: markdownTheme colors (inherit from theme)
+ *   - Thinking: theme.fg("thinkingText", text) + italic
+ *   - Error: theme.fg("error", message)
+ *   - Aborted: theme.fg("error", message) [same as error]
+ *
+ * Text Processing:
+ *   - Markdown: Full markdown rendering (lists, code, emphasis, etc.)
+ *   - Text trim(): Remove leading/trailing whitespace
+ *   - Thinking italic: Applied via theme formatter
+ *
+ * Component Nesting:
+ *   - AssistantMessageComponent (Container)
+ *     └── contentContainer (Container)
+ *         ├── Spacer(1) [conditional]
+ *         ├── Markdown(text content) [0+ times]
+ *         ├── Markdown(thinking) [italic] [0+ times]
+ *         ├── Spacer(1) [between thinking and text]
+ *         └── Text(error message) [conditional]
+ *
+ * EXAMPLES:
+ * ============================================================================
+ *
+ * Example 1: Regular Text Response
+ * ─────────────────────────────────
+ * Message content: [{ type: "text", text: "# Hello\n\nThis is a response" }]
+ * Rendered output:
+ *   <blank line>
+ *   # Hello
+ *
+ *   This is a response
+ *
+ * Example 2: Response with Thinking
+ * ──────────────────────────────────
+ * Message content: [
+ *   { type: "thinking", thinking: "Let me reason about this..." },
+ *   { type: "text", text: "The answer is..." }
+ * ]
+ * Rendered output:
+ *   <blank line>
+ *   [italic, dim] Thinking...
+ *   <blank line>
+ *   The answer is...
+ *
+ * Example 3: Thinking with Full Trace (hideThinkingBlock=false)
+ * ───────────────────────────────────────────────────────────
+ * Message content: [
+ *   { type: "thinking", thinking: "1. Check args\n2. Validate\n3. Execute" }
+ * ]
+ * Rendered output:
+ *   <blank line>
+ *   [italic, muted color]
+ *   1. Check args
+ *   2. Validate
+ *   3. Execute
+ *
+ * Example 4: Error State
+ * ──────────────────────
+ * Message: { stopReason: "error", errorMessage: "Rate limit exceeded" }
+ * Rendered output:
+ *   Error: Rate limit exceeded
+ *
+ * INTEGRATION:
+ * ============================================================================
+ * TUI Integration:
+ *   - Extends Container (indusagi/tui base component)
+ *   - Uses Markdown, Text, Spacer from indusagi/tui
+ *   - Theme system: getMarkdownTheme(), theme.fg(), theme.italic()
+ *
+ * Session Integration:
+ *   - Created in InteractiveMode.handleEvent() for message_streamed
+ *   - Updated via updateContent() as streaming progresses
+ *   - Stored in chatContainer for display
+ *
+ * Theme Integration:
+ *   - Listens to theme changes via invalidate()
+ *   - Re-renders with new theme when theme.json changes
+ *   - Preserves message content across re-renders
+ *
+ * Settings Integration:
+ *   - hideThinkingBlock: Toggle thinking visibility
+ *   - Can be changed after component creation via setHideThinkingBlock()
+ *   - Changes take effect on next invalidate()
+ *
+ * Streaming Integration:
+ *   - updateContent() called repeatedly as text arrives
+ *   - Maintains lastMessage reference for invalidate() re-render
+ *   - Efficient: only modifies contentContainer, not entire component tree
+ *
+ * Performance Notes:
+ *   - Markdown rendering is cached by indusagi/tui library
+ *   - invalidate() only re-renders contentContainer
+ *   - Suitable for incremental streaming (100+ updates acceptable)
  */
 export class AssistantMessageComponent extends Container {
     constructor(message, hideThinkingBlock = false, markdownTheme = getMarkdownTheme()) {

package/dist/modes/interactive/components/assistant-message.js.map

@@ -1 +1 @@
-{"version":3,"file":"assistant-message.js","sourceRoot":"","sources":["../../../../src/modes/interactive/components/assistant-message.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"assistant-message.js","sourceRoot":"","sources":["../../../../src/modes/interactive/components/assistant-message.ts"],"names":[],"mappings":"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"}

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

@@ -1,5 +1,301 @@
 /**
- * Component for displaying bash command execution with streaming output.
+ * ============================================================================
+ * 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 "../../../core/tools/truncate.js";

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;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAwB,KAAK,GAAG,EAAE,MAAM,cAAc,CAAC;AAEzE,OAAO,EAGN,KAAK,gBAAgB,EAErB,MAAM,iCAAiC,CAAC;AASzC,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0SG;AAEH,OAAO,EAAE,SAAS,EAAwB,KAAK,GAAG,EAAE,MAAM,cAAc,CAAC;AAEzE,OAAO,EAGN,KAAK,gBAAgB,EAErB,MAAM,iCAAiC,CAAC;AASzC,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"}