clementine-agent 1.18.83 → 1.18.85

package/dist/agent/assistant.d.ts

@@ -70,8 +70,6 @@ export declare class PersonalAssistant {
     private memoryStore;
     private _lastUserMessage?;
     onSkillProposed: ((skill: import('../types.js').SkillDocument) => void) | null;
-    private _lastMcpStatus;
-    private _lastMcpStatusTime;
     /** Terminal reason from the last SDK query — consumed by cron scheduler for precise error classification. */
     private _lastTerminalReason?;
     /** Per-session stall nudge — set after a query shows stall signals, consumed on the next query. */

package/dist/agent/assistant.js

@@ -17,6 +17,7 @@ import { BASE_DIR, PKG_DIR, VAULT_DIR, DAILY_NOTES_DIR, SOUL_FILE, AGENTS_FILE,
 import { summarizeIntegrationStatus } from '../config/integrations-registry.js';
 import { loadToolPreferences, computeAvailability, buildPromptInstruction, buildComposioStatusBlock, KNOWN_SERVICES, } from '../integrations/tool-preferences.js';
 import { loadClaudeIntegrations } from './mcp-bridge.js';
+import { getLatestMcpStatusSnapshot, recordMcpStatusFromSystemInit, invalidateMcpStatusEntry } from './run-agent.js';
 import { detectFrustrationSignals, detectRepeatedTopics } from './insight-engine.js';
 import { DEFAULT_CHANNEL_CAPABILITIES } from '../types.js';
 import { enforceToolPermissions, getSecurityPrompt, getHeartbeatSecurityPrompt, getCronSecurityPrompt, getHeartbeatDisallowedTools, logToolUse, logAuditJsonl, } from './hooks.js';
@@ -710,8 +711,10 @@ export class PersonalAssistant {
     memoryStore = null; // Typed as any — MemoryStore may not be available yet
     _lastUserMessage;
     onSkillProposed = null;
-    _lastMcpStatus = [];
-    _lastMcpStatusTime = '';
+    // PRD Phase 2 / 1.18.84: superseded by the shared module-level cache in
+    // run-agent.ts (getLatestMcpStatusSnapshot / recordMcpStatusFromSystemInit).
+    // The fields below were declared but never written pre-1.18.84; the
+    // module cache populates from every system/init message instead.
     /** Terminal reason from the last SDK query — consumed by cron scheduler for precise error classification. */
     _lastTerminalReason;
     /** Per-session stall nudge — set after a query shows stall signals, consumed on the next query. */
@@ -808,7 +811,12 @@ export class PersonalAssistant {
         this.onSkillProposed = cb;
     }
     getMcpStatus() {
-        return { servers: this._lastMcpStatus, updatedAt: this._lastMcpStatusTime };
+        // 1.18.84 correctness fix: delegate to the shared module-level cache.
+        // Pre-1.18.84 we returned this._lastMcpStatus, which was declared but
+        // never written — getMcpStatus() always returned empty. Now run-agent
+        // and assistant query streams record into a shared snapshot via
+        // recordMcpStatusFromSystemInit when the SDK init message lands.
+        return getLatestMcpStatusSnapshot();
     }
     /**
      * PRD Phase 2.1: clear the cached status for one server so the next query
@@ -818,12 +826,9 @@ export class PersonalAssistant {
      * stale error/auth state. Returns the post-clear cached snapshot.
      */
     invalidateMcpStatus(serverName) {
-        const beforeLen = this._lastMcpStatus.length;
-        this._lastMcpStatus = this._lastMcpStatus.filter((s) => s.name !== serverName);
-        const cleared = this._lastMcpStatus.length < beforeLen;
-        if (cleared)
-            this._lastMcpStatusTime = new Date().toISOString();
-        return { servers: this._lastMcpStatus, updatedAt: this._lastMcpStatusTime, cleared };
+        const result = invalidateMcpStatusEntry(serverName);
+        const snapshot = getLatestMcpStatusSnapshot();
+        return { servers: snapshot.servers, updatedAt: snapshot.updatedAt, cleared: result.cleared };
     }
     /** Inject a background work result into the session as silent follow-up context. */
     injectPendingContext(sessionKey, userPrompt, result) {
@@ -2999,6 +3004,15 @@ You have a cost budget per message — not a hard turn limit. Work until the tas
         const trace = [];
         const stream = query({ prompt, options: sdkOptions });
         for await (const message of stream) {
+            // 1.18.84 correctness: capture MCP server status from SDK init.
+            if (message.type === 'system' && message.subtype === 'init') {
+                const mcpServersRaw = message.mcp_servers;
+                if (mcpServersRaw)
+                    try {
+                        recordMcpStatusFromSystemInit(mcpServersRaw);
+                    }
+                    catch { /* non-fatal */ }
+            }
             if (message.type === 'assistant') {
                 const blocks = getContentBlocks(message);
                 for (const block of blocks) {

package/dist/agent/run-agent.d.ts

@@ -22,6 +22,21 @@
  *    long-task preflight, NO mode=unleashed wrapper.
  */
 import { type AgentDefinition } from '@anthropic-ai/claude-agent-sdk';
+/** Read the latest MCP status snapshot. Safe to call from any module. */
+export declare function getLatestMcpStatusSnapshot(): {
+    servers: Array<{
+        name: string;
+        status: string;
+    }>;
+    updatedAt: string;
+};
+/** Write a fresh snapshot. Called from system/init handlers. */
+export declare function recordMcpStatusFromSystemInit(rawMcpServers: unknown): void;
+/** Drop one server from the cache so the next query repopulates it. */
+export declare function invalidateMcpStatusEntry(name: string): {
+    cleared: boolean;
+    updatedAt: string;
+};
 import type { AgentProfile } from '../types.js';
 import type { AgentManager } from './agent-manager.js';
 import type { MemoryStore } from '../memory/store.js';
@@ -102,6 +117,10 @@ export interface RunAgentResult {
         cache_read_input_tokens?: number;
         cache_creation_input_tokens?: number;
     };
+    /** PRD §6 / 1.18.85: stable run UUID. The Event store keys off this id;
+     *  callers (cron-scheduler, cron CLI) stamp it on CronRunEntry so the
+     *  Run detail page can join run row → events. */
+    runId: string;
 }
 /**
  * Run a single agent invocation via the canonical SDK pattern.

package/dist/agent/run-agent.js

@@ -22,8 +22,74 @@
  *    long-task preflight, NO mode=unleashed wrapper.
  */
 import path from 'node:path';
+import { randomUUID } from 'node:crypto';
 import { query } from '@anthropic-ai/claude-agent-sdk';
 import pino from 'pino';
+import { EventLog } from '../gateway/event-log.js';
+/**
+ * Module-level cache of MCP server statuses from the most recent SDK
+ * init message. Populated by every runAgent / PersonalAssistant query
+ * stream that captures `system/init`. Read by Assistant.getMcpStatus()
+ * and the dashboard's Tools & MCP catalog page.
+ *
+ * Pre-1.18.84 the assistant declared a private _lastMcpStatus but no
+ * code wrote to it — getMcpStatus() always returned empty, making the
+ * catalog status pills misleading. The shared module cache fixes that
+ * without coupling assistant.ts to runAgent's stream loop.
+ */
+let _lastMcpStatusSnapshot = {
+    servers: [],
+    updatedAt: '',
+};
+/** Read the latest MCP status snapshot. Safe to call from any module. */
+export function getLatestMcpStatusSnapshot() {
+    return { servers: [..._lastMcpStatusSnapshot.servers], updatedAt: _lastMcpStatusSnapshot.updatedAt };
+}
+/** Write a fresh snapshot. Called from system/init handlers. */
+export function recordMcpStatusFromSystemInit(rawMcpServers) {
+    if (!Array.isArray(rawMcpServers))
+        return;
+    const servers = [];
+    for (const entry of rawMcpServers) {
+        if (!entry || typeof entry !== 'object')
+            continue;
+        const e = entry;
+        if (typeof e.name !== 'string' || !e.name)
+            continue;
+        servers.push({ name: e.name, status: typeof e.status === 'string' ? e.status : 'unknown' });
+    }
+    _lastMcpStatusSnapshot = { servers, updatedAt: new Date().toISOString() };
+}
+/**
+ * Truncate a value for the Event store so a single huge tool input/output
+ * doesn't blow out the JSONL line. Object/array shapes are JSON-stringified
+ * and capped; primitive strings are sliced; everything else is returned as-is.
+ */
+function truncateForLog(value, maxBytes) {
+    if (value == null)
+        return value;
+    if (typeof value === 'string') {
+        return value.length > maxBytes ? value.slice(0, maxBytes) + '...[truncated]' : value;
+    }
+    try {
+        const json = JSON.stringify(value);
+        if (json.length <= maxBytes)
+            return value;
+        return { _truncated: true, preview: json.slice(0, maxBytes) + '...[truncated]', _bytes: json.length };
+    }
+    catch {
+        return { _unstringifiable: true };
+    }
+}
+/** Drop one server from the cache so the next query repopulates it. */
+export function invalidateMcpStatusEntry(name) {
+    const before = _lastMcpStatusSnapshot.servers.length;
+    _lastMcpStatusSnapshot = {
+        servers: _lastMcpStatusSnapshot.servers.filter((s) => s.name !== name),
+        updatedAt: new Date().toISOString(),
+    };
+    return { cleared: _lastMcpStatusSnapshot.servers.length < before, updatedAt: _lastMcpStatusSnapshot.updatedAt };
+}
 import { BASE_DIR, PKG_DIR, CLAUDE_CODE_OAUTH_TOKEN, ANTHROPIC_API_KEY as CONFIG_ANTHROPIC_API_KEY, normalizeClaudeSdkOptionsForOneMillionContext, } from '../config.js';
 import { buildAgentMap } from './agent-definitions.js';
 const MCP_SERVER_SCRIPT = path.join(PKG_DIR, 'dist', 'tools', 'mcp-server.js');
@@ -218,6 +284,23 @@ export async function runAgent(prompt, opts) {
         agentCount: Object.keys(agents).length,
         allowedToolCount: allowedTools.length,
     }, 'runAgent: starting query');
+    // PRD §6 / 1.18.85: path A in-process tap. One Event row per significant
+    // SDK message, written to ~/.clementine/events/<runId>.jsonl. The Run
+    // detail page (Phase 4b) reads from this file. EventLog.append never
+    // throws back to the caller — telemetry is best-effort.
+    const runId = randomUUID();
+    const eventLog = new EventLog();
+    let eventSeq = 0;
+    const writeEvent = (e) => {
+        try {
+            eventLog.append({
+                ...e,
+                runId,
+                seq: eventSeq++,
+            });
+        }
+        catch { /* never block */ }
+    };
     let finalText = '';
     let sessionId = '';
     let totalCostUsd = 0;
@@ -229,15 +312,38 @@ export async function runAgent(prompt, opts) {
         for await (const message of stream) {
             if (message.type === 'system' && message.subtype === 'init') {
                 sessionId = message.session_id ?? '';
-                logger.debug({ sessionKey: opts.sessionKey, sdkSessionId: sessionId }, 'runAgent: SDK session initialized');
+                // PRD Phase 2 / 1.18.84 correctness: capture the SDK-reported MCP
+                // server status so getMcpStatus() (and the dashboard's Tools & MCP
+                // catalog) actually has data. The init message includes
+                // mcp_servers: Array<{ name, status }> per the SDK protocol.
+                const mcpServersRaw = message.mcp_servers;
+                if (mcpServersRaw) {
+                    try {
+                        recordMcpStatusFromSystemInit(mcpServersRaw);
+                    }
+                    catch { /* non-fatal */ }
+                }
+                // PRD Phase 4a / 1.18.85: write the session_start Event row.
+                writeEvent({ kind: 'session_start', ts: new Date().toISOString(), sessionId });
+                logger.debug({ sessionKey: opts.sessionKey, sdkSessionId: sessionId, runId }, 'runAgent: SDK session initialized');
                 continue;
             }
             if (message.type === 'assistant') {
                 const am = message;
+                // SDK content blocks include text, tool_use, and (when extended-thinking
+                // is enabled) thinking. We tap each kind into the Event store.
                 const blocks = (am.message?.content ?? []);
                 for (const block of blocks) {
                     if (block.type === 'text' && typeof block.text === 'string') {
                         finalText += block.text;
+                        // PRD Phase 4a / 1.18.85: llm_text Event. Truncate at 8KB to keep
+                        // the JSONL light — full text is reachable via the SDK transcript.
+                        writeEvent({
+                            kind: 'llm_text',
+                            ts: new Date().toISOString(),
+                            sessionId,
+                            text: block.text.slice(0, 8000),
+                        });
                         if (opts.onText) {
                             try {
                                 await opts.onText(block.text);
@@ -245,7 +351,29 @@ export async function runAgent(prompt, opts) {
                             catch { /* streaming is best-effort */ }
                         }
                     }
+                    else if (block.type === 'thinking' && typeof block.thinking === 'string') {
+                        // Extended-thinking block — captured separately so the Run detail
+                        // page can render thinking distinctly from final text.
+                        writeEvent({
+                            kind: 'thinking',
+                            ts: new Date().toISOString(),
+                            sessionId,
+                            thinking: block.thinking.slice(0, 8000),
+                        });
+                    }
                     else if (block.type === 'tool_use' && typeof block.name === 'string') {
+                        // PRD Phase 4a: tool_call Event. The tool_use id pairs with the
+                        // tool_result Event written when the SDK reports back. Inputs
+                        // truncated at 8KB; the dashboard can fetch the full transcript
+                        // if a deeper drill-down is needed.
+                        writeEvent({
+                            kind: 'tool_call',
+                            ts: new Date().toISOString(),
+                            sessionId,
+                            toolName: block.name,
+                            toolUseId: block.id,
+                            toolInput: truncateForLog(block.input ?? {}, 8000),
+                        });
                         if (opts.onToolActivity) {
                             try {
                                 await opts.onToolActivity({ tool: block.name, input: block.input ?? {} });
@@ -256,6 +384,26 @@ export async function runAgent(prompt, opts) {
                 }
                 continue;
             }
+            // SDK user messages carry tool_result blocks back from tool execution.
+            // We pair them with the earlier tool_call Event via toolUseId so the
+            // Run detail waterfall renders call → result side by side.
+            if (message.type === 'user') {
+                const um = message;
+                const blocks = um.message?.content ?? [];
+                for (const block of blocks) {
+                    if (block.type === 'tool_result') {
+                        writeEvent({
+                            kind: 'tool_result',
+                            ts: new Date().toISOString(),
+                            sessionId,
+                            toolUseId: block.tool_use_id,
+                            toolResult: truncateForLog(block.content, 16000),
+                            ...(block.is_error ? { toolError: 'tool reported is_error' } : {}),
+                        });
+                    }
+                }
+                continue;
+            }
             if (message.type === 'result') {
                 const result = message;
                 sessionId = sessionId || (result.session_id ?? '');
@@ -271,6 +419,15 @@ export async function runAgent(prompt, opts) {
                     if (r)
                         finalText = r;
                 }
+                // PRD Phase 4a / 1.18.85: session_end Event — closes the run in the
+                // event store and stamps the cost + stop reason for the Run detail page.
+                writeEvent({
+                    kind: 'session_end',
+                    ts: new Date().toISOString(),
+                    sessionId,
+                    costUsd: totalCostUsd,
+                    stopReason: subtype,
+                });
                 // Mirror cost to usage_log. Same shape as the existing
                 // logQueryResult, but standalone so we don't depend on
                 // PersonalAssistant's instance state.
@@ -299,13 +456,22 @@ export async function runAgent(prompt, opts) {
         }
     }
     catch (err) {
+        // PRD Phase 4a / 1.18.85: error Event closes the run if the SDK throws.
+        // Lets the Run detail page render an explicit failure span instead of a
+        // run that just trails off after the last successful tool_call.
+        const errMsg = String(err?.message ?? err).slice(0, 1000);
+        writeEvent({
+            kind: 'error',
+            ts: new Date().toISOString(),
+            sessionId,
+            toolError: errMsg,
+        });
         // Translate the SDK's budget-exhaustion throw into a message that
         // tells the user (a) what cap tripped and (b) how to raise it.
         // The raw SDK string ("Claude Code returned an error result:
         // Reached maximum budget ($0.5)") leaks through the channel layer
         // as a generic "Something went wrong:" with no actionable hint.
-        const msg = String(err?.message ?? err);
-        if (/Reached maximum budget|error_max_budget_usd/i.test(msg)) {
+        if (/Reached maximum budget|error_max_budget_usd/i.test(errMsg)) {
             const cap = maxBudgetUsd?.toFixed(2) ?? '?';
             const envKey = `BUDGET_${source.toUpperCase().replace(/-/g, '_')}_USD`;
             throw new Error(`Hit the $${cap} ${source} budget cap before finishing. ` +
@@ -330,6 +496,7 @@ export async function runAgent(prompt, opts) {
         sessionId,
         subtype,
         ...(usage ? { usage } : {}),
+        runId,
     };
 }
 //# sourceMappingURL=run-agent.js.map

package/dist/cli/cron.js

@@ -140,6 +140,15 @@ export async function cmdCronRun(jobName) {
     try {
         const response = await gateway.handleCronJob(job.name, job.prompt, job.tier, job.maxTurns, job.model, job.workDir, job.mode, job.maxHours);
         const finishedAt = new Date();
+        // 1.18.84: trigger source comes from the CRON_RUN_TRIGGER env var set
+        // by the dashboard's manual-run endpoint. Defaults to 'scheduled' for
+        // any other invocation path (CLI, daemon-internal callsites).
+        const trigger = process.env.CRON_RUN_TRIGGER || 'scheduled';
+        // 1.18.85: pull the run UUID from the gateway's per-run metadata
+        // side-channel. runAgent stamps it; consume here to link CronRunEntry
+        // to the Event store.
+        const sideChannel = gateway.consumeLastCronRunMetadata?.();
+        const runIdFromGateway = sideChannel?.runId;
         const entry = {
             jobName: job.name,
             startedAt: startedAt.toISOString(),
@@ -148,6 +157,8 @@ export async function cmdCronRun(jobName) {
             durationMs: finishedAt.getTime() - startedAt.getTime(),
             attempt: 1,
             outputPreview: response ? response.slice(0, 200) : undefined,
+            trigger,
+            ...(runIdFromGateway ? { id: runIdFromGateway } : {}),
         };
         // PRD Phase 1.1: goal-orientation evaluator (mirrors the daemon path).
         if (job.successSchema || (job.successCriteriaText && job.successCriteriaText.trim())) {
@@ -170,6 +181,7 @@ export async function cmdCronRun(jobName) {
     }
     catch (err) {
         const finishedAt = new Date();
+        const trigger = process.env.CRON_RUN_TRIGGER || 'scheduled';
         runLog.append({
             jobName: job.name,
             startedAt: startedAt.toISOString(),
@@ -179,6 +191,7 @@ export async function cmdCronRun(jobName) {
             error: String(err).slice(0, 500),
             errorType: classifyError(err),
             attempt: 1,
+            trigger,
         });
         console.error(`Error: ${err}`);
         process.exit(1);

package/dist/cli/dashboard.js

@@ -4613,7 +4613,8 @@ export async function cmdDashboard(opts) {
                 detached: true,
                 stdio: ['ignore', 'pipe', 'pipe'],
                 cwd: BASE_DIR,
-                env: { ...process.env, CLEMENTINE_HOME: BASE_DIR },
+                // 1.18.84: pass the trigger source so cron.ts stamps it on the run entry.
+                env: { ...process.env, CLEMENTINE_HOME: BASE_DIR, CRON_RUN_TRIGGER: 'manual' },
             });
             // Capture stderr for error reporting
             let stderr = '';
@@ -5669,6 +5670,26 @@ If the tool returns nothing or errors, return an empty array \`[]\`.`,
             res.status(500).json({ error: String(err) });
         }
     });
+    // ── PRD Phase 4a / 1.18.85: per-run Event store reader ─────────
+    // Returns every event captured by path A (in-process tap in runAgent)
+    // for one run. Used by the new Run detail page (Phase 4b).
+    app.get('/api/runs/:runId/events', async (req, res) => {
+        try {
+            const rawId = req.params.runId;
+            const runId = Array.isArray(rawId) ? rawId[0] : rawId;
+            if (!runId || typeof runId !== 'string') {
+                res.status(400).json({ ok: false, error: 'runId required' });
+                return;
+            }
+            const { EventLog } = await import('../gateway/event-log.js');
+            const log = new EventLog();
+            const events = log.readByRun(runId);
+            res.json({ ok: true, runId, events });
+        }
+        catch (err) {
+            res.status(500).json({ ok: false, error: String(err) });
+        }
+    });
     // ── Recent runs across ALL cron jobs ───────────────────────────
     // Powers the "Recent History" zone on the Tasks page. Returns the most
     // recent N CronRunEntry rows merged from every per-job .jsonl, sorted
@@ -6675,6 +6696,24 @@ If the tool returns nothing or errors, return an empty array \`[]\`.`,
             if (purge) {
                 const safe = bareJobName.replace(/[^a-zA-Z0-9_-]/g, '_');
                 const runLog = path.join(BASE_DIR, 'cron', 'runs', `${safe}.jsonl`);
+                // Read run UUIDs BEFORE we drop the run log — the Event store is
+                // keyed by run UUID, not by job name, so the only way to know which
+                // event files to delete is by reading the JSONL first.
+                const runIdsToPurge = [];
+                try {
+                    if (existsSync(runLog)) {
+                        const lines = readFileSync(runLog, 'utf-8').trim().split('\n').filter(Boolean);
+                        for (const l of lines) {
+                            try {
+                                const entry = JSON.parse(l);
+                                if (entry && typeof entry.id === 'string' && entry.id)
+                                    runIdsToPurge.push(entry.id);
+                            }
+                            catch { /* skip malformed */ }
+                        }
+                    }
+                }
+                catch { /* non-fatal */ }
                 try {
                     if (existsSync(runLog)) {
                         unlinkSync(runLog);
@@ -6697,6 +6736,30 @@ If the tool returns nothing or errors, return an empty array \`[]\`.`,
                     }
                 }
                 catch { /* non-fatal */ }
+                // PRD Phase 4a / 1.18.85: drop the new Event store entries linked
+                // to this job's runs. One file per run UUID.
+                try {
+                    if (runIdsToPurge.length > 0) {
+                        const eventsDir = path.join(BASE_DIR, 'events');
+                        if (existsSync(eventsDir)) {
+                            let dropped = 0;
+                            for (const rid of runIdsToPurge) {
+                                const safeRid = String(rid).replace(/[^a-zA-Z0-9_-]/g, '_').slice(0, 128);
+                                const evtFile = path.join(eventsDir, `${safeRid}.jsonl`);
+                                try {
+                                    if (existsSync(evtFile)) {
+                                        unlinkSync(evtFile);
+                                        dropped++;
+                                    }
+                                }
+                                catch { /* skip */ }
+                            }
+                            if (dropped > 0)
+                                purged.push(`${dropped} event log${dropped === 1 ? '' : 's'}`);
+                        }
+                    }
+                }
+                catch { /* non-fatal */ }
                 try {
                     const uploadsDir = path.join(BASE_DIR, 'uploads', `cron-${safe}`);
                     if (existsSync(uploadsDir)) {
@@ -23811,12 +23874,13 @@ function renderRunListBody(allRuns) {
     var startedAt = entry.startedAt ? new Date(entry.startedAt) : null;
     var startedLabel = startedAt ? startedAt.toLocaleString() : '—';
     var durationLabel = entry.durationMs != null ? formatDurationMs(entry.durationMs) : '—';
-    // Trigger heuristic until we persist it for real (Phase 3.1):
-    //   'unleashed' mode + manual cron run = manual; otherwise scheduled.
-    // The cron-running.json sidecar already carries pid which can hint at
-    // manual but isn't on terminal entries. Best-effort label only.
-    var triggerLabel = entry.attempt > 1 ? 'retry' : 'scheduled';
-    var triggerColor = 'var(--text-muted)';
+    // 1.18.84: real persisted trigger field. Falls back to a heuristic for
+    // pre-1.18.84 run entries that don't have the field set.
+    var triggerLabel = entry.trigger || (entry.attempt > 1 ? 'retry' : 'scheduled');
+    var triggerColor = entry.trigger === 'manual' ? 'var(--accent)'
+      : entry.trigger === 'after' ? 'var(--purple)'
+      : entry.trigger === 'discord' ? 'var(--blue)'
+      : 'var(--text-muted)';
     // Goal cell
     var goalCell = '<div></div>';
     if (entry.goalCheck) {
@@ -23932,7 +23996,14 @@ async function refreshToolsMcpCatalog() {
   try {
     var sR = await apiFetch('/api/mcp-status');
     var statusJson = await sR.json();
-    statusMap = statusJson || {};
+    // /api/mcp-status returns { servers: [{name, status}], updatedAt }.
+    // Build a name → entry lookup so renderMcpCatalogCard can probe by name.
+    if (statusJson && Array.isArray(statusJson.servers)) {
+      for (var si = 0; si < statusJson.servers.length; si++) {
+        var entry = statusJson.servers[si];
+        if (entry && entry.name) statusMap[entry.name] = entry;
+      }
+    }
   } catch (e) { /* status is optional — servers still render without it */ }
   try {
     var lR = await apiFetch('/api/mcp-servers');

package/dist/gateway/cron-scheduler.js

@@ -888,7 +888,7 @@ export class CronScheduler {
             ctx.agentSlug = wf.agentSlug;
         return ctx;
     }
-    async runJob(job) {
+    async runJob(job, trigger = 'scheduled') {
         const creditBlock = getBackgroundCreditBlock();
         if (creditBlock) {
             logger.warn({ job: job.name, until: creditBlock.until }, 'Cron job skipped — Claude credit block active');
@@ -1206,6 +1206,10 @@ export class CronScheduler {
                         outputPreview: response ? response.slice(0, 200) : undefined,
                         advisorApplied,
                         terminalReason,
+                        // 1.18.84: persist the actual trigger source for the Run list filter.
+                        trigger,
+                        // 1.18.85: stable UUID linking this run to its Event store entries.
+                        ...(cronMetadata?.runId ? { id: cronMetadata.runId } : {}),
                         // 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 } : {}),
@@ -1268,7 +1272,8 @@ export class CronScheduler {
                     const dependents = this.jobs.filter(j => j.after === job.name && j.enabled && !this.disabledJobs.has(j.name));
                     for (const dep of dependents) {
                         logger.info(`Chain: '${job.name}' succeeded — triggering '${dep.name}'`);
-                        this.runJob(dep).catch((err) => {
+                        // 1.18.84: chained-after triggers carry trigger='after' for the Run list filter.
+                        this.runJob(dep, 'after').catch((err) => {
                             logger.error({ err, job: dep.name }, `Chained job '${dep.name}' failed`);
                         });
                     }

package/dist/gateway/event-log.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Per-run event log — PRD §6 / Phase 4a.
+ *
+ * Stores RunEvent rows as JSONL at ~/.clementine/events/<runId>.jsonl,
+ * mirroring the existing CronRunLog pattern (auto-prune at 2MB / 2000 lines).
+ * One file per run keeps reads cheap (no scanning unrelated runs) and lets
+ * the Run detail page tail a single file for live updates.
+ *
+ * Writers:
+ *   - In-process tap in runAgent (path A) writes session_start, llm_text,
+ *     thinking, tool_call, tool_result, session_end during the SDK stream.
+ *   - Hook side-channel (path B, Phase 4d) writes hook events.
+ *   - Subagent backfill (path C, Phase 4e) synthesizes tool_call/tool_result
+ *     for inner SDK calls that don't fire parent-level hooks.
+ *
+ * Reader: dashboard's Run detail page via /api/runs/:run_id/events.
+ */
+import type { RunEvent } from '../types.js';
+export declare class EventLog {
+    private readonly dir;
+    private static readonly MAX_BYTES;
+    private static readonly MAX_LINES;
+    constructor(baseDir?: string);
+    private logPath;
+    append(event: RunEvent): void;
+    /** Read every event for one run, in seq order. */
+    readByRun(runId: string): RunEvent[];
+    /** Returns true if any events were captured for the run. Cheap existence check. */
+    hasEventsForRun(runId: string): boolean;
+    /** Drop one run's entire log. Called from cron-delete cascade cleanup. */
+    removeRun(runId: string): boolean;
+    /** Total disk size of all event logs in bytes. For diagnostics. */
+    totalBytes(): number;
+    private maybePrune;
+}
+//# sourceMappingURL=event-log.d.ts.map

package/dist/gateway/event-log.js

@@ -0,0 +1,136 @@
+/**
+ * Per-run event log — PRD §6 / Phase 4a.
+ *
+ * Stores RunEvent rows as JSONL at ~/.clementine/events/<runId>.jsonl,
+ * mirroring the existing CronRunLog pattern (auto-prune at 2MB / 2000 lines).
+ * One file per run keeps reads cheap (no scanning unrelated runs) and lets
+ * the Run detail page tail a single file for live updates.
+ *
+ * Writers:
+ *   - In-process tap in runAgent (path A) writes session_start, llm_text,
+ *     thinking, tool_call, tool_result, session_end during the SDK stream.
+ *   - Hook side-channel (path B, Phase 4d) writes hook events.
+ *   - Subagent backfill (path C, Phase 4e) synthesizes tool_call/tool_result
+ *     for inner SDK calls that don't fire parent-level hooks.
+ *
+ * Reader: dashboard's Run detail page via /api/runs/:run_id/events.
+ */
+import { appendFileSync, existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import pino from 'pino';
+import { BASE_DIR } from '../config.js';
+const logger = pino({ name: 'clementine.event-log', level: process.env.LOG_LEVEL ?? 'info' });
+export class EventLog {
+    dir;
+    static MAX_BYTES = 2_000_000;
+    static MAX_LINES = 2000;
+    constructor(baseDir) {
+        this.dir = path.join(baseDir ?? BASE_DIR, 'events');
+        if (!existsSync(this.dir)) {
+            mkdirSync(this.dir, { recursive: true });
+        }
+    }
+    logPath(runId) {
+        // Sanitize runId for filesystem — UUIDs are safe but we defend against
+        // accidental non-UUID values flowing in from older callsites.
+        const safe = String(runId).replace(/[^a-zA-Z0-9_-]/g, '_').slice(0, 128);
+        return path.join(this.dir, `${safe}.jsonl`);
+    }
+    append(event) {
+        if (!event.runId) {
+            logger.warn({ event: { kind: event.kind, ts: event.ts } }, 'Event missing runId — dropped');
+            return;
+        }
+        const filePath = this.logPath(event.runId);
+        const line = JSON.stringify(event) + '\n';
+        try {
+            appendFileSync(filePath, line);
+            // Prune asynchronously so the SDK stream loop never blocks on disk IO.
+            setImmediate(() => this.maybePrune(filePath));
+        }
+        catch (err) {
+            // Never throw to the caller — telemetry must not break runs.
+            logger.warn({ err, runId: event.runId }, 'Failed to write event log');
+        }
+    }
+    /** Read every event for one run, in seq order. */
+    readByRun(runId) {
+        const filePath = this.logPath(runId);
+        if (!existsSync(filePath))
+            return [];
+        try {
+            const lines = readFileSync(filePath, 'utf-8').trim().split('\n').filter(Boolean);
+            const events = lines
+                .map((l) => {
+                try {
+                    return JSON.parse(l);
+                }
+                catch {
+                    return null;
+                }
+            })
+                .filter((e) => e !== null);
+            // Sort by seq so events with the same ts (sub-millisecond bursts) order
+            // deterministically.
+            events.sort((a, b) => (a.seq ?? 0) - (b.seq ?? 0));
+            return events;
+        }
+        catch {
+            return [];
+        }
+    }
+    /** Returns true if any events were captured for the run. Cheap existence check. */
+    hasEventsForRun(runId) {
+        return existsSync(this.logPath(runId));
+    }
+    /** Drop one run's entire log. Called from cron-delete cascade cleanup. */
+    removeRun(runId) {
+        const filePath = this.logPath(runId);
+        if (!existsSync(filePath))
+            return false;
+        try {
+            writeFileSync(filePath, ''); // truncate, then unlink — symmetric with cron-runs delete pattern
+            const fs = require('node:fs');
+            fs.unlinkSync(filePath);
+            return true;
+        }
+        catch (err) {
+            logger.warn({ err, runId }, 'Failed to remove event log');
+            return false;
+        }
+    }
+    /** Total disk size of all event logs in bytes. For diagnostics. */
+    totalBytes() {
+        if (!existsSync(this.dir))
+            return 0;
+        let total = 0;
+        try {
+            for (const f of readdirSync(this.dir)) {
+                if (!f.endsWith('.jsonl'))
+                    continue;
+                try {
+                    total += statSync(path.join(this.dir, f)).size;
+                }
+                catch { /* skip */ }
+            }
+        }
+        catch { /* skip */ }
+        return total;
+    }
+    maybePrune(filePath) {
+        try {
+            const { size } = statSync(filePath);
+            if (size <= EventLog.MAX_BYTES)
+                return;
+            const lines = readFileSync(filePath, 'utf-8').trim().split('\n');
+            if (lines.length <= EventLog.MAX_LINES)
+                return;
+            const trimmed = lines.slice(-EventLog.MAX_LINES);
+            writeFileSync(filePath, trimmed.join('\n') + '\n');
+        }
+        catch {
+            // non-critical
+        }
+    }
+}
+//# sourceMappingURL=event-log.js.map

package/dist/gateway/router.d.ts

@@ -237,6 +237,8 @@ export declare class Gateway {
         skillsMissing: string[];
         allowedToolsApplied?: string[];
         mcpServersApplied: string[];
+        /** PRD §6 / 1.18.85: run UUID from runAgent. */
+        runId?: string;
     } | undefined;
     requestApproval(descriptionOrId: string, explicitId?: string): Promise<boolean | string>;
     resolveApproval(requestId: string, result: boolean | string): void;

package/dist/gateway/router.js

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

package/dist/types.d.ts

@@ -404,7 +404,55 @@ export interface LongTaskPreflightSnapshot {
     reasons: string[];
 }
 export type TerminalReason = 'blocking_limit' | 'rapid_refill_breaker' | 'prompt_too_long' | 'image_error' | 'model_error' | 'aborted_streaming' | 'aborted_tools' | 'stop_hook_prevented' | 'hook_stopped' | 'tool_deferred' | 'max_turns' | 'completed';
+/**
+ * PRD §6 Event entity — one row per significant SDK message during a Run.
+ * Stored as JSONL at ~/.clementine/events/<run_id>.jsonl. Powers the new
+ * Run detail waterfall (Phase 4b) and the metrics dashboards (Phase 6).
+ *
+ * Designed to fit the SDK's typed message stream + the 12 hook events. Most
+ * fields are optional because each event kind populates a different subset.
+ */
+export interface RunEvent {
+    /** Run this event belongs to — links back to CronRunEntry.id. */
+    runId: string;
+    /** SDK session id once known (system/init lands first; everything else carries it). */
+    sessionId?: string;
+    /** Monotonic sequence within the run. Used to order events that share a ts. */
+    seq: number;
+    /** ISO timestamp when the event was captured. */
+    ts: string;
+    /** Event kind — semantic grouping for the dashboard's span types. */
+    kind: 'session_start' | 'session_end' | 'llm_text' | 'thinking' | 'tool_call' | 'tool_result' | 'subagent_start' | 'subagent_stop' | 'rate_limit' | 'hook' | 'error';
+    /** Hook event name when kind='hook' (PreToolUse / PostToolUse / etc.). */
+    hookEventName?: string;
+    /** Tool name when kind='tool_call' or 'tool_result'. Includes mcp__ prefix. */
+    toolName?: string;
+    /** SDK-assigned tool_use id — pairs tool_call with its tool_result. */
+    toolUseId?: string;
+    /** For nested tool calls (parallel sub-spawning). */
+    parentToolUseId?: string;
+    /** Tool input as JSON, truncated at 8KB. */
+    toolInput?: unknown;
+    /** Tool result as JSON or string, truncated at 16KB. */
+    toolResult?: unknown;
+    /** Tool error message when result.is_error or PostToolUseFailure. */
+    toolError?: string;
+    /** Assistant text block content when kind='llm_text'. */
+    text?: string;
+    /** ThinkingBlock content when kind='thinking'. */
+    thinking?: string;
+    /** Cost so far for this run when kind='session_end'. */
+    costUsd?: number;
+    /** Stop reason from ResultMessage when kind='session_end'. */
+    stopReason?: string;
+    /** Subagent id when kind='subagent_*'. */
+    agentId?: string;
+}
 export interface CronRunEntry {
+    /** PRD §6 / 1.18.85: stable run UUID. Optional only because pre-1.18.85
+     *  entries don't have it; new entries always do. The Event store keys
+     *  off this id. */
+    id?: string;
     jobName: string;
     startedAt: string;
     /** Optional: in-progress runs are appended with status='running' before the
@@ -447,6 +495,11 @@ export interface CronRunEntry {
     allowedToolsApplied?: string[];
     /** MCP servers live for this run (post profile + trick allowlist intersection). */
     mcpServersApplied?: string[];
+    /** PRD §6 / 1.18.84: how this run was triggered. Persisted by the
+     *  scheduler (cron tick / chained 'after' / manual-run endpoint /
+     *  Discord) so the Run list can filter by source instead of guessing
+     *  via heuristics on attempt count. */
+    trigger?: 'manual' | 'scheduled' | 'webhook' | 'api' | 'fork' | 'resume' | 'discord' | 'after';
     /** 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.83",
+  "version": "1.18.85",
   "description": "Clementine — Personal AI Assistant (TypeScript)",
   "type": "module",
   "main": "dist/index.js",