envoy_ai 0.0.1

data/app/assets/stylesheets/envoy/console.css

@@ -0,0 +1,371 @@
+/*
+ * Envoy debug console — self-contained stylesheet.
+ *
+ * The console ships its own presentation so it renders correctly in ANY
+ * host app, Tailwind or not. No Tailwind utilities are used anywhere in the
+ * engine's views; every class here is semantic and scoped to `envoy-*`.
+ *
+ * Dark mode follows the OS preference (there is no in-app theme toggle) via
+ * `prefers-color-scheme`. The palette is centralized in CSS custom
+ * properties so light/dark stay in one place.
+ */
+
+:root {
+  --envoy-bg: #f9fafb;
+  --envoy-surface: #ffffff;
+  --envoy-surface-assistant: #eff6ff;
+  --envoy-surface-muted: #f9fafb;
+  --envoy-ink: #111827;
+  --envoy-muted: #6b7280;
+  --envoy-border: #e5e7eb;
+  --envoy-link: #1d4ed8;
+  --envoy-btn-bg: #111827;
+  --envoy-btn-ink: #ffffff;
+  --envoy-danger: #b91c1c;
+  --envoy-header-bg: rgba(255, 255, 255, 0.8);
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --envoy-bg: #030712;
+    --envoy-surface: #111827;
+    --envoy-surface-assistant: #1f2937;
+    --envoy-surface-muted: #111827;
+    --envoy-ink: #f3f4f6;
+    --envoy-muted: #9ca3af;
+    --envoy-border: #374151;
+    --envoy-link: #60a5fa;
+    --envoy-btn-bg: #f3f4f6;
+    --envoy-btn-ink: #111827;
+    --envoy-header-bg: rgba(17, 24, 39, 0.8);
+  }
+}
+
+/* ---------------------------------------------------------------------- */
+/* Base / layout                                                          */
+/* ---------------------------------------------------------------------- */
+
+body.envoy-body {
+  min-height: 100vh;
+  margin: 0;
+  background: var(--envoy-bg);
+  color: var(--envoy-ink);
+  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+}
+
+.envoy-header {
+  position: sticky;
+  top: 0;
+  z-index: 10;
+  border-bottom: 1px solid var(--envoy-border);
+  background: var(--envoy-header-bg);
+  -webkit-backdrop-filter: blur(8px);
+  backdrop-filter: blur(8px);
+}
+
+.envoy-header__inner {
+  max-width: 48rem;
+  margin: 0 auto;
+  padding: 0 1rem;
+  height: 3rem;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+}
+
+.envoy-brand {
+  font-weight: 600;
+  letter-spacing: -0.01em;
+  text-decoration: none;
+  color: inherit;
+}
+.envoy-brand:hover { opacity: 0.7; }
+
+.envoy-navlink {
+  font-size: 0.875rem;
+  color: var(--envoy-link);
+  text-decoration: none;
+}
+.envoy-navlink:hover { text-decoration: underline; }
+
+.envoy-main {
+  max-width: 48rem;
+  margin: 0 auto;
+  padding: 1rem;
+}
+
+/* ---------------------------------------------------------------------- */
+/* Titles / headings                                                      */
+/* ---------------------------------------------------------------------- */
+
+.envoy-title {
+  font-size: 1.25rem;
+  font-weight: 600;
+}
+
+.envoy-title--sm {
+  font-size: 1.125rem;
+  font-weight: 600;
+}
+@media (min-width: 640px) {
+  .envoy-title--sm { font-size: 1.25rem; }
+}
+
+.envoy-subtitle {
+  font-weight: 600;
+  margin-bottom: 0.5rem;
+}
+
+/* ---------------------------------------------------------------------- */
+/* Header rows / button groups                                            */
+/* ---------------------------------------------------------------------- */
+
+.envoy-header-row {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  justify-content: space-between;
+  gap: 0.5rem;
+}
+
+.envoy-btn-group {
+  display: flex;
+  gap: 0.5rem;
+}
+
+/* ---------------------------------------------------------------------- */
+/* Spacing helpers                                                        */
+/* ---------------------------------------------------------------------- */
+
+.envoy-mb-3 { margin-bottom: 0.75rem; }
+.envoy-mb-4 { margin-bottom: 1rem; }
+.envoy-mt-4 { margin-top: 1rem; }
+
+.envoy-stack > * + * { margin-top: 1rem; }
+.envoy-stack--sm > * + * { margin-top: 0.75rem; }
+
+/* ---------------------------------------------------------------------- */
+/* Messages                                                               */
+/* ---------------------------------------------------------------------- */
+
+.envoy-msg {
+  border: 1px solid var(--envoy-border);
+  border-radius: 0.5rem;
+  padding: 1rem;
+  background: var(--envoy-surface);
+}
+.envoy-msg--assistant { background: var(--envoy-surface-assistant); }
+
+.envoy-msg__role {
+  font-size: 0.75rem;
+  text-transform: uppercase;
+  color: var(--envoy-muted);
+  margin-bottom: 0.25rem;
+}
+
+/* Subtle "working…" shimmer while a reply is being generated. */
+.envoy-working { animation: envoy-working 1.4s ease-in-out infinite; }
+@keyframes envoy-working {
+  0%, 100% { opacity: 0.4; }
+  50%      { opacity: 0.95; }
+}
+@media (prefers-reduced-motion: reduce) {
+  .envoy-working { animation: none; opacity: 0.7; }
+}
+
+/* ---------------------------------------------------------------------- */
+/* Rendered markdown body                                                 */
+/* ---------------------------------------------------------------------- */
+
+.envoy-md { font-size: 0.9rem; line-height: 1.6; }
+.envoy-md > * + * { margin-top: 0.7rem; }
+.envoy-md h1 { font-size: 1.3em; font-weight: 700; }
+.envoy-md h2 { font-size: 1.15em; font-weight: 700; }
+.envoy-md h3, .envoy-md h4 { font-size: 1em; font-weight: 700; }
+.envoy-md ul { padding-left: 1.25rem; list-style: disc; }
+.envoy-md ol { padding-left: 1.25rem; list-style: decimal; }
+.envoy-md li + li { margin-top: 0.2rem; }
+.envoy-md a { text-decoration: underline; }
+.envoy-md blockquote { border-left: 3px solid rgba(128, 128, 128, 0.4); padding-left: 0.75rem; }
+.envoy-md hr { border: 0; border-top: 1px solid rgba(128, 128, 128, 0.3); }
+/* Fenced code (comrak carries its own dark background + inline styles). */
+.envoy-md pre { padding: 0.75rem 1rem; border-radius: 0.5rem; }
+/* Inline code gets a subtle theme-agnostic chip. */
+.envoy-md :not(pre) > code {
+  font-size: 0.9em;
+  overflow-wrap: anywhere;
+  background: rgba(128, 128, 128, 0.15);
+  padding: 0.1em 0.3em;
+  border-radius: 0.25rem;
+}
+
+/* Code blocks scroll within the message instead of spilling past it, with a
+   thin, theme-agnostic overlay scrollbar (mid-gray at 50% reads on both the
+   light tool-call panels and the dark highlighted blocks). */
+#envoy_messages pre {
+  overflow-x: auto;
+  max-width: 100%;
+  scrollbar-width: thin;
+  scrollbar-color: rgba(128, 128, 128, 0.5) transparent;
+}
+#envoy_messages pre::-webkit-scrollbar { height: 8px; }
+#envoy_messages pre::-webkit-scrollbar-track { background: transparent; }
+#envoy_messages pre::-webkit-scrollbar-thumb {
+  background: rgba(128, 128, 128, 0.5);
+  border-radius: 9999px;
+}
+#envoy_messages pre::-webkit-scrollbar-thumb:hover { background: rgba(128, 128, 128, 0.8); }
+
+/* ---------------------------------------------------------------------- */
+/* Tool calls                                                             */
+/* ---------------------------------------------------------------------- */
+
+.envoy-tool {
+  margin-top: 0.5rem;
+  font-size: 0.875rem;
+  border: 1px solid var(--envoy-border);
+  border-radius: 0.375rem;
+  padding: 0.5rem;
+  background: var(--envoy-surface-muted);
+}
+
+.envoy-tool__summary {
+  cursor: pointer;
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+}
+
+.envoy-tool pre {
+  font-size: 0.75rem;
+  margin-top: 0.5rem;
+  overflow-x: auto;
+  max-width: 100%;
+}
+
+.envoy-mono {
+  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+}
+
+/* Tool-call outcome badge (rendered by Envoy::Badges.outcome). Colors match
+   the original Tailwind red-100/amber-100/green-100 pairs; intentionally
+   scheme-independent, as the original badge had no dark variant. */
+.envoy-badge {
+  display: inline-block;
+  font-size: 0.75rem;
+  padding: 0.125rem 0.5rem;
+  border-radius: 0.375rem;
+  font-weight: 500;
+}
+.envoy-badge--ok     { background: #dcfce7; color: #166534; }
+.envoy-badge--failed { background: #fef3c7; color: #92400e; }
+.envoy-badge--denied { background: #fee2e2; color: #991b1b; }
+
+/* ---------------------------------------------------------------------- */
+/* Composer                                                               */
+/* ---------------------------------------------------------------------- */
+
+.envoy-composer {
+  display: flex;
+  gap: 0.5rem;
+  align-items: flex-end;
+}
+
+.envoy-input {
+  flex: 1;
+  border: 1px solid var(--envoy-border);
+  border-radius: 0.375rem;
+  padding: 0.5rem;
+  background: var(--envoy-surface);
+  color: var(--envoy-ink);
+}
+.envoy-input::placeholder { color: var(--envoy-muted); opacity: 1; }
+
+.envoy-hint {
+  font-size: 0.75rem;
+  color: var(--envoy-muted);
+  margin-top: 0.25rem;
+}
+
+/* ---------------------------------------------------------------------- */
+/* Buttons / links                                                        */
+/* ---------------------------------------------------------------------- */
+
+.envoy-btn {
+  padding: 0.375rem 0.75rem;
+  border-radius: 0.375rem;
+  background: var(--envoy-btn-bg);
+  color: var(--envoy-btn-ink);
+  border: 0;
+  cursor: pointer;
+  text-decoration: none;
+  display: inline-block;
+  flex-shrink: 0;
+  font: inherit;
+}
+.envoy-btn--secondary {
+  background: transparent;
+  color: inherit;
+  border: 1px solid var(--envoy-border);
+}
+
+.envoy-link {
+  color: var(--envoy-link);
+  text-decoration: none;
+}
+.envoy-link:hover { text-decoration: underline; }
+
+/* ---------------------------------------------------------------------- */
+/* Lists                                                                  */
+/* ---------------------------------------------------------------------- */
+
+.envoy-list { list-style: none; margin: 0; padding: 0; }
+.envoy-list > * + * { border-top: 1px solid var(--envoy-border); }
+.envoy-list__item { padding: 0.5rem 0; }
+
+/* ---------------------------------------------------------------------- */
+/* Forms                                                                  */
+/* ---------------------------------------------------------------------- */
+
+.envoy-form > * + * { margin-top: 0.75rem; }
+
+.envoy-label {
+  display: block;
+  font-size: 0.875rem;
+  color: var(--envoy-muted);
+  margin-bottom: 0.25rem;
+}
+
+.envoy-field {
+  width: 100%;
+  border: 1px solid var(--envoy-border);
+  border-radius: 0.375rem;
+  padding: 0.5rem;
+  background: var(--envoy-surface);
+  color: var(--envoy-ink);
+}
+.envoy-field::placeholder { color: var(--envoy-muted); opacity: 1; }
+.envoy-field--mono {
+  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+  font-size: 0.875rem;
+}
+
+.envoy-error {
+  color: var(--envoy-danger);
+  font-size: 0.875rem;
+  margin-bottom: 0.75rem;
+}
+
+.envoy-prose-box {
+  border: 1px solid var(--envoy-border);
+  border-radius: 0.375rem;
+  padding: 0.75rem;
+  background: var(--envoy-surface-muted);
+  white-space: pre-wrap;
+  font-size: 0.875rem;
+}
+
+.envoy-muted {
+  color: var(--envoy-muted);
+  font-size: 0.875rem;
+}

data/app/controllers/envoy/application_controller.rb

@@ -0,0 +1,18 @@
+module Envoy
+  class ApplicationController < ActionController::Base
+    protect_from_forgery with: :exception
+    before_action :envoy_authenticate!
+
+    helper_method :envoy_current_actor
+
+    private
+
+    def envoy_authenticate!
+      instance_exec(self, &Envoy.config.authenticate)
+    end
+
+    def envoy_current_actor
+      @envoy_current_actor ||= Envoy.config.actor_resolver.call(self)
+    end
+  end
+end

data/app/controllers/envoy/conversations_controller.rb

@@ -0,0 +1,36 @@
+module Envoy
+  class ConversationsController < ApplicationController
+    def index
+      @conversations = Conversation.where(actor: envoy_current_actor).order(created_at: :desc)
+    end
+
+    def new
+      @conversation = Conversation.new
+    end
+
+    def create
+      @conversation = Conversation.new(conversation_params)
+      @conversation.actor = envoy_current_actor
+      @conversation.model_id ||= Envoy.config.default_model
+      @conversation.provider = Envoy.config.provider.to_s
+      if (pid = params.dig(:conversation, :system_prompt_id)).present?
+        @conversation.system_prompt_version = Envoy::SystemPrompt.find(pid).latest_version
+      end
+      if @conversation.save
+        redirect_to conversation_path(@conversation)
+      else
+        render :new, status: :unprocessable_entity
+      end
+    end
+
+    def show
+      @conversation = Conversation.where(actor: envoy_current_actor).find(params[:id])
+    end
+
+    private
+
+    def conversation_params
+      params.require(:conversation).permit(:title, :model_id, :toolset_key, :system_prompt)
+    end
+  end
+end

data/app/controllers/envoy/messages_controller.rb

@@ -0,0 +1,14 @@
+module Envoy
+  class MessagesController < ApplicationController
+    def create
+      @conversation = Conversation.where(actor: envoy_current_actor).find(params[:conversation_id])
+      content = params.require(:message).fetch(:content)
+      Envoy::RunJob.perform_later(@conversation, content)
+
+      respond_to do |format|
+        format.turbo_stream { @user_content = content }
+        format.html { redirect_to conversation_path(@conversation) }
+      end
+    end
+  end
+end

data/app/controllers/envoy/system_prompts_controller.rb

@@ -0,0 +1,52 @@
+module Envoy
+  class SystemPromptsController < ApplicationController
+    def index
+      @system_prompts = SystemPrompt.order(:name)
+    end
+
+    def show
+      @system_prompt = SystemPrompt.find(params[:id])
+    end
+
+    def new
+      @system_prompt = SystemPrompt.new
+    end
+
+    def create
+      @system_prompt = SystemPrompt.new(prompt_params.except(:body))
+      body = prompt_params[:body].to_s
+      if body.blank?
+        @system_prompt.errors.add(:base, "Body can't be blank")
+        return render :new, status: :unprocessable_entity
+      end
+      SystemPrompt.transaction do
+        @system_prompt.save!
+        @system_prompt.add_version!(body)
+      end
+      redirect_to system_prompt_path(@system_prompt), notice: "Prompt created."
+    rescue ActiveRecord::RecordInvalid
+      render :new, status: :unprocessable_entity
+    end
+
+    def edit
+      @system_prompt = SystemPrompt.find(params[:id])
+    end
+
+    def update
+      @system_prompt = SystemPrompt.find(params[:id])
+      if @system_prompt.update(prompt_params.except(:body))
+        body = prompt_params[:body].to_s
+        @system_prompt.add_version!(body) if body.present? && body != @system_prompt.current_body
+        redirect_to system_prompt_path(@system_prompt), notice: "Prompt updated."
+      else
+        render :edit, status: :unprocessable_entity
+      end
+    end
+
+    private
+
+    def prompt_params
+      params.require(:system_prompt).permit(:name, :description, :body)
+    end
+  end
+end

data/app/javascript/envoy/controllers/autoscroll_controller.js

@@ -0,0 +1,46 @@
+import { Controller } from "@hotwired/stimulus"
+
+// Wraps the message region. Keeps the window scrolled to the newest content as
+// it streams in. If the user scrolls away from the bottom, autoscroll pauses;
+// it resumes when they scroll back to the bottom or send a new message.
+export default class extends Controller {
+  connect() {
+    this.stick = true
+
+    // Content changes (appends + streaming replaces) trigger a scroll-to-bottom.
+    this.observer = new MutationObserver(() => {
+      if (this.stick) this.toBottom()
+    })
+    this.observer.observe(this.element, {
+      childList: true, subtree: true, characterData: true
+    })
+
+    // wheel/touch are unambiguously user-initiated (our own scrollTo doesn't
+    // fire them), so use them to decide whether to keep sticking to the bottom.
+    this.onUserScroll = () => { this.stick = this.atBottom() }
+    window.addEventListener("wheel", this.onUserScroll, { passive: true })
+    window.addEventListener("touchmove", this.onUserScroll, { passive: true })
+
+    // A new message re-enables autoscroll for that response.
+    this.onSubmit = () => { this.stick = true; this.toBottom() }
+    document.addEventListener("turbo:submit-end", this.onSubmit)
+
+    this.toBottom()
+  }
+
+  disconnect() {
+    this.observer?.disconnect()
+    window.removeEventListener("wheel", this.onUserScroll)
+    window.removeEventListener("touchmove", this.onUserScroll)
+    document.removeEventListener("turbo:submit-end", this.onSubmit)
+  }
+
+  atBottom() {
+    const doc = document.documentElement
+    return window.innerHeight + window.scrollY >= doc.scrollHeight - 48
+  }
+
+  toBottom() {
+    window.scrollTo({ top: document.documentElement.scrollHeight })
+  }
+}

data/app/javascript/envoy/controllers/composer_controller.js

@@ -0,0 +1,30 @@
+import { Controller } from "@hotwired/stimulus"
+
+// Mounted on the composer textarea. Enter submits; Shift+Enter (native) and
+// Option/Alt+Enter insert a newline instead — matching common chat interfaces.
+// Clearing the textarea after send is handled server-side by the
+// create.turbo_stream response, so sending still works without this controller.
+export default class extends Controller {
+  submit(event) {
+    if (event.key !== "Enter") return
+    if (event.shiftKey) return // native newline
+
+    if (event.altKey) {
+      // Option/Alt+Enter has no reliable native newline in a textarea; do it.
+      event.preventDefault()
+      this.insertNewline()
+      return
+    }
+
+    event.preventDefault()
+    this.element.closest("form").requestSubmit()
+  }
+
+  insertNewline() {
+    const el = this.element
+    const { selectionStart: start, selectionEnd: end, value } = el
+    el.value = `${value.slice(0, start)}\n${value.slice(end)}`
+    el.selectionStart = el.selectionEnd = start + 1
+    el.dispatchEvent(new Event("input", { bubbles: true }))
+  }
+}

data/app/jobs/envoy/application_job.rb

@@ -0,0 +1,4 @@
+module Envoy
+  class ApplicationJob < ActiveJob::Base
+  end
+end

data/app/jobs/envoy/run_job.rb

@@ -0,0 +1,65 @@
+module Envoy
+  class RunJob < ApplicationJob
+    STREAM_TARGET = "envoy_streaming_reply"
+
+    # GlobalID serialization of the Conversation (and its polymorphic actor)
+    # is handled by ActiveJob automatically.
+    def perform(conversation, content)
+      # RubyLLM yields incremental deltas; accumulate them so each broadcast
+      # carries the full text so far (broadcast_replace_to replaces, not appends).
+      # This also makes streaming race-proof: a missed early broadcast is harmless
+      # because every later one contains the whole reply.
+      @streamed = +""
+      Envoy::Runner.new(conversation: conversation).call(content: content) do |event|
+        stream(conversation, event)
+      end
+      finalize(conversation)
+    end
+
+    private
+
+    # Live streaming: accumulate deltas and replace the streaming target (which
+    # lives at the bottom of the message list) with the growing assistant bubble.
+    # Tool events aren't forwarded by the LLM seam in production; the completed
+    # tool calls appear when the turn finalizes.
+    def stream(conversation, (kind, payload))
+      return unless kind == :delta
+
+      @streamed << payload.to_s
+      Turbo::StreamsChannel.broadcast_replace_to(
+        conversation, "messages",
+        target: STREAM_TARGET,
+        partial: "envoy/messages/streaming",
+        locals: { content: @streamed }
+      )
+    end
+
+    # Replace the streaming target with the persisted assistant messages
+    # (authoritative text + tool calls, and no streaming id). This "commits" the
+    # reply into the history so the next turn's fresh target appends AFTER it and
+    # message order stays correct across turns.
+    def finalize(conversation)
+      messages = committed_messages(conversation)
+      return if messages.empty?
+
+      Turbo::StreamsChannel.broadcast_replace_to(
+        conversation, "messages",
+        target: STREAM_TARGET,
+        partial: "envoy/messages/message",
+        collection: messages,
+        as: :message
+      )
+    end
+
+    # Every assistant message the turn produced — those created after the last
+    # user message. A tool-using turn spans multiple assistant messages (the
+    # tool-call request, which carries the chips, then the final text answer);
+    # committing only the last dropped the chips from the live view until reload.
+    def committed_messages(conversation)
+      last_user_id = conversation.messages.where(role: "user").maximum(:id)
+      scope = conversation.messages.where(role: "assistant").order(:id)
+      scope = scope.where("id > ?", last_user_id) if last_user_id
+      scope.to_a
+    end
+  end
+end

data/app/models/envoy/application_record.rb

@@ -0,0 +1,5 @@
+module Envoy
+  class ApplicationRecord < ActiveRecord::Base
+    self.abstract_class = true
+  end
+end

data/app/models/envoy/conversation.rb

@@ -0,0 +1,20 @@
+module Envoy
+  class Conversation < ApplicationRecord
+    acts_as_chat message_class: "Envoy::Message", tool_call_class: "Envoy::ToolCall"
+
+    belongs_to :actor, polymorphic: true
+    belongs_to :system_prompt_version, class_name: "Envoy::SystemPromptVersion", optional: true
+
+    validates :model_id, :toolset_key, presence: true
+
+    def toolset
+      Envoy.toolset(toolset_key)
+    end
+
+    # Version body (if pinned) is primary; custom text (if any) is appended as
+    # chat-specific context. Either stands alone; both compose; neither -> nil.
+    def effective_system_prompt
+      [ system_prompt_version&.body, system_prompt ].compact_blank.join("\n\n").presence
+    end
+  end
+end

data/app/models/envoy/message.rb

@@ -0,0 +1,8 @@
+module Envoy
+  class Message < ApplicationRecord
+    acts_as_message chat_class: "Envoy::Conversation",
+                    chat_foreign_key: "conversation_id",
+                    tool_call_class: "Envoy::ToolCall"
+    # Do NOT validate content presence — it is null during streaming init.
+  end
+end