noctrace 0.5.1 → 0.6.1

package/README.md

@@ -54,7 +54,10 @@ Requires Node.js 20+. That's it. No config required. Optional hooks for real-tim
 - **Token drift detection** — tracks how per-turn token cost drifts from baseline, warns when sessions burn excessive quota
 - **Context Health grade** — A-F letter grade from 5 signals with actionable recommendations
 - **Compact stats pill** — toolbar shows agent count, health grade, drift factor, total tokens, and session duration at a glance
-- **Filter with highlighting** — search by tool name, label, or keywords (`error`, `agent`, `running`) with yellow match highlighting
+- **Advanced filtering** — structured filter syntax: `type:bash`, `>5s`, `<100ms`, `tokens:>1k`, `error`, `running`, `success` — combinable with plain text search
+- **Per-tool latency stats** — Session Stats flyout shows P50/P95/Max latency per tool type; calls exceeding a configurable threshold (default 5s) are flagged with a clock icon
+- **Loop detection** — flags 3+ consecutive identical tool calls (same tool + same input) as a warning tip on the row
+- **Session comparison** — split-screen view comparing two sessions side-by-side: health grades, summary metrics, tool mix bars, and context fill trajectory sparklines
 - **Virtual scrolling** — handles sessions with thousands of tool calls
 - **Zoom & pan** — mouse wheel zoom (1-50x), click-drag pan
 - **Detail panel** — click any row for full tool input/output, resizable
@@ -66,6 +69,7 @@ Requires Node.js 20+. That's it. No config required. Optional hooks for real-tim
 - **Session export** — share sessions as standalone offline HTML files
 - **Hooks integration** — optional real-time event streaming from Claude Code
 - **Context Drift Rate** — detect accelerating token growth before context rot hits
+- **MCP session registry** — when integrated with Claude Code, sessions self-register on start and unregister on exit; dashboard shows only active sessions with a live count indicator
 
 ![Noctrace waterfall timeline](docs/screenshots/noctrace-waterfall.gif)
 
@@ -95,6 +99,14 @@ Click any row to inspect the full tool input and output. Two-column layout shows
 
 ## How it works
 
+Noctrace has two modes depending on how you start it:
+
+**Standalone mode** (`npx noctrace`) — scans all of `~/.claude/projects/` and shows every session. Good for reviewing past work or running alongside a session you've already started.
+
+**MCP mode** (via Claude Code integration) — sessions register and unregister themselves automatically. The session picker shows only currently active sessions and a "MCP mode — N active sessions" indicator. Multiple Claude Code sessions share one noctrace dashboard without interference.
+
+In both modes:
+
 1. Starts a local server on `http://localhost:4117` (auto-finds next available port)
 2. Opens your browser
 3. Reads JSONL session logs from `~/.claude/projects/`

package/bin/claude-config.js

@@ -0,0 +1,139 @@
+#!/usr/bin/env node
+/**
+ * Shared helpers for reading/writing Claude Code MCP server registration
+ * in ~/.claude/settings.json.
+ *
+ * Used by:
+ *   - noctrace --enable / --disable
+ *   - bin/postinstall.js
+ *   - bin/preuninstall.js
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import os from 'node:os';
+
+/**
+ * Resolve the path to ~/.claude/settings.json.
+ * Respects the CLAUDE_HOME env var override.
+ */
+export function settingsPath() {
+  const claudeHome = process.env.CLAUDE_HOME ?? path.join(os.homedir(), '.claude');
+  return path.join(claudeHome, 'settings.json');
+}
+
+/**
+ * Resolve the ~/.claude directory path.
+ * Respects the CLAUDE_HOME env var override.
+ */
+export function claudeDir() {
+  return process.env.CLAUDE_HOME ?? path.join(os.homedir(), '.claude');
+}
+
+/**
+ * Read and parse settings.json.
+ * Returns {} if the file doesn't exist or contains invalid JSON.
+ */
+export async function readSettings(filePath) {
+  try {
+    const raw = await fs.readFile(filePath, 'utf8');
+    try {
+      return JSON.parse(raw);
+    } catch {
+      // Corrupted JSON — start fresh rather than aborting
+      return {};
+    }
+  } catch (err) {
+    if (err.code === 'ENOENT') return {};
+    throw err;
+  }
+}
+
+/**
+ * Write settings back to disk, creating parent directories as needed.
+ */
+export async function writeSettings(filePath, settings) {
+  await fs.mkdir(path.dirname(filePath), { recursive: true });
+  await fs.writeFile(filePath, JSON.stringify(settings, null, 2) + '\n', 'utf8');
+}
+
+/**
+ * Register noctrace as an MCP server in ~/.claude/settings.json.
+ *
+ * Adds:
+ *   mcpServers.noctrace = { command: "npx", args: ["-y", "noctrace", "--mcp"] }
+ *
+ * Preserves all other settings and MCP server entries.
+ *
+ * @param {object} [opts]
+ * @param {boolean} [opts.silent]  Suppress console output (for postinstall quiet mode)
+ * @returns {{ alreadyConfigured: boolean }}
+ */
+export async function enableMcp({ silent = false } = {}) {
+  const sp = settingsPath();
+  const settings = await readSettings(sp);
+
+  if (!settings.mcpServers) settings.mcpServers = {};
+
+  const already =
+    settings.mcpServers.noctrace != null &&
+    settings.mcpServers.noctrace.command === 'npx' &&
+    Array.isArray(settings.mcpServers.noctrace.args) &&
+    settings.mcpServers.noctrace.args.includes('--mcp');
+
+  settings.mcpServers.noctrace = {
+    command: 'npx',
+    args: ['-y', 'noctrace', '--mcp'],
+  };
+
+  await writeSettings(sp, settings);
+
+  if (!silent) {
+    if (already) {
+      console.log('[noctrace] MCP server already configured — updated entry.');
+    } else {
+      console.log('[noctrace] Registered noctrace MCP server in Claude Code settings.');
+    }
+    console.log('[noctrace] Settings written to:', sp);
+  }
+
+  return { alreadyConfigured: already };
+}
+
+/**
+ * Remove the noctrace MCP server entry from ~/.claude/settings.json.
+ *
+ * Cleans up the mcpServers key entirely if it becomes empty.
+ *
+ * @param {object} [opts]
+ * @param {boolean} [opts.silent]  Suppress console output
+ * @returns {{ wasConfigured: boolean }}
+ */
+export async function disableMcp({ silent = false } = {}) {
+  const sp = settingsPath();
+  const settings = await readSettings(sp);
+
+  const wasConfigured = settings.mcpServers?.noctrace != null;
+
+  if (!wasConfigured) {
+    if (!silent) {
+      console.log('[noctrace] Noctrace is not configured in Claude Code.');
+    }
+    return { wasConfigured: false };
+  }
+
+  delete settings.mcpServers.noctrace;
+
+  // Remove the mcpServers key entirely if it's now empty
+  if (Object.keys(settings.mcpServers).length === 0) {
+    delete settings.mcpServers;
+  }
+
+  await writeSettings(sp, settings);
+
+  if (!silent) {
+    console.log('[noctrace] Removed noctrace MCP server from Claude Code settings.');
+    console.log('[noctrace] Settings written to:', sp);
+  }
+
+  return { wasConfigured: true };
+}

package/bin/noctrace-mcp.js

@@ -1,44 +1,199 @@
 #!/usr/bin/env node
 /**
- * Minimal MCP server wrapper for the noctrace plugin.
+ * MCP server wrapper for the noctrace plugin.
  *
- * Starts the noctrace Express server as a side effect and speaks just enough
- * MCP (JSON-RPC 2.0 over stdio) to stay alive as a Claude Code managed process.
- * Exposes a single `open_dashboard` tool so Claude can tell the user the URL.
+ * Behaviour:
+ *  1. Discovers the current Claude Code session's JSONL path from env vars.
+ *  2. Checks whether noctrace is already running on port 4117.
+ *  3. If not running, starts the Express server and opens the browser.
+ *  4. Registers this session via POST /api/sessions/register.
+ *  5. Speaks JSON-RPC 2.0 over stdio to satisfy Claude Code's MCP protocol.
+ *  6. On exit (SIGTERM / SIGINT / stdin close), unregisters the session.
+ *
+ * Session path discovery order:
+ *  a. CLAUDE_SESSION_PATH env var (direct path to the .jsonl file)
+ *  b. CLAUDE_PROJECT_DIR or PWD → compute project slug → find newest .jsonl
+ *  c. Fall back to null (register with null; file watcher will pick it up)
  */
 import { createInterface } from 'node:readline';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import os from 'node:os';
+
+const VERSION = '0.5.1';
+const NOCTRACE_PORT = 4117;
+const BASE_URL = `http://localhost:${NOCTRACE_PORT}`;
+
+// ---------------------------------------------------------------------------
+// Session path discovery
+// ---------------------------------------------------------------------------
+
+/**
+ * Convert an absolute filesystem path to the Claude project slug format.
+ * Slugs replace every "/" with "-" and strip any leading "-".
+ * Example: /Users/lam/dev/noctrace → -Users-lam-dev-noctrace
+ */
+function pathToSlug(absPath) {
+  return absPath.replace(/\//g, '-');
+}
+
+/**
+ * Return the path to the most recently modified .jsonl file in `dir`,
+ * or null if the directory is empty / inaccessible.
+ *
+ * @param {string} dir — absolute path to a project directory
+ * @returns {Promise<string|null>}
+ */
+async function newestJsonl(dir) {
+  let files;
+  try {
+    files = await fs.readdir(dir);
+  } catch {
+    return null;
+  }
+  const jsonlFiles = files.filter((f) => f.endsWith('.jsonl'));
+  if (jsonlFiles.length === 0) return null;
+
+  let newest = null;
+  let newestMtime = -Infinity;
+
+  for (const file of jsonlFiles) {
+    try {
+      const stat = await fs.stat(path.join(dir, file));
+      if (stat.mtimeMs > newestMtime) {
+        newestMtime = stat.mtimeMs;
+        newest = path.join(dir, file);
+      }
+    } catch {
+      // skip
+    }
+  }
+  return newest;
+}
 
-const VERSION = '0.4.0';
-let serverPort = null;
-let browserOpened = false;
+/**
+ * Discover the JSONL session path for the current Claude Code session.
+ *
+ * @returns {Promise<string|null>}
+ */
+async function discoverSessionPath() {
+  // Option a: direct env var
+  if (process.env.CLAUDE_SESSION_PATH) {
+    return process.env.CLAUDE_SESSION_PATH;
+  }
+
+  // Option b: derive from project directory
+  const projectDir = process.env.CLAUDE_PROJECT_DIR ?? process.env.PWD ?? null;
+  if (!projectDir) return null;
+
+  const claudeHome = process.env.CLAUDE_HOME ?? path.join(os.homedir(), '.claude');
+  const slug = pathToSlug(projectDir);
+  const projectSessionDir = path.join(claudeHome, 'projects', slug);
+
+  return newestJsonl(projectSessionDir);
+}
+
+// ---------------------------------------------------------------------------
+// Port / server helpers
+// ---------------------------------------------------------------------------
+
+/**
+ * Check whether noctrace is already running on the configured port.
+ * Uses the /api/health endpoint; resolves true if reachable, false otherwise.
+ *
+ * @returns {Promise<boolean>}
+ */
+async function isServerRunning() {
+  try {
+    const { default: http } = await import('node:http');
+    return await new Promise((resolve) => {
+      const req = http.get(`${BASE_URL}/api/health`, { timeout: 1500 }, (res) => {
+        resolve(res.statusCode >= 200 && res.statusCode < 500);
+      });
+      req.on('error', () => resolve(false));
+      req.on('timeout', () => { req.destroy(); resolve(false); });
+    });
+  } catch {
+    return false;
+  }
+}
 
-// Start the Express server (lazy import to avoid loading before needed)
-async function boot() {
+/**
+ * Start the noctrace Express server by importing the compiled entry point.
+ * Sets NOCTRACE_NO_AUTOSTART so the module does not start a second server
+ * instance when imported as a side-effect.
+ *
+ * @returns {Promise<void>}
+ */
+async function startNoctraceServer() {
   process.env.NOCTRACE_NO_AUTOSTART = '1';
   const { startServer } = await import('../dist/server/server/index.js');
-  serverPort = await startServer();
+  await startServer();
+}
 
-  // Open browser once on first start
-  if (!browserOpened) {
-    const open = (await import('open')).default;
-    await open(`http://localhost:${serverPort}`);
-    browserOpened = true;
-  }
+// ---------------------------------------------------------------------------
+// Session registration
+// ---------------------------------------------------------------------------
+
+/**
+ * POST a session path to the noctrace register/unregister endpoint.
+ *
+ * @param {'register'|'unregister'} action
+ * @param {string} sessionPath
+ * @returns {Promise<void>}
+ */
+async function postSessionAction(action, sessionPath) {
+  const { default: http } = await import('node:http');
+  const body = JSON.stringify({ sessionPath });
+  return new Promise((resolve) => {
+    const req = http.request(
+      {
+        hostname: 'localhost',
+        port: NOCTRACE_PORT,
+        path: `/api/sessions/${action}`,
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'Content-Length': Buffer.byteLength(body),
+        },
+        timeout: 3000,
+      },
+      () => resolve(),
+    );
+    req.on('error', () => resolve());
+    req.on('timeout', () => { req.destroy(); resolve(); });
+    req.write(body);
+    req.end();
+  });
 }
 
-// JSON-RPC response helper
+// ---------------------------------------------------------------------------
+// JSON-RPC helpers
+// ---------------------------------------------------------------------------
+
+/**
+ * Write a JSON-RPC 2.0 response to stdout.
+ * All other output must go to stderr (stdout is the MCP channel).
+ *
+ * @param {unknown} id
+ * @param {unknown} result
+ */
 function respond(id, result) {
   const msg = JSON.stringify({ jsonrpc: '2.0', id, result });
   process.stdout.write(`${msg}\n`);
 }
 
-// Handle incoming JSON-RPC messages from Claude Code
+/**
+ * Handle a single JSON-RPC message from Claude Code.
+ *
+ * @param {string} line
+ */
 function handleMessage(line) {
   let msg;
   try {
     msg = JSON.parse(line);
   } catch {
-    return; // ignore malformed input
+    return;
   }
 
   const { id, method, params } = msg;
@@ -53,8 +208,7 @@ function handleMessage(line) {
   }
 
   if (method === 'notifications/initialized') {
-    // No response needed for notifications
-    return;
+    return; // no response for notifications
   }
 
   if (method === 'tools/list') {
@@ -73,15 +227,12 @@ function handleMessage(line) {
   if (method === 'tools/call') {
     const toolName = params?.name;
     if (toolName === 'open_dashboard') {
-      const url = `http://localhost:${serverPort ?? 4117}`;
-      // Open browser
-      import('open').then((m) => m.default(url)).catch(() => {});
+      import('open').then((m) => m.default(BASE_URL)).catch(() => {});
       respond(id, {
-        content: [{ type: 'text', text: `Noctrace dashboard: ${url}` }],
+        content: [{ type: 'text', text: `Noctrace dashboard: ${BASE_URL}` }],
       });
       return;
     }
-    // Unknown tool
     respond(id, {
       content: [{ type: 'text', text: `Unknown tool: ${toolName}` }],
       isError: true,
@@ -95,20 +246,87 @@ function handleMessage(line) {
   }
 }
 
+// ---------------------------------------------------------------------------
 // Main
+// ---------------------------------------------------------------------------
+
 async function main() {
-  await boot();
+  let sessionPath = await discoverSessionPath();
+
+  // Check if noctrace is already running; if not, start it (first MCP process wins).
+  // Use a retry loop to handle the race where two MCP processes start simultaneously.
+  const running = await isServerRunning();
+  if (!running) {
+    process.stderr.write('[noctrace-mcp] Starting noctrace server...\n');
+    try {
+      await startNoctraceServer();
+    } catch (err) {
+      if (err.code === 'EADDRINUSE') {
+        // Another process won the race — verify it's reachable before continuing.
+        const nowRunning = await isServerRunning();
+        if (!nowRunning) {
+          process.stderr.write('[noctrace-mcp] Fatal: port in use but server is not responding\n');
+          process.exit(1);
+        }
+        process.stderr.write('[noctrace-mcp] Server started by peer process — continuing\n');
+      } else {
+        // A real startup error (e.g. missing dist/, permission denied) — surface it.
+        process.stderr.write(`[noctrace-mcp] Fatal: could not start server: ${err.message}\n`);
+        process.exit(1);
+      }
+    }
+
+    // Open the browser — only the first MCP process to start the server does this
+    try {
+      const open = (await import('open')).default;
+      await open(BASE_URL);
+    } catch {
+      // Non-fatal — user can navigate manually
+    }
+  }
+
+  // Retry session discovery once — Claude Code may still be creating the session file
+  // when the MCP server starts. Wait 1 second and prefer the newer result.
+  await new Promise((r) => setTimeout(r, 1000));
+  const retryPath = await discoverSessionPath();
+  if (retryPath && retryPath !== sessionPath) {
+    sessionPath = retryPath;
+  }
 
+  if (sessionPath) {
+    process.stderr.write(`[noctrace-mcp] Session: ${sessionPath}\n`);
+  } else {
+    process.stderr.write('[noctrace-mcp] Could not discover session path — proceeding without registration\n');
+  }
+
+  // Register this session with the running noctrace server
+  if (sessionPath) {
+    await postSessionAction('register', sessionPath);
+    process.stderr.write('[noctrace-mcp] Session registered\n');
+  }
+
+  // Cleanup: unregister on process exit
+  let cleaned = false;
+  async function cleanup() {
+    if (cleaned) return;
+    cleaned = true;
+    if (sessionPath) {
+      await postSessionAction('unregister', sessionPath).catch(() => {});
+    }
+  }
+
+  process.on('SIGTERM', () => { void cleanup().then(() => process.exit(0)); });
+  process.on('SIGINT', () => { void cleanup().then(() => process.exit(0)); });
+
+  // Speak JSON-RPC over stdio for Claude Code's MCP protocol
   const rl = createInterface({ input: process.stdin });
   rl.on('line', handleMessage);
-
-  // Keep alive until stdin closes (Claude Code manages our lifecycle)
   rl.on('close', () => {
-    process.exit(0);
+    void cleanup().then(() => process.exit(0));
   });
 }
 
 main().catch((err) => {
-  console.error('[noctrace-mcp] Fatal:', err.message);
+  process.stderr.write(`[noctrace-mcp] Fatal: ${err.message}\n`);
   process.exit(1);
 });

package/bin/noctrace.js

@@ -2,6 +2,7 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import os from 'node:os';
+import { enableMcp, disableMcp } from './claude-config.js';
 
 const NOCTRACE_PORT = 4117;
 const NOCTRACE_BASE_URL = `http://localhost:${NOCTRACE_PORT}`;
@@ -177,6 +178,36 @@ if (args.includes('--uninstall-hooks')) {
   process.exit(0);
 }
 
+if (args.includes('--enable')) {
+  const { alreadyConfigured } = await enableMcp();
+  if (alreadyConfigured) {
+    console.log('[noctrace] MCP server entry updated.');
+  } else {
+    console.log('[noctrace] ✓ Noctrace will auto-start with your next Claude Code session.');
+    console.log('[noctrace]   Run "noctrace --disable" to remove.');
+  }
+  process.exit(0);
+}
+
+if (args.includes('--disable')) {
+  const { wasConfigured } = await disableMcp();
+  if (wasConfigured) {
+    console.log('[noctrace] ✓ Noctrace removed from Claude Code.');
+  } else {
+    console.log('[noctrace] Noctrace is not configured in Claude Code.');
+  }
+  process.exit(0);
+}
+
+if (args.includes('--mcp')) {
+  // MCP mode: boot the Express server and speak JSON-RPC over stdio.
+  // stdout is the JSON-RPC channel — all logging must go to stderr.
+  process.stderr.write('[noctrace-mcp] Starting MCP server...\n');
+  await import('./noctrace-mcp.js');
+  // noctrace-mcp.js takes over from here (runs main() internally)
+  process.exit(0); // unreachable — mcp keeps process alive via readline
+}
+
 // Default: start the server and open the browser
 process.env.NOCTRACE_NO_AUTOSTART = '1';
 const { startServer } = await import('../dist/server/server/index.js');

package/bin/postinstall.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+/**
+ * Auto-register noctrace as an MCP server in Claude Code settings.
+ * Runs after `npm install -g noctrace`.
+ *
+ * Only acts if ~/.claude/ already exists (i.e. Claude Code is installed).
+ * Never fails — always exits with code 0 so the install is never interrupted.
+ */
+import fs from 'node:fs/promises';
+import { claudeDir, enableMcp } from './claude-config.js';
+
+async function run() {
+  // Check whether Claude Code is installed
+  try {
+    await fs.access(claudeDir());
+  } catch {
+    // ~/.claude doesn't exist — Claude Code is not installed, skip silently
+    return;
+  }
+
+  // Check if already configured
+  const settingsFile = (await import('./claude-config.js')).settingsPath();
+  let alreadyConfigured = false;
+  try {
+    const raw = await fs.readFile(settingsFile, 'utf8');
+    const settings = JSON.parse(raw);
+    alreadyConfigured = !!settings?.mcpServers?.noctrace;
+  } catch {
+    // No settings file or invalid JSON — not configured
+  }
+
+  if (alreadyConfigured) {
+    return; // Already set up, nothing to say
+  }
+
+  // Don't auto-modify config — just tell the user how to opt in
+  console.log('');
+  console.log('  \x1b[36mnoctrace\x1b[0m installed successfully.');
+  console.log('');
+  console.log('  Auto-start with Claude Code (recommended):');
+  console.log('    \x1b[1mnoctrace --enable\x1b[0m');
+  console.log('');
+  console.log('  Or run standalone:');
+  console.log('    \x1b[1mnoctrace\x1b[0m');
+  console.log('');
+}
+
+run().catch(() => {
+  // Silently swallow all errors — never break the install
+}).finally(() => {
+  process.exit(0);
+});

package/bin/preuninstall.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+/**
+ * Remove noctrace MCP server registration from Claude Code settings.
+ * Runs before `npm uninstall -g noctrace`.
+ *
+ * Never fails — always exits with code 0 so the uninstall is never interrupted.
+ */
+import fs from 'node:fs/promises';
+import { claudeDir, disableMcp } from './claude-config.js';
+
+async function run() {
+  // Check whether Claude Code is installed before touching anything
+  try {
+    await fs.access(claudeDir());
+  } catch {
+    // ~/.claude doesn't exist — nothing to clean up
+    return;
+  }
+
+  const { wasConfigured } = await disableMcp({ silent: true });
+
+  if (wasConfigured) {
+    console.log('[noctrace] Removed noctrace MCP server from Claude Code settings.');
+  }
+  // If not configured, exit quietly
+}
+
+run().catch(() => {
+  // Silently swallow all errors — never block the uninstall
+}).finally(() => {
+  process.exit(0);
+});

package/dist/client/assets/index-C4vi082v.css

@@ -0,0 +1,2 @@
+/*! tailwindcss v4.2.2 | MIT License | https://tailwindcss.com */
+@layer properties{@supports (((-webkit-hyphens:none)) and (not (margin-trim:inline))) or ((-moz-orient:inline) and (not (color:rgb(from red r g b)))){*,:before,:after,::backdrop{--tw-rotate-x:initial;--tw-rotate-y:initial;--tw-rotate-z:initial;--tw-skew-x:initial;--tw-skew-y:initial;--tw-border-style:solid;--tw-font-weight:initial;--tw-tracking:initial;--tw-shadow:0 0 #0000;--tw-shadow-color:initial;--tw-shadow-alpha:100%;--tw-inset-shadow:0 0 #0000;--tw-inset-shadow-color:initial;--tw-inset-shadow-alpha:100%;--tw-ring-color:initial;--tw-ring-shadow:0 0 #0000;--tw-inset-ring-color:initial;--tw-inset-ring-shadow:0 0 #0000;--tw-ring-inset:initial;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-offset-shadow:0 0 #0000;--tw-outline-style:solid;--tw-blur:initial;--tw-brightness:initial;--tw-contrast:initial;--tw-grayscale:initial;--tw-hue-rotate:initial;--tw-invert:initial;--tw-opacity:initial;--tw-saturate:initial;--tw-sepia:initial;--tw-drop-shadow:initial;--tw-drop-shadow-color:initial;--tw-drop-shadow-alpha:100%;--tw-drop-shadow-size:initial;--tw-ease:initial}}}@layer theme{:root,:host{--font-sans:ui-sans-serif, system-ui, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";--font-mono:ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;--spacing:.25rem;--text-xs:.75rem;--text-xs--line-height:calc(1 / .75);--text-sm:.875rem;--text-sm--line-height:calc(1.25 / .875);--font-weight-semibold:600;--font-weight-bold:700;--tracking-wider:.05em;--radius-sm:.25rem;--ease-in-out:cubic-bezier(.4, 0, .2, 1);--default-transition-duration:.15s;--default-transition-timing-function:cubic-bezier(.4, 0, .2, 1);--default-font-family:var(--font-sans);--default-mono-font-family:var(--font-mono)}}@layer base{*,:after,:before,::backdrop{box-sizing:border-box;border:0 solid;margin:0;padding:0}::file-selector-button{box-sizing:border-box;border:0 solid;margin:0;padding:0}html,:host{-webkit-text-size-adjust:100%;tab-size:4;line-height:1.5;font-family:var(--default-font-family,ui-sans-serif, system-ui, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji");font-feature-settings:var(--default-font-feature-settings,normal);font-variation-settings:var(--default-font-variation-settings,normal);-webkit-tap-highlight-color:transparent}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:var(--default-mono-font-family,ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace);font-feature-settings:var(--default-mono-font-feature-settings,normal);font-variation-settings:var(--default-mono-font-variation-settings,normal);font-size:1em}small{font-size:80%}sub,sup{vertical-align:baseline;font-size:75%;line-height:0;position:relative}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}:-moz-focusring{outline:auto}progress{vertical-align:baseline}summary{display:list-item}ol,ul,menu{list-style:none}img,svg,video,canvas,audio,iframe,embed,object{vertical-align:middle;display:block}img,video{max-width:100%;height:auto}button,input,select,optgroup,textarea{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}::file-selector-button{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}:where(select:is([multiple],[size])) optgroup{font-weight:bolder}:where(select:is([multiple],[size])) optgroup option{padding-inline-start:20px}::file-selector-button{margin-inline-end:4px}::placeholder{opacity:1}@supports (not ((-webkit-appearance:-apple-pay-button))) or (contain-intrinsic-size:1px){::placeholder{color:currentColor}@supports (color:color-mix(in lab, red, red)){::placeholder{color:color-mix(in oklab, currentcolor 50%, transparent)}}}textarea{resize:vertical}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-date-and-time-value{min-height:1lh;text-align:inherit}::-webkit-datetime-edit{display:inline-flex}::-webkit-datetime-edit-fields-wrapper{padding:0}::-webkit-datetime-edit{padding-block:0}::-webkit-datetime-edit-year-field{padding-block:0}::-webkit-datetime-edit-month-field{padding-block:0}::-webkit-datetime-edit-day-field{padding-block:0}::-webkit-datetime-edit-hour-field{padding-block:0}::-webkit-datetime-edit-minute-field{padding-block:0}::-webkit-datetime-edit-second-field{padding-block:0}::-webkit-datetime-edit-millisecond-field{padding-block:0}::-webkit-datetime-edit-meridiem-field{padding-block:0}::-webkit-calendar-picker-indicator{line-height:1}:-moz-ui-invalid{box-shadow:none}button,input:where([type=button],[type=reset],[type=submit]){appearance:button}::file-selector-button{appearance:button}::-webkit-inner-spin-button{height:auto}::-webkit-outer-spin-button{height:auto}[hidden]:where(:not([hidden=until-found])){display:none!important}}@layer components;@layer utilities{.pointer-events-none{pointer-events:none}.collapse{visibility:collapse}.invisible{visibility:hidden}.visible{visibility:visible}.absolute{position:absolute}.fixed{position:fixed}.relative{position:relative}.static{position:static}.sticky{position:sticky}.start{inset-inline-start:var(--spacing)}.end{inset-inline-end:var(--spacing)}.top-1\/2{top:50%}.top-2{top:calc(var(--spacing) * 2)}.top-8{top:calc(var(--spacing) * 8)}.right-0{right:calc(var(--spacing) * 0)}.right-1\.5{right:calc(var(--spacing) * 1.5)}.right-2{right:calc(var(--spacing) * 2)}.left-0{left:calc(var(--spacing) * 0)}.left-2{left:calc(var(--spacing) * 2)}.z-10{z-index:10}.z-50{z-index:50}.container{width:100%}@media (width>=40rem){.container{max-width:40rem}}@media (width>=48rem){.container{max-width:48rem}}@media (width>=64rem){.container{max-width:64rem}}@media (width>=80rem){.container{max-width:80rem}}@media (width>=96rem){.container{max-width:96rem}}.mx-3{margin-inline:calc(var(--spacing) * 3)}.mt-0\.5{margin-top:calc(var(--spacing) * .5)}.mt-1{margin-top:calc(var(--spacing) * 1)}.mt-2{margin-top:calc(var(--spacing) * 2)}.mb-0\.5{margin-bottom:calc(var(--spacing) * .5)}.mb-2{margin-bottom:calc(var(--spacing) * 2)}.block{display:block}.contents{display:contents}.flex{display:flex}.grid{display:grid}.hidden{display:none}.inline{display:inline}.inline-block{display:inline-block}.inline-flex{display:inline-flex}.table{display:table}.h-full{height:100%}.w-full{width:100%}.min-w-0{min-width:calc(var(--spacing) * 0)}.flex-1{flex:1}.shrink-0{flex-shrink:0}.transform{transform:var(--tw-rotate-x,) var(--tw-rotate-y,) var(--tw-rotate-z,) var(--tw-skew-x,) var(--tw-skew-y,)}.resize{resize:both}.flex-col{flex-direction:column}.items-center{align-items:center}.items-stretch{align-items:stretch}.justify-between{justify-content:space-between}.justify-center{justify-content:center}.justify-end{justify-content:flex-end}.gap-1{gap:calc(var(--spacing) * 1)}.gap-1\.5{gap:calc(var(--spacing) * 1.5)}.gap-2{gap:calc(var(--spacing) * 2)}.gap-3{gap:calc(var(--spacing) * 3)}.gap-4{gap:calc(var(--spacing) * 4)}.truncate{text-overflow:ellipsis;white-space:nowrap;overflow:hidden}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.rounded{border-radius:.25rem}.rounded-sm{border-radius:var(--radius-sm)}.rounded-r{border-top-right-radius:.25rem;border-bottom-right-radius:.25rem}.border{border-style:var(--tw-border-style);border-width:1px}.p-1{padding:calc(var(--spacing) * 1)}.p-2{padding:calc(var(--spacing) * 2)}.px-1\.5{padding-inline:calc(var(--spacing) * 1.5)}.px-2{padding-inline:calc(var(--spacing) * 2)}.px-2\.5{padding-inline:calc(var(--spacing) * 2.5)}.px-3{padding-inline:calc(var(--spacing) * 3)}.px-4{padding-inline:calc(var(--spacing) * 4)}.py-0\.5{padding-block:calc(var(--spacing) * .5)}.py-1{padding-block:calc(var(--spacing) * 1)}.py-1\.5{padding-block:calc(var(--spacing) * 1.5)}.py-2{padding-block:calc(var(--spacing) * 2)}.py-3{padding-block:calc(var(--spacing) * 3)}.py-4{padding-block:calc(var(--spacing) * 4)}.pr-3{padding-right:calc(var(--spacing) * 3)}.pb-3{padding-bottom:calc(var(--spacing) * 3)}.pb-4{padding-bottom:calc(var(--spacing) * 4)}.pl-7{padding-left:calc(var(--spacing) * 7)}.text-center{text-align:center}.text-left{text-align:left}.font-mono{font-family:var(--font-mono)}.text-sm{font-size:var(--text-sm);line-height:var(--tw-leading,var(--text-sm--line-height))}.text-xs{font-size:var(--text-xs);line-height:var(--tw-leading,var(--text-xs--line-height))}.font-bold{--tw-font-weight:var(--font-weight-bold);font-weight:var(--font-weight-bold)}.font-semibold{--tw-font-weight:var(--font-weight-semibold);font-weight:var(--font-weight-semibold)}.tracking-wider{--tw-tracking:var(--tracking-wider);letter-spacing:var(--tracking-wider)}.break-all{word-break:break-all}.whitespace-pre-wrap{white-space:pre-wrap}.uppercase{text-transform:uppercase}.italic{font-style:italic}.shadow-xl{--tw-shadow:0 20px 25px -5px var(--tw-shadow-color,#0000001a), 0 8px 10px -6px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)}.ring{--tw-ring-shadow:var(--tw-ring-inset,) 0 0 0 calc(1px + var(--tw-ring-offset-width)) var(--tw-ring-color,currentcolor);box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)}.outline{outline-style:var(--tw-outline-style);outline-width:1px}.filter{filter:var(--tw-blur,) var(--tw-brightness,) var(--tw-contrast,) var(--tw-grayscale,) var(--tw-hue-rotate,) var(--tw-invert,) var(--tw-saturate,) var(--tw-sepia,) var(--tw-drop-shadow,)}.transition{transition-property:color,background-color,border-color,outline-color,text-decoration-color,fill,stroke,--tw-gradient-from,--tw-gradient-via,--tw-gradient-to,opacity,box-shadow,transform,translate,scale,rotate,filter,-webkit-backdrop-filter,backdrop-filter,display,content-visibility,overlay,pointer-events;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-colors{transition-property:color,background-color,border-color,outline-color,text-decoration-color,fill,stroke,--tw-gradient-from,--tw-gradient-via,--tw-gradient-to;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.ease-in-out{--tw-ease:var(--ease-in-out);transition-timing-function:var(--ease-in-out)}.select-none{-webkit-user-select:none;user-select:none}.\[file\:line\]{file:line}@media (width>=48rem){.md\:hidden{display:none}}}:root{--ctp-base:#1e1e2e;--ctp-mantle:#181825;--ctp-crust:#11111b;--ctp-surface0:#313244;--ctp-surface1:#45475a;--ctp-surface2:#585b70;--ctp-overlay0:#6c7086;--ctp-overlay1:#7f849c;--ctp-text:#cdd6f4;--ctp-subtext0:#a6adc8;--ctp-subtext1:#bac2de;--ctp-blue:#89b4fa;--ctp-green:#a6e3a1;--ctp-yellow:#f9e2af;--ctp-peach:#fab387;--ctp-mauve:#cba6f7;--ctp-teal:#94e2d5;--ctp-red:#f38ba8;--ctp-pink:#f5c2e7;--ctp-lavender:#b4befe;--color-read:var(--ctp-blue);--color-write:var(--ctp-green);--color-edit:var(--ctp-yellow);--color-bash:var(--ctp-peach);--color-agent:var(--ctp-mauve);--color-grep:var(--ctp-teal);--color-error:var(--ctp-red);--color-running:var(--ctp-pink)}body{background-color:var(--ctp-base);color:var(--ctp-text);font-family:SF Mono,Cascadia Code,JetBrains Mono,Fira Code,ui-monospace,monospace}@keyframes pulse-edge{0%,to{opacity:.6}50%{opacity:.1}}.running-pulse{animation:1.2s ease-in-out infinite pulse-edge}@keyframes noc-pulse{0%,to{opacity:1;transform:scale(1)}50%{opacity:.4;transform:scale(.85)}}@keyframes noc-blink{0%,to{opacity:1}50%{opacity:0}}@media (width<=768px){.hidden-mobile{display:none!important}}.sidebar-panel{background-color:var(--ctp-mantle);flex-direction:column;flex-shrink:0;width:240px;display:flex;overflow:hidden}@media (width<=767px){.sidebar-panel{width:240px;transition:transform .2s;position:fixed;top:0;bottom:0;left:0;transform:translate(-100%)}.sidebar-panel[data-open=true]{transform:translate(0)}}@property --tw-rotate-x{syntax:"*";inherits:false}@property --tw-rotate-y{syntax:"*";inherits:false}@property --tw-rotate-z{syntax:"*";inherits:false}@property --tw-skew-x{syntax:"*";inherits:false}@property --tw-skew-y{syntax:"*";inherits:false}@property --tw-border-style{syntax:"*";inherits:false;initial-value:solid}@property --tw-font-weight{syntax:"*";inherits:false}@property --tw-tracking{syntax:"*";inherits:false}@property --tw-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-shadow-color{syntax:"*";inherits:false}@property --tw-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-inset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-shadow-color{syntax:"*";inherits:false}@property --tw-inset-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-ring-color{syntax:"*";inherits:false}@property --tw-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-ring-color{syntax:"*";inherits:false}@property --tw-inset-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-ring-inset{syntax:"*";inherits:false}@property --tw-ring-offset-width{syntax:"<length>";inherits:false;initial-value:0}@property --tw-ring-offset-color{syntax:"*";inherits:false;initial-value:#fff}@property --tw-ring-offset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-outline-style{syntax:"*";inherits:false;initial-value:solid}@property --tw-blur{syntax:"*";inherits:false}@property --tw-brightness{syntax:"*";inherits:false}@property --tw-contrast{syntax:"*";inherits:false}@property --tw-grayscale{syntax:"*";inherits:false}@property --tw-hue-rotate{syntax:"*";inherits:false}@property --tw-invert{syntax:"*";inherits:false}@property --tw-opacity{syntax:"*";inherits:false}@property --tw-saturate{syntax:"*";inherits:false}@property --tw-sepia{syntax:"*";inherits:false}@property --tw-drop-shadow{syntax:"*";inherits:false}@property --tw-drop-shadow-color{syntax:"*";inherits:false}@property --tw-drop-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-drop-shadow-size{syntax:"*";inherits:false}@property --tw-ease{syntax:"*";inherits:false}