kward 0.76.0 → 0.78.0

data/lib/kward/plugin_registry.rb

@@ -34,6 +34,10 @@ module Kward
       end
     end
 
+    # Registered plugin-owned tab runtime. Its factory receives a
+    # `PluginTabHost` and its persisted descriptor, then returns a driver.
+    TabType = Struct.new(:id, :name, :title, :singleton, :rpc, :transcript_events, :path, :handler, keyword_init: true)
+
     # Read-only event passed to plugin transcript observers.
     TranscriptEvent = Struct.new(:type, :payload, keyword_init: true) do
       def to_h
@@ -87,14 +91,17 @@ module Kward
         nil
       end
 
+      # @return [String, nil] active session identifier
       def session_id
         @session&.id
       end
 
+      # @return [String, nil] human-readable active session name
       def session_name
         @session&.name
       end
 
+      # @return [String, nil] saved active session path
       def session_path
         @session&.path
       end
@@ -108,30 +115,45 @@ module Kward
         nil
       end
 
+      # Allows the current lifecycle event to continue.
+      # @return [Hooks::Decision]
       def allow(message = nil, metadata: nil)
         Hooks::Decision.allow(message, metadata: metadata)
       end
 
+      # Denies the current lifecycle event.
+      # @return [Hooks::Decision]
       def deny(message = nil, metadata: nil)
         Hooks::Decision.deny(message, metadata: metadata)
       end
 
+      # Requests frontend approval for the current lifecycle event.
+      # @return [Hooks::Decision]
       def ask(message = nil, metadata: nil)
         Hooks::Decision.ask(message, metadata: metadata)
       end
 
+      # Continues with an event-specific payload replacement.
+      # @param payload [Hash] replacement fields supported by the event
+      # @return [Hooks::Decision]
       def modify(payload, message: nil, metadata: nil)
         Hooks::Decision.modify(payload, message: message, metadata: metadata)
       end
 
+      # Allows the event while recording a warning.
+      # @return [Hooks::Decision]
       def warn(message = nil, metadata: nil)
         Hooks::Decision.warn(message, metadata: metadata)
       end
 
+      # Requests a retry when the current event supports it.
+      # @return [Hooks::Decision]
       def retry(message = nil, payload: nil, metadata: nil)
         Hooks::Decision.retry(message, payload: payload, metadata: metadata)
       end
 
+      # Defers the event when the current workflow supports it.
+      # @return [Hooks::Decision]
       def defer(message = nil, payload: nil, metadata: nil)
         Hooks::Decision.defer(message, payload: payload, metadata: metadata)
       end
@@ -246,6 +268,23 @@ module Kward
       def interactive_command(name, rows:, fps: 30, description: "", argument_hint: "", &block)
         @registry.register_interactive_command(name, rows: rows, fps: fps, description: description, argument_hint: argument_hint, path: @path, &block)
       end
+
+      # Registers a plugin-owned tab type for the interactive CLI. `id` is a
+      # durable identifier used in persisted tab layouts and must not change.
+      # The factory receives a `PluginTabHost` and a descriptor hash.
+      #
+      # @param name [String] command name used by `/tab open <name>`
+      # @param id [String] stable persisted tab type identifier
+      # @param title [String] default tab label
+      # @param singleton [Symbol] `:global` for one shared plugin runtime
+      # @param transcript_events [Boolean] allow global transcript observers to receive this tab's events
+      # @yieldparam host [PluginTabHost] supported host dependencies
+      # @yieldparam descriptor [Hash] persisted tab descriptor
+      # @return [void]
+      # @api public
+      def tab_type(name, id:, title: nil, singleton: nil, rpc: false, transcript_events: false, &block)
+        @registry.register_tab_type(name, id: id, title: title, singleton: singleton, rpc: rpc, transcript_events: transcript_events, path: @path, &block)
+      end
     end
 
     # Mutable singleton guard used while loading trusted plugin files.
@@ -264,6 +303,8 @@ module Kward
       @reserved_commands = reserved_commands.map(&:to_s)
       @commands = {}
       @interactive_commands = {}
+      @tab_types = {}
+      @tab_types_by_id = {}
       @footer = nil
       @footer_path = nil
       @transcript_event_handlers = []
@@ -294,6 +335,18 @@ module Kward
       @interactive_commands[name.to_s]
     end
 
+    def tab_types
+      @tab_types.values
+    end
+
+    def tab_type_for(name)
+      @tab_types[name.to_s]
+    end
+
+    def tab_type_for_id(id)
+      @tab_types_by_id[id.to_s]
+    end
+
     def footer_renderer
       @footer
     end
@@ -411,6 +464,23 @@ module Kward
       )
     end
 
+    def register_tab_type(name, id:, title: nil, singleton: nil, rpc: false, transcript_events: false, path: nil, &handler)
+      name = name.to_s
+      id = id.to_s
+      raise "Plugin tab type name is invalid: #{name}" unless name.match?(COMMAND_NAME_PATTERN)
+      raise "Plugin tab type id is required" if id.empty?
+      raise "Plugin tab type #{name} requires a handler" unless handler
+
+      if @tab_types.key?(name) || @tab_types_by_id.key?(id)
+        warn "Warning: skipping duplicate Kward plugin tab type #{id}: #{path}"
+        return nil
+      end
+
+      tab_type = TabType.new(id: id, name: name, title: title.to_s.empty? ? name.capitalize : title.to_s, singleton: singleton&.to_sym, rpc: rpc == true, transcript_events: transcript_events == true, path: path, handler: handler)
+      @tab_types[name] = tab_type
+      @tab_types_by_id[id] = tab_type
+    end
+
     def register_footer(path: nil, &renderer)
       raise "Plugin footer requires a renderer" unless renderer
 
@@ -482,7 +552,7 @@ module Kward
       end
     end
 
-    def transcript_event(type, payload)
+    def transcript_event(type, payload = {})
       TranscriptEvent.new(
         type: type,
         payload: DeepCopy.freeze(DeepCopy.dup(payload))

data/lib/kward/prompt_interface/approval_prompt.rb

@@ -0,0 +1,62 @@
+require "json"
+
+# Namespace for the Kward CLI agent runtime.
+module Kward
+  class PromptInterface
+    # Tool-approval overlay built on the structured question modal.
+    module ApprovalPrompt
+      # Asks the captain to approve a model-requested tool call. Cancellation is
+      # intentionally a denial so a closed or interrupted overlay never permits
+      # a side effect.
+      def ask_tool_approval(tool_name:, args:, reason: nil)
+        summary, details = tool_approval_details(tool_name, args)
+        question = (["The agent wants to #{summary}."] + Array(details) + [reason.to_s].reject(&:empty?)).join("\n")
+        answers = ask_user_question([
+          {
+            header: "Approval required · #{tool_approval_title(tool_name)}",
+            question: question,
+            options: [
+              { label: "Allow once", description: "Run this tool call." },
+              { label: "Allow this tool for this session", description: "Run this call and future calls to #{tool_name}." },
+              { label: "Deny", description: "Do not run this tool call." }
+            ]
+          }
+        ])
+        answer = answers&.first
+        return { denied_message: answer[:answer] } if answer&.fetch(:custom, false) && !answer[:answer].to_s.empty?
+
+        case answer&.fetch(:answer, nil)
+        when "Allow once" then true
+        when "Allow this tool for this session" then :allow_for_session
+        else false
+        end
+      end
+
+      private
+
+      def tool_approval_title(tool_name)
+        case tool_name.to_s
+        when "run_shell_command" then "Shell command"
+        when "write_file" then "Write file"
+        when "edit_file" then "Edit file"
+        when "fetch_content", "fetch_raw" then "Network request"
+        when "web_search" then "Web search"
+        else tool_name.to_s.tr("_", " ").capitalize
+        end
+      end
+
+      def tool_approval_details(tool_name, args)
+        action = case tool_name.to_s
+                 when "run_shell_command" then "run this shell command"
+                 when "write_file" then "write this file"
+                 when "edit_file" then "edit this file"
+                 when "read_file", "read_skill" then "read these resources"
+                 when "fetch_content", "fetch_raw" then "make this network request"
+                 when "web_search" then "search the web"
+                 else "use #{tool_name}"
+                 end
+        [action, ["Arguments:\n#{JSON.pretty_generate(args.to_h)}"]]
+      end
+    end
+  end
+end

data/lib/kward/prompt_interface/editor/auto_indent.rb

@@ -177,7 +177,7 @@ module Kward
       def editor_expected_indent_for_line(line_index)
         line = @editor_state.lines[line_index].to_s
         code = editor_indent_code(line, editor_syntax_language).strip
-        matching_indent = editor_matching_indent_for_line(code)
+        matching_indent = editor_matching_indent_for_line(code, line_index)
         return matching_indent if matching_indent
 
         previous_line = previous_non_blank_editor_line(line_index)
@@ -188,11 +188,11 @@ module Kward
         indent
       end
 
-      def editor_matching_indent_for_line(code)
+      def editor_matching_indent_for_line(code, line_index = nil)
         return nil if code.empty?
-        return editor_matching_punctuation_indent(code[0]) if editor_closing_punctuation?(code[0])
+        return editor_matching_punctuation_indent(code[0], line_index) if editor_closing_punctuation?(code[0])
 
-        editor_matching_word_indent if editor_completed_word_closer?(code, editor_syntax_language)
+        editor_matching_word_indent(line_index) if editor_completed_word_closer?(code, editor_syntax_language)
       end
 
       def previous_non_blank_editor_line(line_index)
@@ -371,7 +371,8 @@ module Kward
       def editor_reindent_for_closing_punctuation(text)
         return unless editor_cursor_in_leading_indent?
 
-        indent = editor_matching_punctuation_indent(text)
+        line_index, = @editor_state.cursor_line_and_column
+        indent = editor_matching_punctuation_indent(text, line_index)
         editor_reindent_current_line(indent) if indent
       end
 
@@ -381,7 +382,7 @@ module Kward
         before_cursor = line[0...column].to_s
         return unless editor_completed_word_closer?(before_cursor, editor_syntax_language)
 
-        indent = editor_matching_word_indent
+        indent = editor_matching_word_indent(line_index)
         editor_reindent_current_line(indent) if indent
       end
 
@@ -394,14 +395,21 @@ module Kward
       def editor_reindent_current_line(indent)
         line_index, column = @editor_state.cursor_line_and_column
         line_start = @editor_state.line_start_offset(line_index)
-        line = @editor_state.lines[line_index].to_s
-        old_indent = line[/\A[ \t]*/].to_s
+        old_indent = @editor_state.lines[line_index].to_s[/\A[ \t]*/].to_s
+        return false unless editor_reindent_line(line_index, indent)
+
+        content_column = [column - old_indent.length, 0].max
+        @editor_state.cursor = line_start + indent.to_s.length + content_column
+        true
+      end
+
+      def editor_reindent_line(line_index, indent)
+        line_start = @editor_state.line_start_offset(line_index)
+        old_indent = @editor_state.lines[line_index].to_s[/\A[ \t]*/].to_s
         new_indent = indent.to_s
         return false if old_indent == new_indent
 
-        content_column = [column - old_indent.length, 0].max
         @editor_state.replace_range(line_start, line_start + old_indent.length, new_indent)
-        @editor_state.cursor = line_start + new_indent.length + content_column
         true
       end
 
@@ -421,23 +429,23 @@ module Kward
         end
       end
 
-      def editor_matching_word_indent
+      def editor_matching_word_indent(line_index = nil)
         case editor_syntax_language
         when :ruby
-          editor_matching_keyword_indent("end", %w[end])
+          editor_matching_keyword_indent("end", %w[end], line_index)
         when :lua
-          editor_matching_keyword_indent("end", %w[end until])
+          editor_matching_keyword_indent("end", %w[end until], line_index)
         when :shell
-          editor_matching_keyword_indent(nil, SHELL_DEDENT_KEYWORDS)
+          editor_matching_keyword_indent(nil, SHELL_DEDENT_KEYWORDS, line_index)
         when :html
-          editor_matching_html_indent
+          editor_matching_html_indent(line_index)
         end
       end
 
-      def editor_matching_punctuation_indent(text)
+      def editor_matching_punctuation_indent(text, line_index = nil)
         opener = PUNCTUATION_PAIRS[text]
         stack = []
-        editor_previous_code_lines.each do |line|
+        editor_previous_code_lines(line_index).each do |line|
           editor_scan_punctuation_tokens(line[:code]).each do |token|
             if token == opener
               stack << line[:indent]
@@ -449,9 +457,9 @@ module Kward
         stack.last || ""
       end
 
-      def editor_matching_keyword_indent(opener = nil, closers = [])
+      def editor_matching_keyword_indent(opener = nil, closers = [], line_index = nil)
         stack = []
-        editor_previous_code_lines.each do |line|
+        editor_previous_code_lines(line_index).each do |line|
           code = line[:code].strip
           next if code.empty?
 
@@ -461,9 +469,9 @@ module Kward
         stack.last || ""
       end
 
-      def editor_matching_html_indent
+      def editor_matching_html_indent(line_index = nil)
         stack = []
-        editor_previous_code_lines.each do |line|
+        editor_previous_code_lines(line_index).each do |line|
           code = line[:code].strip
           next if code.empty?
 
@@ -473,8 +481,8 @@ module Kward
         stack.last || ""
       end
 
-      def editor_previous_code_lines
-        line_index, = @editor_state.cursor_line_and_column
+      def editor_previous_code_lines(line_index = nil)
+        line_index ||= @editor_state.cursor_line_and_column.first
         @editor_state.lines.first(line_index).filter_map do |line|
           code = editor_indent_code(line, editor_syntax_language).rstrip
           next if code.strip.empty?

data/lib/kward/prompt_interface/editor/modes/vibe.rb

@@ -452,9 +452,10 @@ module Kward
         return true if command.match?(/\A\d*g\z/)
         return true if command.match?(/\A\d*g[uU~]\z/)
         return true if command.match?(/\A\d*z\z/)
-        return true if command.match?(/\A\d*[cdy]\d*\z/)
-        return true if command.match?(/\A\d*[cdy]\d*[ai]\z/)
-        return true if command.match?(/\A\d*[cdy]\d*[fFtT]\z/)
+        return true if command.match?(/\A\d*[=cdy](?:[1-9]\d*)?\z/)
+        return true if command.match?(/\A\d*[=cdy]\d*g\z/)
+        return true if command.match?(/\A\d*[=cdy]\d*[ai]\z/)
+        return true if command.match?(/\A\d*[=cdy]\d*[fFtT]\z/)
         return true if command.match?(/\A\d*[fFtT]\z/)
         return true if command.match?(/\A\d*r\z/)
         return true if command.match?(/\Am\z/)
@@ -635,6 +636,10 @@ module Kward
         when "<<"
           vibe_indent_lines(count, :left)
           vibe_remember_change(command)
+        when "=="
+          vibe_reindent_lines(count, command)
+        when /\A=(.+)\z/
+          vibe_reindent_operator(Regexp.last_match(1), count, command)
         when "p"
           vibe_active_register_linewise? ? vibe_paste_line(:below, original_command) : vibe_paste_after(original_command)
         when "P"
@@ -704,6 +709,8 @@ module Kward
           vibe_indent_visual_selection(:right)
         when "<"
           vibe_indent_visual_selection(:left)
+        when "="
+          vibe_reindent_visual_selection
         when "J"
           vibe_join_visual_selection
         when "~"
@@ -1077,6 +1084,18 @@ module Kward
         vibe_cancel_visual_mode
       end
 
+      def vibe_reindent_visual_selection
+        ranges = @editor_state.selection_ranges
+        return false if ranges.empty?
+
+        start_index = ranges.map(&:first).min
+        end_index = ranges.map(&:last).max
+        start_line, = @editor_state.cursor_line_and_column_for(start_index)
+        end_line, = @editor_state.cursor_line_and_column_for([end_index - 1, start_index].max)
+        vibe_reindent_line_range(start_line, end_line)
+        vibe_cancel_visual_mode
+      end
+
       def vibe_count_and_body(command)
         return [0, "0"] if command == "0"
 
@@ -1284,6 +1303,56 @@ module Kward
         true
       end
 
+      def vibe_reindent_lines(count, command = nil)
+        line, = @editor_state.cursor_line_and_column
+        vibe_reindent_line_range(line, line + count - 1, command)
+      end
+
+      def vibe_reindent_operator(motion, count, command = nil)
+        motion_count, motion = vibe_count_and_body(motion)
+        return vibe_reindent_to_line(motion_count, command) if motion == "G"
+        return vibe_reindent_to_line(motion_count.positive? ? motion_count : 1, command) if motion == "gg"
+        return vibe_reindent_lines(count, command) if motion == "=" || motion == "g_"
+
+        count *= motion_count if motion_count.positive?
+        target = vibe_operator_target(motion, count)
+        return false unless target
+
+        vibe_reindent_target(target, motion, command)
+      end
+
+      def vibe_reindent_to_line(line_count, command)
+        line, = @editor_state.cursor_line_and_column
+        target_line = line_count.positive? ? line_count - 1 : @editor_state.lines.length - 1
+        vibe_reindent_line_range(line, target_line, command)
+      end
+
+      def vibe_reindent_target(target, motion, command)
+        start_line, = @editor_state.cursor_line_and_column_for(target.start_index)
+        end_line = if motion.match?(/\A[ai].\z/)
+                     @editor_state.cursor_line_and_column_for([target.end_index - 1, target.start_index].max).first
+                   else
+                     @editor_state.cursor_line_and_column.first
+                   end
+        vibe_reindent_line_range(start_line, end_line, command)
+      end
+
+      def vibe_reindent_line_range(first_line, last_line, command = nil)
+        start_line, end_line = [first_line, last_line].minmax
+        end_line = [end_line, @editor_state.lines.length - 1].min
+        vibe_record_undo do
+          (start_line..end_line).each do |line_index|
+            next if @editor_state.lines[line_index].to_s.strip.empty?
+
+            editor_reindent_line(line_index, editor_expected_indent_for_line(line_index))
+          end
+        end
+        @editor_state.move_to_line_first_non_blank(end_line)
+        @editor_state.status = "Reindented #{end_line - start_line + 1} line#{end_line == start_line ? "" : "s"}"
+        vibe_remember_change(command) if command
+        true
+      end
+
       def vibe_change_lines(count, command = nil)
         start_index, end_index = vibe_linewise_change_range(count)
         @editor_state.copy_range(start_index, end_index)

data/lib/kward/prompt_interface/layout.rb

@@ -10,10 +10,6 @@ module Kward
         @banner.rows(width, message: message)
       end
 
-      def banner_logo_rows
-        @banner.logo_rows(screen_width)
-      end
-
       def transcript_redraw_row_count(height = screen_height)
         [[@transcript_viewport_rows, transcript_bottom_row(height)].max, height].min
       end

data/lib/kward/prompt_interface/project_browser.rb

@@ -12,6 +12,28 @@ module Kward
       PROJECT_BROWSER_ROOT = "".freeze
       PROJECT_BROWSER_RESULT_LIMIT = 200
       PROJECT_BROWSER_STATE_VERSION = 1
+      PROJECT_BROWSER_FILENAME_ICONS = {
+        ".gitignore" => "",
+        "Gemfile" => "",
+        "Rakefile" => "",
+        "README" => "",
+        "README.md" => "",
+        "package.json" => ""
+      }.freeze
+      PROJECT_BROWSER_EXTENSION_ICONS = {
+        "css" => "",
+        "html" => "",
+        "js" => "",
+        "json" => "",
+        "md" => "",
+        "rb" => "",
+        "sh" => "",
+        "ts" => "",
+        "yaml" => "",
+        "yml" => ""
+      }.freeze
+      PROJECT_BROWSER_DIRECTORY_ICON = ""
+      PROJECT_BROWSER_FILE_ICON = ""
 
       def open_project_browser
         @mutex.synchronize do
@@ -399,8 +421,25 @@ module Kward
                  else
                    "  "
                  end
+        icon = project_browser_icon(row)
         suffix = row[:directory] ? "/" : ""
-        "#{indent}#{marker}#{row[:name]}#{suffix}"
+        "#{indent}#{marker}#{icon}#{row[:name]}#{suffix}"
+      end
+
+      def project_browser_icon(row)
+        return "" unless @project_browser_icon_theme == "nerd-font"
+
+        icon = if row[:directory]
+                 PROJECT_BROWSER_DIRECTORY_ICON
+               else
+                 project_browser_file_icon(row[:path])
+               end
+        "#{icon} "
+      end
+
+      def project_browser_file_icon(path)
+        name = File.basename(path.to_s)
+        PROJECT_BROWSER_FILENAME_ICONS[name] || PROJECT_BROWSER_EXTENSION_ICONS[File.extname(name).delete_prefix(".").downcase] || PROJECT_BROWSER_FILE_ICON
       end
 
       def saved_project_browser_state

data/lib/kward/prompt_interface/question_prompt.rb

@@ -337,11 +337,12 @@ module Kward
 
       def question_overlay_rows(width)
         title = "Question #{@question_state[:index]}/#{@question_state[:total]} · #{@question_state[:header]}"
-        lines = [
-          overlay_text_line(@question_state[:question].to_s, :bold),
+        content_width = [overlay_card_width(width) - 4, 1].max
+        lines = question_text_rows(@question_state[:question], content_width, :bold)
+        lines.concat([
           overlay_text_line("↑/↓ select · Enter choose · Esc cancel", :muted),
           overlay_blank_line
-        ]
+        ])
         question_choices.each_with_index do |choice, index|
           selected = index == question_selection_index
           lines << overlay_choice_line(choice_text(choice, selected: selected), selected: selected)
@@ -349,6 +350,14 @@ module Kward
         overlay_card_rows(title, lines, width)
       end
 
+      def question_text_rows(text, width, style)
+        text.to_s.split("\n", -1).flat_map do |line|
+          wrapped = ANSI.wrap_visible(line, width)
+          wrapped = [""] if wrapped.empty?
+          wrapped.map { |row| overlay_text_line(row, style) }
+        end
+      end
+
       def choice_text(choice, selected: false)
         if choice[:custom]
           selected ? "Type a custom answer below." : "Type something."

data/lib/kward/prompt_interface/runtime_state.rb

@@ -74,6 +74,10 @@ module Kward
         ANSI.colorize(text, *styles, enabled: @color_enabled)
       end
 
+      def normalize_project_browser_icon_theme(value)
+        value.to_s == "nerd-font" ? "nerd-font" : "off"
+      end
+
       def normalize_tab_keybindings(value)
         text = value.to_s.downcase
         return "ctrl" if text == "ctrl"

data/lib/kward/prompt_interface/selection_prompt.rb

@@ -68,7 +68,6 @@ module Kward
         return false unless sequence
 
         code = sequence[:code]
-        modifiers = sequence[:modifiers]
         modifier = sequence[:modifier]
         queue_pending_keys(sequence[:remaining]) if sequence[:remaining] && !sequence[:remaining].empty?
 

data/lib/kward/prompt_interface/transcript_renderer.rb

@@ -40,10 +40,6 @@ module Kward
         @transcript_buffer.append(text.to_s)
       end
 
-      def invalidate_transcript_display_rows_cache
-        @transcript_buffer.invalidate_display_rows_cache
-      end
-
       def ensure_transcript_block_separator_locked
         return if @transcript_buffer.empty? || @transcript_buffer.end_with?("\n\n")
 
@@ -65,10 +61,6 @@ module Kward
         @output_io.print(terminal_newlines(rows.join("\n")))
       end
 
-      def transcript_viewport_text(row_count, width)
-        transcript_viewport_rows(row_count, width).join("\n")
-      end
-
       def transcript_viewport_rows(row_count, width)
         return [] unless row_count.positive?
 
@@ -89,10 +81,6 @@ module Kward
         @transcript_buffer.display_rows(width)
       end
 
-      def transcript_text_display_rows(width)
-        @transcript_buffer.text_display_rows(width)
-      end
-
       def reset_stream_position_from_transcript_locked(width = screen_width)
         @stream_state.reset_position_from_rows(transcript_display_rows(width), width)
       end

data/lib/kward/prompt_interface.rb

@@ -25,6 +25,7 @@ require_relative "prompt_interface/file_overlay"
 require_relative "prompt_interface/project_browser"
 require_relative "prompt_interface/selection_prompt"
 require_relative "prompt_interface/question_prompt"
+require_relative "prompt_interface/approval_prompt"
 require_relative "prompt_interface/git_prompt"
 require_relative "prompt_interface/overlay_renderer"
 require_relative "prompt_interface/editor/renderer"
@@ -75,6 +76,7 @@ module Kward
     include ProjectBrowser
     include SelectionPrompt
     include QuestionPrompt
+    include ApprovalPrompt
     include GitPrompt
     include OverlayRenderer
     include EditorRenderer
@@ -126,7 +128,7 @@ module Kward
       end
     end
 
-    def initialize(input: $stdin, output: $stdout, slash_commands: [], overlay_settings: nil, footer: nil, composer_status: nil, busy_help: true, attachment_badges: nil, attachment_parser: nil, banner_message: nil, tab_keybindings: nil, prompt_history: nil, editor_mode: nil, editor_mode_source: nil, editor_auto_indent: true, editor_auto_indent_source: nil, editor_auto_close_pairs: true, editor_auto_close_pairs_source: nil, editor_soft_wrap: true, editor_soft_wrap_source: nil, editor_bar_cursor: true, editor_bar_cursor_source: nil, editor_line_numbers: "absolute", editor_line_numbers_source: nil, diff_view: "auto", diff_view_source: nil)
+    def initialize(input: $stdin, output: $stdout, slash_commands: [], overlay_settings: nil, project_browser_icon_theme: "off", footer: nil, composer_status: nil, busy_help: true, attachment_badges: nil, attachment_parser: nil, banner_message: nil, tab_keybindings: nil, prompt_history: nil, editor_mode: nil, editor_mode_source: nil, editor_auto_indent: true, editor_auto_indent_source: nil, editor_auto_close_pairs: true, editor_auto_close_pairs_source: nil, editor_soft_wrap: true, editor_soft_wrap_source: nil, editor_bar_cursor: true, editor_bar_cursor_source: nil, editor_line_numbers: "absolute", editor_line_numbers_source: nil, diff_view: "auto", diff_view_source: nil)
       @input_io = input
       @output_io = output
       @reader = TTY::Reader.new(input: input, output: output, interrupt: :error)
@@ -186,6 +188,7 @@ module Kward
       @editor_bar_cursor_active = false
       @synchronized_output_depth = 0
       @overlay_settings = normalize_overlay_settings(overlay_settings)
+      @project_browser_icon_theme = normalize_project_browser_icon_theme(project_browser_icon_theme)
       @footer = footer
       @composer_status = composer_status
       @busy_help = busy_help
@@ -211,6 +214,15 @@ module Kward
       @diff_view_source = diff_view_source
     end
 
+    def update_slash_commands(commands)
+      @mutex.synchronize do
+        @slash_commands = normalize_slash_commands(commands)
+        reset_slash_selection
+        @slash_overlay_dismissed_input = nil
+        render_prompt_locked if @started
+      end
+    end
+
     def start(render: true)
       @mutex.synchronize do
         return if @started
@@ -661,6 +673,13 @@ module Kward
       end
     end
 
+    def update_project_browser_icon_theme(theme)
+      @mutex.synchronize do
+        @project_browser_icon_theme = normalize_project_browser_icon_theme(theme)
+        render_prompt_locked if @started && @asking && project_browser_visible?
+      end
+    end
+
     def begin_busy_input(message = "You>", activity: "streaming")
       start
       @mutex.synchronize do