completion-kit 0.5.9 → 0.5.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2e1641413d1ed8d27bb6344094b788f33ab521e4d738bf1468fba148185a58f6
-  data.tar.gz: 60b3676c0b8100430a7841a6281b5656184198583b40565c0ef5f7b24663ebc4
+  metadata.gz: 64a36635f11bc5109afed180697b763a1c8231347b4912aa452271fd19694a45
+  data.tar.gz: 366ef22faa5914db74402b7ae1c9769f50f14ae8204e2144a245b8d29f89b464
 SHA512:
-  metadata.gz: 003f3af4e5eaa28bc5c9b800e3788a63134a8bc9750d170ed03c6c1707b2e57675c79e25994abd763fb133eaec484f07133e12a74be9179f90c360b1d290dafd
-  data.tar.gz: 6b73b15e6c1eb9af3d8f5228997553a7489db9c948a2e7298d2c9b40eb19b27a431af84b52368716bac0705f4c62acc2b5b7a8f937192445416b131c59b661f9
+  metadata.gz: f84d7a7e0bcd5a3a054e84231cb390026dd07ac469b34ff8bb8a10a6f9f77fbbcb53748b4814d7b86aa94d1e67f41f3ad1e9c8eb1907f0ac56388169765174d6
+  data.tar.gz: ab627c627f3c88d1ef4a8f14afa0d72d7a92acc83b1107a4ebfeb25dacaf7a04282dfe3cfa5657d3c474171e508dec9944db95da526cbe8b3d94bbd0a9ef32a7

data/app/assets/stylesheets/completion_kit/application.css

@@ -126,13 +126,21 @@ form.button_to {
   font-weight: 700;
   letter-spacing: 0.02em;
   text-decoration: none;
-  color: var(--ck-accent);
+  color: #3AD0E6;
 }
 
 .ck-brand img {
   display: block;
 }
 
+.ck-brand__name {
+  padding-top: 0.75rem;
+}
+
+.ck-brand__kit {
+  color: #AFEDF7;
+}
+
 .ck-topbar__copy {
   display: none;
 }
@@ -262,7 +270,7 @@ form.button_to {
 .ck-meta-copy,
 .ck-note,
 .ck-hint {
-  font-size: 0.95rem;
+  font-size: 0.9rem;
   line-height: 1.6;
 }
 
@@ -1269,6 +1277,13 @@ tr:hover .ck-chip--publish {
   color: var(--ck-accent);
 }
 
+/* the main prompt template block on prompts/show — bigger padding + a
+   touch more line-height since this is the page's primary content */
+.ck-code--prompt {
+  padding: 1.5rem;
+  line-height: 1.75;
+}
+
 .ck-note-box {
   background: var(--ck-surface-soft);
   border: 1px solid var(--ck-line);
@@ -1855,7 +1870,18 @@ tr:hover .ck-chip--publish {
   background: var(--ck-bg-strong);
   overflow: auto;
   max-height: 60vh;
+  scrollbar-width: thin;
+  scrollbar-color: var(--ck-line-strong) transparent;
 }
+.ck-csv-table-wrap::-webkit-scrollbar { width: 10px; height: 10px; }
+.ck-csv-table-wrap::-webkit-scrollbar-track { background: transparent; }
+.ck-csv-table-wrap::-webkit-scrollbar-thumb {
+  background: var(--ck-line-strong);
+  border-radius: 5px;
+  border: 2px solid var(--ck-bg-strong);
+}
+.ck-csv-table-wrap::-webkit-scrollbar-thumb:hover { background: var(--ck-muted); }
+.ck-csv-table-wrap::-webkit-scrollbar-corner { background: transparent; }
 
 .ck-modal__body .ck-csv-table-wrap {
   margin-top: 0;
@@ -2763,8 +2789,10 @@ select.ck-input {
 
 /* the metrics field stacks several sub-sections (hint, groups, divider, tag
    filter, checkboxes) — give it more vertical breathing room than a plain field,
-   and extra separation from the run-tags field that follows it */
-#metrics-field {
+   and extra separation from the run-tags field that follows it. Only when the
+   checkboxes are actually present, though — when there are no metrics the field
+   is just "label + warning" and should be a normal compact field. */
+#metrics-field:has(.ck-metric-checkboxes) {
   gap: 0.85rem;
   margin-bottom: 1.25rem;
 }
@@ -3571,7 +3599,7 @@ a.ck-metric-group-pill {
 }
 
 .ck-mcp-tool__desc {
-  font-size: 0.8rem;
+  font-size: 0.9rem;
   color: var(--ck-muted);
 }
 
@@ -3595,7 +3623,7 @@ a.ck-metric-group-pill {
   gap: 0.5rem;
   padding: 0.6rem 0.85rem;
   font-family: var(--ck-mono);
-  font-size: 0.78rem;
+  font-size: 0.9rem;
   font-weight: 500;
   color: var(--ck-text);
   border-bottom: 1px solid var(--ck-line);
@@ -3669,7 +3697,7 @@ a.ck-metric-group-pill {
 }
 
 .ck-api-prompt-card__desc {
-  font-size: 0.78rem;
+  font-size: 0.9rem;
   color: var(--ck-muted);
   margin: 0.2rem 0 0;
   line-height: 1.4;

data/app/controllers/completion_kit/api_reference_controller.rb

@@ -2,6 +2,12 @@ module CompletionKit
   class ApiReferenceController < ApplicationController
     def index
       @published_prompts = Prompt.current_versions.order(name: :asc)
+      @recent_runs = Run.includes(:prompt).order(created_at: :desc).limit(10)
+      @datasets = Dataset.order(name: :asc)
+      @metrics = Metric.order(name: :asc)
+      @metric_groups = MetricGroup.includes(:metrics).order(name: :asc)
+      @tags = Tag.order(name: :asc)
+      @provider_credentials = ProviderCredential.order(:provider)
       @token = CompletionKit.config.api_token
       @base_url = request.base_url + request.script_name
     end

data/app/controllers/completion_kit/datasets_controller.rb

@@ -9,6 +9,16 @@ module CompletionKit
 
     def show
       @runs = @dataset.runs.includes(:prompt, :responses).order(created_at: :desc)
+      respond_to do |format|
+        format.html
+        format.csv do
+          slug = @dataset.name.to_s.parameterize.presence || "dataset-#{@dataset.id}"
+          send_data @dataset.csv_data.to_s,
+                    type: "text/csv",
+                    filename: "#{slug}.csv",
+                    disposition: "attachment"
+        end
+      end
     end
 
     def new

data/app/controllers/completion_kit/mcp_controller.rb

@@ -17,7 +17,7 @@ module CompletionKit
       end
 
       session_id = request.headers["Mcp-Session-Id"]
-      unless session_id && Rails.cache.exist?("mcp_session:#{session_id}")
+      unless McpSession.active?(session_id)
         render json: jsonrpc_error(request_body["id"], -32000, "Session not initialized. Send initialize first."), status: :bad_request
         return
       end
@@ -40,7 +40,7 @@ module CompletionKit
 
     def destroy
       session_id = request.headers["Mcp-Session-Id"]
-      Rails.cache.delete("mcp_session:#{session_id}") if session_id
+      McpSession.destroy_session(session_id) if session_id
       head :ok
     end
 

data/app/models/completion_kit/mcp_session.rb

@@ -0,0 +1,29 @@
+module CompletionKit
+  # MCP session marker — one row per active client session, kept in the
+  # database so sessions survive Puma restarts, deploys, and Rails.cache
+  # eviction. Expired rows are opportunistically pruned on every new
+  # session start, so the table stays bounded by recent activity.
+  class McpSession < ApplicationRecord
+    self.table_name = "completion_kit_mcp_sessions"
+
+    SESSION_TTL = 1.hour
+
+    def self.start!
+      prune_expired!
+      create!(session_id: SecureRandom.uuid, expires_at: SESSION_TTL.from_now).session_id
+    end
+
+    def self.active?(session_id)
+      return false if session_id.blank?
+      where(session_id: session_id).where("expires_at > ?", Time.current).exists?
+    end
+
+    def self.destroy_session(session_id)
+      where(session_id: session_id).delete_all
+    end
+
+    def self.prune_expired!
+      where("expires_at < ?", Time.current).delete_all
+    end
+  end
+end

data/app/services/completion_kit/mcp_dispatcher.rb

@@ -6,10 +6,8 @@ module CompletionKit
     PROTOCOL_VERSION = "2025-03-26"
 
     def self.initialize_session
-      session_id = SecureRandom.uuid
-      Rails.cache.write("mcp_session:#{session_id}", true, expires_in: 1.hour)
       {
-        session_id: session_id,
+        session_id: McpSession.start!,
         protocolVersion: PROTOCOL_VERSION,
         serverInfo: {name: "CompletionKit", version: CompletionKit::VERSION},
         capabilities: {tools: {listChanged: false}}

data/app/views/completion_kit/api_reference/_body.html.erb

@@ -2,6 +2,12 @@
   token = local_assigns.fetch(:token, "YOUR_TOKEN")
   real_token = local_assigns.fetch(:real_token, nil)
   published_prompts = local_assigns.fetch(:published_prompts, [])
+  recent_runs = local_assigns.fetch(:recent_runs, [])
+  datasets = local_assigns.fetch(:datasets, [])
+  metrics = local_assigns.fetch(:metrics, [])
+  metric_groups = local_assigns.fetch(:metric_groups, [])
+  tags = local_assigns.fetch(:tags, [])
+  provider_credentials = local_assigns.fetch(:provider_credentials, [])
 %>
 <div class="ck-api-tabs">
   <input type="radio" name="ck-api-tab" id="ck-tab-mcp" class="ck-api-tabs__radio" checked>
@@ -86,28 +92,11 @@
         <p class="ck-api-method"><span class="ck-chip ck-chip--soft">GET</span> /api/v1/prompts/:id</p>
         <p class="ck-meta-copy">Get a single prompt by ID.</p>
       </div>
-      <% if published_prompts.any? %>
-        <div class="ck-api-endpoint" style="padding-top: 1rem;">
-          <p class="ck-kicker" style="margin-bottom: 0.5rem;">Your published prompts</p>
-          <% published_prompts.each do |p| %>
-            <div class="ck-api-prompt-card">
-              <div class="ck-api-prompt-card__top">
-                <div>
-                  <strong class="ck-api-prompt-card__name"><%= p.name %></strong>
-                  <% if p.description.present? %>
-                    <p class="ck-api-prompt-card__desc"><%= p.description %></p>
-                  <% end %>
-                </div>
-                <span class="ck-chip" style="text-transform: none; flex-shrink: 0;"><%= p.llm_model %></span>
-              </div>
-              <div class="ck-api-prompt-card__url">
-                <code class="ck-endpoint__url" id="prompt_ep_<%= p.id %>"><%= base_url %>/api/v1/prompts/<%= p.slug %></code>
-                <button type="button" class="ck-icon-btn" title="Copy endpoint" aria-label="Copy endpoint URL" onclick="navigator.clipboard.writeText(document.getElementById('prompt_ep_<%= p.id %>').textContent)"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" fill="currentColor" width="14" height="14" aria-hidden="true"><path d="M0 6.75C0 5.784.784 5 1.75 5h1.5a.75.75 0 0 1 0 1.5h-1.5a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-1.5a.75.75 0 0 1 1.5 0v1.5A1.75 1.75 0 0 1 9.25 16h-7.5A1.75 1.75 0 0 1 0 14.25Z"/><path d="M5 1.75C5 .784 5.784 0 6.75 0h7.5C15.216 0 16 .784 16 1.75v7.5A1.75 1.75 0 0 1 14.25 11h-7.5A1.75 1.75 0 0 1 5 9.25Zm1.75-.25a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-7.5a.25.25 0 0 0-.25-.25Z"/></svg></button>
-              </div>
-            </div>
-          <% end %>
-        </div>
-      <% end %>
+      <%= render "completion_kit/api_reference/resource_list", title: "Your published prompts",
+            items: published_prompts.map { |p|
+              { name: p.name, subtitle: p.description, meta: p.llm_model,
+                url: "#{base_url}/api/v1/prompts/#{p.slug}", dom_id: "prompt_ep_#{p.id}" }
+            } %>
       <div class="ck-api-endpoint">
         <p class="ck-api-method"><span class="ck-chip ck-chip--soft">PATCH</span> /api/v1/prompts/:id</p>
         <p class="ck-meta-copy">Update a prompt. Accepts same params as create.</p>
@@ -140,6 +129,11 @@
         <p class="ck-meta-copy">Get a run with status, progress, response count, and average score.</p>
         <%= render "completion_kit/api_reference/example", base_url: base_url, token: token, real_token: real_token, cmd: "curl #{base_url}/api/v1/runs/1 \\\n  -H \"Authorization: Bearer #{token}\"" %>
       </div>
+      <%= render "completion_kit/api_reference/resource_list", title: "Your recent runs",
+            items: recent_runs.map { |r|
+              { name: r.name, meta: r.status.to_s.titleize,
+                url: "#{base_url}/api/v1/runs/#{r.id}", dom_id: "run_ep_#{r.id}" }
+            } %>
       <div class="ck-api-endpoint">
         <p class="ck-api-method"><span class="ck-chip ck-chip--soft">POST</span> /api/v1/runs/:id/generate</p>
         <p class="ck-meta-copy">Start generating responses. Returns 202 Accepted. Poll the run to check progress.</p>
@@ -167,6 +161,11 @@
         <p class="ck-api-method"><span class="ck-chip ck-chip--soft">GET</span> /api/v1/runs/:run_id/responses/:id</p>
         <p class="ck-meta-copy">Get a single response with its review scores and feedback.</p>
       </div>
+      <%= render "completion_kit/api_reference/resource_list", title: "Your responses",
+            items: recent_runs.first(1).map { |r|
+              { name: "#{r.name} — responses",
+                url: "#{base_url}/api/v1/runs/#{r.id}/responses", dom_id: "responses_ep_#{r.id}" }
+            } %>
     </div>
 
     <div class="ck-api-tabs__panel">
@@ -186,6 +185,11 @@
         <p class="ck-api-method"><span class="ck-chip ck-chip--soft">GET</span>&ensp;<span class="ck-chip ck-chip--soft">PATCH</span>&ensp;<span class="ck-chip" style="color: var(--ck-danger);">DELETE</span> /api/v1/datasets/:id</p>
         <p class="ck-meta-copy">Get, update, or delete a dataset.</p>
       </div>
+      <%= render "completion_kit/api_reference/resource_list", title: "Your datasets",
+            items: datasets.map { |d|
+              { name: d.name, meta: pluralize([d.csv_data.to_s.lines.count - 1, 0].max, "row"),
+                url: "#{base_url}/api/v1/datasets/#{d.id}", dom_id: "dataset_ep_#{d.id}" }
+            } %>
     </div>
 
     <div class="ck-api-tabs__panel">
@@ -205,6 +209,11 @@
         <p class="ck-api-method"><span class="ck-chip ck-chip--soft">GET</span>&ensp;<span class="ck-chip ck-chip--soft">PATCH</span>&ensp;<span class="ck-chip" style="color: var(--ck-danger);">DELETE</span> /api/v1/metrics/:id</p>
         <p class="ck-meta-copy">Get, update, or delete a metric.</p>
       </div>
+      <%= render "completion_kit/api_reference/resource_list", title: "Your metrics",
+            items: metrics.map { |m|
+              { name: m.name, subtitle: m.instruction.presence&.truncate(100),
+                url: "#{base_url}/api/v1/metrics/#{m.id}", dom_id: "metric_ep_#{m.id}" }
+            } %>
     </div>
 
     <div class="ck-api-tabs__panel">
@@ -223,6 +232,11 @@
         <p class="ck-api-method"><span class="ck-chip ck-chip--soft">GET</span>&ensp;<span class="ck-chip ck-chip--soft">PATCH</span>&ensp;<span class="ck-chip" style="color: var(--ck-danger);">DELETE</span> /api/v1/metric_groups/:id</p>
         <p class="ck-meta-copy">Get, update, or delete a metric group. PATCH with <code>metric_ids</code> replaces all metric associations.</p>
       </div>
+      <%= render "completion_kit/api_reference/resource_list", title: "Your metric groups",
+            items: metric_groups.map { |g|
+              { name: g.name, subtitle: g.description.presence, meta: pluralize(g.metric_ids.size, "metric"),
+                url: "#{base_url}/api/v1/metric_groups/#{g.id}", dom_id: "metric_group_ep_#{g.id}" }
+            } %>
     </div>
 
     <div class="ck-api-tabs__panel">
@@ -243,6 +257,11 @@
         <p class="ck-api-method"><span class="ck-chip ck-chip--soft">GET</span>&ensp;<span class="ck-chip ck-chip--soft">PATCH</span>&ensp;<span class="ck-chip" style="color: var(--ck-danger);">DELETE</span> /api/v1/tags/:id</p>
         <p class="ck-meta-copy">Get, update, or delete a tag. PATCH accepts <code>name</code>. DELETE returns 204 No Content and removes all taggings for this tag.</p>
       </div>
+      <%= render "completion_kit/api_reference/resource_list", title: "Your tags",
+            items: tags.map { |t|
+              { name: t.name, meta: t.color,
+                url: "#{base_url}/api/v1/tags/#{t.id}", dom_id: "tag_ep_#{t.id}" }
+            } %>
       <div class="ck-api-endpoint" style="padding-top: 1rem;">
         <p class="ck-kicker" style="margin-bottom: 0.5rem;">Tagging resources</p>
         <p class="ck-meta-copy">Metrics, prompts, runs, and datasets accept a <code>tag_names</code> array on their create and update endpoints. Passing a name that does not yet exist silently creates the tag. On PATCH, the list replaces all existing tags for that record (omit the field to leave tags unchanged).</p>
@@ -277,6 +296,11 @@
         <p class="ck-api-method"><span class="ck-chip ck-chip--soft">GET</span>&ensp;<span class="ck-chip ck-chip--soft">PATCH</span>&ensp;<span class="ck-chip" style="color: var(--ck-danger);">DELETE</span> /api/v1/provider_credentials/:id</p>
         <p class="ck-meta-copy">Get, update, or delete a provider credential.</p>
       </div>
+      <%= render "completion_kit/api_reference/resource_list", title: "Your providers",
+            items: provider_credentials.map { |pc|
+              { name: ck_provider_label(pc.provider), meta: pluralize(pc.model_count, "model"),
+                url: "#{base_url}/api/v1/provider_credentials/#{pc.id}", dom_id: "provider_ep_#{pc.id}" }
+            } %>
     </div>
 
   </div>

data/app/views/completion_kit/api_reference/_resource_card.html.erb

@@ -0,0 +1,24 @@
+<%
+  name = local_assigns.fetch(:name)
+  url = local_assigns.fetch(:url)
+  dom_id = local_assigns.fetch(:dom_id)
+  subtitle = local_assigns[:subtitle]
+  meta = local_assigns[:meta]
+%>
+<div class="ck-api-prompt-card">
+  <div class="ck-api-prompt-card__top">
+    <div>
+      <strong class="ck-api-prompt-card__name"><%= name %></strong>
+      <% if subtitle.present? %>
+        <p class="ck-api-prompt-card__desc"><%= subtitle %></p>
+      <% end %>
+    </div>
+    <% if meta.present? %>
+      <span class="ck-chip" style="text-transform: none; flex-shrink: 0;"><%= meta %></span>
+    <% end %>
+  </div>
+  <div class="ck-api-prompt-card__url">
+    <code class="ck-endpoint__url" id="<%= dom_id %>"><%= url %></code>
+    <button type="button" class="ck-icon-btn" title="Copy endpoint" aria-label="Copy endpoint URL" onclick="navigator.clipboard.writeText(document.getElementById('<%= dom_id %>').textContent)"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" fill="currentColor" width="14" height="14" aria-hidden="true"><path d="M0 6.75C0 5.784.784 5 1.75 5h1.5a.75.75 0 0 1 0 1.5h-1.5a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-1.5a.75.75 0 0 1 1.5 0v1.5A1.75 1.75 0 0 1 9.25 16h-7.5A1.75 1.75 0 0 1 0 14.25Z"/><path d="M5 1.75C5 .784 5.784 0 6.75 0h7.5C15.216 0 16 .784 16 1.75v7.5A1.75 1.75 0 0 1 14.25 11h-7.5A1.75 1.75 0 0 1 5 9.25Zm1.75-.25a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-7.5a.25.25 0 0 0-.25-.25Z"/></svg></button>
+  </div>
+</div>

data/app/views/completion_kit/api_reference/_resource_list.html.erb

@@ -0,0 +1,10 @@
+<%# title: heading text; items: array of hashes for _resource_card (name:, url:, dom_id:, subtitle?:, meta?:) %>
+<% items = Array(local_assigns.fetch(:items, [])) %>
+<% if items.any? %>
+  <div class="ck-api-endpoint" style="padding-top: 1rem;">
+    <p class="ck-kicker" style="margin-bottom: 0.5rem;"><%= local_assigns.fetch(:title) %></p>
+    <% items.each do |item| %>
+      <%= render "completion_kit/api_reference/resource_card", item %>
+    <% end %>
+  </div>
+<% end %>

data/app/views/completion_kit/api_reference/index.html.erb

@@ -20,4 +20,10 @@
       base_url: @base_url,
       token: ck_masked_token(@token),
       real_token: @token,
-      published_prompts: @published_prompts %>
+      published_prompts: @published_prompts,
+      recent_runs: @recent_runs,
+      datasets: @datasets,
+      metrics: @metrics,
+      metric_groups: @metric_groups,
+      tags: @tags,
+      provider_credentials: @provider_credentials %>

data/app/views/completion_kit/datasets/show.html.erb

@@ -8,6 +8,7 @@
     <h1 class="ck-title"><%= @dataset.name %></h1>
   </div>
   <div class="ck-actions">
+    <%= link_to "Download CSV", dataset_path(@dataset, format: :csv), class: ck_button_classes(:light, variant: :outline) %>
     <%= link_to "Edit", edit_dataset_path(@dataset), class: ck_button_classes(:light, variant: :outline) %>
   </div>
 </section>
@@ -67,23 +68,6 @@
 <% if @runs.any? %>
   <section class="ck-card--spaced">
     <p class="ck-kicker">Runs</p>
-
-    <table class="ck-results-table ck-runs-table" style="margin-top: 0.5rem;">
-      <thead>
-        <tr>
-          <th>Run</th>
-          <th>Responses</th>
-          <th>Metrics</th>
-          <th>Avg score</th>
-          <th>When</th>
-          <th></th>
-        </tr>
-      </thead>
-      <tbody>
-        <% @runs.each do |run| %>
-          <%= render "completion_kit/runs/row", run: run %>
-        <% end %>
-      </tbody>
-    </table>
+    <%= render "completion_kit/runs/table", runs: @runs %>
   </section>
 <% end %>

data/app/views/completion_kit/prompts/show.html.erb

@@ -17,6 +17,11 @@
       <code class="ck-endpoint__url" id="prompt_endpoint"><%= request.base_url %><%= api_v1_prompt_path(@prompt.slug) %></code>
       <button type="button" class="ck-icon-btn" title="Copy endpoint" onclick="navigator.clipboard.writeText(document.getElementById('prompt_endpoint').textContent)"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" fill="currentColor" width="14" height="14"><path d="M0 6.75C0 5.784.784 5 1.75 5h1.5a.75.75 0 0 1 0 1.5h-1.5a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-1.5a.75.75 0 0 1 1.5 0v1.5A1.75 1.75 0 0 1 9.25 16h-7.5A1.75 1.75 0 0 1 0 14.25Z"/><path d="M5 1.75C5 .784 5.784 0 6.75 0h7.5C15.216 0 16 .784 16 1.75v7.5A1.75 1.75 0 0 1 14.25 11h-7.5A1.75 1.75 0 0 1 5 9.25Zm1.75-.25a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-7.5a.25.25 0 0 0-.25-.25Z"/></svg></button>
     </div>
+    <% if @prompt.tags.any? %>
+      <div class="tag-marks-row">
+        <%= render "completion_kit/tags/marks", tags: @prompt.tags %>
+      </div>
+    <% end %>
   </div>
 
   <div class="ck-actions">
@@ -26,13 +31,7 @@
   </div>
 </section>
 
-<% if @prompt.tags.any? %>
-  <div class="tag-marks-row tag-marks-row--header">
-    <%= render "completion_kit/tags/marks", tags: @prompt.tags %>
-  </div>
-<% end %>
-
-<section>
+<section class="ck-card--spaced">
   <div class="ck-prompt-preview__header">
     <p class="ck-kicker">Prompt</p>
     <% judged_run = @runs.select { |r| r.prompt_id == @prompt.id && r.status == "completed" }.find { |r| r.responses.joins(:reviews).exists? } %>
@@ -45,7 +44,7 @@
       <p class="ck-hint"><%= link_to "Run a test with judging configured", new_run_path(prompt_id: @prompt.id), class: "ck-link" %> to get AI-suggested improvements.</p>
     <% end %>
   </div>
-  <pre class="ck-code ck-code--dark"><%= @prompt.template %></pre>
+  <pre class="ck-code ck-code--dark ck-code--prompt"><%= @prompt.template %></pre>
 </section>
 
 <% versions = @prompt.family_versions.includes(runs: { responses: :reviews }).to_a %>
@@ -140,24 +139,7 @@
 <% if @runs.any? %>
   <section class="ck-card--spaced">
     <p class="ck-kicker">Runs</p>
-
-    <table class="ck-results-table ck-runs-table" style="margin-top: 0.5rem;">
-      <thead>
-        <tr>
-          <th>Run</th>
-          <th>Responses</th>
-          <th>Metrics</th>
-          <th>Avg score</th>
-          <th>When</th>
-          <th></th>
-        </tr>
-      </thead>
-      <tbody>
-        <% @runs.each do |run| %>
-          <%= render "completion_kit/runs/row", run: run %>
-        <% end %>
-      </tbody>
-    </table>
+    <%= render "completion_kit/runs/table", runs: @runs %>
   </section>
 <% end %>
 

data/app/views/completion_kit/runs/_form.html.erb

@@ -93,10 +93,10 @@
 
     <div class="ck-field" id="metrics-field">
       <label class="ck-label">Metrics</label>
-      <p class="ck-field-hint" id="metrics-hint"></p>
       <% if @all_metrics.empty? %>
         <p class="ck-field-hint" style="color: var(--ck-warning);">No metrics yet.&ensp;<%= link_to "Create a metric", new_metric_path, class: "ck-link" %></p>
       <% else %>
+        <p class="ck-field-hint" id="metrics-hint"></p>
         <% if @metric_groups.any? %>
           <div class="ck-metric-groups">
             <span class="ck-metric-groups__label">Groups</span>

data/app/views/completion_kit/runs/_table.html.erb

@@ -0,0 +1,19 @@
+<%# Renders a runs table. Locals: runs: enumerable of CompletionKit::Run. %>
+<% runs = local_assigns.fetch(:runs) %>
+<table class="ck-results-table ck-runs-table" style="margin-top: 0.5rem;">
+  <thead>
+    <tr>
+      <th>Run</th>
+      <th>Responses</th>
+      <th>Metrics</th>
+      <th>Avg score</th>
+      <th>When</th>
+      <th></th>
+    </tr>
+  </thead>
+  <tbody>
+    <% runs.each do |run| %>
+      <%= render "completion_kit/runs/row", run: run %>
+    <% end %>
+  </tbody>
+</table>

data/app/views/completion_kit/runs/index.html.erb

@@ -14,23 +14,7 @@
       base_path: runs_path %>
 
 <% if @runs.any? %>
-  <table class="ck-results-table ck-runs-table">
-    <thead>
-      <tr>
-        <th>Run</th>
-        <th>Responses</th>
-        <th>Metrics</th>
-        <th>Avg score</th>
-        <th>When</th>
-        <th></th>
-      </tr>
-    </thead>
-    <tbody>
-      <% @runs.each do |run| %>
-        <%= render "row", run: run %>
-      <% end %>
-    </tbody>
-  </table>
+  <%= render "completion_kit/runs/table", runs: @runs %>
 <% elsif @selected_tags.any? %>
   <div class="ck-empty">
     <p>No runs match these tags. <%= link_to "Clear filters", runs_path, class: "ck-link" %>.</p>

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

@@ -6,7 +6,7 @@
   <%= csrf_meta_tags %>
   <%= csp_meta_tag %>
 
-  <%= favicon_link_tag "completion_kit/logo.svg", type: "image/svg+xml" %>
+  <%= favicon_link_tag "completion_kit/favicon.ico" %>
   <%= stylesheet_link_tag "completion_kit/application", media: "all" %>
   <%= javascript_include_tag "turbo", type: "module" %>
   <%= javascript_include_tag "completion_kit/application", defer: true %>
@@ -15,7 +15,7 @@
 <body class="ck-app">
   <header class="ck-topbar">
     <div class="ck-wrap ck-topbar__inner">
-      <%= link_to (main_app.respond_to?(:root_path) ? main_app.root_path : prompts_path), class: "ck-brand" do %><%= image_tag "completion_kit/logo.svg", alt: "CompletionKit", style: "height: 52px; width: auto; margin-bottom: 10px;" %> CompletionKit<% end %>
+      <%= link_to (main_app.respond_to?(:root_path) ? main_app.root_path : prompts_path), class: "ck-brand" do %><%= image_tag "completion_kit/logo.png", alt: "CompletionKit", style: "height: 64px; width: auto;" %><span class="ck-brand__name">Completion<span class="ck-brand__kit">Kit</span></span><% end %>
 
       <nav class="ck-nav">
         <% active = ->(path) { request.path.start_with?(path) ? ck_button_classes(:dark) : ck_button_classes(:light, variant: :outline) } %>

data/db/migrate/20260513000001_create_completion_kit_mcp_sessions.rb

@@ -0,0 +1,12 @@
+class CreateCompletionKitMcpSessions < ActiveRecord::Migration[8.1]
+  def change
+    create_table :completion_kit_mcp_sessions do |t|
+      t.string :session_id, null: false
+      t.datetime :expires_at, null: false
+      t.timestamps
+    end
+
+    add_index :completion_kit_mcp_sessions, :session_id, unique: true
+    add_index :completion_kit_mcp_sessions, :expires_at
+  end
+end

data/lib/completion_kit/engine.rb

@@ -11,7 +11,8 @@ module CompletionKit
       app.config.assets.precompile += %w(
         completion_kit/application.css
         completion_kit/application.js
-        completion_kit/logo.svg
+        completion_kit/logo.png
+        completion_kit/favicon.ico
       )
     end
 

data/lib/completion_kit/version.rb

@@ -1,3 +1,3 @@
 module CompletionKit
-  VERSION = "0.5.9"
+  VERSION = "0.5.10"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: completion-kit
 version: !ruby/object:Gem::Version
-  version: 0.5.9
+  version: 0.5.10
 platform: ruby
 authors:
 - Damien Bastin
@@ -227,7 +227,8 @@ files:
 - Rakefile
 - app/assets/config/completion_kit_manifest.js
 - app/assets/config/manifest.js
-- app/assets/images/completion_kit/logo.svg
+- app/assets/images/completion_kit/favicon.ico
+- app/assets/images/completion_kit/logo.png
 - app/assets/javascripts/completion_kit/application.js
 - app/assets/stylesheets/completion_kit/application.css
 - app/controllers/completion_kit/api/v1/base_controller.rb
@@ -262,6 +263,7 @@ files:
 - app/mailers/completion_kit/application_mailer.rb
 - app/models/completion_kit/application_record.rb
 - app/models/completion_kit/dataset.rb
+- app/models/completion_kit/mcp_session.rb
 - app/models/completion_kit/metric.rb
 - app/models/completion_kit/metric_group.rb
 - app/models/completion_kit/metric_group_membership.rb
@@ -303,6 +305,8 @@ files:
 - app/views/completion_kit/api_reference/_authentication.html.erb
 - app/views/completion_kit/api_reference/_body.html.erb
 - app/views/completion_kit/api_reference/_example.html.erb
+- app/views/completion_kit/api_reference/_resource_card.html.erb
+- app/views/completion_kit/api_reference/_resource_list.html.erb
 - app/views/completion_kit/api_reference/index.html.erb
 - app/views/completion_kit/datasets/_form.html.erb
 - app/views/completion_kit/datasets/edit.html.erb
@@ -339,6 +343,7 @@ files:
 - app/views/completion_kit/runs/_sort_toolbar.html.erb
 - app/views/completion_kit/runs/_status_header.html.erb
 - app/views/completion_kit/runs/_status_panel.html.erb
+- app/views/completion_kit/runs/_table.html.erb
 - app/views/completion_kit/runs/edit.html.erb
 - app/views/completion_kit/runs/index.html.erb
 - app/views/completion_kit/runs/new.html.erb
@@ -375,6 +380,7 @@ files:
 - db/migrate/20260507150000_add_temperature_ignored_to_runs.rb
 - db/migrate/20260509000001_create_completion_kit_tags.rb
 - db/migrate/20260509000002_create_completion_kit_taggings.rb
+- db/migrate/20260513000001_create_completion_kit_mcp_sessions.rb
 - lib/completion-kit.rb
 - lib/completion_kit.rb
 - lib/completion_kit/concurrency_check.rb

data/app/assets/images/completion_kit/logo.svg

@@ -1,6 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="2.4 2.3 88.74 89.1" width="512" height="512">
-  <path d="M57.7,56.4c1.2-1.2,1.8-3.1,1.4-5c-0.5-2-2.1-3.6-4.1-4c-3.5-0.7-6.6,1.9-6.6,5.3c0,1.5,0.6,2.8,1.5,3.8H37.4l0-12.6c-1.2,1.2-3.1,1.8-5,1.4c-2-0.5-3.6-2.1-4-4.1c-0.7-3.5,1.9-6.6,5.3-6.6c1.5,0,2.8,0.6,3.8,1.5V23.5H10.1c-3.1,0-5.7,2.5-5.7,5.7v54.5c0,3.1,2.5,5.7,5.7,5.7h27.2h27.2c3.1,0,5.7-2.5,5.7-5.7V56.4H57.7z" fill="#0891B2"/>
-  <path d="M54.7,37.5c-0.1-1.7,0.6-3.5,2.2-4.8c1.6-1.2,3.9-1.4,5.7-0.5c3.2,1.7,3.8,5.7,1.6,8.3c-0.9,1.1-2.3,1.8-3.6,1.9l9.6,8.1l17.5-20.9c2-2.4,1.7-6-0.7-8L66.2,4.3l-8.1,9.6c-0.2-1.7-1.2-3.4-3-4.3c-1.8-0.9-4.1-0.7-5.7,0.5c-2.8,2.2-2.8,6.3-0.2,8.4c1.1,0.9,2.5,1.4,3.9,1.2L45,29.5L54.7,37.5z" fill="#06B6D4"/>
-  <path d="M70.2,52.6c-0.5,0-0.9-0.2-1.3-0.5L59.3,44c-0.6-0.5-0.9-1.4-0.6-2.1c0.2-0.8,0.9-1.3,1.7-1.4c0.9-0.1,1.7-0.5,2.3-1.2c0.7-0.8,0.9-1.8,0.7-2.8c-0.2-1-0.8-1.9-1.8-2.4c-1.1-0.6-2.6-0.5-3.6,0.3c-1,0.7-1.5,1.8-1.4,3c0.1,0.8-0.4,1.6-1.1,1.9c-0.7,0.4-1.6,0.3-2.2-0.2L43.8,31c-0.4-0.3-0.7-0.8-0.7-1.4c0-0.5,0.1-1.1,0.5-1.5l5.9-7.1c-0.5-0.3-1-0.6-1.5-1c-1.7-1.4-2.7-3.6-2.6-5.8c0-2.2,1.1-4.3,2.9-5.7c2.2-1.8,5.3-2.1,7.9-0.7c1.1,0.6,2,1.3,2.6,2.3l6-7.1C65,2.6,65.5,2.3,66,2.3c0.5,0,1.1,0.1,1.5,0.5l20.9,17.5c1.6,1.3,2.5,3.2,2.7,5.2s-0.4,4-1.8,5.6L71.8,51.9c-0.3,0.4-0.8,0.7-1.4,0.7C70.4,52.6,70.3,52.6,70.2,52.6z M64.4,43.1l5.6,4.7l16.2-19.3c0.6-0.8,0.9-1.7,0.8-2.7s-0.5-1.9-1.3-2.5L66.4,7.1l-6.8,8.1c-0.5,0.6-1.4,0.9-2.1,0.6c-0.8-0.2-1.3-0.9-1.4-1.7c-0.1-1.2-0.8-2.2-1.9-2.7c-1.1-0.6-2.6-0.4-3.6,0.3c-0.9,0.7-1.3,1.6-1.4,2.7c0,1,0.4,2,1.2,2.7c0.7,0.6,1.5,0.9,2.4,0.8c0.8-0.1,1.6,0.4,1.9,1.1s0.3,1.6-0.2,2.2l-6.8,8.1l5.6,4.7c0.5-1,1.3-2,2.2-2.7c2.3-1.7,5.4-2,7.9-0.6c2,1.1,3.4,3,3.8,5.2s-0.2,4.5-1.6,6.2C65.4,42.4,64.9,42.8,64.4,43.1z" fill="#475569"/>
-  <path d="M70.3,54.4H61c0.3-1.1,0.3-2.3,0-3.5c-0.6-2.8-2.8-5-5.6-5.5c-2.2-0.5-4.5,0.1-6.3,1.5c-1.7,1.4-2.7,3.5-2.7,5.8c0,0.6,0.1,1.2,0.2,1.8h-7.3V43.8c0-0.8-0.5-1.5-1.2-1.8c-0.7-0.3-1.6-0.1-2.2,0.4c-0.8,0.8-2,1.2-3.2,0.9c-1.2-0.3-2.2-1.3-2.5-2.5c-0.2-1.1,0-2.1,0.7-2.9c0.7-0.8,1.6-1.3,2.6-1.3c0.9,0,1.7,0.3,2.4,1c0.6,0.6,1.4,0.7,2.2,0.4c0.7-0.3,1.2-1,1.2-1.8V23.5c0-1.1-0.9-2-2-2H10.1c-4.2,0-7.7,3.4-7.7,7.7v54.5c0,4.2,3.4,7.7,7.7,7.7h54.5c4.2,0,7.7-3.4,7.7-7.7V56.4C72.3,55.3,71.4,54.4,70.3,54.4z M10.1,25.5h25.2v7.3c-0.6-0.1-1.2-0.2-1.8-0.2c-2.2,0-4.3,1-5.8,2.7s-2,4-1.5,6.3c0.6,2.8,2.8,5,5.5,5.6c1.2,0.3,2.4,0.2,3.5,0v7.3H24.8c-0.8,0-1.5,0.5-1.8,1.2c-0.3,0.7-0.1,1.6,0.4,2.2c0.8,0.8,1.1,2,0.9,3.2c-0.3,1.2-1.3,2.2-2.6,2.5c-1.1,0.2-2.1,0-2.9-0.7c-0.8-0.7-1.3-1.6-1.3-2.6c0-0.9,0.3-1.7,1-2.4c0.6-0.6,0.7-1.4,0.4-2.2c-0.3-0.7-1-1.2-1.8-1.2H6.5V29.2C6.5,27.1,8.1,25.5,10.1,25.5z M36.6,74.9c-0.7,0.3-1.2,1-1.2,1.8v10.6H10.1c-2,0-3.7-1.6-3.7-3.7V58.4h7.3c-0.1,0.6-0.2,1.2-0.2,1.8c0,2.2,1,4.3,2.7,5.8c1.7,1.4,4,2,6.3,1.5c2.8-0.6,5-2.8,5.6-5.5c0.3-1.2,0.2-2.4,0-3.5h7.3V69c0,0.8,0.5,1.5,1.2,1.8c0.7,0.3,1.6,0.1,2.2-0.4c0.8-0.8,2-1.1,3.2-0.9c1.2,0.3,2.2,1.3,2.5,2.6c0.2,1.1,0,2.1-0.7,2.9c-0.7,0.8-1.6,1.3-2.6,1.3c-0.9,0-1.7-0.3-2.4-1C38.2,74.7,37.3,74.6,36.6,74.9z M68.3,83.6c0,2-1.6,3.7-3.7,3.7H39.4V80c0.6,0.1,1.2,0.2,1.8,0.2c2.2,0,4.3-1,5.8-2.7c1.4-1.7,2-4,1.5-6.3c-0.6-2.8-2.8-5-5.5-5.6c-1.2-0.3-2.4-0.2-3.5,0v-7.3H50c0.8,0,1.5-0.5,1.8-1.2c0.3-0.7,0.1-1.6-0.4-2.2c-0.6-0.6-1-1.5-1-2.4c0-1,0.5-2,1.3-2.6c0.8-0.7,1.8-0.9,2.9-0.7c1.2,0.3,2.3,1.3,2.6,2.5c0.3,1.2-0.1,2.4-0.9,3.2c-0.6,0.6-0.7,1.4-0.4,2.2c0.3,0.7,1,1.2,1.8,1.2h10.6V83.6z" fill="#475569"/>
-</svg>