silas 0.1.2 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e6f592c5f4b254794f9a2a9cd4efc87d70b898f685f50ffff75c7af41415a7d8
-  data.tar.gz: 43871af8708f50e68803bc727975201d693ba4337ddf056f54062fb8e6070208
+  metadata.gz: be0574c8a9c71366220b9be69d9f3d679a6c0a469d907bec1fb2a7d53436f6b3
+  data.tar.gz: 5ac2adcf62f854ec3a4b8206c0d9a19bd33bb3b631615e36bffed425757126ca
 SHA512:
-  metadata.gz: f1b8239d3d5eaaf1de6d199ac1a3fd53562cc7c1e8d8b6f67124974810fbe811692aa2d466a4d595660bca13cbc98c98ae0b500275bc54e216e2a2a4b8810fb5
-  data.tar.gz: d1a1132bb5b027b19e338e40b57ac9a418f8bdde7fefe11f1d20a196cf6f7ecd7999fd0f7209f45c1e21ef7445a313d65f88abd2dabe56c00fc5dafaf79e9279
+  metadata.gz: 3a0be6b63aec608abe5cf2c72f0533c79b7150f8d389344a36e68c90122055fb1f304a4a251ade503467c875c21d99ddd9d136fa37f4d4734d1d5bda9c158bd6
+  data.tar.gz: 1340782f9cb00620e4e1ed5e9c5b9dc9fc8d96a9310d3d9e67e55004363352e4d17e98f62d1cb6054738b2fed1052c0c7e92f576f5afe587a33770db5294cc48

data/CHANGELOG.md

@@ -1,5 +1,46 @@
 # Changelog
 
+## 0.1.4
+
+- **Fresh-app quickstart actually works.** A from-scratch install previously
+  failed at its own post-install steps: the generated default model
+  ("claude-sonnet-5") wasn't in ruby_llm 1.16's bundled registry, and no
+  provider-key initializer was generated, so the first turn raised. The
+  generator now emits `config/initializers/ruby_llm.rb` (maps
+  `ANTHROPIC_API_KEY`), defaults to the registry-known `claude-opus-4-8`, and a
+  missing model raises an actionable error suggesting
+  `RubyLLM.models.refresh!`.
+- **`silas:schedules` no longer crashes on the generator's own template.** The
+  example schedule's ERB comment rendered a leading blank line the frontmatter
+  parser rejected; template fixed and the parser now tolerates leading
+  whitespace.
+- **`bin/ci` is never clobbered.** Rails 8.1 ships a real bin/ci; the installer
+  now leaves an existing one untouched and tells you to add
+  `bin/rails silas:eval` to it.
+- **Correct Opus 4.8 pricing.** Default `model_prices` had Opus 4.8 at $15/$75
+  per MTok; it is $5/$25. Added Sonnet 4.6 and the `claude-haiku-4-5` alias.
+- **ruby_llm dependency bounded `< 2`** (2.0 removes APIs the engine relies on).
+- **`bin/rails silas:chat` — a terminal REPL for your agent.** The dev-loop a
+  hosted platform gives you from its CLI, except there is no platform: it runs
+  inside your app, tools hit your real dev database, and parked approvals prompt
+  inline (`approve? [y]es / [d]ecline / [s]kip`) calling the same
+  `approve!`/`decline!` as the inbox and Slack. `SESSION=id` resumes a session;
+  a new message while a turn is parked steers you to the pending approvals. The
+  task forces the synchronous `:inline` adapter for its own process (a REPL
+  wants each turn settled before the next prompt; production still runs Solid
+  Queue).
+
+## 0.1.3
+
+- **Ledger: parallel graded gates.** When the model emits several tool calls in
+  one step, `settle!` now settles every invocation instead of stopping at the
+  first one that needs approval. An ungated call (e.g. a low-risk write) runs
+  immediately even when a gated sibling (e.g. a money move) parks for a human —
+  it is no longer stranded behind the approval. This changes only *timing*, not
+  safety: an unsettled sibling already executed on resume regardless of the
+  human's approve/decline, so stopping early only delayed independent work.
+  Regression test in `spec/silas/parallel_tool_calls_spec.rb`.
+
 ## 0.1.2
 
 - **Security (email channel scaffold): approvals no longer go to the session

data/README.md

@@ -53,6 +53,23 @@ session.pending_approvals.first.approve!(by: "daniel")
 session.continue(input: "Now email the customer.")
 ```
 
+Or talk to it from the terminal — the REPL runs *inside your app*, so tools hit
+your real dev database, and parked approvals prompt inline (the same
+`approve!`/`decline!` as the inbox and Slack):
+
+```
+$ bin/rails silas:chat
+you> Refund order 42, £12.50
+  ✓ lookup_order(order_id: 42)
+  ⏸ issue_refund(order_id: 42, amount: 1250) — awaiting approval
+
+approval needed — issue_refund(order_id: 42, amount: 1250)
+approve? [y]es / [d]ecline / [s]kip> y
+agent> Done — £12.50 refunded on order 42.
+```
+
+`SESSION=id` resumes an existing session.
+
 ## The durability contract (what's actually guaranteed)
 
 Verified by `chaos_host/bin/chaos` — the harness that kill -9s a live agent

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

@@ -7,6 +7,9 @@ module Silas
 
       def create_initializer
         template "initializer.rb", "config/initializers/silas.rb"
+        # ruby_llm reads no provider keys from ENV on its own; without this the
+        # first model call raises ConfigurationError.
+        template "ruby_llm.rb", "config/initializers/ruby_llm.rb"
       end
 
       def create_agent_directory
@@ -28,11 +31,19 @@ module Silas
         route 'mount Silas::Engine => "/silas"'
       end
 
-      # Evals as a deploy gate: an example scenario + a bin/ci wrapper.
+      # Evals as a deploy gate: an example scenario + a bin/ci wrapper. Rails
+      # 8.1 apps ship their own bin/ci (rubocop, brakeman, tests) — never
+      # clobber it; tell the user to add the eval gate to theirs instead.
       def create_eval_gate
         template "example_eval.rb", "test/agent_evals/example_eval.rb"
-        copy_file "bin_ci", "bin/ci"
-        chmod "bin/ci", 0o755
+
+        if File.exist?(File.expand_path("bin/ci", destination_root))
+          say "bin/ci already exists — left untouched. Add `bin/rails silas:eval` " \
+              "to it to gate deploys on agent evals.", :yellow
+        else
+          copy_file "bin_ci", "bin/ci"
+          chmod "bin/ci", 0o755
+        end
       end
 
       def add_rescuer_recurring_task
@@ -65,14 +76,15 @@ module Silas
 
           Silas installed. Next:
             1. bin/rails db:migrate
-            2. Edit app/agent/instructions.md (your agent's persona)
-            3. Write tools in app/agent/tools/ (keyword signature = schema)
-            4. Silas.agent.start(input: "hello")
-            5. Schedules: edit app/agent/schedules/*, then `bin/rails silas:schedules`
-            6. Channels (optional): set credentials.silas.slack.{signing_secret,bot_token}
+            2. export ANTHROPIC_API_KEY=sk-ant-...  (config/initializers/ruby_llm.rb reads it)
+            3. Edit app/agent/instructions.md (your agent's persona)
+            4. Write tools in app/agent/tools/ (keyword signature = schema)
+            5. Talk to it: bin/rails silas:chat  (or Silas.agent.start(input: "hello"))
+            6. Schedules: edit app/agent/schedules/*, then `bin/rails silas:schedules`
+            7. Channels (optional): set credentials.silas.slack.{signing_secret,bot_token}
                for Slack; route inbound mail to Silas::AgentMailbox for email.
                Delete app/agent/channels/{slack,email}.rb to disable.
-            7. Inbox: live at /silas/inbox once you set config.inbox_auth
+            8. Inbox: live at /silas/inbox once you set config.inbox_auth
                (deny-by-default until you do).
         MSG
       end

data/lib/generators/silas/install/templates/example_schedule.md

@@ -1,5 +1,5 @@
-<%# Task-mode schedule: this markdown body becomes the turn input on each tick. %>
 ---
+# Task-mode schedule: this markdown body becomes the turn input on each tick.
 cron: "0 9 * * *"
 # queue: default
 ---

data/lib/generators/silas/install/templates/initializer.rb

@@ -3,7 +3,10 @@ Silas.configure do |config|
   # :agent_sdk (a `claude -p` subprocess; API-key auth only). See silas/README.
   config.engine = :ruby_llm
 
-  config.default_model = "claude-sonnet-5"
+  # Any model your installed ruby_llm's registry resolves (newer Claude models
+  # may need `RubyLLM.models.refresh!` first). Alternatives: "claude-sonnet-5"
+  # (balanced), "claude-haiku-4-5" (fastest/cheapest).
+  config.default_model = "claude-opus-4-8"
 
   # Parked approvals expire after this long (the turn fails as approval_expired).
   # config.approval_ttl = 7.days

data/lib/generators/silas/install/templates/ruby_llm.rb

@@ -0,0 +1,9 @@
+# Point RubyLLM at your model provider. RubyLLM does NOT read provider API keys
+# from the environment automatically — this initializer maps them in.
+#
+#   export ANTHROPIC_API_KEY=sk-ant-...
+#
+# Any provider RubyLLM supports works the same way (openai_api_key, etc.).
+RubyLLM.configure do |c|
+  c.anthropic_api_key = ENV["ANTHROPIC_API_KEY"]
+end if ENV["ANTHROPIC_API_KEY"].present?

data/lib/silas/chat.rb

@@ -0,0 +1,137 @@
+module Silas
+  # Terminal REPL for talking to the app's agent: `bin/rails silas:chat`.
+  #
+  # The dev-loop equivalent of a hosted platform's CLI — except there is no
+  # platform: this runs inside your app, so tools hit your real dev database
+  # and the transcript is rows in your own Postgres. Parked approvals prompt
+  # inline and call the exact same approve!/decline! as the inbox and Slack.
+  #
+  # IO is injected so the loop is testable; the rake task wires $stdin/$stdout
+  # and forces the synchronous :inline adapter (a REPL wants each turn settled
+  # before the next prompt, and the dev-default Async adapter is unsafe).
+  class Chat
+    GLYPH = { "completed" => "✓", "failed" => "✗", "pending" => "⏸",
+              "started" => "…", "in_doubt" => "?" }.freeze
+
+    def initialize(io_in: $stdin, io_out: $stdout, actor: ENV["USER"] || "cli", session: nil)
+      @in = io_in
+      @out = io_out
+      @actor = actor
+      @session = session
+    end
+
+    def run
+      banner
+      if @session && pending_for(@session).exists? # resuming a session that parked last time
+        settle_parked
+        print_outcome(@session.turns.reload.last)
+      end
+
+      loop do
+        @out.print "\nyou> "
+        line = @in.gets
+        break if line.nil?
+
+        line = line.strip
+        next if line.empty?
+        break if %w[exit quit].include?(line.downcase)
+
+        submit(line)
+      end
+      @out.puts "bye — session #{@session.id}" if @session
+    end
+
+    private
+
+    def banner
+      description = Silas.agent.description.presence || "your agent"
+      @out.puts "Silas chat — #{description} (#{Silas.agent.model})."
+      @out.puts "Approvals prompt inline. 'exit' or Ctrl-D to quit."
+      @out.puts "Resuming session #{@session.id} (#{@session.turns.count} turns)." if @session
+    end
+
+    def submit(text)
+      turn =
+        if @session.nil?
+          @session = Silas.agent.start(input: text)
+          @session.turns.first
+        else
+          @session.continue(input: text)
+        end
+      # start/continue enqueue the loop job; the :inline adapter has already run
+      # it synchronously by the time they return.
+      report(turn)
+    rescue TurnInProgressError
+      @out.puts "! a turn is still parked awaiting approval — settle it first:"
+      settle_parked
+      print_outcome(@session.turns.reload.last)
+    end
+
+    def report(turn)
+      turn.reload
+      print_trace(turn)
+
+      if turn.parked?
+        settle_parked
+        turn.reload
+      end
+
+      print_outcome(turn)
+    end
+
+    def print_outcome(turn)
+      case turn.reload.status
+      when "completed"
+        @out.puts "agent> #{turn.answer_text}"
+      when "waiting", "in_doubt"
+        @out.puts "(parked — #{pending_for(turn.session).count} approval(s) still pending; " \
+                  "they also render in /silas/inbox)"
+      when "failed"
+        @out.puts "(turn failed: #{turn.failure_reason})"
+      end
+    end
+
+    def print_trace(turn)
+      ToolInvocation.where(turn_id: turn.id).order(:id).each do |inv|
+        gate = inv.approval_state == "required" ? " — awaiting approval" : ""
+        @out.puts "  #{GLYPH.fetch(inv.status, '·')} #{inv.tool_name}(#{compact_args(inv.arguments)})#{gate}"
+      end
+    end
+
+    # Prompt for every parked approval in the session. Approving resumes the
+    # turn synchronously (inline adapter), so new invocations may appear —
+    # loop until nothing is pending or the user skips.
+    def settle_parked
+      loop do
+        invocation = pending_for(@session).order(:id).first
+        break unless invocation
+
+        @out.puts "\napproval needed — #{invocation.tool_name}(#{compact_args(invocation.arguments)})"
+        @out.print "approve? [y]es / [d]ecline / [s]kip> "
+        answer = @in.gets&.strip&.downcase
+
+        case answer
+        when "y", "yes"
+          invocation.approve!(by: @actor)
+          @out.puts
+          print_trace(@session.turns.reload.last)
+        when "d", "decline"
+          @out.print "reason> "
+          reason = @in.gets&.strip
+          invocation.decline!(reason: reason.presence || "declined from CLI", by: @actor)
+        else
+          @out.puts "(left parked — approve later here or in /silas/inbox)"
+          break
+        end
+      end
+    end
+
+    def pending_for(session)
+      session.pending_approvals.where(status: %w[pending in_doubt])
+    end
+
+    def compact_args(arguments)
+      (arguments || {}).map { |key, value| "#{key}: #{value.inspect}" }.join(", ")
+    end
+  end
+end

data/lib/silas/configuration.rb

@@ -64,7 +64,9 @@ module Silas
     def initialize
       @engine = :ruby_llm
       @auth = :api_key
-      @default_model = "claude-sonnet-5"
+      # Must be resolvable by the installed ruby_llm's model registry — newer
+      # Claude models may need `RubyLLM.models.refresh!` before they resolve.
+      @default_model = "claude-opus-4-8"
       @queue_name = :default
       @around_model_call = nil
       @approval_ttl = 7.days
@@ -102,10 +104,12 @@ module Silas
       @inbox_public_read = false
       @inbox_actor = ->(controller) { controller.try(:current_user)&.try(:email) || "inbox" }
       # Current Claude rates as cost-units per 1k tokens (1e6 units = $1):
-      # Sonnet $3/$15, Opus $15/$75, Haiku $1/$5 per million tokens.
+      # Opus 4.8 $5/$25, Sonnet $3/$15, Haiku $1/$5 per million tokens.
       @model_prices = {
+        "claude-opus-4-8" => { in: 5000, out: 25_000 },
         "claude-sonnet-5" => { in: 3000, out: 15_000 },
-        "claude-opus-4-8" => { in: 15_000, out: 75_000 },
+        "claude-sonnet-4-6" => { in: 3000, out: 15_000 },
+        "claude-haiku-4-5" => { in: 1000, out: 5000 },
         "claude-haiku-4-5-20251001" => { in: 1000, out: 5000 }
       }
     end

data/lib/silas/engines/ruby_llm.rb

@@ -26,7 +26,14 @@ module Silas
       private
 
       def build_chat(context, &on_event)
-        chat = ::RubyLLM.chat(model: context[:model])
+        chat = begin
+          ::RubyLLM.chat(model: context[:model])
+        rescue ::RubyLLM::ModelNotFoundError
+          raise Silas::Error,
+                "Model #{context[:model].inspect} is not in ruby_llm's model registry. " \
+                "Newer models may need a registry refresh (`RubyLLM.models.refresh!`), " \
+                "or pick a registry-known model in config.default_model / agent.yml."
+        end
         chat.with_instructions(context[:system]) if context[:system].present?
         context[:tools].each { |definition| chat.with_tool(HaltProxy.new(definition)) }
 

data/lib/silas/ledger.rb

@@ -34,12 +34,19 @@ module Silas
               "the continuation believes are committed."
       end
 
+      # Settle EVERY invocation in the step, then report whether the turn must
+      # park. When the model emits parallel tool calls, an ungated one must not
+      # be blocked by a gated sibling's approval — and it wouldn't be protected
+      # anyway: an unsettled sibling executes on resume regardless of whether the
+      # human approves or declines the gated call, so stopping at the first park
+      # only delays independent work. Execute what can proceed; park if any
+      # invocation is awaiting a human.
       def settle!(step, resolver:)
+        parked = false
         step.tool_invocations.order(:id).each do |invocation|
-          outcome = settle_invocation!(invocation, resolver)
-          return :parked if outcome == :parked
+          parked = true if settle_invocation!(invocation, resolver) == :parked
         end
-        :completed
+        parked ? :parked : :completed
       end
 
       # Drive a SINGLE freshly-created invocation to a terminal state — the

data/lib/silas/schedule.rb

@@ -38,7 +38,9 @@ module Silas
 
     def self.from_markdown(name, path)
       content = File.read(path)
-      if content =~ /\A---\s*\n(.*?)\n---\s*\n(.*)\z/m
+      # Tolerate leading whitespace/blank lines (e.g. an ERB comment in a
+      # generator template renders to an empty first line).
+      if content.sub(/\A\s+/, "") =~ /\A---\s*\n(.*?)\n---\s*\n(.*)\z/m
         frontmatter = YAML.safe_load(Regexp.last_match(1)) || {}
         body = Regexp.last_match(2)
       else

data/lib/silas/version.rb

@@ -1,3 +1,3 @@
 module Silas
-  VERSION = "0.1.2"
+  VERSION = "0.1.4"
 end

data/lib/silas.rb

@@ -41,6 +41,7 @@ require "silas/instructions"
 require "silas/step_runner"
 require "silas/subprocess_runner"
 require "silas/eval" # after engines (ScriptedEngine < Engines::Base)
+require "silas/chat"
 
 module Silas
   class << self

data/lib/tasks/silas_chat.rake

@@ -0,0 +1,16 @@
+namespace :silas do
+  desc "Chat with your agent in the terminal (REPL). SESSION=id resumes one; approvals prompt inline."
+  task chat: :environment do
+    # A REPL wants each turn settled synchronously in this one process before
+    # the next prompt — and Rails' dev-default Async adapter is unsafe for Silas
+    # (it double-executes continuation retries; Silas warns at boot). Force the
+    # synchronous :inline adapter for this process only; production still runs
+    # Solid Queue.
+    ActiveJob::Base.queue_adapter = :inline
+    Silas.config.isolate_steps = false
+    Silas::Registry.install!
+
+    session = ENV["SESSION"].present? ? Silas::Session.find(ENV["SESSION"]) : nil
+    Silas::Chat.new(session: session).run
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: silas
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.4
 platform: ruby
 authors:
 - Daniel St Paul
@@ -30,6 +30,9 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '1.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -37,6 +40,9 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '1.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2'
 - !ruby/object:Gem::Dependency
   name: rspec-rails
   requirement: !ruby/object:Gem::Requirement
@@ -153,6 +159,7 @@ files:
 - lib/generators/silas/install/templates/example_tool.rb
 - lib/generators/silas/install/templates/initializer.rb
 - lib/generators/silas/install/templates/instructions.md
+- lib/generators/silas/install/templates/ruby_llm.rb
 - lib/silas.rb
 - lib/silas/agent.rb
 - lib/silas/agent_scope.rb
@@ -161,6 +168,7 @@ files:
 - lib/silas/agent_sdk/version_guard.rb
 - lib/silas/budget.rb
 - lib/silas/channel.rb
+- lib/silas/chat.rb
 - lib/silas/configuration.rb
 - lib/silas/connection.rb
 - lib/silas/connections.rb
@@ -202,6 +210,7 @@ files:
 - lib/silas/tools/load_skill.rb
 - lib/silas/tools/run_code.rb
 - lib/silas/version.rb
+- lib/tasks/silas_chat.rake
 - lib/tasks/silas_eval.rake
 - lib/tasks/silas_schedules.rake
 homepage: https://github.com/danielstpaul/silas