solid_agents 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: f47eb3e38b46a127496f51a08a4a9613becb2abc109922b1ad4f5f2b203c89a2
+  data.tar.gz: ad064cee60b057a8eb9dc3baccf5f06c48411550f91f984a35ff8a32fca51d5e
+SHA512:
+  metadata.gz: fd4fe012fb44f5f2707152fae422cbc0a4a63b2342e3fac2e485231808d46c460c8465642fa747f37e7aa14820763f8a1bc9a722c65e1734b76db14c1153892f
+  data.tar.gz: 31a7f4a1ecc53a08710c656b7c7009d118e01de305f273d112984d460e1a826a0f5b4c14edbe5833bcb4589ffd1b6fa620346b8b23f61b52f265c3afd49eaf4b

data/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+All notable changes to `solid_agents` will be documented in this file.
+
+## [v0.1.0] - 2026-03-22
+
+Initial public release (WIP).
+
+- Introduced `solid_agents` Rails engine for database-backed agent run orchestration.
+- Added run lifecycle models and persistence for runs, events, artifacts, agents, and config.
+- Added dispatch and execution flow with runtime adapters for TinyClaw and OpenClaw.
+- Added built-in UI/controllers for managing agents and inspecting runs.
+- Added installer generator, schema template, and base configuration defaults.
+
+Status notes:
+
+- This release is still WIP and not production-ready.
+- Breaking changes are expected before `1.0`.

data/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Solid Agent
+
+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/README.md

@@ -0,0 +1,111 @@
+# SolidAgents
+
+**Automation workflows for Rails apps, powered by agent runtimes.**
+
+> [!WARNING]
+> `solid_agents` is an early release and still a work in progress.
+> APIs, schema, runtime behavior, and configuration may change between minor releases.
+> Expect breaking changes before `1.0`.
+> Not production-ready yet.
+
+`solid_agents` is a Rails engine that consumes observability/incident APIs (for example from `solid_events`), stores automation run state, dispatches work to runtime executors (TinyClaw in development, OpenClaw in production), and provides a built-in dashboard for operations.
+
+## Scope
+
+`solid_agents` is strictly for automation and execution:
+
+- Consume incident/trace APIs and operator instructions
+- Plan/execute workflows (triage, patch, test, PR, QA, review loops)
+- Track run lifecycle, artifacts, and runtime outputs
+- Route tasks to runtime adapters (TinyClaw/OpenClaw)
+
+It does **not** own observability storage or incident detection/state as a source of truth. That belongs in `solid_events`.
+
+## Features
+
+- DB-backed run lifecycle (`queued`, `running`, `succeeded`, `failed`)
+- Separate agent profiles per environment
+- Runtime adapters for TinyClaw and OpenClaw
+- Built-in UI for runs, events, artifacts, and agent configuration
+- Install generator and schema template aligned with Solid gem conventions
+
+## Installation
+
+Add this to your Gemfile:
+
+```ruby
+gem "solid_agents"
+```
+
+Run installer:
+
+```bash
+rails generate solid_agents:install
+```
+
+Add a dedicated database in `config/database.yml` (recommended):
+
+```yaml
+production:
+  primary: &primary
+    <<: *default
+    database: app_production
+  solid_agents:
+    <<: *primary
+    database: app_production_solid_agents
+    migrations_paths: db/agent_migrate
+```
+
+Configure engine DB connection:
+
+```ruby
+# config/environments/production.rb
+config.solid_agents.connects_to = { database: { writing: :solid_agents } }
+config.solid_agents.default_runtime = :openclaw
+```
+
+Mount the UI:
+
+```ruby
+# config/routes.rb
+authenticate :user, ->(u) { u.admin? } do
+  mount SolidAgents::Engine, at: "/solid_agents"
+end
+```
+
+## Usage
+
+Create an agent profile:
+
+```ruby
+SolidAgents::Agent.create!(
+  key: "fixer",
+  name: "Bug Fixer",
+  role: "fixer",
+  runtime: Rails.env.production? ? "openclaw" : "tinyclaw",
+  working_directory: Rails.root.to_s,
+  capabilities_json: {"allow_pr" => Rails.env.production?}
+)
+```
+
+Dispatch from a job:
+
+```ruby
+SolidAgents.dispatch_error(source: solid_error_record, agent_key: "fixer")
+```
+
+## Configuration
+
+```ruby
+config.solid_agents.tinyclaw_command = "tinyclaw"
+config.solid_agents.openclaw_command = "openclaw"
+config.solid_agents.default_test_command = "bin/rails test"
+config.solid_agents.max_iterations = 8
+```
+
+## Development
+
+```bash
+bundle install
+bundle exec rake test
+```

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.pattern = "test/**/*_test.rb"
+  t.verbose = true
+end
+
+task default: :test

data/app/controllers/solid_agents/agents_controller.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module SolidAgents
+  class AgentsController < ApplicationController
+    before_action :set_agent, only: %i[show edit update]
+
+    def index
+      @agents = SolidAgents::Agent.order(:key)
+    end
+
+    def show; end
+
+    def edit; end
+
+    def update
+      if @agent.update(agent_params)
+        redirect_to agent_path(@agent), notice: "Agent updated."
+      else
+        render :edit, status: :unprocessable_entity
+      end
+    end
+
+    private
+
+    def set_agent
+      @agent = SolidAgents::Agent.find(params[:id])
+    end
+
+    def agent_params
+      params.require(:agent).permit(:name, :role, :runtime, :enabled, :model, :working_directory, :timeout_seconds, :max_iterations, :environment, :system_prompt)
+    end
+  end
+end

data/app/controllers/solid_agents/application_controller.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module SolidAgents
+  class ApplicationController < SolidAgents.base_controller_class.constantize
+    layout "solid_agents/application"
+    protect_from_forgery with: :exception
+  end
+end

data/app/controllers/solid_agents/runs_controller.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module SolidAgents
+  class RunsController < ApplicationController
+    helper SolidAgents::RunsHelper
+    before_action :set_run, only: %i[show retry]
+
+    def index
+      @runs = SolidAgents::Run.includes(:agent).order(created_at: :desc).limit(100)
+    end
+
+    def show
+      @events = @run.events.order(sequence: :asc)
+      @artifacts = @run.artifacts.order(created_at: :desc)
+    end
+
+    def retry
+      duplicated = @run.dup
+      duplicated.status = :queued
+      duplicated.started_at = nil
+      duplicated.finished_at = nil
+      duplicated.error_payload = nil
+      duplicated.result_payload = nil
+      duplicated.external_key = "retry-#{@run.id}-#{Time.current.to_i}"
+      duplicated.save!
+      duplicated.append_event!("retried", message: "Run created from retry", payload: {original_run_id: @run.id})
+      SolidAgents::ExecuteRunJob.perform_later(duplicated.id)
+
+      redirect_to run_path(duplicated), notice: "Run retried."
+    end
+
+    private
+
+    def set_run
+      @run = SolidAgents::Run.find(params[:id])
+    end
+  end
+end

data/app/helpers/solid_agents/runs_helper.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module SolidAgents
+  module RunsHelper
+    def status_badge_class(status)
+      case status
+      when "succeeded" then "ok"
+      when "failed" then "err"
+      when "running" then "run"
+      else "muted"
+      end
+    end
+  end
+end

data/app/jobs/solid_agents/execute_run_job.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module SolidAgents
+  class ExecuteRunJob < ActiveJob::Base
+    queue_as :default
+
+    def perform(run_id)
+      run = SolidAgents::Run.find(run_id)
+      SolidAgents::Runs::Executor.call(run)
+    end
+  end
+end

data/app/models/solid_agents/agent.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module SolidAgents
+  class Agent < Record
+    self.table_name = "solid_agents_agents"
+
+    ROLES = %w[fixer reviewer qa custom].freeze
+
+    has_many :runs, class_name: "SolidAgents::Run", dependent: :nullify
+
+    validates :key, :name, :runtime, presence: true
+    validates :key, uniqueness: {scope: :environment}
+    validates :role, inclusion: {in: ROLES}
+
+    scope :enabled, -> { where(enabled: true) }
+    scope :for_environment, ->(env) { where(environment: [nil, env.to_s]) }
+
+    def runtime_sym
+      runtime.to_sym
+    end
+
+    def capability?(name)
+      capabilities_json.to_h.fetch(name.to_s, false)
+    end
+  end
+end

data/app/models/solid_agents/artifact.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module SolidAgents
+  class Artifact < Record
+    self.table_name = "solid_agents_artifacts"
+
+    belongs_to :run, class_name: "SolidAgents::Run"
+
+    validates :kind, :storage_type, presence: true
+  end
+end

data/app/models/solid_agents/config.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module SolidAgents
+  class Config < Record
+    self.table_name = "solid_agents_configs"
+
+    validates :key, presence: true, uniqueness: {scope: :environment}
+
+    def self.get(key, environment: Rails.env)
+      row = where(key: key, environment: [environment, nil]).order(Arel.sql("environment IS NULL")).first
+      row&.value_json
+    end
+  end
+end

data/app/models/solid_agents/record.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module SolidAgents
+  class Record < ActiveRecord::Base
+    self.abstract_class = true
+
+    connects_to(**SolidAgents.connects_to) if SolidAgents.connects_to
+  end
+end
+
+ActiveSupport.run_load_hooks :solid_agents_record, SolidAgents::Record

data/app/models/solid_agents/run.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module SolidAgents
+  class Run < Record
+    self.table_name = "solid_agents_runs"
+
+    STATUSES = {
+      queued: "queued",
+      running: "running",
+      pr_opened: "pr_opened",
+      succeeded: "succeeded",
+      failed: "failed",
+      canceled: "canceled"
+    }.freeze
+
+    belongs_to :agent, class_name: "SolidAgents::Agent"
+    has_many :events, class_name: "SolidAgents::RunEvent", foreign_key: :run_id, dependent: :delete_all
+    has_many :artifacts, class_name: "SolidAgents::Artifact", foreign_key: :run_id, dependent: :delete_all
+
+    enum :status, STATUSES
+
+    validates :runtime, :environment, :status, :source_type, presence: true
+    validates :external_key, uniqueness: true, allow_nil: true
+
+    before_validation :set_defaults, on: :create
+
+    def append_event!(event_type, message:, payload: nil)
+      next_sequence = (events.maximum(:sequence) || 0) + 1
+      events.create!(event_type: event_type, message: message, payload: payload || {}, event_time: Time.current, sequence: next_sequence)
+    end
+
+    private
+
+    def set_defaults
+      self.status ||= :queued
+      self.runtime ||= agent&.runtime || SolidAgents.default_runtime.to_s
+      self.environment ||= Rails.env
+      self.test_command ||= SolidAgents.default_test_command
+    end
+  end
+end

data/app/models/solid_agents/run_event.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module SolidAgents
+  class RunEvent < Record
+    self.table_name = "solid_agents_run_events"
+
+    belongs_to :run, class_name: "SolidAgents::Run"
+
+    validates :event_type, :message, :sequence, :event_time, presence: true
+    validates :sequence, uniqueness: {scope: :run_id}
+  end
+end

data/app/services/solid_agents/runs/context_builder.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module SolidAgents
+  module Runs
+    class ContextBuilder
+      def self.call(source:)
+        if source.respond_to?(:attributes)
+          source.attributes.slice("id", "message", "class_name", "backtrace", "context")
+        else
+          {value: source.to_s}
+        end
+      end
+    end
+  end
+end

data/app/services/solid_agents/runs/dispatch.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module SolidAgents
+  module Runs
+    class Dispatch
+      def self.call(source:, agent_key:)
+        environment = Rails.env
+        agent = SolidAgents::Agent.enabled.for_environment(environment).find_by!(key: agent_key)
+
+        run = SolidAgents::Run.create!(
+          agent: agent,
+          source_type: source.class.name,
+          source_id: source.respond_to?(:id) ? source.id : nil,
+          runtime: agent.runtime,
+          environment: environment,
+          external_key: "#{source.class.name}-#{source.respond_to?(:id) ? source.id : source.object_id}-#{Time.current.to_i}",
+          repo_path: agent.working_directory,
+          base_branch: "main",
+          max_iterations: agent.max_iterations
+        )
+
+        context = ContextBuilder.call(source: source)
+        run.update!(prompt_payload: context)
+        run.append_event!("dispatched", message: "Run dispatched from source", payload: {agent_key: agent.key})
+
+        SolidAgents::ExecuteRunJob.perform_later(run.id)
+        run
+      end
+    end
+  end
+end

data/app/services/solid_agents/runs/executor.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module SolidAgents
+  module Runs
+    class Executor
+      def self.call(run)
+        run.update!(status: :running, started_at: Time.current)
+        run.append_event!("runtime_started", message: "Runtime execution started")
+
+        prompt = PromptBuilder.call(run: run, context: run.prompt_payload || {})
+        adapter = SolidAgents.runtime_adapter(run.runtime)
+        result = adapter.execute(run: run, prompt: prompt)
+
+        run.artifacts.create!(kind: "log", label: "runtime_output", storage_type: "inline", content_text: result.output.to_s)
+
+        if result.ok
+          metadata = result.metadata.to_h
+          run.update!(status: :succeeded, finished_at: Time.current, result_payload: {output: result.output, metadata: metadata})
+          run.append_event!("runtime_succeeded", message: "Runtime execution finished", payload: metadata)
+        else
+          run.update!(status: :failed, finished_at: Time.current, error_payload: {stderr: result.error, metadata: result.metadata})
+          run.append_event!("runtime_failed", message: "Runtime execution failed", payload: result.metadata.to_h.merge("stderr" => result.error.to_s))
+        end
+
+        run
+      end
+    end
+  end
+end

data/app/services/solid_agents/runs/prompt_builder.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require "json"
+
+module SolidAgents
+  module Runs
+    class PromptBuilder
+      def self.call(run:, context:)
+        <<~PROMPT
+          You are #{run.agent.name} (#{run.agent.role}).
+          Goal: fix the reported Rails issue end-to-end.
+
+          Constraints:
+          - Work in repository: #{run.repo_path}
+          - Base branch: #{run.base_branch}
+          - Test command: #{run.test_command}
+          - Max iterations: #{run.max_iterations || SolidAgents.max_iterations}
+          - Open PR allowed: #{run.agent.capability?("allow_pr")}
+
+          Context JSON:
+          #{JSON.pretty_generate(context)}
+
+          Definition of done:
+          1) Root cause identified.
+          2) Code fix applied.
+          3) Tests added or updated.
+          4) Tests executed and passing.
+          5) Return final JSON with keys: status, branch_name, test_summary, pr_url, notes.
+        PROMPT
+      end
+    end
+  end
+end

data/app/views/layouts/solid_agents/_style.html.erb

@@ -0,0 +1,128 @@
+<style>
+  :root {
+    --bg: #f4f7fb;
+    --surface: #ffffff;
+    --ink: #17202a;
+    --muted: #5e6b78;
+    --line: #dbe4ee;
+    --accent: #0f766e;
+    --good: #166534;
+    --bad: #b91c1c;
+    --run: #7c3aed;
+  }
+
+  * { box-sizing: border-box; }
+
+  body {
+    margin: 0;
+    font-family: ui-sans-serif, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+    background: radial-gradient(circle at 5% 0%, #d7f7f0 0%, transparent 35%), var(--bg);
+    color: var(--ink);
+  }
+
+  .wrap { width: min(1100px, 94vw); margin: 0 auto; }
+
+  .topbar {
+    background: var(--surface);
+    border-bottom: 1px solid var(--line);
+    margin-bottom: 1.25rem;
+  }
+
+  .topbar .wrap {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    padding: .8rem 0;
+  }
+
+  .topbar h1 {
+    font-size: 1.1rem;
+    margin: 0;
+    letter-spacing: .02em;
+  }
+
+  .topbar nav { display: flex; gap: .75rem; }
+
+  .topbar a {
+    color: var(--ink);
+    text-decoration: none;
+    padding: .35rem .65rem;
+    border-radius: .5rem;
+    border: 1px solid transparent;
+  }
+
+  .topbar a:hover { border-color: var(--line); background: #f8fbff; }
+
+  .card {
+    background: var(--surface);
+    border: 1px solid var(--line);
+    border-radius: .9rem;
+    padding: 1rem;
+    margin-bottom: 1rem;
+    box-shadow: 0 1px 0 rgba(16,24,40,.02);
+  }
+
+  table { width: 100%; border-collapse: collapse; }
+
+  th, td {
+    text-align: left;
+    padding: .65rem .5rem;
+    border-bottom: 1px solid var(--line);
+    font-size: .93rem;
+  }
+
+  th { color: var(--muted); font-size: .8rem; text-transform: uppercase; letter-spacing: .05em; }
+
+  .badge {
+    display: inline-block;
+    padding: .2rem .55rem;
+    border-radius: .55rem;
+    font-size: .75rem;
+    font-weight: 700;
+    text-transform: uppercase;
+    letter-spacing: .04em;
+  }
+
+  .badge.ok { background: #dcfce7; color: var(--good); }
+  .badge.err { background: #fee2e2; color: var(--bad); }
+  .badge.run { background: #ede9fe; color: var(--run); }
+  .badge.muted { background: #eef2f7; color: var(--muted); }
+
+  .grid { display: grid; grid-template-columns: 1fr 1fr; gap: 1rem; }
+
+  .flash {
+    padding: .6rem .8rem;
+    border-radius: .65rem;
+    border: 1px solid var(--line);
+  }
+
+  .notice { background: #ecfeff; }
+  .alert { background: #fff7ed; }
+
+  .btn {
+    display: inline-block;
+    border: 1px solid var(--line);
+    background: #fff;
+    color: var(--ink);
+    border-radius: .55rem;
+    padding: .45rem .7rem;
+    text-decoration: none;
+    cursor: pointer;
+  }
+
+  .btn.primary { background: var(--accent); border-color: var(--accent); color: #fff; }
+
+  pre {
+    background: #0b1220;
+    color: #d1e0ff;
+    border-radius: .8rem;
+    padding: .85rem;
+    overflow: auto;
+    font-size: .82rem;
+  }
+
+  @media (max-width: 800px) {
+    .grid { grid-template-columns: 1fr; }
+    th:nth-child(4), td:nth-child(4) { display: none; }
+  }
+</style>

data/app/views/layouts/solid_agents/application.html.erb

@@ -0,0 +1,26 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta name="viewport" content="width=device-width,initial-scale=1" />
+    <title>SolidAgents</title>
+    <%= csrf_meta_tags %>
+    <%= csp_meta_tag %>
+    <%= render "layouts/solid_agents/style" %>
+  </head>
+  <body>
+    <header class="topbar">
+      <div class="wrap">
+        <h1>SolidAgents</h1>
+        <nav>
+          <%= link_to "Runs", runs_path %>
+          <%= link_to "Agents", agents_path %>
+        </nav>
+      </div>
+    </header>
+    <main class="wrap">
+      <% if notice.present? %><p class="flash notice"><%= notice %></p><% end %>
+      <% if alert.present? %><p class="flash alert"><%= alert %></p><% end %>
+      <%= yield %>
+    </main>
+  </body>
+</html>

data/app/views/solid_agents/agents/edit.html.erb

@@ -0,0 +1,17 @@
+<div class="card">
+  <h2>Edit Agent <%= @agent.key %></h2>
+
+  <%= form_with model: @agent, url: agent_path(@agent), method: :patch do |f| %>
+    <p><%= f.label :name %><br><%= f.text_field :name %></p>
+    <p><%= f.label :role %><br><%= f.select :role, SolidAgents::Agent::ROLES %></p>
+    <p><%= f.label :runtime %><br><%= f.select :runtime, %w[tinyclaw openclaw] %></p>
+    <p><%= f.label :environment %><br><%= f.text_field :environment %></p>
+    <p><%= f.label :model %><br><%= f.text_field :model %></p>
+    <p><%= f.label :working_directory %><br><%= f.text_field :working_directory %></p>
+    <p><%= f.label :timeout_seconds %><br><%= f.number_field :timeout_seconds %></p>
+    <p><%= f.label :max_iterations %><br><%= f.number_field :max_iterations %></p>
+    <p><%= f.label :system_prompt %><br><%= f.text_area :system_prompt, rows: 8, cols: 80 %></p>
+    <p><%= f.label :enabled %> <%= f.check_box :enabled %></p>
+    <p><%= f.submit "Save", class: "btn primary" %></p>
+  <% end %>
+</div>

data/app/views/solid_agents/agents/index.html.erb

@@ -0,0 +1,27 @@
+<div class="card">
+  <h2>Agents</h2>
+  <table>
+    <thead>
+      <tr>
+        <th>Key</th>
+        <th>Name</th>
+        <th>Role</th>
+        <th>Runtime</th>
+        <th>Env</th>
+        <th>Enabled</th>
+      </tr>
+    </thead>
+    <tbody>
+      <% @agents.each do |agent| %>
+        <tr>
+          <td><%= link_to agent.key, agent_path(agent) %></td>
+          <td><%= agent.name %></td>
+          <td><%= agent.role %></td>
+          <td><%= agent.runtime %></td>
+          <td><%= agent.environment || "all" %></td>
+          <td><%= agent.enabled? ? "yes" : "no" %></td>
+        </tr>
+      <% end %>
+    </tbody>
+  </table>
+</div>

data/app/views/solid_agents/agents/show.html.erb

@@ -0,0 +1,11 @@
+<div class="card">
+  <h2>Agent: <%= @agent.key %></h2>
+  <p>Name: <strong><%= @agent.name %></strong></p>
+  <p>Role: <strong><%= @agent.role %></strong></p>
+  <p>Runtime: <strong><%= @agent.runtime %></strong></p>
+  <p>Environment: <strong><%= @agent.environment || "all" %></strong></p>
+  <p>Working directory: <code><%= @agent.working_directory %></code></p>
+  <p>Model: <code><%= @agent.model %></code></p>
+  <p>Enabled: <strong><%= @agent.enabled? ? "yes" : "no" %></strong></p>
+  <%= link_to "Edit", edit_agent_path(@agent), class: "btn" %>
+</div>

data/app/views/solid_agents/runs/index.html.erb

@@ -0,0 +1,27 @@
+<div class="card">
+  <h2>Runs</h2>
+  <table>
+    <thead>
+      <tr>
+        <th>ID</th>
+        <th>Agent</th>
+        <th>Status</th>
+        <th>Runtime</th>
+        <th>Source</th>
+        <th>Started</th>
+      </tr>
+    </thead>
+    <tbody>
+      <% @runs.each do |run| %>
+        <tr>
+          <td><%= link_to "##{run.id}", run_path(run) %></td>
+          <td><%= run.agent&.key %></td>
+          <td><span class="badge <%= status_badge_class(run.status) %>"><%= run.status %></span></td>
+          <td><%= run.runtime %></td>
+          <td><%= [run.source_type, run.source_id].compact.join("#") %></td>
+          <td><%= run.started_at || run.created_at %></td>
+        </tr>
+      <% end %>
+    </tbody>
+  </table>
+</div>

data/app/views/solid_agents/runs/show.html.erb

@@ -0,0 +1,48 @@
+<div class="card">
+  <h2>Run #<%= @run.id %></h2>
+  <p>
+    Agent: <strong><%= @run.agent.key %></strong> |
+    Runtime: <strong><%= @run.runtime %></strong> |
+    Status: <span class="badge <%= status_badge_class(@run.status) %>"><%= @run.status %></span>
+  </p>
+  <p>
+    Source: <%= [@run.source_type, @run.source_id].compact.join("#") %>
+  </p>
+  <%= button_to "Retry", retry_run_path(@run), method: :post, class: "btn primary" %>
+</div>
+
+<div class="grid">
+  <div class="card">
+    <h3>Events</h3>
+    <table>
+      <thead>
+        <tr>
+          <th>#</th>
+          <th>Type</th>
+          <th>Message</th>
+        </tr>
+      </thead>
+      <tbody>
+        <% @events.each do |event| %>
+          <tr>
+            <td><%= event.sequence %></td>
+            <td><%= event.event_type %></td>
+            <td><%= event.message %></td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+  </div>
+
+  <div class="card">
+    <h3>Artifacts</h3>
+    <% @artifacts.each do |artifact| %>
+      <h4><%= artifact.kind %> - <%= artifact.label %></h4>
+      <% if artifact.content_text.present? %>
+        <pre><%= artifact.content_text %></pre>
+      <% else %>
+        <pre><%= artifact.content_json %></pre>
+      <% end %>
+    <% end %>
+  </div>
+</div>

data/config/locales/en.yml

@@ -0,0 +1,6 @@
+en:
+  solid_agents:
+    runs:
+      title: "Agent Runs"
+    agents:
+      title: "Agents"

data/config/routes.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+SolidAgents::Engine.routes.draw do
+  resources :agents, only: %i[index show edit update]
+
+  resources :runs, only: %i[index show], path: "" do
+    member { post :retry }
+  end
+end

data/lib/generators/solid_agents/install/USAGE

@@ -0,0 +1,4 @@
+Run the schema install and add a `solid_agents` database in your app's `config/database.yml`.
+Then mount the UI in routes:
+
+  mount SolidAgents::Engine, at: "/solid_agents"

data/lib/generators/solid_agents/install/install_generator.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module SolidAgents
+  class InstallGenerator < Rails::Generators::Base
+    source_root File.expand_path("templates", __dir__)
+
+    def add_schema
+      template "db/agent_schema.rb"
+    end
+
+    def add_initializer
+      template "config/initializers/solid_agents.rb"
+    end
+
+    def configure_environment
+      insert_into_file Pathname(destination_root).join("config/environments/production.rb"), after: /^([ \t]*).*?(?=\nend)$/ do
+        [
+          "",
+          '\\1# Configure Solid Agent',
+          '\\1config.solid_agents.connects_to = { database: { writing: :solid_agents } }',
+          '\\1config.solid_agents.default_runtime = :openclaw'
+        ].join("\n")
+      end
+    end
+
+    def ensure_migrations_directory
+      empty_directory "db/agent_migrate"
+      keep_path = Pathname(destination_root).join("db/agent_migrate/.gitkeep")
+      return if keep_path.exist?
+
+      create_file "db/agent_migrate/.gitkeep", "# Keep the SolidAgents migrations directory tracked by Git.\n"
+    end
+  end
+end

data/lib/generators/solid_agents/install/templates/config/initializers/solid_agents.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+Rails.application.configure do
+  # Optional: override in specific environments.
+  # config.solid_agents.connects_to = { database: { writing: :solid_agents } }
+
+  config.solid_agents.tinyclaw_command = ENV.fetch("SOLID_AGENTS_TINYCLAW_COMMAND", "tinyclaw")
+  config.solid_agents.openclaw_command = ENV.fetch("SOLID_AGENTS_OPENCLAW_COMMAND", "openclaw")
+  config.solid_agents.default_test_command = ENV.fetch("SOLID_AGENTS_TEST_COMMAND", "bin/rails test")
+  config.solid_agents.max_iterations = ENV.fetch("SOLID_AGENTS_MAX_ITERATIONS", 8).to_i
+end

data/lib/generators/solid_agents/install/templates/db/agent_schema.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+ActiveRecord::Schema[6.1].define do
+  create_table :solid_agents_agents, force: :cascade do |t|
+    t.string :key, null: false
+    t.string :name, null: false
+    t.string :role, null: false, default: "fixer"
+    t.string :runtime, null: false, default: "tinyclaw"
+    t.boolean :enabled, null: false, default: true
+    t.string :environment
+    t.string :model
+    t.text :system_prompt
+    t.json :capabilities_json, default: {}
+    t.string :working_directory
+    t.integer :timeout_seconds, null: false, default: 900
+    t.integer :max_iterations, null: false, default: 8
+    t.timestamps
+  end
+
+  add_index :solid_agents_agents, [:key, :environment], unique: true
+
+  create_table :solid_agents_runs, force: :cascade do |t|
+    t.references :agent, null: false, foreign_key: {to_table: :solid_agents_agents}
+    t.string :external_key
+    t.string :source_type, null: false
+    t.bigint :source_id
+    t.string :error_fingerprint
+    t.string :status, null: false, default: "queued"
+    t.string :runtime, null: false
+    t.string :environment, null: false
+    t.string :repo_path
+    t.string :base_branch
+    t.string :work_branch
+    t.string :commit_sha
+    t.string :pr_url
+    t.integer :pr_number
+    t.string :test_command
+    t.integer :attempt_count, null: false, default: 0
+    t.integer :max_iterations
+    t.datetime :started_at
+    t.datetime :finished_at
+    t.json :prompt_payload, default: {}
+    t.json :result_payload, default: {}
+    t.json :error_payload, default: {}
+    t.timestamps
+  end
+
+  add_index :solid_agents_runs, :external_key, unique: true
+  add_index :solid_agents_runs, :status
+  add_index :solid_agents_runs, :error_fingerprint
+  add_index :solid_agents_runs, [:source_type, :source_id]
+
+  create_table :solid_agents_run_events, force: :cascade do |t|
+    t.references :run, null: false, foreign_key: {to_table: :solid_agents_runs}
+    t.string :event_type, null: false
+    t.datetime :event_time, null: false
+    t.text :message, null: false
+    t.json :payload, default: {}
+    t.integer :sequence, null: false
+    t.timestamps
+  end
+
+  add_index :solid_agents_run_events, [:run_id, :sequence], unique: true
+  add_index :solid_agents_run_events, :event_type
+
+  create_table :solid_agents_artifacts, force: :cascade do |t|
+    t.references :run, null: false, foreign_key: {to_table: :solid_agents_runs}
+    t.string :kind, null: false
+    t.string :label
+    t.string :storage_type, null: false
+    t.string :storage_ref
+    t.text :content_text
+    t.json :content_json, default: {}
+    t.string :sha256
+    t.bigint :byte_size
+    t.timestamps
+  end
+
+  add_index :solid_agents_artifacts, :kind
+
+  create_table :solid_agents_configs, force: :cascade do |t|
+    t.string :key, null: false
+    t.string :environment
+    t.json :value_json, default: {}
+    t.timestamps
+  end
+
+  add_index :solid_agents_configs, [:key, :environment], unique: true
+end

data/lib/solid_agents/engine.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module SolidAgents
+  class Engine < ::Rails::Engine
+    config.root = File.expand_path("../..", __dir__)
+    isolate_namespace SolidAgents
+
+    config.solid_agents = ActiveSupport::OrderedOptions.new
+
+    initializer "solid_agents.configure" do
+      config.solid_agents.each do |name, value|
+        SolidAgents.public_send(:"#{name}=", value)
+      end
+    end
+  end
+end

data/lib/solid_agents/runtime/adapter.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require "open3"
+
+module SolidAgents
+  module Runtime
+    class Adapter
+      Result = Struct.new(:ok, :output, :error, :metadata, keyword_init: true)
+
+      def execute(_run:, _prompt:)
+        raise NotImplementedError
+      end
+
+      private
+
+      def run_command(*argv)
+        stdout, stderr, status = Open3.capture3(*argv)
+        Result.new(ok: status.success?, output: stdout, error: stderr, metadata: {exit_status: status.exitstatus, command: argv})
+      end
+    end
+  end
+end

data/lib/solid_agents/runtime/openclaw_adapter.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module SolidAgents
+  module Runtime
+    class OpenclawAdapter < Adapter
+      def execute(run:, prompt:)
+        command = [SolidAgents.openclaw_command.to_s, "agent", "--message", prompt, "--thinking", "high"]
+        run_command(*command)
+      end
+    end
+  end
+end

data/lib/solid_agents/runtime/tinyclaw_adapter.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module SolidAgents
+  module Runtime
+    class TinyclawAdapter < Adapter
+      def execute(run:, prompt:)
+        command = [SolidAgents.tinyclaw_command.to_s, "send", "@#{run.agent.key} #{prompt}"]
+        run_command(*command)
+      end
+    end
+  end
+end

data/lib/solid_agents/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module SolidAgents
+  VERSION = "0.1.0"
+end

data/lib/solid_agents.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require_relative "solid_agents/version"
+require_relative "solid_agents/runtime/adapter"
+require_relative "solid_agents/runtime/tinyclaw_adapter"
+require_relative "solid_agents/runtime/openclaw_adapter"
+require_relative "solid_agents/engine"
+
+module SolidAgents
+  mattr_accessor :connects_to
+  mattr_accessor :base_controller_class, default: "::ActionController::Base"
+  mattr_accessor :default_runtime, default: :tinyclaw
+  mattr_accessor :tinyclaw_command, default: "tinyclaw"
+  mattr_accessor :openclaw_command, default: "openclaw"
+  mattr_accessor :default_test_command, default: "bin/rails test"
+  mattr_accessor :max_iterations, default: 8
+
+  class << self
+    def runtime_adapter(runtime)
+      case runtime.to_sym
+      when :tinyclaw then SolidAgents::Runtime::TinyclawAdapter.new
+      when :openclaw then SolidAgents::Runtime::OpenclawAdapter.new
+      else
+        raise ArgumentError, "Unsupported runtime: #{runtime.inspect}"
+      end
+    end
+
+    def dispatch_error(source:, agent_key: "fixer")
+      SolidAgents::Runs::Dispatch.call(source: source, agent_key: agent_key)
+    end
+  end
+end

metadata

@@ -0,0 +1,179 @@
+--- !ruby/object:Gem::Specification
+name: solid_agents
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Kaka Ruto
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: actionpack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.1'
+- !ruby/object:Gem::Dependency
+  name: actionview
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.1'
+- !ruby/object:Gem::Dependency
+  name: activejob
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.1'
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.1'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.1'
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.1'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+description: Solid Agent stores agent runs in its own database and dispatches work
+  to tinyclaw/openclaw runtimes with a built-in Rails UI.
+email:
+- kr@kakaruto.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- app/controllers/solid_agents/agents_controller.rb
+- app/controllers/solid_agents/application_controller.rb
+- app/controllers/solid_agents/runs_controller.rb
+- app/helpers/solid_agents/runs_helper.rb
+- app/jobs/solid_agents/execute_run_job.rb
+- app/models/solid_agents/agent.rb
+- app/models/solid_agents/artifact.rb
+- app/models/solid_agents/config.rb
+- app/models/solid_agents/record.rb
+- app/models/solid_agents/run.rb
+- app/models/solid_agents/run_event.rb
+- app/services/solid_agents/runs/context_builder.rb
+- app/services/solid_agents/runs/dispatch.rb
+- app/services/solid_agents/runs/executor.rb
+- app/services/solid_agents/runs/prompt_builder.rb
+- app/views/layouts/solid_agents/_style.html.erb
+- app/views/layouts/solid_agents/application.html.erb
+- app/views/solid_agents/agents/edit.html.erb
+- app/views/solid_agents/agents/index.html.erb
+- app/views/solid_agents/agents/show.html.erb
+- app/views/solid_agents/runs/index.html.erb
+- app/views/solid_agents/runs/show.html.erb
+- config/locales/en.yml
+- config/routes.rb
+- lib/generators/solid_agents/install/USAGE
+- lib/generators/solid_agents/install/install_generator.rb
+- lib/generators/solid_agents/install/templates/config/initializers/solid_agents.rb
+- lib/generators/solid_agents/install/templates/db/agent_schema.rb
+- lib/solid_agents.rb
+- lib/solid_agents/engine.rb
+- lib/solid_agents/runtime/adapter.rb
+- lib/solid_agents/runtime/openclaw_adapter.rb
+- lib/solid_agents/runtime/tinyclaw_adapter.rb
+- lib/solid_agents/version.rb
+homepage: https://github.com/kaka-ruto/solid_agents
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/kaka-ruto/solid_agents
+  source_code_uri: https://github.com/kaka-ruto/solid_agents
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.3
+specification_version: 4
+summary: Database-backed Rails AI agent runtime bridge
+test_files: []