anima-core 1.2.0 → 1.4.0

data/lib/tui/braille_spinner.rb

@@ -0,0 +1,152 @@
+# frozen_string_literal: true
+
+module TUI
+  # Animated braille spinner that communicates session state through distinct
+  # visual patterns. Each state gets its own animation — a user watching long
+  # enough starts _feeling_ the difference between LLM thinking and tool
+  # execution without reading text.
+  #
+  # The 2x4 braille grid (U+2800-U+28FF) encodes 8 dots in a single character
+  # cell. Dot positions map to bit flags:
+  #
+  #   ┌───┬───┐
+  #   │ 0 │ 3 │   bit 0 = top-left,     bit 3 = top-right
+  #   │ 1 │ 4 │   bit 1 = mid-left,     bit 4 = mid-right
+  #   │ 2 │ 5 │   bit 2 = lower-left,   bit 5 = lower-right
+  #   │ 6 │ 7 │   bit 6 = bottom-left,  bit 7 = bottom-right
+  #   └───┴───┘
+  #
+  # During LLM generation, a snake weaves through the grid — organic,
+  # unpredictable movement like watching a campfire. During tool execution,
+  # a fast staccato pulse signals mechanical work. Interrupting decelerates
+  # to a freeze.
+  #
+  # @example Basic usage
+  #   spinner = BrailleSpinner.new
+  #   spinner.state = "llm_generating"
+  #   char = spinner.tick  # => "⠋" (braille pattern)
+  class BrailleSpinner
+    # Clockwise traversal of the 8 dots in the braille grid.
+    # Produces a smooth rotating animation — one dot lit at a time.
+    SNAKE_FRAMES = [
+      0x01, # ⠁ dot 0 (top-left)
+      0x02, # ⠂ dot 1 (mid-left)
+      0x04, # ⠄ dot 2 (lower-left)
+      0x40, # ⡀ dot 6 (bottom-left)
+      0x80, # ⢀ dot 7 (bottom-right)
+      0x20, # ⠠ dot 5 (lower-right)
+      0x10, # ⠐ dot 4 (mid-right)
+      0x08  # ⠈ dot 3 (top-right)
+    ].freeze
+
+    # Snake animation: 3 consecutive dots form a growing/moving tail.
+    # Each frame is the OR of 3 adjacent positions in SNAKE_FRAMES,
+    # creating a worm-like creature circling the grid.
+    SNAKE_TRAIL_FRAMES = SNAKE_FRAMES.each_index.map { |idx|
+      SNAKE_FRAMES[idx] | SNAKE_FRAMES[(idx + 1) % 8] | SNAKE_FRAMES[(idx + 2) % 8]
+    }.freeze
+
+    # Tool execution: alternating dot patterns for a staccato pulse.
+    # Fast, mechanical, clearly different from the smooth snake.
+    TOOL_FRAMES = [
+      0x09, # ⠉ dots 0+3 (top row)
+      0x12, # ⠒ dots 1+4 (middle row)
+      0x24, # ⠤ dots 2+5 (lower row)
+      0xC0, # ⣀ dots 6+7 (bottom row)
+      0x24, # ⠤ dots 2+5 (lower row)
+      0x12  # ⠒ dots 1+4 (middle row)
+    ].freeze
+
+    # Interrupting: rapid deceleration — full grid fading to empty.
+    INTERRUPT_FRAMES = [
+      0xFF, # ⣿ all dots
+      0xDB, # ⣛ most dots
+      0x49, # ⡉ sparse
+      0x00, # ⠀ empty
+      0x49, # ⡉ sparse
+      0xFF  # ⣿ all dots
+    ].freeze
+
+    # Braille Unicode block base codepoint.
+    BRAILLE_BASE = 0x2800
+
+    # Ticks per frame for each state — controls animation speed.
+    # Higher = slower. At ~15fps render loop: 2 = ~7.5fps, 4 = ~3.75fps.
+    SPEED = {
+      "llm_generating" => 2,
+      "tool_executing" => 1,
+      "interrupting" => 1
+    }.freeze
+
+    # @return [String] current session state
+    attr_reader :state
+
+    def initialize
+      @state = "idle"
+      @frame_index = 0
+      @tick_count = 0
+    end
+
+    # Updates the session state driving the animation.
+    # Resets frame position on state change for a clean transition.
+    #
+    # @param new_state [String] one of "idle", "llm_generating",
+    #   "tool_executing", "interrupting"
+    def state=(new_state)
+      if @state != new_state
+        @frame_index = 0
+        @tick_count = 0
+      end
+      @state = new_state
+    end
+
+    # Advances the animation by one tick and returns the current
+    # braille character. Returns nil when idle (no animation).
+    #
+    # @return [String, nil] single braille character, or nil when idle
+    def tick
+      return nil if @state == "idle"
+
+      frames = frames_for_state
+      return nil unless frames
+
+      speed = SPEED.fetch(@state, 2)
+      @tick_count += 1
+      if @tick_count >= speed
+        @tick_count = 0
+        @frame_index = (@frame_index + 1) % frames.size
+      end
+
+      (BRAILLE_BASE + frames[@frame_index]).chr(Encoding::UTF_8)
+    end
+
+    # Returns the current frame character without advancing.
+    #
+    # @return [String, nil] single braille character, or nil when idle
+    def current
+      return nil if @state == "idle"
+
+      frames = frames_for_state
+      return nil unless frames
+
+      (BRAILLE_BASE + frames[@frame_index]).chr(Encoding::UTF_8)
+    end
+
+    # Whether the spinner is actively animating.
+    #
+    # @return [Boolean]
+    def active?
+      @state != "idle"
+    end
+
+    private
+
+    def frames_for_state
+      case @state
+      when "llm_generating" then SNAKE_TRAIL_FRAMES
+      when "tool_executing" then TOOL_FRAMES
+      when "interrupting" then INTERRUPT_FRAMES
+      end
+    end
+  end
+end

data/lib/tui/cable_client.rb

@@ -2,6 +2,7 @@
 
 require "websocket-client-simple"
 require "json"
+require_relative "settings"
 
 module TUI
   # Action Cable WebSocket client for connecting the TUI to the brain server.
@@ -23,14 +24,6 @@ module TUI
   #   messages = client.drain_messages
   #   client.disconnect
   class CableClient
-    DISCONNECT_TIMEOUT = 2 # seconds to wait for WebSocket thread to finish
-    POLL_INTERVAL = 0.1 # seconds between connection status checks
-    CONNECTION_TIMEOUT = 10 # seconds to wait for the connecting state to advance
-    MAX_RECONNECT_ATTEMPTS = 10
-    BACKOFF_BASE = 1.0 # initial backoff delay in seconds
-    BACKOFF_CAP = 30.0 # maximum backoff delay
-    PING_STALE_THRESHOLD = 6.0 # seconds without ping before connection is stale
-
     # Message types queued for the TUI render loop via @message_queue
     MSG_TYPE_CONNECTION = "connection"
 
@@ -129,9 +122,9 @@ module TUI
     # Requests the brain to recall (delete) a pending message so the user
     # can edit it before the LLM sees it.
     #
-    # @param message_id [Integer] database ID of the pending user_message
-    def recall_pending(message_id)
-      send_action("recall_pending", {"message_id" => message_id})
+    # @param pending_message_id [Integer] database ID of the {PendingMessage}
+    def recall_pending(pending_message_id)
+      send_action("recall_pending", {"pending_message_id" => pending_message_id})
     end
 
     # Requests interruption of the current tool execution. The server sets
@@ -143,7 +136,7 @@ module TUI
     end
 
     # Sends an Anthropic subscription token to the brain for validation and storage.
-    # The token flows directly from TUI input to encrypted credentials — never
+    # The token flows directly from TUI input to the encrypted secrets table — never
     # enters the LLM context window.
     #
     # @param token [String] Anthropic subscription token (sk-ant-oat01-...)
@@ -180,7 +173,7 @@ module TUI
         @status = :disconnected
       end
       @ws&.close
-      @ws_thread&.join(DISCONNECT_TIMEOUT)
+      @ws_thread&.join(Settings.connection_disconnect_timeout)
     end
 
     private
@@ -260,13 +253,13 @@ module TUI
       loop do
         break if @status == :disconnected
 
-        if @status == :connecting && (Time.now - connection_start) > CONNECTION_TIMEOUT
+        if @status == :connecting && (Time.now - connection_start) > Settings.connection_timeout
           on_disconnected
           break
         end
 
         check_stale_connection
-        sleep POLL_INTERVAL
+        sleep Settings.connection_poll_interval
       end
     end
 
@@ -276,7 +269,7 @@ module TUI
     def check_stale_connection
       stale = @mutex.synchronize do
         next false unless @last_ping_at && @status == :subscribed
-        (Time.now - @last_ping_at) >= PING_STALE_THRESHOLD
+        (Time.now - @last_ping_at) >= Settings.connection_ping_stale_threshold
       end
 
       on_disconnected if stale
@@ -291,12 +284,12 @@ module TUI
         @reconnect_attempt
       end
 
-      if attempt > MAX_RECONNECT_ATTEMPTS
+      if attempt > Settings.connection_max_reconnect_attempts
         @mutex.synchronize { @status = :disconnected }
         @message_queue << {
           "type" => MSG_TYPE_CONNECTION,
           "status" => STATUS_FAILED,
-          "message" => "Reconnection failed after #{MAX_RECONNECT_ATTEMPTS} attempts"
+          "message" => "Reconnection failed after #{Settings.connection_max_reconnect_attempts} attempts"
         }
         return false
       end
@@ -307,7 +300,7 @@ module TUI
         "type" => MSG_TYPE_CONNECTION,
         "status" => STATUS_RECONNECTING,
         "attempt" => attempt,
-        "max_attempts" => MAX_RECONNECT_ATTEMPTS,
+        "max_attempts" => Settings.connection_max_reconnect_attempts,
         "delay" => delay.round(1)
       }
 
@@ -321,7 +314,7 @@ module TUI
     # @param attempt [Integer] current attempt number (1-based)
     # @return [Float] delay in seconds
     def backoff_delay(attempt)
-      max_delay = [BACKOFF_CAP, BACKOFF_BASE * (2**(attempt - 1))].min
+      max_delay = [Settings.connection_backoff_cap, Settings.connection_backoff_base * (2**(attempt - 1))].min
       rand(0.0..max_delay)
     end
 

data/lib/tui/decorators/base_decorator.rb

@@ -19,6 +19,26 @@ module TUI
     # @example Render a tool call
     #   decorator = TUI::Decorators::BaseDecorator.for(data)
     #   lines = decorator.render(tui)
+    # Shared rendering for file-related tool decorators (read, write, edit).
+    # Extracts the file path from input and displays it in the header line,
+    # making the target file immediately visible — like bash shows its command.
+    module FileCallBehavior
+      def render_call(tui)
+        style = tui.style(fg: color)
+        input_lines = data["input"].to_s.split("\n", -1)
+        path_line = input_lines.first.to_s
+
+        header = build_call_header
+        header = "#{header} #{path_line}" unless path_line.empty?
+        lines = [tui.line(spans: [tui.span(content: header, style: style)])]
+
+        input_lines.drop(1).each do |line|
+          lines << tui.line(spans: [tui.span(content: preserve_indentation("  #{line}"), style: style)])
+        end
+        lines
+      end
+    end
+
     class BaseDecorator
       include Formatting
 
@@ -65,12 +85,14 @@ module TUI
         header = build_call_header
         lines = [tui.line(spans: [tui.span(content: header, style: style)])]
         data["input"].to_s.split("\n", -1).each do |line|
-          lines << tui.line(spans: [tui.span(content: "  #{line}", style: style)])
+          lines << tui.line(spans: [tui.span(content: preserve_indentation("  #{line}"), style: style)])
         end
         lines
       end
 
       # Generic tool response rendering — success/failure indicator and content.
+      # Token counts get their own color-coded span so expensive responses
+      # visually jump out in debug mode.
       # Subclasses override for tool-specific presentation.
       #
       # @param tui [RatatuiRuby] TUI rendering API
@@ -79,17 +101,23 @@ module TUI
         indicator = (data["success"] == false) ? ERROR_ICON : CHECKMARK
         tool_id = data["tool_use_id"]
         tokens = data["tokens"]
+        style = tui.style(fg: response_color)
 
         meta_parts = []
         meta_parts << "[#{tool_id}]" if tool_id
         meta_parts << indicator
-        meta_parts << format_token_label(tokens, data["estimated"]) if tokens
         prefix = "  #{RETURN_ARROW} #{meta_parts.join(" ")} "
 
         content_lines = data["content"].to_s.split("\n", -1)
-        style = tui.style(fg: response_color)
-        lines = [tui.line(spans: [tui.span(content: "#{prefix}#{content_lines.first}", style: style)])]
-        content_lines.drop(1).each { |line| lines << tui.line(spans: [tui.span(content: "    #{line}", style: style)]) }
+        first_line_spans = [tui.span(content: prefix, style: style)]
+        if tokens
+          tok_label = format_token_label(tokens, data["estimated"])
+          first_line_spans << tui.span(content: "#{tok_label} ", style: tui.style(fg: token_count_color(tokens)))
+        end
+        first_line_spans << tui.span(content: content_lines.first.to_s, style: style)
+
+        lines = [tui.line(spans: first_line_spans)]
+        content_lines.drop(1).each { |line| lines << tui.line(spans: [tui.span(content: preserve_indentation("    #{line}"), style: style)]) }
         lines
       end
 
@@ -108,16 +136,17 @@ module TUI
         ICON
       end
 
-      # Color for tool call headers. Subclasses override for tool-specific colors.
+      # Unified color for all tool call headers. Keeps tool invocations
+      # visually distinct from conversation messages (user/assistant/thought).
       # @return [String]
       def color
-        "white"
+        Settings.theme_color_accent
       end
 
       # Color for tool response content. Subclasses override for tool-specific colors.
       # @return [String]
       def response_color
-        "white"
+        Settings.theme_color_text
       end
 
       private
@@ -152,9 +181,9 @@ module TUI
         case tool_name
         when "bash" then BashDecorator
         when "think" then ThinkDecorator
-        when "read" then ReadDecorator
-        when "edit" then EditDecorator
-        when "write" then WriteDecorator
+        when "read_file" then ReadDecorator
+        when "edit_file" then EditDecorator
+        when "write_file" then WriteDecorator
         when "web_get" then WebGetDecorator
         else self
         end

data/lib/tui/decorators/bash_decorator.rb

@@ -3,8 +3,8 @@
 module TUI
   module Decorators
     # Renders bash tool calls and responses.
-    # Calls show the shell command with a terminal icon.
-    # Responses use green for success, red for failure.
+    # Calls show the shell command with a terminal icon in the unified tool color.
+    # Responses use green for success, red for failure — immediate actionable feedback.
     class BashDecorator < BaseDecorator
       ICON = "\u{1F4BB}" # laptop / terminal
 
@@ -13,7 +13,7 @@ module TUI
       end
 
       def response_color
-        (data["success"] == false) ? "red" : "green"
+        (data["success"] == false) ? Settings.theme_color_error : Settings.theme_color_success
       end
     end
   end

data/lib/tui/decorators/edit_decorator.rb

@@ -2,17 +2,20 @@
 
 module TUI
   module Decorators
-    # Renders edit tool calls and responses.
-    # Calls show the file path with a pencil icon.
+    # Renders edit_file tool calls and responses.
+    # Calls show the file path in the header line for immediate visibility.
+    # Responses use the CRUD Update color (light_yellow) to flag modifications.
     class EditDecorator < BaseDecorator
+      include FileCallBehavior
+
       ICON = "\u270F\uFE0F" # pencil
 
       def icon
         ICON
       end
 
-      def color
-        "yellow"
+      def response_color
+        Settings.theme_tool_update_color
       end
     end
   end

data/lib/tui/decorators/read_decorator.rb

@@ -2,22 +2,20 @@
 
 module TUI
   module Decorators
-    # Renders read tool calls and responses.
-    # Calls show the file path with a page icon.
-    # Responses show file content in dim text.
+    # Renders read_file tool calls and responses.
+    # Calls show the file path in the header line for immediate visibility.
+    # Responses use the CRUD Read color (light_blue) for informational content.
     class ReadDecorator < BaseDecorator
+      include FileCallBehavior
+
       ICON = "\u{1F4C4}" # page facing up
 
       def icon
         ICON
       end
 
-      def color
-        "cyan"
-      end
-
       def response_color
-        "dark_gray"
+        Settings.theme_tool_read_color
       end
     end
   end

data/lib/tui/decorators/think_decorator.rb

@@ -3,8 +3,8 @@
 module TUI
   module Decorators
     # Renders think tool events — the agent's inner reasoning.
-    # "aloud" thoughts use yellow (narration for the user), "inner"
-    # thoughts use dark_gray (dimmed to signal internality).
+    # Both "aloud" and "inner" thoughts use grey (dark_gray) to visually
+    # de-emphasize reasoning content vs. actual conversation output.
     class ThinkDecorator < BaseDecorator
       THOUGHT_BUBBLE = "\u{1F4AD}" # thought balloon
 
@@ -17,9 +17,7 @@ module TUI
       # @param tui [RatatuiRuby] TUI rendering API
       # @return [Array<RatatuiRuby::Widgets::Line>]
       def render_think(tui)
-        aloud = data["visibility"] == "aloud"
-        fg = aloud ? "yellow" : "dark_gray"
-        style = tui.style(fg: fg)
+        style = tui.style(fg: Settings.theme_color_muted)
         ts = data["timestamp"]
 
         meta = []
@@ -28,7 +26,7 @@ module TUI
 
         content_lines = data["content"].to_s.split("\n", -1)
         lines = [tui.line(spans: [tui.span(content: "#{header} #{content_lines.first}", style: style)])]
-        content_lines.drop(1).each { |line| lines << tui.line(spans: [tui.span(content: "  #{line}", style: style)]) }
+        content_lines.drop(1).each { |line| lines << tui.line(spans: [tui.span(content: preserve_indentation("  #{line}"), style: style)]) }
         lines
       end
     end

data/lib/tui/decorators/web_get_decorator.rb

@@ -3,7 +3,8 @@
 module TUI
   module Decorators
     # Renders web_get tool calls and responses.
-    # Calls show the URL with a globe icon.
+    # Calls show the URL with a globe icon in the unified tool color.
+    # Responses use the CRUD Read color (light_blue) for fetched content.
     class WebGetDecorator < BaseDecorator
       ICON = "\u{1F310}" # globe with meridians
 
@@ -11,8 +12,8 @@ module TUI
         ICON
       end
 
-      def color
-        "blue"
+      def response_color
+        Settings.theme_tool_read_color
       end
     end
   end

data/lib/tui/decorators/write_decorator.rb

@@ -2,17 +2,20 @@
 
 module TUI
   module Decorators
-    # Renders write tool calls and responses.
-    # Calls show the file path with a memo icon.
+    # Renders write_file tool calls and responses.
+    # Calls show the file path in the header line for immediate visibility.
+    # Responses use the CRUD Create color (light_green) to signal new content.
     class WriteDecorator < BaseDecorator
+      include FileCallBehavior
+
       ICON = "\u{1F4DD}" # memo
 
       def icon
         ICON
       end
 
-      def color
-        "yellow"
+      def response_color
+        Settings.theme_tool_create_color
       end
     end
   end

data/lib/tui/flash.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require_relative "settings"
+
 module TUI
   # Ephemeral notification system for the TUI, modeled after Rails flash
   # messages. Notifications render as a colored bar at the top of the
@@ -22,18 +24,19 @@ module TUI
   # @example Dismissing
   #   flash.dismiss!
   class Flash
-    AUTO_DISMISS_SECONDS = 5.0
-
-    # Flash area occupies at most 1/3 of the chat pane height.
-    MAX_HEIGHT_FRACTION = 3
-
     Entry = Struct.new(:message, :level, :created_at, keyword_init: true)
 
-    LEVEL_STYLES = {
-      error: {fg: "white", bg: "red", icon: " \u2718 "},
-      warning: {fg: "black", bg: "yellow", icon: " \u26A0 "},
-      info: {fg: "white", bg: "blue", icon: " \u2139 "}
-    }.freeze
+    LEVEL_ICONS = {error: " \u2718 ", warning: " \u26A0 ", info: " \u2139 "}.freeze
+
+    # Builds level styles from current theme settings.
+    # Called per-render so hot-reloaded theme changes take effect immediately.
+    def self.level_styles
+      {
+        error: {fg: Settings.theme_flash_error_fg, bg: Settings.theme_flash_error_bg},
+        warning: {fg: Settings.theme_flash_warning_fg, bg: Settings.theme_flash_warning_bg},
+        info: {fg: Settings.theme_flash_info_fg, bg: Settings.theme_flash_info_bg}
+      }
+    end
 
     def initialize
       @entries = []
@@ -81,7 +84,7 @@ module TUI
       expire!
       return 0 if @entries.empty?
 
-      height = [@entries.size, area.height / MAX_HEIGHT_FRACTION].min
+      height = [@entries.size, area.height / Settings.flash_max_height_fraction].min
 
       flash_area, _ = tui.split(
         area,
@@ -110,7 +113,7 @@ module TUI
 
     def expire!
       now = monotonic_now
-      @entries.reject! { |entry| now - entry.created_at > AUTO_DISMISS_SECONDS }
+      @entries.reject! { |entry| now - entry.created_at > Settings.flash_auto_dismiss_seconds }
     end
 
     def row_rect(area, index, tui)
@@ -120,10 +123,12 @@ module TUI
     end
 
     def render_entry(frame, area, entry, tui)
-      config = LEVEL_STYLES.fetch(entry.level, LEVEL_STYLES[:info])
+      styles = self.class.level_styles
+      config = styles.fetch(entry.level, styles[:info])
+      icon = LEVEL_ICONS.fetch(entry.level, LEVEL_ICONS[:info])
       style = tui.style(fg: config[:fg], bg: config[:bg], modifiers: [:bold])
 
-      text = "#{config[:icon]}#{entry.message} "
+      text = "#{icon}#{entry.message} "
       # Pad to full width so background color fills the entire row
       padded = text.ljust(area.width)
 

data/lib/tui/formatting.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require_relative "settings"
+
 module TUI
   # Shared formatting helpers for timestamps and token counts.
   # Used by both the Chat screen and client-side decorators
@@ -16,6 +18,28 @@ module TUI
       "[#{label} tok]"
     end
 
+    # Returns a semantic color for token count display.
+    # Visually flags expensive messages so runaway tool calls or bloated
+    # responses jump out immediately in debug mode.
+    #
+    # Thresholds (empirically tuned from real agent sessions):
+    #   < 1k  → muted   (routine, ignorable)
+    #   < 3k  → text    (normal)
+    #   < 10k → warning (notable)
+    #   < 20k → 208/orange (expensive)
+    #   ≥ 20k → error   (alarm — likely runaway)
+    #
+    # @param tokens [Integer] token count
+    # @return [String, Integer] named color or 256-color index
+    def token_count_color(tokens)
+      return Settings.theme_color_muted if tokens < 1_000
+      return Settings.theme_color_text if tokens < 3_000
+      return Settings.theme_color_warning if tokens < 10_000
+      return Settings.theme_color_expensive if tokens < 20_000
+
+      Settings.theme_color_error
+    end
+
     # Converts nanosecond-precision timestamp to human-readable HH:MM:SS.
     # @param ns [Integer, nil] nanosecond timestamp
     # @return [String] formatted time, or "--:--:--" when nil
@@ -24,5 +48,14 @@ module TUI
 
       Time.at(ns / 1_000_000_000.0).strftime("%H:%M:%S")
     end
+
+    # Replaces leading ASCII spaces with non-breaking spaces (\u00a0).
+    # Ratatui's Paragraph widget with wrap:true trims regular leading
+    # spaces; NBSP preserves visual indentation in wrapped text.
+    # @param text [String] text that may contain leading spaces
+    # @return [String] text with leading spaces replaced by NBSP
+    def preserve_indentation(text)
+      text.gsub(/^( +)/) { "\u00a0" * _1.length }
+    end
   end
 end

data/lib/tui/input_buffer.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require_relative "settings"
+
 module TUI
   # Manages editable text with cursor position tracking.
   # Supports multiline input with newline insertion, cursor navigation
@@ -7,8 +9,6 @@ module TUI
   #
   # Pure logic object with no rendering or framework dependencies.
   class InputBuffer
-    MAX_LENGTH = 10_000
-
     attr_reader :text, :cursor_pos
 
     def initialize
@@ -36,9 +36,9 @@ module TUI
       @text.include?("\n")
     end
 
-    # @return [Boolean] whether the buffer has reached MAX_LENGTH
+    # @return [Boolean] whether the buffer has reached Settings.input_max_length
     def full?
-      @text.length >= MAX_LENGTH
+      @text.length >= Settings.input_max_length
     end
 
     # Ensures cursor stays within valid bounds after external state changes.
@@ -48,9 +48,9 @@ module TUI
     end
 
     # @param char [String] character(s) to insert at cursor
-    # @return [Boolean] true if inserted, false if result would exceed MAX_LENGTH
+    # @return [Boolean] true if inserted, false if result would exceed Settings.input_max_length
     def insert(char)
-      return false if @text.length + char.length > MAX_LENGTH
+      return false if @text.length + char.length > Settings.input_max_length
 
       @text = "#{@text[0...@cursor_pos]}#{char}#{@text[@cursor_pos..]}"
       @cursor_pos += char.length