ruby-claw 0.1.2 → 0.2.0

data/lib/claw/tui/status_panel.rb

@@ -0,0 +1,133 @@
+# frozen_string_literal: true
+
+module Claw
+  module TUI
+    # Right panel: Binding, Snapshots, Memory, Tokens, Status sections.
+    module StatusPanel
+      def self.render(model, width, height)
+        sections = []
+
+        sections << render_binding(model, width - 4)
+        sections << render_snapshots(model, width - 4)
+        sections << render_memory(model, width - 4)
+        sections << render_tokens(model, width - 4)
+        sections << render_status(model, width - 4)
+
+        content = sections.join("\n")
+        Styles::PANEL_BORDER.width(width).height(height).render(content)
+      end
+
+      def self.render_binding(model, width)
+        header = Styles::SECTION_HEADER.render("Binding")
+        return "#{header}\n  (no runtime)" unless model.runtime
+
+        binding_res = model.runtime.resources["binding"]
+        return "#{header}\n  (not tracked)" unless binding_res
+
+        lines = [header]
+        binding_res.tracked.each do |name, blob|
+          val = begin
+            v = MarshalMd.load(blob)
+            "#{v.class} (#{summary_value(v)})"
+          rescue
+            "?"
+          end
+          line = "  #{name}: #{val}"
+          lines << truncate(line, width)
+        end
+        lines << "  (empty)" if binding_res.tracked.empty?
+        lines.join("\n")
+      end
+
+      def self.render_snapshots(model, width)
+        header = Styles::SECTION_HEADER.render("Snapshots")
+        return "#{header}\n  (none)" unless model.runtime
+
+        snaps = model.runtime.snapshots.last(5)
+        lines = [header]
+        snaps.reverse_each do |s|
+          lines << "  [#{s.id}] #{s.label || '(unlabeled)'}"
+        end
+        lines << "  (none)" if snaps.empty?
+        lines.join("\n")
+      end
+
+      def self.render_memory(model, width)
+        header = Styles::SECTION_HEADER.render("Memory")
+        memory = Claw.memory
+        unless memory
+          return "#{header}\n  (disabled)"
+        end
+
+        count = memory.long_term.size
+        lines = [header, "  #{count} facts"]
+        memory.long_term.last(3).each do |m|
+          lines << "  · #{truncate(m[:content].to_s, width - 4)}"
+        end
+        lines.join("\n")
+      end
+
+      def self.render_tokens(model, width)
+        header = Styles::SECTION_HEADER.render("Tokens")
+        ctx = Mana::Context.current
+        used = ctx.token_count
+        limit = Mana.config.context_window
+        pct = limit > 0 ? (used.to_f / limit * 100).round(1) : 0
+
+        bar_width = [width - 12, 10].max
+        filled = (bar_width * pct / 100.0).round
+        bar = "▓" * filled + "░" * (bar_width - filled)
+
+        lines = [header]
+        lines << "  session: #{format_tokens(used)}/#{format_tokens(limit)}"
+        lines << "  #{bar} #{pct}%"
+        lines.join("\n")
+      end
+
+      def self.render_status(model, width)
+        header = Styles::SECTION_HEADER.render("Status")
+        return "#{header}\n  (no runtime)" unless model.runtime
+
+        state = model.runtime.state
+        icon = case state
+               when :idle then "●"
+               when :thinking then "◉"
+               when :executing_tool then "⚡"
+               when :failed then "✗"
+               else "?"
+               end
+
+        lines = [header, "  #{icon} #{state}"]
+        if model.runtime.current_step
+          step = model.runtime.current_step
+          lines << "  #{step.tool_name}(#{step.target})"
+        end
+        lines.join("\n")
+      end
+
+      # --- Helpers ---
+
+      def self.summary_value(v)
+        case v
+        when Array then v.size.to_s
+        when Hash then "#{v.size} keys"
+        when String then v.length > 20 ? "#{v.length} chars" : v.inspect
+        else v.inspect[0, 20]
+        end
+      end
+
+      def self.format_tokens(n)
+        return "#{n}" if n < 1000
+        "#{(n / 1000.0).round(1)}k"
+      end
+
+      def self.truncate(str, max)
+        str.length > max ? "#{str[0, max - 3]}..." : str
+      end
+
+      private_class_method :render_binding, :render_snapshots, :render_memory,
+                           :render_tokens, :render_status,
+                           :summary_value, :format_tokens, :truncate
+    end
+  end
+end

data/lib/claw/tui/styles.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require "lipgloss"
+
+module Claw
+  module TUI
+    # Centralized color and style definitions for the TUI.
+    module Styles
+      # Colors
+      CYAN       = "#00BFFF"
+      YELLOW     = "#FFD700"
+      GREEN      = "#32CD32"
+      RED        = "#FF4444"
+      MAGENTA    = "#FF69B4"
+      DIM_GRAY   = "#666666"
+      BORDER     = "#444444"
+      BG_DARK    = "#1A1A2E"
+
+      # Status bar (top)
+      STATUS_BAR = Lipgloss::Style.new
+        .foreground(CYAN)
+        .background("#1A1A2E")
+        .bold(true)
+        .padding(0, 1)
+
+      # Chat panel styles
+      USER_STYLE = Lipgloss::Style.new.foreground(CYAN).bold(true)
+      AGENT_STYLE = Lipgloss::Style.new.foreground(YELLOW)
+      TOOL_STYLE = Lipgloss::Style.new.foreground(DIM_GRAY).faint(true)
+      RESULT_STYLE = Lipgloss::Style.new.foreground(GREEN).faint(true)
+      ERROR_STYLE = Lipgloss::Style.new.foreground(RED)
+      RUBY_STYLE = Lipgloss::Style.new.foreground(MAGENTA)
+
+      # Panel borders
+      PANEL_BORDER = Lipgloss::Style.new
+        .border(:rounded)
+        .border_foreground(BORDER)
+        .padding(0, 1)
+
+      # Right panel section headers
+      SECTION_HEADER = Lipgloss::Style.new
+        .foreground(CYAN)
+        .bold(true)
+
+      # Command bar (bottom)
+      COMMAND_BAR = Lipgloss::Style.new
+        .foreground(DIM_GRAY)
+        .padding(0, 1)
+
+      # Spinner style
+      SPINNER_STYLE = Lipgloss::Style.new.foreground(YELLOW)
+
+      # Progress bar colors
+      PROGRESS_FULL = GREEN
+      PROGRESS_EMPTY = DIM_GRAY
+    end
+  end
+end

data/lib/claw/tui/tui.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+require "bubbletea"
+require "lipgloss"
+require "bubbles"
+
+require_relative "styles"
+require_relative "messages"
+require_relative "status_bar"
+require_relative "chat_panel"
+require_relative "status_panel"
+require_relative "command_bar"
+require_relative "layout"
+require_relative "agent_executor"
+require_relative "input_handler"
+require_relative "object_explorer"
+require_relative "file_card"
+require_relative "folding"
+require_relative "model"
+
+module Claw
+  module TUI
+    # Start the TUI application.
+    #
+    # @param caller_binding [Binding] the caller's binding for variable access
+    def self.start(caller_binding)
+      # Load session state
+      load_session(caller_binding)
+
+      model = Model.new(caller_binding)
+      Bubbletea.run(model, alt_screen: true)
+    end
+
+    # --- Session loading (extracted from Chat) ---
+
+    def self.load_session(caller_binding)
+      # Load compiled mana def methods
+      cache_dir = Mana::Compiler.cache_dir
+      if Dir.exist?(cache_dir)
+        Dir.glob(File.join(cache_dir, "*.rb")).each do |path|
+          caller_binding.eval(File.read(path), path, 1) rescue nil
+        end
+      end
+
+      # Restore runtime state
+      return unless Claw.config.persist_session
+      dir = File.join(Dir.pwd, ".ruby-claw")
+      return unless File.exist?(File.join(dir, "values.json")) || File.exist?(File.join(dir, "definitions.rb"))
+      Claw::Serializer.restore(caller_binding, dir) rescue nil
+    end
+
+    private_class_method :load_session
+  end
+end

data/lib/claw/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Claw
-  VERSION = "0.1.2"
+  VERSION = "0.2.0"
 end

data/lib/claw.rb

@@ -1,13 +1,37 @@
 # frozen_string_literal: true
 
 require "mana"
+require "marshal-md"
 require_relative "claw/version"
 require_relative "claw/config"
 require_relative "claw/memory_store"
 require_relative "claw/memory"
 require_relative "claw/knowledge"
+require_relative "claw/resource"
+require_relative "claw/runtime"
+require_relative "claw/resources/context_resource"
+require_relative "claw/resources/memory_resource"
+require_relative "claw/resources/filesystem_resource"
+require_relative "claw/resources/binding_resource"
+require_relative "claw/resources/worktree_resource"
 require_relative "claw/serializer"
+require_relative "claw/trace"
+require_relative "claw/init"
+require_relative "claw/evolution"
+require_relative "claw/child_runtime"
+require_relative "claw/tool"
+require_relative "claw/tool_index"
+require_relative "claw/tool_registry"
+require_relative "claw/forge"
+require_relative "claw/auto_forge"
+require_relative "claw/hub"
+require_relative "claw/commands"
+require_relative "claw/plan_mode"
+require_relative "claw/roles"
+require_relative "claw/console"
+require_relative "claw/cli"
 require_relative "claw/chat"
+require_relative "claw/tui/tui"
 
 module Claw
   class << self
@@ -32,8 +56,19 @@ module Claw
       Memory.incognito(&block)
     end
 
+    def tool_registry
+      @tool_registry
+    end
+
+    def init_tool_registry(tools_dir: nil, hub: nil)
+      tools_dir ||= File.join(Dir.pwd, ".ruby-claw", "tools")
+      @tool_registry = ToolRegistry.new(tools_dir: tools_dir, hub: hub)
+    end
+
     def reset!
       @config = Config.new
+      @tool_registry = nil
+      Claw::Tool.tool_classes.clear
       Thread.current[:claw_memory] = nil
       Thread.current[:mana_context] = nil
     end
@@ -69,9 +104,72 @@ Mana.register_prompt_section do
   lines = ["Long-term memories (persistent background context):"]
   memory.long_term.each { |m| lines << "- #{m[:content]}" }
   lines << ""
-  lines << "You have a `remember` tool to store new facts in long-term memory when the user asks."
+  lines << "You have a `remember` tool to store facts in long-term memory."
+  lines << "After completing a task, proactively use `remember` to store:"
+  lines << "- User preferences you observed (coding style, language, formatting)"
+  lines << "- Project characteristics (tech stack, architecture, key files)"
+  lines << "- Effective strategies that worked well"
+  lines << "- Corrections the user made (to avoid repeating mistakes)"
+  lines << "Do not wait to be asked — remember useful context proactively."
   lines.join("\n")
 end
 
+# Register prompt section to inject active role into system prompt.
+Mana.register_prompt_section do
+  role = Claw::Roles.current
+  next nil unless role
+
+  "Active role: #{role[:name]}\n#{role[:content]}"
+end
+
+# Register search_tools — agent uses this to discover available project/hub tools.
+Mana.register_tool(
+  {
+    name: "search_tools",
+    description: "Search for available tools by keyword. Returns matching tools that can be loaded with load_tool.",
+    input_schema: {
+      type: "object",
+      properties: { query: { type: "string", description: "What capability you need" } },
+      required: ["query"]
+    }
+  }
+) do |input|
+  registry = Claw.tool_registry
+  unless registry
+    next "Tool registry not initialized. Run `claw init` first."
+  end
+
+  results = registry.search(input["query"])
+  if results.empty?
+    "No tools found matching '#{input['query']}'"
+  else
+    lines = results.map do |r|
+      status = r[:loaded] ? " [loaded]" : ""
+      "- #{r[:name]}: #{r[:description]} (#{r[:source]}#{status})"
+    end
+    "Found #{results.size} tool(s):\n#{lines.join("\n")}"
+  end
+end
+
+# Register load_tool — agent uses this to dynamically load a discovered tool.
+Mana.register_tool(
+  {
+    name: "load_tool",
+    description: "Load a tool to make it available for use in the current session. Use search_tools first to find available tools.",
+    input_schema: {
+      type: "object",
+      properties: { tool_name: { type: "string", description: "Name of the tool to load" } },
+      required: ["tool_name"]
+    }
+  }
+) do |input|
+  registry = Claw.tool_registry
+  unless registry
+    next "Tool registry not initialized. Run `claw init` first."
+  end
+
+  registry.load(input["tool_name"])
+end
+
 # Register Claw's enhanced knowledge provider.
 Mana.config.knowledge_provider = Claw::Knowledge

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ruby-claw
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.0
 platform: ruby
 authors:
 - Carl Li
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-04-05 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ruby-mana
@@ -24,6 +23,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 0.5.11
+- !ruby/object:Gem::Dependency
+  name: marshal-md
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.0
 - !ruby/object:Gem::Dependency
   name: binding_of_caller
   requirement: !ruby/object:Gem::Requirement
@@ -52,9 +65,148 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0.5'
+- !ruby/object:Gem::Dependency
+  name: bubbletea
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+- !ruby/object:Gem::Dependency
+  name: lipgloss
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+- !ruby/object:Gem::Dependency
+  name: bubbles
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+- !ruby/object:Gem::Dependency
+  name: glamour
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+- !ruby/object:Gem::Dependency
+  name: ntcharts
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+- !ruby/object:Gem::Dependency
+  name: bubblezone
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+- !ruby/object:Gem::Dependency
+  name: huh
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: harmonica
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+- !ruby/object:Gem::Dependency
+  name: sinatra
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: rackup
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
 description: Claw is an Agent framework built on ruby-mana. Adds interactive chat,
   persistent memory with compaction, knowledge base, and runtime state persistence.
-email:
 executables:
 - claw
 extensions: []
@@ -65,18 +217,83 @@ files:
 - README.md
 - exe/claw
 - lib/claw.rb
+- lib/claw/auto_forge.rb
+- lib/claw/benchmark/benchmark.rb
+- lib/claw/benchmark/diff.rb
+- lib/claw/benchmark/report.rb
+- lib/claw/benchmark/runner.rb
+- lib/claw/benchmark/scorer.rb
+- lib/claw/benchmark/task.rb
+- lib/claw/benchmark/tasks/claw_remember.rb
+- lib/claw/benchmark/tasks/claw_session.rb
+- lib/claw/benchmark/tasks/evolution_trace.rb
+- lib/claw/benchmark/tasks/mana_call_func.rb
+- lib/claw/benchmark/tasks/mana_eval.rb
+- lib/claw/benchmark/tasks/mana_knowledge.rb
+- lib/claw/benchmark/tasks/mana_var_readwrite.rb
+- lib/claw/benchmark/tasks/runtime_fork.rb
+- lib/claw/benchmark/tasks/runtime_snapshot.rb
+- lib/claw/benchmark/trigger.rb
 - lib/claw/chat.rb
+- lib/claw/child_runtime.rb
+- lib/claw/cli.rb
+- lib/claw/commands.rb
 - lib/claw/config.rb
+- lib/claw/console.rb
+- lib/claw/console/event_logger.rb
+- lib/claw/console/public/app.js
+- lib/claw/console/public/style.css
+- lib/claw/console/server.rb
+- lib/claw/console/sse.rb
+- lib/claw/console/views/experiments.erb
+- lib/claw/console/views/index.erb
+- lib/claw/console/views/layout.erb
+- lib/claw/console/views/memory.erb
+- lib/claw/console/views/monitor.erb
+- lib/claw/console/views/prompt.erb
+- lib/claw/console/views/snapshots.erb
+- lib/claw/console/views/tools.erb
+- lib/claw/console/views/traces.erb
+- lib/claw/evolution.rb
+- lib/claw/forge.rb
+- lib/claw/hub.rb
+- lib/claw/init.rb
 - lib/claw/knowledge.rb
 - lib/claw/memory.rb
 - lib/claw/memory_store.rb
+- lib/claw/plan_mode.rb
+- lib/claw/resource.rb
+- lib/claw/resources/binding_resource.rb
+- lib/claw/resources/context_resource.rb
+- lib/claw/resources/filesystem_resource.rb
+- lib/claw/resources/memory_resource.rb
+- lib/claw/resources/worktree_resource.rb
+- lib/claw/roles.rb
+- lib/claw/runtime.rb
 - lib/claw/serializer.rb
+- lib/claw/tool.rb
+- lib/claw/tool_index.rb
+- lib/claw/tool_registry.rb
+- lib/claw/trace.rb
+- lib/claw/tui/agent_executor.rb
+- lib/claw/tui/chat_panel.rb
+- lib/claw/tui/command_bar.rb
+- lib/claw/tui/file_card.rb
+- lib/claw/tui/folding.rb
+- lib/claw/tui/input_handler.rb
+- lib/claw/tui/layout.rb
+- lib/claw/tui/messages.rb
+- lib/claw/tui/model.rb
+- lib/claw/tui/object_explorer.rb
+- lib/claw/tui/status_bar.rb
+- lib/claw/tui/status_panel.rb
+- lib/claw/tui/styles.rb
+- lib/claw/tui/tui.rb
 - lib/claw/version.rb
 homepage: https://github.com/twokidsCarl/ruby-claw
 licenses:
 - MIT
 metadata: {}
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -91,8 +308,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: AI Agent framework for Ruby — chat, memory, persistence
 test_files: []