feat: add Kimi & Perplexity as visible Workshop agents (#11 )

- agent-defs.js: add Kimi (Long Context Analysis, cyan) and Perplexity (Real-time Research, pink) with world positions at (-10,-10) and (10,-10) - agents.js: add 3D geometric bodies for both agents — Kimi as an octahedron with orbital rings, Perplexity as an icosahedron with scanning tori; idle/active/dormant animations driven by agent state; restrict Timmy mood derivation to workshop agents only - hud-labels.js: show specialization and last-task summary in inspect popup; export setLabelLastTask() for WS updates - websocket.js: handle agent_task_summary messages; call setLabelLastTask on job_completed events - world-state.ts: add kimi and perplexity to initial agentStates; restrict _deriveTimmy() to workshop agents only - event-bus.ts: add AgentExternalEvent type for external agent state changes - events.ts: handle agent:external_state bus events, broadcast agent_state and agent_task_summary WS messages Fixes #11 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
[claude] Mobile: Job history tab showing completed jobs (#31 ) (#107 )
2026-03-23 22:38:09 -04:00 · 2026-03-24 02:26:13 +00:00 · 2026-03-24 02:20:34 +00:00
12 changed files with 550 additions and 14 deletions
--- a/artifacts/api-server/src/lib/event-bus.ts
+++ b/artifacts/api-server/src/lib/event-bus.ts
@@ -21,7 +21,11 @@ export type CostEvent =
 export type CommentaryEvent =
  | { type: "agent_commentary"; agentId: string; jobId: string; text: string };

-export type BusEvent = JobEvent | SessionEvent | DebateEvent | CostEvent | CommentaryEvent;
+// External agent state changes (e.g. Kimi, Perplexity picking up or completing tasks)
+export type AgentExternalEvent =
+  | { type: "agent:external_state"; agentId: string; state: string; taskSummary?: string };
+
+export type BusEvent = JobEvent | SessionEvent | DebateEvent | CostEvent | CommentaryEvent | AgentExternalEvent;

 class EventBus extends EventEmitter {
  emit(event: "bus", data: BusEvent): boolean;
--- a/artifacts/api-server/src/lib/world-state.ts
+++ b/artifacts/api-server/src/lib/world-state.ts
@@ -16,7 +16,7 @@ const DEFAULT_TIMMY: TimmyState = {

 const _state: WorldState = {
  timmyState: { ...DEFAULT_TIMMY },
-  agentStates: { alpha: "idle", beta: "idle", gamma: "idle", delta: "idle" },
+  agentStates: { alpha: "idle", beta: "idle", gamma: "idle", delta: "idle", kimi: "idle", perplexity: "idle" },
  updatedAt: new Date().toISOString(),
 };

@@ -34,8 +34,10 @@ export function setAgentStateInWorld(agentId: string, agentState: string): void
  _deriveTimmy();
 }

+const WORKSHOP_AGENTS = ["alpha", "beta", "gamma", "delta"];
+
 function _deriveTimmy(): void {
-  const states = Object.values(_state.agentStates);
+  const states = WORKSHOP_AGENTS.map(id => _state.agentStates[id] ?? "idle");
  if (states.includes("working")) {
    _state.timmyState.activity = "working";
    _state.timmyState.mood = "focused";
--- a/artifacts/api-server/src/routes/events.ts
+++ b/artifacts/api-server/src/routes/events.ts
@@ -269,6 +269,21 @@ function translateEvent(ev: BusEvent): object | null {
        text: ev.text,
      };

+    // ── External agent state (Kimi, Perplexity) (#11) ─────────────────────────
+    case "agent:external_state": {
+      updateAgentWorld(ev.agentId, ev.state);
+      void logWorldEvent(
+        `agent:${ev.state}`,
+        `${ev.agentId} is now ${ev.state}${ev.taskSummary ? `: ${ev.taskSummary.slice(0, 80)}` : ""}`,
+        ev.agentId,
+      );
+      const msgs: object[] = [{ type: "agent_state", agentId: ev.agentId, state: ev.state }];
+      if (ev.taskSummary) {
+        msgs.push({ type: "agent_task_summary", agentId: ev.agentId, summary: ev.taskSummary });
+      }
+      return msgs;
+    }
+
    default:
      return null;
  }
--- a/the-matrix/index.html
+++ b/the-matrix/index.html
@@ -599,6 +599,109 @@
      #activity-heatmap #heatmap-bar { display: none; }
      #heatmap-icon-btn { display: block; }
    }
+
+    /* ── History button ──────────────────────────────────────────────── */
+    #open-history-btn {
+      font-family: 'Courier New', monospace; font-size: 11px; font-weight: bold;
+      color: #aabbdd; background: rgba(20, 16, 50, 0.85); border: 1px solid #2a2a44;
+      padding: 7px 18px; cursor: pointer; letter-spacing: 2px;
+      box-shadow: 0 0 14px #2244aa22;
+      transition: background 0.15s, box-shadow 0.15s, color 0.15s;
+      border-radius: 2px;
+      min-height: 36px;
+    }
+    #open-history-btn:hover, #open-history-btn:active {
+      background: rgba(35, 28, 80, 0.95);
+      box-shadow: 0 0 20px #3355aa44;
+      color: #ccddff;
+    }
+
+    /* ── History panel (bottom sheet) ───────────────────────────────── */
+    #history-panel {
+      position: fixed; bottom: -100%; left: 0; right: 0;
+      height: 70vh;
+      background: rgba(5, 3, 12, 0.97);
+      border-top: 1px solid #1a1a2e;
+      z-index: 100;
+      font-family: 'Courier New', monospace;
+      transition: bottom 0.35s cubic-bezier(0.4, 0, 0.2, 1);
+      box-shadow: 0 -8px 32px rgba(40, 60, 120, 0.18);
+      display: flex; flex-direction: column;
+    }
+    #history-panel.open { bottom: 60px; }
+
+    .hist-header {
+      display: flex; align-items: center; gap: 8px;
+      padding: 14px 20px 10px;
+      border-bottom: 1px solid #1a1a2e;
+      font-size: 12px; letter-spacing: 3px; color: #5577aa;
+      flex-shrink: 0;
+    }
+    .hist-header span { flex: 1; text-shadow: 0 0 8px #2244aa66; }
+    #history-refresh-btn, #history-close {
+      background: transparent; border: 1px solid #1a1a2e;
+      color: #334466; font-family: 'Courier New', monospace;
+      font-size: 11px; padding: 3px 10px; cursor: pointer;
+      transition: color 0.2s, border-color 0.2s; letter-spacing: 1px;
+      border-radius: 2px;
+    }
+    #history-refresh-btn:hover { color: #5577aa; border-color: #334466; }
+    #history-refresh-btn:disabled { opacity: 0.4; cursor: default; }
+    #history-close { font-size: 14px; padding: 3px 8px; }
+    #history-close:hover { color: #6688bb; border-color: #4466aa; }
+
+    #history-list {
+      flex: 1; overflow-y: auto; padding: 12px 16px;
+      overscroll-behavior: contain;
+    }
+
+    .hist-empty {
+      color: #334466; font-size: 11px; letter-spacing: 1px;
+      line-height: 1.8; text-align: center;
+      margin-top: 40px; padding: 0 20px;
+    }
+
+    .hist-row {
+      border: 1px solid #1a1a2e; border-radius: 2px;
+      margin-bottom: 10px; overflow: hidden;
+      background: #060310;
+    }
+    .hist-row.hist-rejected { border-color: #331111; }
+    .hist-row-header {
+      padding: 10px 12px; cursor: pointer;
+      transition: background 0.15s;
+    }
+    .hist-row-header:hover { background: rgba(30, 25, 60, 0.6); }
+    .hist-prompt {
+      color: #aabbdd; font-size: 12px; line-height: 1.5;
+      display: -webkit-box; -webkit-line-clamp: 2;
+      -webkit-box-orient: vertical; overflow: hidden;
+      margin-bottom: 6px;
+    }
+    .hist-meta {
+      display: flex; gap: 12px; align-items: center;
+    }
+    .hist-cost { font-size: 10px; color: #ffcc44; letter-spacing: 1px; }
+    .hist-rejected .hist-cost { color: #994444; }
+    .hist-time { font-size: 10px; color: #334466; letter-spacing: 0.5px; flex: 1; }
+    .hist-chevron { font-size: 10px; color: #334466; transition: color 0.15s; }
+    .hist-row-header:hover .hist-chevron { color: #5577aa; }
+
+    .hist-row-body {
+      max-height: 0; overflow: hidden;
+      transition: max-height 0.3s ease-out;
+    }
+    .hist-row.expanded .hist-row-body {
+      max-height: 400px;
+      border-top: 1px solid #1a1a2e;
+    }
+    .hist-result {
+      color: #aabbdd; font-family: 'Courier New', monospace;
+      font-size: 11px; line-height: 1.6;
+      white-space: pre-wrap; word-break: break-word;
+      padding: 12px; margin: 0;
+      max-height: 400px; overflow-y: auto;
+    }
  </style>
 </head>
 <body>
@@ -640,6 +743,7 @@
  <div id="top-buttons">
    <button id="open-panel-btn">⚡ SUBMIT JOB</button>
    <button id="open-session-btn">⚡ FUND SESSION</button>
+    <button id="open-history-btn">⏱ HISTORY</button>
    <a id="relay-admin-btn" href="/admin/relay">⚙ RELAY ADMIN</a>
  </div>

@@ -789,6 +893,16 @@
    <div id="session-error"></div>
  </div>

+  <!-- ── History panel (bottom sheet) ─────────────────────────────── -->
+  <div id="history-panel">
+    <div class="hist-header">
+      <span>⏱ JOB HISTORY</span>
+      <button id="history-refresh-btn">↺ REFRESH</button>
+      <button id="history-close">✕</button>
+    </div>
+    <div id="history-list"></div>
+  </div>
+
  <!-- ── FPS crosshair ─────────────────────────────────────────────── -->
  <div id="crosshair"></div>

--- a/the-matrix/js/agent-defs.js
+++ b/the-matrix/js/agent-defs.js
@@ -5,18 +5,27 @@
 * unused (x, z) position. No other file needs to be edited.
 *
 * Fields:
- *   id        — unique string key used in WebSocket messages and state maps
- *   label     — display name shown in the 3D HUD and chat panel
- *   color     — hex integer (0xRRGGBB) used for Three.js materials and lights
- *   role      — human-readable role string shown under the label sprite
- *   direction — cardinal facing direction (for future mesh orientation use)
- *   x, z      — world-space position on the horizontal plane (y is always 0)
+ *   id             — unique string key used in WebSocket messages and state maps
+ *   label          — display name shown in the 3D HUD and chat panel
+ *   color          — hex integer (0xRRGGBB) used for Three.js materials and lights
+ *   role           — human-readable role string shown under the label sprite
+ *   specialization — optional capability description shown in agent inspect card
+ *   direction      — cardinal facing direction (for future mesh orientation use)
+ *   x, z           — world-space position on the horizontal plane (y is always 0)
 */
 export const AGENT_DEFS = [
  { id: 'alpha', label: 'ALPHA', color: 0x00ff88, role: 'orchestrator', direction: 'north', x:  0, z: -6 },
  { id: 'beta',  label: 'BETA',  color: 0x00aaff, role: 'worker',       direction: 'east',  x:  6, z:  0 },
  { id: 'gamma', label: 'GAMMA', color: 0xff6600, role: 'validator',    direction: 'south', x:  0, z:  6 },
  { id: 'delta', label: 'DELTA', color: 0xaa00ff, role: 'monitor',      direction: 'west',  x: -6, z:  0 },
+  {
+    id: 'kimi', label: 'KIMI', color: 0x00d4ff, role: 'analyst',
+    specialization: 'Long Context Analysis', direction: 'northwest', x: -10, z: -10,
+  },
+  {
+    id: 'perplexity', label: 'PERPLEXITY', color: 0xff6b9d, role: 'researcher',
+    specialization: 'Real-time Research', direction: 'northeast', x: 10, z: -10,
+  },
 ];

 /**
--- a/the-matrix/js/agents.js
+++ b/the-matrix/js/agents.js
@@ -7,10 +7,13 @@ const CRYSTAL_POS = new THREE.Vector3(0.6, 1.15, -4.1);

 const agentStates = Object.fromEntries(AGENT_DEFS.map(d => [d.id, 'idle']));

+// Workshop agents that drive Timmy's mood (excludes external agents Kimi/Perplexity)
+const WORKSHOP_AGENT_IDS = ['alpha', 'beta', 'gamma', 'delta'];
+
 function deriveTimmyState() {
  if (agentStates.gamma === 'working') return 'working';
  if (agentStates.beta === 'thinking' || agentStates.alpha === 'thinking') return 'thinking';
-  if (Object.values(agentStates).some(s => s !== 'idle')) return 'active';
+  if (WORKSHOP_AGENT_IDS.some(id => agentStates[id] !== 'idle')) return 'active';
  return 'idle';
 }

@@ -97,9 +100,108 @@ function _pickMouthGeo(smileAmount) {

 // ── Build Timmy ───────────────────────────────────────────────────────────────

+// ── External agent bodies (Kimi, Perplexity) ──────────────────────────────────
+const _extBodies = {};
+
 export function initAgents(sceneRef) {
  scene = sceneRef;
  timmy = buildTimmy(scene);
+  _initKimiBody(scene);
+  _initPerplexityBody(scene);
+}
+
+function _initKimiBody(sc) {
+  const group = new THREE.Group();
+  group.position.set(-10, 1.2, -10);
+
+  const mat = new THREE.MeshStandardMaterial({
+    color: 0x00d4ff, emissive: 0x004466, emissiveIntensity: 0.4,
+    roughness: 0.15, metalness: 0.4,
+  });
+  const core = new THREE.Mesh(new THREE.OctahedronGeometry(0.38, 0), mat);
+  group.add(core);
+
+  const ringMat = new THREE.MeshStandardMaterial({
+    color: 0x00d4ff, emissive: 0x0088aa, emissiveIntensity: 0.6,
+    roughness: 0.1, metalness: 0.6, transparent: true, opacity: 0.7,
+  });
+  const ring1 = new THREE.Mesh(new THREE.TorusGeometry(0.60, 0.025, 6, 32), ringMat);
+  ring1.rotation.x = Math.PI / 3;
+  group.add(ring1);
+
+  const ring2 = new THREE.Mesh(new THREE.TorusGeometry(0.76, 0.018, 6, 32), ringMat.clone());
+  ring2.rotation.x = Math.PI / 2;
+  ring2.rotation.z = Math.PI / 4;
+  group.add(ring2);
+
+  const light = new THREE.PointLight(0x00d4ff, 0.5, 8);
+  group.add(light);
+
+  sc.add(group);
+  _extBodies.kimi = { group, core, ring1, ring2, light, mat, pulsePhase: Math.random() * Math.PI * 2 };
+}
+
+function _initPerplexityBody(sc) {
+  const group = new THREE.Group();
+  group.position.set(10, 1.2, -10);
+
+  const mat = new THREE.MeshStandardMaterial({
+    color: 0xff6b9d, emissive: 0x660033, emissiveIntensity: 0.4,
+    roughness: 0.2, metalness: 0.3,
+  });
+  const core = new THREE.Mesh(new THREE.IcosahedronGeometry(0.32, 0), mat);
+  group.add(core);
+
+  const scanMat = new THREE.MeshStandardMaterial({
+    color: 0xff6b9d, emissive: 0xaa2255, emissiveIntensity: 0.7,
+    roughness: 0.1, metalness: 0.5, transparent: true, opacity: 0.65,
+  });
+  const scanRings = [0, Math.PI / 3, -Math.PI / 3].map(angle => {
+    const r = new THREE.Mesh(new THREE.TorusGeometry(0.55, 0.022, 6, 28), scanMat.clone());
+    r.rotation.x = Math.PI / 2 + angle;
+    r.rotation.z = angle * 0.5;
+    group.add(r);
+    return r;
+  });
+
+  const light = new THREE.PointLight(0xff6b9d, 0.5, 8);
+  group.add(light);
+
+  sc.add(group);
+  _extBodies.perplexity = { group, core, scanRings, light, mat, pulsePhase: Math.random() * Math.PI * 2 };
+}
+
+function _updateExtBodies(t) {
+  _updateExtBody('kimi', t);
+  _updateExtBody('perplexity', t);
+}
+
+function _updateExtBody(id, t) {
+  const body = _extBodies[id];
+  if (!body) return;
+  const state = agentStates[id] || 'idle';
+  const isActive   = state === 'working' || state === 'active';
+  const isThinking = state === 'thinking';
+
+  const speedMult = isActive ? 2.5 : isThinking ? 1.5 : 0.6;
+  const emissI    = isActive ? 1.2 : isThinking ? 0.7 : 0.25;
+  const lightI    = isActive ? 1.2 : isThinking ? 0.6 : 0.2;
+  const bobAmp    = isActive ? 0.10 : 0.04;
+
+  body.group.position.y = 1.2 + Math.sin(t * 0.0008 + body.pulsePhase) * bobAmp;
+  body.mat.emissiveIntensity = emissI;
+  body.light.intensity = lightI;
+
+  if (id === 'kimi') {
+    body.core.rotation.y += 0.008 * speedMult;
+    body.core.rotation.x += 0.003 * speedMult;
+    body.ring1.rotation.z += 0.012 * speedMult;
+    body.ring2.rotation.x += 0.007 * speedMult;
+  } else {
+    body.core.rotation.y += 0.006 * speedMult;
+    body.core.rotation.z += 0.009 * speedMult;
+    body.scanRings.forEach((r, i) => { r.rotation.y += (0.015 + i * 0.008) * speedMult; });
+  }
 }

 function buildTimmy(sc) {
@@ -417,6 +519,7 @@ export function updateAgents(time) {
  const t = time * 0.001;
  const dt = _lastFrameTime > 0 ? Math.min((time - _lastFrameTime) * 0.001, 0.05) : 0.016;
  _lastFrameTime = time;
+  _updateExtBodies(time);

  const vs = deriveTimmyState();
  const pulse = Math.sin(t * 1.8 + timmy.pulsePhase);
@@ -889,5 +992,19 @@ export function disposeAgents() {
  timmy.bubbleTex?.dispose();
  timmy.bubbleMat?.dispose();
  timmy = null;
+
+  // Dispose external agent bodies
+  for (const body of Object.values(_extBodies)) {
+    body.group.traverse(obj => {
+      if (obj.geometry) obj.geometry.dispose();
+      if (obj.material) {
+        const mats = Array.isArray(obj.material) ? obj.material : [obj.material];
+        mats.forEach(m => m.dispose());
+      }
+    });
+    if (scene) scene.remove(body.group);
+  }
+  for (const k of Object.keys(_extBodies)) delete _extBodies[k];
+
  scene = null;
 }
--- a/the-matrix/js/history.js
+++ b/the-matrix/js/history.js
@@ -0,0 +1,222 @@
+/**
+ * history.js — Job history panel for Timmy Tower Workshop.
+ *
+ * Persists completed jobs in localStorage and renders them in a
+ * bottom-sheet panel with expandable results and pull-to-refresh.
+ *
+ * Public API:
+ *   addHistoryEntry(entry)   — called by payment.js / session.js on completion
+ *   initHistoryPanel()       — wire up DOM (call once from main.js)
+ */
+
+const LS_KEY      = 'timmy_history_v1';
+const MAX_ENTRIES = 50;
+
+// ── Persistence ───────────────────────────────────────────────────────────────
+
+function _loadEntries() {
+  try {
+    const raw = localStorage.getItem(LS_KEY);
+    return raw ? JSON.parse(raw) : [];
+  } catch {
+    return [];
+  }
+}
+
+function _saveEntries(entries) {
+  try {
+    localStorage.setItem(LS_KEY, JSON.stringify(entries));
+  } catch { /* storage full — oldest already trimmed */ }
+}
+
+/**
+ * Record a completed job.
+ * @param {object} entry
+ * @param {string} entry.jobId
+ * @param {string} entry.request      — user prompt
+ * @param {number} entry.costSats     — sats charged (0 for free/session)
+ * @param {string} entry.result       — AI answer or rejection reason
+ * @param {string} entry.state        — 'complete' | 'rejected' | 'failed'
+ * @param {string} [entry.completedAt] — ISO timestamp (defaults to now)
+ */
+export function addHistoryEntry({ jobId, request, costSats, result, state, completedAt }) {
+  const entries = _loadEntries();
+  const entry = {
+    jobId:       jobId       ?? `local-${Date.now()}`,
+    request:     request     ?? '',
+    costSats:    costSats    ?? 0,
+    result:      result      ?? '',
+    state:       state       ?? 'complete',
+    completedAt: completedAt ?? new Date().toISOString(),
+  };
+  const idx = entries.findIndex(e => e.jobId === entry.jobId);
+  if (idx >= 0) {
+    entries[idx] = entry;
+  } else {
+    entries.unshift(entry); // newest first
+    if (entries.length > MAX_ENTRIES) entries.length = MAX_ENTRIES;
+  }
+  _saveEntries(entries);
+}
+
+// ── Helpers ───────────────────────────────────────────────────────────────────
+
+function _relativeTime(isoString) {
+  try {
+    const diff = Date.now() - new Date(isoString).getTime();
+    const secs = Math.floor(diff / 1000);
+    if (secs < 60)  return `${secs}s ago`;
+    const mins = Math.floor(secs / 60);
+    if (mins < 60)  return `${mins} min ago`;
+    const hrs  = Math.floor(mins / 60);
+    if (hrs  < 24)  return `${hrs}h ago`;
+    const days = Math.floor(hrs  / 24);
+    return `${days}d ago`;
+  } catch {
+    return '';
+  }
+}
+
+function _escHtml(text) {
+  return String(text)
+    .replace(/&/g, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;');
+}
+
+function _truncate(text, maxLen) {
+  if (!text) return '';
+  return text.length > maxLen ? text.slice(0, maxLen) + '…' : text;
+}
+
+// ── Rendering ─────────────────────────────────────────────────────────────────
+
+function _renderEntries(entries, container) {
+  container.innerHTML = '';
+
+  if (!entries.length) {
+    const empty = document.createElement('div');
+    empty.className = 'hist-empty';
+    empty.textContent = 'No completed jobs yet. Submit a job to see your history here.';
+    container.appendChild(empty);
+    return;
+  }
+
+  entries.forEach(entry => {
+    const row = document.createElement('div');
+    row.className = 'hist-row' + (entry.state === 'rejected' ? ' hist-rejected' : '');
+
+    // ── Header (always visible) ────────────────────────────────────────────
+    const header = document.createElement('div');
+    header.className = 'hist-row-header';
+
+    const promptEl = document.createElement('div');
+    promptEl.className = 'hist-prompt';
+    promptEl.textContent = _truncate(entry.request, 140);
+
+    const metaEl = document.createElement('div');
+    metaEl.className = 'hist-meta';
+
+    const costEl = document.createElement('span');
+    costEl.className = 'hist-cost';
+    if (entry.state === 'rejected') {
+      costEl.textContent = 'rejected';
+    } else if (entry.costSats > 0) {
+      costEl.textContent = `⚡ ${entry.costSats} sats`;
+    } else {
+      costEl.textContent = 'free';
+    }
+
+    const timeEl = document.createElement('span');
+    timeEl.className = 'hist-time';
+    timeEl.textContent = _relativeTime(entry.completedAt);
+
+    const chevronEl = document.createElement('span');
+    chevronEl.className = 'hist-chevron';
+    chevronEl.textContent = '▸';
+
+    metaEl.appendChild(costEl);
+    metaEl.appendChild(timeEl);
+    metaEl.appendChild(chevronEl);
+
+    header.appendChild(promptEl);
+    header.appendChild(metaEl);
+
+    // ── Body (expandable) ──────────────────────────────────────────────────
+    const body = document.createElement('div');
+    body.className = 'hist-row-body';
+
+    const pre = document.createElement('pre');
+    pre.className = 'hist-result';
+    pre.textContent = entry.result || '(no result)';
+    body.appendChild(pre);
+
+    // ── Toggle ─────────────────────────────────────────────────────────────
+    let expanded = false;
+    header.addEventListener('click', () => {
+      expanded = !expanded;
+      row.classList.toggle('expanded', expanded);
+      chevronEl.textContent = expanded ? '▾' : '▸';
+    });
+
+    row.appendChild(header);
+    row.appendChild(body);
+    container.appendChild(row);
+  });
+}
+
+// ── Panel state ───────────────────────────────────────────────────────────────
+
+let _panel      = null;
+let _list       = null;
+let _refreshBtn = null;
+
+function _open() {
+  if (!_panel) return;
+  _panel.classList.add('open');
+  _refresh();
+}
+
+function _close() {
+  _panel?.classList.remove('open');
+}
+
+function _refresh() {
+  if (!_list) return;
+  const entries = _loadEntries();
+  _renderEntries(entries, _list);
+  if (_refreshBtn) {
+    _refreshBtn.textContent = '↺ REFRESH';
+    _refreshBtn.disabled = false;
+  }
+}
+
+export function initHistoryPanel() {
+  _panel      = document.getElementById('history-panel');
+  _list       = document.getElementById('history-list');
+  _refreshBtn = document.getElementById('history-refresh-btn');
+  if (!_panel) return;
+
+  document.getElementById('open-history-btn')?.addEventListener('click', _open);
+  document.getElementById('history-close')?.addEventListener('click', _close);
+
+  if (_refreshBtn) {
+    _refreshBtn.addEventListener('click', () => {
+      _refreshBtn.textContent = '↺ …';
+      _refreshBtn.disabled = true;
+      setTimeout(_refresh, 150);
+    });
+  }
+
+  // Pull-to-refresh: detect downward drag when already scrolled to top
+  let _touchStartY = 0;
+  _list?.addEventListener('touchstart', e => {
+    _touchStartY = e.touches[0].clientY;
+  }, { passive: true });
+  _list?.addEventListener('touchend', e => {
+    const dy = e.changedTouches[0].clientY - _touchStartY;
+    if (dy > 60 && _list.scrollTop === 0) {
+      _refresh();
+    }
+  }, { passive: true });
+}
--- a/the-matrix/js/hud-labels.js
+++ b/the-matrix/js/hud-labels.js
@@ -12,7 +12,12 @@
 */

 import * as THREE from 'three';
-import { colorToCss } from './agent-defs.js';
+import { colorToCss, AGENT_DEFS } from './agent-defs.js';
+
+// Specialization lookup built once from AGENT_DEFS
+const _specializations = Object.fromEntries(
+  AGENT_DEFS.filter(d => d.specialization).map(d => [d.id, d.specialization])
+);

 const _proj   = new THREE.Vector3();
 let   _camera = null;
@@ -20,6 +25,7 @@ let   _labels = [];    // { el, worldPos: THREE.Vector3, id }

 // ── State cache (updated from WS) ────────────────────────────────────────────
 const _states = {};
+const _lastTasks = {};

 // ── Inspect popup ─────────────────────────────────────────────────────────────
 let _inspectEl    = null;
@@ -100,6 +106,10 @@ function _makeLabel(container, id, name, role, color, worldPos) {
  return { el, worldPos, id, color };
 }

+export function setLabelLastTask(id, summary) {
+  _lastTasks[id] = summary;
+}
+
 export function setLabelState(id, state) {
  _states[id] = state;
  const entry = _labels.find(l => l.id === id);
@@ -118,13 +128,17 @@ export function showInspectPopup(id, screenX, screenY) {

  const state  = _states[id] || 'idle';
  const uptime = Math.floor(performance.now() / 1000);
+  const spec    = _specializations[id];
+  const lastTask = _lastTasks[id];
  _inspectEl.innerHTML = `
    <div style="color:${entry.color};font-weight:bold;letter-spacing:2px;font-size:12px;margin-bottom:6px;">
      ${id.toUpperCase()}
    </div>
+    ${spec ? `<div style="color:${entry.color}99;margin-bottom:4px;font-size:10px;letter-spacing:1px;">⬡ ${spec}</div>` : ''}
    <div style="color:#aaa;margin-bottom:2px;">state&nbsp;&nbsp;: <span style="color:${entry.color}">${state}</span></div>
    <div style="color:#aaa;margin-bottom:2px;">uptime : ${uptime}s</div>
-    <div style="color:#aaa;">network: <span style="color:#44ff88">connected</span></div>
+    <div style="color:#aaa;margin-bottom:2px;">network: <span style="color:#44ff88">connected</span></div>
+    ${lastTask ? `<div style="color:#888;font-size:9px;margin-top:4px;border-top:1px solid #333;padding-top:4px;">last: ${lastTask.slice(0, 60)}</div>` : ''}
  `;
  _inspectEl.style.left    = `${screenX}px`;
  _inspectEl.style.top     = `${screenY}px`;
--- a/the-matrix/js/main.js
+++ b/the-matrix/js/main.js
@@ -11,6 +11,7 @@ import { initInteraction, disposeInteraction, registerSlapTarget } from './inter
 import { initWebSocket, getConnectionState, getJobCount } from './websocket.js';
 import { initPaymentPanel } from './payment.js';
 import { initSessionPanel } from './session.js';
+import { initHistoryPanel } from './history.js';
 import { initNostrIdentity } from './nostr-identity.js';
 import { warmup as warmupEdgeWorker, onReady as onEdgeWorkerReady } from './edge-worker-client.js';
 import { setEdgeWorkerReady } from './ui.js';
@@ -46,6 +47,7 @@ function buildWorld(firstInit, stateSnapshot) {
    initWebSocket(scene);
    initPaymentPanel();
    initSessionPanel();
+    initHistoryPanel();
    void initNostrIdentity('/api');
    warmupEdgeWorker();
    onEdgeWorkerReady(() => setEdgeWorkerReady());
--- a/the-matrix/js/payment.js
+++ b/the-matrix/js/payment.js
@@ -10,6 +10,7 @@
 */

 import { getOrRefreshToken } from './nostr-identity.js';
+import { addHistoryEntry } from './history.js';

 const API_BASE = '/api';
 const POLL_INTERVAL_MS = 2000;
@@ -18,6 +19,7 @@ const POLL_TIMEOUT_MS  = 60000;
 let panel = null;
 let closeBtn = null;
 let currentJobId = null;
+let currentRequest = '';
 let pollTimer = null;

 export function initPaymentPanel() {
@@ -96,6 +98,7 @@ async function submitJob() {
    if (!res.ok) { setError(data.error || 'Failed to create job.'); return; }

    currentJobId = data.jobId;
+    currentRequest = request;
    showEvalInvoice(data.evalInvoice);
  } catch (err) {
    setError('Network error: ' + err.message);
@@ -167,7 +170,7 @@ function startPolling() {
      const pollHeaders = token ? { 'X-Nostr-Token': token } : {};
      const res  = await fetch(`${API_BASE}/jobs/${currentJobId}`, { headers: pollHeaders });
      const data = await res.json();
-      const { state, workInvoice, result, reason } = data;
+      const { state, workInvoice, result, reason, costLedger, completedAt } = data;

      if (state === 'awaiting_work_payment' && workInvoice) {
        showWorkInvoice(workInvoice);
@@ -175,10 +178,26 @@ function startPolling() {
        return;
      }
      if (state === 'complete') {
+        addHistoryEntry({
+          jobId: currentJobId,
+          request: currentRequest,
+          costSats: costLedger?.workAmountSats ?? costLedger?.actualAmountSats ?? 0,
+          result,
+          state: 'complete',
+          completedAt: completedAt ?? new Date().toISOString(),
+        });
        showResult(result, 'complete');
        return;
      }
      if (state === 'rejected') {
+        addHistoryEntry({
+          jobId: currentJobId,
+          request: currentRequest,
+          costSats: 0,
+          result: reason,
+          state: 'rejected',
+          completedAt: completedAt ?? new Date().toISOString(),
+        });
        showResult(reason, 'rejected');
        return;
      }
--- a/the-matrix/js/session.js
+++ b/the-matrix/js/session.js
@@ -16,6 +16,7 @@ import { setSpeechBubble, setMood } from './agents.js';
 import { appendSystemMessage, setSessionSendHandler, setInputBarSessionMode } from './ui.js';
 import { getOrRefreshToken } from './nostr-identity.js';
 import { sentiment } from './edge-worker-client.js';
+import { addHistoryEntry } from './history.js';

 const API          = '/api';
 const LS_KEY       = 'timmy_session_v1';
@@ -152,12 +153,21 @@ export async function sessionSendHandler(text) {
      return;
    }

+    const prevBalance = _balanceSats;
    _balanceSats  = data.balanceRemaining ?? 0;
    _sessionState = _balanceSats < MIN_BALANCE ? 'paused' : 'active';
    _saveToStorage();
    _applySessionUI();

    const reply = data.result || data.reason || '…';
+    const costSats = Math.max(0, prevBalance - _balanceSats);
+    addHistoryEntry({
+      request: text,
+      costSats,
+      result: reply,
+      state: data.reason && !data.result ? 'rejected' : 'complete',
+      completedAt: new Date().toISOString(),
+    });
    setSpeechBubble(reply);
    appendSystemMessage('Timmy: ' + reply.slice(0, 80));

--- a/the-matrix/js/websocket.js
+++ b/the-matrix/js/websocket.js
@@ -3,7 +3,7 @@ import { scene } from './world.js'; // Import the scene
 import { setAgentState, setSpeechBubble, applyAgentStates, setMood, TIMMY_WORLD_POS } from './agents.js';
 import { appendSystemMessage, appendDebateMessage, showCostTicker, updateCostTicker } from './ui.js';
 import { sentiment } from './edge-worker-client.js';
-import { setLabelState } from './hud-labels.js';
+import { setLabelState, setLabelLastTask } from './hud-labels.js';
 import { createJobIndicator, dissolveJobIndicator } from './effects.js';
 import { getPubkey } from './nostr-identity.js';

@@ -122,11 +122,19 @@ function handleMessage(msg) {
      break;
    }

+    case 'agent_task_summary': {
+      if (msg.agentId && msg.summary) {
+        setLabelLastTask(msg.agentId, msg.summary);
+      }
+      break;
+    }
+
    case 'job_completed': {
      if (jobCount > 0) jobCount--;
      if (msg.agentId) {
        setAgentState(msg.agentId, 'idle');
        setLabelState(msg.agentId, 'idle');
+        setLabelLastTask(msg.agentId, `job ${(msg.jobId || '').slice(0, 8)} completed`);
      }
      appendSystemMessage(`job ${(msg.jobId || '').slice(0, 8)} complete`);