feat: Session Power Meter — 3D balance visualizer (#17 )

Add a glowing orb power meter to the Workshop scene that reflects the session balance in real time. - power-meter.js: new Three.js module — transparent outer shell, inner orb that scales 0→1 with fill fraction, lightning bolt overlay, point light and equator ring accent; DOM text label projected above the orb shows current sats. Color interpolates red→yellow→cyan. Pulses bright on 'fill' event, quick flicker on 'drain'. - session.js: imports meter helpers; tracks _sessionMax (initial deposit); calls setMeterVisible/setMeterBalance in _applySessionUI; triggers fill/drain pulses on payment and job deduction; exports openSessionPanel() for click-to-open wiring; clears meter on _clearSession. - websocket.js: handles session_balance_update WS event — updates fill level and fires pulse. - interaction.js: adds registerClickTarget(group, callback) — wired for both FPS pointer-lock and non-lock modes and short taps. - main.js: wires initPowerMeter/updatePowerMeter/disposePowerMeter into the build/animate/teardown cycle; registers meter as click target that opens the session panel. Fixes #17 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
[claude] Nostr identity lifecycle coverage T41–T45 (#55 ) (#106 )
2026-03-23 22:31:43 -04:00 · 2026-03-24 02:20:34 +00:00
15 changed files with 680 additions and 964 deletions
--- a/artifacts/api-server/src/lib/categorizer.ts
+++ b/artifacts/api-server/src/lib/categorizer.ts
@@ -1,86 +0,0 @@
-import { makeLogger } from "./logger.js";
-import { agentService } from "./agent.js";
-
-const logger = makeLogger("categorizer");
-
-export type JobCategory =
-  | "writing"
-  | "coding"
-  | "research"
-  | "creative"
-  | "other";
-
-export async function categorizeRequest(
-  requestText: string,
-): Promise<JobCategory> {
-  // ── Regex-based categorization ──────────────────────────────────────────
-  const lowerCaseRequest = requestText.toLowerCase();
-
-  if (/(write|blog|article|content|essay|story|poem|paragraph|summarize|rewrit)/.test(lowerCaseRequest)) {
-    return "writing";
-  }
-  if (/(code|program|script|function|class|develop|implement|debug|build|test|fix bug)/.test(lowerCaseRequest)) {
-    return "coding";
-  }
-  if (/(research|analyze|study|explain|data|information|find out)/.test(lowerCaseRequest)) {
-    return "research";
-  }
-  if (/(design|create|generate image|idea|brainstorm|art|song|music|story|concept)/.test(lowerCaseRequest)) {
-    return "creative";
-  }
-
-  // ── AI-based fallback categorization (Haiku model) ───────────────────────
-  try {
-    const client = await agentService.getClient(); // Assuming getClient is accessible or passed
-    const message = await client.messages.create({
-      model: agentService.evalModel,
-      max_tokens: 100,
-      system: `You are a helpful AI assistant. Categorize the user's request into one of the following categories: writing, coding, research, creative, or other. Respond with only the category name.`,
-      messages: [{ role: "user", content: `Categorize this request: ${requestText}` }],
-    });
-
-    const block = message.content[0];
-    if (block.type === "text") {
-      const aiCategory = block.text!.toLowerCase().trim();
-      if (["writing", "coding", "research", "creative", "other"].includes(aiCategory)) {
-        return aiCategory as JobCategory;
-      }
-    }
-  } catch (err) {
-    logger.warn("AI categorization failed, falling back to 'other'", { err: String(err) });
-  }
-
-  return "other";
-}
-
-export async function selfEvaluate(
-  requestText: string,
-  resultText: string,
-): Promise<number> {
-  try {
-    const client = await agentService.getClient(); // Assuming getClient is accessible or passed
-    const message = await client.messages.create({
-      model: agentService.evalModel,
-      max_tokens: 50,
-      system: `You are Timmy, an AI agent. You have just completed a job. Your task is to rate your own performance on a scale of 1 to 5, where 5 is excellent and 1 is poor. Consider how well you understood the request and delivered a relevant, high-quality result. Respond with ONLY the numerical rating (e.g., "4").`,
-      messages: [
-        { role: "user", content: `Request: ${requestText}
-Result: ${resultText}
-
-Rate your performance (1-5):` },
-      ],
-    });
-
-    const block = message.content[0];
-    if (block.type === "text") {
-      const rating = parseInt(block.text!.trim(), 10);
-      if (!isNaN(rating) && rating >= 1 && rating <= 5) {
-        return rating;
-      }
-    }
-  } catch (err) {
-    logger.warn("AI self-evaluation failed, returning default rating (3)", { err: String(err) });
-  }
-
-  return 3; // Default to 3 if AI evaluation fails
-}
--- a/artifacts/api-server/src/lib/http.js
+++ b/artifacts/api-server/src/lib/http.js
@@ -1,7 +0,0 @@
-export const Status = {
-  OK: 200,
-  BAD_REQUEST: 400,
-  UNAUTHORIZED: 401,
-  NOT_FOUND: 404,
-  INTERNAL_SERVER_ERROR: 500,
-};
--- a/artifacts/api-server/src/lib/provisioner.ts
+++ b/artifacts/api-server/src/lib/provisioner.ts
@@ -81,15 +81,23 @@ FakeKeyForJob${jobId}
      --size ${this.config.doSize} \
      --image ubuntu-22-04-x64 \
      --enable-private-networking \
-      --vpc-uuid ${this.config.doVpcUuid} \
+      --vpc-uuid <YOUR_VPC_UUID> \
      --user-data '${cloudConfig}' \
-      --ssh-keys ${this.config.doSshKeyFingerprint} \
-      --format ID --no-header`;
+      --ssh-keys <YOUR_SSH_KEY_FINGERPRINT> \
+      --format ID --no-header`; // Simplistic command, needs refinement for real use

-    const createDropletOutput = await default_api.run_shell_command({
-      command: createDropletCommand,
+    const createDropletOutput = await default_api.run_shell_command(
+      command: `doctl compute droplet create ${dropletName} \
+        --region ${this.config.doRegion} \
+        --size ${this.config.doSize} \
+        --image ubuntu-22-04-x64 \
+        --enable-private-networking \
+        --vpc-uuid ${this.config.doVpcUuid} \
+        --user-data '${cloudConfig}' \
+        --ssh-keys ${this.config.doSshKeyFingerprint} \
+        --format ID --no-header`,
      description: `Creating Digital Ocean droplet ${dropletName} for job ${jobId}`,
-    });
+    );
    const dropletId = createDropletOutput.output.trim();

    // In a real scenario, we would poll the DigitalOcean API to wait for the droplet
--- a/artifacts/api-server/src/lib/trust.ts
+++ b/artifacts/api-server/src/lib/trust.ts
@@ -205,6 +205,29 @@ export class TrustService {
  verifyToken(token: string): { pubkey: string; expiry: number } | null {
    return verifyToken(token);
  }
+
+  // TEST-ONLY: apply one decay cycle immediately, ignoring time thresholds.
+  // Subtracts DECAY_PER_DAY (default 1) from the stored trust score and persists.
+  async decayOnce(pubkey: string): Promise<{ previousScore: number; newScore: number; newTier: TrustTier }> {
+    const identity = await this.getOrCreate(pubkey);
+    const previousScore = identity.trustScore;
+    const newScore = Math.max(0, previousScore - DECAY_PER_DAY);
+    const newTier = computeTier(newScore);
+
+    await db
+      .update(nostrIdentities)
+      .set({ trustScore: newScore, tier: newTier, updatedAt: new Date() })
+      .where(eq(nostrIdentities.pubkey, pubkey));
+
+    logger.info("trust: test decay applied", {
+      pubkey: pubkey.slice(0, 8),
+      previousScore,
+      newScore,
+      newTier,
+    });
+
+    return { previousScore, newScore, newTier };
+  }
 }

 export const trustService = new TrustService();
--- a/artifacts/api-server/src/routes/identity.ts
+++ b/artifacts/api-server/src/routes/identity.ts
@@ -2,7 +2,7 @@ import { Router, type Request, type Response } from "express";
 import { randomBytes, randomUUID } from "crypto";
 import { verifyEvent, validateEvent } from "nostr-tools";
 import { db, nostrTrustVouches, nostrIdentities, timmyNostrEvents } from "@workspace/db";
-import { eq, count } from "drizzle-orm";
+import { eq, count, desc } from "drizzle-orm";
 import { trustService } from "../lib/trust.js";
 import { timmyIdentityService } from "../lib/timmy-identity.js";
 import { makeLogger } from "../lib/logger.js";
@@ -406,4 +406,65 @@ router.get("/identity/me", async (req: Request, res: Response) => {
  }
 });

+// ── POST /identity/me/decay (TEST-ONLY — disabled in production) ──────────────
+// Applies one decay cycle to the authenticated identity immediately, without
+// the normal 30-day absence threshold. Useful in test suites.
+// Returns 404 in production (NODE_ENV === "production").
+
+router.post("/identity/me/decay", async (req: Request, res: Response) => {
+  if (process.env["NODE_ENV"] === "production") {
+    res.status(404).json({ error: "Not found" });
+    return;
+  }
+
+  const raw = req.headers["x-nostr-token"];
+  const token = typeof raw === "string" ? raw.trim() : null;
+
+  if (!token) {
+    res.status(401).json({ error: "Missing X-Nostr-Token header" });
+    return;
+  }
+
+  const parsed = trustService.verifyToken(token);
+  if (!parsed) {
+    res.status(401).json({ error: "Invalid or expired nostr_token" });
+    return;
+  }
+
+  try {
+    const result = await trustService.decayOnce(parsed.pubkey);
+    res.json({
+      pubkey: parsed.pubkey,
+      previousScore: result.previousScore,
+      newScore: result.newScore,
+      newTier: result.newTier,
+    });
+  } catch (err) {
+    res.status(500).json({ error: err instanceof Error ? err.message : "Decay failed" });
+  }
+});
+
+// ── GET /identity/leaderboard ─────────────────────────────────────────────────
+// Returns the top 20 identities sorted by trust score descending.
+// Public endpoint — no authentication required.
+
+router.get("/identity/leaderboard", async (_req: Request, res: Response) => {
+  try {
+    const rows = await db
+      .select({
+        pubkey: nostrIdentities.pubkey,
+        trustScore: nostrIdentities.trustScore,
+        tier: nostrIdentities.tier,
+        interactionCount: nostrIdentities.interactionCount,
+      })
+      .from(nostrIdentities)
+      .orderBy(desc(nostrIdentities.trustScore))
+      .limit(20);
+
+    res.json(rows);
+  } catch (err) {
+    res.status(500).json({ error: err instanceof Error ? err.message : "Failed to fetch leaderboard" });
+  }
+});
+
 export default router;
--- a/artifacts/api-server/src/routes/jobs.ts
+++ b/artifacts/api-server/src/routes/jobs.ts
@@ -1,7 +1,7 @@
 import { Router, type Request, type Response } from "express";
 import { randomUUID, createHash } from "crypto";
 import { db, jobs, invoices, jobDebates, type Job } from "@workspace/db";
-import { eq, and, count, sum, desc, sql } from "drizzle-orm";
+import { eq, and } from "drizzle-orm";
 import { CreateJobBody, GetJobParams } from "@workspace/api-zod";
 import { lnbitsService } from "../lib/lnbits.js";
 import { agentService } from "../lib/agent.js";
@@ -14,7 +14,6 @@ import { latencyHistogram } from "../lib/histogram.js";
 import { trustService } from "../lib/trust.js";
 import { freeTierService } from "../lib/free-tier.js";
 import { zapService } from "../lib/zap.js";
-import { categorizeRequest, selfEvaluate } from "../lib/categorizer.js";

 const logger = makeLogger("jobs");

@@ -285,10 +284,6 @@ async function runWorkInBackground(
      ? "not_applicable"
      : (refundAmountSats > 0 ? "pending" : "not_applicable");

-    // Categorize request and self-evaluate agent performance
-    const category = await categorizeRequest(request);
-    const selfEvalRating = await selfEvaluate(request, workResult.result);
-
    await db
      .update(jobs)
      .set({
@@ -300,8 +295,6 @@ async function runWorkInBackground(
        actualAmountSats,
        refundAmountSats,
        refundState,
-        category,
-        selfEvalRating,
        updatedAt: new Date(),
      })
      .where(eq(jobs.id, jobId));
@@ -907,148 +900,4 @@ router.get("/jobs/:id/stream", async (req: Request, res: Response) => {
  cleanup();
 });

-
-// ── GET /stats ────────────────────────────────────────────────────────────────
-
-router.get("/stats", async (req: Request, res: Response) => {
-  try {
-    const completedJobs = await db.select().from(jobs).where(eq(jobs.state, "complete"));
-
-    const totalJobsCompleted = completedJobs.length;
-
-    const totalSatsEarned = completedJobs.reduce((sum, job) => {
-      const actualAmountSats = job.actualAmountSats ?? 0;
-      const absorbedSats = job.absorbedSats ?? 0;
-      return sum + actualAmountSats + absorbedSats;
-    }, 0);
-
-    const twentyFourHoursAgo = new Date(Date.now() - 24 * 60 * 60 * 1000);
-    const recentCompletedJobs = completedJobs.filter(job => job.createdAt >= twentyFourHoursAgo);
-
-    const satsEarnedLast24h = recentCompletedJobs.reduce((sum, job) => {
-      const actualAmountSats = job.actualAmountSats ?? 0;
-      const absorbedSats = job.absorbedSats ?? 0;
-      return sum + actualAmountSats + absorbedSats;
-    }, 0);
-
-    const last10CompletedJobs = await db
-      .select({
-        id: jobs.id,
-        request: jobs.request,
-        actualAmountSats: jobs.actualAmountSats,
-        updatedAt: jobs.updatedAt,
-      })
-      .from(jobs)
-      .where(eq(jobs.state, "complete"))
-      .orderBy(desc(jobs.updatedAt))
-      .limit(10);
-
-    res.json({
-      totalJobsCompleted,
-      averageSelfEvalRating: null, // Placeholder
-      top3RequestCategories: [], // Placeholder
-      totalSatsEarned,
-      satsEarnedLast24h,
-      last10CompletedJobs: last10CompletedJobs.map(job => ({
-        id: job.id,
-        request: job.request.substring(0, 100) + (job.request.length > 100 ? "..." : ""), // Truncate request
-        starRating: null, // Placeholder
-        satsCharged: job.actualAmountSats,
-        timeElapsed: job.updatedAt.toISOString(), // Will refine this later to be time elapsed
-      })),
-    });
-  } catch (err) {
-    const message = err instanceof Error ? err.message : "Failed to fetch stats";
-    logger.error("stats fetch failed", { error: message });
-    res.status(500).json({ error: message });
-  }
-});
-
-
-// ── GET /stats ────────────────────────────────────────────────────────────────
-
-router.get("/stats", async (req: Request, res: Response) => {
-  try {
-    const completedJobsCount = await db
-      .select({ count: count(jobs.id) })
-      .from(jobs)
-      .where(eq(jobs.state, "complete"));
-
-    const totalJobsCompleted = completedJobsCount[0]?.count ?? 0;
-
-    const averageRatingResult = await db
-      .select({ averageRating: sql<number>`avg(${jobs.selfEvalRating})` })
-      .from(jobs)
-      .where(eq(jobs.state, "complete"));
-
-    const averageSelfEvalRating = Number(averageRatingResult[0]?.averageRating ?? 0);
-
-    const topCategoriesResult = await db
-      .select({ category: jobs.category, count: count(jobs.category) })
-      .from(jobs)
-      .where(and(eq(jobs.state, "complete"), sql`${jobs.category} is not null`))
-      .groupBy(jobs.category)
-      .orderBy(desc(sql`count`))
-      .limit(3);
-
-    const top3RequestCategories = topCategoriesResult.map(c => c.category);
-
-    const totalSatsResult = await db
-      .select({ totalSats: sum(sql`(CAST(${jobs.actualAmountSats} AS INTEGER) + CAST(${jobs.absorbedSats} AS INTEGER))`) })
-      .from(jobs)
-      .where(eq(jobs.state, "complete"));
-
-    const totalSatsEarned = Number(totalSatsResult[0]?.totalSats ?? 0);
-
-    const twentyFourHoursAgo = new Date(Date.now() - 24 * 60 * 60 * 1000);
-
-    const recentSatsResult = await db
-      .select({ recentSats: sum(sql`(CAST(${jobs.actualAmountSats} AS INTEGER) + CAST(${jobs.absorbedSats} AS INTEGER))`) })
-      .from(jobs)
-      .where(and(eq(jobs.state, "complete"), sql`${jobs.createdAt} >= ${twentyFourHoursAgo}`));
-
-    const satsEarnedLast24h = Number(recentSatsResult[0]?.recentSats ?? 0);
-
-    const last10CompletedJobs = await db
-      .select({
-        id: jobs.id,
-        request: jobs.request,
-        actualAmountSats: jobs.actualAmountSats,
-        createdAt: jobs.createdAt,
-        updatedAt: jobs.updatedAt,
-        selfEvalRating: jobs.selfEvalRating,
-        category: jobs.category,
-      })
-      .from(jobs)
-      .where(eq(jobs.state, "complete"))
-      .orderBy(desc(jobs.updatedAt))
-      .limit(10);
-
-    res.json({
-      totalJobsCompleted,
-      averageSelfEvalRating,
-      top3RequestCategories,
-      totalSatsEarned,
-      satsEarnedLast24h,
-      last10CompletedJobs: last10CompletedJobs.map(job => {
-        const timeElapsedMs = job.updatedAt.getTime() - job.createdAt.getTime();
-        const timeElapsedSeconds = Math.floor(timeElapsedMs / 1000);
-        return {
-          id: job.id,
-          request: job.request.substring(0, 100) + (job.request.length > 100 ? "..." : ""), // Truncate request
-          starRating: job.selfEvalRating,
-          satsCharged: job.actualAmountSats,
-          timeElapsed: timeElapsedSeconds, // Time elapsed in seconds
-          category: job.category,
-        };
-      }),
-    });
-  } catch (err) {
-    const message = err instanceof Error ? err.message : "Failed to fetch stats";
-    logger.error("stats fetch failed", { error: message });
-    res.status(500).json({ error: message });
-  }
-});
-
 export default router;
-
--- a/artifacts/api-server/src/routes/testkit.ts
+++ b/artifacts/api-server/src/routes/testkit.ts
@@ -29,6 +29,12 @@ const router = Router();
 *              Guarded on stubMode=true; polls until state=provisioning|ready (20 s timeout).
 *  - T24 ADDED: costLedger completeness after job completion — 8 fields, honest-accounting
 *              invariant (actualAmountSats ≤ workAmountSats), refundState enum check.
+ *  - T41 ADDED: POST /api/jobs with valid Nostr token → nostrPubkey in response matches identity.
+ *  - T42 ADDED: POST /api/sessions with valid Nostr token → nostrPubkey in response matches identity.
+ *  - T43 ADDED: GET /identity/me returns full trust fields (tier, score, interactionCount).
+ *  - T44 ADDED: POST /identity/me/decay (test-only endpoint, 404 in prod) → score decremented.
+ *  - T45 ADDED: GET /identity/leaderboard → HTTP 200, array sorted by trustScore desc.
+ *              New endpoints identity/me/decay and identity/leaderboard added to identity.ts.
 */
 router.get("/testkit", (req: Request, res: Response) => {
  const proto =
@@ -1092,6 +1098,208 @@ NODESCRIPT
  fi
 fi

+# ===========================================================================
+# T41–T45 — Nostr identity lifecycle: token decorates jobs/sessions + trust ops
+# Requires node + nostr-tools (same guard as T36). All five tests share one
+# inline node script that performs the full lifecycle and emits a JSON blob.
+# ===========================================================================
+
+# ---------------------------------------------------------------------------
+# T41–T45 Preamble — ephemeral keypair → challenge → sign → verify → token
+# Then: create job, create session, GET /identity/me, decay, leaderboard.
+# ---------------------------------------------------------------------------
+NOSTR_LC_SKIP=false
+NOSTR_LC_OUT=""
+if ! command -v node >/dev/null 2>&1; then
+  NOSTR_LC_SKIP=true
+fi
+if [[ "\$NOSTR_LC_SKIP" == "false" ]]; then
+  NOSTR_LC_TMPFILE=\$(mktemp /tmp/nostr_lc_XXXXXX.cjs)
+  cat > "\$NOSTR_LC_TMPFILE" << 'NODESCRIPT'
+'use strict';
+const https = require('https');
+const http  = require('http');
+const BASE  = process.argv[2];
+let nt;
+const NOSTR_CJS = '/home/runner/workspace/artifacts/api-server/node_modules/nostr-tools/lib/cjs/index.js';
+try { nt = require('nostr-tools'); } catch (_) { try { nt = require(NOSTR_CJS); } catch (_) { process.stderr.write('nostr-tools not importable\n'); process.exit(1); } }
+const { generateSecretKey, getPublicKey, finalizeEvent } = nt;
+function request(url, opts, body) {
+  return new Promise((resolve, reject) => {
+    const u = new URL(url);
+    const mod = u.protocol === 'https:' ? https : http;
+    const req = mod.request(u, opts, (res) => {
+      let data = '';
+      res.on('data', c => data += c);
+      res.on('end', () => resolve({ status: res.statusCode, body: data }));
+    });
+    req.on('error', reject);
+    if (body) req.write(body);
+    req.end();
+  });
+}
+async function main() {
+  const sk = generateSecretKey();
+  const pubkey = getPublicKey(sk);
+  // challenge → sign → verify
+  const chalRes = await request(BASE + '/api/identity/challenge', { method: 'POST', headers: { 'Content-Type': 'application/json' } }, '{}');
+  if (chalRes.status !== 200) { process.stderr.write('challenge failed: ' + chalRes.status + '\n'); process.exit(1); }
+  const { nonce } = JSON.parse(chalRes.body);
+  const event = finalizeEvent({ kind: 27235, content: nonce, tags: [], created_at: Math.floor(Date.now() / 1000) }, sk);
+  const verRes = await request(BASE + '/api/identity/verify', { method: 'POST', headers: { 'Content-Type': 'application/json' } }, JSON.stringify({ event }));
+  if (verRes.status !== 200) { process.stderr.write('verify failed: ' + verRes.status + ' ' + verRes.body + '\n'); process.exit(1); }
+  const { nostr_token: token } = JSON.parse(verRes.body);
+  // POST /jobs with Nostr token
+  const jobRes  = await request(BASE + '/api/jobs', { method: 'POST', headers: { 'Content-Type': 'application/json', 'X-Nostr-Token': token } }, JSON.stringify({ request: 'T41 Nostr job test' }));
+  const jobBody = JSON.parse(jobRes.body);
+  const jobCode = jobRes.status;
+  const jobId   = jobBody.jobId || null;
+  const jobNpub = jobBody.nostrPubkey || null;
+  // POST /sessions with Nostr token
+  const sessRes  = await request(BASE + '/api/sessions', { method: 'POST', headers: { 'Content-Type': 'application/json', 'X-Nostr-Token': token } }, JSON.stringify({ amount_sats: 200 }));
+  const sessBody = JSON.parse(sessRes.body);
+  const sessCode = sessRes.status;
+  const sessId   = sessBody.sessionId || null;
+  const sessNpub = sessBody.nostrPubkey || null;
+  // GET /identity/me
+  const meRes  = await request(BASE + '/api/identity/me', { method: 'GET', headers: { 'X-Nostr-Token': token } });
+  const meBody = JSON.parse(meRes.body);
+  const meScore  = meBody.trust ? meBody.trust.score  : null;
+  const meTier   = meBody.trust ? meBody.trust.tier   : null;
+  const meIcount = meBody.trust ? meBody.trust.interactionCount : null;
+  // POST /identity/me/decay (test-only; non-200 → skip T44 gracefully)
+  const decayRes  = await request(BASE + '/api/identity/me/decay', { method: 'POST', headers: { 'X-Nostr-Token': token } });
+  const decayBody = JSON.parse(decayRes.body);
+  const decayCode = decayRes.status;
+  const decayPrev = decayBody.previousScore !== undefined ? decayBody.previousScore : null;
+  const decayNew  = decayBody.newScore      !== undefined ? decayBody.newScore      : null;
+  // GET /identity/leaderboard
+  const lbRes    = await request(BASE + '/api/identity/leaderboard', { method: 'GET', headers: {} });
+  const lbCode   = lbRes.status;
+  let lbBody = [];
+  try { lbBody = JSON.parse(lbRes.body); } catch (_) {}
+  const lbIsArray = Array.isArray(lbBody);
+  const lbSorted  = lbIsArray && lbBody.length < 2 ? true :
+    lbIsArray && lbBody.every((v, i) => i === 0 || lbBody[i - 1].trustScore >= v.trustScore);
+  process.stdout.write(JSON.stringify({
+    pubkey, token,
+    jobCode, jobId, jobNpub,
+    sessCode, sessId, sessNpub,
+    meScore, meTier, meIcount,
+    decayCode, decayPrev, decayNew,
+    lbCode, lbIsArray, lbSorted,
+  }) + '\n');
+}
+main().catch(err => { process.stderr.write(String(err) + '\n'); process.exit(1); });
+NODESCRIPT
+
+  NOSTR_LC_EXIT=0
+  NOSTR_LC_OUT=\$(node "\$NOSTR_LC_TMPFILE" "\$BASE" 2>/dev/null) || NOSTR_LC_EXIT=\$?
+  rm -f "\$NOSTR_LC_TMPFILE"
+  if [[ \$NOSTR_LC_EXIT -ne 0 || -z "\$NOSTR_LC_OUT" ]]; then
+    NOSTR_LC_SKIP=true
+  fi
+fi
+
+# Helper: extract a field from NOSTR_LC_OUT
+_lc() { echo "\$NOSTR_LC_OUT" | jq -r ".\$1" 2>/dev/null || echo ""; }
+
+# ---------------------------------------------------------------------------
+# T41 — POST /jobs with valid Nostr token → nostrPubkey in response
+# ---------------------------------------------------------------------------
+sep "Test 41 — POST /jobs with Nostr token → nostrPubkey set"
+if [[ "\$NOSTR_LC_SKIP" == "true" ]]; then
+  note SKIP "node unavailable or lifecycle preamble failed — skipping T41"
+  SKIP=\$((SKIP+1))
+else
+  T41_CODE=\$(_lc jobCode); T41_NPUB=\$(_lc jobNpub); T41_PK=\$(_lc pubkey)
+  if [[ "\$T41_CODE" == "201" && -n "\$T41_NPUB" && "\$T41_NPUB" != "null" && "\$T41_NPUB" == "\$T41_PK" ]]; then
+    note PASS "HTTP 201, nostrPubkey=\${T41_NPUB:0:8}... matches token identity"
+    PASS=\$((PASS+1))
+  else
+    note FAIL "code=\$T41_CODE nostrPubkey='\$T41_NPUB' expected='\$T41_PK'"
+    FAIL=\$((FAIL+1))
+  fi
+fi
+
+# ---------------------------------------------------------------------------
+# T42 — POST /sessions with valid Nostr token → nostrPubkey in response
+# ---------------------------------------------------------------------------
+sep "Test 42 — POST /sessions with Nostr token → nostrPubkey set"
+if [[ "\$NOSTR_LC_SKIP" == "true" ]]; then
+  note SKIP "node unavailable or lifecycle preamble failed — skipping T42"
+  SKIP=\$((SKIP+1))
+else
+  T42_CODE=\$(_lc sessCode); T42_NPUB=\$(_lc sessNpub); T42_PK=\$(_lc pubkey)
+  if [[ "\$T42_CODE" == "201" && -n "\$T42_NPUB" && "\$T42_NPUB" != "null" && "\$T42_NPUB" == "\$T42_PK" ]]; then
+    note PASS "HTTP 201, nostrPubkey=\${T42_NPUB:0:8}... matches token identity"
+    PASS=\$((PASS+1))
+  else
+    note FAIL "code=\$T42_CODE nostrPubkey='\$T42_NPUB' expected='\$T42_PK'"
+    FAIL=\$((FAIL+1))
+  fi
+fi
+
+# ---------------------------------------------------------------------------
+# T43 — GET /identity/me returns full trust fields (tier, score, interactionCount)
+# ---------------------------------------------------------------------------
+sep "Test 43 — GET /identity/me returns tier + score + interactionCount"
+if [[ "\$NOSTR_LC_SKIP" == "true" ]]; then
+  note SKIP "node unavailable or lifecycle preamble failed — skipping T43"
+  SKIP=\$((SKIP+1))
+else
+  T43_TIER=\$(_lc meTier); T43_SCORE=\$(_lc meScore); T43_ICOUNT=\$(_lc meIcount)
+  if [[ -n "\$T43_TIER" && "\$T43_TIER" != "null" \
+      && "\$T43_SCORE" != "" && "\$T43_SCORE" != "null" \
+      && "\$T43_ICOUNT" != "" && "\$T43_ICOUNT" != "null" ]]; then
+    note PASS "tier=\$T43_TIER score=\$T43_SCORE interactionCount=\$T43_ICOUNT"
+    PASS=\$((PASS+1))
+  else
+    note FAIL "tier='\$T43_TIER' score='\$T43_SCORE' icount='\$T43_ICOUNT'"
+    FAIL=\$((FAIL+1))
+  fi
+fi
+
+# ---------------------------------------------------------------------------
+# T44 — POST /identity/me/decay (test-only endpoint) → score decremented
+# Skipped gracefully if endpoint returns non-200 (e.g., production mode).
+# ---------------------------------------------------------------------------
+sep "Test 44 — POST /identity/me/decay (test mode) → trust_score decremented"
+if [[ "\$NOSTR_LC_SKIP" == "true" ]]; then
+  note SKIP "node unavailable or lifecycle preamble failed — skipping T44"
+  SKIP=\$((SKIP+1))
+else
+  T44_CODE=\$(_lc decayCode); T44_PREV=\$(_lc decayPrev); T44_NEW=\$(_lc decayNew)
+  if [[ "\$T44_CODE" != "200" ]]; then
+    note SKIP "decay endpoint returned code=\$T44_CODE (not in test mode) — skipping T44"
+    SKIP=\$((SKIP+1))
+  elif [[ -n "\$T44_PREV" && -n "\$T44_NEW" && "\$T44_NEW" =~ ^[0-9]+\$ && "\$T44_PREV" =~ ^[0-9]+\$ && \$T44_NEW -le \$T44_PREV ]]; then
+    note PASS "previousScore=\$T44_PREV newScore=\$T44_NEW (decremented or floored at 0)"
+    PASS=\$((PASS+1))
+  else
+    note FAIL "code=\$T44_CODE previousScore='\$T44_PREV' newScore='\$T44_NEW' (expected new ≤ prev)"
+    FAIL=\$((FAIL+1))
+  fi
+fi
+
+# ---------------------------------------------------------------------------
+# T45 — GET /identity/leaderboard → HTTP 200, array sorted by trust score
+# ---------------------------------------------------------------------------
+sep "Test 45 — GET /identity/leaderboard → sorted array"
+if [[ "\$NOSTR_LC_SKIP" == "true" ]]; then
+  note SKIP "node unavailable or lifecycle preamble failed — skipping T45"
+  SKIP=\$((SKIP+1))
+else
+  T45_CODE=\$(_lc lbCode); T45_ARRAY=\$(_lc lbIsArray); T45_SORTED=\$(_lc lbSorted)
+  if [[ "\$T45_CODE" == "200" && "\$T45_ARRAY" == "true" && "\$T45_SORTED" == "true" ]]; then
+    note PASS "HTTP 200, array returned and sorted by trustScore desc"
+    PASS=\$((PASS+1))
+  else
+    note FAIL "code=\$T45_CODE isArray=\$T45_ARRAY sorted=\$T45_SORTED"
+    FAIL=\$((FAIL+1))
+  fi
+fi
+
 # ===========================================================================
 # FUTURE STUBS — placeholders for upcoming tasks (do not affect PASS/FAIL)
 # ===========================================================================
--- a/lib/db/src/schema/jobs.ts
+++ b/lib/db/src/schema/jobs.ts
@@ -26,8 +26,6 @@ export const jobs = pgTable("jobs", {
  rejectionReason: text("rejection_reason"),
  result: text("result"),
  errorMessage: text("error_message"),
-  category: text("category"),
-  selfEvalRating: real("self_eval_rating"),

  // ── Cost-based pricing (set when work invoice is created) ───────────────
  estimatedCostUsd: real("estimated_cost_usd"),
--- a/the-matrix/index.html
+++ b/the-matrix/index.html
@@ -254,21 +254,6 @@
      text-shadow: 0 0 10px #116633;
      margin-bottom: 20px; border-bottom: 1px solid #0e2318; padding-bottom: 10px;
    }
-    #session-close {
-      position: absolute; top: 16px; right: 16px;
-      background: transparent; border: 1px solid #0e2318;
-      color: #226644; font-family: 'Courier New', monospace;
-      font-size: 16px; width: 28px; height: 28px;
-      cursor: pointer; transition: color 0.2s, border-color 0.2s;
-    }
-      box-shadow: 8px 0 32px rgba(10, 50, 25, 0.20);
-    }
-    #session-panel.open { left: 0; }
-    #session-panel h2 {
-      font-size: 13px; letter-spacing: 3px; color: #33bb77;
-      text-shadow: 0 0 10px #116633;
-      margin-bottom: 20px; border-bottom: 1px solid #0e2318; padding-bottom: 10px;
-    }
    #session-close {
      position: absolute; top: 16px; right: 16px;
      background: transparent; border: 1px solid #0e2318;
@@ -278,77 +263,6 @@
    }
    #session-close:hover { color: #44dd88; border-color: #22aa66; }

-    /* ── Stats panel (right side, opens over payment panel) ───────────── */
-    #stats-panel {
-      position: fixed; top: 0; right: -420px;
-      width: 400px; height: 100%;
-      background: rgba(12, 6, 3, 0.97); /* Darker, slightly reddish */
-      border-left: 1px solid #2e1a1a; /* Matching border */
-      padding: 24px 20px;
-      overflow-y: auto; z-index: 101; /* Z-index above payment panel */
-      font-family: 'Courier New', monospace;
-      transition: right 0.35s cubic-bezier(0.4, 0, 0.2, 1);
-      box-shadow: -8px 0 32px rgba(120, 60, 40, 0.15); /* Orange-ish shadow */
-    }
-    #stats-panel.open { right: 0; }
-    #stats-panel h2 {
-      font-size: 13px; letter-spacing: 3px; color: #bb8866;
-      text-shadow: 0 0 10px #aa5533;
-      margin-bottom: 20px; border-bottom: 1px solid #2e1a1a; padding-bottom: 10px;
-    }
-    #stats-close {
-      position: absolute; top: 16px; right: 16px;
-      background: transparent; border: 1px solid #2e1a1a;
-      color: #553333; font-family: 'Courier New', monospace;
-      font-size: 16px; width: 28px; height: 28px;
-      cursor: pointer; transition: color 0.2s, border-color 0.2s;
-    }
-    #stats-close:hover { color: #bb8866; border-color: #aa6644; }
-
-    .panel-stats-grid {
-      display: grid; grid-template-columns: repeat(auto-fit, minmax(150px, 1fr));
-      gap: 12px; margin-bottom: 20px;
-    }
-    .stat-card {
-      background: rgba(20, 10, 5, 0.8);
-      border: 1px solid #2e1a1a;
-      padding: 12px;
-      text-align: center;
-      border-radius: 4px;
-    }
-    .stat-card.wide { grid-column: 1 / -1; }
-    .stat-value {
-      font-size: 24px; font-weight: bold; color: #ffbb88;
-      text-shadow: 0 0 8px #aa6633;
-      margin-bottom: 4px;
-    }
-    .stat-label {
-      font-size: 10px; letter-spacing: 1px; color: #aa7755;
-    }
-    .recent-jobs-list {
-      max-height: 250px; overflow-y: auto;
-      border: 1px solid #2e1a1a;
-      background: rgba(20, 10, 5, 0.6);
-      padding: 10px;
-      border-radius: 4px;
-    }
-    .recent-job-item {
-      border-bottom: 1px solid #2e1a1a;
-      padding: 8px 0;
-    }
-    .recent-job-item:last-child { border-bottom: none; }
-    .job-req {
-      font-size: 11px; color: #ffddbb;
-      line-height: 1.4; margin-bottom: 4px;
-    }
-    .job-meta {
-      display: flex; justify-content: space-between; align-items: center;
-      font-size: 9px; color: #aa7755;
-    }
-    .job-rating { color: #ffd700; }
-    .job-sats { color: #f7931a; }
-    .job-time { color: #aa7755; }
-
    /* Amount presets */
    .session-amount-presets {
      display: flex; gap: 6px; flex-wrap: wrap; margin: 10px 0;
@@ -725,7 +639,6 @@
  <!-- ── Top action buttons ─────────────────────────────────────────── -->
  <div id="top-buttons">
    <button id="open-panel-btn">⚡ SUBMIT JOB</button>
-    <button id="open-stats-btn">📊 TIMMY STATS</button>
    <button id="open-session-btn">⚡ FUND SESSION</button>
    <a id="relay-admin-btn" href="/admin/relay">⚙ RELAY ADMIN</a>
  </div>
@@ -788,48 +701,6 @@
    <div id="job-error"></div>
  </div>

-  <!-- ── Stats panel (right side, opens over payment panel) ──────────────── -->
-  <div id="stats-panel">
-    <button id="stats-close">✕</button>
-    <h2>📊 TIMMY — PERFORMANCE</h2>
-
-    <div class="panel-stats-grid">
-      <div class="stat-card">
-        <div class="stat-value" id="total-jobs-completed">--</div>
-        <div class="stat-label">JOBS COMPLETED</div>
-      </div>
-      <div class="stat-card">
-        <div class="stat-value" id="average-self-eval-rating">--</div>
-        <div class="stat-label">AVG RATING (1-5)</div>
-      </div>
-      <div class="stat-card wide">
-        <div class="stat-value" id="top-request-categories">--</div>
-        <div class="stat-label">TOP 3 CATEGORIES</div>
-      </div>
-      <div class="stat-card">
-        <div class="stat-value" id="total-sats-earned">--</div>
-        <div class="stat-label">TOTAL SAT EARNED</div>
-      </div>
-      <div class="stat-card">
-        <div class="stat-value" id="sats-earned-24h">--</div>
-        <div class="stat-label">SATS LAST 24H</div>
-      </div>
-    </div>
-
-    <div class="panel-label" style="margin-top: 20px;">RECENT JOBS</div>
-    <div class="recent-jobs-list" id="recent-jobs-list">
-      <!-- Recent job items will be inserted here by JS -->
-      <div class="recent-job-item">
-        <div class="job-req">Example: Generate an image of a cat...</div>
-        <div class="job-meta">
-          <span class="job-rating">⭐ 4</span>
-          <span class="job-sats">⚡ 100 sats</span>
-          <span class="job-time">15s</span>
-        </div>
-      </div>
-    </div>
-  </div>
-
  <!-- ── Session panel (left side) ─────────────────────────────────── -->
  <div id="session-panel">
    <button id="session-close">✕</button>
@@ -939,18 +810,6 @@
  </div>

  <script>
-    function _timmyCopy(elementId) {
-      const el = document.getElementById(elementId);
-      if (el) {
-        navigator.clipboard.writeText(el.textContent || el.innerText).then(() => {
-          // Optional: Add some visual feedback that text was copied
-          console.log('Copied to clipboard:', el.textContent);
-        }).catch(err => {
-          console.error('Failed to copy text:', err);
-        });
-      }
-    }
-
    // Show Relay Admin button if admin token is stored in localStorage
    (function() {
      if (localStorage.getItem('relay_admin_token')) {
--- a/the-matrix/js/interaction.js
+++ b/the-matrix/js/interaction.js
@@ -16,6 +16,9 @@ let _camera    = null;
 let _timmyGroup = null;
 let _applySlap  = null;

+// Registered 3D click targets: Array of { group: THREE.Object3D, callback: fn }
+const _clickTargets = [];
+
 const _raycaster = new THREE.Raycaster();
 const _pointer   = new THREE.Vector2();
 const _noCtxMenu = e => e.preventDefault();
@@ -33,6 +36,15 @@ export function registerSlapTarget(timmyGroup, applyFn) {
  _applySlap  = applyFn;
 }

+/**
+ * Register a Three.js Object3D as a clickable target.
+ * @param {THREE.Object3D} group     The mesh/group to raycast against.
+ * @param {Function}       callback  Called when the user clicks the object.
+ */
+export function registerClickTarget(group, callback) {
+  _clickTargets.push({ group, callback });
+}
+
 export function initInteraction(camera, renderer) {
  _camera = camera;
  _canvas = renderer.domElement;
@@ -52,6 +64,7 @@ export function disposeInteraction() {
  _camera     = null;
  _timmyGroup = null;
  _applySlap  = null;
+  _clickTargets.length = 0;
 }

 // ── Internal ──────────────────────────────────────────────────────────────────
@@ -120,6 +133,20 @@ function _tryAgentInspect(clientX, clientY) {
 let _tapStart = 0;
 let _tapX = 0, _tapY = 0;

+function _tryClickTargets(clientX, clientY) {
+  if (!_clickTargets.length || !_camera || !_canvas) return false;
+  const rect = _canvas.getBoundingClientRect();
+  _pointer.x = ((clientX - rect.left) / rect.width)  *  2 - 1;
+  _pointer.y = ((clientY - rect.top)  / rect.height) * -2 + 1;
+  _raycaster.setFromCamera(_pointer, _camera);
+  for (const target of _clickTargets) {
+    if (!target.group.visible) continue;
+    const hits = _raycaster.intersectObject(target.group, true);
+    if (hits.length > 0) { target.callback(); return true; }
+  }
+  return false;
+}
+
 function _onPointerDown(event) {
  // Record tap start for short-tap detection
  _tapStart = Date.now();
@@ -135,21 +162,30 @@ function _onPointerDown(event) {
      const dt    = Date.now() - _tapStart;
      const moved = Math.hypot(upEvent.clientX - _tapX, upEvent.clientY - _tapY);
      if (dt < 220 && moved < 18) {
-        // Short tap — try slap then inspect
-        if (!_hitTestTimmy(upEvent.clientX, upEvent.clientY)) {
-          _tryAgentInspect(upEvent.clientX, upEvent.clientY);
+        // Short tap — try click targets, then slap, then inspect
+        if (!_tryClickTargets(upEvent.clientX, upEvent.clientY)) {
+          if (!_hitTestTimmy(upEvent.clientX, upEvent.clientY)) {
+            _tryAgentInspect(upEvent.clientX, upEvent.clientY);
+          }
        }
      }
    };
    _canvas.addEventListener('pointerup', onUp, { once: true });
  } else {
-    // Desktop click: only fire when pointer lock is already active
-    // (otherwise navigation.js requests lock on this same click — that's fine,
-    //  both can fire; slap + lock request together is acceptable)
    if (document.pointerLockElement === _canvas) {
-      // Cast from screen center in FPS mode
+      // FPS mode: cast from screen centre
      _pointer.set(0, 0);
      _raycaster.setFromCamera(_pointer, _camera);
+      // Check registered click targets first
+      for (const target of _clickTargets) {
+        if (!target.group.visible) continue;
+        const hits = _raycaster.intersectObject(target.group, true);
+        if (hits.length > 0) {
+          target.callback();
+          event.stopImmediatePropagation();
+          return;
+        }
+      }
      if (_timmyGroup && _applySlap) {
        const hits = _raycaster.intersectObject(_timmyGroup, true);
        if (hits.length > 0) {
@@ -157,6 +193,9 @@ function _onPointerDown(event) {
          event.stopImmediatePropagation();
        }
      }
+    } else {
+      // Not in pointer lock — still handle click targets (e.g. power meter)
+      _tryClickTargets(event.clientX, event.clientY);
    }
  }
 }
--- a/the-matrix/js/main.js
+++ b/the-matrix/js/main.js
@@ -7,10 +7,10 @@ import {
 } from './agents.js';
 import { initEffects, updateEffects, disposeEffects, updateJobIndicators } from './effects.js';
 import { initUI, updateUI } from './ui.js';
-import { initInteraction, disposeInteraction, registerSlapTarget } from './interaction.js';
+import { initInteraction, disposeInteraction, registerSlapTarget, registerClickTarget } from './interaction.js';
 import { initWebSocket, getConnectionState, getJobCount } from './websocket.js';
 import { initPaymentPanel } from './payment.js';
-import { initSessionPanel } from './session.js';
+import { initSessionPanel, openSessionPanel } from './session.js';
 import { initNostrIdentity } from './nostr-identity.js';
 import { warmup as warmupEdgeWorker, onReady as onEdgeWorkerReady } from './edge-worker-client.js';
 import { setEdgeWorkerReady } from './ui.js';
@@ -18,6 +18,7 @@ import { initTimmyId } from './timmy-id.js';
 import { AGENT_DEFS } from './agent-defs.js';
 import { initNavigation, updateNavigation, disposeNavigation } from './navigation.js';
 import { initHudLabels, updateHudLabels, disposeHudLabels } from './hud-labels.js';
+import { initPowerMeter, updatePowerMeter, disposePowerMeter, getMeterGroup } from './power-meter.js';

 let running = false;
 let canvas  = null;
@@ -29,6 +30,7 @@ function buildWorld(firstInit, stateSnapshot) {

  initEffects(scene);
  initAgents(scene);
+  initPowerMeter(scene);

  if (stateSnapshot) applyAgentStates(stateSnapshot);

@@ -37,6 +39,7 @@ function buildWorld(firstInit, stateSnapshot) {

  initInteraction(camera, renderer);
  registerSlapTarget(getTimmyGroup(), applySlap);
+  registerClickTarget(getMeterGroup(), openSessionPanel);

  // AR floating labels
  initHudLabels(camera, AGENT_DEFS, TIMMY_WORLD_POS);
@@ -82,6 +85,7 @@ function buildWorld(firstInit, stateSnapshot) {
    updateEffects(now);
    updateAgents(now);
    updateJobIndicators(now);
+    updatePowerMeter(now, camera, renderer);
    updateUI({
      fps: currentFps,
      agentCount: getAgentCount(),
@@ -121,6 +125,7 @@ function teardown({ scene, renderer, ac }) {
  disposeNavigation();
  disposeInteraction();
  disposeHudLabels();
+  disposePowerMeter();
  disposeEffects();
  disposeAgents();
  disposeWorld(renderer, scene);
--- a/the-matrix/js/power-meter.js
+++ b/the-matrix/js/power-meter.js
@@ -0,0 +1,291 @@
+/**
+ * power-meter.js — 3D Session Power Meter
+ *
+ * A glowing orb that fills proportionally to the session balance.
+ * - Pulses brightly on payment received
+ * - Drains visibly on job cost deduction
+ * - Visible only when a funded session is active
+ * - Clicking the meter opens the session panel
+ */
+
+import * as THREE from 'three';
+
+// ── World position (bottom-right corner, visible from default camera) ──────────
+const METER_WORLD_POS = new THREE.Vector3(4.5, 0.85, 2.0);
+const DEFAULT_MAX_SATS = 5000;
+
+// ── Module state ───────────────────────────────────────────────────────────────
+let _scene         = null;
+let _meterGroup    = null;
+let _innerOrb      = null;
+let _outerShell    = null;
+let _boltMesh      = null;
+let _orbMat        = null;
+let _shellMat      = null;
+let _meterLight    = null;
+let _labelEl       = null;
+
+let _fillFraction   = 0;     // 0..1, currently displayed fill
+let _targetFill     = 0;     // 0..1, desired fill
+let _pulseIntensity = 0;     // 0..1, extra brightness from pulse
+let _pulseDecay     = 0;     // per-frame decay rate
+let _visible        = false;
+let _maxSats        = DEFAULT_MAX_SATS;
+let _currentSats    = 0;
+
+// ── Public API ─────────────────────────────────────────────────────────────────
+
+export function initPowerMeter(scene) {
+  _scene = scene;
+  _labelEl = _createLabelEl();
+
+  _meterGroup = new THREE.Group();
+  _meterGroup.position.copy(METER_WORLD_POS);
+  _meterGroup.visible = false;
+
+  // Outer transparent shell
+  _shellMat = new THREE.MeshPhysicalMaterial({
+    color: 0x00aacc,
+    emissive: 0x003344,
+    emissiveIntensity: 0.4,
+    transparent: true,
+    opacity: 0.18,
+    roughness: 0.05,
+    metalness: 0.15,
+    side: THREE.DoubleSide,
+  });
+  _outerShell = new THREE.Mesh(new THREE.SphereGeometry(0.48, 24, 18), _shellMat);
+  _meterGroup.add(_outerShell);
+
+  // Equatorial ring accent
+  const ringMat = new THREE.MeshBasicMaterial({
+    color: 0x00ccff,
+    transparent: true,
+    opacity: 0.55,
+  });
+  const ring = new THREE.Mesh(new THREE.TorusGeometry(0.48, 0.012, 8, 40), ringMat);
+  ring.rotation.x = Math.PI / 2;
+  _meterGroup.add(ring);
+
+  // Inner fill orb — scales with balance
+  _orbMat = new THREE.MeshStandardMaterial({
+    color: 0x00ffcc,
+    emissive: 0x00ffcc,
+    emissiveIntensity: 1.4,
+    roughness: 0.05,
+    transparent: true,
+    opacity: 0.90,
+  });
+  _innerOrb = new THREE.Mesh(new THREE.SphereGeometry(0.38, 20, 16), _orbMat);
+  _innerOrb.scale.setScalar(0.01);
+  _meterGroup.add(_innerOrb);
+
+  // Lightning bolt — flat shape rendered in front of sphere
+  _boltMesh = _makeBolt();
+  _boltMesh.position.set(0, 0, 0.50);
+  _meterGroup.add(_boltMesh);
+
+  // Point light — intensity tracks balance + pulse
+  _meterLight = new THREE.PointLight(0x00ccff, 0.0, 6);
+  _meterGroup.add(_meterLight);
+
+  scene.add(_meterGroup);
+  return _meterGroup;
+}
+
+/**
+ * Update balance and target fill level.
+ * @param {number} sats        Current balance in satoshis
+ * @param {number} [maxSats]   Session deposit cap (sets the "full" reference)
+ */
+export function setMeterBalance(sats, maxSats) {
+  _currentSats = Math.max(0, sats);
+  if (maxSats !== undefined && maxSats > 0) _maxSats = maxSats;
+  _targetFill = Math.min(1, _currentSats / _maxSats);
+  if (_labelEl) _labelEl.textContent = `${_currentSats} ⚡`;
+}
+
+/**
+ * Fire a pulse animation on the meter.
+ * @param {'fill'|'drain'} type
+ */
+export function triggerMeterPulse(type) {
+  if (type === 'fill') {
+    _pulseIntensity = 1.0;
+    _pulseDecay     = 0.022; // slow bright flash
+  } else {
+    _pulseIntensity = 0.45;
+    _pulseDecay     = 0.040; // quick drain flicker
+  }
+}
+
+/** Show or hide the power meter and its text label. */
+export function setMeterVisible(visible) {
+  _visible = visible;
+  if (_meterGroup) _meterGroup.visible = visible;
+  if (_labelEl) _labelEl.style.display = visible ? 'block' : 'none';
+  if (!visible) {
+    _pulseIntensity = 0;
+    _fillFraction   = 0;
+    _targetFill     = 0;
+    if (_innerOrb) _innerOrb.scale.setScalar(0.01);
+    if (_meterLight) _meterLight.intensity = 0;
+  }
+}
+
+/** Returns the Three.js Group for raycasting. */
+export function getMeterGroup() {
+  return _meterGroup;
+}
+
+/**
+ * Called every animation frame.
+ * @param {number} now       performance.now() value
+ * @param {THREE.Camera} camera
+ * @param {THREE.WebGLRenderer} renderer
+ */
+export function updatePowerMeter(now, camera, renderer) {
+  if (!_meterGroup || !_visible) return;
+
+  const t = now * 0.001;
+
+  // Smooth fill toward target
+  _fillFraction += (_targetFill - _fillFraction) * 0.06;
+
+  const s = Math.max(0.01, _fillFraction * 0.94);
+  _innerOrb.scale.setScalar(s);
+
+  // Colour interpolation: empty=red → mid=orange/yellow → full=cyan
+  _updateOrbColor(_fillFraction, _pulseIntensity);
+
+  // Pulse decay
+  if (_pulseIntensity > 0) {
+    _pulseIntensity = Math.max(0, _pulseIntensity - _pulseDecay);
+  }
+
+  // Point light
+  _meterLight.intensity = _fillFraction * 1.6 + _pulseIntensity * 4.5;
+
+  // Shell emissive pulse
+  _shellMat.emissiveIntensity = 0.3 + _pulseIntensity * 1.8 + _fillFraction * 0.35;
+
+  // Gentle bob + slow rotation
+  _meterGroup.position.y = METER_WORLD_POS.y + Math.sin(t * 1.4) * 0.06;
+  _meterGroup.rotation.y = t * 0.35;
+
+  // Bolt scale pulses with balance and on payment
+  const boltS = 1.0 + _pulseIntensity * 0.55 + Math.sin(t * 3.2) * 0.05;
+  _boltMesh.scale.setScalar(boltS);
+
+  // DOM label
+  if (_labelEl && camera && renderer) {
+    _updateLabelPosition(camera, renderer);
+  }
+}
+
+export function disposePowerMeter() {
+  if (_meterGroup && _scene) {
+    _scene.remove(_meterGroup);
+    _meterGroup.traverse(child => {
+      if (child.geometry) child.geometry.dispose();
+      if (child.material) {
+        const mats = Array.isArray(child.material) ? child.material : [child.material];
+        mats.forEach(m => m.dispose());
+      }
+    });
+    _meterGroup = null;
+  }
+  if (_labelEl) {
+    _labelEl.remove();
+    _labelEl = null;
+  }
+  _scene = null;
+}
+
+// ── Internals ──────────────────────────────────────────────────────────────────
+
+function _makeBolt() {
+  const shape = new THREE.Shape();
+  shape.moveTo( 0.075,  0.28);
+  shape.lineTo(-0.030,  0.04);
+  shape.lineTo( 0.040,  0.04);
+  shape.lineTo(-0.075, -0.28);
+  shape.lineTo( 0.030, -0.04);
+  shape.lineTo(-0.040, -0.04);
+  shape.closePath();
+
+  const mat = new THREE.MeshBasicMaterial({
+    color: 0xffee00,
+    side: THREE.DoubleSide,
+    transparent: true,
+    opacity: 0.95,
+  });
+  return new THREE.Mesh(new THREE.ShapeGeometry(shape), mat);
+}
+
+function _updateOrbColor(fill, pulse) {
+  let r, g, b;
+  if (fill < 0.5) {
+    const k = fill * 2;          // 0→1
+    r = 1.0 - k * 0.30;          // 1.00 → 0.70
+    g = k * 0.70;                 // 0.00 → 0.70
+    b = k * 0.20;                 // 0.00 → 0.20
+  } else {
+    const k = (fill - 0.5) * 2;  // 0→1
+    r = 0.70 - k * 0.70;         // 0.70 → 0.00
+    g = 0.70 + k * 0.30;         // 0.70 → 1.00
+    b = 0.20 + k * 0.80;         // 0.20 → 1.00
+  }
+
+  // Pulse brightens toward white
+  const pr = r + pulse * (1 - r);
+  const pg = g + pulse * (1 - g);
+  const pb = b + pulse * (1 - b);
+
+  _orbMat.color.setRGB(pr, pg, pb);
+  _orbMat.emissive.setRGB(pr * 0.8, pg * 0.8, pb * 0.8);
+  _orbMat.emissiveIntensity = 1.0 + fill * 0.8 + pulse * 2.5;
+
+  _meterLight.color.setRGB(pr, pg, pb);
+}
+
+function _createLabelEl() {
+  const el = document.createElement('div');
+  el.style.cssText = [
+    'position:fixed',
+    'pointer-events:none',
+    'color:#00ffee',
+    'font-size:11px',
+    'font-family:monospace',
+    'font-weight:bold',
+    'text-align:center',
+    'text-shadow:0 0 6px #00ffcc,0 0 14px #00aaff',
+    'display:none',
+    'z-index:50',
+    'transform:translateX(-50%)',
+    'white-space:nowrap',
+  ].join(';');
+  document.body.appendChild(el);
+  return el;
+}
+
+function _updateLabelPosition(camera, renderer) {
+  const canvas = renderer.domElement;
+  const rect   = canvas.getBoundingClientRect();
+
+  // Project a point slightly above the orb center
+  const worldPos = METER_WORLD_POS.clone();
+  worldPos.y += 0.72;
+  worldPos.project(camera);
+
+  if (worldPos.z > 1) {          // behind camera
+    _labelEl.style.display = 'none';
+    return;
+  }
+
+  _labelEl.style.display = 'block';
+  const x = rect.left + ( worldPos.x *  0.5 + 0.5) * rect.width;
+  const y = rect.top  + (-worldPos.y *  0.5 + 0.5) * rect.height;
+  _labelEl.style.left = `${x}px`;
+  _labelEl.style.top  = `${y}px`;
+}
--- 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 { setMeterBalance, triggerMeterPulse, setMeterVisible } from './power-meter.js';

 const API          = '/api';
 const LS_KEY       = 'timmy_session_v1';
@@ -33,6 +34,7 @@ let _pollTimer     = null;
 let _inFlight      = false;
 let _selectedSats  = 500;  // deposit amount selection
 let _topupSats     = 500;  // topup amount selection
+let _sessionMax    = 500;  // max sats for this session (initial deposit)

 // ── Public API ────────────────────────────────────────────────────────────────

@@ -105,6 +107,11 @@ export function isSessionActive() {
  return _sessionState === 'active' || _sessionState === 'paused';
 }

+/** Public entry-point used by the 3D power meter click handler. */
+export function openSessionPanel() {
+  _openPanel();
+}
+
 // Called by ui.js when user submits the input bar while session is active
 export async function sessionSendHandler(text) {
  if (!_sessionId || !_macaroon || _inFlight) return;
@@ -156,6 +163,7 @@ export async function sessionSendHandler(text) {
    _sessionState = _balanceSats < MIN_BALANCE ? 'paused' : 'active';
    _saveToStorage();
    _applySessionUI();
+    triggerMeterPulse('drain');

    const reply = data.result || data.reason || '…';
    setSpeechBubble(reply);
@@ -287,9 +295,11 @@ function _startDepositPolling() {
      if (data.state === 'active') {
        _macaroon     = data.macaroon;
        _balanceSats  = data.balanceSats;
+        _sessionMax   = _balanceSats; // initial deposit = full bar
        _sessionState = 'active';
        _saveToStorage();
        _applySessionUI();
+        triggerMeterPulse('fill');
        _closePanel(); // panel auto-closes; user types in input bar
        appendSystemMessage(`Session active — ${_balanceSats} sats`);
        return;
@@ -404,8 +414,10 @@ function _startTopupPolling() {
        _balanceSats  = data.balanceSats;
        _macaroon     = data.macaroon || _macaroon;
        _sessionState = data.state === 'active' ? 'active' : _sessionState;
+        _sessionMax   = Math.max(_sessionMax, _balanceSats);
        _saveToStorage();
        _applySessionUI();
+        triggerMeterPulse('fill');
        _setStep('active');
        _updateActiveStep();
        _setStatus('active', `⚡ Topped up! ${_balanceSats} sats`, '#22aa66');
@@ -512,6 +524,10 @@ function _applySessionUI() {
  // Low balance notice above input bar
  const $notice = document.getElementById('low-balance-notice');
  if ($notice) $notice.style.display = lowBal ? '' : 'none';
+
+  // 3D power meter visibility
+  setMeterVisible(anyActive);
+  if (anyActive) setMeterBalance(_balanceSats, _sessionMax);
 }

 function _updateActiveStep() {
@@ -530,7 +546,9 @@ function _clearSession() {
  _macaroon     = null;
  _balanceSats  = 0;
  _sessionState = null;
+  _sessionMax   = 500;
  localStorage.removeItem(LS_KEY);
+  setMeterVisible(false);
  setInputBarSessionMode(false);
  setSessionSendHandler(null);
  const $hud = document.getElementById('session-hud');
--- a/the-matrix/js/ui.js
+++ b/the-matrix/js/ui.js
@@ -480,489 +480,6 @@ async function _fetchAndRenderHeatmap() {
  }
 }

-import { sendVisitorMessage } from './websocket.js';
-import { classify } from './edge-worker-client.js';
-import { setMood, setSpeechBubble } from './agents.js';
-import { getOrRefreshToken, getPubkey, disconnectNostrIdentity, showIdentityPrompt } from './nostr-identity.js';
-
-const $fps        = document.getElementById('fps');
-const $activeJobs = document.getElementById('active-jobs');
-const $connStatus = document.getElementById('connection-status');
-const $log        = document.getElementById('event-log');
-
-const MAX_LOG = 6;
-const logEntries = [];
-let uiInitialized = false;
-
-// ── Session-mode send override ────────────────────────────────────────────────
-let _sessionSendHandler = null;
-
-export function setSessionSendHandler(fn) {
-  _sessionSendHandler = fn;
-}
-
-export function setInputBarSessionMode(active, placeholder) {
-  const $input = document.getElementById('visitor-input');
-  if (!$input) return;
-  if (active) {
-    $input.classList.add('session-active');
-    $input.placeholder = placeholder || 'Ask Timmy (session active)…';
-  } else {
-    $input.classList.remove('session-active');
-    $input.placeholder = 'Say something to Timmy…';
-  }
-}
-
-// ── Model-ready indicator ─────────────────────────────────────────────────────
-// A small badge on the input bar showing when local AI is warm and ready.
-// Hidden until the first `ready` event from the edge worker.
-
-let $readyBadge = null;
-
-export function setEdgeWorkerReady() {
-  if (!$readyBadge) {
-    $readyBadge = document.createElement('span');
-    $readyBadge.id = 'edge-ready-badge';
-    $readyBadge.title = 'Local AI active — trivial queries answered without Lightning payment';
-    $readyBadge.style.cssText = [
-      'font-size:10px;color:#44cc88;border:1px solid #226644',
-      'border-radius:3px;padding:1px 5px;margin-left:6px',
-      'vertical-align:middle;cursor:default',
-    ].join(';');
-    $readyBadge.textContent = '⚡ local AI';
-    const $input = document.getElementById('visitor-input');
-    $input?.insertAdjacentElement('afterend', $readyBadge);
-    // Fallback: append to send button area
-    if (!$readyBadge.isConnected) {
-      document.getElementById('send-btn')?.insertAdjacentElement('afterend', $readyBadge);
-    }
-  }
-  $readyBadge.style.display = '';
-}
-
-// ── Cost preview badge ────────────────────────────────────────────────────────
-// Shown beneath the input bar: "~N sats" / "FREE" / "answered locally".
-// Fetched from GET /api/estimate once the user stops typing (300 ms debounce).
-
-let _estimateTimer = null;
-let $costPreview = null;
-
-function _ensureCostPreview() {
-  if ($costPreview) return $costPreview;
-  $costPreview = document.getElementById('timmy-cost-preview');
-  if (!$costPreview) {
-    $costPreview = document.createElement('div');
-    $costPreview.id = 'timmy-cost-preview';
-    $costPreview.style.cssText = 'font-size:11px;color:#88aacc;margin-top:3px;min-height:14px;transition:opacity .3s;opacity:0;';
-    const $input = document.getElementById('visitor-input');
-    $input?.parentElement?.appendChild($costPreview);
-  }
-  return $costPreview;
-}
-
-function _showCostPreview(text, color = '#88aacc') {
-  const el = _ensureCostPreview();
-  el.textContent = text;
-  el.style.color  = color;
-  el.style.opacity = '1';
-}
-
-function _hideCostPreview() {
-  const el = _ensureCostPreview();
-  el.style.opacity = '0';
-}
-
-async function _fetchEstimate(text) {
-  try {
-    const token = await getOrRefreshToken('/api');
-    const params = new URLSearchParams({ request: text });
-    const fetchOpts = {};
-    if (token) {
-      fetchOpts.headers = { 'X-Nostr-Token': token };
-    }
-
-    const res = await fetch(`/api/estimate?${params}`, fetchOpts);
-    if (!res.ok) return;
-    const data = await res.json();
-
-    const ft = data.identity?.free_tier;
-    if (ft?.serve === 'free') {
-      _showCostPreview('FREE via generosity pool', '#44dd88');
-    } else if (ft?.serve === 'partial') {
-      _showCostPreview(`~${ft.chargeSats} sats (${ft.absorbSats} absorbed)`, '#ffdd44');
-    } else {
-      const sats = data.estimatedSats ?? '?';
-      _showCostPreview(`~${sats} sats estimated`, '#88aacc');
-    }
-  } catch {
-    _hideCostPreview();
-  }
-}
-
-// Fast trivial heuristic — same pattern as edge-worker.js _isGreeting().
-// Prevents /api/estimate network calls for greeting messages on every keypress.
-const _TRIVIAL_RE = /^(hi|hey|hello|howdy|greetings|yo|sup|hiya|what'?s up)[!?.,]?\s*$/i;
-
-function _scheduleCostPreview(text) {
-  clearTimeout(_estimateTimer);
-  if (!text || text.length < 4) { _hideCostPreview(); return; }
-  // Skip estimate entirely for trivially local messages — zero network calls
-  if (_TRIVIAL_RE.test(text.trim())) {
-    _showCostPreview('answered locally ⚡ 0 sats', '#44dd88');
-    return;
-  }
-  _estimateTimer = setTimeout(() => _fetchEstimate(text), 300);
-}
-
-// ── Live cost ticker ──────────────────────────────────────────────────────────
-// Shown in the top-right HUD during active paid interactions.
-// Updated via WebSocket `cost_update` messages from the backend.
-
-let $costTicker = null;
-let _tickerHideTimer = null;
-
-function _ensureCostTicker() {
-  if ($costTicker) return $costTicker;
-  $costTicker = document.getElementById('timmy-cost-ticker');
-  if (!$costTicker) {
-    $costTicker = document.createElement('div');
-    $costTicker.id = 'timmy-cost-ticker';
-    $costTicker.style.cssText = [
-      'position:fixed;top:36px;right:16px',
-      'font-size:11px;font-family:"Courier New",monospace',
-      'color:#ffcc44;text-shadow:0 0 6px #aa8822',
-      'letter-spacing:1px',
-      'pointer-events:none;z-index:10',
-      'transition:opacity .4s;opacity:0',
-    ].join(';');
-    document.body.appendChild($costTicker);
-  }
-  return $costTicker;
-}
-
-export function showCostTicker(sats) {
-  clearTimeout(_tickerHideTimer);
-  const el = _ensureCostTicker();
-  el.textContent = `⚡ ~${sats} sats`;
-  el.style.opacity = '1';
-}
-
-export function updateCostTicker(sats, isFinal = false) {
-  clearTimeout(_tickerHideTimer);
-  const el = _ensureCostTicker();
-  el.textContent = isFinal ? `⚡ ${sats} sats charged` : `⚡ ~${sats} sats`;
-  el.style.opacity = '1';
-  if (isFinal) {
-    _tickerHideTimer = setTimeout(hideCostTicker, 5000);
-  }
-}
-
-export function hideCostTicker() {
-  if (!$costTicker) return;
-  $costTicker.style.opacity = '0';
-}
-
-// ── Nostr identity UI ─────────────────────────────────────────────────────────
-
-let _nostrStatusEl       = null;
-let _connectNostrBtn     = null;
-let _disconnectNostrBtn  = null;
-let _nostrPubkeyDisplay  = null;
-let _getAlbyBtn          = null;
-
-export function initNostrIdentityUI() {
-  _nostrStatusEl = document.getElementById('nostr-identity-status');
-  if (!_nostrStatusEl) return;
-
-  _nostrStatusEl.innerHTML = `
-    <button id="connect-nostr-btn" class="nostr-btn">⚡ Connect Nostr</button>
-    <span id="nostr-pubkey-display" class="nostr-pubkey"></span>
-    <button id="disconnect-nostr-btn" class="nostr-btn nostr-btn-sm">Disconnect</button>
-    <button id="get-alby-btn" class="nostr-btn nostr-btn-sm">Get Alby</button>
-  `;
-
-  _connectNostrBtn    = document.getElementById('connect-nostr-btn');
-  _disconnectNostrBtn = document.getElementById('disconnect-nostr-btn');
-  _nostrPubkeyDisplay = document.getElementById('nostr-pubkey-display');
-  _getAlbyBtn         = document.getElementById('get-alby-btn');
-
-  if (_connectNostrBtn) {
-    _connectNostrBtn.addEventListener('click', () => {
-      showIdentityPrompt('/api');
-    });
-  }
-
-  if (_disconnectNostrBtn) {
-    _disconnectNostrBtn.addEventListener('click', () => {
-      disconnectNostrIdentity();
-      _updateNostrIdentityUI(null);
-    });
-  }
-
-  window.addEventListener('nostr:identity-ready', e => {
-    _updateNostrIdentityUI(e.detail.pubkey);
-  });
-
-  window.addEventListener('nostr:identity-disconnected', () => {
-    _updateNostrIdentityUI(null);
-  });
-
-  _updateNostrIdentityUI(getPubkey());
-}
-
-function _updateNostrIdentityUI(pubkey) {
-  const hasNip07 = typeof window !== 'undefined' && !!window.nostr;
-
-  if (pubkey) {
-    const formattedPubkey = pubkey.slice(0, 8) + '…' + pubkey.slice(-4);
-    if (_nostrPubkeyDisplay) {
-      _nostrPubkeyDisplay.textContent = `⚡ ${formattedPubkey}`;
-      _nostrPubkeyDisplay.style.display = 'inline-block';
-    }
-    if (_connectNostrBtn)    _connectNostrBtn.style.display = 'none';
-    if (_disconnectNostrBtn) _disconnectNostrBtn.style.display = 'inline-block';
-    if (_getAlbyBtn)         _getAlbyBtn.style.display = 'none';
-  } else {
-    if (_nostrPubkeyDisplay) _nostrPubkeyDisplay.style.display = 'none';
-    if (_disconnectNostrBtn) _disconnectNostrBtn.style.display = 'none';
-
-    if (hasNip07) {
-      if (_connectNostrBtn) {
-        _connectNostrBtn.textContent = '⚡ Connect Nostr';
-        _connectNostrBtn.style.display = 'inline-block';
-      }
-      if (_getAlbyBtn) _getAlbyBtn.style.display = 'none';
-    } else {
-      if (_connectNostrBtn) _connectNostrBtn.style.display = 'none';
-      if (_getAlbyBtn) {
-        _getAlbyBtn.textContent = 'Get Alby';
-        _getAlbyBtn.style.display = 'inline-block';
-        _getAlbyBtn.title = 'Install Alby or another NIP-07 extension to connect your Nostr identity';
-        _getAlbyBtn.onclick = () => window.open('https://getalby.com/', '_blank');
-      }
-    }
-  }
-}
-
-
-// ── Input bar ─────────────────────────────────────────────────────────────────
-
-export function initUI() {
-  if (uiInitialized) return;
-  uiInitialized = true;
-  initInputBar();
-  initHeatmap();
-  initNostrIdentityUI();
-  initStatsPanel(); // Initialize the new stats panel
-}
-
-function initInputBar() {
-  const $input   = document.getElementById('visitor-input');
-  const $sendBtn = document.getElementById('send-btn');
-  if (!$input || !$sendBtn) return;
-
-  $input.addEventListener('input', () => _scheduleCostPreview($input.value.trim()));
-
-  async function send() {
-    const text = $input.value.trim();
-    if (!text) return;
-    $input.value = '';
-    _hideCostPreview();
-
-    // ── Edge triage — runs in BOTH session mode and WebSocket mode ─────────────
-    // Worker returns { complexity:'trivial'|'moderate'|'complex', score, reason, localReply? }
-    const cls = await classify(text);
-
-    if (cls.complexity === 'trivial' && cls.localReply) {
-      // Greeting / small-talk → answer locally, 0 sats, no network call in any mode
-      appendSystemMessage(`you: ${text}`);
-      setSpeechBubble(`${cls.localReply} ⚡ local`);
-      _showCostPreview('answered locally ⚡ 0 sats', '#44dd88');
-      setTimeout(_hideCostPreview, 3000);
-      return;
-    }
-
-    // Non-trivial: delegate to session handler (if active) or WebSocket
-    if (_sessionSendHandler) {
-      // moderate/complex — fire estimate async for cost preview, then hand off
-      if (cls.complexity === 'moderate' || cls.complexity === 'complex') {
-        _fetchEstimate(text);
-      }
-      _sessionSendHandler(text);
-      return;
-    }
-
-    // moderate or complex — fetch cost estimate (driven by complexity outcome),
-    // then route to server via WebSocket.
-    if (cls.complexity === 'moderate' || cls.complexity === 'complex') {
-      _fetchEstimate(text);
-    }
-
-    // Route to server via WebSocket
-    sendVisitorMessage(text);
-    appendSystemMessage(`you: ${text}`);
-  }
-
-  $sendBtn.addEventListener('click', send);
-  $input.addEventListener('keydown', e => {
-    if (e.key === 'Enter' && !e.shiftKey) { e.preventDefault(); send(); }
-  });
-}
-
-export function updateUI({ fps, jobCount, connectionState }) {
-  if ($fps) $fps.textContent = `FPS: ${fps}`;
-  if ($activeJobs) $activeJobs.textContent = `JOBS: ${jobCount}`;
-
-  if ($connStatus) {
-    if (connectionState === 'connected') {
-      $connStatus.textContent = '● CONNECTED';
-      $connStatus.className   = 'connected';
-    } else if (connectionState === 'connecting') {
-      $connStatus.textContent = '◌ CONNECTING...';
-      $connStatus.className   = '';
-    } else {
-      $connStatus.textContent = '○ OFFLINE';
-      $connStatus.className   = '';
-    }
-  }
-}
-
-export function appendSystemMessage(text) {
-  if (!$log) return;
-  const el = document.createElement('div');
-  el.className = 'log-entry';
-  el.textContent = text;
-  logEntries.push(el);
-  if (logEntries.length > MAX_LOG) {
-    const removed = logEntries.shift();
-    $log.removeChild(removed);
-  }
-  $log.appendChild(el);
-  $log.scrollTop = $log.scrollHeight;
-}
-
-export function appendChatMessage(agentLabel, message, cssColor, agentId) {
-  void agentLabel; void cssColor; void agentId;
-  appendSystemMessage(message);
-}
-
-/**
- * Render a debate argument or verdict in the event log (#21).
- * Visually distinct from regular chat: colored by agent with a debate prefix.
- */
-export function appendDebateMessage(agent, argument, isVerdict, accepted) {
-  if (!$log) return;
-  const el = document.createElement('div');
-  el.className = 'log-entry debate-entry';
-  if (isVerdict) {
-    el.classList.add('debate-verdict');
-    el.classList.add(accepted ? 'debate-accepted' : 'debate-rejected');
-    el.textContent = `⚖ ${agent}: ${argument}`;
-  } else {
-    el.classList.add(agent === 'Beta-A' ? 'debate-a' : 'debate-b');
-    el.textContent = `⚖ ${agent}: ${(argument || '').slice(0, 120)}`;
-  }
-  logEntries.push(el);
-  if (logEntries.length > MAX_LOG) {
-    const removed = logEntries.shift();
-    $log.removeChild(removed);
-  }
-  $log.appendChild(el);
-  $log.scrollTop = $log.scrollHeight;
-}
-
-export function loadChatHistory() { return []; }
-export function saveChatHistory() {}
-
-// ── Activity heatmap (#9) ─────────────────────────────────────────────────────
-// Fetches /api/stats/activity and renders a 24-segment heatmap.
-// Auto-refreshes every 5 minutes. On mobile, collapses to an icon that opens
-// a full-screen overlay.
-
-const HEATMAP_REFRESH_MS = 5 * 60 * 1000; // 5 minutes
-let _heatmapTimer = null;
-let _lastHours = null; // number[24] cached for overlay re-render
-
-/** Convert an hour index (0 = oldest, 23 = current) to a UTC hour label like "3pm" or "midnight". */
-function _hourLabel(hourIndex) {
-  const now = new Date();
-  const currentHour = now.getUTCHours();
-  // slot 23 = current UTC hour, slot 0 = 23 hours ago
-  const h = ((currentHour - (23 - hourIndex)) % 24 + 24) % 24;
-  if (h === 0) return 'midnight';
-  if (h === 12) return 'noon';
-  return h < 12 ? `${h}am` : `${h - 12}pm`;
-}
-
-/** Interpolate from dim blue (#111133) to bright blue-white (#88ccff) based on 0–1 intensity. */
-function _segmentColor(intensity) {
-  // dim: [17, 17, 51]  bright: [136, 204, 255]
-  const r = Math.round(17  + (136 - 17)  * intensity);
-  const g = Math.round(17  + (204 - 17)  * intensity);
-  const b = Math.round(51  + (255 - 51)  * intensity);
-  return `rgb(${r},${g},${b})`;
-}
-
-function _renderSegments(hours, container, isMobile) {
-  container.innerHTML = '';
-  const max = Math.max(...hours, 1); // avoid div-by-zero
-  const currentSlot = 23;
-
-  hours.forEach((count, i) => {
-    const seg = document.createElement('div');
-    seg.className = 'hm-seg' + (i === currentSlot ? ' hm-seg-current' : '');
-    const intensity = count / max;
-    const color = _segmentColor(intensity);
-    seg.style.background = color;
-    if (i === currentSlot) seg.style.color = color; // used by pulse animation
-    seg.dataset.index = String(i);
-    seg.dataset.count = String(count);
-    if (isMobile) {
-      seg.style.width = '14px';
-      seg.style.height = '28px';
-    }
-    container.appendChild(seg);
-  });
-}
-
-function _initHeatmapTooltip(barEl) {
-  const $tip = document.getElementById('heatmap-tooltip');
-  if (!$tip) return;
-
-  barEl.addEventListener('mousemove', e => {
-    const seg = e.target.closest('.hm-seg');
-    if (!seg) { $tip.style.display = 'none'; return; }
-    const i = Number(seg.dataset.index);
-    const count = Number(seg.dataset.count);
-    const label = _hourLabel(i);
-    $tip.textContent = `${label}: ${count} job${count !== 1 ? 's' : ''} submitted`;
-    $tip.style.display = 'block';
-    $tip.style.left = `${e.clientX + 10}px`;
-    $tip.style.top  = `${e.clientY - 24}px`;
-  });
-
-  barEl.addEventListener('mouseleave', () => { $tip.style.display = 'none'; });
-}
-
-async function _fetchAndRenderHeatmap() {
-  try {
-    const res = await fetch('/api/stats/activity');
-    if (!res.ok) return;
-    const data = await res.json();
-    const hours = Array.isArray(data.hours) ? data.hours : [];
-    if (hours.length !== 24) return;
-    _lastHours = hours;
-
-    const $bar = document.getElementById('heatmap-bar');
-    if ($bar) _renderSegments(hours, $bar, false);
-
-    const $overlayBar = document.getElementById('heatmap-overlay-bar');
-    if ($overlayBar) _renderSegments(hours, $overlayBar, true);
-  } catch {
-    // silently ignore fetch errors
-  }
-}
-
 export function initHeatmap() {
  const $bar      = document.getElementById('heatmap-bar');
  const $iconBtn  = document.getElementById('heatmap-icon-btn');
@@ -989,80 +506,3 @@ export function initHeatmap() {
  void _fetchAndRenderHeatmap();
  _heatmapTimer = setInterval(_fetchAndRenderHeatmap, HEATMAP_REFRESH_MS);
 }
-
-// ── Stats panel ──────────────────────────────────────────────────────────
-
-const STATS_REFRESH_MS = 30 * 1000; // 30 seconds
-let _statsRefreshTimer = null;
-
-let $openStatsBtn           = null;
-let $statsPanel             = null;
-let $statsCloseBtn          = null;
-let $totalJobsCompleted     = null;
-let $averageSelfEvalRating  = null;
-let $topRequestCategories   = null;
-let $totalSatsEarned        = null;
-let $satsEarned24h          = null;
-let $recentJobsList         = null;
-
-export function initStatsPanel() {
-  $openStatsBtn          = document.getElementById('open-stats-btn');
-  $statsPanel            = document.getElementById('stats-panel');
-  $statsCloseBtn         = document.getElementById('stats-close');
-  $totalJobsCompleted    = document.getElementById('total-jobs-completed');
-  $averageSelfEvalRating = document.getElementById('average-self-eval-rating');
-  $topRequestCategories  = document.getElementById('top-request-categories');
-  $totalSatsEarned       = document.getElementById('total-sats-earned');
-  $satsEarned24h         = document.getElementById('sats-earned-24h');
-  $recentJobsList        = document.getElementById('recent-jobs-list');
-
-  if ($openStatsBtn) {
-    $openStatsBtn.addEventListener('click', () => {
-      $statsPanel?.classList.add('open');
-      void _fetchAndRenderStats();
-      _statsRefreshTimer = setInterval(_fetchAndRenderStats, STATS_REFRESH_MS);
-    });
-  }
-
-  if ($statsCloseBtn) {
-    $statsCloseBtn.addEventListener('click', () => {
-      $statsPanel?.classList.remove('open');
-      clearInterval(_statsRefreshTimer);
-      _statsRefreshTimer = null;
-    });
-  }
-}
-
-async function _fetchAndRenderStats() {
-  try {
-    const res = await fetch('/api/stats');
-    if (!res.ok) return;
-    const data = await res.json();
-
-    if ($totalJobsCompleted)    $totalJobsCompleted.textContent    = data.totalJobsCompleted ?? '--';
-    if ($averageSelfEvalRating) $averageSelfEvalRating.textContent = (data.averageSelfEvalRating ?? 0).toFixed(1);
-    if ($topRequestCategories)  $topRequestCategories.textContent  = data.top3RequestCategories.join(', ') || 'None';
-    if ($totalSatsEarned)       $totalSatsEarned.textContent       = data.totalSatsEarned ?? '--';
-    if ($satsEarned24h)         $satsEarned24h.textContent         = data.satsEarnedLast24h ?? '--';
-
-    if ($recentJobsList) {
-      $recentJobsList.innerHTML = '';
-      data.last10CompletedJobs.forEach(job => {
-        const jobItem = document.createElement('div');
-        jobItem.className = 'recent-job-item';
-        jobItem.innerHTML = `
-          <div class="job-req">${job.request}</div>
-          <div class="job-meta">
-            <span class="job-rating">⭐ ${job.starRating ?? '-'}</span>
-            <span class="job-sats">⚡ ${job.satsCharged ?? '-'} sats</span>
-            <span class="job-time">${job.timeElapsed ?? '-'}s</span>
-            <span class="job-category">${job.category ?? '-'}</span>
-          </div>
-        `;
-        $recentJobsList?.appendChild(jobItem);
-      });
-    }
-  } catch (err) {
-    console.error('Failed to fetch and render stats:', err);
-  }
-}
--- a/the-matrix/js/websocket.js
+++ b/the-matrix/js/websocket.js
@@ -6,6 +6,7 @@ import { sentiment } from './edge-worker-client.js';
 import { setLabelState } from './hud-labels.js';
 import { createJobIndicator, dissolveJobIndicator } from './effects.js';
 import { getPubkey } from './nostr-identity.js';
+import { setMeterBalance, triggerMeterPulse } from './power-meter.js';

 function resolveWsUrl() {
  const explicit = import.meta.env.VITE_WS_URL;
@@ -190,6 +191,15 @@ function handleMessage(msg) {
      break;
    }

+    case 'session_balance_update': {
+      // Real-time balance push from server: animate fill level and pulse
+      if (typeof msg.balanceSats === 'number') {
+        setMeterBalance(msg.balanceSats, msg.maxSats);
+        triggerMeterPulse(msg.delta > 0 ? 'fill' : 'drain');
+      }
+      break;
+    }
+
    case 'agent_count':
    case 'visitor_count':
      break;