ruby-claw 0.1.2 → 0.2.0

data/lib/claw/config.rb

@@ -5,7 +5,8 @@ module Claw
   # Set via Claw.configure { |c| ... }.
   class Config
     attr_accessor :memory_pressure, :memory_keep_recent, :compact_model,
-                  :on_compact, :persist_session, :memory_top_k
+                  :on_compact, :persist_session, :memory_top_k,
+                  :tools_dir, :hub_url, :console_port
 
     def initialize
       @memory_pressure = 0.7
@@ -14,6 +15,9 @@ module Claw
       @on_compact = nil
       @persist_session = true
       @memory_top_k = 10
+      @tools_dir = nil   # auto-detect: .ruby-claw/tools/
+      @hub_url = nil     # disabled by default
+      @console_port = 4567
     end
   end
 end

data/lib/claw/console/event_logger.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+require "json"
+require "fileutils"
+
+module Claw
+  module Console
+    # Writes structured JSONL events to .ruby-claw/log/events.jsonl.
+    # Used by the console for real-time observability.
+    # Events are opt-in — silently dropped if log directory doesn't exist.
+    class EventLogger
+      attr_reader :log_path
+
+      def initialize(log_dir)
+        @log_dir = log_dir
+        @log_path = File.join(log_dir, "events.jsonl") if log_dir
+        @mutex = Mutex.new
+      end
+
+      # Emit a structured event.
+      #
+      # @param type [String] event type (e.g., "llm_call_start", "tool_call")
+      # @param data [Hash] event-specific data
+      def emit(type:, data: {})
+        return unless @log_dir && Dir.exist?(@log_dir)
+
+        event = {
+          timestamp: Time.now.iso8601(3),
+          type: type,
+          data: data
+        }
+
+        @mutex.synchronize do
+          File.open(@log_path, "a") { |f| f.puts(JSON.generate(event)) }
+        end
+      rescue => e
+        # Silently drop events on error
+      end
+
+      # Read events since a given timestamp.
+      #
+      # @param since [String, nil] ISO 8601 timestamp (nil = all events)
+      # @return [Array<Hash>] events
+      def tail(since: nil)
+        return [] unless @log_path && File.exist?(@log_path)
+
+        events = []
+        File.foreach(@log_path) do |line|
+          event = JSON.parse(line.strip, symbolize_names: true) rescue next
+          if since.nil? || event[:timestamp] > since
+            events << event
+          end
+        end
+        events
+      end
+
+      # Total event count.
+      def count
+        return 0 unless @log_path && File.exist?(@log_path)
+        File.foreach(@log_path).count
+      end
+
+      # Clear all events.
+      def clear!
+        File.write(@log_path, "") if @log_path && File.exist?(@log_path)
+      end
+    end
+  end
+end

data/lib/claw/console/public/app.js

@@ -0,0 +1,264 @@
+// Claw Console — Client-side application
+(function() {
+  "use strict";
+
+  // --- Utilities ---
+
+  function api(method, path, body) {
+    var opts = { method: method, headers: {} };
+    if (body) {
+      opts.headers["Content-Type"] = "application/json";
+      opts.body = JSON.stringify(body);
+    }
+    return fetch(path, opts).then(function(r) { return r.json(); });
+  }
+
+  function esc(str) {
+    var d = document.createElement("div");
+    d.textContent = str;
+    return d.innerHTML;
+  }
+
+  function timeStr(iso) {
+    if (!iso) return "—";
+    var d = new Date(iso);
+    return d.toLocaleTimeString();
+  }
+
+  // --- Highlight active nav ---
+
+  var path = window.location.pathname;
+  document.querySelectorAll(".nav-link").forEach(function(a) {
+    if (a.getAttribute("href") === path) a.classList.add("active");
+  });
+
+  // --- Dashboard ---
+
+  var statVersion = document.getElementById("stat-version");
+  if (statVersion) {
+    api("GET", "/api/status").then(function(d) {
+      document.getElementById("stat-version").textContent = "v" + d.version;
+      document.getElementById("stat-tools").textContent = d.tool_count;
+      document.getElementById("stat-memories").textContent = d.memory_count;
+      document.getElementById("stat-snapshots").textContent = d.snapshot_count;
+      document.getElementById("stat-events").textContent = d.event_count;
+    });
+  }
+
+  // --- Header status ---
+
+  var headerStatus = document.getElementById("header-status");
+  if (headerStatus) {
+    api("GET", "/api/status").then(function(d) {
+      headerStatus.textContent = "v" + d.version;
+    });
+  }
+
+  // --- Prompt Inspector ---
+
+  var promptArea = document.getElementById("prompt-template");
+  if (promptArea) {
+    api("GET", "/api/prompt").then(function(d) {
+      promptArea.value = d.template || "";
+      var container = document.getElementById("prompt-sections");
+      if (d.sections && d.sections.length) {
+        container.innerHTML = d.sections.map(function(s) {
+          return '<div class="section-item">' + esc(s) + '</div>';
+        }).join("");
+      } else {
+        container.innerHTML = '<p class="muted">No dynamic sections.</p>';
+      }
+    });
+  }
+
+  window.savePrompt = function() {
+    var content = document.getElementById("prompt-template").value;
+    api("POST", "/api/prompt", { content: content }).then(function() {
+      document.getElementById("prompt-status").textContent = "Saved!";
+      setTimeout(function() {
+        document.getElementById("prompt-status").textContent = "";
+      }, 2000);
+    });
+  };
+
+  // --- Monitor (SSE) ---
+
+  var eventStream = document.getElementById("event-stream");
+  if (eventStream) {
+    var eventCount = 0;
+    var source = new EventSource("/api/events");
+
+    source.onmessage = function(e) {
+      var evt = JSON.parse(e.data);
+      var filterEl = document.getElementById("event-filter");
+      var filter = filterEl ? filterEl.value : "";
+      if (filter && !evt.type.startsWith(filter)) return;
+
+      eventCount++;
+      var countEl = document.getElementById("event-count");
+      if (countEl) countEl.textContent = eventCount + " events";
+
+      if (eventCount === 1) eventStream.innerHTML = "";
+
+      var div = document.createElement("div");
+      div.className = "event-item";
+      div.innerHTML =
+        '<span class="event-time">' + timeStr(evt.timestamp) + '</span>' +
+        '<span class="event-type ' + esc(evt.type) + '">' + esc(evt.type) + '</span>' +
+        '<span class="event-data">' + esc(JSON.stringify(evt.data || {})) + '</span>';
+      eventStream.appendChild(div);
+
+      var autoScroll = document.getElementById("auto-scroll");
+      if (autoScroll && autoScroll.checked) {
+        eventStream.scrollTop = eventStream.scrollHeight;
+      }
+    };
+
+    source.onerror = function() {
+      if (eventCount === 0) {
+        eventStream.innerHTML = '<p class="muted">Event stream disconnected. Retrying...</p>';
+      }
+    };
+  }
+
+  // --- Traces ---
+
+  var traceList = document.getElementById("trace-list");
+  if (traceList) {
+    api("GET", "/api/traces").then(function(traces) {
+      if (!traces.length) {
+        traceList.innerHTML = '<p class="muted" style="padding:0.75rem">No traces found.</p>';
+        return;
+      }
+      traceList.innerHTML = traces.map(function(t) {
+        return '<div class="trace-entry" data-id="' + esc(t.id) + '">' +
+          '<div class="trace-entry-id">' + esc(t.id) + '</div>' +
+          '<div class="trace-entry-meta">' + esc(t.modified) + '</div>' +
+          '</div>';
+      }).join("");
+
+      traceList.querySelectorAll(".trace-entry").forEach(function(el) {
+        el.addEventListener("click", function() {
+          traceList.querySelectorAll(".trace-entry").forEach(function(e) { e.classList.remove("active"); });
+          el.classList.add("active");
+          loadTrace(el.dataset.id);
+        });
+      });
+    });
+  }
+
+  function loadTrace(id) {
+    var detail = document.getElementById("trace-detail");
+    detail.innerHTML = '<p class="muted">Loading...</p>';
+    api("GET", "/api/traces/" + encodeURIComponent(id)).then(function(d) {
+      detail.textContent = d.content || "Empty trace.";
+    });
+  }
+
+  // --- Memory ---
+
+  var memoryBody = document.getElementById("memory-body");
+  if (memoryBody) {
+    loadMemories();
+  }
+
+  function loadMemories() {
+    api("GET", "/api/memory").then(function(mems) {
+      var body = document.getElementById("memory-body");
+      if (!mems || !mems.length) {
+        body.innerHTML = '<tr><td colspan="4" class="muted">No memories stored.</td></tr>';
+        return;
+      }
+      body.innerHTML = mems.map(function(m) {
+        return '<tr>' +
+          '<td>' + esc(String(m.id)) + '</td>' +
+          '<td>' + esc(m.content) + '</td>' +
+          '<td>' + esc(m.created_at || "—") + '</td>' +
+          '<td><button class="btn btn-sm btn-danger" onclick="forgetMemory(' + m.id + ')">Forget</button></td>' +
+          '</tr>';
+      }).join("");
+    });
+  }
+
+  window.addMemory = function() {
+    var input = document.getElementById("memory-input");
+    var content = input.value.trim();
+    if (!content) return;
+    api("POST", "/api/memory", { content: content }).then(function() {
+      input.value = "";
+      loadMemories();
+    });
+  };
+
+  window.forgetMemory = function(id) {
+    api("DELETE", "/api/memory/" + id).then(function() { loadMemories(); });
+  };
+
+  // --- Tools ---
+
+  var coreTools = document.getElementById("core-tools");
+  if (coreTools) {
+    api("GET", "/api/tools").then(function(d) {
+      coreTools.innerHTML = (d.core || []).map(function(t) {
+        return '<div class="tool-card"><div><div class="tool-name">' + esc(t.name) + '</div>' +
+          '<div class="tool-desc">' + esc(t.description || "") + '</div></div>' +
+          '<span class="tool-badge loaded">core</span></div>';
+      }).join("") || '<p class="muted">No core tools.</p>';
+
+      var projectTools = document.getElementById("project-tools");
+      projectTools.innerHTML = (d.project || []).map(function(t) {
+        var badge = t.loaded
+          ? '<span class="tool-badge loaded">loaded</span>'
+          : '<button class="btn btn-sm" onclick="loadTool(\'' + esc(t.name) + '\')">Load</button>';
+        return '<div class="tool-card"><div><div class="tool-name">' + esc(t.name) + '</div>' +
+          '<div class="tool-desc">' + esc(t.description || "") + '</div></div>' + badge + '</div>';
+      }).join("") || '<p class="muted">No project tools. Create tools in .ruby-claw/tools/</p>';
+    });
+  }
+
+  window.loadTool = function(name) {
+    api("POST", "/api/tools/load", { name: name }).then(function() {
+      window.location.reload();
+    });
+  };
+
+  // --- Snapshots ---
+
+  var snapshotBody = document.getElementById("snapshot-body");
+  if (snapshotBody) {
+    loadSnapshots();
+  }
+
+  function loadSnapshots() {
+    api("GET", "/api/snapshots").then(function(snaps) {
+      var body = document.getElementById("snapshot-body");
+      if (!snaps || !snaps.length) {
+        body.innerHTML = '<tr><td colspan="4" class="muted">No snapshots.</td></tr>';
+        return;
+      }
+      body.innerHTML = snaps.map(function(s) {
+        return '<tr>' +
+          '<td>#' + esc(String(s.id)) + '</td>' +
+          '<td>' + esc(s.label || "(unlabeled)") + '</td>' +
+          '<td>' + esc(s.timestamp || "—") + '</td>' +
+          '<td><button class="btn btn-sm btn-secondary" onclick="rollbackSnapshot(' + s.id + ')">Rollback</button></td>' +
+          '</tr>';
+      }).join("");
+    });
+  }
+
+  window.createSnapshot = function() {
+    api("POST", "/api/snapshots").then(function() { loadSnapshots(); });
+  };
+
+  window.rollbackSnapshot = function(id) {
+    if (!confirm("Rollback to snapshot #" + id + "?")) return;
+    api("POST", "/api/snapshots/" + id + "/rollback").then(function() { loadSnapshots(); });
+  };
+
+  // --- Experiments (placeholder) ---
+
+  window.newExperiment = function() {
+    alert("Experiment platform coming in Sprint 15.");
+  };
+})();

data/lib/claw/console/public/style.css

@@ -0,0 +1,330 @@
+/* Claw Console — Dark monospace theme */
+:root {
+  --bg: #0d1117;
+  --bg-card: #161b22;
+  --bg-input: #0d1117;
+  --fg: #c9d1d9;
+  --fg-muted: #8b949e;
+  --accent: #58a6ff;
+  --green: #3fb950;
+  --red: #f85149;
+  --orange: #d29922;
+  --border: #30363d;
+  --radius: 6px;
+}
+
+* { box-sizing: border-box; margin: 0; padding: 0; }
+
+body {
+  font-family: "SF Mono", "Fira Code", "Cascadia Code", monospace;
+  font-size: 13px;
+  background: var(--bg);
+  color: var(--fg);
+  line-height: 1.5;
+}
+
+/* Header */
+header {
+  display: flex;
+  align-items: center;
+  gap: 1.5rem;
+  padding: 0.75rem 1.5rem;
+  border-bottom: 1px solid var(--border);
+  background: var(--bg-card);
+}
+
+.logo {
+  font-weight: 700;
+  font-size: 16px;
+  color: var(--accent);
+  letter-spacing: 1px;
+}
+
+nav { display: flex; gap: 0.25rem; }
+
+.nav-link {
+  color: var(--fg-muted);
+  text-decoration: none;
+  padding: 0.35rem 0.65rem;
+  border-radius: var(--radius);
+  transition: background 0.15s, color 0.15s;
+}
+
+.nav-link:hover, .nav-link.active {
+  color: var(--fg);
+  background: var(--border);
+}
+
+.header-status {
+  margin-left: auto;
+  color: var(--fg-muted);
+  font-size: 11px;
+}
+
+/* Main */
+main {
+  max-width: 1200px;
+  margin: 0 auto;
+  padding: 1.5rem;
+}
+
+h1 { font-size: 20px; margin-bottom: 1rem; color: var(--fg); }
+h2 { font-size: 15px; margin: 1.25rem 0 0.5rem; color: var(--fg-muted); }
+
+.muted { color: var(--fg-muted); }
+
+/* Cards */
+.cards {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(160px, 1fr));
+  gap: 0.75rem;
+  margin-bottom: 1.5rem;
+}
+
+.card {
+  background: var(--bg-card);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  padding: 1rem;
+}
+
+.card-label {
+  font-size: 11px;
+  color: var(--fg-muted);
+  text-transform: uppercase;
+  letter-spacing: 0.5px;
+}
+
+.card-value {
+  font-size: 22px;
+  font-weight: 600;
+  margin-top: 0.25rem;
+}
+
+/* Tables */
+.data-table {
+  width: 100%;
+  border-collapse: collapse;
+  margin-top: 0.5rem;
+}
+
+.data-table th, .data-table td {
+  text-align: left;
+  padding: 0.5rem 0.75rem;
+  border-bottom: 1px solid var(--border);
+}
+
+.data-table th {
+  font-size: 11px;
+  color: var(--fg-muted);
+  text-transform: uppercase;
+}
+
+.data-table tr:hover td { background: var(--bg-card); }
+
+/* Buttons */
+.btn {
+  background: var(--accent);
+  color: #000;
+  border: none;
+  padding: 0.4rem 0.85rem;
+  border-radius: var(--radius);
+  cursor: pointer;
+  font-family: inherit;
+  font-size: 12px;
+  font-weight: 600;
+}
+
+.btn:hover { opacity: 0.9; }
+
+.btn-sm { padding: 0.25rem 0.5rem; font-size: 11px; }
+
+.btn-danger { background: var(--red); }
+
+.btn-secondary {
+  background: transparent;
+  color: var(--fg-muted);
+  border: 1px solid var(--border);
+}
+
+/* Inputs */
+.text-input {
+  background: var(--bg-input);
+  color: var(--fg);
+  border: 1px solid var(--border);
+  padding: 0.4rem 0.65rem;
+  border-radius: var(--radius);
+  font-family: inherit;
+  font-size: 13px;
+  width: 300px;
+}
+
+.text-input:focus { outline: none; border-color: var(--accent); }
+
+textarea {
+  background: var(--bg-input);
+  color: var(--fg);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  font-family: inherit;
+  font-size: 13px;
+  width: 100%;
+  padding: 0.75rem;
+  resize: vertical;
+}
+
+textarea:focus { outline: none; border-color: var(--accent); }
+
+/* Prompt */
+.prompt-section { margin-bottom: 1.5rem; }
+
+.prompt-editor { display: flex; flex-direction: column; gap: 0.5rem; }
+
+.section-list .section-item {
+  background: var(--bg-card);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  padding: 0.75rem;
+  margin-bottom: 0.5rem;
+  white-space: pre-wrap;
+  font-size: 12px;
+}
+
+/* Monitor */
+.monitor-controls {
+  display: flex;
+  align-items: center;
+  gap: 1rem;
+  margin-bottom: 1rem;
+  padding: 0.5rem 0;
+}
+
+.monitor-controls select {
+  background: var(--bg-input);
+  color: var(--fg);
+  border: 1px solid var(--border);
+  padding: 0.3rem 0.5rem;
+  border-radius: var(--radius);
+  font-family: inherit;
+  font-size: 12px;
+}
+
+.event-stream, .event-feed {
+  background: var(--bg-card);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  padding: 0.5rem;
+  max-height: 600px;
+  overflow-y: auto;
+}
+
+.event-item {
+  padding: 0.35rem 0.5rem;
+  border-bottom: 1px solid var(--border);
+  font-size: 12px;
+  display: flex;
+  gap: 0.75rem;
+}
+
+.event-item:last-child { border-bottom: none; }
+
+.event-time { color: var(--fg-muted); flex-shrink: 0; width: 85px; }
+
+.event-type {
+  font-weight: 600;
+  flex-shrink: 0;
+  width: 120px;
+}
+
+.event-type.llm_call { color: var(--accent); }
+.event-type.tool_call { color: var(--green); }
+.event-type.snapshot { color: var(--orange); }
+.event-type.trace { color: #bc8cff; }
+
+.event-data { color: var(--fg-muted); overflow: hidden; text-overflow: ellipsis; }
+
+/* Traces */
+.trace-layout {
+  display: grid;
+  grid-template-columns: 280px 1fr;
+  gap: 1rem;
+  min-height: 500px;
+}
+
+.trace-list {
+  background: var(--bg-card);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  overflow-y: auto;
+  max-height: 600px;
+}
+
+.trace-entry {
+  padding: 0.5rem 0.75rem;
+  border-bottom: 1px solid var(--border);
+  cursor: pointer;
+  font-size: 12px;
+}
+
+.trace-entry:hover { background: var(--border); }
+.trace-entry.active { background: var(--border); border-left: 2px solid var(--accent); }
+
+.trace-entry-id { font-weight: 600; }
+.trace-entry-meta { color: var(--fg-muted); font-size: 11px; }
+
+.trace-detail {
+  background: var(--bg-card);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  padding: 1rem;
+  overflow-y: auto;
+  max-height: 600px;
+  white-space: pre-wrap;
+  font-size: 12px;
+}
+
+/* Tools */
+.tools-section { margin-bottom: 1.5rem; }
+
+.tool-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
+  gap: 0.5rem;
+}
+
+.tool-card {
+  background: var(--bg-card);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  padding: 0.75rem;
+  display: flex;
+  justify-content: space-between;
+  align-items: flex-start;
+}
+
+.tool-name { font-weight: 600; font-size: 13px; }
+.tool-desc { color: var(--fg-muted); font-size: 11px; margin-top: 0.2rem; }
+
+.tool-badge {
+  font-size: 10px;
+  padding: 0.15rem 0.4rem;
+  border-radius: 3px;
+  font-weight: 600;
+}
+
+.tool-badge.loaded { background: var(--green); color: #000; }
+.tool-badge.available { background: var(--border); color: var(--fg-muted); }
+
+/* Memory / Snapshot controls */
+.memory-controls, .snapshot-controls, .experiment-controls {
+  display: flex;
+  gap: 0.5rem;
+  align-items: center;
+  margin-bottom: 1rem;
+}
+
+/* Scrollbar */
+::-webkit-scrollbar { width: 6px; }
+::-webkit-scrollbar-track { background: transparent; }
+::-webkit-scrollbar-thumb { background: var(--border); border-radius: 3px; }
+::-webkit-scrollbar-thumb:hover { background: var(--fg-muted); }