elelem-tools 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 10d95e567040251074141f329ea4f0e1400a866715c8ca6b3c5c58f61136576a
+  data.tar.gz: 135c83d3d9945b31555a28012a5b0e9d91260d4d8e2e984de42f71461e8f76dc
+SHA512:
+  metadata.gz: c7026b46f8b420cb9be98b16282dda7a0048b909057b7c945e76df481a5b7139846ffe3f12239868c3829d43e45bc5da2a0f2e8155caa5b90f73001841ae6741
+  data.tar.gz: fb44a774890cafa5d26cf14eb8d5d7b117a73cd56bd8190c49cef711e7611aa7c431faf95b0b8b4ed0be399a65fb61a818bf7a76e66a73877bd36bdc4b4e410e

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 mo khan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+task default: %i[]

data/lib/elelem/tools/compact.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+Elelem::Plugins.register(:compact) do |agent|
+  agent.commands.register("compact", description: "Compress context") do
+    response = agent.turn("Summarize: accomplishments, state, next steps. Brief.")
+    agent.conversation.clear!
+    agent.conversation.add(role: "user", content: "Context: #{response}")
+    agent.terminal.say "  → compacted"
+  end
+end

data/lib/elelem/tools/edit.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+Elelem::Plugins.register(:edit) do |agent|
+  agent.toolbox.add("edit",
+    description: "Replace first occurrence of text in file",
+    params: { path: { type: "string" }, old: { type: "string" }, new: { type: "string" } },
+    required: ["path", "old", "new"]
+  ) do |args|
+    path = Pathname.new(args["path"]).expand_path
+    content = path.read
+    agent.toolbox
+      .run("write", { "path" => args["path"], "content" => content.sub(args["old"], args["new"]) })
+      .merge(replaced: args["old"], with: args["new"])
+  end
+end

data/lib/elelem/tools/eval.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+Elelem::Plugins.register(:eval) do |agent|
+  description = <<~'DESC'
+    Evaluate Ruby code. Available API:
+
+    name = "search"
+    agent.toolbox.add(name, description: "Search using rg", params: { query: { type: "string" } }, required: ["query"], aliases: []) do |args|
+      agent.toolbox.run("execute", { "command" => "rg --json -nI -F #{args["query"]}" })
+    end
+  DESC
+
+  agent.toolbox.add("eval",
+    description: description,
+    params: { ruby: { type: "string" } },
+    required: ["ruby"]
+  ) do |args|
+    { result: binding.eval(args["ruby"]) }
+  end
+end

data/lib/elelem/tools/git.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+Elelem::Plugins.register(:git) do |agent|
+  agent.toolbox.add("git",
+    description: "Run git command",
+    params: { command: { type: "string" }, args: { type: "array", items: { type: "string" } } },
+    required: ["command"]
+  ) do |args|
+    agent.toolbox.exec("git", args["command"], *(args["args"] || []))
+  end
+
+  agent.toolbox.after("git") do |_, result|
+    agent.terminal.say "  ! #{result[:error]}" if result[:error]
+  end
+end

data/lib/elelem/tools/glob.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+Elelem::Plugins.register(:glob) do |agent|
+  agent.toolbox.add("glob",
+    description: "Find files matching pattern",
+    params: { pattern: { type: "string" }, path: { type: "string" } },
+    required: ["pattern"]
+  ) do |args|
+    path = args["path"].to_s.empty? ? "." : args["path"]
+    result = agent.toolbox.exec("fd", "--glob", args["pattern"], path)
+    result[:ok] ? result : agent.toolbox.exec("find", path, "-name", args["pattern"])
+  end
+end

data/lib/elelem/tools/grep.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+Elelem::Plugins.register(:grep) do |agent|
+  agent.toolbox.add("grep",
+    description: "Search file contents",
+    params: { pattern: { type: "string" }, path: { type: "string" }, glob: { type: "string" } },
+    required: ["pattern"]
+  ) do |args|
+    path = args["path"].to_s.empty? ? "." : args["path"]
+    glob = args["glob"]
+
+    rg_args = ["rg", "-n", args["pattern"], path]
+    rg_args += ["-g", glob] if glob
+    result = agent.toolbox.exec(*rg_args)
+    next result if result[:ok]
+
+    grep_args = ["grep", "-rn"]
+    grep_args += ["--include", glob] if glob
+    grep_args += [args["pattern"], path]
+    agent.toolbox.exec(*grep_args)
+  end
+end

data/lib/elelem/tools/init.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+Elelem::Plugins.register(:init) do |agent|
+  agent.commands.register("init", description: "Generate AGENTS.md") do
+    system_prompt = <<~PROMPT
+      AGENTS.md generator. Analyze codebase and write AGENTS.md to project root.
+
+      # AGENTS.md Spec (https://agents.md/)
+      A file providing context and instructions for AI coding agents.
+
+      ## Recommended Sections
+      - Commands: build, test, lint commands
+      - Code Style: conventions, patterns
+      - Architecture: key components and flow
+      - Testing: how to run tests
+
+      ## Process
+      1. Read README.md if present
+      2. Identify language (Gemfile, package.json, go.mod)
+      3. Find test scripts (bin/test, npm test)
+      4. Check linter configs
+      5. Write concise AGENTS.md
+
+      Keep it minimal. No fluff.
+    PROMPT
+
+    agent.fork(system_prompt: system_prompt).turn("Generate AGENTS.md for this project")
+  end
+end

data/lib/elelem/tools/interview.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+Elelem::Plugins.register(:interview) do |agent|
+  agent.toolbox.add("interview",
+    description: "Ask the user a question and wait for their response",
+    params: {
+      question: { type: "string", description: "The question to ask the user" },
+    },
+    required: ["question"]
+  ) do |args|
+    agent.terminal.say(agent.terminal.markdown(args["question"]))
+    { answer: agent.terminal.ask("> ") }
+  end
+end

data/lib/elelem/tools/list.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+Elelem::Plugins.register(:list) do |agent|
+  agent.toolbox.add("list",
+    description: "List directory contents",
+    params: { path: { type: "string" }, recursive: { type: "boolean" } },
+    required: [],
+    aliases: ["ls"]
+  ) do |args|
+    path = args["path"] && !args["path"].empty? ? args["path"] : "."
+    flags = args["recursive"] ? "-laR" : "-la"
+    agent.toolbox.exec("ls", flags, path)
+  end
+end

data/lib/elelem/tools/shell.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+Elelem::Plugins.register(:shell) do |agent|
+  strip_ansi = ->(text) do
+    text
+      .gsub(/^Script started.*?\n/, "")
+      .gsub(/\nScript done.*$/, "")
+      .gsub(/\e\].*?(?:\a|\e\\)/, "")
+      .gsub(/\e\[[0-9;?]*[A-Za-z]/, "")
+      .gsub(/\e[PX^_].*?\e\\/, "")
+      .gsub(/\e./, "")
+      .gsub(/[\b]/, "")
+      .gsub(/\r/, "")
+  end
+
+  agent.commands.register("shell", description: "Start interactive shell") do
+    transcript = Tempfile.create do |file|
+      system("script", "-q", file.path, chdir: Dir.pwd)
+      strip_ansi.call(File.read(file.path))
+    end
+    agent.conversation.add(role: "user", content: transcript) unless transcript.strip.empty?
+  end
+end

data/lib/elelem/tools/task.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+Elelem::Plugins.register(:task) do |agent|
+  agent.toolbox.add("task",
+    description: "Delegate subtask to focused agent (complex searches, multi-file analysis)",
+    params: { prompt: { type: "string" } },
+    required: ["prompt"]
+  ) do |args|
+    sub = agent.fork(system_prompt: "Research agent. Search, analyze, report. Be concise.")
+    sub.turn(args["prompt"])
+    { result: sub.conversation.last[:content] }
+  end
+end

data/lib/elelem/tools/verify.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+Elelem::Plugins.register(:verify) do |agent|
+  agent.toolbox.add("verify",
+    description: "Verify file syntax and run tests",
+    params: { path: { type: "string" } },
+    required: ["path"]
+  ) do |args|
+    path = args["path"]
+    Elelem::Plugins::Verifiers.for(path).inject({ verified: [] }) do |memo, cmd|
+      agent.terminal.say agent.toolbox.header("execute", { "command" => cmd })
+      v = agent.toolbox.run("execute", { "command" => cmd })
+      break v.merge(path: path, command: cmd) if v[:exit_status] != 0
+
+      memo[:verified] << cmd
+      memo
+    end
+  end
+end

data/lib/elelem/tools/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Elelem
+  module Tools
+    VERSION = "0.1.0"
+  end
+end

data/lib/elelem/tools.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require "elelem"
+require "pathname"
+require "tempfile"
+
+require_relative "tools/version"
+require_relative "tools/compact"
+require_relative "tools/edit"
+require_relative "tools/eval"
+require_relative "tools/git"
+require_relative "tools/glob"
+require_relative "tools/grep"
+require_relative "tools/init"
+require_relative "tools/interview"
+require_relative "tools/list"
+require_relative "tools/shell"
+require_relative "tools/task"
+require_relative "tools/verify"

metadata

@@ -0,0 +1,101 @@
+--- !ruby/object:Gem::Specification
+name: elelem-tools
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- mo khan
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: elelem
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+- !ruby/object:Gem::Dependency
+  name: pathname
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+- !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'
+description: Adds tools to elelem.
+email:
+- mo@mokhan.ca
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- Rakefile
+- lib/elelem/tools.rb
+- lib/elelem/tools/compact.rb
+- lib/elelem/tools/edit.rb
+- lib/elelem/tools/eval.rb
+- lib/elelem/tools/git.rb
+- lib/elelem/tools/glob.rb
+- lib/elelem/tools/grep.rb
+- lib/elelem/tools/init.rb
+- lib/elelem/tools/interview.rb
+- lib/elelem/tools/list.rb
+- lib/elelem/tools/shell.rb
+- lib/elelem/tools/task.rb
+- lib/elelem/tools/verify.rb
+- lib/elelem/tools/version.rb
+homepage: https://src.mokhan.ca/elelem/tools
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://src.mokhan.ca/elelem/tools
+  source_code_uri: https://src.mokhan.ca/elelem/tools
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 4.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.20
+specification_version: 4
+summary: Optional tools for elelem.
+test_files: []