elelem 0.4.0 → 0.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2885faeaffa4f0ee7eff742f50bbf1ee78f257f7989c6401c787c4d4feb5d6a2
-  data.tar.gz: '0965d3a94ce8633cd01e7471e5688912216794e9b6af49450d0c1a5326e24645'
+  metadata.gz: 7c9f3ee321bf585693ae2be5186a3b84f0122f282bcd8cb6d320b92931eb0d13
+  data.tar.gz: f9200f6646a49666394493f46a99ec5ebb157d415e35208a8cdb405736c822c1
 SHA512:
-  metadata.gz: e00079252cb138588937776e7d37fc28de2e451c1ac72a190f842d29d27df537123a524b3358c6f36a685704b18e5c3a424cd819b3c8eb3ed1259f1937bdf02d
-  data.tar.gz: c77a7a8b34cf326e812db4ac23a38de0f7841fc1763f18f569a60d783be6719e251ff1eae59234b4da68cb8276c71fb617491ea46d97905ec39e05f5359b405f
+  metadata.gz: b62630ba5787d5b7daa55113c01012ade1075f4d9618b43c6a4ce46643b4a29ce3d380c864070f6aa43e26732ae6e20b07f4ce7eb7b4b251b90fd83f5ff5c781
+  data.tar.gz: 48929614d89e694d9d153baa195276042d586a537f1197c588156cf8d192afd4b6b134bad5bd30c836a05358ff26607ae6b7531f5f71e33f9e0291f0d5331e2d

data/CHANGELOG.md

@@ -1,5 +1,26 @@
 ## [Unreleased]
 
+## [0.4.2] - 2025-12-01
+
+### Changed
+- Renamed `exec` tool to `bash` for clarity
+- Improved system prompt with iterative refinements
+- Added environment context variables to system prompt
+
+## [0.4.1] - 2025-11-26
+
+### Added
+- `elelem files` subcommand: generates Claude‑compatible XML file listings.
+- Rake task `files:prompt` to output a ready‑to‑copy list of files for prompts.
+
+### Changed
+- Refactor tool‑call formatting to a more compact JSON payload for better LLM parsing.
+- Updated CI and documentation to use GitHub instead of previous hosting.
+- Runtime validation of command‑line parameters against a JSON schema.
+
+### Fixed
+- Minor documentation and CI workflow adjustments.
+
 ## [0.4.0] - 2025-11-10
 
 ### Added
@@ -116,3 +137,4 @@
 ## [0.1.0] - 2025-08-08
 
 - Initial release
+

data/README.md

@@ -125,13 +125,13 @@ seven tools, each represented by a JSON schema that the LLM can call.
 
 | Tool      | Purpose                              | Parameters                           |
 | ----      | -------                              | ----------                           |
+| `bash`    | Run shell commands                   | `cmd`, `args`, `env`, `cwd`, `stdin` |
 | `eval`    | Dynamically create new tools         | `code`                               |
 | `grep`    | Search Git‑tracked files             | `query`                              |
 | `list`    | List tracked files                   | `path` (optional)                    |
+| `patch`   | Apply a unified diff via `git apply` | `diff`                               |
 | `read`    | Read file contents                   | `path`                               |
 | `write`   | Overwrite a file                     | `path`, `content`                    |
-| `patch`   | Apply a unified diff via `git apply` | `diff`                               |
-| `execute` | Run shell commands                   | `cmd`, `args`, `env`, `cwd`, `stdin` |
 
 ## Tool Definition
 

data/Rakefile

@@ -5,4 +5,15 @@ require "rspec/core/rake_task"
 
 RSpec::Core::RakeTask.new(:spec)
 
+task :files do
+  IO.popen(%w[git ls-files], chdir: __dir__, err: IO::NULL) do |ls|
+    ls.readlines.each do |f|
+      next if f.start_with?(*%w[bin/ spec/ pkg/ .git .rspec Gemfile Rakefile])
+      next if f.strip.end_with?(*%w[.toml .txt .md])
+
+      puts f
+    end
+  end
+end
+
 task default: %i[spec]

data/lib/elelem/agent.rb

@@ -65,20 +65,13 @@ module Elelem
       HELP
     end
 
-    def format_tool_call(name, args)
-      case name
-      when "execute"
-        cmd = args["cmd"]
-        cmd_args = args["args"] || []
-        cmd_args.empty? ? cmd : "#{cmd} #{cmd_args.join(' ')}"
-      when "grep" then "grep(#{args["query"]})"
-      when "list" then "list(#{args["path"] || "."})"
-      when "patch" then "patch(#{args["diff"]&.lines&.count || 0} lines)"
-      when "read" then "read(#{args["path"]})"
-      when "write" then "write(#{args["path"]})"
-      else
-        "#{name}(#{args.to_s[0...50]})"
-      end
+    def format_tool_call_result(result)
+      return if result.nil?
+      return result["stdout"] if result["stdout"]
+      return result["stderr"] if result["stderr"]
+      return result[:error] if result[:error]
+
+      ""
     end
 
     def execute_turn(messages, tools:)
@@ -88,7 +81,7 @@ module Elelem
         content = ""
         tool_calls = []
 
-        print "Thinking..."
+        print "Assistant> Thinking..."
         client.chat(messages + turn_context, tools) do |chunk|
           msg = chunk["message"]
           if msg
@@ -110,8 +103,9 @@ module Elelem
             name = call.dig("function", "name")
             args = call.dig("function", "arguments")
 
-            puts "Tool> #{format_tool_call(name, args)}"
+            puts "Tool> #{name}(#{args})"
             result = toolbox.run_tool(name, args)
+            puts format_tool_call_result(result)
             turn_context << { role: "tool", content: JSON.dump(result) }
           end
 

data/lib/elelem/application.rb

@@ -13,7 +13,6 @@ module Elelem
                   type: :string,
                   desc: "Ollama model",
                   default: ENV.fetch("OLLAMA_MODEL", "gpt-oss")
-
     def chat(*)
       client = Net::Llm::Ollama.new(
         host: options[:host],
@@ -24,6 +23,20 @@ module Elelem
       agent.repl
     end
 
+    desc "files", "Generate CXML of the files"
+    def files
+      puts '<documents>'
+      $stdin.read.split("\n").map(&:strip).reject(&:empty?).each_with_index do |file, i|
+        next unless File.file?(file)
+
+        puts "  <document index=\"#{i + 1}\">"
+        puts "    <source><![CDATA[#{file}]]></source>"
+        puts "    <document_content><![CDATA[#{File.read(file)}]]></document_content>"
+        puts "  </document>"
+      end
+      puts '</documents>'
+    end
+
     desc "version", "The version of this CLI"
     def version
       say "v#{Elelem::VERSION}"

data/lib/elelem/conversation.rb

@@ -45,19 +45,19 @@ module Elelem
 
       case mode.sort
       when [:read]
-        "#{base}\n\nRead and analyze. Understand before suggesting action."
+        "#{base}\n\nYou may read files on the system."
       when [:write]
-        "#{base}\n\nWrite clean, thoughtful code."
+        "#{base}\n\nYou may write files on the system."
       when [:execute]
-        "#{base}\n\nUse shell commands creatively to understand and manipulate the system."
+        "#{base}\n\nYou may execute shell commands on the system."
       when [:read, :write]
-        "#{base}\n\nFirst understand, then build solutions that integrate well."
+        "#{base}\n\nYou may read and write files on the system."
       when [:execute, :read]
-        "#{base}\n\nUse commands to deeply understand the system."
+        "#{base}\n\nYou may execute shell commands and read files on the system."
       when [:execute, :write]
-        "#{base}\n\nCreate and execute freely. Have fun. Be kind."
+        "#{base}\n\nYou may execute shell commands and write files on the system."
       when [:execute, :read, :write]
-        "#{base}\n\nYou have all tools. Use them wisely."
+        "#{base}\n\nYou may read files, write files and execute shell commands on the system."
       else
         base
       end

data/lib/elelem/system_prompt.erb

@@ -1,5 +1,15 @@
 You are a reasoning coding and system agent.
 
-- Less is more
-- No code comments
-- No trailing whitespace
+## System
+
+Operating System: <%= `uname -a` %>
+USER: <%= ENV['USER'] %>
+HOME: <%= ENV['HOME'] %>
+SHELL: <%= ENV['SHELL'] %>
+PATH: <%= ENV['PATH'] %>
+PWD: <%= ENV['PWD'] %>
+LANG: <%= ENV['LANG'] %>
+EDITOR: <%= ENV['EDITOR'] %>
+LOGNAME: <%= ENV['LOGNAME'] %>
+TERM: <%= ENV['TERM'] %>
+MAIL: <%= ENV['MAIL'] %>

data/lib/elelem/tool.rb

@@ -11,14 +11,15 @@ module Elelem
     end
 
     def call(args)
-      return ArgumentError.new(args) unless valid?(args)
+      unless valid?(args)
+        return { error: "Invalid args for #{@name}", received: args.keys, expected: @schema.dig(:function, :parameters, :required) }
+      end
 
       @block.call(args)
     end
 
     def valid?(args)
-      # TODO:: Use JSON Schema Validator
-      true
+      JSON::Validator.validate(@schema.dig(:function, :parameters), args)
     end
 
     def to_h

data/lib/elelem/toolbox.rb

@@ -8,7 +8,7 @@ module Elelem
       full_path.exist? ? { content: full_path.read } : { error: "File not found: #{path}" }
     end
 
-    EXEC_TOOL = Tool.build("execute", "Execute shell commands directly. Commands run in a shell context. Examples: 'date', 'git status'.", { cmd: { type: "string" }, args: { type: "array", items: { type: "string" } }, env: { type: "object", additionalProperties: { type: "string" } }, cwd: { type: "string", description: "Working directory (defaults to current)" }, stdin: { type: "string" } }, ["cmd"]) do |args|
+    BASH_TOOL = Tool.build("bash", "Run shell commands. For git: bash({\"cmd\": \"git\", \"args\": [\"log\", \"--oneline\"]}). Returns stdout/stderr/exit_status.", { cmd: { type: "string" }, args: { type: "array", items: { type: "string" } }, env: { type: "object", additionalProperties: { type: "string" } }, cwd: { type: "string", description: "Working directory (defaults to current)" }, stdin: { type: "string" } }, ["cmd"]) do |args|
       Elelem.shell.execute(
         args["cmd"],
         args: args["args"] || [],
@@ -42,7 +42,7 @@ module Elelem
       @tools_by_name = {}
       @tools = { read: [], write: [], execute: [] }
       add_tool(eval_tool(binding), :execute)
-      add_tool(EXEC_TOOL, :execute)
+      add_tool(BASH_TOOL, :execute)
       add_tool(GREP_TOOL, :read)
       add_tool(LIST_TOOL, :read)
       add_tool(PATCH_TOOL, :write)

data/lib/elelem/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: elelem
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.4.2
 platform: ruby
 authors:
 - mo khan
@@ -198,14 +198,14 @@ files:
 - lib/elelem/tool.rb
 - lib/elelem/toolbox.rb
 - lib/elelem/version.rb
-homepage: https://gitlab.com/mokhax/elelem
+homepage: https://github.com/xlgmokha/elelem
 licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
-  homepage_uri: https://gitlab.com/mokhax/elelem
-  source_code_uri: https://gitlab.com/mokhax/elelem
-  changelog_uri: https://gitlab.com/mokhax/elelem/-/blob/main/CHANGELOG.md
+  homepage_uri: https://github.com/xlgmokha/elelem
+  source_code_uri: https://github.com/xlgmokha/elelem
+  changelog_uri: https://github.com/xlgmokha/elelem/blob/main/CHANGELOG.md
 rdoc_options: []
 require_paths:
 - lib