rails_console_ai 0.26.0 → 0.27.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a2194416a93ce8522de376169eb627b90c8b2477ba253f0f1b877144251f9ee6
-  data.tar.gz: 65dcbeb6eef9dd2641181529aa671058e85a6cd1c5263acd51678c52c89d3567
+  metadata.gz: db0c0b3b95cc349906845d4058e1eadc6be4ab67e25f32a4b8e4262e61340a87
+  data.tar.gz: 0ba79ae87d8975193b2b6033279dc41a8841cf71e7f015ce8f36dafa6d62d463
 SHA512:
-  metadata.gz: e4d5a1f2fe8ef6ae4593829ac1a8997eeeac652ea0d0a491f91a64b8e45a246d024a10aa269e853949e0d106779d4f1b9d671af21057bd6af802ff6a541ac15d
-  data.tar.gz: ec0e0d25f7bb2605a7c4180ebc56ab56d8f590d3632c98310ec65c3aecd987d04118e7199534a8ea5a1a8023a505de9ac467ce05d01393df667c2436bcebc68c
+  metadata.gz: 615da46e5aa24149783309d69a3b739db1170459c1bf6d929c8ecfc875fbc0654117a7c5d15057aaf7d421660afa9959192f4112b25e722e5e224ce3de768fb0
+  data.tar.gz: cf807c3dfc0fae08a79013606c5e00383bc26994461c02e4135f8efb495540a0f677bff62eae01c2f396e9ce2de8ede7c82a95415b69831425447aa93361dbdb

data/lib/rails_console_ai/channel/console.rb

@@ -207,6 +207,7 @@ module RailsConsoleAi
           break if input.nil?
 
           input = input.strip
+          input = input.force_encoding('UTF-8') if input.encoding == Encoding::ASCII_8BIT
           break if input.downcase == 'exit' || input.downcase == 'quit'
           next if input.empty?
 

data/lib/rails_console_ai/conversation_engine.rb

@@ -249,7 +249,7 @@ module RailsConsoleAi
       output_id = @executor.store_output(result_str)
       if result_str.length > LARGE_OUTPUT_THRESHOLD
         preview = result_str[0, LARGE_OUTPUT_PREVIEW_CHARS]
-        context_msg += "\n#{preview}\n\n[Output truncated at #{LARGE_OUTPUT_PREVIEW_CHARS} of #{result_str.length} chars — use recall_output tool with id #{output_id} to retrieve the full output]"
+        context_msg += "\n#{preview}\n\n[Output truncated at #{LARGE_OUTPUT_PREVIEW_CHARS} of #{result_str.length} chars — use explore_output with output_id=#{output_id} for focused queries, or recall_output to expand in place]"
       elsif !output_parts.empty?
         context_msg += "\n#{result_str}"
       end
@@ -332,7 +332,7 @@ module RailsConsoleAi
             context_msg = "Code was executed (safety override). "
             if result_str.length > LARGE_OUTPUT_THRESHOLD
               context_msg += result_str[0, LARGE_OUTPUT_PREVIEW_CHARS]
-              context_msg += "\n\n[Output truncated at #{LARGE_OUTPUT_PREVIEW_CHARS} of #{result_str.length} chars — use recall_output tool with id #{output_id} to retrieve the full output]"
+              context_msg += "\n\n[Output truncated at #{LARGE_OUTPUT_PREVIEW_CHARS} of #{result_str.length} chars — use explore_output with output_id=#{output_id} for focused queries, or recall_output to expand in place]"
             else
               context_msg += result_str
             end
@@ -360,7 +360,7 @@ module RailsConsoleAi
           context_msg = "Code was executed. "
           if result_str.length > LARGE_OUTPUT_THRESHOLD
             context_msg += result_str[0, LARGE_OUTPUT_PREVIEW_CHARS]
-            context_msg += "\n\n[Output truncated at #{LARGE_OUTPUT_PREVIEW_CHARS} of #{result_str.length} chars — use recall_output tool with id #{output_id} to retrieve the full output]"
+            context_msg += "\n\n[Output truncated at #{LARGE_OUTPUT_PREVIEW_CHARS} of #{result_str.length} chars — use explore_output with output_id=#{output_id} for focused queries, or recall_output to expand in place]"
           else
             context_msg += result_str
           end
@@ -903,7 +903,7 @@ module RailsConsoleAi
           tool_msg[:output_id] = output_id
           if full_text.length > LARGE_OUTPUT_THRESHOLD
             truncated = full_text[0, LARGE_OUTPUT_PREVIEW_CHARS]
-            truncated += "\n\n[Output truncated at #{LARGE_OUTPUT_PREVIEW_CHARS} of #{full_text.length} chars — use recall_output tool with id #{output_id} to retrieve the full output]"
+            truncated += "\n\n[Output truncated at #{LARGE_OUTPUT_PREVIEW_CHARS} of #{full_text.length} chars — use explore_output with output_id=#{output_id} for focused queries, or recall_output to expand in place]"
             tool_msg = provider.format_tool_result(tc[:id], truncated)
             tool_msg[:output_id] = output_id
           end
@@ -1041,6 +1041,10 @@ module RailsConsoleAi
       when 'save_skill'     then "(\"#{args['name']}\")"
       when 'delete_skill'   then "(\"#{args['name']}\")"
       when 'recall_output'   then "(#{args['id']})"
+      when 'explore_output'
+        task_preview = args['task'].to_s[0, 80]
+        task_preview += '...' if args['task'].to_s.length > 80
+        "(id: #{args['output_id']}, \"#{task_preview}\")"
       when 'execute_plan'
         steps = args['steps']
         steps ? "(#{steps.length} steps)" : ''
@@ -1409,7 +1413,7 @@ module RailsConsoleAi
     end
 
     def trim_message(msg)
-      ref = "[Output omitted — use recall_output tool with id #{msg[:output_id]} to retrieve]"
+      ref = "[Output omitted — use explore_output with output_id=#{msg[:output_id]} for focused queries, or recall_output to expand in place]"
 
       if msg[:content].is_a?(Array)
         trimmed_content = msg[:content].map do |block|

data/lib/rails_console_ai/sub_agent.rb

@@ -12,12 +12,15 @@ module RailsConsoleAi
 
     attr_reader :input_tokens, :output_tokens, :model_used
 
-    def initialize(task:, agent_config:, binding_context:, parent_channel:, executor:)
+    def initialize(task:, agent_config:, binding_context:, parent_channel:, executor:,
+                   output_payload: nil, output_local_name: :output)
       @task = task
       @agent_config = agent_config || {}
       @binding_context = binding_context
       @parent_channel = parent_channel
       @parent_executor = executor
+      @output_payload = output_payload
+      @output_local_name = output_local_name
       @input_tokens = 0
       @output_tokens = 0
       @model_used = nil
@@ -29,7 +32,16 @@ module RailsConsoleAi
         task_label: @agent_config['name']
       )
 
-      executor = Executor.new(@binding_context, channel: channel)
+      effective_binding =
+        if @output_payload
+          b = @binding_context.eval("proc { binding }.call")
+          b.local_variable_set(@output_local_name, @output_payload)
+          b
+        else
+          @binding_context
+        end
+
+      executor = Executor.new(effective_binding, channel: channel)
       allowed_tools = @agent_config['tools'] ? Array(@agent_config['tools']) : nil
       tools = Tools::Registry.new(executor: executor, mode: :sub_agent, channel: channel, allowed_tools: allowed_tools)
       provider = build_provider

data/lib/rails_console_ai/tools/registry.rb

@@ -6,7 +6,7 @@ module RailsConsoleAi
       attr_reader :definitions, :last_sub_agent_usage
 
       # Tools that should never be cached (side effects or user interaction)
-      NO_CACHE = %w[ask_user save_memory delete_memory recall_memory execute_code execute_plan activate_skill save_skill delete_skill delegate_task].freeze
+      NO_CACHE = %w[ask_user save_memory delete_memory recall_memory execute_code execute_plan activate_skill save_skill delete_skill delegate_task explore_output].freeze
 
       def initialize(executor: nil, mode: :default, channel: nil, allowed_tools: nil)
         @executor = executor
@@ -188,7 +188,7 @@ module RailsConsoleAi
         if @executor
           register(
             name: 'recall_output',
-            description: 'Retrieve a previous code execution output that was omitted or truncated. The output will be expanded in place in the conversation. Use the output id shown in the "[Output omitted]" or "[Output truncated]" placeholder.',
+            description: 'Expand a previously omitted/truncated output back into this conversation\'s context, where it will persist for the rest of the session. Prefer `explore_output` if you only need a specific answer about the output — that keeps this conversation lean. Use `recall_output` only when you need the full content alongside other context here. Use the output id shown in the "[Output omitted]" or "[Output truncated]" placeholder.',
             parameters: {
               'type' => 'object',
               'properties' => {
@@ -204,7 +204,7 @@ module RailsConsoleAi
 
           register(
             name: 'recall_outputs',
-            description: 'Retrieve multiple previous code execution outputs that were omitted from the conversation. Use the output ids shown in "[Output omitted]" or "[Output truncated]" placeholders.',
+            description: 'Expand multiple previously omitted outputs back into this conversation. Prefer `explore_output` per-id for focused queries. Use the output ids shown in "[Output omitted]" or "[Output truncated]" placeholders.',
             parameters: {
               'type' => 'object',
               'properties' => {
@@ -214,6 +214,22 @@ module RailsConsoleAi
             },
             handler: ->(args) { "recall_outputs handled by conversation engine" }
           )
+
+          if @mode != :sub_agent
+            register(
+              name: 'explore_output',
+              description: 'Prefer this over recall_output when you have a specific question about a large omitted/truncated output (e.g. "find the item where X", "how many match Y", "what is the value at index N", "parse the JSON and return field Z"). Spawns a sub-agent with the full output bound to the local Ruby variable `output` (a String); the sub-agent runs execute_code against it and returns a concise answer. The full output does NOT enter this conversation.',
+              parameters: {
+                'type' => 'object',
+                'properties' => {
+                  'output_id' => { 'type' => 'integer', 'description' => 'The output id shown in the "[Output omitted]" or "[Output truncated]" placeholder.' },
+                  'task' => { 'type' => 'string', 'description' => 'The specific question or task. Be concrete — the sub-agent only sees this task and the output.' }
+                },
+                'required' => ['output_id', 'task']
+              },
+              handler: ->(args) { explore_output(args['output_id'].to_i, args['task']) }
+            )
+          end
         end
 
         unless @mode == :init
@@ -317,6 +333,45 @@ module RailsConsoleAi
         )
       end
 
+      EXPLORE_OUTPUT_AGENT_CONFIG = {
+        'name' => 'output-explorer',
+        'tools' => ['execute_code'],
+        'max_rounds' => 8,
+        'body' => <<~PROMPT.freeze
+          You are exploring a single chunk of captured tool output on behalf of the main assistant.
+
+          The full output is bound to the local variable `output` (a String). You do NOT see it
+          directly — it lives in Ruby memory. Use `execute_code` with Ruby to query it:
+            - `output.length`, `output.lines.count`
+            - `output[start, len]`, `output.lines[n]`
+            - `output.scan(/pattern/)`, `output.include?("...")`
+            - `JSON.parse(output)` if it looks like JSON, then drill in
+            - any other Ruby string/collection methods
+
+          Print only the specific slice or summary the task requires — never dump the whole `output`.
+          Return a concise factual answer. No preamble.
+        PROMPT
+      }.freeze
+
+      def explore_output(output_id, task)
+        require 'rails_console_ai/sub_agent'
+
+        payload = @executor.recall_output(output_id)
+        return "No output found with id #{output_id}" unless payload
+
+        sub = SubAgent.new(
+          task: task,
+          agent_config: EXPLORE_OUTPUT_AGENT_CONFIG,
+          binding_context: @executor.binding_context,
+          parent_channel: @channel,
+          executor: @executor,
+          output_payload: payload.dup
+        )
+        result = sub.run
+        @last_sub_agent_usage = { input: sub.input_tokens, output: sub.output_tokens, model: sub.model_used }
+        "Exploration result (#{sub.input_tokens + sub.output_tokens} tokens used, #{payload.length} chars explored):\n#{result}"
+      end
+
       def delegate_task(task, agent_name = nil)
         require 'rails_console_ai/sub_agent'
         require 'rails_console_ai/agent_loader'

data/lib/rails_console_ai/version.rb

@@ -1,3 +1,3 @@
 module RailsConsoleAi
-  VERSION = '0.26.0'.freeze
+  VERSION = '0.27.0'.freeze
 end

metadata

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