console_agent 0.9.0 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5f82de0e3bdd6d1e3189c3b1bd0c88c386a6b31b4dff317656365352490f06c9
-  data.tar.gz: 1347a93e946c254809cdf6bfa90e3dea0378b7aef9a5e04950bdf0151569cd79
+  metadata.gz: 902a34c15b9fa06e60e4b8eb040d57126bbdf9f725d2e727634ed4e73d8fbaa0
+  data.tar.gz: cda463c1023ad995a8143d52702a6b8098dbcdd3cde4e2002352c327a536109e
 SHA512:
-  metadata.gz: cec5e56aaddea19c5d1b9046fcbd7fd4707d16efa3fab65f9977703e24d28d177c12331c9cba7590048b1ad2f412d67bcb9ffe78c5cef288d6da40916cb53a86
-  data.tar.gz: 9e67f0c30bbd38561c400523ca19240f931ff5c08b353fa545037472b6b2195f931b5987b21d3c643a35e2cb3377647447cc676aa7544ba5a2ccec2a505f7e16
+  metadata.gz: 6380481f86f277205aa2aadac23745cf7f5fe5785b8f5ce8272c64fd26206166814434f06bbcf97494f6f1d75a08e69657721fd5423e62898a7c1e5d7312347f
+  data.tar.gz: adffc1e8afa7ad60469c03df75427284c988c8b1e64f954571435441397e66cd3d597906feb2fa953e19575432b27b7583bfcea0e73bc4cbc49cdd19e32bc2d0

data/CHANGELOG.md

@@ -2,6 +2,32 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.11.0]
+
+- Add Slack channel integration with system instructions and connection pooling
+- Extract channels abstraction and ConversationEngine from Repl
+- Add built-in safety guards with `/danger` bypass and progressive safety allowlists
+- Add local model support with prompt truncation warnings
+- Add `clear!` command to clear bot messages in thread
+- Match code blocks in LLM results
+- Fix long query display and add cost tracking to session viewer
+- Strip quotes from session names when saving
+
+## [0.10.0]
+
+- Add `/expand` command to view previous results
+- Exclude previous output from context; add tool for LLM to retrieve it on demand
+- Show summarized info per LLM call in `/debug`
+
+## [0.9.0]
+
+- Add `/system` and `/context` commands to inspect what is being sent
+- Omit huge output from tool results
+- Don't cancel code execution on incorrect prompt answers
+- Preserve code blocks when compacting; require manual `/compact`
+- Fix authentication when neither method was applied
+- Remove prompt to upgrade model on excessive tool calls
+
 ## [0.8.0]
 
 - Add authentication function support so host apps can avoid using basic auth

data/README.md

@@ -12,7 +12,7 @@ irb> ai "find the 5 most recent orders over $100"
 
   Order.where("total > ?", 100).order(created_at: :desc).limit(5)
 
-Execute? [y/N/edit] y
+Execute? [y/N/edit/danger] y
 => [#<Order id: 4821, ...>, ...]
 ```
 
@@ -75,11 +75,16 @@ end
 | Command | What it does |
 |---------|-------------|
 | `/auto` | Toggle auto-execute (skip confirmations) |
+| `/danger` | Toggle safe mode off/on (allow side effects) |
+| `/safe` | Show safety guard status |
 | `/compact` | Compress history into a summary (saves tokens) |
 | `/usage` | Show token stats |
 | `/cost` | Show per-model cost breakdown |
 | `/think` | Upgrade to thinking model (Opus) for the rest of the session |
-| `/debug` | Toggle raw API output |
+| `/debug` | Toggle debug summaries (context stats, cost per call) |
+| `/expand <id>` | Show full omitted output |
+| `/context` | Show conversation history as sent to the LLM |
+| `/system` | Show the system prompt |
 | `/name <label>` | Name the session for easy resume |
 
 Prefix input with `>` to run Ruby directly (no LLM round-trip). The result is added to conversation context.
@@ -96,6 +101,51 @@ Say "think harder" in any query to auto-upgrade to the thinking model for that s
 - **App guide** — `ai_init` generates a guide injected into every system prompt
 - **Sessions** — name, list, and resume interactive conversations (`ai_setup` to enable)
 - **History compaction** — `/compact` summarizes long conversations to reduce cost and latency
+- **Output trimming** — older execution outputs are automatically replaced with references; the LLM can recall them on demand via `recall_output`, and you can `/expand <id>` to see them
+- **Debug mode** — `/debug` shows context breakdown, token counts, and per-call cost estimates before and after each LLM call
+- **Safe mode** — configurable guards that block side effects (DB writes, HTTP mutations, email delivery) during AI code execution
+
+## Safety Guards
+
+Safety guards prevent AI-generated code from causing side effects. When a guard blocks an operation, the user is prompted to re-run with safe mode disabled.
+
+### Built-in Guards
+
+```ruby
+ConsoleAgent.configure do |config|
+  config.use_builtin_safety_guard :database_writes  # blocks INSERT/UPDATE/DELETE/DROP/etc.
+  config.use_builtin_safety_guard :http_mutations    # blocks POST/PUT/PATCH/DELETE via Net::HTTP
+  config.use_builtin_safety_guard :mailers           # disables ActionMailer delivery
+end
+```
+
+- **`:database_writes`** — intercepts the ActiveRecord connection adapter to block write SQL. Works on Rails 5+ with any database adapter.
+- **`:http_mutations`** — intercepts `Net::HTTP#request` to block non-GET/HEAD/OPTIONS requests. Covers libraries built on Net::HTTP (HTTParty, RestClient, Faraday).
+- **`:mailers`** — sets `ActionMailer::Base.perform_deliveries = false` during execution.
+
+### Custom Guards
+
+Write your own guards using the around-block pattern:
+
+```ruby
+ConsoleAgent.configure do |config|
+  config.safety_guard :jobs do |&execute|
+    Sidekiq::Testing.fake! { execute.call }
+  end
+end
+```
+
+Raise `ConsoleAgent::SafetyError` in your app code to trigger the safe mode prompt:
+
+```ruby
+raise ConsoleAgent::SafetyError, "Stripe charge blocked"
+```
+
+### Toggling Safe Mode
+
+- **`/danger`** in interactive mode toggles all guards off/on for the session
+- **`d`** at the `Execute? [y/N/edit/danger]` prompt disables guards for that single execution
+- When a guard blocks an operation, the user is prompted: `Re-run with safe mode disabled? [y/N]`
 
 ## Configuration
 
@@ -141,6 +191,58 @@ end
 
 When `authenticate` is set, `admin_username` / `admin_password` are ignored.
 
+## Channels
+
+ConsoleAgent can run through different channels beyond the Rails console. Each channel is a separate process that connects the same AI engine to a different interface.
+
+### Slack
+
+Run ConsoleAgent as a Slack bot. Each Slack thread becomes an independent AI session with full tool use, multi-step plans, and safety guards always on.
+
+#### Slack App Setup
+
+1. Create a new app at https://api.slack.com/apps → **Create New App** → **From scratch**
+
+2. **Enable Socket Mode** — Settings → Socket Mode → toggle ON. Generate an App-Level Token with the `connections:write` scope. Copy the `xapp-...` token.
+
+3. **Bot Token Scopes** — OAuth & Permissions → Bot Token Scopes, add:
+   - `chat:write`
+   - `channels:history` (public channels)
+   - `groups:history` (private channels, optional)
+   - `im:history` (direct messages)
+   - `users:read`
+
+4. **Event Subscriptions** — Event Subscriptions → toggle ON, then under "Subscribe to bot events" add:
+   - `message.channels` (public channels)
+   - `message.groups` (private channels, optional)
+   - `message.im` (direct messages)
+
+5. **App Home** — Show Tabs → toggle **Messages Tab** ON and check **"Allow users to send Slash commands and messages from the messages tab"**
+
+6. **Install to workspace** — Install App → Install to Workspace. Copy the `xoxb-...` Bot User OAuth Token.
+
+7. **Invite the bot** to a channel with `/invite @YourBotName`, or DM it directly.
+
+#### Configuration
+
+```ruby
+ConsoleAgent.configure do |config|
+  config.slack_bot_token = ENV['SLACK_BOT_TOKEN']   # xoxb-...
+  config.slack_app_token = ENV['SLACK_APP_TOKEN']    # xapp-...
+
+  # Optional: restrict to specific Slack channel IDs
+  # config.slack_channel_ids = 'C1234567890,C0987654321'
+end
+```
+
+#### Running
+
+```bash
+bundle exec rake console_agent:slack
+```
+
+This starts a long-running process (run it separately from your web server). Each new message creates a session; threaded replies continue the conversation. The bot auto-executes code with safety guards always enabled — there is no `/danger` equivalent in Slack.
+
 ## Requirements
 
 Ruby >= 2.5, Rails >= 5.0, Faraday >= 1.0

data/app/helpers/console_agent/sessions_helper.rb

@@ -1,5 +1,19 @@
 module ConsoleAgent
   module SessionsHelper
+    def estimated_cost(session)
+      pricing = Configuration::PRICING[session.model]
+      return nil unless pricing
+
+      (session.input_tokens * pricing[:input]) + (session.output_tokens * pricing[:output])
+    end
+
+    def format_cost(session)
+      cost = estimated_cost(session)
+      return '-' unless cost
+
+      cost < 0.01 ? "<$0.01" : "$#{'%.2f' % cost}"
+    end
+
     # Convert ANSI escape codes to HTML spans for terminal-style rendering
     def ansi_to_html(text)
       return '' if text.nil? || text.empty?

data/app/models/console_agent/session.rb

@@ -4,7 +4,7 @@ module ConsoleAgent
 
     validates :query, presence: true
     validates :conversation, presence: true
-    validates :mode, presence: true, inclusion: { in: %w[one_shot interactive explain] }
+    validates :mode, presence: true, inclusion: { in: %w[one_shot interactive explain slack] }
 
     scope :recent, -> { order(created_at: :desc) }
     scope :named, ->(name) { where(name: name) }

data/app/views/console_agent/sessions/index.html.erb

@@ -14,10 +14,10 @@
         <th>Time</th>
         <th>User</th>
         <th>Name</th>
-        <th>Query</th>
+        <th style="max-width: 400px;">Query</th>
         <th>Mode</th>
         <th>Tokens</th>
-        <th>Executed?</th>
+        <th>Cost</th>
         <th>Duration</th>
       </tr>
     </thead>
@@ -27,10 +27,10 @@
           <td class="mono"><%= session.created_at.strftime('%Y-%m-%d %H:%M') %></td>
           <td><%= session.user_name %></td>
           <td><%= session.name.present? ? session.name : '-' %></td>
-          <td><a href="<%= console_agent.session_path(session) %>"><%= truncate(session.query, length: 80) %></a></td>
+          <td class="query-cell"><a href="<%= console_agent.session_path(session) %>" title="<%= h session.query.truncate(200) %>"><%= truncate(session.query.gsub(/\s+/, ' ').strip, length: 80) %></a></td>
           <td><span class="badge badge-<%= session.mode %>"><%= session.mode %></span></td>
           <td class="mono"><%= session.input_tokens + session.output_tokens %></td>
-          <td><%= session.executed? ? '<span class="check">Yes</span>'.html_safe : '<span class="cross">No</span>'.html_safe %></td>
+          <td class="mono"><%= format_cost(session) %></td>
           <td class="mono"><%= session.duration_ms ? "#{session.duration_ms}ms" : '-' %></td>
         </tr>
       <% end %>

data/app/views/console_agent/sessions/show.html.erb

@@ -2,9 +2,19 @@
 
 <div class="meta-card">
   <div class="meta-grid">
-    <div class="meta-item">
+    <div class="meta-item" style="grid-column: 1 / -1;">
       <label>Query</label>
-      <span><%= @session.query %></span>
+      <% if @session.query.length > 300 %>
+        <div class="query-preview">
+          <span><%= truncate(@session.query, length: 300) %></span>
+          <details style="margin-top: 4px;">
+            <summary style="cursor: pointer; font-size: 12px; color: #4a6fa5;">Show full query</summary>
+            <pre style="white-space: pre-wrap; word-wrap: break-word; font-size: 13px; margin-top: 8px; padding: 12px; background: #f8f9fa; border-radius: 4px; max-height: 400px; overflow-y: auto;"><%= @session.query %></pre>
+          </details>
+        </div>
+      <% else %>
+        <span><%= @session.query %></span>
+      <% end %>
     </div>
     <% if @session.name.present? %>
       <div class="meta-item">
@@ -29,12 +39,12 @@
       <span class="mono"><%= @session.input_tokens %> / <%= @session.output_tokens %></span>
     </div>
     <div class="meta-item">
-      <label>Duration</label>
-      <span class="mono"><%= @session.duration_ms ? "#{@session.duration_ms}ms" : '-' %></span>
+      <label>Est. Cost</label>
+      <span class="mono"><%= format_cost(@session) %></span>
     </div>
     <div class="meta-item">
-      <label>Executed?</label>
-      <span><%= @session.executed? ? '<span class="check">Yes</span>'.html_safe : '<span class="cross">No</span>'.html_safe %></span>
+      <label>Duration</label>
+      <span class="mono"><%= @session.duration_ms ? "#{@session.duration_ms}ms" : '-' %></span>
     </div>
     <div class="meta-item">
       <label>Time</label>

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

@@ -54,6 +54,7 @@
       overflow-x: auto; white-space: pre-wrap; word-wrap: break-word;
     }
     .mono { font-family: "SF Mono", "Monaco", "Menlo", "Consolas", monospace; font-size: 13px; }
+    .query-cell { max-width: 400px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
     .text-muted { color: #888; }
     .back-link { margin-bottom: 16px; display: inline-block; }
     .check { color: #28a745; }

data/lib/console_agent/channel/base.rb

@@ -0,0 +1,23 @@
+module ConsoleAgent
+  module Channel
+    class Base
+      def display(text);            raise NotImplementedError; end
+      def display_dim(text);        raise NotImplementedError; end
+      def display_warning(text);    raise NotImplementedError; end
+      def display_error(text);      raise NotImplementedError; end
+      def display_code(code);       raise NotImplementedError; end
+      def display_result(text);     raise NotImplementedError; end
+      def display_result_output(text); end  # stdout output from code execution
+      def prompt(text);             raise NotImplementedError; end
+      def confirm(text);            raise NotImplementedError; end
+      def user_identity;            raise NotImplementedError; end
+      def mode;                     raise NotImplementedError; end
+      def cancelled?;               false; end
+      def supports_danger?;         true; end
+      def supports_editing?;        false; end
+      def edit_code(code);          code; end
+      def wrap_llm_call(&block);    yield; end
+      def system_instructions;      nil; end
+    end
+  end
+end