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
21 changed files with 605 additions and 427 deletions
--- a/artifacts/api-server/src/lib/agent.ts
+++ b/artifacts/api-server/src/lib/agent.ts
@@ -2,23 +2,6 @@ import { makeLogger } from "./logger.js";

 const logger = makeLogger("agent");

-// ── Image request detection ───────────────────────────────────────────────────
-
-const IMAGE_INTENT_RE =
-  /\b(draw|illustrate|create\s+an?\s+image\s+of|generate\s+an?\s+image\s+of|visualize|visualise|make\s+an?\s+image\s+of|paint\s+me|sketch|render\s+an?\s+image\s+of|picture\s+of)\b/i;
-
-/**
- * Returns true if the request text signals an image-generation intent.
- */
-export function detectImageRequest(text: string): boolean {
-  return IMAGE_INTENT_RE.test(text);
-}
-
-export interface ImageWorkResult {
-  b64_json: string;
-  mimeType: string;
-}
-
 export interface EvalResult {
  accepted: boolean;
  reason: string;
@@ -459,36 +442,6 @@ Respond ONLY with valid JSON: {"accepted": true/false, "reason": "..."}`,
      return "";
    }
  }
-
-  /**
-   * Generate an image via Gemini for the given prompt.
-   * Falls back to a stub 1×1 transparent PNG when Gemini credentials are absent.
-   */
-  async executeImageWork(prompt: string): Promise<ImageWorkResult> {
-    const geminiAvailable =
-      !!process.env["AI_INTEGRATIONS_GEMINI_API_KEY"] &&
-      !!process.env["AI_INTEGRATIONS_GEMINI_BASE_URL"];
-
-    if (!geminiAvailable) {
-      logger.warn("Gemini credentials absent — returning stub image", { component: "agent" });
-      // 1×1 transparent PNG (base64)
-      return {
-        b64_json:
-          "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
-        mimeType: "image/png",
-      };
-    }
-
-    try {
-      const mod = (await import("@workspace/integrations-gemini-ai")) as {
-        generateImage: (prompt: string) => Promise<{ b64_json: string; mimeType: string }>;
-      };
-      return await mod.generateImage(prompt);
-    } catch (err) {
-      logger.error("Gemini image generation failed", { error: String(err) });
-      throw err;
-    }
-  }
 }

 export const agentService = new AgentService();
--- a/artifacts/api-server/src/lib/event-bus.ts
+++ b/artifacts/api-server/src/lib/event-bus.ts
@@ -3,7 +3,7 @@ import { EventEmitter } from "events";
 export type JobEvent =
  | { type: "job:state"; jobId: string; state: string }
  | { type: "job:paid"; jobId: string; invoiceType: "eval" | "work" }
-  | { type: "job:completed"; jobId: string; result: string; mediaUrl?: string; mediaType?: string }
+  | { type: "job:completed"; jobId: string; result: string }
  | { type: "job:failed"; jobId: string; reason: string };

 export type SessionEvent =
@@ -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/pricing.ts
+++ b/artifacts/api-server/src/lib/pricing.ts
@@ -62,11 +62,6 @@ const DO_INFRA_PER_REQUEST_USD = DO_MONTHLY_COST_USD / DO_MONTHLY_REQUESTS;

 const ORIGINATOR_MARGIN_PCT = envFloat("ORIGINATOR_MARGIN_PCT", 25);

-// ── Image generation flat rate ────────────────────────────────────────────────
-// Charged in addition to eval fee; covers Gemini imagen costs + margin.
-
-const IMAGE_GENERATION_FLAT_RATE_USD = envFloat("IMAGE_GENERATION_FLAT_RATE_USD", 0.04);
-
 // ── Fixed fees ────────────────────────────────────────────────────────────────

 const EVAL_FEE_SATS = envInt("EVAL_FEE_SATS", 10);
@@ -100,25 +95,6 @@ export class PricingService {
    return BOOTSTRAP_FEE_SATS;
  }

-  /**
-   * Flat USD cost for a single image generation request (covers Gemini + margin).
-   */
-  calculateImageFeeUsd(): number {
-    return IMAGE_GENERATION_FLAT_RATE_USD * (1 + this.marginPct / 100);
-  }
-
-  /**
-   * Convert image flat rate to sats. Includes infra amortisation and margin.
-   * Returns the same shape as calculateWorkFeeSats() for drop-in use.
-   */
-  async calculateImageFeeSats(): Promise<WorkFeeBreakdown> {
-    const rawCostUsd = IMAGE_GENERATION_FLAT_RATE_USD + DO_INFRA_PER_REQUEST_USD;
-    const estimatedCostUsd = rawCostUsd * (1 + this.marginPct / 100);
-    const btcPriceUsd = await getBtcPriceUsd();
-    const amountSats = usdToSats(estimatedCostUsd, btcPriceUsd);
-    return { amountSats, estimatedCostUsd, marginPct: this.marginPct, btcPriceUsd };
-  }
-
  // ── Token estimation ─────────────────────────────────────────────────────

  /**
--- 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/estimate.ts
+++ b/artifacts/api-server/src/routes/estimate.ts
@@ -1,6 +1,6 @@
 import { Router, type Request, type Response } from "express";
 import { pricingService } from "../lib/pricing.js";
-import { agentService, detectImageRequest } from "../lib/agent.js";
+import { agentService } from "../lib/agent.js";
 import { getBtcPriceUsd, usdToSats } from "../lib/btc-oracle.js";
 import { freeTierService } from "../lib/free-tier.js";
 import { trustService } from "../lib/trust.js";
@@ -25,27 +25,10 @@ router.get("/estimate", async (req: Request, res: Response) => {
  }

  try {
-    const isImageRequest = detectImageRequest(requestText);
-
-    let inputTokens = 0;
-    let outputTokens = 0;
-    let costUsd: number;
-    let btcPriceUsd: number;
-    let estimatedSats: number;
-
-    if (isImageRequest) {
-      const imageBreakdown = await pricingService.calculateImageFeeSats();
-      costUsd = imageBreakdown.estimatedCostUsd;
-      btcPriceUsd = imageBreakdown.btcPriceUsd;
-      estimatedSats = imageBreakdown.amountSats;
-    } else {
-      const estimate = pricingService.estimateRequestCost(requestText, agentService.workModel);
-      inputTokens = estimate.estimatedInputTokens;
-      outputTokens = estimate.estimatedOutputTokens;
-      costUsd = estimate.estimatedCostUsd;
-      btcPriceUsd = await getBtcPriceUsd();
-      estimatedSats = usdToSats(costUsd, btcPriceUsd);
-    }
+    const { estimatedInputTokens: inputTokens, estimatedOutputTokens: outputTokens, estimatedCostUsd: costUsd } =
+      pricingService.estimateRequestCost(requestText, agentService.workModel);
+    const btcPriceUsd  = await getBtcPriceUsd();
+    const estimatedSats = usdToSats(costUsd, btcPriceUsd);

    // Optionally resolve Nostr identity from query param or header for free-tier preview
    const rawToken =
@@ -76,11 +59,10 @@ router.get("/estimate", async (req: Request, res: Response) => {
      estimatedSats,
      estimatedCostUsd: costUsd,
      btcPriceUsd,
-      ...(isImageRequest ? { mediaType: "image" } : {}),
      tokenEstimate: {
        inputTokens,
        outputTokens,
-        model: isImageRequest ? "gemini-2.5-flash-image" : agentService.workModel,
+        model: agentService.workModel,
      },
      identity: {
        trust_tier:  trustTier,
--- 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/artifacts/api-server/src/routes/jobs.ts
+++ b/artifacts/api-server/src/routes/jobs.ts
@@ -1,10 +1,10 @@
 import { Router, type Request, type Response } from "express";
 import { randomUUID, createHash } from "crypto";
-import { db, jobs, invoices, jobDebates, jobMedia, type Job } from "@workspace/db";
+import { db, jobs, invoices, jobDebates, type Job } from "@workspace/db";
 import { eq, and } from "drizzle-orm";
 import { CreateJobBody, GetJobParams } from "@workspace/api-zod";
 import { lnbitsService } from "../lib/lnbits.js";
-import { agentService, detectImageRequest } from "../lib/agent.js";
+import { agentService } from "../lib/agent.js";
 import { pricingService } from "../lib/pricing.js";
 import { jobsLimiter } from "../lib/rate-limiter.js";
 import { eventBus } from "../lib/event-bus.js";
@@ -110,18 +110,12 @@ async function runEvalInBackground(
    }

    if (evalResult.accepted) {
-      // Detect image-generation requests and flag job accordingly
-      const isImageJob = detectImageRequest(request);
-      if (isImageJob) {
-        await db.update(jobs).set({ mediaType: "image", updatedAt: new Date() }).where(eq(jobs.id, jobId));
-      }
-
-      const breakdown = isImageJob
-        ? await pricingService.calculateImageFeeSats()
-        : await (async () => {
-            const { estimatedInputTokens, estimatedOutputTokens } = pricingService.estimateRequestCost(request, agentService.workModel);
-            return pricingService.calculateWorkFeeSats(estimatedInputTokens, estimatedOutputTokens, agentService.workModel);
-          })();
+      const { estimatedInputTokens, estimatedOutputTokens } = pricingService.estimateRequestCost(request, agentService.workModel);
+      const breakdown = await pricingService.calculateWorkFeeSats(
+        estimatedInputTokens,
+        estimatedOutputTokens,
+        agentService.workModel,
+      );

      // ── Free-tier gate ──────────────────────────────────────────────────
      const ftDecision = await freeTierService.decide(nostrPubkey, breakdown.amountSats);
@@ -260,49 +254,18 @@ async function runWorkInBackground(
  try {
    eventBus.publish({ type: "job:state", jobId, state: "executing" });

-    // Check if this is an image job
-    const jobRow = await getJobById(jobId);
-    const isImageJob = jobRow?.mediaType === "image";
-
-    let resultText = "";
-    let mediaUrl: string | undefined;
-    let inputTokensUsed = 0;
-    let outputTokensUsed = 0;
-
-    if (isImageJob) {
-      // Generate image via Gemini
-      const imageResult = await agentService.executeImageWork(request);
-      const mediaId = randomUUID();
-      const expiresAt = new Date(Date.now() + 7 * 24 * 60 * 60 * 1000); // 7 days
-
-      await db.insert(jobMedia).values({
-        id: mediaId,
-        entityId: jobId,
-        entityType: "job",
-        mediaType: "image",
-        mimeType: imageResult.mimeType,
-        data: imageResult.b64_json,
-        expiresAt,
-      });
-
-      mediaUrl = `/api/jobs/${jobId}/media`;
-      resultText = `Image generated. View at: ${mediaUrl}`;
-      streamRegistry.write(jobId, resultText);
-    } else {
-      const workResult = await agentService.executeWorkStreaming(request, (delta) => {
-        streamRegistry.write(jobId, delta);
-      });
-      resultText = workResult.result;
-      inputTokensUsed = workResult.inputTokens;
-      outputTokensUsed = workResult.outputTokens;
-    }
+    const workResult = await agentService.executeWorkStreaming(request, (delta) => {
+      streamRegistry.write(jobId, delta);
+    });

    streamRegistry.end(jobId);
    latencyHistogram.record("work_phase", Date.now() - workStart);

-    const actualCostUsd = isImageJob
-      ? pricingService.calculateImageFeeUsd()
-      : pricingService.calculateActualCostUsd(inputTokensUsed, outputTokensUsed, agentService.workModel);
+    const actualCostUsd = pricingService.calculateActualCostUsd(
+      workResult.inputTokens,
+      workResult.outputTokens,
+      agentService.workModel,
+    );

    const lockedBtcPrice = btcPriceUsd ?? 100_000;
    const actualTotalCostSats = pricingService.calculateActualChargeSats(actualCostUsd, lockedBtcPrice);
@@ -325,9 +288,9 @@ async function runWorkInBackground(
      .update(jobs)
      .set({
        state: "complete",
-        result: resultText,
-        actualInputTokens: isImageJob ? null : inputTokensUsed,
-        actualOutputTokens: isImageJob ? null : outputTokensUsed,
+        result: workResult.result,
+        actualInputTokens: workResult.inputTokens,
+        actualOutputTokens: workResult.outputTokens,
        actualCostUsd,
        actualAmountSats,
        refundAmountSats,
@@ -339,14 +302,13 @@ async function runWorkInBackground(
    logger.info("work completed", {
      jobId,
      isFree,
-      isImageJob,
-      inputTokens:      inputTokensUsed,
-      outputTokens:     outputTokensUsed,
+      inputTokens:      workResult.inputTokens,
+      outputTokens:     workResult.outputTokens,
      actualAmountSats,
      refundAmountSats,
      refundState,
    });
-    eventBus.publish({ type: "job:completed", jobId, result: resultText, ...(mediaUrl ? { mediaUrl, mediaType: "image" } : {}) });
+    eventBus.publish({ type: "job:completed", jobId, result: workResult.result });
    // Emit final actual cost for the UI cost ticker
    if (!isFree && actualAmountSats > 0) {
      eventBus.publish({ type: "cost:update", jobId, sats: actualAmountSats, phase: "work", isFinal: true });
@@ -705,7 +667,6 @@ router.get("/jobs/:id", async (req: Request, res: Response) => {
        res.json({
          ...base,
          result: job.result ?? undefined,
-          ...(job.mediaType === "image" ? { mediaType: "image", mediaUrl: `/api/jobs/${job.id}/media` } : {}),
          ...(job.actualCostUsd != null ? {
            costLedger: {
              // Token usage
@@ -745,44 +706,6 @@ router.get("/jobs/:id", async (req: Request, res: Response) => {
  }
 });

-// ── GET /jobs/:id/media ───────────────────────────────────────────────────────
-
-router.get("/jobs/:id/media", async (req: Request, res: Response) => {
-  const paramResult = GetJobParams.safeParse(req.params);
-  if (!paramResult.success) { res.status(400).json({ error: "Invalid job id" }); return; }
-  const { id } = paramResult.data;
-
-  try {
-    const rows = await db
-      .select()
-      .from(jobMedia)
-      .where(eq(jobMedia.entityId, id))
-      .limit(1);
-
-    const media = rows[0];
-    if (!media) {
-      res.status(404).json({ error: "No media found for this job" });
-      return;
-    }
-
-    if (new Date() > media.expiresAt) {
-      res.status(410).json({ error: "Media has expired" });
-      return;
-    }
-
-    res.json({
-      jobId: id,
-      mediaType: media.mediaType,
-      mimeType: media.mimeType,
-      data: media.data,
-      expiresAt: media.expiresAt.toISOString(),
-    });
-  } catch (err) {
-    const message = err instanceof Error ? err.message : "Failed to fetch media";
-    res.status(500).json({ error: message });
-  }
-});
-
 // ── POST /jobs/:id/refund ─────────────────────────────────────────────────────

 router.post("/jobs/:id/refund", async (req: Request, res: Response) => {
--- a/artifacts/api-server/src/routes/sessions.ts
+++ b/artifacts/api-server/src/routes/sessions.ts
@@ -1,11 +1,11 @@
 import { Router, type Request, type Response } from "express";
 import { randomBytes, randomUUID, createHash } from "crypto";
-import { db, sessions, sessionRequests, sessionMessages, jobMedia, getSessionHistory, type Session } from "@workspace/db";
+import { db, sessions, sessionRequests, sessionMessages, getSessionHistory, type Session } from "@workspace/db";
 import { eq, and } from "drizzle-orm";
 import { lnbitsService } from "../lib/lnbits.js";
 import { sessionsLimiter } from "../lib/rate-limiter.js";
 import { eventBus } from "../lib/event-bus.js";
-import { agentService, detectImageRequest } from "../lib/agent.js";
+import { agentService } from "../lib/agent.js";
 import { pricingService } from "../lib/pricing.js";
 import { getBtcPriceUsd, usdToSats } from "../lib/btc-oracle.js";
 import { trustService } from "../lib/trust.js";
@@ -336,11 +336,6 @@ router.post("/sessions/:id/request", async (req: Request, res: Response) => {
    let finalState: "complete" | "rejected" | "failed" = "rejected";
    let reason: string | null = null;
    let errorMessage: string | null = null;
-    let mediaUrl: string | null = null;
-    let mediaType: string | null = null;
-
-    // Detect image generation intent before pricing estimate
-    const isImageRequest = detectImageRequest(requestText);

    // ── Pre-gate: free-tier decision on ESTIMATED cost before executing work ──
    // Estimate total request cost (work portion) pre-execution to determine subsidy.
@@ -350,59 +345,26 @@ router.post("/sessions/:id/request", async (req: Request, res: Response) => {
    let ftDecision: import("../lib/free-tier.js").FreeTierDecision | null = null;
    if (evalResult.accepted && session.nostrPubkey) {
      // estimateRequestCost includes infra + margin. Convert to sats for decide().
-      let estimatedSats: number;
-      if (isImageRequest) {
-        const imageBreakdown = await pricingService.calculateImageFeeSats();
-        estimatedSats = imageBreakdown.amountSats;
-      } else {
-        const { estimatedCostUsd } = pricingService.estimateRequestCost(requestText, agentService.workModel);
-        estimatedSats = usdToSats(estimatedCostUsd, btcPriceUsd);
-      }
+      const { estimatedCostUsd } = pricingService.estimateRequestCost(requestText, agentService.workModel);
+      const estimatedSats = usdToSats(estimatedCostUsd, btcPriceUsd);
      ftDecision = await freeTierService.decide(session.nostrPubkey, estimatedSats);
    }

    if (evalResult.accepted) {
-      if (isImageRequest) {
-        try {
-          const imageResult = await agentService.executeImageWork(requestText);
-          const mediaId = randomUUID();
-          const expiresAt = new Date(Date.now() + 7 * 24 * 60 * 60 * 1000); // 7 days
-
-          await db.insert(jobMedia).values({
-            id: mediaId,
-            entityId: requestId,
-            entityType: "session_request",
-            mediaType: "image",
-            mimeType: imageResult.mimeType,
-            data: imageResult.b64_json,
-            expiresAt,
-          });
-
-          mediaUrl = `/api/sessions/${id}/requests/${requestId}/media`;
-          mediaType = "image";
-          workCostUsd = pricingService.calculateImageFeeUsd();
-          result = `Image generated. View at: ${mediaUrl}`;
-          finalState = "complete";
-        } catch (err) {
-          errorMessage = err instanceof Error ? err.message : "Image generation error";
-          finalState = "failed";
-        }
-      } else {
-        try {
-          const workResult = await agentService.executeWork(requestText, history);
-          workInputTokens = workResult.inputTokens;
-          workOutputTokens = workResult.outputTokens;
-          workCostUsd = pricingService.calculateActualCostUsd(
-            workResult.inputTokens,
-            workResult.outputTokens,
-            agentService.workModel,
-          );
-          result = workResult.result;
-          finalState = "complete";
-        } catch (err) {
-          errorMessage = err instanceof Error ? err.message : "Execution error";
-          finalState = "failed";
-        }
+      try {
+        const workResult = await agentService.executeWork(requestText, history);
+        workInputTokens = workResult.inputTokens;
+        workOutputTokens = workResult.outputTokens;
+        workCostUsd = pricingService.calculateActualCostUsd(
+          workResult.inputTokens,
+          workResult.outputTokens,
+          agentService.workModel,
+        );
+        result = workResult.result;
+        finalState = "complete";
+      } catch (err) {
+        errorMessage = err instanceof Error ? err.message : "Execution error";
+        finalState = "failed";
      }
    } else {
      reason = evalResult.reason;
@@ -529,7 +491,6 @@ router.post("/sessions/:id/request", async (req: Request, res: Response) => {
      ...(result ? { result } : {}),
      ...(reason ? { reason } : {}),
      ...(errorMessage ? { errorMessage } : {}),
-      ...(mediaUrl ? { mediaUrl, mediaType } : {}),
      debitedSats,
      balanceRemaining: newBalance,
      ...(freeTierServed ? { free_tier: true, absorbed_sats: absorbedSats } : {}),
@@ -647,43 +608,4 @@ router.delete("/sessions/:id/history", async (req: Request, res: Response) => {
  }
 });

-// ── GET /sessions/:id/requests/:requestId/media ───────────────────────────────
-
-router.get("/sessions/:id/requests/:requestId/media", async (req: Request, res: Response) => {
-  const sessionId = req.params.id as string;
-  const requestId = req.params.requestId as string;
-
-  try {
-    const session = await getSessionById(sessionId);
-    if (!session) { res.status(404).json({ error: "Session not found" }); return; }
-
-    const rows = await db
-      .select()
-      .from(jobMedia)
-      .where(eq(jobMedia.entityId, requestId))
-      .limit(1);
-
-    const media = rows[0];
-    if (!media) {
-      res.status(404).json({ error: "No media found for this request" });
-      return;
-    }
-
-    if (new Date() > media.expiresAt) {
-      res.status(410).json({ error: "Media has expired" });
-      return;
-    }
-
-    res.json({
-      requestId,
-      mediaType: media.mediaType,
-      mimeType: media.mimeType,
-      data: media.data,
-      expiresAt: media.expiresAt.toISOString(),
-    });
-  } catch (err) {
-    res.status(500).json({ error: err instanceof Error ? err.message : "Failed to fetch media" });
-  }
-});
-
 export default router;
--- a/lib/db/migrations/0010_job_media.sql
+++ b/lib/db/migrations/0010_job_media.sql
@@ -1,26 +0,0 @@
-- Migration: Image generation media storage (#19)
-- Adds job_media table for storing generated images (base64) with 7-day TTL.
-- Also adds media_type column to jobs table to flag image-type work.
-
-- ── job_media ─────────────────────────────────────────────────────────────────
-- Stores generated media for both standalone jobs and session requests.
-- entity_id is polymorphic: job ID or session request ID.
-- expires_at is set to NOW + 7 days at insert time.
-
-CREATE TABLE IF NOT EXISTS job_media (
-  id          TEXT PRIMARY KEY,
-  entity_id   TEXT NOT NULL,        -- job ID or session request ID
-  entity_type TEXT NOT NULL,        -- 'job' | 'session_request'
-  media_type  TEXT NOT NULL,        -- 'image'
-  mime_type   TEXT NOT NULL,        -- e.g. 'image/png'
-  data        TEXT NOT NULL,        -- base64-encoded image data
-  created_at  TIMESTAMPTZ NOT NULL DEFAULT NOW(),
-  expires_at  TIMESTAMPTZ NOT NULL
-);
-
-CREATE INDEX IF NOT EXISTS idx_job_media_entity_id ON job_media(entity_id);
-
-- ── jobs.media_type ───────────────────────────────────────────────────────────
-- Nullable flag set during eval phase for image-generation requests.
-
-ALTER TABLE jobs ADD COLUMN IF NOT EXISTS media_type TEXT;
--- a/lib/db/src/schema/index.ts
+++ b/lib/db/src/schema/index.ts
@@ -14,4 +14,3 @@ export * from "./relay-accounts";
 export * from "./relay-event-queue";
 export * from "./job-debates";
 export * from "./session-messages";
-export * from "./job-media";
--- a/lib/db/src/schema/job-media.ts
+++ b/lib/db/src/schema/job-media.ts
@@ -1,19 +0,0 @@
-import { pgTable, text, timestamp } from "drizzle-orm/pg-core";
-
-/**
- * job_media — stores generated media (images) for jobs and session requests.
- * entityId is polymorphic: it can be a job ID or a session request ID.
- * expiresAt is set to NOW + 7 days; a cleanup job should purge expired rows.
- */
-export const jobMedia = pgTable("job_media", {
-  id: text("id").primaryKey(),
-  entityId: text("entity_id").notNull(),       // job ID or session request ID
-  entityType: text("entity_type").notNull(),   // 'job' | 'session_request'
-  mediaType: text("media_type").notNull(),      // 'image'
-  mimeType: text("mime_type").notNull(),        // e.g. 'image/png'
-  data: text("data").notNull(),                 // base64-encoded image data
-  createdAt: timestamp("created_at", { withTimezone: true }).defaultNow().notNull(),
-  expiresAt: timestamp("expires_at", { withTimezone: true }).notNull(),
-});
-
-export type JobMedia = typeof jobMedia.$inferSelect;
--- a/lib/db/src/schema/jobs.ts
+++ b/lib/db/src/schema/jobs.ts
@@ -52,9 +52,6 @@ export const jobs = pgTable("jobs", {
  refundState: text("refund_state").$type<"not_applicable" | "pending" | "paid">(),
  refundPaymentHash: text("refund_payment_hash"),

-  // ── Image generation (set during eval if request is an image job) ───────────
-  mediaType: text("media_type"),  // 'image' | null
-
  createdAt: timestamp("created_at", { withTimezone: true }).defaultNow().notNull(),
  updatedAt: timestamp("updated_at", { withTimezone: true }).defaultNow().notNull(),
 });
--- 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,25 +153,29 @@ export async function sessionSendHandler(text) {
      return;
    }

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

-    if (data.mediaType === 'image' && data.mediaUrl) {
-      // Fetch image data and render inline
-      _renderImageResponse(data.mediaUrl, text);
-    } else {
-      const reply = data.result || data.reason || '…';
-      setSpeechBubble(reply);
-      appendSystemMessage('Timmy: ' + reply.slice(0, 80));
+    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));

-      // Sentiment-driven mood on inbound Timmy reply
-      sentiment(reply).then(s => {
-        setMood(s.label);
-        setTimeout(() => setMood(null), 10_000);
-      }).catch(() => {});
-    }
+    // Sentiment-driven mood on inbound Timmy reply
+    sentiment(reply).then(s => {
+      setMood(s.label);
+      setTimeout(() => setMood(null), 10_000);
+    }).catch(() => {});

    // Update active-step balance if panel is open
    _updateActiveStep();
@@ -183,66 +188,6 @@ export async function sessionSendHandler(text) {
  }
 }

-// ── Image rendering ───────────────────────────────────────────────────────────
-
-async function _renderImageResponse(mediaUrl, prompt) {
-  const $log = document.getElementById('event-log');
-  if (!$log) return;
-
-  setSpeechBubble('✨ Here is your image!');
-  appendSystemMessage('Timmy: ✨ Image generated!');
-
-  try {
-    const res = await fetch(mediaUrl);
-    if (!res.ok) {
-      appendSystemMessage('Timmy: Image ready — ' + mediaUrl);
-      return;
-    }
-    const data = await res.json();
-    const src = `data:${data.mimeType};base64,${data.data}`;
-
-    const container = document.createElement('div');
-    container.className = 'log-entry timmy-image-result';
-    container.style.cssText = [
-      'margin:6px 0;padding:6px;',
-      'border:1px solid #336655;border-radius:4px;',
-      'background:#0a1a14;',
-    ].join('');
-
-    const img = document.createElement('img');
-    img.src = src;
-    img.alt = prompt.slice(0, 60);
-    img.style.cssText = [
-      'max-width:100%;max-height:240px;',
-      'display:block;border-radius:3px;',
-      'cursor:pointer;',
-    ].join('');
-    img.title = 'Click to view full size';
-
-    const dlBtn = document.createElement('a');
-    dlBtn.href = src;
-    dlBtn.download = 'timmy-image.png';
-    dlBtn.textContent = '⬇ Download';
-    dlBtn.style.cssText = [
-      'display:inline-block;margin-top:4px;',
-      'font-size:10px;color:#44cc88;',
-      'text-decoration:none;letter-spacing:1px;',
-    ].join('');
-
-    container.appendChild(img);
-    container.appendChild(dlBtn);
-
-    const entries = $log.querySelectorAll('.log-entry');
-    if (entries.length >= 6) {
-      $log.removeChild(entries[0]);
-    }
-    $log.appendChild(container);
-    $log.scrollTop = $log.scrollHeight;
-  } catch {
-    appendSystemMessage('Timmy: Image generated — ' + mediaUrl);
-  }
-}
-
 // ── Panel open/close ──────────────────────────────────────────────────────────

 function _openPanel() {
--- 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`);