kward 0.70.0 → 0.71.0

data/lib/kward/tools/retrieve_tool_output.rb

@@ -0,0 +1,71 @@
+require_relative "base"
+
+# Namespace for the Kward CLI agent runtime.
+module Kward
+  # Model-callable tool wrappers and their argument schemas.
+  module Tools
+    # Retrieves original tool outputs that were compacted out of model context.
+    class RetrieveToolOutput < Base
+      DEFAULT_LIMIT = 120
+
+      # Builds the retrieval tool schema.
+      def initialize
+        super(
+          "retrieve_tool_output",
+          "Retrieve original output from a compacted previous tool result.",
+          properties: {
+            id: { type: "string", description: "Tool output id, for example toolout_abc123." },
+            query: { type: "string", description: "Optional case-insensitive text search within the original output." },
+            offset: { type: "integer", description: "1-indexed line offset for returned output." },
+            limit: { type: "integer", description: "Maximum lines to return; default 120." }
+          },
+          required: ["id"]
+        )
+      end
+
+      # Executes retrieval from the active conversation artifact store.
+      def call(args, conversation, cancellation: nil)
+        cancellation&.raise_if_cancelled!
+        id = argument(args, :id, "").to_s
+        return "Error: id is required" if id.empty?
+
+        artifact = conversation.tool_output_artifacts[id]
+        return "Error: unknown tool output id: #{id}" unless artifact
+
+        content = artifact[:content].to_s
+        query = argument(args, :query, "").to_s
+        lines = query.empty? ? content.split("\n", -1) : matching_lines(content, query)
+        return "No matching lines for #{query.inspect} in #{id}." if lines.empty?
+
+        slice_lines(id, lines, offset: argument(args, :offset), limit: argument(args, :limit), query: query)
+      end
+
+      private
+
+      def matching_lines(content, query)
+        needle = query.downcase
+        content.split("\n", -1).each_with_index.filter_map do |line, index|
+          next unless line.downcase.include?(needle)
+
+          "#{index + 1}: #{line}"
+        end
+      end
+
+      def slice_lines(id, lines, offset:, limit:, query:)
+        start_index = [offset.to_i - 1, 0].max
+        return "Error: offset #{offset} is beyond output (#{lines.length} lines total)" if start_index >= lines.length
+
+        line_limit = limit.to_i.positive? ? limit.to_i : DEFAULT_LIMIT
+        selected = lines[start_index, line_limit] || []
+        header = "[Retrieved tool output #{id}"
+        header << " matching #{query.inspect}" unless query.empty?
+        header << ": lines #{start_index + 1}-#{start_index + selected.length} of #{lines.length}]"
+        output = "#{header}\n#{selected.join("\n")}".rstrip
+        if start_index + selected.length < lines.length
+          output << "\n\n[#{lines.length - start_index - selected.length} more lines. Use offset=#{start_index + selected.length + 1} to continue.]"
+        end
+        output
+      end
+    end
+  end
+end

data/lib/kward/tools/search/web.rb

@@ -619,8 +619,8 @@ module Kward
       return web_config[snake] if web_config.key?(snake)
       return web_config[camel] if web_config.key?(camel)
       return config[prefixed] if config.key?(prefixed)
-      return config[snake] if config.key?(snake)
-      return config[camel] if config.key?(camel)
+      return config[snake] if key.to_s != "provider" && config.key?(snake)
+      return config[camel] if key.to_s != "provider" && config.key?(camel)
 
       nil
     end

data/lib/kward/tools/summarize_file_structure.rb

@@ -0,0 +1,29 @@
+require_relative "base"
+
+# Namespace for the Kward CLI agent runtime.
+module Kward
+  # Model-callable tool wrappers and their argument schemas.
+  module Tools
+    # Returns a compact symbol outline for a workspace source file.
+    class SummarizeFileStructure < Base
+      # Builds the tool schema and stores the execution dependency.
+      def initialize(workspace:)
+        @workspace = workspace
+        super(
+          "summarize_file_structure",
+          "Return a compact outline of classes, modules, methods, and functions in a workspace source file.",
+          properties: {
+            path: { type: "string", description: "Workspace-relative source file path." }
+          },
+          required: ["path"]
+        )
+      end
+
+      # Executes the structure summary tool.
+      def call(args, _conversation, cancellation: nil)
+        cancellation&.raise_if_cancelled!
+        @workspace.summarize_file_structure(argument(args, :path, ""))
+      end
+    end
+  end
+end

data/lib/kward/tools/tool_call.rb

@@ -17,6 +17,8 @@ module Kward
       "run_shell_command" => "bash",
       "list_directory" => "list_directory",
       "code_search" => "code_search",
+      "summarize_file_structure" => "summarize_file_structure",
+      "retrieve_tool_output" => "retrieve_tool_output",
       "web_search" => "web_search",
       "fetch_content" => "fetch_content",
       "fetch_raw" => "fetch_raw",

data/lib/kward/version.rb

@@ -1,5 +1,5 @@
 # Namespace for the Kward CLI agent runtime.
 module Kward
   # Current gem version.
-  VERSION = "0.70.0"
+  VERSION = "0.71.0"
 end

data/lib/kward/workspace.rb

@@ -20,7 +20,7 @@ module Kward
     MAX_FILE_BYTES = 256 * 1024
     MAX_READ_OUTPUT_BYTES = 50 * 1024
     MAX_READ_OUTPUT_LINES = 2_000
-    MAX_COMMAND_OUTPUT_BYTES = 20 * 1024
+    MAX_COMMAND_OUTPUT_BYTES = 128 * 1024
     MAX_EDIT_DIFF_BYTES = 8 * 1024
     DEFAULT_COMMAND_TIMEOUT_SECONDS = 30
 
@@ -64,7 +64,27 @@ module Kward
       content = File.read(resolved)
       return "Error: not a text file: #{path}" if binary_content?(content)
 
-      read_file_slice(content, offset: offset, limit: limit)
+      large_file_outline_response(path, content, offset: offset, limit: limit) || read_file_slice(content, offset: offset, limit: limit)
+    rescue SecurityError, Errno::ENOENT => e
+      "Error: #{e.message}"
+    end
+
+    # Returns a compact outline of recognizable source-code declarations.
+    def summarize_file_structure(path)
+      resolved = workspace_path(path)
+      return "Error: not a file: #{path}" unless File.file?(resolved)
+
+      size = File.size(resolved)
+      return "Error: file too large: #{path} is #{size} bytes; limit is #{@max_file_bytes} bytes" if size > @max_file_bytes
+
+      content = File.read(resolved)
+      return "Error: not a text file: #{path}" if binary_content?(content)
+
+      lines = content.split("\n", -1)
+      outline = source_outline(lines)
+      return "No recognizable source structure found in #{path}." if outline.empty?
+
+      (["# File structure: #{path}", "- Lines: #{lines.length}", "- Bytes: #{content.bytesize}", "", "## Outline"] + outline).join("\n")
     rescue SecurityError, Errno::ENOENT => e
       "Error: #{e.message}"
     end
@@ -196,6 +216,42 @@ module Kward
       Pathname.new(path).relative_path_from(@root).to_s
     end
 
+    def large_file_outline_response(path, content, offset:, limit:)
+      return nil unless offset.nil? && limit.nil?
+      lines = content.split("\n", -1)
+      return nil unless lines.length > @max_read_output_lines || content.bytesize > @max_read_output_bytes
+
+      outline = source_outline(lines)
+      return nil if outline.empty?
+
+      preview_limit = [120, @max_read_output_lines].min
+      preview = lines.first(preview_limit).join("\n")
+      [
+        "File has #{lines.length} lines (#{content.bytesize} bytes). Showing an outline and the first #{preview_limit} lines to reduce model context.",
+        "",
+        "Outline:",
+        outline.join("\n"),
+        "",
+        "First #{preview_limit} lines:",
+        preview,
+        "",
+        "[Use read_file with offset=#{preview_limit + 1} and limit to continue, or request a specific section from the outline.]"
+      ].join("\n")
+    end
+
+    def source_outline(lines)
+      outline = []
+      lines.each_with_index do |line, index|
+        stripped = line.strip
+        next unless stripped.match?(/\A(class|module|def)\s+/) || stripped.match?(/\A(function|async function)\s+/) || stripped.match?(/\A(export\s+)?(class|interface|type)\s+/)
+
+        indent = line[/\A\s*/].to_s.length
+        outline << "line #{index + 1}: #{'  ' * [indent / 2, 6].min}#{stripped}"
+        break if outline.length >= 80
+      end
+      outline
+    end
+
     def read_file_slice(content, offset:, limit:)
       lines = content.split("\n", -1)
       lines = [""] if lines.empty?

data/templates/default/fulldoc/html/css/kward.css

@@ -10,6 +10,13 @@
   --kward-accent: #9caf35;
   --kward-accent-bright: #d2df62;
   --kward-code: #030604;
+  --kward-syntax-comment: #7f8b67;
+  --kward-syntax-constant: #f0bf6a;
+  --kward-syntax-keyword: #d2df62;
+  --kward-syntax-method: #b8d852;
+  --kward-syntax-string: #8fd15b;
+  --kward-syntax-symbol: #ff7f6f;
+  --kward-syntax-variable: #a7c884;
 }
 
 html {
@@ -131,12 +138,31 @@ body.kward-docs::before {
   width: 1px;
 }
 
-.kward-guide-search {
+.kward-guide-search,
+.kward-api-index-link {
   justify-self: end;
+}
+
+.kward-guide-search {
   position: relative;
   width: min(280px, 24vw);
 }
 
+.kward-api-index-link {
+  border: 1px solid rgba(156, 175, 53, 0.42);
+  border-radius: 999px;
+  color: var(--kward-ink);
+  padding: 10px 14px;
+  text-decoration: none;
+  white-space: nowrap;
+}
+
+.kward-api-index-link:hover,
+.kward-api-index-link:focus {
+  background: rgba(156, 175, 53, 0.13);
+  color: var(--kward-accent-bright);
+}
+
 .kward-guide-search input {
   background: rgba(3, 6, 4, 0.72);
   border: 1px solid rgba(156, 175, 53, 0.42);
@@ -328,6 +354,90 @@ body.kward-docs code {
   border-radius: 6px;
 }
 
+body.kward-docs pre.code .comment {
+  color: var(--kward-syntax-comment);
+  font-style: italic;
+}
+
+body.kward-docs pre.code .const,
+body.kward-docs pre.code .constant,
+body.kward-docs #content .summary_desc pre.code .const > .object_link a,
+body.kward-docs #content .docstring pre.code .const > .object_link a {
+  color: var(--kward-syntax-constant);
+}
+
+body.kward-docs pre.code .kw,
+body.kward-docs pre.code .rubyid_require,
+body.kward-docs pre.code .rubyid_extend,
+body.kward-docs pre.code .rubyid_include {
+  color: var(--kward-syntax-keyword);
+  font-weight: 700;
+}
+
+body.kward-docs pre.code .id,
+body.kward-docs #content .summary_desc pre.code .id > .object_link a,
+body.kward-docs #content .docstring pre.code .id > .object_link a {
+  color: var(--kward-syntax-method);
+}
+
+body.kward-docs pre.code .tstring_content,
+body.kward-docs pre.code .heredoc_beg,
+body.kward-docs pre.code .heredoc_end,
+body.kward-docs pre.code .qwords_beg,
+body.kward-docs pre.code .qwords_end,
+body.kward-docs pre.code .qwords_sep,
+body.kward-docs pre.code .words_beg,
+body.kward-docs pre.code .words_end,
+body.kward-docs pre.code .words_sep,
+body.kward-docs pre.code .qsymbols_beg,
+body.kward-docs pre.code .qsymbols_end,
+body.kward-docs pre.code .qsymbols_sep,
+body.kward-docs pre.code .symbols_beg,
+body.kward-docs pre.code .symbols_end,
+body.kward-docs pre.code .symbols_sep,
+body.kward-docs pre.code .tstring,
+body.kward-docs pre.code .dstring,
+body.kward-docs pre.code .regexp,
+body.kward-docs .dregexp {
+  color: var(--kward-syntax-string);
+}
+
+body.kward-docs pre.code .label,
+body.kward-docs pre.code .symbol {
+  color: var(--kward-syntax-symbol);
+}
+
+body.kward-docs pre.code .ivar,
+body.kward-docs pre.code .gvar,
+body.kward-docs pre.code .rubyid_backref,
+body.kward-docs pre.code .rubyid_nth_ref {
+  color: var(--kward-syntax-variable);
+}
+
+body.kward-docs pre.code .op,
+body.kward-docs pre.code .period,
+body.kward-docs pre.code .comma,
+body.kward-docs pre.code .lparen,
+body.kward-docs pre.code .rparen,
+body.kward-docs pre.code .lbrace,
+body.kward-docs pre.code .rbrace,
+body.kward-docs pre.code .lbracket,
+body.kward-docs pre.code .rbracket {
+  color: rgba(239, 232, 208, 0.74);
+}
+
+body.kward-docs pre.code a,
+body.kward-docs pre.code a:visited {
+  text-decoration-color: rgba(210, 223, 98, 0.45);
+  text-decoration-thickness: 1px;
+  text-underline-offset: 2px;
+}
+
+body.kward-docs pre.code a:hover {
+  background: rgba(156, 175, 53, 0.16);
+  color: var(--kward-accent-bright);
+}
+
 body.kward-docs .copy-code-button {
   background: transparent;
   border: 1px solid rgba(156, 175, 53, 0.48);
@@ -364,7 +474,8 @@ body.kward-docs #footer {
   }
 
   .kward-topnav,
-  .kward-guide-search {
+  .kward-guide-search,
+  .kward-api-index-link {
     display: none;
   }
 
@@ -1081,17 +1192,26 @@ body.kward-docs .kward-home #footer {
   border-radius: 12px;
   box-shadow: 0 24px 70px rgba(0, 0, 0, 0.48);
   display: none;
-  gap: 22px;
-  grid-template-columns: repeat(4, minmax(170px, 1fr));
+  gap: 16px;
+  grid-template-columns: repeat(2, minmax(160px, 220px));
   left: 50%;
+  max-width: calc(100vw - 48px);
   opacity: 0;
-  padding: 28px 22px 22px;
+  padding: 20px;
   pointer-events: none;
   position: absolute;
   top: 100%;
   transform: translate(-50%, -8px);
   transition: opacity 140ms ease, transform 140ms ease;
-  width: min(920px, calc(100vw - 48px));
+  width: max-content;
+}
+
+.kward-advanced-nav-dropdown {
+  grid-template-columns: repeat(3, minmax(150px, 200px));
+}
+
+.kward-api-nav-dropdown {
+  grid-template-columns: repeat(2, minmax(170px, 210px));
 }
 
 .kward-nav-dropdown::before {
@@ -1257,6 +1377,134 @@ body.kward-docs .kward-home #footer {
   }
 }
 
+/* YARD's class/method/file list pages use a separate full_list template. */
+.kward-full-list-body .kward-topbar {
+  position: relative;
+}
+
+.kward-full-list-body .kward-page {
+  padding-top: 40px;
+}
+
+.kward-full-list-body #content {
+  background: var(--kward-panel-strong);
+  border: 1px solid var(--kward-border);
+  border-radius: 14px;
+  box-shadow: 0 26px 70px rgba(0, 0, 0, 0.28);
+  padding: 38px;
+}
+
+.kward-full-list-body .fixed_header {
+  background: transparent;
+  height: auto;
+  margin: 0 0 24px;
+  padding: 0;
+  position: static;
+  width: auto;
+}
+
+.kward-full-list-body #full_list_header {
+  color: var(--kward-ink);
+  font-size: clamp(36px, 5vw, 62px);
+  letter-spacing: -0.04em;
+  line-height: 0.98;
+  margin: 0 0 18px;
+  padding: 0;
+}
+
+.kward-full-list-body #full_list_nav {
+  color: var(--kward-muted);
+  font-size: 14px;
+  margin: 0 0 18px;
+}
+
+.kward-full-list-body #full_list_nav a,
+.kward-full-list-body #full_list_nav a:visited {
+  color: var(--kward-accent-bright);
+}
+
+.kward-full-list-body #full_list_nav a:hover {
+  color: #f0f7a0;
+}
+
+.kward-full-list-body #search {
+  color: var(--kward-muted);
+  font-size: 14px;
+  margin: 0;
+  padding: 0;
+  width: auto;
+}
+
+.kward-full-list-body #search input {
+  background: rgba(3, 6, 4, 0.72);
+  border: 1px solid rgba(156, 175, 53, 0.42);
+  border-radius: 999px;
+  color: var(--kward-ink);
+  font: inherit;
+  margin-left: 8px;
+  outline: none;
+  padding: 8px 12px;
+  width: min(260px, 60vw);
+}
+
+.kward-full-list-body #search input:focus {
+  border-color: var(--kward-accent-bright);
+  box-shadow: 0 0 0 3px rgba(156, 175, 53, 0.18);
+}
+
+.kward-full-list-body #full_list {
+  background: rgba(3, 6, 4, 0.42);
+  border: 1px solid rgba(156, 175, 53, 0.22);
+  border-radius: 12px;
+  font-size: 15px;
+  margin: 0;
+  overflow: auto;
+  padding: 8px;
+}
+
+.kward-full-list-body #full_list li {
+  color: var(--kward-muted);
+}
+
+.kward-full-list-body #full_list li.odd,
+.kward-full-list-body #full_list li.even {
+  background: transparent;
+}
+
+.kward-full-list-body #full_list li .item {
+  border-radius: 8px;
+  padding-bottom: 7px;
+  padding-top: 7px;
+}
+
+.kward-full-list-body #full_list .item:hover {
+  background: rgba(156, 175, 53, 0.13);
+}
+
+.kward-full-list-body #full_list a,
+.kward-full-list-body #full_list a:visited {
+  color: var(--kward-ink);
+}
+
+.kward-full-list-body #full_list a:hover {
+  color: var(--kward-accent-bright);
+}
+
+.kward-full-list-body #full_list li.clicked > .item {
+  background: rgba(156, 175, 53, 0.22);
+  color: var(--kward-ink);
+}
+
+.kward-full-list-body #full_list li.clicked > .item a,
+.kward-full-list-body #full_list li.clicked > .item a:visited {
+  color: var(--kward-accent-bright);
+}
+
+.kward-full-list-body #noresults {
+  background: transparent;
+  color: var(--kward-muted);
+}
+
 /* Pages no longer use YARD's iframe/sidebar layout. */
 .kward-page {
   box-sizing: border-box;
@@ -1588,8 +1836,9 @@ body.kward-docs #filecontents table {
   border-collapse: collapse;
   color: var(--kward-ink);
   display: block;
+  max-width: 100%;
   overflow-x: auto;
-  width: 100%;
+  width: fit-content;
 }
 
 body.kward-docs #content th,

data/templates/default/fulldoc/html/full_list.erb

@@ -0,0 +1,107 @@
+<!DOCTYPE html>
+<html <%= "lang=\"#{html_lang}\"" unless html_lang.nil? %>>
+  <head>
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta charset="<%= charset %>">
+    <% stylesheets_full_list.each do |stylesheet| %>
+      <link rel="stylesheet" href="<%= mtime_url(stylesheet) %>" type="text/css" media="screen">
+    <% end %>
+
+    <% javascripts_full_list.each do |javascript| %>
+      <script type="text/javascript" charset="utf-8" src="<%= mtime_url(javascript) %>"></script>
+    <% end %>
+
+    <title><%= @list_title %></title>
+    <base id="base_target" target="_parent">
+  </head>
+  <body class="kward-docs kward-content-body kward-full-list-body">
+    <a href="#content" class="kward-skip-link">Skip to content</a>
+
+    <header class="kward-topbar">
+      <a class="kward-brand" href="index.html">
+        <img class="kward-brand-logo" src="images/kward_logo.png" alt="" aria-hidden="true">
+        <span>
+          <strong>Kward</strong>
+        </span>
+      </a>
+      <button class="kward-nav-toggle" type="button" aria-expanded="false" aria-controls="kward-primary-nav" aria-label="Toggle navigation menu" onclick="document.body.classList.toggle('kward-nav-open'); this.setAttribute('aria-expanded', document.body.classList.contains('kward-nav-open'))">
+        <span class="kward-nav-toggle-bar"></span>
+        <span class="kward-nav-toggle-bar"></span>
+        <span class="kward-nav-toggle-bar"></span>
+        <span class="kward-sr-only">Menu</span>
+      </button>
+      <nav id="kward-primary-nav" class="kward-topnav" aria-label="Primary navigation">
+        <a href="index.html">Home</a>
+        <div class="kward-nav-menu">
+          <a class="kward-nav-menu-link" href="file.README.html">Guides</a>
+          <button class="kward-nav-menu-button" type="button" aria-label="Expand guides" aria-expanded="false">⌄</button>
+          <div class="kward-nav-dropdown">
+            <% guide_groups.each do |title, items| %>
+              <section>
+                <h2><%= h title %></h2>
+                <% items.each do |label, link| %>
+                  <a href="<%= url_for(link) %>"><%= h label %></a>
+                <% end %>
+              </section>
+            <% end %>
+          </div>
+        </div>
+        <div class="kward-nav-menu">
+          <a class="kward-nav-menu-link" href="file.extensibility.html">Advanced</a>
+          <button class="kward-nav-menu-button" type="button" aria-label="Expand advanced guides" aria-expanded="false">⌄</button>
+          <div class="kward-nav-dropdown kward-advanced-nav-dropdown">
+            <% extension_groups.each do |title, items| %>
+              <section>
+                <h2><%= h title %></h2>
+                <% items.each do |label, link| %>
+                  <a href="<%= url_for(link) %>"><%= h label %></a>
+                <% end %>
+              </section>
+            <% end %>
+          </div>
+        </div>
+        <div class="kward-nav-menu active">
+          <a class="kward-nav-menu-link" href="file.api.html">API Docs</a>
+          <button class="kward-nav-menu-button" type="button" aria-label="Expand API docs" aria-expanded="false">⌄</button>
+          <div class="kward-nav-dropdown kward-api-nav-dropdown">
+            <% api_groups.each do |title, items| %>
+              <section>
+                <h2><%= h title %></h2>
+                <% items.each do |label, link| %>
+                  <a href="<%= url_for(link) %>"><%= h label %></a>
+                <% end %>
+              </section>
+            <% end %>
+          </div>
+        </div>
+      </nav>
+      <a class="kward-api-index-link" href="class_list.html">Search API index</a>
+    </header>
+
+    <main class="kward-page">
+      <div id="content" class="kward-content-page kward-api-page">
+        <div class="fixed_header">
+          <h1 id="full_list_header"><%= @list_title %></h1>
+          <div id="full_list_nav">
+            <% menu_lists.each do |list| %>
+              <span><a target="_self" href="<%= url_for_list list[:type] %>">
+                <%= list[:title] %>
+              </a></span>
+            <% end %>
+          </div>
+
+          <div id="search">
+            <label for="search-class">Search:</label>
+            <input id="search-class" type="text">
+          </div>
+        </div>
+
+        <ul id="full_list" class="<%= @list_class || @list_type %>">
+          <%= erb "full_list_#{@list_type}" %>
+        </ul>
+      </div>
+    </main>
+
+    <script type="text/javascript" charset="utf-8" src="js/kward.js"></script>
+  </body>
+</html>