elelem 0.10.0 → 0.12.0

data/lib/elelem/toolbox.rb

@@ -10,8 +10,16 @@ module Elelem
       @hooks = { before: Hash.new { |h, k| h[k] = [] }, after: Hash.new { |h, k| h[k] = [] } }
     end
 
-    def add(name, description:, params: {}, required: [], aliases: [], &fn)
-      tool = Tool.new(name, description: description, params: params, required: required, aliases: aliases, &fn)
+    def clear!
+      @tools.clear
+      @aliases.clear
+      @hooks[:before].clear
+      @hooks[:after].clear
+    end
+
+    def add(name, description:, params: {}, required: [], aliases: [], &handler)
+      schema = Schema.new(params: params, required: required)
+      tool = Tool.new(name, description: description, schema: schema, aliases: aliases, &handler)
       @tools[name] = tool
       tool.aliases.each { |a| @aliases[a] = name }
     end
@@ -24,33 +32,15 @@ module Elelem
       @hooks[:after][tool_name] << block
     end
 
-    def header(name, args, state: "+")
-      tool = tool_for(name)
-      color = tool ? "36" : "33"
-      name = tool&.name || "#{name}?"
-      "\n#{state} \e[#{color}m#{name}\e[0m(#{args})"
+    def tool_for(name)
+      tools.fetch(@aliases.fetch(name, name)) { NullTool.new(name, available: tools.keys) }
     end
 
     def run(name, args)
       tool = tool_for(name)
-      return failure(error: "unknown tool: #{name}. Use 'execute' to run shell commands like rg, fd, git.", tools: to_a) unless tool
-
-      errors = tool.validate(args)
-      return failure(error: errors.join(", ")) if errors.any?
-
-      @hooks[:before][:*].each { |h| h.call(args, tool_name: tool.name) }
-      @hooks[:before][tool.name].each { |h| h.call(args) }
-      result = tool.call(args)
-      @hooks[:after][:*].each { |h| h.call(args, result, tool_name: tool.name) }
-      @hooks[:after][tool.name].each { |h| h.call(args, result) }
-      result[:error] ? failure(result) : success(result)
-    rescue => e
-      failure(error: e.message, name: name, args: args)
-    end
-
-    def exec(*args)
-      command = args.flatten.map { |a| Shellwords.escape(a.to_s) }.join(" ")
-      run("execute", { "command" => command })
+      invalid(tool, args) || to_result(dispatch(tool, args))
+    rescue StandardError, ScriptError => e
+      failure(name, args, e)
     end
 
     def to_a
@@ -59,16 +49,35 @@ module Elelem
 
     private
 
-    def tool_for(name)
-      tools[@aliases.fetch(name, name)]
+    def invalid(tool, args)
+      errors = tool.validate(args)
+      Result.failure(error: errors.join(", ")) if errors.any?
+    end
+
+    def to_result(result)
+      result[:error] ? Result.failure(result) : Result.success(result)
     end
 
-    def success(payload)
-      payload.merge(ok: true)
+    def failure(name, args, error)
+      Elelem.logger.warn("toolbox: #{error.message}\n#{error.backtrace.join("\n")}")
+      Result.failure(error: error.message, name: name, args: args)
+    end
+
+    def dispatch(tool, args)
+      run_before_hooks(tool, args)
+      result = tool.call(args)
+      run_after_hooks(tool, args, result)
+      result
     end
 
-    def failure(payload)
-      payload.merge(ok: false)
+    def run_before_hooks(tool, args)
+      @hooks[:before][:*].each { |h| h.call(args, tool_name: tool.name) }
+      @hooks[:before][tool.name].each { |h| h.call(args) }
+    end
+
+    def run_after_hooks(tool, args, result)
+      @hooks[:after][:*].each { |h| h.call(args, result, tool_name: tool.name) }
+      @hooks[:after][tool.name].each { |h| h.call(args, result) }
     end
   end
 end

data/lib/elelem/transcript.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Elelem
+  class Transcript
+    def initialize(system_prompt: nil)
+      @conversation = Conversation.new
+      @system_prompt = SystemPrompt.new(system_prompt)
+    end
+
+    def add(role:, content:, **extra)
+      @conversation.add(role: role, content: content, **extra)
+    end
+
+    def clear!
+      @conversation.clear!
+    end
+
+    def last
+      @conversation.last
+    end
+
+    def to_a(extra = [])
+      @conversation.to_a(system_prompt: @system_prompt.render) + extra
+    end
+  end
+end

data/lib/elelem/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Elelem
-  VERSION = "0.10.0"
-end
+  VERSION = "0.12.0"
+end

data/lib/elelem.rb

@@ -1,141 +1,56 @@
 # frozen_string_literal: true
 
-require "base64"
-require "date"
-require "digest"
 require "erb"
-require "fileutils"
+require "forwardable"
 require "json"
 require "json_schemer"
 require "logger"
-require "net/hippie"
 require "open3"
-require "optparse"
 require "pathname"
-require "reline"
-require "securerandom"
-require "stringio"
-require "tempfile"
-require "uri"
-require "webrick"
+require "shellwords"
 
 require_relative "elelem/agent"
+require_relative "elelem/slash_command"
 require_relative "elelem/commands"
 require_relative "elelem/conversation"
-require_relative "elelem/mcp"
-require_relative "elelem/net"
-require_relative "elelem/permissions"
+require_relative "elelem/input"
+require_relative "elelem/null_input"
+require_relative "elelem/output"
+require_relative "elelem/null_output"
 require_relative "elelem/plugins"
+require_relative "elelem/registration"
+require_relative "elelem/registry"
+require_relative "elelem/repl"
+require_relative "elelem/config"
+require_relative "elelem/result"
+require_relative "elelem/schema"
+require_relative "elelem/session"
+require_relative "elelem/stub_provider"
 require_relative "elelem/system_prompt"
-require_relative "elelem/terminal"
 require_relative "elelem/tool"
+require_relative "elelem/transcript"
+require_relative "elelem/null_tool"
 require_relative "elelem/toolbox"
 require_relative "elelem/version"
 
 module Elelem
-  def self.sh(cmd, args: [], cwd: Dir.pwd, env: {})
-    output = StringIO.new
-
-    Open3.popen2e(env, cmd, *args, chdir: cwd) do |stdin, out, wait_thr|
-      stdin.close
-      out.each_line do |line|
-        yield line if block_given?
-        output.write(line)
-      end
-
-      { exit_status: wait_thr.value.exitstatus, content: output.string }
-    end
+  def self.start(provider: "stub", toolbox: Toolbox.new)
+    Repl.new(build(provider: provider, toolbox: toolbox)).run
   end
 
-  def self.start(client, toolbox: Toolbox.new)
-    agent = Agent.new(client, toolbox: toolbox)
-    Plugins.setup!(agent)
-    agent.terminal = Terminal.new(commands: agent.commands.names)
-    agent.repl
+  def self.ask(prompt, provider: "stub", toolbox: Toolbox.new, output: NullOutput.new)
+    build(provider: provider, toolbox: toolbox, input: NullInput.new, output: output).turn(prompt)
   end
 
-  def self.ask(client, prompt, toolbox: Toolbox.new)
-    agent = Agent.new(client, toolbox: toolbox, terminal: Terminal.new(quiet: true))
-    Plugins.setup!(agent)
-    agent.turn(prompt)
-    agent.conversation.last[:content]
+  def self.build(provider: "stub", toolbox: Toolbox.new, input: nil, output: nil)
+    Config.build_session(provider, toolbox: toolbox, input: input, output: output)
   end
 
-  class CLI
-    MODELS = {
-      "ollama" => "gpt-oss:latest",
-      "anthropic" => "claude-opus-4-5-20250514",
-      "vertex" => "claude-opus-4-5@20251101",
-      "openai" => "gpt-4o"
-    }.freeze
-
-    PROVIDERS = {
-      "ollama" => ->(model) { Elelem::Net::Ollama.new(model: model, host: ENV.fetch("OLLAMA_HOST", "localhost:11434")) },
-      "anthropic" => ->(model) { Elelem::Net::Claude.anthropic(model: model, api_key: ENV.fetch("ANTHROPIC_API_KEY")) },
-      "vertex" => ->(model) { Elelem::Net::Claude.vertex(model: model, project: ENV.fetch("GOOGLE_CLOUD_PROJECT"), region: ENV.fetch("GOOGLE_CLOUD_REGION", "us-east5")) },
-      "openai" => ->(model) { Elelem::Net::OpenAI.new(model: model, api_key: ENV.fetch("OPENAI_API_KEY")) }
-    }.freeze
-
-    def initialize(args)
-      @provider = "ollama"
-      @model = nil
-      @args = parse(args)
-    end
-
-    def run
-      command = @args.shift || "chat"
-      send(command.tr("-", "_"))
-    rescue NoMethodError
-      abort "Unknown command: #{command}"
-    end
-
-    private
-
-    def parse(args)
-      @parser = OptionParser.new do |o|
-        o.banner = "Usage: elelem [command] [options] [args]"
-        o.separator "\nCommands:"
-        o.separator "  chat              Interactive REPL (default)"
-        o.separator "  ask <prompt>      One-shot query (reads stdin if piped)"
-        o.separator "  files             Output files as XML (no options)"
-        o.separator "  help              Show this help"
-        o.separator "\nOptions:"
-        o.on("-p", "--provider NAME", "ollama, anthropic, vertex, openai") { |p| @provider = p }
-        o.on("-m", "--model NAME", "Override default model") { |m| @model = m }
-        o.on("-h", "--help") { puts o; exit }
-      end
-      @parser.parse!(args)
-    end
-
-    def help
-      puts @parser
-    end
-
-    def client
-      model = @model || MODELS.fetch(@provider)
-      PROVIDERS.fetch(@provider).call(model)
-    end
-
-    def chat
-      Elelem.start(client)
-    end
-
-    def ask
-      abort "Usage: elelem ask <prompt>" if @args.empty?
-      prompt = @args.join(" ")
-      prompt = "#{prompt}\n\n```\n#{$stdin.read}\n```" if $stdin.stat.pipe?
-      Elelem::Terminal.new.markdown Elelem.ask(client, prompt)
-    end
-
-    def files
-      files = $stdin.stat.pipe? ? $stdin.readlines : `git ls-files`.lines
-      puts "<documents>"
-      files.each_with_index do |line, i|
-        path = line.strip
-        next if path.empty? || !File.file?(path)
-        puts %Q{<document index="#{i + 1}"><source>#{path}</source><content><![CDATA[#{File.read(path)}]]></content></document>}
-      end
-      puts "</documents>"
+  def self.logger
+    @logger ||= Logger.new($stderr).tap do |log|
+      log.level = Logger.const_get(ENV.fetch("ELELEM_LOG_LEVEL", "warn").upcase)
     end
   end
 end
+
+Elelem.configure { |config| config.provider(:stub) { Elelem::StubProvider.new } }

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: elelem
 version: !ruby/object:Gem::Version
-  version: 0.10.0
+  version: 0.12.0
 platform: ruby
 authors:
 - mo khan
@@ -10,201 +10,145 @@ cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: base64
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.1'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.1'
-- !ruby/object:Gem::Dependency
-  name: date
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-- !ruby/object:Gem::Dependency
-  name: digest
+  name: erb
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '6.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '6.0'
 - !ruby/object:Gem::Dependency
-  name: erb
+  name: forwardable
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '6.0'
+        version: '1.4'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '6.0'
+        version: '1.4'
 - !ruby/object:Gem::Dependency
-  name: fileutils
+  name: io-console
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '0.9'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '0.9'
 - !ruby/object:Gem::Dependency
   name: json
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '3.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: json_schemer
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '2.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '2.5'
 - !ruby/object:Gem::Dependency
   name: logger
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '1.7'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
-- !ruby/object:Gem::Dependency
-  name: net-hippie
-  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'
+        version: '1.7'
 - !ruby/object:Gem::Dependency
   name: open3
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.2'
 - !ruby/object:Gem::Dependency
   name: optparse
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.8'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.8'
 - !ruby/object:Gem::Dependency
   name: pathname
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.5'
 - !ruby/object:Gem::Dependency
   name: reline
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.6'
+        version: '0.7'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.6'
-- !ruby/object:Gem::Dependency
-  name: securerandom
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.1'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.7'
 - !ruby/object:Gem::Dependency
   name: shellwords
   requirement: !ruby/object:Gem::Requirement
@@ -219,34 +163,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.2'
-- !ruby/object:Gem::Dependency
-  name: stringio
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-- !ruby/object:Gem::Dependency
-  name: tempfile
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.3'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.3'
 - !ruby/object:Gem::Dependency
   name: uri
   requirement: !ruby/object:Gem::Requirement
@@ -261,21 +177,7 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
-- !ruby/object:Gem::Dependency
-  name: webrick
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.9'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.9'
-description: A minimal coding agent supporting Ollama, Anthropic, OpenAI, and VertexAI.
+description: A minimal coding harness.
 email:
 - mo@mokhan.ca
 executables:
@@ -283,53 +185,44 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
-- CHANGELOG.md
 - LICENSE.txt
 - README.md
 - Rakefile
 - exe/elelem
 - lib/elelem.rb
 - lib/elelem/agent.rb
+- lib/elelem/cli.rb
 - lib/elelem/commands.rb
+- lib/elelem/config.rb
 - lib/elelem/conversation.rb
-- lib/elelem/mcp.rb
-- lib/elelem/mcp/oauth.rb
-- lib/elelem/mcp/token_storage.rb
-- lib/elelem/net.rb
-- lib/elelem/net/claude.rb
-- lib/elelem/net/ollama.rb
-- lib/elelem/net/openai.rb
-- lib/elelem/permissions.rb
+- lib/elelem/input.rb
+- lib/elelem/null_input.rb
+- lib/elelem/null_output.rb
+- lib/elelem/null_tool.rb
+- lib/elelem/output.rb
 - lib/elelem/plugins.rb
-- lib/elelem/plugins/builtins.rb
-- lib/elelem/plugins/edit.rb
-- lib/elelem/plugins/eval.rb
-- lib/elelem/plugins/execute.rb
-- lib/elelem/plugins/git.rb
-- lib/elelem/plugins/glob.rb
-- lib/elelem/plugins/grep.rb
-- lib/elelem/plugins/list.rb
-- lib/elelem/plugins/mcp.rb
-- lib/elelem/plugins/permissions.json
-- lib/elelem/plugins/read.rb
-- lib/elelem/plugins/task.rb
-- lib/elelem/plugins/tools.rb
-- lib/elelem/plugins/verify.rb
-- lib/elelem/plugins/write.rb
-- lib/elelem/plugins/zz_confirm.rb
+- lib/elelem/prompts/default.erb
+- lib/elelem/registration.rb
+- lib/elelem/registry.rb
+- lib/elelem/repl.rb
+- lib/elelem/result.rb
+- lib/elelem/schema.rb
+- lib/elelem/session.rb
+- lib/elelem/slash_command.rb
+- lib/elelem/stub_provider.rb
 - lib/elelem/system_prompt.rb
-- lib/elelem/terminal.rb
 - lib/elelem/tool.rb
 - lib/elelem/toolbox.rb
+- lib/elelem/transcript.rb
 - lib/elelem/version.rb
-homepage: https://src.mokhan.ca/xlgmokha/elelem
+homepage: https://src.mokhan.ca/elelem/elelem
 licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
-  homepage_uri: https://src.mokhan.ca/xlgmokha/elelem
-  source_code_uri: https://src.mokhan.ca/xlgmokha/elelem
-  changelog_uri: https://src.mokhan.ca/xlgmokha/elelem/blob/main/CHANGELOG.md.html
+  homepage_uri: https://src.mokhan.ca/elelem/elelem
+  source_code_uri: https://src.mokhan.ca/elelem/elelem
+  rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
 - lib
@@ -344,7 +237,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: 4.0.0
 requirements: []
-rubygems_version: 4.0.4
+rubygems_version: 4.0.20
 specification_version: 4
-summary: A minimal coding agent for LLMs.
+summary: A minimal coding harness for LLMs.
 test_files: []