unbrowse 3.1.0 → 3.2.0

package/dist/cli.js

@@ -31,7 +31,7 @@ var __promiseAll = (args) => Promise.all(args);
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // ../../src/build-info.generated.ts
-var BUILD_RELEASE_VERSION = "3.1.0", BUILD_GIT_SHA = "c9f9ce0e5cb1", BUILD_CODE_HASH = "1488fc1d92b7", BUILD_RELEASE_MANIFEST_BASE64 = "eyJzY2hlbWFfdmVyc2lvbiI6MSwicmVsZWFzZV92ZXJzaW9uIjoiMy4xLjAiLCJnaXRfc2hhIjoiYzlmOWNlMGU1Y2IxIiwiY29kZV9oYXNoIjoiMTQ4OGZjMWQ5MmI3IiwidHJhY2VfdmVyc2lvbiI6IjE0ODhmYzFkOTJiN0BjOWY5Y2UwZTVjYjEiLCJpc3N1ZWRfYXQiOiIyMDI2LTA0LTA1VDA2OjUwOjA4LjQzNVoifQ", BUILD_RELEASE_MANIFEST_SIGNATURE = "_2pdxyoIEYkKUHO0nXaXTubP5SrZCa-8CqStcPBsXxw", BUILD_DEFAULT_BACKEND_URL = "https://beta-api.unbrowse.ai";
+var BUILD_RELEASE_VERSION = "3.2.0", BUILD_GIT_SHA = "c3fc3f822751", BUILD_CODE_HASH = "1488fc1d92b7", BUILD_RELEASE_MANIFEST_BASE64 = "eyJzY2hlbWFfdmVyc2lvbiI6MSwicmVsZWFzZV92ZXJzaW9uIjoiMy4yLjAiLCJnaXRfc2hhIjoiYzNmYzNmODIyNzUxIiwiY29kZV9oYXNoIjoiMTQ4OGZjMWQ5MmI3IiwidHJhY2VfdmVyc2lvbiI6IjE0ODhmYzFkOTJiN0BjM2ZjM2Y4MjI3NTEiLCJpc3N1ZWRfYXQiOiIyMDI2LTA0LTA2VDA1OjA2OjAxLjIwMFoifQ", BUILD_RELEASE_MANIFEST_SIGNATURE = "xCBEHEB2UsniVYLfzuTpoXlcomZHL2pXht-7Ii1e7mM", BUILD_DEFAULT_BACKEND_URL = "https://beta-api.unbrowse.ai";
 
 // ../../src/version.ts
 import { createHash } from "crypto";
@@ -400,7 +400,7 @@ var LOBSTER_PAY_TIMEOUT_MS = 30000, cachedCommand = undefined;
 var init_lobster_pay = () => {};
 
 // ../../src/runtime/paths.ts
-import { existsSync as existsSync5, mkdirSync as mkdirSync2, realpathSync } from "node:fs";
+import { existsSync as existsSync6, mkdirSync as mkdirSync3, realpathSync } from "node:fs";
 import os from "node:os";
 import path from "node:path";
 import { createRequire as createRequire2 } from "node:module";
@@ -414,7 +414,7 @@ function getPackageRoot(metaUrl) {
   let dir = getModuleDir(metaUrl);
   const root = path.parse(dir).root;
   while (dir !== root) {
-    if (existsSync5(path.join(dir, "package.json")))
+    if (existsSync6(path.join(dir, "package.json")))
       return dir;
     dir = path.dirname(dir);
   }
@@ -433,7 +433,7 @@ function runtimeArgsForEntrypoint(metaUrl, entrypoint) {
     const req = createRequire2(metaUrl);
     const tsxPkg = req.resolve("tsx/package.json");
     const tsxLoader = path.join(path.dirname(tsxPkg), "dist", "loader.mjs");
-    if (existsSync5(tsxLoader))
+    if (existsSync6(tsxLoader))
       return ["--import", pathToFileURL(tsxLoader).href, entrypoint];
   } catch {}
   return ["--import", "tsx", entrypoint];
@@ -441,16 +441,16 @@ function runtimeArgsForEntrypoint(metaUrl, entrypoint) {
 function getUnbrowseHome() {
   return path.join(os.homedir(), ".unbrowse");
 }
-function ensureDir(dir) {
-  if (!existsSync5(dir))
-    mkdirSync2(dir, { recursive: true });
+function ensureDir2(dir) {
+  if (!existsSync6(dir))
+    mkdirSync3(dir, { recursive: true });
   return dir;
 }
 function getLogsDir() {
-  return ensureDir(path.join(getUnbrowseHome(), "logs"));
+  return ensureDir2(path.join(getUnbrowseHome(), "logs"));
 }
 function getRunDir() {
-  return ensureDir(process.env.UNBROWSE_RUN_DIR || path.join(getUnbrowseHome(), "run"));
+  return ensureDir2(process.env.UNBROWSE_RUN_DIR || path.join(getUnbrowseHome(), "run"));
 }
 function sanitizeSegment(value) {
   return value.replace(/[^a-zA-Z0-9.-]+/g, "_");
@@ -586,7 +586,7 @@ var init_logger = __esm(() => {
 
 // ../../src/kuri/client.ts
 import { execFileSync as execFileSync2, spawn as spawn2 } from "node:child_process";
-import { existsSync as existsSync7 } from "node:fs";
+import { existsSync as existsSync9 } from "node:fs";
 import path5 from "node:path";
 function createBrokerState(port = KURI_DEFAULT_PORT) {
   return {
@@ -661,7 +661,7 @@ function findKuriBinary() {
   if (process.env.KURI_BIN)
     return process.env.KURI_BIN;
   const candidates = getKuriBinaryCandidates();
-  return candidates.find((candidate) => existsSync7(candidate)) ?? candidates[0] ?? kuriBinaryName();
+  return candidates.find((candidate) => existsSync9(candidate)) ?? candidates[0] ?? kuriBinaryName();
 }
 var KURI_DEFAULT_PORT = 7700, defaultBrokerState, brokerClients;
 var init_client2 = __esm(() => {
@@ -684,7 +684,7 @@ var init_browser_access = () => {};
 
 // ../../src/capture/index.ts
 import { nanoid as nanoid2 } from "nanoid";
-var activeTabRegistry, interceptorInjectedTabs;
+var activeTabRegistry, interceptorInjectedTabs, cdpDocStartTabs, cdpCapturedHeaders;
 var init_capture = __esm(() => {
   init_client2();
   init_domain();
@@ -692,6 +692,8 @@ var init_capture = __esm(() => {
   init_browser_access();
   activeTabRegistry = new Set;
   interceptorInjectedTabs = new Set;
+  cdpDocStartTabs = new Set;
+  cdpCapturedHeaders = new Map;
 });
 
 // ../../src/transform/index.ts
@@ -701,11 +703,11 @@ var init_transform = __esm(() => {
 });
 
 // ../../src/debug-trace.ts
-import { join as join5 } from "node:path";
+import { join as join6 } from "node:path";
 import { nanoid as nanoid3 } from "nanoid";
 var TRACE_DIR;
 var init_debug_trace = __esm(() => {
-  TRACE_DIR = process.env.TRACES_DIR ?? join5(process.cwd(), "traces");
+  TRACE_DIR = process.env.TRACES_DIR ?? join6(process.cwd(), "traces");
 });
 
 // ../../src/publish/sanitize.ts
@@ -794,9 +796,18 @@ var init_bundle_scanner = __esm(() => {
   init_logger();
 });
 
+// ../../src/reverse-engineer/token-sources.ts
+var init_token_sources = () => {};
+
+// ../../src/execution/token-resolver.ts
+var init_token_resolver = __esm(() => {
+  init_token_sources();
+  init_client2();
+});
+
 // ../../src/vault/index.ts
-import { join as join6 } from "path";
-import { homedir as homedir4 } from "os";
+import { join as join7 } from "path";
+import { homedir as homedir5 } from "os";
 function normalizeKeytarModule(mod) {
   let candidate = mod;
   for (let depth = 0;depth < 3; depth++) {
@@ -818,9 +829,9 @@ var init_vault = __esm(async () => {
   try {
     keytar = normalizeKeytarModule(await import("keytar"));
   } catch {}
-  VAULT_DIR = join6(homedir4(), ".unbrowse", "vault");
-  VAULT_FILE = join6(VAULT_DIR, "credentials.enc");
-  KEY_FILE = join6(VAULT_DIR, ".key");
+  VAULT_DIR = join7(homedir5(), ".unbrowse", "vault");
+  VAULT_FILE = join7(VAULT_DIR, "credentials.enc");
+  KEY_FILE = join7(VAULT_DIR, ".key");
   vaultLock = Promise.resolve();
 });
 
@@ -897,18 +908,6 @@ var init_extraction = __esm(() => {
   CHROME_TAGS = new Set(["nav", "footer", "header"]);
 });
 
-// ../../src/graph/agent-augment.ts
-var DEFAULT_MODEL, ENABLED, AUGMENT_TIMEOUT_MS, MAX_AUGMENT_ENDPOINTS, MAX_AUGMENT_PAYLOAD_CHARS, GENERIC_SEMANTIC_TYPES;
-var init_agent_augment = __esm(() => {
-  init_graph();
-  DEFAULT_MODEL = process.env.UNBROWSE_AGENT_SEMANTIC_MODEL ?? process.env.UNBROWSE_AGENT_JUDGE_MODEL ?? "gpt-4.1-mini";
-  ENABLED = process.env.UNBROWSE_AGENT_SEMANTIC_AUGMENT !== "0";
-  AUGMENT_TIMEOUT_MS = Number(process.env.UNBROWSE_AGENT_SEMANTIC_TIMEOUT_MS ?? 8000);
-  MAX_AUGMENT_ENDPOINTS = Math.max(1, Number(process.env.UNBROWSE_AGENT_SEMANTIC_MAX_ENDPOINTS ?? 6));
-  MAX_AUGMENT_PAYLOAD_CHARS = Math.max(4000, Number(process.env.UNBROWSE_AGENT_SEMANTIC_MAX_PAYLOAD_CHARS ?? 24000));
-  GENERIC_SEMANTIC_TYPES = new Set(["identifier", "input", "resource", "entity", "item"]);
-});
-
 // ../../src/execution/search-forms.ts
 var SEARCH_FIELD_NAMES, LOGIN_FIELD_NAMES, SUPPORTED_INPUT_TYPES;
 var init_search_forms = __esm(() => {
@@ -971,7 +970,7 @@ var init_schema_review = __esm(() => {
 });
 
 // ../../src/indexer/index.ts
-import { join as join7 } from "node:path";
+import { join as join8 } from "node:path";
 var SKILL_SNAPSHOT_DIR, indexInFlight, pendingIndexJobs;
 var init_indexer = __esm(async () => {
   init_graph();
@@ -986,7 +985,7 @@ var init_indexer = __esm(async () => {
   init_graph();
   init_schema_review();
   await init_orchestrator();
-  SKILL_SNAPSHOT_DIR = process.env.UNBROWSE_SKILL_SNAPSHOT_DIR ?? join7(process.env.HOME ?? "/tmp", ".unbrowse", "skill-snapshots");
+  SKILL_SNAPSHOT_DIR = process.env.UNBROWSE_SKILL_SNAPSHOT_DIR ?? join8(process.env.HOME ?? "/tmp", ".unbrowse", "skill-snapshots");
   indexInFlight = new Map;
   pendingIndexJobs = new Map;
 });
@@ -1024,6 +1023,7 @@ var init_execution = __esm(async () => {
   init_capture();
   init_reverse_engineer();
   init_bundle_scanner();
+  init_token_resolver();
   init_marketplace();
   init_runtime();
   init_transform();
@@ -1034,7 +1034,6 @@ var init_execution = __esm(async () => {
   init_domain();
   init_extraction();
   init_graph();
-  init_agent_augment();
   init_logger();
   init_version();
   init_search_forms();
@@ -1163,8 +1162,8 @@ var init_routing_telemetry = __esm(() => {
 });
 // ../../src/orchestrator/index.ts
 import { nanoid as nanoid9 } from "nanoid";
-import { existsSync as existsSync8, writeFileSync as writeFileSync3, readFileSync as readFileSync5, mkdirSync as mkdirSync4, readdirSync as readdirSync3 } from "node:fs";
-import { dirname as dirname2, join as join8 } from "node:path";
+import { existsSync as existsSync10, writeFileSync as writeFileSync3, readFileSync as readFileSync6, mkdirSync as mkdirSync5, readdirSync as readdirSync3 } from "node:fs";
+import { dirname as dirname3, join as join9 } from "node:path";
 var LIVE_CAPTURE_TIMEOUT_MS, capturedDomainCache, captureInFlight, captureDomainLocks, skillRouteCache, ROUTE_CACHE_FILE, SKILL_SNAPSHOT_DIR2, domainSkillCache, DOMAIN_CACHE_FILE, _routeCacheDirty = false, routeCacheFlushTimer, routeResultCache, ROUTE_CACHE_TTL, MARKETPLACE_HYDRATE_LIMIT, MARKETPLACE_GET_SKILL_TIMEOUT_MS, MARKETPLACE_DOMAIN_SEARCH_K, MARKETPLACE_GLOBAL_SEARCH_K, SEARCH_INTENT_STOPWORDS;
 var init_orchestrator = __esm(async () => {
   init_client();
@@ -1194,13 +1193,13 @@ var init_orchestrator = __esm(async () => {
   captureInFlight = new Map;
   captureDomainLocks = new Map;
   skillRouteCache = new Map;
-  ROUTE_CACHE_FILE = join8(process.env.HOME ?? "/tmp", ".unbrowse", "route-cache.json");
-  SKILL_SNAPSHOT_DIR2 = process.env.UNBROWSE_SKILL_SNAPSHOT_DIR ?? join8(process.env.HOME ?? "/tmp", ".unbrowse", "skill-snapshots");
+  ROUTE_CACHE_FILE = join9(process.env.HOME ?? "/tmp", ".unbrowse", "route-cache.json");
+  SKILL_SNAPSHOT_DIR2 = process.env.UNBROWSE_SKILL_SNAPSHOT_DIR ?? join9(process.env.HOME ?? "/tmp", ".unbrowse", "skill-snapshots");
   domainSkillCache = new Map;
-  DOMAIN_CACHE_FILE = join8(process.env.HOME ?? "/tmp", ".unbrowse", "domain-skill-cache.json");
+  DOMAIN_CACHE_FILE = join9(process.env.HOME ?? "/tmp", ".unbrowse", "domain-skill-cache.json");
   try {
-    if (existsSync8(DOMAIN_CACHE_FILE)) {
-      const data = JSON.parse(readFileSync5(DOMAIN_CACHE_FILE, "utf-8"));
+    if (existsSync10(DOMAIN_CACHE_FILE)) {
+      const data = JSON.parse(readFileSync6(DOMAIN_CACHE_FILE, "utf-8"));
       for (const [k, v] of Object.entries(data)) {
         const entry = v;
         if (Date.now() - entry.ts < 7 * 24 * 60 * 60000) {
@@ -1215,17 +1214,17 @@ var init_orchestrator = __esm(async () => {
       return;
     _routeCacheDirty = false;
     try {
-      const dir = dirname2(ROUTE_CACHE_FILE);
-      if (!existsSync8(dir))
-        mkdirSync4(dir, { recursive: true });
+      const dir = dirname3(ROUTE_CACHE_FILE);
+      if (!existsSync10(dir))
+        mkdirSync5(dir, { recursive: true });
       const entries = Object.fromEntries(skillRouteCache);
       writeFileSync3(ROUTE_CACHE_FILE, JSON.stringify(entries), "utf-8");
     } catch {}
   }, 5000);
   routeCacheFlushTimer.unref?.();
   try {
-    if (existsSync8(ROUTE_CACHE_FILE)) {
-      const data = JSON.parse(readFileSync5(ROUTE_CACHE_FILE, "utf-8"));
+    if (existsSync10(ROUTE_CACHE_FILE)) {
+      const data = JSON.parse(readFileSync6(ROUTE_CACHE_FILE, "utf-8"));
       for (const [k, v] of Object.entries(data)) {
         const entry = v;
         if (Date.now() - entry.ts < 24 * 60 * 60000) {
@@ -1321,18 +1320,18 @@ __export(exports_wallet, {
   getWalletContext: () => getWalletContext2,
   checkWalletConfigured: () => checkWalletConfigured2
 });
-import { existsSync as existsSync12, readFileSync as readFileSync8 } from "node:fs";
-import { homedir as homedir5 } from "node:os";
-import { join as join10 } from "node:path";
+import { existsSync as existsSync14, readFileSync as readFileSync9 } from "node:fs";
+import { homedir as homedir6 } from "node:os";
+import { join as join11 } from "node:path";
 function asNonEmptyString2(value) {
   return typeof value === "string" && value.trim() ? value.trim() : undefined;
 }
 function getLobsterWalletFromLocalConfig2() {
-  const agentsPath = join10(process.env.HOME || homedir5(), ".lobster", "agents.json");
-  if (!existsSync12(agentsPath))
+  const agentsPath = join11(process.env.HOME || homedir6(), ".lobster", "agents.json");
+  if (!existsSync14(agentsPath))
     return;
   try {
-    const raw = JSON.parse(readFileSync8(agentsPath, "utf8"));
+    const raw = JSON.parse(readFileSync9(agentsPath, "utf8"));
     const activeAgentId = asNonEmptyString2(raw.activeAgentId);
     const activeAgent = Array.isArray(raw.agents) ? raw.agents.find((agent) => asNonEmptyString2(agent.id) === activeAgentId) : activeAgentId ? raw.agents?.[activeAgentId] : undefined;
     return asNonEmptyString2(activeAgent?.authorizedWallets?.solana) ?? asNonEmptyString2(activeAgent?.walletAddress) ?? asNonEmptyString2(activeAgent?.wallet_address);
@@ -1380,7 +1379,7 @@ init_wallet();
 init_telemetry_attribution();
 import { readFileSync as readFileSync3, writeFileSync, existsSync as existsSync4, mkdirSync, readdirSync as readdirSync2 } from "fs";
 import { join as join4 } from "path";
-import { homedir as homedir3, hostname } from "os";
+import { homedir as homedir3, hostname, release as osRelease } from "os";
 import { randomBytes, createHash as createHash2 } from "crypto";
 import { createInterface } from "readline";
 var API_URL = process.env.UNBROWSE_BACKEND_URL || DEFAULT_BACKEND_URL;
@@ -1573,9 +1572,19 @@ async function recordInstallTelemetryEvent(source, options) {
     skill_version: options?.skillVersion,
     status: options?.status ?? "installed",
     created_at: createdAt,
-    properties: mergeTelemetryProperties(options?.properties, getTelemetryAttribution())
+    properties: mergeTelemetryProperties({ ...getRuntimeContext(), ...options?.properties }, getTelemetryAttribution())
   });
 }
+function getRuntimeContext() {
+  return {
+    cli_version: PACKAGE_VERSION,
+    code_hash: CODE_HASH,
+    node_version: process.version,
+    platform: process.platform,
+    arch: process.arch,
+    os_release: osRelease()
+  };
+}
 async function recordFunnelTelemetryEvent(name, options) {
   const createdAt = options?.createdAt ?? new Date().toISOString();
   const landingToken = getLandingToken();
@@ -1587,7 +1596,7 @@ async function recordFunnelTelemetryEvent(name, options) {
     source: options?.source ?? "cli",
     host_type: options?.hostType ?? detectTelemetryHostType(),
     created_at: createdAt,
-    properties: mergeTelemetryProperties(options?.properties, getTelemetryAttribution())
+    properties: mergeTelemetryProperties({ ...getRuntimeContext(), ...options?.properties }, getTelemetryAttribution())
   });
 }
 var EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/i;
@@ -1619,6 +1628,10 @@ function getApiKey() {
   }
   return "";
 }
+function getAgentId() {
+  const config = loadConfig();
+  return config?.agent_id ?? null;
+}
 var API_TIMEOUT_MS = parseInt(process.env.UNBROWSE_API_TIMEOUT ?? "8000", 10);
 var PUBLISH_TIMEOUT_MS = parseInt(process.env.UNBROWSE_PUBLISH_TIMEOUT ?? "30000", 10);
 async function validateApiKey(key) {
@@ -1930,6 +1943,170 @@ async function syncAgentWallet(wallet = getLocalWalletContext()) {
     return;
   saveConfig({ ...config, ...wallet });
 }
+async function getTransactionHistory(agentId) {
+  return api("GET", `/v1/transactions/consumer/${agentId}`);
+}
+async function getCreatorEarnings(agentId) {
+  return api("GET", `/v1/transactions/creator/${agentId}`);
+}
+
+// ../../src/impact-log.ts
+import { existsSync as existsSync5, mkdirSync as mkdirSync2, appendFileSync, statSync, readFileSync as readFileSync4, renameSync, unlinkSync } from "node:fs";
+import { homedir as homedir4 } from "node:os";
+import { dirname as dirname2, join as join5 } from "node:path";
+var MAX_LOG_BYTES = 5 * 1024 * 1024;
+var MAX_ROTATIONS = 3;
+function getLogDir() {
+  if (process.env.UNBROWSE_CONFIG_DIR)
+    return process.env.UNBROWSE_CONFIG_DIR;
+  const profile = process.env.UNBROWSE_PROFILE?.trim();
+  return profile ? join5(homedir4(), ".unbrowse", "profiles", profile) : join5(homedir4(), ".unbrowse");
+}
+function getImpactLogPath() {
+  return join5(getLogDir(), "impact-log.jsonl");
+}
+function ensureDir(path) {
+  const dir = dirname2(path);
+  if (!existsSync5(dir))
+    mkdirSync2(dir, { recursive: true });
+}
+function rotateIfNeeded(path) {
+  try {
+    if (!existsSync5(path))
+      return;
+    const size = statSync(path).size;
+    if (size < MAX_LOG_BYTES)
+      return;
+    for (let i = MAX_ROTATIONS;i >= 1; i--) {
+      const older = `${path}.${i}`;
+      if (!existsSync5(older))
+        continue;
+      if (i === MAX_ROTATIONS) {
+        try {
+          unlinkSync(older);
+        } catch {}
+      } else {
+        try {
+          renameSync(older, `${path}.${i + 1}`);
+        } catch {}
+      }
+    }
+    renameSync(path, `${path}.1`);
+  } catch {}
+}
+function appendImpact(entry) {
+  try {
+    const hasSignal = (entry.time_saved_ms ?? 0) > 0 || (entry.tokens_saved ?? 0) > 0 || (entry.cost_saved_uc ?? 0) > 0 || entry.browser_avoided === true;
+    if (!hasSignal)
+      return;
+    const path = getImpactLogPath();
+    ensureDir(path);
+    rotateIfNeeded(path);
+    appendFileSync(path, JSON.stringify(entry) + `
+`, "utf8");
+  } catch {}
+}
+function impactFromResult(command, result, extras = {}) {
+  if (!result || typeof result !== "object")
+    return null;
+  const r = result;
+  const impact = r.impact ?? null;
+  if (!impact || typeof impact !== "object")
+    return null;
+  const num = (v) => typeof v === "number" && Number.isFinite(v) ? v : undefined;
+  return {
+    ts: new Date().toISOString(),
+    command,
+    source: typeof impact.source === "string" ? impact.source : undefined,
+    domain: extras.domain,
+    intent: extras.intent,
+    skill_id: extras.skill_id ?? (typeof r.skill_id === "string" ? r.skill_id : undefined),
+    endpoint_id: extras.endpoint_id ?? (typeof r.endpoint_id === "string" ? r.endpoint_id : undefined),
+    time_saved_ms: num(impact.time_saved_ms),
+    time_saved_pct: num(impact.time_saved_pct),
+    tokens_saved: num(impact.tokens_saved),
+    tokens_saved_pct: num(impact.tokens_saved_pct),
+    cost_saved_uc: num(impact.cost_saved_uc),
+    browser_avoided: impact.browser_avoided === true,
+    success: r.error == null
+  };
+}
+function readImpactSummary() {
+  const path = getImpactLogPath();
+  const summary = {
+    total_runs: 0,
+    successful_runs: 0,
+    browser_avoided_runs: 0,
+    total_time_saved_ms: 0,
+    total_tokens_saved: 0,
+    total_cost_saved_uc: 0,
+    avg_time_saved_pct: 0,
+    avg_tokens_saved_pct: 0,
+    by_source: {},
+    first_entry_at: null,
+    last_entry_at: null
+  };
+  const files = [];
+  for (let i = MAX_ROTATIONS;i >= 1; i--) {
+    const rotated = `${path}.${i}`;
+    if (existsSync5(rotated))
+      files.push(rotated);
+  }
+  if (existsSync5(path))
+    files.push(path);
+  if (files.length === 0)
+    return summary;
+  let timePctSum = 0;
+  let timePctCount = 0;
+  let tokenPctSum = 0;
+  let tokenPctCount = 0;
+  for (const file of files) {
+    let raw;
+    try {
+      raw = readFileSync4(file, "utf8");
+    } catch {
+      continue;
+    }
+    for (const line of raw.split(`
+`)) {
+      const trimmed = line.trim();
+      if (!trimmed)
+        continue;
+      let e;
+      try {
+        e = JSON.parse(trimmed);
+      } catch {
+        continue;
+      }
+      summary.total_runs += 1;
+      if (e.success !== false)
+        summary.successful_runs += 1;
+      if (e.browser_avoided)
+        summary.browser_avoided_runs += 1;
+      summary.total_time_saved_ms += e.time_saved_ms ?? 0;
+      summary.total_tokens_saved += e.tokens_saved ?? 0;
+      summary.total_cost_saved_uc += e.cost_saved_uc ?? 0;
+      if (typeof e.time_saved_pct === "number") {
+        timePctSum += e.time_saved_pct;
+        timePctCount += 1;
+      }
+      if (typeof e.tokens_saved_pct === "number") {
+        tokenPctSum += e.tokens_saved_pct;
+        tokenPctCount += 1;
+      }
+      if (e.source) {
+        summary.by_source[e.source] = (summary.by_source[e.source] ?? 0) + 1;
+      }
+      if (!summary.first_entry_at || e.ts < summary.first_entry_at)
+        summary.first_entry_at = e.ts;
+      if (!summary.last_entry_at || e.ts > summary.last_entry_at)
+        summary.last_entry_at = e.ts;
+    }
+  }
+  summary.avg_time_saved_pct = timePctCount > 0 ? Math.round(timePctSum / timePctCount) : 0;
+  summary.avg_tokens_saved_pct = tokenPctCount > 0 ? Math.round(tokenPctSum / tokenPctCount) : 0;
+  return summary;
+}
 
 // ../../src/cli/shortcuts.ts
 var linkedin = {
@@ -2130,7 +2307,7 @@ function buildDepsMetadata(pack, taskName) {
 init_paths();
 init_supervisor();
 init_version();
-import { openSync, readFileSync as readFileSync4, unlinkSync, writeFileSync as writeFileSync2 } from "node:fs";
+import { existsSync as existsSync7, openSync, readFileSync as readFileSync5, unlinkSync as unlinkSync2, writeFileSync as writeFileSync2 } from "node:fs";
 import path2 from "node:path";
 import { spawn } from "node:child_process";
 function isServerVersionMismatch(runningVersion, installedVersion, runningCodeHash, installedCodeHash) {
@@ -2168,14 +2345,14 @@ function isPidAlive(pid) {
 }
 function readPidState(pidFile) {
   try {
-    return JSON.parse(readFileSync4(pidFile, "utf-8"));
+    return JSON.parse(readFileSync5(pidFile, "utf-8"));
   } catch {
     return null;
   }
 }
 function clearStalePidFile(pidFile) {
   try {
-    unlinkSync(pidFile);
+    unlinkSync2(pidFile);
   } catch {}
 }
 function deriveListenEnv(baseUrl) {
@@ -2196,6 +2373,10 @@ function getServerSpawnSpec(metaUrl, entrypoint = resolveSiblingEntrypoint(metaU
       recordedEntrypoint: `${process.execPath} serve`
     };
   }
+  const serverJs = path2.join(path2.dirname(entrypoint), "server.js");
+  if (existsSync7(serverJs) && path2.basename(entrypoint) !== "server.js") {
+    entrypoint = serverJs;
+  }
   return {
     command: process.execPath,
     args: runtimeArgsForEntrypoint(metaUrl, entrypoint),
@@ -2209,7 +2390,7 @@ function spawnServer(baseUrl, metaUrl, pidFile, restartCount = 0) {
   const entrypoint = resolveSiblingEntrypoint(metaUrl, "index");
   const spawnSpec = getServerSpawnSpec(metaUrl, entrypoint);
   const logFile = getServerAutostartLogFile();
-  ensureDir(path2.dirname(logFile));
+  ensureDir2(path2.dirname(logFile));
   const logFd = openSync(logFile, "a");
   const child = spawn(spawnSpec.command, spawnSpec.args, {
     cwd: spawnSpec.cwd,
@@ -2341,7 +2522,7 @@ async function restartServer(baseUrl, metaUrl) {
 }
 
 // ../../src/runtime/paths.ts
-import { existsSync as existsSync6, mkdirSync as mkdirSync3, realpathSync as realpathSync2 } from "node:fs";
+import { existsSync as existsSync8, mkdirSync as mkdirSync4, realpathSync as realpathSync2 } from "node:fs";
 import path3 from "node:path";
 import { createRequire as createRequire3 } from "node:module";
 import { fileURLToPath as fileURLToPath3, pathToFileURL as pathToFileURL2 } from "node:url";
@@ -2361,7 +2542,7 @@ function runtimeArgsForEntrypoint2(metaUrl, entrypoint) {
     const req = createRequire3(metaUrl);
     const tsxPkg = req.resolve("tsx/package.json");
     const tsxLoader = path3.join(path3.dirname(tsxPkg), "dist", "loader.mjs");
-    if (existsSync6(tsxLoader))
+    if (existsSync8(tsxLoader))
       return ["--import", pathToFileURL2(tsxLoader).href, entrypoint];
   } catch {}
   return ["--import", "tsx", entrypoint];
@@ -2391,8 +2572,8 @@ init_publish();
 init_settings();
 init_graph();
 init_schema_review();
-import { join as join9 } from "node:path";
-var SKILL_SNAPSHOT_DIR3 = process.env.UNBROWSE_SKILL_SNAPSHOT_DIR ?? join9(process.env.HOME ?? "/tmp", ".unbrowse", "skill-snapshots");
+import { join as join10 } from "node:path";
+var SKILL_SNAPSHOT_DIR3 = process.env.UNBROWSE_SKILL_SNAPSHOT_DIR ?? join10(process.env.HOME ?? "/tmp", ".unbrowse", "skill-snapshots");
 var indexInFlight2 = new Map;
 var pendingIndexJobs2 = new Map;
 async function drainPendingIndexJobs() {
@@ -2430,13 +2611,13 @@ init_client2();
 init_logger();
 init_wallet();
 import { execFileSync as execFileSync3 } from "node:child_process";
-import { existsSync as existsSync10, mkdirSync as mkdirSync6, writeFileSync as writeFileSync5 } from "node:fs";
+import { existsSync as existsSync12, mkdirSync as mkdirSync7, writeFileSync as writeFileSync5 } from "node:fs";
 import os4 from "node:os";
 import path7 from "node:path";
 
 // ../../src/runtime/update-hints.ts
 init_paths();
-import { existsSync as existsSync9, mkdirSync as mkdirSync5, readFileSync as readFileSync6, writeFileSync as writeFileSync4 } from "node:fs";
+import { existsSync as existsSync11, mkdirSync as mkdirSync6, readFileSync as readFileSync7, writeFileSync as writeFileSync4 } from "node:fs";
 import os3 from "node:os";
 import path6 from "node:path";
 var DEFAULT_INTERVAL_MS = 12 * 60 * 60 * 1000;
@@ -2449,20 +2630,20 @@ function getConfigDir2() {
     return process.env.UNBROWSE_CONFIG_DIR;
   return path6.join(getHomeDir(), ".unbrowse");
 }
-function ensureDir2(dir) {
-  if (!existsSync9(dir))
-    mkdirSync5(dir, { recursive: true });
+function ensureDir3(dir) {
+  if (!existsSync11(dir))
+    mkdirSync6(dir, { recursive: true });
   return dir;
 }
 function readJsonFile(file) {
   try {
-    return JSON.parse(readFileSync6(file, "utf8"));
+    return JSON.parse(readFileSync7(file, "utf8"));
   } catch {
     return null;
   }
 }
 function writeJsonFile(file, value) {
-  ensureDir2(path6.dirname(file));
+  ensureDir3(path6.dirname(file));
   writeFileSync4(file, `${JSON.stringify(value, null, 2)}
 `);
 }
@@ -2473,7 +2654,7 @@ function detectRepoRoot(start2) {
   let dir = path6.resolve(start2);
   const root = path6.parse(dir).root;
   while (dir !== root) {
-    if (existsSync9(path6.join(dir, ".git")))
+    if (existsSync11(path6.join(dir, ".git")))
       return dir;
     dir = path6.dirname(dir);
   }
@@ -2552,13 +2733,13 @@ codex_hooks = true
 }
 function writeCodexHook(metaUrl) {
   const configPath = getCodexConfigPath();
-  if (!existsSync9(path6.dirname(configPath))) {
+  if (!existsSync11(path6.dirname(configPath))) {
     return { host: "codex", action: "not-detected", config_file: configPath };
   }
   try {
     const hookScript = getHookScriptPath(metaUrl).replace(/\\/g, "/");
-    const fileExistsBefore = existsSync9(configPath);
-    let content = fileExistsBefore ? readFileSync6(configPath, "utf8") : "";
+    const fileExistsBefore = existsSync11(configPath);
+    let content = fileExistsBefore ? readFileSync7(configPath, "utf8") : "";
     const previous = content;
     content = ensureCodexHooksFeature(content);
     if (!content.includes("unbrowse-update-hint.mjs")) {
@@ -2592,13 +2773,13 @@ command = ${JSON.stringify(command)}
 }
 function writeClaudeHook(metaUrl) {
   const settingsPath = getClaudeSettingsPath();
-  if (!existsSync9(path6.dirname(settingsPath))) {
+  if (!existsSync11(path6.dirname(settingsPath))) {
     return { host: "claude", action: "not-detected", config_file: settingsPath };
   }
   try {
     const hookScript = getHookScriptPath(metaUrl).replace(/\\/g, "/");
     const command = `node "${hookScript}"`;
-    const fileExistsBefore = existsSync9(settingsPath);
+    const fileExistsBefore = existsSync11(settingsPath);
     const settings = readJsonFile(settingsPath) ?? {};
     settings.hooks ??= {};
     settings.hooks.SessionStart ??= [];
@@ -2663,7 +2844,7 @@ function getOpenCodeProjectCommandsDir(cwd) {
   return path7.join(cwd, ".opencode", "commands");
 }
 function detectOpenCode(cwd) {
-  return hasBinary("opencode") || existsSync10(path7.join(resolveConfigHome(), "opencode")) || existsSync10(path7.join(cwd, ".opencode"));
+  return hasBinary("opencode") || existsSync12(path7.join(resolveConfigHome(), "opencode")) || existsSync12(path7.join(cwd, ".opencode"));
 }
 function renderOpenCodeCommand() {
   return `---
@@ -2691,12 +2872,12 @@ function writeOpenCodeCommand(scope, cwd) {
   if (scope === "auto" && !detected) {
     return { detected: false, action: "not-detected", scope: "off" };
   }
-  const resolvedScope = scope === "project" ? "project" : scope === "global" ? "global" : existsSync10(path7.join(cwd, ".opencode")) ? "project" : "global";
+  const resolvedScope = scope === "project" ? "project" : scope === "global" ? "global" : existsSync12(path7.join(cwd, ".opencode")) ? "project" : "global";
   const commandsDir = resolvedScope === "project" ? getOpenCodeProjectCommandsDir(cwd) : getOpenCodeGlobalCommandsDir();
-  const commandFile = path7.join(ensureDir(commandsDir), "unbrowse.md");
+  const commandFile = path7.join(ensureDir2(commandsDir), "unbrowse.md");
   const content = renderOpenCodeCommand();
-  const action2 = existsSync10(commandFile) ? "updated" : "installed";
-  mkdirSync6(path7.dirname(commandFile), { recursive: true });
+  const action2 = existsSync12(commandFile) ? "updated" : "installed";
+  mkdirSync7(path7.dirname(commandFile), { recursive: true });
   writeFileSync5(commandFile, content);
   return {
     detected: detected || scope !== "auto",
@@ -2707,10 +2888,10 @@ function writeOpenCodeCommand(scope, cwd) {
 }
 async function ensureBrowserEngineInstalled() {
   const binary = findKuriBinary();
-  if (existsSync10(binary)) {
+  if (existsSync12(binary)) {
     return { installed: true, action: "already-installed" };
   }
-  const sourceDir = getKuriSourceCandidates().find((candidate) => existsSync10(path7.join(candidate, "build.zig")));
+  const sourceDir = getKuriSourceCandidates().find((candidate) => existsSync12(path7.join(candidate, "build.zig")));
   if (!sourceDir) {
     return {
       installed: false,
@@ -2732,7 +2913,7 @@ async function ensureBrowserEngineInstalled() {
       timeout: 300000
     });
     const builtBinary = findKuriBinary();
-    if (existsSync10(builtBinary)) {
+    if (existsSync12(builtBinary)) {
       return {
         installed: true,
         action: "installed",
@@ -2757,7 +2938,7 @@ async function runSetup(options) {
   const browser = options?.installBrowser === false ? { installed: false, action: "skipped" } : await ensureBrowserEngineInstalled();
   const walletCheck = checkWalletConfigured();
   const skipWalletSetup = process.env.UNBROWSE_SKIP_WALLET_SETUP === "1";
-  const lobsterInstalled = hasBinary("lobstercash") || existsSync10(path7.join(os4.homedir(), ".agents", "skills", "lobstercash", "SKILL.md"));
+  const lobsterInstalled = hasBinary("lobstercash") || existsSync12(path7.join(os4.homedir(), ".agents", "skills", "lobstercash", "SKILL.md"));
   if (!skipWalletSetup && !walletCheck.configured && lobsterInstalled) {
     console.log("[unbrowse] Crossmint lobster.cash detected but wallet not configured — running wallet setup...");
     try {
@@ -2797,7 +2978,7 @@ async function runSetup(options) {
 
 // ../../src/runtime/update-hints.ts
 init_paths();
-import { existsSync as existsSync11, mkdirSync as mkdirSync7, readFileSync as readFileSync7, writeFileSync as writeFileSync6 } from "node:fs";
+import { existsSync as existsSync13, mkdirSync as mkdirSync8, readFileSync as readFileSync8, writeFileSync as writeFileSync6 } from "node:fs";
 import os5 from "node:os";
 import path8 from "node:path";
 var INSTALL_SCRIPT_URL = "https://unbrowse.ai/install.sh";
@@ -2810,20 +2991,20 @@ function getConfigDir3() {
     return process.env.UNBROWSE_CONFIG_DIR;
   return path8.join(getHomeDir2(), ".unbrowse");
 }
-function ensureDir3(dir) {
-  if (!existsSync11(dir))
-    mkdirSync7(dir, { recursive: true });
+function ensureDir4(dir) {
+  if (!existsSync13(dir))
+    mkdirSync8(dir, { recursive: true });
   return dir;
 }
 function readJsonFile2(file) {
   try {
-    return JSON.parse(readFileSync7(file, "utf8"));
+    return JSON.parse(readFileSync8(file, "utf8"));
   } catch {
     return null;
   }
 }
 function writeJsonFile2(file, value) {
-  ensureDir3(path8.dirname(file));
+  ensureDir4(path8.dirname(file));
   writeFileSync6(file, `${JSON.stringify(value, null, 2)}
 `);
 }
@@ -2837,7 +3018,7 @@ function detectRepoRoot2(start2) {
   let dir = path8.resolve(start2);
   const root = path8.parse(dir).root;
   while (dir !== root) {
-    if (existsSync11(path8.join(dir, ".git")))
+    if (existsSync13(path8.join(dir, ".git")))
       return dir;
     dir = path8.dirname(dir);
   }
@@ -2870,7 +3051,7 @@ function detectInstallHost2(repoRoot) {
 function getInstalledVersion(metaUrl) {
   const packageRoot = getPackageRoot(metaUrl);
   try {
-    const pkg = JSON.parse(readFileSync7(path8.join(packageRoot, "package.json"), "utf8"));
+    const pkg = JSON.parse(readFileSync8(path8.join(packageRoot, "package.json"), "utf8"));
     return pkg.version ?? "unknown";
   } catch {
     return "unknown";
@@ -3118,6 +3299,14 @@ function formatSavedDuration(ms) {
     return `${(ms / 1000).toFixed(1)}s`;
   return `${ms}ms`;
 }
+function formatCostUsd(uc) {
+  const usd = uc / 1e6;
+  if (usd >= 1)
+    return `$${usd.toFixed(2)}`;
+  if (usd >= 0.01)
+    return `$${usd.toFixed(3)}`;
+  return `$${usd.toFixed(4)}`;
+}
 function emitImpactSummary(result) {
   const impact = result.impact;
   if (!impact)
@@ -3126,14 +3315,17 @@ function emitImpactSummary(result) {
   const tokensSaved = typeof impact.tokens_saved === "number" ? impact.tokens_saved : 0;
   const timeSavedPct = typeof impact.time_saved_pct === "number" ? impact.time_saved_pct : 0;
   const tokensSavedPct = typeof impact.tokens_saved_pct === "number" ? impact.tokens_saved_pct : 0;
+  const costSavedUc = typeof impact.cost_saved_uc === "number" ? impact.cost_saved_uc : 0;
   const browserAvoided = impact.browser_avoided === true;
-  if (timeSavedMs <= 0 && tokensSaved <= 0 && !browserAvoided)
+  if (timeSavedMs <= 0 && tokensSaved <= 0 && costSavedUc <= 0 && !browserAvoided)
     return;
   const parts = [];
   if (timeSavedMs > 0)
     parts.push(`${formatSavedDuration(timeSavedMs)} saved (${timeSavedPct}% faster)`);
   if (tokensSaved > 0)
     parts.push(`${tokensSaved.toLocaleString("en-US")} tokens saved (${tokensSavedPct}% less context)`);
+  if (costSavedUc > 0)
+    parts.push(`${formatCostUsd(costSavedUc)} saved`);
   if (browserAvoided)
     parts.push("browser avoided");
   info(parts.join(" \u2022 "));
@@ -3278,6 +3470,11 @@ async function cmdResolve(flags) {
     }
     result = slimTrace(result);
     emitImpactSummary(result);
+    {
+      const entry = impactFromResult("resolve", result, { intent, domain });
+      if (entry)
+        appendImpact(entry);
+    }
     emitNextActionSummary(result);
     const skill = result.skill;
     const trace = result.trace;
@@ -3448,6 +3645,14 @@ async function cmdExecute(flags) {
     }
     result = slimTrace(result);
     emitImpactSummary(result);
+    {
+      const entry = impactFromResult("execute", result, {
+        skill_id: skillId,
+        endpoint_id: typeof flags.endpoint === "string" ? flags.endpoint : undefined
+      });
+      if (entry)
+        appendImpact(entry);
+    }
     emitNextActionSummary(result);
     const pathFlag = flags.path;
     const extractFlag = flags.extract;
@@ -3536,6 +3741,25 @@ async function cmdFeedback(flags) {
     body.diagnostics = JSON.parse(flags.diagnostics);
   output(await api2("POST", "/v1/feedback", body), !!flags.pretty);
 }
+async function cmdAnnotate(flags) {
+  const skillId = flags.skill;
+  const endpointId = flags.endpoint;
+  if (!skillId || !endpointId)
+    die("--skill and --endpoint are required");
+  const body = {};
+  if (flags.text) {
+    body.annotations = [{ text: flags.text }];
+  }
+  if (flags.constraint) {
+    const parts = flags.constraint.split(":");
+    if (parts.length >= 3) {
+      body.constraints = [{ param: parts[0], rule: parts[1], message: parts.slice(2).join(":") }];
+    }
+  }
+  if (!body.annotations && !body.constraints)
+    die("--text or --constraint required");
+  output(await api2("POST", `/v1/skills/${skillId}/endpoints/${endpointId}/annotate`, body), !!flags.pretty);
+}
 async function cmdReview(flags) {
   const skillId = flags.skill;
   if (!skillId)
@@ -3750,6 +3974,7 @@ var CLI_REFERENCE = {
     { name: "resolve", usage: '--intent "..." [--domain "..."] [--url "..."] [opts]', desc: "Search cached indexed/published routes and optionally execute the top trusted endpoint" },
     { name: "execute", usage: "--skill ID --endpoint ID [opts]", desc: "Execute a specific endpoint" },
     { name: "feedback", usage: "--skill ID --endpoint ID --rating N", desc: "Submit feedback (mandatory after resolve)" },
+    { name: "annotate", usage: "--skill ID --endpoint ID --text 'tip' [--constraint 'param:rule:message']", desc: "Contribute best practices or constraints for an endpoint" },
     { name: "review", usage: "--skill ID --endpoints '[...]'", desc: "Push reviewed descriptions/schema metadata back to a captured skill before publish" },
     { name: "index", usage: "--skill ID", desc: "Recompute local graph/contracts/export from cached skill state only" },
     { name: "publish", usage: "--skill ID [--confirm-publish] [--endpoints '[...]']", desc: "Re-index locally, inspect publish-review metadata, then publish/share from cached skill state" },
@@ -3777,7 +4002,8 @@ var CLI_REFERENCE = {
     { name: "back", usage: "[--session id]", desc: "Navigate back" },
     { name: "forward", usage: "[--session id]", desc: "Navigate forward" },
     { name: "sync", usage: "[--session id]", desc: "Checkpoint current capture, keep tab open, queue background index + publish, then inspect via skill/publish review" },
-    { name: "close", usage: "[--session id]", desc: "Checkpoint capture, queue background index + publish, close browse session, then inspect via skill/publish review" }
+    { name: "close", usage: "[--session id]", desc: "Checkpoint capture, queue background index + publish, close browse session, then inspect via skill/publish review" },
+    { name: "stats", usage: "[--json] [--pretty]", desc: "Show lifetime time/tokens/cost saved and marketplace earnings/spending" }
   ],
   globalFlags: [
     { flag: "--pretty", desc: "Indented JSON output" },
@@ -3818,6 +4044,131 @@ var CLI_REFERENCE = {
     `unbrowse publish --skill abc --endpoints '[{"endpoint_id":"def","description":"Search court judgments by keywords","action_kind":"search","resource_kind":"judgment"}]'`
   ]
 };
+function formatTotalDuration(ms) {
+  if (ms >= 3600000)
+    return `${(ms / 3600000).toFixed(1)}h`;
+  if (ms >= 60000)
+    return `${(ms / 60000).toFixed(1)}m`;
+  if (ms >= 1000)
+    return `${(ms / 1000).toFixed(1)}s`;
+  return `${ms}ms`;
+}
+async function cmdStats(flags) {
+  const pretty = !!flags.pretty;
+  const jsonOnly = !!flags.json;
+  const local = readImpactSummary();
+  const agentId = getAgentId();
+  let profile = null;
+  let earnings = null;
+  let spending = null;
+  const remoteErrors = {};
+  if (agentId) {
+    const results = await Promise.allSettled([
+      getMyProfile(),
+      getCreatorEarnings(agentId),
+      getTransactionHistory(agentId)
+    ]);
+    if (results[0].status === "fulfilled")
+      profile = results[0].value;
+    else
+      remoteErrors.profile = results[0].reason?.message ?? String(results[0].reason);
+    if (results[1].status === "fulfilled")
+      earnings = results[1].value;
+    else
+      remoteErrors.earnings = results[1].reason?.message ?? String(results[1].reason);
+    if (results[2].status === "fulfilled")
+      spending = results[2].value;
+    else
+      remoteErrors.spending = results[2].reason?.message ?? String(results[2].reason);
+  } else {
+    remoteErrors.profile = "No agent_id in local config. Run `unbrowse setup` to register.";
+  }
+  const earnedUsd = earnings?.ledger?.total_earned_usd ?? 0;
+  const spentUsd = spending?.ledger?.total_spent_usd ?? 0;
+  const netUsd = earnedUsd - spentUsd;
+  const savedUsd = local.total_cost_saved_uc / 1e6;
+  const payload = {
+    agent_id: agentId,
+    profile,
+    impact: {
+      total_runs: local.total_runs,
+      successful_runs: local.successful_runs,
+      browser_avoided_runs: local.browser_avoided_runs,
+      total_time_saved_ms: local.total_time_saved_ms,
+      total_time_saved_human: formatTotalDuration(local.total_time_saved_ms),
+      total_tokens_saved: local.total_tokens_saved,
+      total_cost_saved_usd: Number(savedUsd.toFixed(6)),
+      avg_time_saved_pct: local.avg_time_saved_pct,
+      avg_tokens_saved_pct: local.avg_tokens_saved_pct,
+      by_source: local.by_source,
+      first_entry_at: local.first_entry_at,
+      last_entry_at: local.last_entry_at,
+      log_path: getImpactLogPath()
+    },
+    earnings: {
+      total_earned_usd: earnedUsd,
+      total_earned_uc: earnings?.ledger?.total_earned_uc ?? 0,
+      transaction_count: earnings?.ledger?.transaction_count ?? 0,
+      last_transaction_at: earnings?.ledger?.last_transaction_at ?? null
+    },
+    spending: {
+      total_spent_usd: spentUsd,
+      total_spent_uc: spending?.ledger?.total_spent_uc ?? 0,
+      transaction_count: spending?.ledger?.transaction_count ?? 0,
+      last_transaction_at: spending?.ledger?.last_transaction_at ?? null
+    },
+    net_usd: netUsd,
+    ...Object.keys(remoteErrors).length > 0 ? { remote_errors: remoteErrors } : {}
+  };
+  if (jsonOnly) {
+    output(payload, pretty);
+    return;
+  }
+  const lines = [];
+  lines.push("Unbrowse stats");
+  lines.push(`  agent_id: ${agentId ?? "(not registered \u2014 run `unbrowse setup`)"}`);
+  if (profile?.name)
+    lines.push(`  name: ${profile.name}`);
+  lines.push("");
+  lines.push("Impact (local, this machine):");
+  if (local.total_runs === 0) {
+    lines.push("  No resolve/execute runs recorded yet.");
+    lines.push(`  Log file: ${getImpactLogPath()}`);
+  } else {
+    lines.push(`  Runs: ${local.total_runs} (${local.successful_runs} successful, ${local.browser_avoided_runs} browser-avoided)`);
+    if (local.total_time_saved_ms > 0) {
+      lines.push(`  Time saved: ${formatTotalDuration(local.total_time_saved_ms)} (avg ${local.avg_time_saved_pct}% faster)`);
+    }
+    if (local.total_tokens_saved > 0) {
+      lines.push(`  Tokens saved: ${local.total_tokens_saved.toLocaleString("en-US")} (avg ${local.avg_tokens_saved_pct}% less context)`);
+    }
+    if (savedUsd > 0) {
+      lines.push(`  Cost saved: ${formatCostUsd(local.total_cost_saved_uc)}`);
+    }
+    if (Object.keys(local.by_source).length > 0) {
+      const topSources = Object.entries(local.by_source).sort((a, b) => b[1] - a[1]).slice(0, 5).map(([k, v]) => `${k}=${v}`).join(", ");
+      lines.push(`  By source: ${topSources}`);
+    }
+  }
+  lines.push("");
+  lines.push("Money (backend ledger):");
+  if (!agentId) {
+    lines.push("  (not registered \u2014 earnings/spending unavailable)");
+  } else if (remoteErrors.earnings || remoteErrors.spending) {
+    if (remoteErrors.earnings)
+      lines.push(`  earnings: error \u2014 ${remoteErrors.earnings}`);
+    if (remoteErrors.spending)
+      lines.push(`  spending: error \u2014 ${remoteErrors.spending}`);
+  } else {
+    lines.push(`  Earned:  $${earnedUsd.toFixed(4)} (${earnings?.ledger?.transaction_count ?? 0} payouts)`);
+    lines.push(`  Spent:   $${spentUsd.toFixed(4)} (${spending?.ledger?.transaction_count ?? 0} payments)`);
+    lines.push(`  Net:     ${netUsd >= 0 ? "+" : ""}$${netUsd.toFixed(4)}`);
+  }
+  lines.push("");
+  info(lines.join(`
+`));
+  output(payload, pretty);
+}
 function printHelp() {
   const r = CLI_REFERENCE;
   const lines = ["unbrowse \u2014 shell-safe CLI for the local API", ""];
@@ -4239,6 +4590,8 @@ async function main() {
     return cmdUpgrade(flags);
   if (command === "connect-chrome")
     return cmdConnectChrome();
+  if (command === "stats")
+    return cmdStats(flags);
   const KNOWN_COMMANDS = new Set([
     "health",
     "mcp",
@@ -4248,6 +4601,7 @@ async function main() {
     "exec",
     "feedback",
     "fb",
+    "annotate",
     "review",
     "index",
     "publish",
@@ -4282,7 +4636,8 @@ async function main() {
     "forward",
     "sync",
     "close",
-    "connect-chrome"
+    "connect-chrome",
+    "stats"
   ]);
   if (!KNOWN_COMMANDS.has(command)) {
     const pack = findSitePack(command);
@@ -4318,6 +4673,8 @@ async function main() {
     case "feedback":
     case "fb":
       return cmdFeedback(flags);
+    case "annotate":
+      return cmdAnnotate(flags);
     case "review":
       return cmdReview(flags);
     case "index":
@@ -4378,6 +4735,8 @@ async function main() {
       return cmdClose(flags);
     case "connect-chrome":
       return cmdConnectChrome();
+    case "stats":
+      return cmdStats(flags);
     default:
       info(`Unknown command: ${command}`);
       printHelp();