67 Commits

• chore(ts): use source import extensions
  Armin Ronacher · 2026-05-20 00:04:03 +02:00
  ae9450dc51
• fix(tui): bound kitty image id parsing
  Mario Zechner · 2026-05-07 12:21:29 +02:00
  801db80b65
• fix(tui): keep kitty image redraws inside TUI

  Fixes #4208.

  Armin Ronacher · 2026-05-07 10:34:37 +02:00
  b8712457d2
• fix(tui): normalize Thai AM terminal output

  closes #3904

  Mario Zechner · 2026-04-29 23:01:04 +02:00
  338ce3a365
• fix(tui): replace spread-into-push in Container.render() to prevent stack overflow, closes #2651
  Mario Zechner · 2026-04-09 03:33:09 +02:00
  3b7448d156
• fix(tui): throttle render scheduling under streaming load
  Mario Zechner · 2026-04-06 02:03:50 +02:00
  6f5f37f85a
• fix(tui): avoid overlay scrollback inflation on widen
  Mario Zechner · 2026-04-02 01:31:09 +02:00
  af12464217
• fix(tui): stop swallowing escape during cell size detection closes #2661
  Mario Zechner · 2026-03-29 13:22:23 +02:00
  49c0d860a4
• fix(tui): reset viewport state after shrink
  Mario Zechner · 2026-03-26 10:40:10 +01:00
  cb4e4d8c9a
• fix(tui): skip Termux height redraws closes #2467
  Mario Zechner · 2026-03-20 19:35:50 +01:00
  16937947be
• fix(tui): clear stale scrollback on session switch (#2155)

  fullRender wrote \x1b[3J\x1b[2J\x1b[H (clear scrollback, then clear
  screen). But \x1b[2J pushes on-screen content into scrollback, undoing
  the preceding \x1b[3J. Reorder to \x1b[2J\x1b[H\x1b[3J so the screen is
  cleared first and scrollback is wiped last.

  Sviatoslav Abakumov · 2026-03-14 16:00:34 +01:00
  fa26f15e68
• feat(tui): add non-capturing overlays with focus control (#1916)
  Nico Bailon · 2026-03-07 14:19:16 +01:00
  841c95ac9c
• fix(tui): full redraw on terminal width/height resize\n\ncloses #1844
  Mario Zechner · 2026-03-05 20:27:37 +01:00
  dabcda0db3
• feat: add terminal input hook for extensions
  Sam Fold · 2026-02-12 20:45:33 +01:00
  30fd99bd82
• feat(tui): add PI_DEBUG_REDRAW=1 env var for debugging full redraws

  Logs redraw triggers to ~/.pi/agent/pi-debug.log when enabled.

  Mario Zechner · 2026-02-02 08:39:57 +01:00
  0d934091f4
• fix(tui): reduce unnecessary full redraws for better performance

  - Remove height change detection (only width changes trigger full redraw)
  - Change clearOnShrink default to false (use PI_CLEAR_ON_SHRINK=1 to enable)
  - Fix viewport check to use previousLines.length instead of maxLinesRendered
    (prevents false positive redraws when appending lines after content shrunk)
  - Add clearOnShrink setting to /settings in coding-agent
  - Remove line truncation in custom message component (always show full content)

  Mario Zechner · 2026-02-02 08:10:08 +01:00
  0925fafe3b
• fix(tui): auto-clear empty rows when content shrinks (#1095)

  - Add height change detection (analogous to existing width detection)
  - Auto-detect when content shrinks below maxLinesRendered and trigger
    full re-render to clear leftover empty rows
  - Only triggers when no overlays are active (overlays need padding)
  
  Fixes empty rows appearing below footer when:
  - Closing /tree or other selectors
  - Clearing multi-line editor content
  - Any component shrinking
  
  Also adds regression tests for resize handling and content shrinkage.

  Marc Krenn · 2026-01-30 20:45:34 +01:00
  39c898d7c9
• Fixes #1099
  Mario Zechner · 2026-01-30 18:19:16 +01:00
  836e852af1
• perf(tui): optimize image line detection and box cache (#1084)

  - Add isImageLine() to terminal-image.ts with single startsWith check based on detected terminal protocol
  - Replace dual includes() checks in tui.ts with imported isImageLine()
  - Add image line handling to markdown.ts to skip wrapping and margins for image escapes
  - Consolidate Box cache into RenderCache type with childLines/width/bgSample/lines fields
  - Use in-place mutation in applyLineResets() to avoid array allocation

  Can Bölük · 2026-01-30 02:25:19 +01:00
  4058346a64
• perf(tui): scan only bottom terminal height lines in extractCursorPosition
  mom · 2026-01-28 01:40:57 +00:00
  fb693fbc90
• perf(tui): early-out extractCursorPosition when cursor is above visible viewport
  mom · 2026-01-28 01:37:43 +00:00
  9d47747ff6
• perf(tui): optimized extractCursorPosition to scan lines in reverse order (#1004)

  - Optimized extractCursorPosition to scan lines in reverse order for improved performance.

  Can Bölük · 2026-01-28 02:34:50 +01:00
  a8f33fd630
• fix(tui): fix scrollback overwrite when appending lines past viewport

  Appended lines were not committed to terminal scrollback because the
  renderer used cursor movement (CSI B) and carriage return without
  linefeed. This caused earlier content to be overwritten when the
  viewport filled up.
  
  Changes:
  - For appended lines, emit \r\n to create real scrollback lines
  - When target row is below viewport, scroll with \r\n before positioning
  - Add PI_TUI_WRITE_LOG env var for debugging raw ANSI output
  - Add fullRedraws readonly property to TUI class
  - Add viewport-overwrite-repro.ts test script
  
  fixes #954

  Mario Zechner · 2026-01-26 16:51:28 +01:00
  a6f9c3cf0d
• fix(tui): keep overlays centered across resizes (#950)
  Nico Bailon · 2026-01-26 09:43:16 +01:00
  c565fa9af8
• fix(tui): fix viewport tracking and cursor positioning for overlays and content shrink

  - Add maxLinesRendered to track terminal's working area (grows with content, only resets on full clear)
  - Fix viewport calculation: use maxLinesRendered instead of cursorRow for correct viewport bounds
  - Separate cursorRow (end of content for viewport calc) from hardwareCursorRow (actual cursor position)
  - Refactor full render into fullRender(clear) helper to reduce duplication
  - Fix shrink-clearing: properly clear extra lines when content shrinks
  - Add PI_TUI_DEBUG=1 env var for render debugging (writes to /tmp/tui/)
  
  The core issue was that after partial renders (e.g., overlay show/hide), the viewport
  calculation used cursorRow which reflected where rendering stopped, not where content
  ended. This caused incorrect viewport bounds, leading to cursor movement into scrollback
  (unreachable) or rendering at wrong positions.
  
  Additionally, when content shrank (e.g., selector dismissed), the terminal still had
  the old lines as blank space. maxLinesRendered tracks this so viewport calculations
  account for the terminal's actual working area.

  Mario Zechner · 2026-01-20 23:30:53 +01:00
  565488fde6
• fix(tui): always position cursor for IME

  # Conflicts:
  #	packages/coding-agent/CHANGELOG.md

  Mario Zechner · 2026-01-17 11:40:39 +01:00
  673916f63c
• chore: audit changelog entries for v0.47.0, add cl.md prompt template

  - Add missing changelog entries for commits since v0.47.0
  - Cross-duplicate ai/tui fixes to coding-agent changelog
  - Change PI_NO_HARDWARE_CURSOR to PI_HARDWARE_CURSOR (opt-in)
  - Fix typo in PI_CODING_AGENT_DIR changelog entry
  - Add .pi/prompts/cl.md for pre-release changelog audits

  Mario Zechner · 2026-01-16 21:11:01 +01:00
  0c33e0dee5
• Add PI_NO_HARDWARE_CURSOR env var for terminals with limited escape sequence support

  Fixes cursor visibility issues in JetBrains IDE terminals (IntelliJ, PyCharm) where
  the hardware cursor either blinks or becomes invisible depending on settings.
  
  Fixes #771

  Mario Zechner · 2026-01-16 12:51:09 +01:00
  4dbf094b65
• feat(tui): hardware cursor positioning for IME support

  - Add Focusable interface for components that need hardware cursor positioning
  - Add CURSOR_MARKER (APC escape sequence) for marking cursor position in render output
  - Editor and Input components implement Focusable and emit marker when focused
  - TUI extracts cursor position from rendered output and positions hardware cursor
  - Track hardwareCursorRow separately from cursorRow for differential rendering
  - visibleWidth() and extractAnsiCode() now handle APC sequences
  - Update overlay-test.ts example to demonstrate Focusable usage
  - Add documentation for Focusable interface in docs/tui.md
  
  Closes #719, closes #525

  Mario Zechner · 2026-01-16 04:30:07 +01:00
  07fad1362c
• feat(tui): overlay positioning API with CSS-like values

  Add OverlayOptions for configurable positioning (anchor, margins, offsets,
  percentages). Add OverlayHandle for programmatic visibility control with
  hide/setHidden/isHidden. Add visible callback for responsive overlays.
  
  Extension API: ctx.ui.custom() now accepts overlayOptions and onHandle callback.
  
  Examples: overlay-qa-tests.ts (10 test commands), doom-overlay (DOOM at 35 FPS).

  Nico Bailon · 2026-01-12 22:44:58 -08:00
  a4ccff382c
• feat(tui): add OverlayOptions API and fix width overflow crash

  Adds positioning/sizing options for overlays and fixes crash when compositing
  lines with complex ANSI sequences exceed terminal width.

  Nico Bailon · 2026-01-12 10:01:34 -08:00
  0c0aac6599
• fix(tui): reset styles per line
  Mario Zechner · 2026-01-11 18:36:48 +01:00
  6d495348c5
• fix(tui): ensure cursor moves to end of content on exit to prevent visual artifacts
  Jian Zhang · 2026-01-11 17:25:26 +01:00
  b57eafaadb
• fix(tui): reduce flicker by only re-rendering changed lines (#617)
  Ogulcan Celik · 2026-01-11 03:02:35 +01:00
  df3a220d6b
• fix(tui): cursor position tracking when content shrinks with unchanged lines
  Mario Zechner · 2026-01-11 03:00:23 +01:00
  3bb115a39c
• Fix TUI rendering with wrong dimensions after suspend/resume

  - Send SIGWINCH to self on terminal start to refresh stale dimensions (Unix only)
  - Change requestRender(true) to set previousWidth = -1 to trigger widthChanged
  - Update first render condition to skip when widthChanged is true
  
  Fixes #599

  Mario Zechner · 2026-01-11 02:47:28 +01:00
  d7394eb109
• feat(tui): add overlay compositing for ctx.ui.custom() (#558)

  Adds overlay rendering capability to the TUI, enabling floating modal
  components that render on top of existing content without clearing the screen.
  
  - Add showOverlay(), hideOverlay(), hasOverlay() methods to TUI
  - Implement ANSI-aware line compositing via extractSegments()
  - Support overlay stack (multiple overlays, later on top)
  - Add { overlay: true } option to ctx.ui.custom()
  - Add overlay-test.ts example extension
  
  Also fixes pre-existing bug where bash tool output cached visual lines
  at fixed terminal width, causing crashes on terminal resize.
  
  Co-authored-by: Nico Bailon <nico.bailon@gmail.com>

  Mario Zechner · 2026-01-08 22:40:42 +01:00
  f9064c2f69
• feat(coding-agent): add ctx.ui.setEditorComponent() extension API

  - Add setEditorComponent() to ctx.ui for custom editor components
  - Add CustomEditor base class for extensions (handles app keybindings)
  - Add keybindings parameter to ctx.ui.custom() factory (breaking change)
  - Add modal-editor.ts example (vim-like modes)
  - Add rainbow-editor.ts example (animated text highlighting)
  - Update docs: extensions.md, tui.md Pattern 7
  - Clean up terminal on TUI render errors

  Mario Zechner · 2026-01-07 16:11:49 +01:00
  09471ebc7d
• fix(tui): filter key release events by default

  Components must set wantsKeyRelease=true to receive release events.
  Fixes double-processing of keys in editors when Kitty protocol flag 2 is enabled.

  Mario Zechner · 2026-01-07 01:31:24 +01:00
  41fe329cdd
• feat: configurable keybindings for all editor and app actions

  All keybindings configurable via ~/.pi/agent/keybindings.json
  
  Editor actions:
  - cursorUp, cursorDown, cursorLeft, cursorRight
  - cursorWordLeft, cursorWordRight, cursorLineStart, cursorLineEnd
  - deleteCharBackward, deleteCharForward, deleteWordBackward
  - deleteToLineStart, deleteToLineEnd
  - newLine, submit, tab
  - selectUp, selectDown, selectConfirm, selectCancel
  
  App actions:
  - interrupt, clear, exit, suspend
  - cycleThinkingLevel, cycleModelForward, cycleModelBackward
  - selectModel, expandTools, toggleThinking, externalEditor
  
  Also adds support for numpad Enter key (Kitty protocol codepoint 57414
  and SS3 M sequence)
  
  Example emacs-style keybindings.json:
  {
    "cursorUp": ["up", "ctrl+p"],
    "cursorDown": ["down", "ctrl+n"],
    "cursorLeft": ["left", "ctrl+b"],
    "cursorRight": ["right", "ctrl+f"],
    "deleteCharForward": ["delete", "ctrl+d"],
    "cycleModelForward": "ctrl+o"
  }

  Helmut Januschka · 2026-01-03 08:23:56 +01:00
  8f2682578b
• Add global debug key (Shift+Ctrl+D), iterative tree sorting to avoid stack overflow
  Mario Zechner · 2025-12-30 22:42:22 +01:00
  544814875e
• feat(coding-agent): add Ctrl+Z to suspend process (#267)

  * feat(tui): add isCtrlZ key detection and resetRenderState method
  
  * feat(coding-agent): add Ctrl+Z handler to suspend process
  
  * docs(coding-agent): add Ctrl+Z to keyboard shortcuts documentation
  
  * feat(tui): add force parameter to requestRender

  Aliou Diallo · 2025-12-21 20:19:32 +01:00
  8868d623fc
• fix(tui): fix input buffering in iTerm2 causing delayed keypresses

  The cell size query response parser was incorrectly holding back Kitty
  keyboard protocol sequences, thinking they might be incomplete cell size
  responses. This caused Ctrl+C/Ctrl+D to require multiple presses in iTerm2.
  
  Fixed by only waiting for more data if the buffer doesn't end with a
  terminal escape sequence terminator character.

  Mario Zechner · 2025-12-19 22:08:36 +01:00
  d2276ab654
• Fix image rendering artifacts and improve show-images selector

  - Image component returns correct number of lines (rows) for TUI accounting
  - Empty lines rendered first, then cursor moves up and image is drawn
  - This clears the space the image occupies before rendering
  - Add spacer before inline images in tool output
  - Create ShowImagesSelectorComponent with borders like other selectors
  - Use showSelector pattern for /show-images command

  Mario Zechner · 2025-12-13 23:53:28 +01:00
  e4e234ecff
• Only query cell size if terminal supports images
  Mario Zechner · 2025-12-13 23:15:15 +01:00
  d4b2b4be04
• Fix image aspect ratio by querying terminal cell size

  - Add getCellDimensions/setCellDimensions to terminal-image.ts
  - TUI queries cell size on startup via CSI 16 t
  - Parse response and filter it from user input
  - Invalidate and re-render when cell dimensions received
  - Pass rows parameter to Kitty protocol for correct aspect ratio

  Mario Zechner · 2025-12-13 23:09:05 +01:00
  215c10664a
• add inline image rendering for terminals with graphics support
  Nico Bailon · 2025-12-12 19:30:50 -08:00
  9e9d5c94ed
• feat(coding-agent): context compaction with /compact, /autocompact, and auto-trigger

  - Add /compact command for manual context compaction with optional custom instructions
  - Add /autocompact command to toggle automatic compaction
  - Auto-trigger compaction when context usage exceeds threshold (contextWindow - reserveTokens)
  - Add CompactionComponent for TUI display with collapsed/expanded states
  - Add compaction events to HTML export with collapsible summary
  - Refactor export-html.ts to eliminate duplication between session and streaming formats
  - Use setTimeout to break out of agent event handler for safe async compaction
  - Show compaction summary in TUI after compaction completes
  
  fixes #92

  Mario Zechner · 2025-12-04 02:39:54 +01:00
  c89b1ec3c2
• Release v0.11.4
  Mario Zechner · 2025-12-01 13:05:12 +01:00
  e25420a4c8
• Release v0.8.0
  Mario Zechner · 2025-11-21 03:12:42 +01:00
  85adcf22bf