insika 0.0.1 → 0.2.0

data/lib/insika/studio/views/agent_detail.erb

@@ -0,0 +1,285 @@
+<header class="page-head">
+  <div>
+    <nav class="crumbs"><a href="/studio/agents">agents</a> / <span><%= @agent.id %></span></nav>
+    <h1><span class="avatar sm"><%= @agent.id[0, 2].upcase %></span><%= @agent.id %>
+      <span class="sub"><%= @agent.model %><%== " · #{h(@agent.provider)}" if @agent.provider %></span>
+    </h1>
+  </div>
+  <a class="btn primary" href="/studio/playground?agent=<%= Rack::Utils.escape(@agent.id) %>">Open playground →</a>
+</header>
+
+<nav class="subnav">
+  <a href="#config">config</a>
+  <a href="#prompts">prompts</a>
+  <a href="#skills">skills</a>
+  <a href="#memory">memory</a>
+  <a href="#history">history</a>
+</nav>
+
+<!-- ── Config / model ────────────────────────────────────────────────────── -->
+<section class="section" id="config">
+  <div class="section-head"><h2>Configuration</h2><p class="muted">model, provider, memory, limits, generation params and the model fence — saved via <code>update_agent</code>.</p></div>
+  <form class="card" method="post" action="/studio/agents/<%= Rack::Utils.escape(@agent.id) %>/config">
+    <%== csrf_tag %>
+    <div class="grid-2">
+      <label>model <span class="muted">(blank = platform <code>default_model</code>)</span>
+        <input type="text" name="model" value="<%= @agent.model %>" placeholder="inherit platform default">
+      </label>
+      <label>provider
+        <input type="text" name="provider" value="<%= @agent.provider %>" placeholder="deepseek">
+      </label>
+      <label>turn_timeout (s)
+        <input type="text" name="turn_timeout" value="<%= @agent.limits[:turn_timeout] %>" inputmode="numeric">
+      </label>
+      <label>tool_timeout (s)
+        <input type="text" name="tool_timeout" value="<%= @agent.limits[:tool_timeout] %>" inputmode="numeric">
+      </label>
+      <label>tool_concurrency <span class="muted">(parallel tool calls; 1 = serial, off for turns with approvals)</span>
+        <input type="text" name="tool_concurrency" value="<%= @agent.limits[:tool_concurrency] %>" inputmode="numeric">
+      </label>
+      <label>chat_rate_limit <span class="muted">(turns/chat/window; blank = platform, 0 = off)</span>
+        <input type="text" name="chat_rate_limit" value="<%= @agent.limits[:chat_rate_limit] %>" inputmode="numeric" placeholder="inherit platform edge">
+      </label>
+      <label>agent_token_ceiling <span class="muted">(tokens/window; blank = platform, 0 = off)</span>
+        <input type="text" name="agent_token_ceiling" value="<%= @agent.limits[:agent_token_ceiling] %>" inputmode="numeric" placeholder="inherit platform edge">
+      </label>
+    </div>
+    <label class="check">
+      <input type="checkbox" name="memory" value="1"<%== " checked" if @agent.memory %>>
+      cross-session memory (the BIA remembers across conversations)
+    </label>
+
+    <fieldset class="subgroup">
+      <legend>generation params <span class="muted">— blank = provider default</span></legend>
+      <div class="grid-3">
+        <label>temperature
+          <input type="text" name="temperature" value="<%= agent_param(@params, :temperature) %>" inputmode="decimal" placeholder="0.7">
+        </label>
+        <label>max_tokens
+          <input type="text" name="max_tokens" value="<%= agent_param(@params, :max_tokens) %>" inputmode="numeric" placeholder="4096">
+        </label>
+        <label>reasoning <span class="muted">(off/on/effort — blank = inherit model/platform)</span>
+          <%== thinking_select("thinking", agent_param(@params, :thinking), "inherit") %>
+        </label>
+      </div>
+    </fieldset>
+
+    <label>model fence <span class="muted">(<code>model_policy.allow</code> — one ref per line: <code>provider/model</code>, <code>provider/*</code> or <code>model</code>; blank = no fence)</span>
+      <textarea name="model_policy_allow" rows="3" placeholder="deepseek/*&#10;openai/gpt-4o-mini"><%= @model_policy_allow %></textarea>
+    </label>
+
+    <fieldset class="subgroup">
+      <legend>guardrails <span class="muted">— content safety</span></legend>
+      <label class="check">
+        <input type="checkbox" name="guardrail_input" value="1"<%== " checked" if guardrail_field(@guardrails, :input, true) %>>
+        input guardrail <span class="muted">— block injection / abuse / inappropriate before the LLM</span>
+      </label>
+      <label class="check">
+        <input type="checkbox" name="guardrail_output" value="1"<%== " checked" if guardrail_field(@guardrails, :output, true) %>>
+        output guardrail <span class="muted">— redact PII/secret in the stream + flag policy slips</span>
+      </label>
+      <div class="grid-2">
+        <label>strictness
+          <% strictness = guardrail_field(@guardrails, :strictness, "medium").to_s %>
+          <select name="guardrail_strictness">
+            <% %w[low medium high].each do |lvl| %>
+              <option value="<%= lvl %>"<%== " selected" if lvl == strictness %>><%= lvl %></option>
+            <% end %>
+          </select>
+        </label>
+        <label>LLM moderator <span class="muted">(model ref, or <code>on</code> for the platform utility_model; blank = deterministic only)</span>
+          <input type="text" name="guardrail_moderator" value="<%= guardrail_field(@guardrails, :moderator, "") %>" placeholder="deepseek/deepseek-v4-flash">
+        </label>
+      </div>
+      <details class="newfile">
+        <summary>safe replies — override per category <span class="muted">(blank = engine default; this agent's voice/language)</span></summary>
+        <% gr_resp = (@guardrails["responses"] || @guardrails[:responses] || {}) %>
+        <label>default <span class="muted">(catch-all for any blocked category)</span>
+          <textarea name="guardrail_response_default" rows="2" placeholder="I can't help with that particular request…"><%= guardrail_field(gr_resp, :default, "") %></textarea>
+        </label>
+        <div class="grid-2">
+          <% %w[injection sexual abuse escalate].each do |cat| %>
+            <label><%= cat %>
+              <textarea name="guardrail_response_<%= cat %>" rows="2"><%= guardrail_field(gr_resp, cat, "") %></textarea>
+            </label>
+          <% end %>
+        </div>
+      </details>
+    </fieldset>
+
+    <div class="actions"><button type="submit" class="primary" data-turbo-submits-with="Saving…">Save config</button></div>
+  </form>
+</section>
+
+<!-- ── Prompts / identity (island code-editor) ───────────────────────────── -->
+<section class="section" id="prompts">
+  <div class="section-head">
+    <h2>Prompts <span class="pill info plain"><%= @prompt_files.size %></span></h2>
+    <p class="muted">the BIA's own identity (store-backed, versioned). Empty = uses the deployment default.</p>
+  </div>
+
+  <% if @prompt_files.empty? %>
+    <div class="empty">No authored prompts. Create a file below (e.g. <code>IDENTITY.md</code>) to give this agent its own identity.</div>
+  <% end %>
+
+  <% @prompt_files.each do |pf| %>
+    <div class="card promptfile">
+      <div class="promptfile-head">
+        <strong class="mono"><%= pf[:name] %></strong>
+        <form method="post" action="/studio/agents/<%= Rack::Utils.escape(@agent.id) %>/prompts/delete" data-turbo-confirm="Remove prompt file &quot;<%= pf[:name] %>&quot;? This can't be undone.">
+          <%== csrf_tag %>
+          <input type="hidden" name="file" value="<%= pf[:name] %>">
+          <button type="submit" class="ghost danger" data-turbo-submits-with="Removing…">Remove</button>
+        </form>
+      </div>
+      <form method="post" action="/studio/agents/<%= Rack::Utils.escape(@agent.id) %>/prompts" data-controller="dirty-guard">
+        <%== csrf_tag %>
+        <input type="hidden" name="file" value="<%= pf[:name] %>">
+        <div data-controller="code-editor" data-code-editor-language-value="markdown" data-code-editor-preview-value="true">
+          <textarea name="content" data-code-editor-target="source" rows="10"><%= pf[:content] %></textarea>
+        </div>
+        <div class="actions"><button type="submit" class="primary" data-turbo-submits-with="Saving…">Save prompt</button></div>
+      </form>
+      <% unless pf[:versions].empty? %>
+        <details class="versions">
+          <summary><%= pf[:versions].size %> previous version(s)</summary>
+          <ul>
+            <% pf[:versions].each_with_index do |v, i| %>
+              <li>
+                <span class="muted mono"><%= v["at"] %></span>
+                <form method="post" action="/studio/agents/<%= Rack::Utils.escape(@agent.id) %>/prompts/restore">
+                  <%== csrf_tag %>
+                  <input type="hidden" name="file" value="<%= pf[:name] %>">
+                  <input type="hidden" name="version" value="<%= i %>">
+                  <button type="submit" class="ghost">Restore</button>
+                </form>
+              </li>
+            <% end %>
+          </ul>
+        </details>
+      <% end %>
+    </div>
+  <% end %>
+
+  <details class="card newfile">
+    <summary>+ new prompt file</summary>
+    <form method="post" action="/studio/agents/<%= Rack::Utils.escape(@agent.id) %>/prompts" data-controller="dirty-guard">
+      <%== csrf_tag %>
+      <label>file name
+        <input type="text" name="file" placeholder="IDENTITY.md" required>
+      </label>
+      <div data-controller="code-editor" data-code-editor-language-value="markdown" data-code-editor-preview-value="true">
+        <textarea name="content" data-code-editor-target="source" rows="8" placeholder="# Identity&#10;You are..."></textarea>
+      </div>
+      <div class="actions"><button type="submit" class="primary" data-turbo-submits-with="Creating…">Create prompt</button></div>
+    </form>
+  </details>
+</section>
+
+<!-- ── Agent skills ──────────────────────────────────────────────────────── -->
+<section class="section" id="skills">
+  <div class="section-head">
+    <h2>Skills</h2>
+    <p class="muted">which catalog skills this agent may load (<code>load_skill</code>).</p>
+  </div>
+  <form class="card" method="post" action="/studio/agents/<%= Rack::Utils.escape(@agent.id) %>/skills">
+    <%== csrf_tag %>
+    <label class="check">
+      <input type="checkbox" name="all_skills" value="1"<%== " checked" if @agent_skills.nil? %>>
+      all skills (open allowlist)
+    </label>
+    <% if @all_skills.empty? %>
+      <p class="muted">No skills in the catalog. Create one under <a href="/studio/skills/new">skills → new</a>.</p>
+    <% else %>
+      <div class="check-grid">
+        <% @all_skills.sort_by(&:name).each do |s| %>
+          <label class="check">
+            <input type="checkbox" name="skills[]" value="<%= s.name %>"<%== " checked" if @agent_skills&.include?(s.name) %>>
+            <span class="mono"><%= s.name %></span>
+          </label>
+        <% end %>
+      </div>
+    <% end %>
+    <div class="actions">
+      <button type="submit" class="primary" data-turbo-submits-with="Saving…">Save skills</button>
+      <a class="btn ghost" href="/studio/tools">Edit tools →</a>
+    </div>
+  </form>
+</section>
+
+<!-- ── Agent memory (tenant = id) ────────────────────────────────────────── -->
+<section class="section" id="memory">
+  <div class="section-head">
+    <h2>Memory</h2>
+    <p class="muted">facts and notes the BIA reads each turn (tenant <code><%= @agent.id %></code>).</p>
+  </div>
+  <div class="card">
+    <h3>Facts</h3>
+    <% if @facts.empty? %>
+      <p class="muted">No facts.</p>
+    <% else %>
+      <ul class="kv">
+        <% @facts.each do |f| %>
+          <li>
+            <span class="k mono"><%= f.key %></span>
+            <span class="v"><%= f.value %></span>
+            <form method="post" action="/studio/agents/<%= Rack::Utils.escape(@agent.id) %>/memory/forget" data-turbo-confirm="Forget &quot;<%= f.key %>&quot;? The agent loses this fact from the next turn on.">
+              <%== csrf_tag %>
+              <input type="hidden" name="key" value="<%= f.key %>">
+              <button type="submit" class="ghost danger" data-turbo-submits-with="Forgetting…">Forget</button>
+            </form>
+          </li>
+        <% end %>
+      </ul>
+    <% end %>
+    <form class="inline-form" method="post" action="/studio/agents/<%= Rack::Utils.escape(@agent.id) %>/memory/fact">
+      <%== csrf_tag %>
+      <input type="text" name="key" placeholder="key (e.g. customer_name)" required>
+      <input type="text" name="value" placeholder="value" required>
+      <button type="submit" class="primary" data-turbo-submits-with="Saving…">Save fact</button>
+    </form>
+  </div>
+
+  <div class="card">
+    <h3>Notes <span class="muted">(recent)</span></h3>
+    <% if @notes.empty? %>
+      <p class="muted">No notes.</p>
+    <% else %>
+      <ul class="notes">
+        <% @notes.each do |n| %>
+          <li><span class="muted mono"><%= n.created_at %></span> <%= n.text %></li>
+        <% end %>
+      </ul>
+    <% end %>
+    <form class="inline-form" method="post" action="/studio/agents/<%= Rack::Utils.escape(@agent.id) %>/memory/note">
+      <%== csrf_tag %>
+      <input type="text" name="text" placeholder="free-form note…" required>
+      <button type="submit" class="primary" data-turbo-submits-with="Adding…">Add note</button>
+    </form>
+  </div>
+</section>
+
+<!-- ── History ───────────────────────────────────────────────────────────── -->
+<section class="section" id="history">
+  <div class="section-head">
+    <h2>History</h2>
+    <p class="muted">recent conversations (all agents — a session doesn't stamp its author).</p>
+  </div>
+  <% if @recent_sessions.empty? %>
+    <div class="empty">No conversations yet. Start one in the <a href="/studio/playground?agent=<%= Rack::Utils.escape(@agent.id) %>">playground</a>.</div>
+  <% else %>
+    <div class="card">
+      <ul class="history">
+        <% @recent_sessions.each do |s| %>
+          <li>
+            <a href="/studio/sessions/<%= Rack::Utils.escape(s.id) %>">
+              <span class="mono"><%= s.id[0, 12] %></span>
+            </a>
+            <span class="muted"><%= Array(s.messages).size %> msg · <%= s.updated_at %></span>
+            <% if (p = session_preview(s)) %><span class="preview muted"><%= p[0, 80] %></span><% end %>
+          </li>
+        <% end %>
+      </ul>
+    </div>
+  <% end %>
+</section>

data/lib/insika/studio/views/agents.erb

@@ -0,0 +1,63 @@
+<header class="page-head">
+  <h1>Agents<span class="sub"><%= @agents.size %> configured · one BIA each</span></h1>
+  <a class="btn primary" href="/studio/playground">Open playground →</a>
+</header>
+
+<% if @agents.empty? %>
+  <div class="empty">No agents yet. Create your first BIA below (id + model), then give it an identity on its detail page.</div>
+<% else %>
+  <div data-controller="list-filter">
+    <div class="filter-bar">
+      <input type="search" class="filter-input" placeholder="Filter agents by id, model or provider…" aria-label="Filter agents"
+             data-list-filter-target="query" data-action="input->list-filter#filter keydown->list-filter#clear">
+      <span class="filter-count mono muted" data-list-filter-target="count"></span>
+    </div>
+  <div class="agent-grid">
+    <% @agents.each do |a| %>
+      <article class="card agent" data-list-filter-target="item" data-filter-text="<%= a.id %> <%= a.model %> <%= a.provider %>">
+        <a class="agent-head" href="/studio/agents/<%= Rack::Utils.escape(a.id) %>">
+          <span class="avatar"><%= a.id[0, 2].upcase %></span>
+          <div>
+            <div class="agent-id"><%= a.id %></div>
+            <div class="muted mono"><%= a.model %><%== " · #{h(a.provider)}" if a.provider %></div>
+          </div>
+          <% if a.memory %><span class="pill info">memory</span><% end %>
+        </a>
+        <dl class="agent-meta">
+          <div><dt>tools</dt><dd><%= a.tools_allow.nil? ? "all" : a.tools_allow.size %></dd></div>
+          <div><dt>skills</dt><dd><%= a.skills.nil? ? "all" : Array(a.skills).size %></dd></div>
+          <div><dt>prompts</dt><dd><%= Array(a.prompt_files).size %></dd></div>
+        </dl>
+        <div class="agent-actions">
+          <a class="btn" href="/studio/agents/<%= Rack::Utils.escape(a.id) %>">Edit</a>
+          <a class="btn ghost" href="/studio/playground?agent=<%= Rack::Utils.escape(a.id) %>">Test</a>
+        </div>
+      </article>
+    <% end %>
+  </div>
+    <div class="empty" data-list-filter-target="empty" hidden>No agents match your filter.</div>
+  </div>
+<% end %>
+
+<details class="card newfile"<%== " open" if @agents.empty? %>>
+  <summary>+ new agent</summary>
+  <form method="post" action="/studio/agents">
+    <%== csrf_tag %>
+    <div class="grid-2">
+      <label>id <span class="muted">(unique slug, e.g. bia)</span>
+        <input type="text" name="id" placeholder="bia" required>
+      </label>
+      <label>model
+        <input type="text" name="model" placeholder="deepseek-v4-flash" required>
+      </label>
+    </div>
+    <label>provider <span class="muted">(optional)</span>
+      <input type="text" name="provider" placeholder="deepseek">
+    </label>
+    <label class="check">
+      <input type="checkbox" name="memory" value="1" checked>
+      cross-session memory (the BIA remembers across conversations)
+    </label>
+    <div class="actions"><button type="submit" class="primary" data-turbo-submits-with="Creating…">Create agent</button></div>
+  </form>
+</details>

data/lib/insika/studio/views/approvals.erb

@@ -0,0 +1,41 @@
+<header class="page-head">
+  <div>
+    <nav class="crumbs"><span>approvals</span></nav>
+    <h1>Approvals<span class="sub"><%= @approvals.size %> pending</span></h1>
+  </div>
+  <a class="btn" href="/studio/tasks">Tasks →</a>
+</header>
+
+<% if @approvals.empty? %>
+  <div class="empty">No pending approvals. Actions that need a human decision (approval-gated tools) land here.</div>
+<% else %>
+  <% @approvals.each do |a| %>
+    <% pa = a[:pending]; task = a[:task] %>
+    <div class="card">
+      <div class="skill-name mono">
+        <%= pa.tool %>
+        <% if task %><span class="pill <%= status_class(task.status) %>"><%= task.status %></span><% end %>
+      </div>
+      <div class="skill-desc muted">
+        <a class="mono" href="<%= task_path(pa.task_id) %>">task <%= pa.task_id[0, 12] %></a>
+        · turn <%= pa.turn %> · requested <%= pa.requested_at %>
+      </div>
+      <pre><%= message_content(pa.args) %></pre>
+      <div class="actions">
+        <form method="post" action="/studio/approvals/<%= Rack::Utils.escape(pa.id) %>">
+          <%== csrf_tag %>
+          <input type="hidden" name="decision" value="approved">
+          <input type="hidden" name="back" value="/studio/approvals">
+          <button type="submit" class="primary">Approve</button>
+        </form>
+        <form method="post" action="/studio/approvals/<%= Rack::Utils.escape(pa.id) %>"
+              data-turbo-confirm="Reject this action? The turn resumes as if the tool was denied.">
+          <%== csrf_tag %>
+          <input type="hidden" name="decision" value="rejected">
+          <input type="hidden" name="back" value="/studio/approvals">
+          <button type="submit" class="danger">Reject</button>
+        </form>
+      </div>
+    </div>
+  <% end %>
+<% end %>

data/lib/insika/studio/views/chats.erb

@@ -0,0 +1,34 @@
+<header class="page-head">
+  <div>
+    <nav class="crumbs"><a href="/studio/agents">agents</a> / <span>chats</span></nav>
+    <h1>Chats<span class="sub"><%= @sessions.size %> recent conversation(s)</span></h1>
+  </div>
+  <a class="btn primary" href="/studio/playground">New conversation →</a>
+</header>
+
+<% if @sessions.empty? %>
+  <div class="empty">No conversations yet. Start one in the <a href="/studio/playground">playground</a>.</div>
+<% else %>
+  <div data-controller="list-filter">
+    <div class="filter-bar">
+      <input type="search" class="filter-input" placeholder="Filter conversations by id or preview…" aria-label="Filter conversations"
+             data-list-filter-target="query" data-action="input->list-filter#filter keydown->list-filter#clear">
+      <span class="filter-count mono muted" data-list-filter-target="count"></span>
+    </div>
+    <div class="card">
+      <ul class="history">
+        <% @sessions.each do |s| %>
+          <% preview = session_preview(s) %>
+          <li data-list-filter-target="item" data-filter-text="<%= s.id %> <%= preview %>">
+            <a href="/studio/sessions/<%= Rack::Utils.escape(s.id) %>">
+              <span class="mono"><%= s.id[0, 12] %></span>
+            </a>
+            <span class="muted"><%= Array(s.messages).size %> msg · <%= s.updated_at %></span>
+            <% if preview %><span class="preview muted"><%= preview[0, 90] %></span><% end %>
+          </li>
+        <% end %>
+      </ul>
+    </div>
+    <div class="empty" data-list-filter-target="empty" hidden>No conversations match your filter.</div>
+  </div>
+<% end %>

data/lib/insika/studio/views/evals.erb

@@ -0,0 +1,83 @@
+<header class="page-head">
+  <div>
+    <nav class="crumbs"><span>evals</span></nav>
+    <h1>Evals<span class="sub"><%= @cases.size %> case(s)</span></h1>
+  </div>
+  <a class="btn" href="/studio/settings?s=evals">Judges →</a>
+</header>
+
+<% if @invalid.any? %>
+  <div class="empty">
+    <strong><%= @invalid.size %> case(s) no longer validate</strong> and are SKIPPED by a run:
+    <span class="mono"><%= @invalid.join(", ") %></span>. Fix the YAML or re-import the corpus
+    (<code>insika evals:import</code>).
+  </div>
+<% end %>
+
+<div class="drill">
+  <aside class="drill-pane drill-master">
+    <div class="drill-pane-head"><div class="title"><strong>Cases</strong></div></div>
+    <nav class="drill-pane-body drill-list" aria-label="eval cases">
+      <% if @cases.empty? %>
+        <div class="empty">No case yet. Seed the corpus with <code>insika evals:import</code>, or write one on the right.</div>
+      <% end %>
+      <% @by_agent.each do |agent, cases| %>
+        <div class="nav-label"><%= agent %></div>
+        <% cases.each do |g| %>
+          <a class="drill-item<%== ' active' if @case && @case.id == g.id %>" href="/studio/evals?id=<%= Rack::Utils.escape(g.id) %>">
+            <div class="drill-item-name"><span class="txt mono"><%= g.id %></span><% if g.rubric.to_s.strip.empty? %><span class="pill info plain">no rubric</span><% end %></div>
+            <div class="drill-item-sub"><%= g.user_turns.first %></div>
+          </a>
+        <% end %>
+      <% end %>
+    </nav>
+  </aside>
+
+  <section class="drill-pane drill-detail">
+    <div class="drill-pane-head">
+      <div class="title"><strong><%= @case ? @case.id : "New case" %></strong></div>
+      <div class="actions">
+        <% if @case %>
+          <form method="post" action="/studio/evals/<%= Rack::Utils.escape(@case.id) %>/delete"
+                data-turbo-confirm="Remove case &quot;<%= @case.id %>&quot;? The corpus on disk is the way back.">
+            <%== csrf_tag %>
+            <button type="submit" class="ghost danger" data-turbo-submits-with="Removing…">Remove</button>
+          </form>
+        <% end %>
+        <button type="submit" form="set-golden" class="btn primary" data-turbo-submits-with="Saving…">Save</button>
+      </div>
+    </div>
+    <div class="drill-pane-body">
+      <p class="muted">
+        A case is data, in the same YAML the corpus files hold — so this is what a pull
+        request reviews. <code>expect.rubric</code> is plain language and is the part a
+        judge scores; <code>tools_called</code> and <code>must_not</code> are checked
+        deterministically, with no model involved. Saved through
+        <code>write_golden</code> and validated on the way in.
+      </p>
+      <form id="set-golden" method="post" action="/studio/evals">
+        <%== csrf_tag %>
+        <input type="hidden" name="id" value="<%= @case&.id %>">
+        <label>case (YAML)
+          <textarea name="yaml" rows="22" spellcheck="false" class="mono"><%= @case_yaml || <<~YAML %>
+            id: my-agent-coupon
+            agent: my-agent
+            turns:
+              - user: "tem cupom de desconto?"
+            expect:
+              tools_called:
+                - search_voucher
+              must_not:
+                - pii_leak
+                - tool_error
+              rubric: |
+                Consults the active coupon with the tool and says what it is — does NOT
+                invent a code or a discount. If there is none, says so kindly.
+              min_score: 0.7
+          YAML
+          </textarea>
+        </label>
+      </form>
+    </div>
+  </section>
+</div>

data/lib/insika/studio/views/home.erb

@@ -0,0 +1,72 @@
+<%# Overview home (T3): stat cards + activity chart + recent conversations.
+   All from data the Studio already reads; charts are inline SVG (geometry via
+   attributes, fill via stylesheet — CSP-safe, no inline style). %>
+<header class="page-head">
+  <div>
+    <h1>Overview<span class="sub">at a glance</span></h1>
+  </div>
+  <div class="head-actions">
+    <span class="pill <%= @active_now.positive? ? "ok online" : "info" %> plain"><%= @active_now %> active now</span>
+    <a class="btn primary" href="/studio/playground">Open playground →</a>
+  </div>
+</header>
+
+<div class="stat-cards">
+  <% [["conversations", "Conversations"], ["messages", "Messages"], ["agents", "Agents"],
+      ["skills", "Skills"], ["tools", "Tools"], ["providers", "LLM providers"]].each do |key, label| %>
+    <div class="stat-card">
+      <div class="stat-num"><%= @counts[key] %></div>
+      <div class="stat-label"><%= label %></div>
+    </div>
+  <% end %>
+</div>
+
+<div class="home-grid">
+  <section class="card home-activity">
+    <div class="section-head">
+      <h2>Activity</h2>
+      <span class="muted">conversations touched · last 14 days</span>
+    </div>
+    <% max = [@activity.map(&:last).max || 0, 1].max %>
+    <svg class="barchart" viewBox="0 0 700 176" preserveAspectRatio="none" role="img" aria-label="conversations per day, last 14 days">
+      <% n = @activity.size; slot = 700.0 / n; bw = slot * 0.58 %>
+      <% @activity.each_with_index do |(d, c), i| %>
+        <% h = (c.to_f / max) * 150.0; x = (i * slot) + ((slot - bw) / 2.0); y = 160.0 - h %>
+        <rect class="bar<%== ' bar-empty' if c.zero? %>" x="<%= format('%.1f', x) %>" y="<%= format('%.1f', c.zero? ? 157.0 : y) %>"
+              width="<%= format('%.1f', bw) %>" height="<%= format('%.1f', c.zero? ? 3.0 : [h, 3.0].max) %>" rx="2">
+          <title><%= d.strftime('%b %-d') %> · <%= c %> conversation<%= 's' unless c == 1 %></title>
+        </rect>
+      <% end %>
+      <line class="barchart-axis-line" x1="0" y1="160" x2="700" y2="160" />
+    </svg>
+    <div class="barchart-axis">
+      <span><%= @activity.first&.first&.strftime('%b %-d') %></span>
+      <span class="peak">peak <%= max %>/day</span>
+      <span><%= @activity.last&.first&.strftime('%b %-d') %></span>
+    </div>
+  </section>
+
+  <section class="card home-recent">
+    <div class="section-head">
+      <h2>Recent conversations</h2>
+      <a class="muted" href="/studio/chats">all →</a>
+    </div>
+    <% if @recent.empty? %>
+      <div class="empty">No conversations yet. Start one in the <a href="/studio/playground">playground</a>.</div>
+    <% else %>
+      <ul class="convo-rail">
+        <% @recent.each do |s| %>
+          <li>
+            <a href="/studio/sessions/<%= Rack::Utils.escape(s.id) %>">
+              <span class="avatar sm"><%= s.id[0, 2].upcase %></span>
+              <span class="convo-main">
+                <span class="convo-id mono"><%= s.id[0, 20] %></span>
+                <span class="convo-sub"><%= Array(s.messages).size %> msg · <%= time_ago(s.updated_at) %></span>
+              </span>
+            </a>
+          </li>
+        <% end %>
+      </ul>
+    <% end %>
+  </section>
+</div>