rails_console_ai 0.28.0 → 0.29.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 50a2c9dce686cffa315e1fb5004f0ad0a9cbc67459d3a546b28ad1b95d0d1798
-  data.tar.gz: 7eea0529e3a3e4f9a4d60cf8e6b882e5dc825052c3793817013cf5cc6e617d22
+  metadata.gz: 30c7955113bc3e4ce45989fcc0e93034185fbabc0e95acfa01df56ec397900b5
+  data.tar.gz: 87b0399d973e448404b234820067ed2f20d4148f78613963904c9e288a17d87a
 SHA512:
-  metadata.gz: 4ed2a4ad47456f7e28682e0302d346fd04e3778433015855fc2199d4b1dc3077e8ec96efec5eb1b9ae049f6ed5f8c5ac6944e354488313b1f20e8f4354a0bdd1
-  data.tar.gz: c3a9d0faaada962952b9995ac0e07b79384536dc03970c0da17fe0e2eef843edea799d2dfa8698363a869d74e2aa7d86f2dbe80088234206693d86dd29ef45b4
+  metadata.gz: ad1091c711239e286408f0133378c3597c83075b3f9435a40f43bf2df4fa279cf459cf3af84c58027842d2da4c8bccc5d11bfbec616c6e3ec1212784ad59b764
+  data.tar.gz: 61ea9cc3afd50b35ec3d0740b723a076175731d1289c4a98ee5727aaec78c993abb0b78637cb6ac7ef4b550b81b473ff287d83c32405c8fbd345dbf05b0b3b72

data/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.29.0]
+
+- Allow steering Slack conversations mid-run by sending follow-up messages that are folded in as user guidance at the next tool-loop boundary
+- Propagate steering guidance into sub-agent runs so interruptions are seen by both the main engine and any active sub-agent
+
 ## [0.28.0]
 
 - Add `bin/smoke_model.rb` to smoke-test new models (plain, tool, parallel, cache checks)

data/lib/rails_console_ai/channel/slack.rb

@@ -11,6 +11,9 @@ module RailsConsoleAi
         @thread_ts = thread_ts
         @user_name = user_name
         @reply_queue = Queue.new
+        @guidance_main = []
+        @guidance_sub = []
+        @guidance_mutex = Mutex.new
         @cancelled = false
         @log_prefix = "[#{@channel_id}/#{@thread_ts}] @#{@user_name}"
         @output_log = StringIO.new
@@ -18,6 +21,36 @@ module RailsConsoleAi
 
       def cancel!
         @cancelled = true
+        @guidance_mutex.synchronize do
+          @guidance_main.clear
+          @guidance_sub.clear
+        end
+      end
+
+      # Guidance is broadcast to both the main-engine queue and the sub-agent queue
+      # so a steering message arriving during a sub-agent run is seen by both layers
+      # (sub-agent reacts immediately; main engine reacts after delegate_task returns).
+      def add_guidance(text)
+        @guidance_mutex.synchronize do
+          @guidance_main << text
+          @guidance_sub << text
+        end
+      end
+
+      def drain_guidance(scope: :main)
+        @guidance_mutex.synchronize do
+          arr = scope == :sub ? @guidance_sub : @guidance_main
+          pending = arr.dup
+          arr.clear
+          pending
+        end
+      end
+
+      def pending_guidance?(scope: :main)
+        @guidance_mutex.synchronize do
+          arr = scope == :sub ? @guidance_sub : @guidance_main
+          !arr.empty?
+        end
       end
 
       def cancelled?

data/lib/rails_console_ai/channel/sub_agent.rb

@@ -64,6 +64,18 @@ module RailsConsoleAi
         @parent.cancelled?
       end
 
+      def pending_guidance?
+        @parent.respond_to?(:pending_guidance?) && @parent.pending_guidance?(scope: :sub)
+      end
+
+      def drain_guidance
+        @parent.respond_to?(:drain_guidance) ? @parent.drain_guidance(scope: :sub) : []
+      end
+
+      def add_guidance(text)
+        @parent.add_guidance(text) if @parent.respond_to?(:add_guidance)
+      end
+
       def supports_danger?
         false  # Sub-agents must never silently bypass safety guards
       end

data/lib/rails_console_ai/conversation_engine.rb

@@ -803,6 +803,15 @@ module RailsConsoleAi
           break
         end
 
+        if round > 0 && @channel.respond_to?(:pending_guidance?) && @channel.pending_guidance?
+          pending = @channel.drain_guidance
+          guidance_text = format_user_interruption(pending)
+          guidance_msg = { role: :user, content: guidance_text }
+          messages << guidance_msg
+          new_messages << guidance_msg
+          @channel.display_status("  Steering: incorporating user guidance.")
+        end
+
         if round == 0
           @channel.display_status("  Thinking...")
         elsif last_thinking
@@ -1152,6 +1161,28 @@ module RailsConsoleAi
       str.length > max ? str[0..max] + '...' : str
     end
 
+    # Wraps mid-task user messages with explicit framing so the model treats them
+    # as a real-time interruption that supersedes the prior task, rather than as
+    # a reply to the most recent tool result.
+    def format_user_interruption(messages)
+      joined = messages.map { |t| t.to_s.strip }.reject(&:empty?).join("\n\n")
+      <<~MSG.strip
+        [INTERRUPTION FROM USER — REAL-TIME MESSAGE]
+
+        The user sent the following message while you were working on the previous step.
+        They sent it before seeing the result of your last tool call, so it is NOT a
+        reply to that result. It is your most recent direction from the user and
+        supersedes the prior task.
+
+        If they are telling you to stop, halt completely and acknowledge — do not
+        autonomously switch to a different method to accomplish the original task.
+        If their instruction is unclear, ask them what they want before continuing.
+
+        User message:
+        "#{joined}"
+      MSG
+    end
+
     def llm_status(round, messages, req_tokens, total_billed, last_thinking = nil, last_tool_names = [])
       status = "Calling LLM (round #{round + 1}, #{messages.length} msgs"
       status += ", ~#{format_tokens(req_tokens)} ctx" if req_tokens > 0

data/lib/rails_console_ai/slack_bot.rb

@@ -491,6 +491,14 @@ module RailsConsoleAi
         return
       end
 
+      # If the engine is mid-run, treat the message as steering guidance to be
+      # folded in at the next tool-loop boundary instead of restarting.
+      if session[:thread]&.alive? && channel.respond_to?(:add_guidance)
+        channel.add_guidance(text)
+        channel.display("Got it. One moment.")
+        return
+      end
+
       # Otherwise treat as a new message in the conversation
       replace_session_thread(session) do
         Thread.current.report_on_exception = false

data/lib/rails_console_ai/sub_agent.rb

@@ -66,6 +66,12 @@ module RailsConsoleAi
       max_rounds.times do |round|
         break if channel.cancelled?
 
+        if round > 0 && channel.respond_to?(:pending_guidance?) && channel.pending_guidance?
+          pending = channel.drain_guidance
+          messages << { role: :user, content: format_user_interruption(pending) }
+          channel.display_status("  Steering: incorporating user guidance.")
+        end
+
         if round == 0
           channel.display_status("Thinking...")
         end
@@ -147,6 +153,25 @@ module RailsConsoleAi
       result&.text || '(sub-agent returned no result)'
     end
 
+    def format_user_interruption(messages)
+      joined = messages.map { |t| t.to_s.strip }.reject(&:empty?).join("\n\n")
+      <<~MSG.strip
+        [INTERRUPTION FROM USER — REAL-TIME MESSAGE]
+
+        The user sent the following message while you were working. They sent it
+        before seeing your latest tool result, so it is NOT a reply to that result.
+        It is your most recent direction from the user and supersedes the prior task.
+
+        If they are telling you to stop, halt immediately and finish with a brief
+        acknowledgement — do not switch to a different method to accomplish the
+        original task on your own. If unclear, return what you have so far and let
+        the parent agent ask the user.
+
+        User message:
+        "#{joined}"
+      MSG
+    end
+
     def build_provider
       config = RailsConsoleAi.configuration
       model_override = @agent_config['model'] || config.sub_agent_model

data/lib/rails_console_ai/version.rb

@@ -1,3 +1,3 @@
 module RailsConsoleAi
-  VERSION = '0.28.0'.freeze
+  VERSION = '0.29.0'.freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails_console_ai
 version: !ruby/object:Gem::Version
-  version: 0.28.0
+  version: 0.29.0
 platform: ruby
 authors:
 - Cortfr