token-larper 1.0.0

package/src/startup.ts

@@ -0,0 +1,110 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import type { StartupConfig } from "./types.ts";
+
+const REG_KEY = "HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Run";
+const REG_VALUE_NAME = "TokenLarper";
+const ROOT_DIR = resolve(import.meta.dir, "..");
+const SETTINGS_FILE = join(ROOT_DIR, ".cache", "settings.json");
+const VBS_LAUNCHER = join(ROOT_DIR, "scripts", "launch-silent.vbs");
+const PS1_RUNNER = join(ROOT_DIR, "scripts", "run-server.ps1");
+
+interface SavedSettings {
+  openBrowserOnBoot: boolean;
+  port: number;
+}
+
+function validPort(value: unknown, fallback: number): number {
+  const port = Number(value);
+  return Number.isInteger(port) && port > 0 && port <= 65535 ? port : fallback;
+}
+
+function loadSavedSettings(defaultPort = 4269): SavedSettings {
+  try {
+    if (existsSync(SETTINGS_FILE)) {
+      const raw = JSON.parse(readFileSync(SETTINGS_FILE, "utf8"));
+      return {
+        openBrowserOnBoot: raw.openBrowserOnBoot === true,
+        port: validPort(raw.port, defaultPort),
+      };
+    }
+  } catch {
+    // A missing or damaged settings file falls back to the default port.
+  }
+  return { openBrowserOnBoot: false, port: defaultPort };
+}
+
+function saveSettings(settings: SavedSettings): void {
+  mkdirSync(join(ROOT_DIR, ".cache"), { recursive: true });
+  writeFileSync(SETTINGS_FILE, JSON.stringify(settings, null, 2), "utf8");
+}
+
+async function runReg(args: string[]): Promise<{ code: number; output: string; error: string }> {
+  const proc = Bun.spawn(["reg.exe", ...args], { stdout: "pipe", stderr: "pipe" });
+  const [output, error, code] = await Promise.all([
+    new Response(proc.stdout).text(),
+    new Response(proc.stderr).text(),
+    proc.exited,
+  ]);
+  return { code, output, error };
+}
+
+async function readRegistryValue(): Promise<string | null> {
+  if (process.platform !== "win32") return null;
+  const result = await runReg(["query", REG_KEY, "/v", REG_VALUE_NAME]);
+  if (result.code !== 0) return null;
+  const line = result.output.split(/\r?\n/).find((part) =>
+    new RegExp(`^\\s*${REG_VALUE_NAME}\\s+REG_\\w+\\s+`, "i").test(part)
+  );
+  return line?.match(/^\s*\S+\s+REG_\w+\s+(.+)$/i)?.[1]?.trim() ?? null;
+}
+
+export async function getStartupStatus(defaultPort = 4269): Promise<StartupConfig> {
+  const saved = loadSavedSettings(defaultPort);
+  let registryValue: string | null = null;
+  try {
+    registryValue = await readRegistryValue();
+  } catch {
+    // Status remains readable if reg.exe is unavailable.
+  }
+  const expected = `wscript.exe //B //Nologo "${VBS_LAUNCHER}"`;
+  return {
+    enabled: registryValue?.toLowerCase() === expected.toLowerCase(),
+    openBrowserOnBoot: saved.openBrowserOnBoot,
+    port: defaultPort,
+    registryValue,
+    launcherPath: VBS_LAUNCHER,
+  };
+}
+
+export async function setStartupStatus(options: {
+  enabled: boolean;
+  openBrowserOnBoot?: boolean;
+  port?: number;
+}): Promise<StartupConfig> {
+  const current = loadSavedSettings();
+  const next: SavedSettings = {
+    openBrowserOnBoot: options.openBrowserOnBoot ?? current.openBrowserOnBoot,
+    port: validPort(options.port ?? current.port, current.port),
+  };
+
+  if (options.enabled && (!existsSync(VBS_LAUNCHER) || !existsSync(PS1_RUNNER))) {
+    throw new Error("The Windows startup launcher is missing");
+  }
+
+  if (process.platform === "win32") {
+    if (options.enabled) {
+      const command = `wscript.exe //B //Nologo "${VBS_LAUNCHER}"`;
+      const result = await runReg([
+        "add", REG_KEY, "/v", REG_VALUE_NAME, "/t", "REG_SZ", "/d", command, "/f",
+      ]);
+      if (result.code !== 0) throw new Error(result.error.trim() || "Could not enable Windows startup");
+    } else if (await readRegistryValue()) {
+      const result = await runReg(["delete", REG_KEY, "/v", REG_VALUE_NAME, "/f"]);
+      if (result.code !== 0) throw new Error(result.error.trim() || "Could not disable Windows startup");
+    }
+  }
+
+  saveSettings(next);
+  return getStartupStatus(next.port);
+}

package/src/tray.ts

@@ -0,0 +1,293 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+
+const ROOT_DIR = resolve(import.meta.dir, "..");
+const SCRIPTS_DIR = join(ROOT_DIR, "scripts");
+const TRAY_PS1_PATH = join(SCRIPTS_DIR, "tray-host.ps1");
+const TRAY_LAUNCHER_PS1 = join(SCRIPTS_DIR, "launch-on-default-desktop.ps1");
+
+let trayPid: number | null = null;
+
+export function generateTrayScript(port: number, serverPid: number): string {
+  mkdirSync(SCRIPTS_DIR, { recursive: true });
+
+  const psScript = `
+Add-Type -AssemblyName System.Windows.Forms
+Add-Type -AssemblyName System.Drawing
+
+$ServerPort = ${port}
+$ServerPid = ${serverPid}
+$BaseUrl = "http://127.0.0.1:$ServerPort"
+
+# Opt into DPI awareness so the icon is drawn at the tray's real pixel size
+# (20px at 125%, 24px at 150%) instead of being drawn at 16px and blurred up.
+Add-Type -Namespace TokenLarper -Name Dpi -MemberDefinition '[DllImport("user32.dll")] public static extern bool SetProcessDPIAware();'
+[TokenLarper.Dpi]::SetProcessDPIAware() | Out-Null
+
+# The t. monogram from src/client/logo.svg, drawn in its 64-unit coordinates.
+$iconSize = [Math]::Max(16, [System.Windows.Forms.SystemInformation]::SmallIconSize.Width)
+$bmp = New-Object System.Drawing.Bitmap($iconSize, $iconSize)
+$g = [System.Drawing.Graphics]::FromImage($bmp)
+$g.SmoothingMode = [System.Drawing.Drawing2D.SmoothingMode]::AntiAlias
+$g.PixelOffsetMode = [System.Drawing.Drawing2D.PixelOffsetMode]::HighQuality
+$g.Clear([System.Drawing.Color]::Transparent)
+$g.ScaleTransform($iconSize / 64, $iconSize / 64)
+
+$green = New-Object System.Drawing.SolidBrush([System.Drawing.Color]::FromArgb(255, 47, 90, 67))
+$cream = New-Object System.Drawing.SolidBrush([System.Drawing.Color]::FromArgb(255, 243, 227, 191))
+$gold = New-Object System.Drawing.SolidBrush([System.Drawing.Color]::FromArgb(255, 225, 183, 92))
+
+# Rounded square: x 3, y 3, size 58, corner radius 14.
+$tile = New-Object System.Drawing.Drawing2D.GraphicsPath
+$tile.AddArc(3, 3, 28, 28, 180, 90)
+$tile.AddArc(33, 3, 28, 28, 270, 90)
+$tile.AddArc(33, 33, 28, 28, 0, 90)
+$tile.AddArc(3, 33, 28, 28, 90, 90)
+$tile.CloseFigure()
+$g.FillPath($green, $tile)
+
+# Letter t: a stem with a curved foot, plus the crossbar.
+$stem = New-Object System.Drawing.Drawing2D.GraphicsPath
+$stem.AddLine(20, 12, 28, 12)
+$stem.AddLine(28, 12, 28, 43.5)
+$stem.AddBezier(28, 43.5, 28, 45.2, 28.8, 46, 30.5, 46)
+$stem.AddLine(30.5, 46, 35, 46)
+$stem.AddLine(35, 46, 35, 53)
+$stem.AddLine(35, 53, 28.5, 53)
+$stem.AddBezier(28.5, 53, 22.8, 53, 20, 50.2, 20, 44.5)
+$stem.CloseFigure()
+$g.FillPath($cream, $stem)
+$g.FillRectangle($cream, 13, 21, 22, 7)
+
+# The dot.
+$g.FillEllipse($gold, 39.5, 42, 11, 11)
+
+$hIcon = $bmp.GetHicon()
+$icon = [System.Drawing.Icon]::FromHandle($hIcon)
+
+$notifyIcon = New-Object System.Windows.Forms.NotifyIcon
+$notifyIcon.Icon = $icon
+$notifyIcon.Text = "Token Larper - AI Coding Telemetry (Port $ServerPort)"
+$notifyIcon.Visible = $true
+
+# Context Menu
+$menu = New-Object System.Windows.Forms.ContextMenuStrip
+
+$itemHeader = New-Object System.Windows.Forms.ToolStripMenuItem("Token Larper Telemetry")
+$itemHeader.Enabled = $false
+$menu.Items.Add($itemHeader) | Out-Null
+
+$itemStats = New-Object System.Windows.Forms.ToolStripMenuItem("Loading usage stats...")
+$itemStats.Enabled = $false
+$menu.Items.Add($itemStats) | Out-Null
+
+$menu.Items.Add((New-Object System.Windows.Forms.ToolStripSeparator)) | Out-Null
+
+$itemOpen = New-Object System.Windows.Forms.ToolStripMenuItem("Open Dashboard (http://localhost:$ServerPort)")
+$itemOpen.Font = New-Object System.Drawing.Font($itemOpen.Font, [System.Drawing.FontStyle]::Bold)
+$itemOpen.Add_Click({
+  Start-Process "$BaseUrl"
+})
+$menu.Items.Add($itemOpen) | Out-Null
+
+$itemSync = New-Object System.Windows.Forms.ToolStripMenuItem("Sync Harnesses Now (ccusage)")
+$itemSync.Add_Click({
+  try {
+    $notifyIcon.ShowBalloonTip(2000, "Token Larper", "Syncing coding harnesses via ccusage...", [System.Windows.Forms.ToolTipIcon]::Info)
+    Invoke-RestMethod -Uri "$BaseUrl/api/usage?refresh=1" -Method Get -TimeoutSec 20 | Out-Null
+    Update-TrayStatus
+    $notifyIcon.ShowBalloonTip(2500, "Token Larper Synced", $itemStats.Text, [System.Windows.Forms.ToolTipIcon]::Info)
+  } catch {
+    $notifyIcon.ShowBalloonTip(2500, "Token Larper", "Failed to sync harnesses.", [System.Windows.Forms.ToolTipIcon]::Warning)
+  }
+})
+$menu.Items.Add($itemSync) | Out-Null
+
+$menu.Items.Add((New-Object System.Windows.Forms.ToolStripSeparator)) | Out-Null
+
+$itemBoot = New-Object System.Windows.Forms.ToolStripMenuItem("Start on Windows Boot")
+$itemBoot.CheckOnClick = $false
+$itemBoot.Add_Click({
+  try {
+    $nextState = -not $itemBoot.Checked
+    $body = @{ enabled = $nextState; openBrowserOnBoot = $itemOpenOnBoot.Checked } | ConvertTo-Json
+    $res = Invoke-RestMethod -Uri "$BaseUrl/api/startup" -Method Post -Body $body -ContentType "application/json" -TimeoutSec 5
+    $itemBoot.Checked = [bool]$res.enabled
+    $itemOpenOnBoot.Checked = [bool]$res.openBrowserOnBoot
+  } catch {}
+})
+$menu.Items.Add($itemBoot) | Out-Null
+
+$itemOpenOnBoot = New-Object System.Windows.Forms.ToolStripMenuItem("Auto-Open Browser on Boot")
+$itemOpenOnBoot.CheckOnClick = $false
+$itemOpenOnBoot.Add_Click({
+  try {
+    $nextOpen = -not $itemOpenOnBoot.Checked
+    $body = @{ enabled = $itemBoot.Checked; openBrowserOnBoot = $nextOpen } | ConvertTo-Json
+    $res = Invoke-RestMethod -Uri "$BaseUrl/api/startup" -Method Post -Body $body -ContentType "application/json" -TimeoutSec 5
+    $itemBoot.Checked = [bool]$res.enabled
+    $itemOpenOnBoot.Checked = [bool]$res.openBrowserOnBoot
+  } catch {}
+})
+$menu.Items.Add($itemOpenOnBoot) | Out-Null
+
+$menu.Items.Add((New-Object System.Windows.Forms.ToolStripSeparator)) | Out-Null
+
+$itemQuit = New-Object System.Windows.Forms.ToolStripMenuItem("Quit Token Larper")
+$itemQuit.Add_Click({
+  $notifyIcon.Visible = $false
+  try {
+    Invoke-RestMethod -Uri "$BaseUrl/api/shutdown" -Method Post -ContentType "application/json" -TimeoutSec 3 | Out-Null
+  } catch {}
+  try {
+    Stop-Process -Id $ServerPid -Force -ErrorAction SilentlyContinue
+  } catch {}
+  $notifyIcon.Dispose()
+  [System.Windows.Forms.Application]::Exit()
+})
+$menu.Items.Add($itemQuit) | Out-Null
+
+$notifyIcon.ContextMenuStrip = $menu
+
+# Double-click tray icon opens dashboard
+$notifyIcon.Add_DoubleClick({
+  Start-Process "$BaseUrl"
+})
+
+function Update-TrayStatus {
+  try {
+    $st = Invoke-RestMethod -Uri "$BaseUrl/api/tray-status" -Method Get -TimeoutSec 4
+    if ($null -ne $st) {
+      $itemStats.Text = $st.summaryText
+      $tooltip = "Token Larper: $($st.shortTooltip)"
+      if ($tooltip.Length -gt 63) {
+        $tooltip = $tooltip.Substring(0, 63)
+      }
+      $notifyIcon.Text = $tooltip
+      $itemBoot.Checked = [bool]$st.bootEnabled
+      $itemOpenOnBoot.Checked = [bool]$st.openBrowserOnBoot
+    }
+  } catch {}
+}
+
+# Timer to check parent Bun server health & update stats
+$timer = New-Object System.Windows.Forms.Timer
+$timer.Interval = 5000
+$script:tickCount = 0
+$timer.Add_Tick({
+  $proc = Get-Process -Id $ServerPid -ErrorAction SilentlyContinue
+  if ($null -eq $proc) {
+    $notifyIcon.Visible = $false
+    $notifyIcon.Dispose()
+    [System.Windows.Forms.Application]::Exit()
+    return
+  }
+  $script:tickCount++
+  if ($script:tickCount -eq 1 -or ($script:tickCount % 3 -eq 0)) {
+    Update-TrayStatus
+  }
+})
+$timer.Start()
+
+Update-TrayStatus
+$notifyIcon.ShowBalloonTip(2500, "Token Larper Running", "Right-click or double-click the green t. icon in your system tray.", [System.Windows.Forms.ToolTipIcon]::Info)
+
+[System.Windows.Forms.Application]::Run()
+`.trim();
+
+  writeFileSync(TRAY_PS1_PATH, psScript, "utf8");
+
+  // Generate WinSta0\Default desktop trampoline so even sandboxed terminals attach to Explorer's tray
+  const launcherScript = `
+Add-Type @"
+using System;
+using System.Runtime.InteropServices;
+public class DefaultDesktopLauncher {
+    [StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
+    public struct STARTUPINFO {
+        public int cb;
+        public string lpReserved;
+        public string lpDesktop;
+        public string lpTitle;
+        public int dwX; public int dwY; public int dwXSize; public int dwYSize;
+        public int dwXCountChars; public int dwYCountChars; public int dwFillAttribute;
+        public int dwFlags; public short wShowWindow; public short cbReserved2;
+        public IntPtr lpReserved2; public IntPtr hStdInput; public IntPtr hStdOutput; public IntPtr hStdError;
+    }
+    [StructLayout(LayoutKind.Sequential)]
+    public struct PROCESS_INFORMATION {
+        public IntPtr hProcess; public IntPtr hThread; public int dwProcessId; public int dwThreadId;
+    }
+    [DllImport("kernel32.dll", CharSet = CharSet.Unicode, SetLastError = true)]
+    public static extern bool CreateProcess(
+        string lpApplicationName, string lpCommandLine, IntPtr lpProcessAttributes, IntPtr lpThreadAttributes,
+        bool bInheritHandles, uint dwCreationFlags, IntPtr lpEnvironment, string lpCurrentDirectory,
+        ref STARTUPINFO lpStartupInfo, out PROCESS_INFORMATION lpProcessInformation);
+
+    public static int LaunchOnDefaultDesktop(string cmdLine, string workDir) {
+        STARTUPINFO si = new STARTUPINFO();
+        si.cb = Marshal.SizeOf(si);
+        si.lpDesktop = "WinSta0\\\\Default";
+        si.dwFlags = 1;
+        si.wShowWindow = 0;
+        PROCESS_INFORMATION pi;
+        uint CREATE_NO_WINDOW = 0x08000000;
+        bool ok = CreateProcess(null, cmdLine, IntPtr.Zero, IntPtr.Zero, false, CREATE_NO_WINDOW, IntPtr.Zero, workDir, ref si, out pi);
+        if (!ok) return -Marshal.GetLastWin32Error();
+        return pi.dwProcessId;
+    }
+}
+"@
+$cmd = "powershell.exe -NoProfile -ExecutionPolicy Bypass -Sta -File \`"${TRAY_PS1_PATH}\`""
+$launchedPid = [DefaultDesktopLauncher]::LaunchOnDefaultDesktop($cmd, "${ROOT_DIR}")
+Write-Output $launchedPid
+`.trim();
+
+  writeFileSync(TRAY_LAUNCHER_PS1, launcherScript, "utf8");
+  return TRAY_LAUNCHER_PS1;
+}
+
+export async function startSystemTray(port: number): Promise<void> {
+  if (process.platform !== "win32") return;
+  if (process.env.NO_TRAY === "1") return;
+
+  try {
+    const launcherPath = generateTrayScript(port, process.pid);
+    const proc = Bun.spawn(
+      [
+        "powershell.exe",
+        "-NoProfile",
+        "-NonInteractive",
+        "-ExecutionPolicy",
+        "Bypass",
+        "-File",
+        launcherPath,
+      ],
+      {
+        stdout: "pipe",
+        stderr: "ignore",
+      }
+    );
+    const out = (await new Response(proc.stdout).text()).trim();
+    const parsedPid = Number(out);
+    if (Number.isFinite(parsedPid) && parsedPid > 0) {
+      trayPid = parsedPid;
+    }
+  } catch (err) {
+    console.error("Failed to launch system tray icon:", err);
+  }
+}
+
+export function stopSystemTray(): void {
+  if (trayPid && trayPid > 0) {
+    try {
+      Bun.spawnSync(["taskkill.exe", "/PID", String(trayPid), "/F"], {
+        stdout: "ignore",
+        stderr: "ignore",
+      });
+    } catch {
+      // ignore
+    }
+    trayPid = null;
+  }
+}

package/src/types.ts

@@ -0,0 +1,155 @@
+export type HarnessId =
+  | "claude"
+  | "codex"
+  | "antigravity"
+  | "pi"
+  | "opencode"
+  | "gemini"
+  | "copilot"
+  | "amp"
+  | "droid"
+  | "codebuff"
+  | "hermes"
+  | "goose"
+  | "kilo"
+  | "kimi"
+  | "qwen"
+  | "openclaw"
+  | "grok"
+  | "zcode";
+
+export interface HarnessMetadata {
+  id: HarnessId;
+  name: string;
+  vendor: string;
+  color: string;
+  accentBg: string;
+  description: string;
+  configPathHint: string;
+  installed: boolean;
+  hasUsage: boolean;
+  syncStatus: "ready" | "syncing" | "idle" | "error";
+  lastSyncMs?: number;
+}
+
+export interface ModelMetric {
+  modelName: string;
+  harness: HarnessId;
+  inputTokens: number;
+  outputTokens: number;
+  cacheCreationTokens: number;
+  cacheReadTokens: number;
+  reasoningOutputTokens: number;
+  totalTokens: number;
+  verifiedCost: number;
+  estimatedCost: number;
+  missingPricing: boolean;
+}
+
+export interface PeriodHarnessBreakdown {
+  harness: HarnessId;
+  inputTokens: number;
+  outputTokens: number;
+  cacheCreationTokens: number;
+  cacheReadTokens: number;
+  reasoningOutputTokens: number;
+  totalTokens: number;
+  verifiedCost: number;
+  estimatedCost: number;
+  models: ModelMetric[];
+}
+
+export interface TimePeriodRow {
+  period: string; // YYYY-MM-DD, YYYY-Www, YYYY-MM, or YYYY
+  label: string;
+  inputTokens: number;
+  outputTokens: number;
+  cacheCreationTokens: number;
+  cacheReadTokens: number;
+  reasoningOutputTokens: number;
+  totalTokens: number;
+  verifiedCost: number;
+  estimatedCost: number;
+  byHarness: Record<string, PeriodHarnessBreakdown>;
+  modelsUsed: string[];
+}
+
+export interface SessionEntry {
+  id: string;
+  harness: HarnessId;
+  projectPath: string;
+  /** Working directory read from the harness's own session files, when it records one. */
+  cwd?: string;
+  /** Repository root (nearest folder with .git) or the cwd; sessions are grouped by this. */
+  projectRoot?: string;
+  projectName?: string;
+  firstActivity?: string;
+  lastActivity?: string;
+  date: string;
+  inputTokens: number;
+  outputTokens: number;
+  cacheCreationTokens: number;
+  cacheReadTokens: number;
+  reasoningOutputTokens: number;
+  totalTokens: number;
+  verifiedCost: number;
+  estimatedCost: number;
+  modelsUsed: string[];
+  modelBreakdowns: ModelMetric[];
+}
+
+export interface HarnessSummary {
+  meta: HarnessMetadata;
+  inputTokens: number;
+  outputTokens: number;
+  cacheCreationTokens: number;
+  cacheReadTokens: number;
+  reasoningOutputTokens: number;
+  totalTokens: number;
+  verifiedCost: number;
+  estimatedCost: number;
+  activeDays: number;
+  sessionCount: number;
+  lastActiveDate: string | null;
+  topModel: string | null;
+  cacheHitRate: number;
+  models: ModelMetric[];
+  unpricedModels: string[];
+}
+
+export interface DashboardPayload {
+  generatedAt: string;
+  ccusageVersion: string;
+  syncingHarnesses: HarnessId[];
+  totals: {
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationTokens: number;
+    cacheReadTokens: number;
+    reasoningOutputTokens: number;
+    totalTokens: number;
+    verifiedCost: number;
+    estimatedCost: number;
+    activeHarnesses: number;
+    installedHarnesses: number;
+    totalHarnesses: number;
+    activeDays: number;
+    totalSessions: number;
+    cacheHitRate: number;
+  };
+  harnesses: HarnessSummary[];
+  daily: TimePeriodRow[];
+  weekly: TimePeriodRow[];
+  monthly: TimePeriodRow[];
+  yearly: TimePeriodRow[];
+  models: ModelMetric[];
+  sessions: SessionEntry[];
+}
+
+export interface StartupConfig {
+  enabled: boolean;
+  openBrowserOnBoot: boolean;
+  port: number;
+  registryValue: string | null;
+  launcherPath: string;
+}