insika 0.9.0 → 1.0.1

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

@@ -2,7 +2,8 @@
 <!-- ── Config / model ────────────────────────────────────────────────────── -->
 <section class="section" id="config" data-tabs-target="panel">
   <% config_groups = [
-       ["model", "Model & limits", "model, provider, timeouts, ceilings, generation, fence"],
+       ["model", "Model & limits", "model, generation and runtime limits"],
+       ["retrieval", "Memory & knowledge", "remember, learn, retrieve and rerank"],
        ["guardrails", "Guardrails", "input/output checks, strictness, safe replies"],
        ["grounding", "Grounding", "evidence behind product claims"],
        ["funnel", "Outcome funnel", "stage vocabulary"],
@@ -17,10 +18,13 @@
      ]
      active = config_groups.find { |k, _| k == @config_group } || config_groups.first
      @config_group = active[0] %>
-  <div class="section-head"><h2>Configuration</h2><p class="muted">every profile field, editable hot — pick a group to the left — saved via <code>update_agent</code>.</p></div>
+  <%# The group nav is its own master column (like Prompts' file list) — not a
+      "Configuration" card wrapping a duplicate "Configuration" card. Its own
+      drill-pane-head carries the title; the detail pane's head carries the
+      active group's name + description, same as every other drill-detail. %>
   <div class="drill config-drill">
     <aside class="drill-pane drill-master">
-      <div class="drill-pane-head"><div class="title"><strong>Configuration</strong></div></div>
+      <div class="drill-pane-head"><div class="title"><strong>Configuration <span class="count"><%= config_groups.size %></span></strong></div></div>
       <nav class="drill-pane-body drill-list" aria-label="config groups">
         <% config_groups.each do |key, label, sub| %>
           <a class="drill-item<%== ' active' if @config_group == key %>"
@@ -34,21 +38,41 @@
     </aside>
     <section class="drill-pane drill-detail">
       <div class="drill-pane-head">
-        <div class="title"><strong><%= active[1] %></strong></div>
+        <div class="title"><strong><%= active[1] %></strong><span class="count"><%= active[2] %></span></div>
         <button type="submit" form="config-form" class="btn primary" data-turbo-submits-with="Saving…">Save config</button>
       </div>
       <div class="drill-pane-body">
-        <form id="config-form" method="post" action="/studio/agents/<%= Rack::Utils.escape(@agent.id) %>/config">
+        <form id="config-form" method="post" action="/studio/agents/<%= Rack::Utils.escape(@agent.id) %>/config" data-controller="dirty-guard">
           <%== csrf_tag %>
           <input type="hidden" name="cfg" value="<%= @config_group %>">
+          <p class="muted">Save config applies changes to <strong><%= @agent.id %></strong>. Changes take effect on future turns.</p>
           <div class="config-group" data-config-group="model"<%== " hidden" unless @config_group == "model" %>>
-    <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">
+    <fieldset class="subgroup">
+      <legend>Model</legend>
+      <label>model <span class="muted">(blank = platform <code>default_model</code>; the list is Settings › LLM providers)</span>
+        <%== model_select("model_ref", model_ref_of(@agent.model, @agent.provider), "inherit platform default") %>
       </label>
+    </fieldset>
+
+    <fieldset class="subgroup">
+      <legend>Response generation <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>
+
+    <details class="newfile">
+      <summary>Runtime limits &amp; allowed models</summary>
+      <p class="muted">Control turn duration, tool concurrency and usage. Blank limits inherit platform defaults where indicated.</p>
+      <div class="grid-2">
       <label>turn_timeout (s)
         <input type="text" name="turn_timeout" value="<%= @agent.limits[:turn_timeout] %>" inputmode="numeric">
       </label>
@@ -64,6 +88,16 @@
       <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>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>
+    </details>
+
+    <details class="newfile">
+      <summary>Messages received while busy</summary>
+      <p class="muted">Choose whether new messages wait, combine, steer or interrupt a running turn.</p>
+      <div class="grid-2">
       <label>queue_mode <span class="muted">(burst policy: followup | collect | steer | interrupt; blank = platform/default followup)</span>
         <select name="queue_mode">
           <option value=""<%== " selected" if @agent.limits[:queue_mode].nil? %>>— inherit</option>
@@ -75,99 +109,35 @@
       <label>steer_max_messages <span class="muted">(messages ONE running turn may absorb; blank = default 5, 0 = never steer)</span>
         <input type="text" name="steer_max_messages" value="<%= @agent.limits[:steer_max_messages] %>" inputmode="numeric" placeholder="5">
       </label>
-    </div>
-    <label class="check">
-      <input type="checkbox" name="memory" value="1"<%== " checked" if @agent.memory %>>
-      cross-session memory (the agent 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>
+      <label>debounce_ms <span class="muted">(extra quiet window at the door; blank/0 = none — collect/steer still merge into a turn that is queued behind another)</span>
+        <input type="text" name="debounce_ms" value="<%= @agent.limits[:debounce_ms] %>" inputmode="numeric" placeholder="0">
+      </label>
+      <label>debounce_max_ms <span class="muted">(ceiling on the TOTAL wait; blank = default 10000)</span>
+        <input type="text" name="debounce_max_ms" value="<%= @agent.limits[:debounce_max_ms] %>" inputmode="numeric" placeholder="10000">
+      </label>
+      <label>steer_join <span class="muted">(template framing a mid-run message; must carry <%= Insika::QueuePolicy::JOIN_PLACEHOLDER %>; blank = the raw text)</span>
+        <input type="text" name="steer_join" value="<%= @agent.limits[:steer_join] %>" placeholder="the customer just added: <%= Insika::QueuePolicy::JOIN_PLACEHOLDER %>">
+      </label>
       </div>
-    </fieldset>
+    </details>
 
-    <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>
+          </div>
+
+          <div class="config-group" data-config-group="retrieval"<%== " hidden" unless @config_group == "retrieval" %>>
+            <%== render("_agent_config_retrieval") %>
           </div>
 
           <div class="config-group" data-config-group="guardrails"<%== " hidden" unless @config_group == "guardrails" %>>
-    <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>
+            <%== render("_cfg_guardrails") %>
           </div>
 
           <div class="config-group" data-config-group="grounding"<%== " hidden" unless @config_group == "grounding" %>>
-    <fieldset class="subgroup">
-      <legend>grounding <span class="muted">— product claims must point at evidence the session actually saw</span></legend>
-      <% gr = @agent.grounding || {} %>
-      <div class="grid-2">
-        <label>mode <span class="muted">(blank = off)</span>
-          <select name="grounding_mode">
-            <option value="">off</option>
-            <% %w[flag enforce].each do |m| %>
-              <option value="<%= m %>"<%== ' selected' if gr["mode"] == m %>><%= m %></option>
-            <% end %>
-          </select>
-        </label>
-        <label>matcher SKU <span class="muted">(evidence id prefix, e.g. <code>sku:</code>)</span>
-          <input type="text" name="grounding_matcher_sku" value="<%= gr.dig("matcher", "sku") %>" placeholder="sku:">
-        </label>
-        <label>name keys <span class="muted">(comma-separated metadata keys with product names)</span>
-          <input type="text" name="grounding_name_keys" value="<%= agent_list(gr.dig("matcher", "name_keys")) %>" placeholder="product, name">
-        </label>
-      </div>
-    </fieldset>
+            <%== render("_cfg_grounding") %>
           </div>
 
           <div class="config-group" data-config-group="funnel"<%== " hidden" unless @config_group == "funnel" %>>
     <fieldset class="subgroup">
-      <legend>outcome funnel <span class="muted">— the stage vocabulary the engine folds WS7 outcomes into</span></legend>
+      <legend>outcome funnel <span class="muted">— the stages used to track recorded outcomes</span></legend>
       <% fun = @agent.funnel || {} %>
       <div class="grid-2">
         <label>stages <span class="muted">(one per line, in order; blank = no funnel)</span>
@@ -190,35 +160,7 @@
           </div>
 
           <div class="config-group" data-config-group="followups"<%== " hidden" unless @config_group == "followups" %>>
-<fieldset class="subgroup">
-  <legend>follow-ups <span class="muted">— the seller who comes back (blank arm = off)</span></legend>
-  <% fu = @agent.followup || {}; fup = fu["policy"] || {}; fqh = fup["quiet_hours"] || {} %>
-  <div class="grid-2">
-    <label>arm
-      <input type="text" name="followup_arm" value="<%= fu["arm"] %>" placeholder="schedule">
-    </label>
-    <label>max frequency <span class="muted">(e.g. <code>2/24h</code>)</span>
-      <input type="text" name="followup_max_frequency" value="<%= fup["max_frequency"] %>" placeholder="2/24h">
-    </label>
-    <label>quiet hours timezone <span class="muted">(blank = no quiet hours)</span>
-      <input type="text" name="followup_tz" value="<%= fqh["timezone"] %>" placeholder="America/Sao_Paulo">
-    </label>
-    <div class="grid-2">
-      <label>quiet start
-        <input type="text" name="followup_quiet_start" value="<%= fqh["start"] %>" placeholder="21:30">
-      </label>
-      <label>quiet end
-        <input type="text" name="followup_quiet_end" value="<%= fqh["end"] %>" placeholder="09:00">
-      </label>
-    </div>
-    <label>cancel keywords <span class="muted">(comma-separated)</span>
-      <input type="text" name="followup_cancel_keywords" value="<%= agent_list(fup["cancel_keywords"]) %>" placeholder="não quero mais contato">
-    </label>
-    <label>silence after N sends
-      <input type="text" name="followup_silence_after_sends" value="<%= fup["silence_after_sends"] %>" placeholder="3" inputmode="numeric">
-    </label>
-  </div>
-</fieldset>
+            <%== render("_cfg_followup") %>
           </div>
 
           <div class="config-group" data-config-group="schedules"<%== " hidden" unless @config_group == "schedules" %>>
@@ -251,68 +193,11 @@
           </div>
 
           <div class="config-group" data-config-group="distill"<%== " hidden" unless @config_group == "distill" %>>
-<fieldset class="subgroup">
-  <legend>distillation <span class="muted">— finished conversations → proposed customer facts (Facts page)</span></legend>
-  <% dist = @agent.distill || {} %>
-  <label class="check">
-    <input type="checkbox" name="distill_enabled" value="1"<%== " checked" if Insika::Coercion.truthy?(dist["enabled"]) %>>
-    distillation on — idle sessions are read back as fact proposals; a human always approves
-  </label>
-  <div class="grid-3">
-    <label>idle hours <span class="muted">(blank = 6)</span>
-      <input type="text" name="distill_idle_hours" value="<%= dist["idle_hours"] %>" placeholder="6" inputmode="numeric">
-    </label>
-    <label>min messages <span class="muted">(blank = 3)</span>
-      <input type="text" name="distill_min_messages" value="<%= dist["min_messages"] %>" placeholder="3" inputmode="numeric">
-    </label>
-    <label>max proposals <span class="muted">(blank = 10)</span>
-      <input type="text" name="distill_max_proposals" value="<%= dist["max_proposals"] %>" placeholder="10" inputmode="numeric">
-    </label>
-  </div>
-  <label>model <span class="muted">(blank = the platform utility_model)</span>
-    <input type="text" name="distill_model" value="<%= dist["model"] %>" placeholder="deepseek-v4-flash">
-  </label>
-  <label>prompt <span class="muted">— what counts as a fact for THIS store (blank = the engine default)</span>
-    <textarea name="distill_prompt" rows="3" placeholder="what counts as a customer fact for this store"><%= dist["prompt"] %></textarea>
-  </label>
-</fieldset>
+            <%== render("_cfg_distill") %>
           </div>
 
           <div class="config-group" data-config-group="harvest"<%== " hidden" unless @config_group == "harvest" %>>
-<fieldset class="subgroup">
-  <legend>harvest <span class="muted">— finished traffic → proposed SKILLs, double-gated, human-promoted (Harvest page)</span></legend>
-  <% hv = @agent.harvest || {}; hvm = hv["miner"] || {} %>
-  <label class="check">
-    <input type="checkbox" name="harvest_enabled" value="1"<%== " checked" if Insika::Coercion.truthy?(hv["enabled"]) %>>
-    harvest on — idle conversations are mined for skills; a human promotes every one
-  </label>
-  <div class="grid-3">
-    <label>idle hours <span class="muted">(blank = 24)</span>
-      <input type="text" name="harvest_idle_hours" value="<%= hv["idle_hours"] %>" placeholder="24" inputmode="numeric">
-    </label>
-    <label>min messages <span class="muted">(blank = 3)</span>
-      <input type="text" name="harvest_min_messages" value="<%= hv["min_messages"] %>" placeholder="3" inputmode="numeric">
-    </label>
-    <label>miner model <span class="muted">(blank = the platform utility_model)</span>
-      <input type="text" name="harvest_miner_model" value="<%= hvm["model"] %>" placeholder="deepseek-v4-flash">
-    </label>
-    <label>miner window <span class="muted">(last N conversations)</span>
-      <input type="text" name="harvest_miner_window" value="<%= hvm.dig("window", "last_sessions") %>" placeholder="200" inputmode="numeric">
-    </label>
-    <label>miner max proposals
-      <input type="text" name="harvest_miner_max_proposals" value="<%= hvm["max_proposals"] %>" placeholder="10" inputmode="numeric">
-    </label>
-    <label>miner budget (tokens)
-      <input type="text" name="harvest_miner_budget_tokens" value="<%= hvm.dig("budget", "tokens") %>" placeholder="20000" inputmode="numeric">
-    </label>
-  </div>
-  <label>negative list <span class="muted">— JSON: <code>[{ "rule": "…", "pattern": "…" }]</code> (blank = the deployment seed)</span>
-    <textarea name="harvest_negative_list" rows="3" spellcheck="false" class="mono" placeholder='[ { "rule": "no-competitor-prices", "pattern": "concorrente" } ]'><%= agent_json(hv["negative_list"]) %></textarea>
-  </label>
-  <label>prompt <span class="muted">— what a harvestable skill is for THIS store (blank = the engine default)</span>
-    <textarea name="harvest_prompt" rows="3" placeholder="what makes a skill harvestable for this store"><%= hv["prompt"] %></textarea>
-  </label>
-</fieldset>
+            <%== render("_cfg_harvest") %>
           </div>
 
           <div class="config-group" data-config-group="refinement"<%== " hidden" unless @config_group == "refinement" %>>
@@ -340,9 +225,9 @@
         <label>files <span class="muted">(allowlist, comma-separated)</span>
           <input type="text" name="refinement_files" value="<%= agent_list(rf["files"]) %>" placeholder="IDENTITY.md">
         </label>
-        <label>proposers <span class="muted">(model refs, comma-separated)</span>
-          <input type="text" name="refinement_proposers" value="<%= agent_list(rf["proposers"]) %>" placeholder="deepseek/deepseek-v4-flash">
-        </label>
+        <div>proposers <span class="muted">(model refs)</span>
+          <%== model_slots("refinement_proposers_refs", rf["proposers"], min: 2) %>
+        </div>
       </div>
       <label>budget (tokens)
         <input type="text" name="refinement_budget_tokens" value="<%= rfb["tokens"] %>" inputmode="numeric">
@@ -351,79 +236,27 @@
           </div>
 
           <div class="config-group" data-config-group="budget_rel"<%== " hidden" unless @config_group == "budget_rel" %>>
-      <fieldset class="subgroup">
-        <legend>budget <span class="muted">— WS2: calendar spend caps per (tenant, agent)</span></legend>
-        <% bd = @agent.budget || {} %>
-        <div class="grid-3">
-          <label>daily (tokens)
-            <input type="text" name="budget_daily" value="<%= bd["daily"] %>" inputmode="numeric">
-          </label>
-          <label>monthly (tokens)
-            <input type="text" name="budget_monthly" value="<%= bd["monthly"] %>" inputmode="numeric">
-          </label>
-          <label>alert at <span class="muted">(0–1 of the cap)</span>
-            <input type="text" name="budget_alert_at" value="<%= bd["alert_at"] %>" placeholder="0.8" inputmode="decimal">
-          </label>
-        </div>
-        <label class="check">
-          <input type="checkbox" name="budget_soft" value="1"<%== " checked" if bd["soft"] %>>
-          soft cap <span class="muted">— crossing it warns and runs; hard (default) fails the turn</span>
-        </label>
-      </fieldset>
-
-      <fieldset class="subgroup">
-        <legend>reliability <span class="muted">— WS3: retries, fallback chain, circuit breaker</span></legend>
-        <% rel = @agent.reliability || {}; brk = rel["circuit_breaker"] || {} %>
-        <div class="grid-3">
-          <label>retries
-            <input type="text" name="reliability_retries" value="<%= rel["retries"] %>" inputmode="numeric">
-          </label>
-          <label>backoff
-            <select name="reliability_backoff">
-              <option value="">none</option>
-              <% %w[constant exponential].each do |m| %>
-                <option value="<%= m %>"<%== ' selected' if rel["backoff"] == m %>><%= m %></option>
-              <% end %>
-            </select>
-          </label>
-          <label>timeout (s)
-            <input type="text" name="reliability_timeout" value="<%= rel["timeout"] %>" placeholder="30" inputmode="numeric">
-          </label>
-          <label>breaker after <span class="muted">(failures)</span>
-            <input type="text" name="reliability_breaker_after" value="<%= brk["after"] %>" inputmode="numeric">
-          </label>
-          <label>breaker within (s)
-            <input type="text" name="reliability_breaker_within" value="<%= brk["within"] %>" inputmode="numeric">
-          </label>
-          <label>breaker cooldown (s)
-            <input type="text" name="reliability_breaker_cooldown" value="<%= brk["cooldown"] %>" inputmode="numeric">
-          </label>
-        </div>
-        <label>fallback models <span class="muted">(comma-separated refs, tried after retries)</span>
-          <input type="text" name="reliability_fallback" value="<%= agent_list(rel["fallback"]) %>" placeholder="openai/gpt-4o-mini">
-        </label>
-      </fieldset>
+            <%== render("_cfg_budget") %>
+            <%== render("_cfg_reliability") %>
           </div>
 
           <div class="config-group" data-config-group="routing"<%== " hidden" unless @config_group == "routing" %>>
       <fieldset class="subgroup">
         <legend>routing, media, alerts &amp; the edge</legend>
-        <label>routes <span class="muted">— WS4 JSON: intent → description / delegate / stuck (blank = no routing)</span>
+        <label>routes <span class="muted">— JSON: intent → description / delegate / stuck (blank = no routing)</span>
           <textarea name="routes" rows="4" spellcheck="false" class="mono" placeholder='{ "shopping": "the customer wants to browse", "default": "shopping" }'><%= agent_json(@agent.routes) %></textarea>
         </label>
-        <label>outputs <span class="muted">— WS9 JSON: generated media the agent may produce (blank = none)</span>
+        <label>outputs <span class="muted">— JSON: generated media the agent may produce (blank = none)</span>
           <textarea name="outputs" rows="3" spellcheck="false" class="mono" placeholder='{ "image": { "model": "gpt-image-1" } }'><%= agent_json(@agent.outputs) %></textarea>
         </label>
         <label>STT vocabulary prompt <span class="muted">— domain words (products, brands) expected in this agent's voice notes (blank = deployment default)</span>
-          <input type="text" name="stt_prompt" value="<%= @agent.stt_prompt %>" placeholder="Ocean Drop, tênis, boné trucker, chinelo">
+          <input type="text" name="stt_prompt" value="<%= @agent.stt_prompt %>" placeholder="Acme Surf, tênis, boné trucker, chinelo">
         </label>
         <div class="grid-2">
-          <label>alerts webhook <span class="muted">(budget_warning / breaker_open / delivery_failed)</span>
-            <input type="text" name="alerts_webhook" value="<%= @agent.alerts && @agent.alerts["webhook"] %>" placeholder="https://ops.example.com/insika-alerts">
-          </label>
+          <%== render("_cfg_alerts") %>
           <label class="check">
             <input type="checkbox" name="stuck_signal" value="1"<%== " checked" if @agent.stuck_signal %>>
-            stuck signal <span class="muted">— the model may end a turn <code>stuck</code> (WS5)</span>
+            stuck signal <span class="muted">— the model may end a turn <code>stuck</code></span>
           </label>
         </div>
         <div class="grid-2">
@@ -471,6 +304,9 @@
           <label>approvals required <span class="muted">(tools whose call suspends for a human)</span>
             <input type="text" name="approvals_required" value="<%= agent_list(@agent.approvals_required) %>" placeholder="send_discount_coupon">
           </label>
+          <label>customer confirm <span class="muted">(tools held until the customer says yes on the next message)</span>
+            <input type="text" name="customer_confirm" value="<%= agent_list(@agent.customer_confirm) %>" placeholder="create_order">
+          </label>
           <label>policies <span class="muted">(registry names)</span>
             <input type="text" name="policies" value="<%= agent_list(@agent.policies) %>" placeholder="tool_allowlist, skill_allowlist">
           </label>

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

@@ -1,8 +1,63 @@
 <!-- ── History ───────────────────────────────────────────────────────────── -->
 <section class="section" id="history" data-tabs-target="panel">
+  <div class="section-head">
+    <h2>What changed, and what it did</h2>
+    <p class="muted"><%= @change_primary ? "Primary outcome · #{@change_primary}" : "All outcomes" %> per day, last <%= @change_days.size %> days. A dashed line marks each change to a prompt file or to one of this agent's skills.</p>
+  </div>
+  <div class="card">
+    <% max = [@change_days.values.max || 0, 1].max; span = @change_days.size * 86_400.0 %>
+    <svg class="barchart" viewBox="0 0 700 176" preserveAspectRatio="none" role="img" aria-label="outcomes per day, last <%= @change_days.size %> days, with prompt-file changes">
+      <% slot = 700.0 / @change_days.size; bw = slot * 0.58 %>
+      <% @change_days.each_with_index do |(d, c), i| %>
+        <% h = (c.to_f / max) * 150.0; x = (i * slot) + ((slot - bw) / 2.0) %>
+        <rect class="bar<%== ' bar-empty' if c.zero? %>" x="<%= format('%.1f', x) %>" y="<%= format('%.1f', c.zero? ? 157.0 : 160.0 - h) %>"
+              width="<%= format('%.1f', bw) %>" height="<%= format('%.1f', c.zero? ? 3.0 : [h, 3.0].max) %>" rx="2">
+          <title><%= d.strftime('%b %-d') %> · <%= c %> outcome<%= 's' unless c == 1 %></title>
+        </rect>
+      <% end %>
+      <% @changes.each do |ch| %>
+        <% x = format('%.1f', (ch[:at] - @change_start) / span * 700.0) %>
+        <line class="change-mark" x1="<%= x %>" y1="0" x2="<%= x %>" y2="160" vector-effect="non-scaling-stroke"><title><%= ch[:kind] == :skill ? "skill " : "" %><%= ch[:file] %> · <%= ch[:at].strftime('%b %-d %H:%M UTC') %></title></line>
+      <% end %>
+      <line class="barchart-axis-line" x1="0" y1="160" x2="700" y2="160" />
+    </svg>
+    <div class="barchart-axis"><span><%= @change_days.keys.first.strftime('%b %-d') %></span><span>today</span></div>
+  </div>
+  <% if @changes.empty? %>
+    <div class="empty">No prompt or skill changes in the last <%= @change_days.size %> days.</div>
+  <% end %>
+  <% @changes.each do |ch| %>
+    <div class="card">
+      <div class="drill-section-head">
+        <h3><% if ch[:kind] == :skill %><span class="muted">skill</span> <% end %><%= ch[:file] %></h3>
+        <span class="muted mono"><%= ch[:at].strftime('%Y-%m-%d %H:%M UTC') %></span>
+      </div>
+      <% unless ch[:removed].empty? && ch[:added].empty? %>
+        <pre class="diff"><% ch[:removed].first(6).each do |l| %><span class="del">- <%= l %></span><% end %><% ch[:added].first(6).each do |l| %><span class="ins">+ <%= l %></span><% end %></pre>
+      <% end %>
+      <p>
+        <% if ch[:before] && ch[:after] %>
+          Outcomes: <strong class="tnum"><%= ch[:after] %></strong> in the 7 days after vs <strong class="tnum"><%= ch[:before] %></strong> in the 7 days before.
+        <% else %>
+          <span class="muted">Outcomes 7 days after vs 7 days before: not enough data.</span>
+        <% end %>
+      </p>
+      <% if ch[:kind] == :skill %>
+        <a href="/studio/agents/<%= Rack::Utils.escape(@agent.id) %>/skills/<%= Rack::Utils.escape(ch[:file]) %>" data-turbo-frame="_top">Open the skill</a>
+      <% else %>
+        <form method="post" action="/studio/agents/<%= Rack::Utils.escape(@agent.id) %>/prompts/restore">
+          <%== csrf_tag %>
+          <input type="hidden" name="file" value="<%= ch[:file] %>">
+          <input type="hidden" name="version" value="<%= ch[:version] %>">
+          <button type="submit" class="ghost">Restore the version before</button>
+        </form>
+      <% end %>
+    </div>
+  <% end %>
+
   <div class="section-head">
     <h2>History</h2>
-    <p class="muted">recent conversations (all agents — a session doesn't stamp its author).</p>
+    <p class="muted">This agent's most recent conversations. Every conversation is in <a href="/studio/chats?agent=<%= Rack::Utils.escape(@agent.id) %>" data-turbo-frame="_top">Chats</a>.</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) %>" data-turbo-frame="_top">playground</a>.</div>

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

@@ -0,0 +1,34 @@
+<!-- ── Performance ───────────────────────────────────────────────────────── -->
+<% periods = { "24h" => "24h", "7d" => "7 days", "30d" => "30 days" } %>
+<% q = Rack::Utils.escape(@agent.id) %>
+<section class="section" id="performance" data-tabs-target="panel">
+  <div class="section-head">
+    <h2>Performance</h2>
+    <p class="muted">The same numbers as the <a href="/studio/home?agent=<%= q %>" data-turbo-frame="_top">home</a> and <a href="/studio/models?agent=<%= q %>" data-turbo-frame="_top">Models</a>, for this agent. Latency is the whole turn; first balloon is what a channel customer waits.</p>
+  </div>
+  <div class="card">
+    <table class="grid">
+      <thead><tr><th></th><% periods.each_value do |label| %><th class="num"><%= label %></th><% end %></tr></thead>
+      <tbody>
+        <% pct = ->(ms) { ms.nil? ? "—" : format("%.1fs", ms / 1000.0) } %>
+        <% rows = [
+             ["Conversations", ->(p) { @perf_activity[p][:conversations] }],
+             ["Messages", ->(p) { @perf_activity[p][:messages] }],
+             ["Outcomes", ->(p) { @perf_activity[p][:outcomes] }],
+             ["Cost", ->(p) { usd(@perf.dig(p, "totals", "cost")) }],
+             ["Model requests", ->(p) { @perf.dig(p, "totals", "requests") || 0 }],
+             ["Tokens in / out", ->(p) { t = @perf.dig(p, "totals") || {}; "#{t['input_tokens'] || 0} / #{t['output_tokens'] || 0}" }],
+             ["Turns", ->(p) { @perf.dig(p, "turns", "count") || 0 }],
+             ["Failed turns", ->(p) { t = @perf.dig(p, "turns"); t && t["count"].positive? ? format("%d (%.1f%%)", t["failures"], t["failures"] * 100.0 / t["count"]) : "—" }],
+             ["ttft p50 / p95", ->(p) { w = @perf.dig(p, "turns", "windows", "ttft_ms") || {}; "#{pct.(w['p50'])} / #{pct.(w['p95'])}" }],
+             ["Turn p50 / p95", ->(p) { w = @perf.dig(p, "turns", "windows", "total_ms") || {}; "#{pct.(w['p50'])} / #{pct.(w['p95'])}" }],
+             ["First balloon p95", ->(p) { pct.(@perf.dig(p, "turns", "windows", "first_balloon_ms", "p95")) }],
+             ["Tool calls ok", ->(p) { tools = Array(@perf.dig(p, "turns", "tools")); calls = tools.sum { |t| t["calls"] }; calls.zero? ? "—" : format("%.1f%% of %d", (calls - tools.sum { |t| t["failures"] }) * 100.0 / calls, calls) }]
+           ] %>
+        <% rows.each do |label, value| %>
+          <tr><td><%= label %></td><% periods.each_key do |p| %><td class="num"><%= value.(p) %></td><% end %></tr>
+        <% end %>
+      </tbody>
+    </table>
+  </div>
+</section>

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

@@ -2,7 +2,7 @@
 <section class="section" id="prompts" data-tabs-target="panel">
   <div class="section-head">
     <h2>Prompts <span class="pill info plain"><%= @prompt_files.size %></span></h2>
-    <p class="muted">the agent's own identity (store-backed, versioned). Empty = uses the deployment default.</p>
+    <p class="muted">Define this agent’s identity and voice. Save each prompt separately; no files means the deployment default is used.</p>
   </div>
 
   <div class="drill" data-controller="list-filter">
@@ -60,19 +60,17 @@
             <% else %>
               <input type="hidden" name="file" value="<%= @prompt_selected %>">
             <% end %>
-            <label>content <span class="muted">(markdown — the agent's identity/voice)</span></label>
+            <label for="prompt-content">content <span class="muted">(markdown — the agent's identity/voice)</span></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="18"><%= new ? "" : (pf ? pf[:content] : "") %></textarea>
+              <textarea id="prompt-content" name="content" data-code-editor-target="source" rows="18"><%= new ? "" : (pf ? pf[:content] : "") %></textarea>
             </div>
           </form>
 
           <% if !new && pf %>
             <% unless pf[:versions].empty? %>
-              <div class="drill-section">
-                <div class="drill-section-head">
-                  <h3>Versions</h3>
-                  <span class="muted">store-backed history — restore replaces the current content.</span>
-                </div>
+              <details class="drill-section newfile">
+                <summary>Previous versions <span class="count"><%= pf[:versions].size %></span></summary>
+                <p class="muted">Restore replaces the current content.</p>
                 <ul class="versions-list">
                   <% pf[:versions].each_with_index do |v, i| %>
                     <li>
@@ -86,7 +84,7 @@
                     </li>
                   <% end %>
                 </ul>
-              </div>
+              </details>
             <% end %>
 
             <div class="drill-section">