kward 0.66.0 → 0.67.0

data/lib/kward/session_trash.rb

@@ -0,0 +1,96 @@
+require "open3"
+require "rbconfig"
+
+module Kward
+  # Best-effort session file remover. Uses the OS trash/recycle bin when a
+  # supported platform tool is available, and falls back to permanent deletion.
+  class SessionTrash
+    def initialize(env: ENV, command_runner: nil, host_os: RbConfig::CONFIG["host_os"])
+      @env = env
+      @command_runner = command_runner || method(:run_command)
+      @host_os = host_os
+    end
+
+    def delete(path)
+      return false unless File.exist?(path)
+
+      return true if move_to_trash(path)
+
+      File.delete(path) if File.exist?(path)
+      true
+    end
+
+    private
+
+    def move_to_trash(path)
+      trash_commands.each do |name, command|
+        next unless executable?(name)
+
+        return true if @command_runner.call(command, path) && !File.exist?(path)
+      end
+
+      false
+    end
+
+    def trash_commands
+      if windows?
+        powershell_trash_commands
+      elsif macos?
+        [["osascript", ["osascript", "-e", "on run argv", "-e", "tell application \"Finder\" to delete POSIX file (item 1 of argv)", "-e", "end run"]]]
+      else
+        [
+          ["gio", ["gio", "trash"]],
+          ["trash-put", ["trash-put"]],
+          ["kioclient5", ["kioclient5", "move", nil, "trash:/"]],
+          ["kioclient", ["kioclient", "move", nil, "trash:/"]]
+        ]
+      end
+    end
+
+    def powershell_trash_commands
+      script = <<~POWERSHELL.strip
+        Add-Type -AssemblyName Microsoft.VisualBasic;
+        [Microsoft.VisualBasic.FileIO.FileSystem]::DeleteFile($args[0], 'OnlyErrorDialogs', 'SendToRecycleBin')
+      POWERSHELL
+      [
+        ["pwsh", ["pwsh", "-NoProfile", "-Command", script]],
+        ["powershell", ["powershell", "-NoProfile", "-Command", script]]
+      ]
+    end
+
+    def executable?(name)
+      paths = @env.fetch("PATH", "").split(File::PATH_SEPARATOR)
+      extensions = windows? ? @env.fetch("PATHEXT", ".COM;.EXE;.BAT;.CMD").split(";") : [""]
+      paths.any? do |path|
+        extensions.any? do |extension|
+          candidate = File.join(path, name + extension)
+          File.file?(candidate) && File.executable?(candidate)
+        end
+      end
+    end
+
+    def run_command(command, path)
+      command = if command.include?(nil)
+                  command.map { |part| part || path }
+                else
+                  command + [path]
+                end
+      _stdout, _stderr, status = Open3.capture3(*command)
+      status.success?
+    rescue StandardError
+      false
+    end
+
+    def macos?
+      host_os.match?(/darwin/i)
+    end
+
+    def windows?
+      host_os.match?(/mswin|mingw|cygwin/i)
+    end
+
+    def host_os
+      @host_os
+    end
+  end
+end

data/lib/kward/session_tree_renderer.rb

@@ -0,0 +1,264 @@
+require "json"
+require_relative "message_access"
+require_relative "tools/tool_call"
+
+module Kward
+  class SessionTreeRenderer
+    def initialize(roots:, current_leaf_id:)
+      @roots = roots
+      @current_leaf_id = current_leaf_id
+    end
+
+    def items
+      active_path = session_tree_active_path(@roots, @current_leaf_id)
+      tool_calls_by_id = session_tree_tool_calls(@roots)
+      visible_roots = @roots.flat_map { |root| visible_session_tree_nodes(root) }
+      multiple_roots = visible_roots.length > 1
+      result = []
+
+      walk = lambda do |node, indent, just_branched, show_connector, is_last, gutters, virtual_root_child|
+        entry = node[:source]["entry"] || {}
+        display_indent = multiple_roots ? [indent - 1, 0].max : indent
+        prefix = session_tree_visual_prefix(display_indent, gutters, show_connector && !virtual_root_child, is_last, !node[:children].empty?)
+        result << {
+          entry: entry,
+          label: session_tree_label(entry, node[:source], prefix, active_path.include?(entry["id"].to_s), tool_calls_by_id)
+        }
+
+        children = node[:children].sort_by { |child| session_tree_contains_active_path?(child, active_path) ? 0 : 1 }
+        multiple_children = children.length > 1
+        child_indent = if multiple_children
+                         indent + 1
+                       elsif just_branched && indent.positive?
+                         indent + 1
+                       else
+                         indent
+                       end
+        connector_position = [display_indent - 1, 0].max
+        child_gutters = show_connector && !virtual_root_child ? gutters + [{ position: connector_position, show: !is_last }] : gutters
+
+        children.each_with_index do |child, index|
+          walk.call(child, child_indent, multiple_children, multiple_children, index == children.length - 1, child_gutters, false)
+        end
+      end
+
+      visible_roots.sort_by { |root| session_tree_contains_active_path?(root, active_path) ? 0 : 1 }.each_with_index do |root, index|
+        walk.call(root, multiple_roots ? 1 : 0, multiple_roots, multiple_roots, index == visible_roots.length - 1, [], multiple_roots)
+      end
+
+      result
+    end
+
+    private
+
+    def visible_session_tree_nodes(node)
+      children = Array(node["children"]).flat_map { |child| visible_session_tree_nodes(child) }
+      return children if hidden_session_tree_entry?(node["entry"] || {})
+
+      [{ source: node, children: children }]
+    end
+
+    def hidden_session_tree_entry?(entry)
+      return false if @current_leaf_id && entry["id"].to_s == @current_leaf_id.to_s
+      return false unless entry["type"] == "message"
+
+      message = entry["message"]
+      return false unless message.is_a?(Hash) && message_role(message) == "assistant"
+
+      content = message_content(message)
+      content_tool_calls = content.is_a?(Array) && content.any? { |part| session_tree_content_part_value(part, :type) == "toolCall" }
+      (content_tool_calls && !session_tree_text_content?(content)) || (!message_tool_calls(message).empty? && full_message_text(message).empty?)
+    end
+
+    def session_tree_text_content?(content)
+      Array(content).any? { |part| session_tree_content_part_value(part, :type) == "text" && session_tree_content_part_value(part, :text).to_s.strip != "" }
+    end
+
+    def session_tree_content_part_value(part, key)
+      MessageAccess.value(part, key)
+    end
+
+    def session_tree_label(entry, node, prefix, active_path, tool_calls_by_id)
+      label = node["label"] || entry["resolvedLabel"]
+      label = label.to_s.strip
+      label_text = label.empty? ? "" : "[#{label}] "
+      path_marker = active_path ? "• " : ""
+      "#{prefix}#{path_marker}#{label_text}#{session_tree_entry_display(entry, tool_calls_by_id)}"
+    end
+
+    def session_tree_entry_display(entry, tool_calls_by_id = {})
+      case entry["type"]
+      when "message"
+        message = entry["message"] || {}
+        role = message_role(message).to_s
+        return session_tree_tool_display(message, tool_calls_by_id) if ["tool", "toolResult"].include?(role)
+
+        "#{role.empty? ? 'message' : role}: #{display_message_text(message)}"
+      when "compaction"
+        "compaction: #{display_message_text(entry["message"] || {})}"
+      when "branch_summary"
+        "[branch summary]: #{truncate_session_tree_text(entry["summary"])}"
+      else
+        entry["type"].to_s
+      end
+    end
+
+    def session_tree_visual_prefix(display_indent, gutters, show_connector, is_last, foldable)
+      return "" if display_indent.to_i <= 0
+
+      connector_position = show_connector ? display_indent - 1 : -1
+      (0...(display_indent * 3)).map do |index|
+        level = index / 3
+        position = index % 3
+        gutter = gutters.find { |candidate| candidate[:position] == level }
+
+        if gutter
+          position.zero? && gutter[:show] ? "│" : " "
+        elsif show_connector && level == connector_position
+          if position.zero?
+            is_last ? "└" : "├"
+          elsif position == 1
+            foldable ? "⊟" : "─"
+          else
+            " "
+          end
+        else
+          " "
+        end
+      end.join
+    end
+
+    def session_tree_contains_active_path?(node, active_path)
+      entry_id = (node[:source]["entry"] || {})["id"].to_s
+      active_path.include?(entry_id) || node[:children].any? { |child| session_tree_contains_active_path?(child, active_path) }
+    end
+
+    def session_tree_active_path(roots, leaf_id)
+      by_id = session_tree_entries_by_id(roots)
+      ids = []
+      entry = by_id[leaf_id.to_s]
+      while entry
+        ids << entry["id"].to_s
+        entry = by_id[entry["parentId"].to_s]
+      end
+      ids
+    end
+
+    def session_tree_entries_by_id(roots)
+      roots.each_with_object({}) do |root, map|
+        stack = [root]
+        until stack.empty?
+          node = stack.pop
+          entry = node["entry"] || {}
+          map[entry["id"].to_s] = entry unless entry["id"].to_s.empty?
+          stack.concat(Array(node["children"]))
+        end
+      end
+    end
+
+    def session_tree_tool_calls(roots)
+      roots.each_with_object({}) do |root, tool_calls|
+        stack = [root]
+        until stack.empty?
+          node = stack.pop
+          entry = node["entry"] || {}
+          message = entry["message"]
+          if entry["type"] == "message" && message.is_a?(Hash) && message_role(message) == "assistant"
+            message_tool_calls(message).each { |tool_call| tool_calls[tool_call_id(tool_call).to_s] = tool_call }
+          end
+          stack.concat(Array(node["children"]))
+        end
+      end
+    end
+
+    def session_tree_tool_display(message, tool_calls_by_id)
+      tool_call = tool_calls_by_id[session_tree_message_tool_call_id(message).to_s]
+      return session_tree_format_tool_call(tool_call) if tool_call
+
+      name = session_tree_message_tool_name(message).to_s
+      "[#{name.empty? ? 'tool' : name}]"
+    end
+
+    def session_tree_message_tool_call_id(message)
+      message_tool_call_id(message) || MessageAccess.value(message, :toolCallId)
+    end
+
+    def session_tree_message_tool_name(message)
+      message_name(message) || MessageAccess.value(message, :toolName)
+    end
+
+    def session_tree_format_tool_call(tool_call)
+      name = ToolCall.display_name(tool_call)
+      args = tool_call_args(tool_call)
+      case name
+      when "read"
+        path = args["path"] || args[:path] || args["file_path"] || args[:file_path]
+        offset = args["offset"] || args[:offset]
+        limit = args["limit"] || args[:limit]
+        display = path.to_s
+        if offset || limit
+          start_line = offset || 1
+          end_line = limit ? start_line.to_i + limit.to_i - 1 : nil
+          display += ":#{start_line}#{end_line ? "-#{end_line}" : ""}"
+        end
+        "[read: #{display}]"
+      when "write", "edit"
+        path = args["path"] || args[:path] || args["file_path"] || args[:file_path]
+        "[#{name}: #{path}]"
+      when "bash"
+        command = (args["command"] || args[:command]).to_s.gsub(/[\n\t]/, " ").strip
+        "[bash: #{command.length > 50 ? "#{command.slice(0, 50)}..." : command}]"
+      else
+        serialized = JSON.dump(args)
+        "[#{name}: #{serialized.length > 40 ? "#{serialized.slice(0, 40)}..." : serialized}]"
+      end
+    end
+
+    def display_message_text(message)
+      truncate_session_tree_text(full_message_text(message))
+    end
+
+    def truncate_session_tree_text(text)
+      normalized = text.to_s.gsub(/\s+/, " ").strip
+      normalized.length > 120 ? "#{normalized.slice(0, 117)}..." : normalized
+    end
+
+    def full_message_text(message)
+      content = message_content(message)
+      text = if content.is_a?(Array)
+               content.filter_map { |part| MessageAccess.value(part, :text) }.join("\n")
+             else
+               content.to_s
+             end
+      text.strip
+    end
+
+    def message_role(message)
+      MessageAccess.role(message)
+    end
+
+    def message_content(message)
+      MessageAccess.content(message)
+    end
+
+    def message_name(message)
+      MessageAccess.name(message)
+    end
+
+    def message_tool_call_id(message)
+      MessageAccess.tool_call_id(message)
+    end
+
+    def message_tool_calls(message)
+      MessageAccess.tool_calls(message)
+    end
+
+    def tool_call_id(tool_call)
+      ToolCall.id(tool_call)
+    end
+
+    def tool_call_args(tool_call)
+      ToolCall.arguments(tool_call)
+    end
+  end
+end

data/lib/kward/tools/registry.rb

@@ -69,7 +69,9 @@ module Kward
     end
 
     def build_schema_tools
-      tools = core_tools
+      tools = @tools.values_at(
+        "list_directory", "read_file", "write_file", "edit_file", "run_shell_command", "code_search"
+      )
       tools << @tools["web_search"] if web_search_available?
       tools << @tools["read_skill"] if skills_available?
       tools << @tools["ask_user_question"] if ask_user_question_available?

data/lib/kward/version.rb

@@ -1,4 +1,4 @@
 module Kward
   # Current gem version.
-  VERSION = "0.66.0"
+  VERSION = "0.67.0"
 end

data/lib/kward/workspace.rb

@@ -12,8 +12,9 @@ module Kward
     MAX_EDIT_DIFF_BYTES = 8 * 1024
     DEFAULT_COMMAND_TIMEOUT_SECONDS = 30
 
-    def initialize(root: Dir.pwd, max_file_bytes: MAX_FILE_BYTES, max_read_output_bytes: MAX_READ_OUTPUT_BYTES, max_read_output_lines: MAX_READ_OUTPUT_LINES, max_command_output_bytes: MAX_COMMAND_OUTPUT_BYTES)
+    def initialize(root: Dir.pwd, max_file_bytes: MAX_FILE_BYTES, max_read_output_bytes: MAX_READ_OUTPUT_BYTES, max_read_output_lines: MAX_READ_OUTPUT_LINES, max_command_output_bytes: MAX_COMMAND_OUTPUT_BYTES, guardrails: true)
       @root = Pathname.new(root).realpath
+      @guardrails = guardrails
       @max_file_bytes = max_file_bytes
       @max_read_output_bytes = max_read_output_bytes
       @max_read_output_lines = max_read_output_lines
@@ -124,10 +125,10 @@ module Kward
       target = @root.join(target) unless target.absolute?
 
       expanded = target.expand_path
-      raise SecurityError, "path outside workspace: #{path}" unless inside_workspace?(expanded)
+      raise SecurityError, "path outside workspace: #{path}" if guardrails_enabled? && !inside_workspace?(expanded)
 
       resolved = target.realpath
-      raise SecurityError, "path outside workspace: #{path}" unless inside_workspace?(resolved)
+      raise SecurityError, "path outside workspace: #{path}" if guardrails_enabled? && !inside_workspace?(resolved)
 
       resolved.to_s
     end
@@ -137,16 +138,20 @@ module Kward
       target = @root.join(target) unless target.absolute?
 
       expanded = target.expand_path
-      raise SecurityError, "path outside workspace: #{path}" unless inside_workspace?(expanded)
+      raise SecurityError, "path outside workspace: #{path}" if guardrails_enabled? && !inside_workspace?(expanded)
 
       return workspace_path(path) if File.exist?(expanded) || File.symlink?(expanded)
 
       parent = expanded.dirname.realpath
-      raise SecurityError, "path outside workspace: #{path}" unless inside_workspace?(parent)
+      raise SecurityError, "path outside workspace: #{path}" if guardrails_enabled? && !inside_workspace?(parent)
 
       expanded.to_s
     end
 
+    def guardrails_enabled?
+      @guardrails != false
+    end
+
     def inside_workspace?(path)
       path.to_s == @root.to_s || path.to_s.start_with?("#{@root}/")
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kward
 version: !ruby/object:Gem::Version
-  version: 0.66.0
+  version: 0.67.0
 platform: ruby
 authors:
 - Kai Wood
@@ -132,6 +132,7 @@ files:
 - doc/plugins.md
 - doc/releasing.md
 - doc/rpc.md
+- doc/troubleshooting.md
 - doc/usage.md
 - doc/web-search.md
 - exe/kward
@@ -145,7 +146,9 @@ files:
 - lib/kward/auth/openrouter_api_key.rb
 - lib/kward/cancellation.rb
 - lib/kward/cli.rb
+- lib/kward/cli_transcript_formatter.rb
 - lib/kward/clipboard.rb
+- lib/kward/compaction/file_operation_tracker.rb
 - lib/kward/compactor.rb
 - lib/kward/config_files.rb
 - lib/kward/conversation.rb
@@ -160,6 +163,7 @@ files:
 - lib/kward/model/context_overflow.rb
 - lib/kward/model/context_usage.rb
 - lib/kward/model/model_info.rb
+- lib/kward/model/payloads.rb
 - lib/kward/model/retry_message.rb
 - lib/kward/model/stream_parser.rb
 - lib/kward/pan/index.html.erb
@@ -167,6 +171,7 @@ files:
 - lib/kward/plugin_registry.rb
 - lib/kward/private_file.rb
 - lib/kward/prompt_interface.rb
+- lib/kward/prompt_interface/banner.rb
 - lib/kward/prompts.rb
 - lib/kward/prompts/commands.rb
 - lib/kward/prompts/templates.rb
@@ -176,6 +181,7 @@ files:
 - lib/kward/rpc/config_manager.rb
 - lib/kward/rpc/prompt_bridge.rb
 - lib/kward/rpc/redactor.rb
+- lib/kward/rpc/runtime_payloads.rb
 - lib/kward/rpc/server.rb
 - lib/kward/rpc/session_manager.rb
 - lib/kward/rpc/tool_event_normalizer.rb
@@ -184,6 +190,8 @@ files:
 - lib/kward/rpc/transport.rb
 - lib/kward/session_diff.rb
 - lib/kward/session_store.rb
+- lib/kward/session_trash.rb
+- lib/kward/session_tree_renderer.rb
 - lib/kward/skills/registry.rb
 - lib/kward/starter_pack_installer.rb
 - lib/kward/steering.rb