brute 0.1.0

data/lib/brute.rb

@@ -0,0 +1,121 @@
+# frozen_string_literal: true
+
+require "llm"
+require "timeout"
+require "logger"
+
+# Brute — a coding agent built on llm.rb
+#
+# Cross-cutting concerns are implemented as Rack-style middleware in a
+# Pipeline that wraps every LLM call:
+#
+#   Tracing → Retry → Session → Tokens → Compaction → ToolErrors → DoomLoop → Reasoning → [LLM Call]
+#
+module Brute
+  module Tools; end
+  module Hooks; end
+  module Middleware; end
+end
+
+# Infrastructure
+require_relative "brute/snapshot_store"
+require_relative "brute/todo_store"
+require_relative "brute/file_mutation_queue"
+require_relative "brute/doom_loop"
+require_relative "brute/hooks"
+require_relative "brute/compactor"
+require_relative "brute/system_prompt"
+require_relative "brute/session"
+require_relative "brute/pipeline"
+require_relative "brute/agent_stream"
+
+# Provider patches
+require_relative "brute/patches/anthropic_tool_role"
+require_relative "brute/patches/buffer_nil_guard"
+
+# Middleware (Rack-style)
+require_relative "brute/middleware/base"
+require_relative "brute/middleware/llm_call"
+require_relative "brute/middleware/retry"
+require_relative "brute/middleware/doom_loop_detection"
+require_relative "brute/middleware/token_tracking"
+require_relative "brute/middleware/compaction_check"
+require_relative "brute/middleware/session_persistence"
+require_relative "brute/middleware/tracing"
+require_relative "brute/middleware/tool_error_tracking"
+require_relative "brute/middleware/reasoning_normalizer"
+
+# Tools
+require_relative "brute/tools/fs_read"
+require_relative "brute/tools/fs_write"
+require_relative "brute/tools/fs_patch"
+require_relative "brute/tools/fs_remove"
+require_relative "brute/tools/fs_search"
+require_relative "brute/tools/fs_undo"
+require_relative "brute/tools/shell"
+require_relative "brute/tools/net_fetch"
+require_relative "brute/tools/todo_write"
+require_relative "brute/tools/todo_read"
+require_relative "brute/tools/delegate"
+
+# Orchestrator (depends on tools, middleware, and infrastructure)
+require_relative "brute/orchestrator"
+
+module Brute
+  VERSION = "0.1.0"
+
+  # The complete set of tools available to the agent.
+  TOOLS = [
+    Tools::FSRead,
+    Tools::FSWrite,
+    Tools::FSPatch,
+    Tools::FSRemove,
+    Tools::FSSearch,
+    Tools::FSUndo,
+    Tools::Shell,
+    Tools::NetFetch,
+    Tools::TodoWrite,
+    Tools::TodoRead,
+    Tools::Delegate,
+  ].freeze
+
+  # Default provider, resolved from environment.
+  def self.provider
+    @provider ||= resolve_provider
+  end
+
+  def self.provider=(p)
+    @provider = p
+  end
+
+  # Create a new orchestrator with sensible defaults.
+  def self.agent(cwd: Dir.pwd, tools: TOOLS, session: nil, reasoning: {}, **callbacks)
+    Orchestrator.new(
+      provider: provider,
+      tools: tools,
+      cwd: cwd,
+      session: session,
+      reasoning: reasoning,
+      **callbacks
+    )
+  end
+
+  def self.resolve_provider
+    if ENV["ANTHROPIC_API_KEY"]
+      LLM.anthropic(key: ENV["ANTHROPIC_API_KEY"]).tap { Patches::AnthropicToolRole.apply! }
+    elsif ENV["OPENAI_API_KEY"]
+      LLM.openai(key: ENV["OPENAI_API_KEY"])
+    elsif ENV["GOOGLE_API_KEY"]
+      LLM.google(key: ENV["GOOGLE_API_KEY"])
+    else
+      raise <<~MSG
+        No API key found. Set one of:
+          ANTHROPIC_API_KEY
+          OPENAI_API_KEY
+          GOOGLE_API_KEY
+      MSG
+    end
+  end
+
+  private_class_method :resolve_provider
+end

metadata

@@ -0,0 +1,101 @@
+--- !ruby/object:Gem::Specification
+name: brute
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Brute Contributors
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: llm.rb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.11'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.11'
+- !ruby/object:Gem::Dependency
+  name: async
+  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: Production-grade coding agent with tool execution, middleware pipeline,
+  context compaction, session persistence, and multi-provider LLM support.
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/brute.rb
+- lib/brute/agent_stream.rb
+- lib/brute/compactor.rb
+- lib/brute/doom_loop.rb
+- lib/brute/file_mutation_queue.rb
+- lib/brute/hooks.rb
+- lib/brute/middleware/base.rb
+- lib/brute/middleware/compaction_check.rb
+- lib/brute/middleware/doom_loop_detection.rb
+- lib/brute/middleware/llm_call.rb
+- lib/brute/middleware/reasoning_normalizer.rb
+- lib/brute/middleware/retry.rb
+- lib/brute/middleware/session_persistence.rb
+- lib/brute/middleware/token_tracking.rb
+- lib/brute/middleware/tool_error_tracking.rb
+- lib/brute/middleware/tracing.rb
+- lib/brute/orchestrator.rb
+- lib/brute/patches/anthropic_tool_role.rb
+- lib/brute/patches/buffer_nil_guard.rb
+- lib/brute/pipeline.rb
+- lib/brute/session.rb
+- lib/brute/snapshot_store.rb
+- lib/brute/system_prompt.rb
+- lib/brute/todo_store.rb
+- lib/brute/tools/delegate.rb
+- lib/brute/tools/fs_patch.rb
+- lib/brute/tools/fs_read.rb
+- lib/brute/tools/fs_remove.rb
+- lib/brute/tools/fs_search.rb
+- lib/brute/tools/fs_undo.rb
+- lib/brute/tools/fs_write.rb
+- lib/brute/tools/net_fetch.rb
+- lib/brute/tools/shell.rb
+- lib/brute/tools/todo_read.rb
+- lib/brute/tools/todo_write.rb
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.7.2
+specification_version: 4
+summary: A coding agent built on llm.rb
+test_files: []