clementine-agent 1.18.88 → 1.18.90

package/dist/cli/cron.js

@@ -149,6 +149,7 @@ export async function cmdCronRun(jobName) {
         // to the Event store.
         const sideChannel = gateway.consumeLastCronRunMetadata?.();
         const runIdFromGateway = sideChannel?.runId;
+        const totalCostFromGateway = sideChannel?.totalCostUsd;
         const entry = {
             jobName: job.name,
             startedAt: startedAt.toISOString(),
@@ -159,6 +160,8 @@ export async function cmdCronRun(jobName) {
             outputPreview: response ? response.slice(0, 200) : undefined,
             trigger,
             ...(runIdFromGateway ? { id: runIdFromGateway } : {}),
+            // 1.18.89: per-run cost for the dashboard Cost column / Health Strip tile.
+            ...(totalCostFromGateway != null ? { totalCostUsd: totalCostFromGateway } : {}),
         };
         // PRD Phase 1.1: goal-orientation evaluator (mirrors the daemon path).
         if (job.successSchema || (job.successCriteriaText && job.successCriteriaText.trim())) {

package/dist/cli/dashboard.js

@@ -20217,7 +20217,10 @@ if('serviceWorker' in navigator){navigator.serviceWorker.getRegistrations().then
           <h4>What it does</h4>
           <p class="cron-section-desc">The instruction the agent receives. Long prompts are fine — drag the corner to resize.</p>
           <div class="form-group">
-            <label class="form-label">Prompt</label>
+            <label class="form-label" style="display:flex;align-items:center;gap:8px">
+              Prompt
+              <a href="#" id="cron-prompt-history-link" onclick="event.preventDefault();openPromptHistory()" style="display:none;font-size:11px;font-weight:normal;color:var(--text-muted);text-decoration:none;border-bottom:1px dotted var(--border)">View prompt history</a>
+            </label>
             <textarea id="cron-prompt" class="cron-prompt-textarea" placeholder="What should the AI do when this task runs?"></textarea>
             <div class="form-hint">The instruction sent to the AI agent when this task fires.</div>
           </div>
@@ -20450,6 +20453,29 @@ if('serviceWorker' in navigator){navigator.serviceWorker.getRegistrations().then
 
 <!-- (legacy standalone Preview modal removed in 1.18.70 — preview now lives as a tab inside the cron modal) -->
 
+<!-- ═══ Prompt History Modal — PRD §11 / 1.18.90 ═══
+     Lists every past prompt revision for the currently-edited task.
+     Each row shows ts + changedBy + a preview, expandable to full
+     content. "Restore" copies the old prompt back into the editor —
+     it does NOT auto-save, so the user reviews + clicks Save Changes
+     to commit. The current draft in the editor is preserved if the
+     user closes without restoring. -->
+<div class="modal-overlay" id="prompt-history-modal">
+  <div class="modal" style="max-width:720px;width:96vw;max-height:88vh;display:flex;flex-direction:column">
+    <div class="modal-header">
+      <h3>Prompt history</h3>
+      <button class="btn-ghost btn-sm" onclick="closePromptHistory()">&times;</button>
+    </div>
+    <div class="modal-body" style="padding:0;flex:1;min-height:0;overflow-y:auto">
+      <div id="prompt-history-list" style="padding:18px"></div>
+    </div>
+    <div class="modal-footer">
+      <span style="flex:1;font-size:11px;color:var(--text-muted)">Restore copies a version into the editor. You still need to click <strong>Save Changes</strong> to commit it.</span>
+      <button onclick="closePromptHistory()">Close</button>
+    </div>
+  </div>
+</div>
+
 <!-- ═══ MCP Server Edit Modal — PRD Phase 2.1 ═══ -->
 <div class="modal-overlay" id="mcp-edit-modal">
   <div class="modal" style="max-width:640px;width:96vw">
@@ -23835,9 +23861,24 @@ async function refreshHealthStrip() {
     : successRate >= 95 ? 'var(--green)'
     : successRate >= 80 ? 'var(--yellow)'
     : 'var(--red)';
+  // 1.18.89: cost tile. Sums totalCostUsd across the 24h window. Runs that
+  // pre-date 1.18.89 don't have the field — they contribute 0 (the user
+  // sees a partial number that grows as new runs land).
+  var totalCost = 0;
+  var runsWithCost = 0;
+  for (var ci = 0; ci < last24.length; ci++) {
+    if (typeof last24[ci].totalCostUsd === 'number') {
+      totalCost += last24[ci].totalCostUsd;
+      runsWithCost++;
+    }
+  }
+  var costLabel = runsWithCost === 0 ? '—' : (totalCost < 0.01 ? '$' + totalCost.toFixed(4) : '$' + totalCost.toFixed(2));
+  var costSub = runsWithCost === 0 ? 'no priced runs yet' : runsWithCost + ' of ' + last24.length + ' runs priced';
+
   var html = '';
   html += tile('Runs · 24h', last24.length, ok + ' ok · ' + failed + ' failed');
   html += tile('Success rate', successRate === null ? '—' : (successRate + '%'), null, srColor);
+  html += tile('Cost · 24h', costLabel, costSub);
   html += tile('P50 latency', p50 === null ? '—' : formatDurationMs(p50), 'median run time');
   html += tile('P95 latency', p95 === null ? '—' : formatDurationMs(p95), '95th percentile');
   html += tile('Running now', activeRuns, activeRuns === 0 ? 'idle' : 'live');
@@ -23981,10 +24022,10 @@ function renderRunListBody(allRuns) {
     return html;
   }
   // Table — same shape as the Recent History list on the Tasks page,
-  // but sortable and with a Trigger column.
+  // but sortable and with a Trigger + Cost column.
   html += '<div style="background:var(--bg-secondary);border:1px solid var(--border);border-radius:var(--radius)">';
-  html += '<div style="display:grid;grid-template-columns:24px 24px minmax(180px,1.2fr) 90px minmax(180px,1fr) 90px auto;gap:10px;padding:8px 14px;border-bottom:1px solid var(--border);font-size:11px;color:var(--text-muted);text-transform:uppercase;letter-spacing:0.04em;font-weight:500">'
-    +    '<div></div><div title="Goal verdict">Goal</div><div>Task</div><div>Trigger</div><div>Started</div><div>Duration</div><div></div>'
+  html += '<div style="display:grid;grid-template-columns:24px 24px minmax(180px,1.2fr) 80px minmax(160px,1fr) 70px 70px auto;gap:10px;padding:8px 14px;border-bottom:1px solid var(--border);font-size:11px;color:var(--text-muted);text-transform:uppercase;letter-spacing:0.04em;font-weight:500">'
+    +    '<div></div><div title="Goal verdict">Goal</div><div>Task</div><div>Trigger</div><div>Started</div><div>Duration</div><div title="Total cost in USD">Cost</div><div></div>'
     + '</div>';
   for (var i = 0; i < filtered.length; i++) {
     var entry = filtered[i] || {};
@@ -24032,7 +24073,14 @@ function renderRunListBody(allRuns) {
     } else if (entry.outputPreview) {
       preview = '<div style="font-size:11px;color:var(--text-muted);margin-top:2px;word-break:break-word">' + esc(String(entry.outputPreview).slice(0, 120)) + '</div>';
     }
-    html += '<div class="history-row" data-trace-job="' + esc(jobName) + '" style="display:grid;grid-template-columns:24px 24px minmax(180px,1.2fr) 90px minmax(180px,1fr) 90px auto;gap:10px;align-items:start;padding:8px 14px;border-bottom:1px solid var(--border);cursor:pointer">'
+    // 1.18.89: cost label. Showing 4 decimals for sub-penny costs (Haiku
+    // runs land in fractions of a cent), 2 decimals when ≥ $0.01.
+    var costLabel = '—';
+    if (entry.totalCostUsd != null) {
+      var c = entry.totalCostUsd;
+      costLabel = c < 0.01 ? '$' + c.toFixed(4) : '$' + c.toFixed(2);
+    }
+    html += '<div class="history-row" data-trace-job="' + esc(jobName) + '" style="display:grid;grid-template-columns:24px 24px minmax(180px,1.2fr) 80px minmax(160px,1fr) 70px 70px auto;gap:10px;align-items:start;padding:8px 14px;border-bottom:1px solid var(--border);cursor:pointer">'
       +    '<div style="color:' + statusColor + ';font-size:14px;line-height:18px;text-align:center" title="' + esc(status) + '">' + statusIcon + '</div>'
       +    goalCell
       +    '<div style="min-width:0">'
@@ -24043,6 +24091,7 @@ function renderRunListBody(allRuns) {
       +    '<div style="font-size:11px;color:' + triggerColor + ';line-height:18px">' + esc(triggerLabel) + '</div>'
       +    '<div style="font-size:12px;color:var(--text-secondary);line-height:18px">' + esc(startedLabel) + '</div>'
       +    '<div style="font-size:12px;color:var(--text-muted);line-height:18px">' + esc(durationLabel) + '</div>'
+      +    '<div style="font-size:12px;color:var(--text-muted);line-height:18px;font-family:\\x27JetBrains Mono\\x27,monospace">' + esc(costLabel) + '</div>'
       +    '<div style="display:flex;gap:6px;align-items:center"><button class="btn-sm" onclick="event.stopPropagation();openRunOrTrace(\\x27' + safeName + '\\x27,' + (entry.id ? '\\x27' + jsStr(entry.id) + '\\x27' : 'null') + ')" style="font-size:11px;padding:3px 8px">' + (entry.id ? 'Open run' : 'Trace') + '</button></div>'
       + '</div>';
   }
@@ -25942,6 +25991,87 @@ async function loadCronPreviewIntoTab(jobName) {
 // Mark the preview as stale (call after save so next tab visit refetches).
 function markCronPreviewDirty() { _cronPreviewLoadedFor = null; }
 
+// ── PRD §11 / 1.18.90: Prompt history viewer ────────────────────────
+// Reads /api/cron/:job/prompt-history (already populated on every PUT
+// since 1.18.x). Each version is the OLD prompt at the moment of a save,
+// so rolling back means picking the version that was AFTER the change
+// you want to undo (or the current saved value if you want the most
+// recent committed state).
+async function openPromptHistory() {
+  if (!editingCronJob) {
+    toast('Save the task first, then prompt history will be available.', 'info');
+    return;
+  }
+  var modal = document.getElementById('prompt-history-modal');
+  var list = document.getElementById('prompt-history-list');
+  if (!modal || !list) return;
+  list.innerHTML = '<div style="padding:24px;color:var(--text-muted);text-align:center">Loading prompt history…</div>';
+  modal.classList.add('show');
+  try {
+    var r = await apiFetch('/api/cron/' + encodeURIComponent(editingCronJob) + '/prompt-history');
+    var d = await r.json();
+    var versions = (d && d.versions) || [];
+    if (versions.length === 0) {
+      list.innerHTML = '<div style="padding:36px 24px;color:var(--text-muted);text-align:center;line-height:1.6">'
+        + '<div style="font-weight:500;color:var(--text-secondary);margin-bottom:8px">No prior prompt versions yet</div>'
+        + '<div style="font-size:12px">A version is recorded each time you save a different prompt. The first edit you make to this task will create version 1.</div>'
+        + '</div>';
+      return;
+    }
+    var html = '<div style="font-size:11px;color:var(--text-muted);margin-bottom:12px">Newest first. Each entry is the prompt as it was BEFORE that save — restoring rolls the editor back to the version that was active before that change landed.</div>';
+    for (var i = 0; i < versions.length; i++) {
+      var v = versions[i];
+      var ts = v.timestamp ? new Date(v.timestamp).toLocaleString() : 'unknown time';
+      var who = v.changedBy || 'dashboard';
+      var prompt = String(v.prompt || '');
+      var preview = prompt.slice(0, 200).replace(/\\s+/g, ' ');
+      var rowId = 'pmt-hist-' + i;
+      var promptB64 = btoa(unescape(encodeURIComponent(prompt))); // safe transport for restore
+      html += '<div style="background:var(--bg-secondary);border:1px solid var(--border);border-radius:8px;padding:14px;margin-bottom:10px">';
+      html += '<div style="display:flex;align-items:center;gap:10px;margin-bottom:8px">';
+      html += '<span style="font-size:11px;font-weight:600;color:var(--text-muted);text-transform:uppercase;letter-spacing:0.04em">v' + esc(v.version || (versions.length - i)) + '</span>';
+      html += '<span style="font-size:12px;color:var(--text-primary)">' + esc(ts) + '</span>';
+      html += '<span style="font-size:11px;color:var(--text-muted)">· by ' + esc(who) + '</span>';
+      html += '<span style="flex:1"></span>';
+      html += '<button class="btn-sm" onclick="document.getElementById(\\x27' + rowId + '\\x27).style.display=document.getElementById(\\x27' + rowId + '\\x27).style.display===\\x27none\\x27?\\x27block\\x27:\\x27none\\x27" style="font-size:11px;padding:3px 8px">Show full</button>';
+      html += '<button class="btn-sm btn-primary" onclick="restorePromptVersion(\\x27' + promptB64 + '\\x27)" style="font-size:11px;padding:3px 10px">Restore</button>';
+      html += '</div>';
+      html += '<div style="font-size:12px;color:var(--text-secondary);line-height:1.5;font-family:\\x27JetBrains Mono\\x27,monospace">' + esc(preview) + (prompt.length > 200 ? '…' : '') + '</div>';
+      html += '<pre id="' + rowId + '" style="display:none;margin-top:10px;font-size:11px;font-family:\\x27JetBrains Mono\\x27,monospace;background:var(--bg-tertiary);border:1px solid var(--border);padding:10px;border-radius:6px;white-space:pre-wrap;word-break:break-word;max-height:280px;overflow-y:auto">' + esc(prompt) + '</pre>';
+      html += '</div>';
+    }
+    list.innerHTML = html;
+  } catch (e) {
+    list.innerHTML = '<div style="padding:24px;color:var(--red)">Failed to load history: ' + esc(String(e)) + '</div>';
+  }
+}
+
+function closePromptHistory() {
+  var modal = document.getElementById('prompt-history-modal');
+  if (modal) modal.classList.remove('show');
+}
+
+// Restore copies the old prompt back into the editor's textarea. Doesn't
+// auto-save — the user must click Save Changes to commit, which keeps the
+// dirty-guard semantics intact and gives them a chance to back out.
+function restorePromptVersion(promptB64) {
+  try {
+    var prompt = decodeURIComponent(escape(atob(promptB64)));
+    var ta = document.getElementById('cron-prompt');
+    if (!ta) return;
+    if (ta.value !== prompt && ta.value.trim() && !confirm('Replace the current prompt with this restored version? Your unsaved edits will be discarded.')) {
+      return;
+    }
+    ta.value = prompt;
+    // Switch to the Prompt tab so the user sees what just changed.
+    if (typeof switchCronConfigTab === 'function') switchCronConfigTab('prompt');
+    closePromptHistory();
+    toast('Prompt restored. Click Save Changes to commit it.', 'info');
+  } catch (e) {
+    toast('Failed to restore: ' + String(e), 'error');
+  }
+}
+
 // PRD Phase 1.3a: inner Configure pane tabs. Sets the data-active-config-tab
 // attribute on #cron-tab-configure; CSS handles section visibility via
 // data-config-tab attributes on each section. JS-light by design.
@@ -26237,6 +26367,9 @@ function openCreateCronModal(agentSlug) {
   if (lastRunBtn) lastRunBtn.setAttribute('disabled', 'disabled');
   var runOnceBtn = document.getElementById('cron-run-once-btn');
   if (runOnceBtn) runOnceBtn.style.display = 'none';
+  // PRD §11 / 1.18.90: prompt history link only meaningful for existing tasks.
+  var historyLinkNew = document.getElementById('cron-prompt-history-link');
+  if (historyLinkNew) historyLinkNew.style.display = 'none';
   var host = document.getElementById('cron-legacy-banner-host');
   if (host) host.innerHTML = '';
   // Reset the "Use a cron expression" link in case it was hidden last time.
@@ -26337,6 +26470,9 @@ function openEditCronModal(jobName) {
   // Show "Run task once" only for saved tasks.
   var runOnceBtnEdit = document.getElementById('cron-run-once-btn');
   if (runOnceBtnEdit) runOnceBtnEdit.style.display = '';
+  // 1.18.90: surface prompt history link for saved tasks.
+  var historyLinkEdit = document.getElementById('cron-prompt-history-link');
+  if (historyLinkEdit) historyLinkEdit.style.display = '';
   // Render the most recent run from the loaded job into the Last run tab so
   // the user sees something the moment they switch to it (rather than a
   // dead empty pane). The pane updates live when Run task once fires.

package/dist/gateway/cron-scheduler.js

@@ -1210,6 +1210,9 @@ export class CronScheduler {
                         trigger,
                         // 1.18.85: stable UUID linking this run to its Event store entries.
                         ...(cronMetadata?.runId ? { id: cronMetadata.runId } : {}),
+                        // 1.18.89: per-run cost for the Run list + Health Strip. Comes from
+                        // SDK's ResultMessage.total_cost_usd via runAgent's side-channel.
+                        ...(cronMetadata?.totalCostUsd != null ? { totalCostUsd: cronMetadata.totalCostUsd } : {}),
                         // Trick capability metadata — surfaced by the dashboard's
                         // "ran with: …" line. Omit empty arrays to keep the JSONL light.
                         ...(cronMetadata?.skillsApplied?.length ? { skillsApplied: cronMetadata.skillsApplied } : {}),
@@ -1306,6 +1309,9 @@ export class CronScheduler {
                         // can show trigger + open the partial Event log if any.
                         trigger,
                         ...(errCronMetadata?.runId ? { id: errCronMetadata.runId } : {}),
+                        // 1.18.89: cost on the error path too — partial-completion runs may
+                        // still have spent budget before the throw.
+                        ...(errCronMetadata?.totalCostUsd != null ? { totalCostUsd: errCronMetadata.totalCostUsd } : {}),
                         ...(errCronMetadata?.skillsApplied?.length ? { skillsApplied: errCronMetadata.skillsApplied } : {}),
                         ...(errCronMetadata?.skillsMissing?.length ? { skillsMissing: errCronMetadata.skillsMissing } : {}),
                         ...(errCronMetadata?.allowedToolsApplied?.length ? { allowedToolsApplied: errCronMetadata.allowedToolsApplied } : {}),

package/dist/gateway/router.d.ts

@@ -239,6 +239,8 @@ export declare class Gateway {
         mcpServersApplied: string[];
         /** PRD §6 / 1.18.85: run UUID from runAgent. */
         runId?: string;
+        /** PRD §12 / 1.18.89: total cost in USD from runAgent's SDK result. */
+        totalCostUsd?: number;
     } | undefined;
     requestApproval(descriptionOrId: string, explicitId?: string): Promise<boolean | string>;
     resolveApproval(requestId: string, result: boolean | string): void;

package/dist/gateway/router.js

@@ -2024,6 +2024,7 @@ export class Gateway {
                     allowedToolsApplied: cronResult.allowedToolsApplied,
                     mcpServersApplied: cronResult.mcpServersApplied,
                     runId: cronResult.runId,
+                    totalCostUsd: cronResult.totalCostUsd,
                 };
                 logger.info({
                     jobName,

package/dist/types.d.ts

@@ -514,6 +514,11 @@ export interface CronRunEntry {
      *  whose status indicates a failure (error/timeout/lost/cancelled). The
      *  Run list filter chip and Run detail header read from this field. */
     failureCategory?: RunFailureCategory;
+    /** PRD §12 / 1.18.89: total cost in USD as reported by the SDK's
+     *  ResultMessage.total_cost_usd. Stamped on success/error entries by
+     *  the scheduler from the runAgent result side-channel. Powers the
+     *  Run list Cost column and the Health Strip's 24h cost tile. */
+    totalCostUsd?: number;
     /** PRD Phase 1: did the run accomplish what it was supposed to?
      *  Computed at run-end when the Task has successSchema or successCriteriaText.
      *  - status='pass'      both configured checks passed (or the only one configured did)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clementine-agent",
-  "version": "1.18.88",
+  "version": "1.18.90",
   "description": "Clementine — Personal AI Assistant (TypeScript)",
   "type": "module",
   "main": "dist/index.js",