RubyGems - kward - Versions diffs - 0.66.0 - Mend

kward 0.66.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (93) hide show

checksums.yaml +7 -0
data/.yardopts +9 -0
data/CHANGELOG.md +12 -0
data/Gemfile +8 -0
data/Gemfile.lock +90 -0
data/LICENSE +21 -0
data/README.md +101 -0
data/Rakefile +20 -0
data/doc/authentication.md +105 -0
data/doc/code-search.md +56 -0
data/doc/configuration.md +310 -0
data/doc/extensibility.md +186 -0
data/doc/getting-started.md +127 -0
data/doc/memory.md +192 -0
data/doc/plugins.md +223 -0
data/doc/releasing.md +36 -0
data/doc/rpc.md +635 -0
data/doc/usage.md +179 -0
data/doc/web-search.md +28 -0
data/exe/kward +5 -0
data/kward.gemspec +33 -0
data/lib/kward/agent.rb +234 -0
data/lib/kward/ansi.rb +276 -0
data/lib/kward/auth/file.rb +11 -0
data/lib/kward/auth/github_oauth.rb +222 -0
data/lib/kward/auth/openai_oauth.rb +323 -0
data/lib/kward/auth/openrouter_api_key.rb +40 -0
data/lib/kward/cancellation.rb +54 -0
data/lib/kward/cli.rb +2122 -0
data/lib/kward/clipboard.rb +84 -0
data/lib/kward/compactor.rb +998 -0
data/lib/kward/config_files.rb +564 -0
data/lib/kward/conversation.rb +148 -0
data/lib/kward/events.rb +13 -0
data/lib/kward/export_path.rb +28 -0
data/lib/kward/image_attachments.rb +331 -0
data/lib/kward/markdown_transcript.rb +72 -0
data/lib/kward/memory/manager.rb +652 -0
data/lib/kward/message_access.rb +42 -0
data/lib/kward/model/chat_invocation.rb +23 -0
data/lib/kward/model/client.rb +875 -0
data/lib/kward/model/context_overflow.rb +55 -0
data/lib/kward/model/context_usage.rb +104 -0
data/lib/kward/model/model_info.rb +188 -0
data/lib/kward/model/retry_message.rb +11 -0
data/lib/kward/model/stream_parser.rb +205 -0
data/lib/kward/pan/index.html.erb +143 -0
data/lib/kward/pan/server.rb +397 -0
data/lib/kward/plugin_registry.rb +327 -0
data/lib/kward/private_file.rb +18 -0
data/lib/kward/prompt_interface.rb +2437 -0
data/lib/kward/prompts/commands.rb +50 -0
data/lib/kward/prompts/templates.rb +60 -0
data/lib/kward/prompts.rb +58 -0
data/lib/kward/resources/avatar_kward_logo.rb +48 -0
data/lib/kward/resources/pixel_logo.rb +230 -0
data/lib/kward/rpc/auth_manager.rb +265 -0
data/lib/kward/rpc/config_manager.rb +58 -0
data/lib/kward/rpc/prompt_bridge.rb +104 -0
data/lib/kward/rpc/redactor.rb +47 -0
data/lib/kward/rpc/server.rb +639 -0
data/lib/kward/rpc/session_manager.rb +1122 -0
data/lib/kward/rpc/tool_event_normalizer.rb +68 -0
data/lib/kward/rpc/tool_metadata.rb +80 -0
data/lib/kward/rpc/transcript_normalizer.rb +307 -0
data/lib/kward/rpc/transport.rb +58 -0
data/lib/kward/session_diff.rb +125 -0
data/lib/kward/session_store.rb +493 -0
data/lib/kward/skills/registry.rb +76 -0
data/lib/kward/starter_pack_installer.rb +110 -0
data/lib/kward/steering.rb +56 -0
data/lib/kward/telemetry/logger.rb +195 -0
data/lib/kward/telemetry/stats.rb +466 -0
data/lib/kward/tools/ask_user_question.rb +107 -0
data/lib/kward/tools/base.rb +45 -0
data/lib/kward/tools/code_search.rb +65 -0
data/lib/kward/tools/edit_file.rb +41 -0
data/lib/kward/tools/list_directory.rb +21 -0
data/lib/kward/tools/read_file.rb +30 -0
data/lib/kward/tools/read_skill.rb +27 -0
data/lib/kward/tools/registry.rb +117 -0
data/lib/kward/tools/run_shell_command.rb +28 -0
data/lib/kward/tools/search/code.rb +445 -0
data/lib/kward/tools/search/web.rb +747 -0
data/lib/kward/tools/tool_call.rb +87 -0
data/lib/kward/tools/web_search.rb +48 -0
data/lib/kward/tools/write_file.rb +29 -0
data/lib/kward/transcript_export.rb +40 -0
data/lib/kward/version.rb +4 -0
data/lib/kward/workspace.rb +377 -0
data/lib/kward.rb +6 -0
data/lib/main.rb +3 -0
metadata +232 -0

data/lib/kward/pan/index.html.erb ADDED Viewed

@@ -0,0 +1,143 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>Kward Pan Mode</title>
+  <style>
+    :root { color-scheme: light dark; font-family: system-ui, sans-serif; }
+    body { margin: 0; padding: 1rem; max-width: 56rem; margin-inline: auto; }
+    header { margin-bottom: 1rem; }
+    h1 { font-size: 1.35rem; margin: 0 0 .25rem; }
+    .meta { color: #666; font-size: .85rem; overflow-wrap: anywhere; }
+    #transcript { border: 1px solid #9995; border-radius: .5rem; min-height: 45vh; max-height: 65vh; overflow-y: auto; padding: .75rem; background: #7771; }
+    .entry { margin: 0 0 .75rem; white-space: pre-wrap; overflow-wrap: anywhere; }
+    .label { font-weight: 700; margin-bottom: .15rem; }
+    .user .label { color: #2f6fca; }
+    .assistant .label { color: #14833b; }
+    .tool .label { color: #9b4ab8; }
+    .reasoning .label { color: #9a6b00; }
+    form { position: sticky; bottom: 0; background: Canvas; padding-top: .75rem; margin-top: .75rem; }
+    textarea { box-sizing: border-box; width: 100%; min-height: 7rem; font: inherit; padding: .65rem; border-radius: .5rem; border: 1px solid #999; }
+    .controls { display: flex; gap: .5rem; align-items: center; margin-top: .5rem; }
+    button { font: inherit; padding: .6rem .9rem; border-radius: .45rem; border: 1px solid #777; }
+    #status { color: #666; font-size: .9rem; }
+    @media (max-width: 600px) {
+      body { padding: .65rem; }
+      #transcript { max-height: 58vh; }
+      .controls { align-items: stretch; flex-direction: column; }
+      button { width: 100%; }
+    }
+  </style>
+</head>
+<body>
+  <header>
+    <h1>Kward Pan Mode</h1>
+    <div class="meta">Workspace: <%= ERB::Util.html_escape(@workspace_root) %></div>
+    <div class="meta">Session: <%= ERB::Util.html_escape(@session_path) %></div>
+  </header>
+  <main id="transcript" aria-live="polite"></main>
+  <form id="prompt-form">
+    <label for="prompt">Prompt</label>
+    <textarea id="prompt" name="prompt" autocomplete="off" placeholder="Give Kward an order..."></textarea>
+    <div class="controls">
+      <button type="submit">Send</button>
+      <span id="status">Connecting…</span>
+    </div>
+  </form>
+  <script>
+    const transcript = document.getElementById('transcript');
+    const form = document.getElementById('prompt-form');
+    const promptBox = document.getElementById('prompt');
+    const statusEl = document.getElementById('status');
+    let currentAssistant = null;
+    let currentReasoning = null;
+    function entry(role, label, text) {
+      const node = document.createElement('section');
+      node.className = `entry ${role}`;
+      const labelNode = document.createElement('div');
+      labelNode.className = 'label';
+      labelNode.textContent = label;
+      const textNode = document.createElement('div');
+      textNode.className = 'text';
+      textNode.textContent = text || '';
+      node.append(labelNode, textNode);
+      transcript.appendChild(node);
+      transcript.scrollTop = transcript.scrollHeight;
+      return textNode;
+    }
+    function setStatus(payload) {
+      const queued = payload && Number(payload.queued || 0);
+      const active = payload && payload.active;
+      statusEl.textContent = active ? `Working${queued ? ` — ${queued} queued` : ''}` : (queued ? `${queued} queued` : 'Ready');
+    }
+    function resetStreamBlocks() {
+      currentAssistant = null;
+      currentReasoning = null;
+    }
+    fetch('/transcript')
+      .then(response => response.json())
+      .then(data => {
+        (data.transcript || []).forEach(item => entry(item.role || 'system', item.label || item.role || 'Message', item.text || ''));
+      })
+      .catch(error => entry('tool', 'Error', error.message));
+    const events = new EventSource('/events');
+    events.addEventListener('ready', event => setStatus(JSON.parse(event.data)));
+    events.addEventListener('queue', event => setStatus(JSON.parse(event.data)));
+    events.addEventListener('turn_started', event => { resetStreamBlocks(); setStatus(JSON.parse(event.data)); });
+    events.addEventListener('turn_finished', event => { resetStreamBlocks(); setStatus(JSON.parse(event.data)); });
+    events.addEventListener('user', event => entry('user', 'You', JSON.parse(event.data).text));
+    events.addEventListener('reasoning_delta', event => {
+      if (!currentReasoning) currentReasoning = entry('reasoning', 'Reasoning', '');
+      currentReasoning.textContent += JSON.parse(event.data).delta;
+      transcript.scrollTop = transcript.scrollHeight;
+    });
+    events.addEventListener('assistant_delta', event => {
+      if (!currentAssistant) currentAssistant = entry('assistant', 'Assistant', '');
+      currentAssistant.textContent += JSON.parse(event.data).delta;
+      transcript.scrollTop = transcript.scrollHeight;
+    });
+    events.addEventListener('tool_call', event => {
+      const data = JSON.parse(event.data);
+      entry('tool', 'Tool', `${data.name} ${JSON.stringify(data.args || {})}`);
+    });
+    events.addEventListener('tool_result', event => {
+      const data = JSON.parse(event.data);
+      entry('tool', 'Tool output', `${data.name}: ${data.content}`);
+    });
+    events.addEventListener('answer', event => {
+      if (!currentAssistant) entry('assistant', 'Assistant', JSON.parse(event.data).content);
+    });
+    events.addEventListener('retry', event => entry('tool', 'Retry', JSON.parse(event.data).message));
+    events.addEventListener('error', event => entry('tool', 'Error', JSON.parse(event.data).message));
+    events.onerror = () => { statusEl.textContent = 'Disconnected'; };
+    form.addEventListener('submit', async event => {
+      event.preventDefault();
+      const prompt = promptBox.value;
+      if (!prompt.trim()) return;
+      promptBox.value = '';
+      try {
+        const response = await fetch('/turn', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ prompt })
+        });
+        const data = await response.json();
+        if (!data.ok) entry('tool', 'Error', data.error || 'Prompt was not accepted.');
+        setStatus(data);
+      } catch (error) {
+        entry('tool', 'Error', error.message);
+      }
+    });
+  </script>
+</body>
+</html>

data/lib/kward/pan/server.rb ADDED Viewed

@@ -0,0 +1,397 @@
+require "base64"
+require "erb"
+require "json"
+require "socket"
+require "thread"
+require "time"
+require "uri"
+require_relative "../agent"
+require_relative "../config_files"
+require_relative "../events"
+require_relative "../model/retry_message"
+require_relative "../rpc/transcript_normalizer"
+require_relative "../session_store"
+require_relative "../tools/tool_call"
+require_relative "../tools/registry"
+require_relative "../workspace"
+module Kward
+  class PanServer
+    DEFAULT_HOST = "0.0.0.0"
+    DEFAULT_PORT = 8765
+    MAX_REQUEST_BODY_BYTES = 64 * 1024
+    def initialize(client:, working_directory:, config: ConfigFiles.read_config, config_dir: ConfigFiles.config_dir, output: $stderr)
+      @client = client
+      @output = output
+      @workspace = Workspace.new(root: working_directory)
+      @config = pan_config(config)
+      @host = @config.fetch("host", DEFAULT_HOST).to_s
+      @port = positive_port(@config.fetch("port", DEFAULT_PORT))
+      @username = @config["username"].to_s
+      @password = @config["password"].to_s
+      raise "Pan mode requires pan_mode.username and pan_mode.password in #{ConfigFiles.config_path}" if @username.empty? || @password.empty?
+      @session_store = SessionStore.new(config_dir: config_dir, cwd: @workspace.root.to_s)
+      @session = @session_store.create
+      @conversation = Conversation.new(
+        workspace_root: @workspace.root.to_s,
+        model: (@client.current_model if @client.respond_to?(:current_model)),
+        reasoning_effort: (@client.current_reasoning_effort if @client.respond_to?(:current_reasoning_effort))
+      )
+      @session.attach(@conversation)
+      @agent = Agent.new(
+        client: @client,
+        tool_registry: ToolRegistry.new(workspace: @workspace, ask_user_question_enabled: false),
+        conversation: @conversation
+      )
+      @prompt_queue = Queue.new
+      @subscribers = []
+      @subscribers_mutex = Mutex.new
+      @worker_started = false
+      @active = false
+      @state_mutex = Mutex.new
+    end
+    attr_reader :host, :port, :session, :workspace
+    def run
+      start_worker
+      @server = TCPServer.new(@host, @port)
+      actual_port = @server.addr[1]
+      @output.puts "Kward pan mode listening on http://#{display_host}:#{actual_port}"
+      @output.puts "Workspace: #{@workspace.root}"
+      @output.puts "Session: #{@session.path}"
+      loop do
+        socket = @server.accept
+        Thread.new(socket) { |client_socket| handle_client(client_socket) }
+      end
+    rescue Interrupt
+      @output.puts "\nPan mode stopped."
+    ensure
+      stop
+    end
+    def stop
+      @server&.close unless @server&.closed?
+    rescue IOError
+      nil
+    end
+    def enqueue_prompt(prompt)
+      text = prompt.to_s
+      return { ok: false, error: "Prompt is required" } if text.strip.empty?
+      queued_at = Time.now.utc.iso8601(3)
+      @prompt_queue << { prompt: text, queued_at: queued_at }
+      broadcast("queue", queue_payload)
+      { ok: true, queued: @prompt_queue.size, active: active? }
+    end
+    def transcript_items
+      RPC::TranscriptNormalizer.new(@conversation.messages).normalize.flat_map { |message| pan_transcript_items(message) }
+    end
+    private
+    def start_worker
+      return if @worker_started
+      @worker_started = true
+      @worker_thread = Thread.new do
+        loop do
+          item = @prompt_queue.pop
+          run_prompt(item[:prompt])
+        end
+      end
+    end
+    def run_prompt(prompt)
+      set_active(true)
+      broadcast("user", { text: prompt })
+      broadcast("turn_started", queue_payload)
+      @agent.ask(prompt) do |event|
+        case event
+        when Events::ReasoningDelta
+          broadcast("reasoning_delta", { delta: event.delta.to_s })
+        when Events::AssistantDelta
+          broadcast("assistant_delta", { delta: event.delta.to_s })
+        when Events::Retry
+          broadcast("retry", { message: retry_message(event) })
+        when Events::ToolCall
+          broadcast("tool_call", tool_call_payload(event.tool_call))
+        when Events::ToolResult
+          broadcast("tool_result", tool_result_payload(event.tool_call, event.content))
+        when Events::Answer
+          broadcast("answer", { content: event.content.to_s })
+        end
+      end
+      broadcast("turn_finished", queue_payload.merge(status: "completed"))
+    rescue StandardError => e
+      broadcast("error", { message: e.message })
+      broadcast("turn_finished", queue_payload.merge(status: "failed"))
+    ensure
+      set_active(false)
+      broadcast("queue", queue_payload)
+    end
+    def handle_client(socket)
+      request = read_request(socket)
+      return unless request
+      unless authorized?(request[:headers])
+        write_response(socket, 401, { "WWW-Authenticate" => 'Basic realm="Kward pan mode"' }, "Unauthorized\n")
+        return
+      end
+      case [request[:method], request[:path]]
+      when ["GET", "/"]
+        write_response(socket, 200, { "Content-Type" => "text/html; charset=utf-8" }, render_index)
+      when ["GET", "/transcript"]
+        write_json(socket, 200, transcript: transcript_items, session: { id: @session.id, path: @session.path }, workspace: @workspace.root.to_s)
+      when ["GET", "/events"]
+        stream_events(socket)
+      when ["POST", "/turn"]
+        handle_turn(socket, request[:body])
+      else
+        write_response(socket, 404, { "Content-Type" => "text/plain; charset=utf-8" }, "Not found\n")
+      end
+    rescue StandardError => e
+      write_response(socket, 500, { "Content-Type" => "text/plain; charset=utf-8" }, "Error: #{e.message}\n") rescue nil
+    ensure
+      socket.close unless socket.closed?
+    end
+    def read_request(socket)
+      request_line = socket.gets
+      return nil unless request_line
+      method, target, = request_line.split(" ", 3)
+      headers = {}
+      while (line = socket.gets)
+        line = line.chomp
+        break if line.empty?
+        name, value = line.split(":", 2)
+        headers[name.downcase] = value.to_s.strip if name
+      end
+      length = headers.fetch("content-length", "0").to_i
+      raise "Request body too large" if length > MAX_REQUEST_BODY_BYTES
+      body = length.positive? ? socket.read(length).to_s : ""
+      path = URI.parse(target.to_s).path
+      { method: method.to_s.upcase, path: path, headers: headers, body: body }
+    end
+    def authorized?(headers)
+      value = headers["authorization"].to_s
+      return false unless value.start_with?("Basic ")
+      expected = Base64.strict_encode64("#{@username}:#{@password}")
+      secure_compare(value.delete_prefix("Basic "), expected)
+    end
+    def secure_compare(left, right)
+      left = left.to_s
+      right = right.to_s
+      return false unless left.bytesize == right.bytesize
+      left.bytes.zip(right.bytes).reduce(0) { |memo, pair| memo | (pair[0] ^ pair[1]) }.zero?
+    end
+    def handle_turn(socket, body)
+      params = JSON.parse(body.empty? ? "{}" : body)
+      result = enqueue_prompt(params["prompt"])
+      status = result[:ok] ? 202 : 422
+      write_json(socket, status, result)
+    rescue JSON::ParserError
+      write_json(socket, 400, ok: false, error: "Invalid JSON")
+    end
+    def stream_events(socket)
+      subscriber = Queue.new
+      subscribe(subscriber)
+      socket.write "HTTP/1.1 200 OK\r\n"
+      socket.write "Content-Type: text/event-stream\r\n"
+      socket.write "Cache-Control: no-cache\r\n"
+      socket.write "Connection: keep-alive\r\n\r\n"
+      socket.write sse("ready", queue_payload)
+      socket.flush
+      loop do
+        socket.write subscriber.pop
+        socket.flush
+      end
+    rescue IOError, Errno::EPIPE, Errno::ECONNRESET
+      nil
+    ensure
+      unsubscribe(subscriber)
+    end
+    def subscribe(queue)
+      @subscribers_mutex.synchronize { @subscribers << queue }
+    end
+    def unsubscribe(queue)
+      @subscribers_mutex.synchronize { @subscribers.delete(queue) }
+    end
+    def broadcast(event, payload)
+      message = sse(event, payload)
+      @subscribers_mutex.synchronize do
+        @subscribers.each { |subscriber| subscriber << message }
+      end
+    end
+    def sse(event, payload)
+      "event: #{event}\ndata: #{JSON.generate(payload)}\n\n"
+    end
+    def write_json(socket, status, payload)
+      write_response(socket, status, { "Content-Type" => "application/json; charset=utf-8" }, JSON.generate(payload))
+    end
+    def write_response(socket, status, headers, body)
+      body = body.to_s
+      socket.write "HTTP/1.1 #{status} #{reason_phrase(status)}\r\n"
+      headers.each { |name, value| socket.write "#{name}: #{value}\r\n" }
+      socket.write "Content-Length: #{body.bytesize}\r\n"
+      socket.write "Connection: close\r\n\r\n"
+      socket.write body
+    end
+    def render_index
+      @workspace_root = @workspace.root.to_s
+      @session_path = @session.path
+      template = File.read(File.join(__dir__, "index.html.erb"))
+      ERB.new(template).result(binding)
+    end
+    def pan_config(config)
+      values = config["pan_mode"] || config["panMode"]
+      values.is_a?(Hash) ? values : {}
+    end
+    def positive_port(value)
+      port = value.to_i
+      port.positive? ? port : DEFAULT_PORT
+    end
+    def display_host
+      @host == "0.0.0.0" ? "<lan-address>" : @host
+    end
+    def set_active(value)
+      @state_mutex.synchronize { @active = value }
+    end
+    def active?
+      @state_mutex.synchronize { @active }
+    end
+    def queue_payload
+      { queued: @prompt_queue.size, active: active? }
+    end
+    def retry_message(event)
+      RetryMessage.format(event)
+    end
+    def tool_call_payload(tool_call)
+      { name: tool_call_name(tool_call), args: tool_call_args(tool_call) }
+    end
+    def tool_result_payload(tool_call, content)
+      { name: tool_call_name(tool_call), content: content.to_s }
+    end
+    def pan_transcript_items(message)
+      case message[:role] || message["role"]
+      when "user"
+        [{ role: "user", label: "You", text: normalized_content_text(message[:content] || message["content"]) }]
+      when "assistant"
+        assistant_items(message[:content] || message["content"])
+      when "toolResult"
+        [{ role: "tool", label: "Tool output", text: tool_result_text(message) }]
+      when "compactionSummary"
+        [{ role: "system", label: "Compaction summary", text: message[:summary] || message["summary"] }]
+      else
+        text = normalized_content_text(message[:content] || message["content"])
+        text.empty? ? [] : [{ role: (message[:role] || message["role"]).to_s, label: message[:role] || message["role"] || "Message", text: text }]
+      end
+    end
+    def assistant_items(content)
+      Array(content).filter_map do |part|
+        next unless part.is_a?(Hash)
+        case part[:type] || part["type"]
+        when "thinking"
+          text = part[:thinking] || part["thinking"]
+          text.to_s.empty? ? nil : { role: "reasoning", label: "Reasoning", text: text }
+        when "text"
+          text = part[:text] || part["text"]
+          text.to_s.empty? ? nil : { role: "assistant", label: "Assistant", text: text }
+        when "image"
+          { role: "assistant", label: "Assistant", text: image_part_text(part) }
+        when "toolCall"
+          { role: "tool", label: "Tool", text: tool_call_part_text(part) }
+        end
+      end
+    end
+    def normalized_content_text(content)
+      Array(content).filter_map do |part|
+        next part.to_s unless part.is_a?(Hash)
+        case part[:type] || part["type"]
+        when "text"
+          part[:text] || part["text"]
+        when "image"
+          image_part_text(part)
+        when "thinking"
+          part[:thinking] || part["thinking"]
+        end
+      end.join("\n")
+    end
+    def image_part_text(part)
+      alt = part[:alt] || part["alt"]
+      media_type = part[:mimeType] || part["mimeType"] || "image"
+      "[#{media_type}#{alt.to_s.empty? ? "" : ": #{alt}"}]"
+    end
+    def tool_call_part_text(part)
+      name = part[:name] || part["name"] || "unknown_tool"
+      arguments = part[:arguments] || part["arguments"] || {}
+      "#{name} #{JSON.generate(arguments)}"
+    end
+    def tool_result_text(message)
+      name = message[:toolName] || message["toolName"] || "tool"
+      content = normalized_content_text(message[:content] || message["content"])
+      "#{name}: #{content}"
+    end
+    def tool_call_name(tool_call)
+      ToolCall.name(tool_call) || "unknown_tool"
+    end
+    def tool_call_args(tool_call)
+      ToolCall.arguments(tool_call)
+    end
+    def reason_phrase(status)
+      case status
+      when 200 then "OK"
+      when 202 then "Accepted"
+      when 400 then "Bad Request"
+      when 401 then "Unauthorized"
+      when 404 then "Not Found"
+      when 422 then "Unprocessable Content"
+      else "Internal Server Error"
+      end
+    end
+  end
+end