open-research 0.1.2 → 0.1.4

package/dist/cli.js

@@ -1,8 +1,14 @@
 #!/usr/bin/env node
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
 
 // src/cli.ts
 import React4 from "react";
-import path18 from "path";
+import path19 from "path";
 import { Command } from "commander";
 import { render } from "ink";
 
@@ -848,7 +854,7 @@ async function ensureOpenResearchConfig(options) {
 }
 
 // src/tui/app.tsx
-import path17 from "path";
+import path18 from "path";
 import {
   startTransition,
   useDeferredValue,
@@ -1773,11 +1779,17 @@ function createOpenAIAuthProvider(credentials, onTokenRefresh, onValidationChang
         } else if (event.type === "response.completed") {
           const resp = event.data.response;
           if (resp?.usage) {
-            const usage = resp.usage;
+            const u = resp.usage;
+            const inputDetails = u.input_tokens_details;
+            const outputDetails = u.output_tokens_details;
+            const inputTokens = u.input_tokens ?? 0;
+            const outputTokens = u.output_tokens ?? 0;
             usageData = {
-              promptTokens: usage.input_tokens ?? 0,
-              completionTokens: usage.output_tokens ?? 0,
-              totalTokens: (usage.input_tokens ?? 0) + (usage.output_tokens ?? 0)
+              promptTokens: inputTokens,
+              completionTokens: outputTokens,
+              totalTokens: u.total_tokens ?? inputTokens + outputTokens,
+              cachedTokens: inputDetails?.cached_tokens ?? 0,
+              reasoningTokens: outputDetails?.reasoning_tokens ?? 0
             };
           }
           if (resp?.model) {
@@ -1889,11 +1901,17 @@ function createOpenAIAuthProvider(credentials, onTokenRefresh, onValidationChang
           case "response.completed": {
             const resp = event.data.response;
             if (resp?.usage) {
-              const responseUsage = resp.usage;
+              const u = resp.usage;
+              const inputDetails = u.input_tokens_details;
+              const outputDetails = u.output_tokens_details;
+              const inputTokens = u.input_tokens ?? 0;
+              const outputTokens = u.output_tokens ?? 0;
               usage = {
-                promptTokens: responseUsage.input_tokens ?? 0,
-                completionTokens: responseUsage.output_tokens ?? 0,
-                totalTokens: (responseUsage.input_tokens ?? 0) + (responseUsage.output_tokens ?? 0)
+                promptTokens: inputTokens,
+                completionTokens: outputTokens,
+                totalTokens: u.total_tokens ?? inputTokens + outputTokens,
+                cachedTokens: inputDetails?.cached_tokens ?? 0,
+                reasoningTokens: outputDetails?.reasoning_tokens ?? 0
               };
             }
             break;
@@ -4501,35 +4519,65 @@ var MODEL_CONTEXT_WINDOWS = {
   "o4-mini": 2e5
 };
 var DEFAULT_CONTEXT_WINDOW = 128e3;
-var COMPACT_THRESHOLD_PERCENT = 0.9;
+var AUTO_COMPACT_TOKEN_LIMIT = 25e4;
 function getContextWindow(model) {
   return MODEL_CONTEXT_WINDOWS[model] ?? DEFAULT_CONTEXT_WINDOW;
 }
 function getCompactThreshold(model) {
-  return Math.floor(getContextWindow(model) * COMPACT_THRESHOLD_PERCENT);
+  const window = getContextWindow(model);
+  return window > AUTO_COMPACT_TOKEN_LIMIT ? AUTO_COMPACT_TOKEN_LIMIT : Math.floor(window * 0.8);
+}
+function emptyBreakdown() {
+  return { input: 0, output: 0, reasoning: 0, cache: { read: 0, write: 0 }, total: 0 };
 }
 function createSessionUsage() {
   return {
+    cumulative: emptyBreakdown(),
+    lastTurn: emptyBreakdown(),
+    estimatedCurrentTokens: 0,
+    compactionCount: 0,
     inputTokens: 0,
     outputTokens: 0,
     totalTokens: 0,
-    lastTurnTokens: 0,
-    estimatedCurrentTokens: 0,
-    compactionCount: 0
+    lastTurnTokens: 0
   };
 }
 function updateUsageFromApi(usage, apiUsage) {
-  usage.inputTokens += apiUsage.promptTokens;
-  usage.outputTokens += apiUsage.completionTokens;
-  usage.totalTokens += apiUsage.totalTokens;
+  const cached = apiUsage.cachedTokens ?? 0;
+  const reasoning = apiUsage.reasoningTokens ?? 0;
+  const adjustedInput = Math.max(0, apiUsage.promptTokens - cached);
+  const adjustedOutput = Math.max(0, apiUsage.completionTokens - reasoning);
+  usage.cumulative.input += adjustedInput;
+  usage.cumulative.output += adjustedOutput;
+  usage.cumulative.reasoning += reasoning;
+  usage.cumulative.cache.read += cached;
+  usage.cumulative.total += apiUsage.totalTokens;
+  usage.lastTurn = {
+    input: adjustedInput,
+    output: adjustedOutput,
+    reasoning,
+    cache: { read: cached, write: 0 },
+    total: apiUsage.totalTokens
+  };
+  usage.inputTokens = usage.cumulative.input;
+  usage.outputTokens = usage.cumulative.output;
+  usage.totalTokens = usage.cumulative.total;
   usage.lastTurnTokens = apiUsage.totalTokens;
 }
 var PRUNE_PROTECT_TOKENS = 4e4;
 var PRUNE_MIN_SAVINGS = 2e4;
+var PRUNE_SKIP_RECENT_USER_TURNS = 2;
 function pruneToolOutputs(messages) {
+  const userIndices = [];
+  for (let i = messages.length - 1; i >= 0; i--) {
+    if (messages[i].role === "user") userIndices.push(i);
+  }
+  const protectBoundary = userIndices.length >= PRUNE_SKIP_RECENT_USER_TURNS ? userIndices[PRUNE_SKIP_RECENT_USER_TURNS - 1] : 0;
   const toolIndices = [];
   for (let i = 0; i < messages.length; i++) {
-    if (messages[i].role === "tool") toolIndices.push(i);
+    if (messages[i].role === "tool" && i < protectBoundary) {
+      toolIndices.push(i);
+    }
   }
   if (toolIndices.length === 0) return { messages, savedTokens: 0 };
   let protectedTokens = 0;
@@ -4549,44 +4597,105 @@ function pruneToolOutputs(messages) {
     const idx = toolIndices[i];
     const msg = result[idx];
     const oldTokens = estimateMessageTokens(msg);
-    const pruned = "[output pruned \u2014 use read_file to re-read if needed]";
-    savedTokens += oldTokens - estimateTokens(pruned);
-    result[idx] = { ...msg, content: pruned };
+    const stub = "[output pruned \u2014 use read_file to re-read if needed]";
+    savedTokens += oldTokens - estimateTokens(stub);
+    result[idx] = { ...msg, content: stub };
   }
   if (savedTokens < PRUNE_MIN_SAVINGS) {
     return { messages, savedTokens: 0 };
   }
   return { messages: result, savedTokens };
 }
-async function compactConversation(messages, provider, model, signal) {
+var COMPACTION_SYSTEM_PROMPT = `You are a conversation summarizer for a research agent. Your job is to create a handoff summary that another agent instance can use to seamlessly continue the work.
+
+Do not respond to any questions in the conversation. Only output the summary.
+Respond in the same language the user used.`;
+var COMPACTION_USER_TEMPLATE = `Provide a detailed summary of our conversation above for handoff to another agent that will continue the work.
+
+Stick to this template:
+
+## Goal
+[What is the user trying to accomplish? Be specific.]
+
+## Instructions
+- [Important instructions or preferences the user gave]
+- [Research methodology constraints or requirements]
+- [If there is a research charter or plan, summarize its key points]
+
+## Discoveries
+- [Key findings from paper searches, data analysis, or experiments]
+- [Important facts, numbers, or evidence discovered]
+- [Any surprising or contradicting results]
+
+## Accomplished
+- [What work has been completed]
+- [What is currently in progress]
+- [What remains to be done]
+
+## Relevant Files
+[List workspace files that were read, created, or modified. Include what each contains.]
+- path/to/file.md \u2014 description of contents
+- experiments/script.py \u2014 what it does and its results
+
+## Active Context
+- [Current research question or hypothesis being investigated]
+- [Which skills are active]
+- [Any pending user decisions or questions]
+
+## Next Steps
+1. [Most immediate next action]
+2. [Following action]
+3. [And so on]
+
+{CUSTOM_INSTRUCTIONS}`;
+async function compactConversation(messages, provider, model, customInstructions, signal) {
   const systemMsg = messages.find((m) => m.role === "system");
   const conversationMsgs = messages.filter((m) => m.role !== "system");
   const conversationText = conversationMsgs.map((m) => {
     const role = m.role === "assistant" ? "Agent" : m.role === "user" ? "User" : "Tool";
-    const content = typeof m.content === "string" ? m.content : m.content ? JSON.stringify(m.content) : "[tool calls]";
-    return `[${role}]: ${content?.slice(0, 2e3)}`;
+    let content;
+    if (typeof m.content === "string") {
+      content = m.content.length > 3e3 ? m.content.slice(0, 3e3) + "\n[... truncated]" : m.content;
+    } else if (m.content) {
+      content = JSON.stringify(m.content).slice(0, 1e3);
+    } else if (m.tool_calls?.length) {
+      content = m.tool_calls.map((tc) => `[tool: ${tc.function.name}]`).join(", ");
+    } else {
+      content = "[empty]";
+    }
+    return `[${role}]: ${content}`;
   }).join("\n\n");
+  const customBlock = customInstructions ? `
+
+Additional instructions: ${customInstructions}` : "";
+  const userPrompt = COMPACTION_USER_TEMPLATE.replace("{CUSTOM_INSTRUCTIONS}", customBlock);
+  const compactionModel = model.includes("5.4") ? "gpt-5.4-mini" : model;
   const summaryResponse = await provider.callLLM({
     messages: [
-      {
-        role: "system",
-        content: "You are performing a CONTEXT COMPACTION. Summarize the conversation into a concise handoff document. Include:\n1. **Goal**: What the user is trying to accomplish\n2. **Key discoveries**: Important findings, file paths, data points\n3. **Work completed**: What has been done so far\n4. **Next steps**: What should happen next\n5. **Active files**: Key file paths and their contents summary\n\nBe concise but preserve all actionable information. This summary will replace the full conversation history."
-      },
+      { role: "system", content: COMPACTION_SYSTEM_PROMPT },
       {
         role: "user",
-        content: `Summarize this conversation:
+        content: `Here is the conversation to summarize:
 
-${conversationText.slice(0, 1e5)}`
+${conversationText.slice(0, 12e4)}
+
+---
+
+${userPrompt}`
       }
     ],
-    model,
+    model: compactionModel,
     maxTokens: 4096
   });
   const compacted = [];
   if (systemMsg) compacted.push(systemMsg);
   compacted.push({
     role: "user",
-    content: "[Context compacted \u2014 previous conversation summarized below]\n\n" + summaryResponse.content
+    content: "What have we accomplished so far in this research session?"
+  });
+  compacted.push({
+    role: "assistant",
+    content: summaryResponse.content
   });
   return compacted;
 }
@@ -4604,7 +4713,17 @@ async function maybeCompact(messages, model, provider, usage, signal) {
     usage.compactionCount++;
     return { messages: pruned, didCompact: true };
   }
-  const compacted = await compactConversation(pruned, provider, model, signal);
+  const compacted = await compactConversation(pruned, provider, model, void 0, signal);
+  usage.estimatedCurrentTokens = estimateConversationTokens(compacted);
+  usage.compactionCount++;
+  return { messages: compacted, didCompact: true };
+}
+async function manualCompact(messages, model, provider, usage, customInstructions, signal) {
+  if (messages.length <= 2) {
+    return { messages, didCompact: false };
+  }
+  const { messages: pruned } = pruneToolOutputs(messages);
+  const compacted = await compactConversation(pruned, provider, model, customInstructions, signal);
   usage.estimatedCurrentTokens = estimateConversationTokens(compacted);
   usage.compactionCount++;
   return { messages: compacted, didCompact: true };
@@ -5294,6 +5413,324 @@ async function checkForUpdate() {
   }
 }
 
+// src/lib/preview/server.ts
+import http2 from "http";
+import fs18 from "fs";
+import path17 from "path";
+
+// src/lib/preview/latex-to-html.ts
+function latexToHtml(latex) {
+  let body = latex;
+  const docMatch = body.match(/\\begin\{document\}([\s\S]*?)\\end\{document\}/);
+  if (docMatch) body = docMatch[1];
+  const titleMatch = latex.match(/\\title\{([^}]*)\}/);
+  const authorMatch = latex.match(/\\author\{([^}]*)\}/);
+  const dateMatch = latex.match(/\\date\{([^}]*)\}/);
+  const abstractMatch = body.match(/\\begin\{abstract\}([\s\S]*?)\\end\{abstract\}/);
+  body = body.replace(/\\maketitle/, "");
+  body = body.replace(/\\begin\{abstract\}[\s\S]*?\\end\{abstract\}/, "");
+  body = body.replace(/\\section\*?\{([^}]*)\}/g, '<h2 class="section">$1</h2>');
+  body = body.replace(/\\subsection\*?\{([^}]*)\}/g, '<h3 class="subsection">$1</h3>');
+  body = body.replace(/\\subsubsection\*?\{([^}]*)\}/g, '<h4 class="subsubsection">$1</h4>');
+  body = body.replace(/\\paragraph\{([^}]*)\}/g, '<h5 class="paragraph">$1</h5>');
+  body = body.replace(/\\textbf\{([^}]*)\}/g, "<strong>$1</strong>");
+  body = body.replace(/\\textit\{([^}]*)\}/g, "<em>$1</em>");
+  body = body.replace(/\\texttt\{([^}]*)\}/g, "<code>$1</code>");
+  body = body.replace(/\\emph\{([^}]*)\}/g, "<em>$1</em>");
+  body = body.replace(/\\underline\{([^}]*)\}/g, "<u>$1</u>");
+  body = body.replace(/\\cite\{([^}]*)\}/g, '<span class="citation">[$1]</span>');
+  body = body.replace(/\\citep\{([^}]*)\}/g, '<span class="citation">($1)</span>');
+  body = body.replace(/\\citet\{([^}]*)\}/g, '<span class="citation">$1</span>');
+  body = body.replace(/\\ref\{([^}]*)\}/g, '<span class="ref">[ref:$1]</span>');
+  body = body.replace(/\\label\{([^}]*)\}/g, "");
+  body = body.replace(/\\\[([\s\S]*?)\\\]/g, '<div class="math-display">\\[$1\\]</div>');
+  body = body.replace(/\$\$([\s\S]*?)\$\$/g, '<div class="math-display">\\[$1\\]</div>');
+  body = body.replace(
+    /\\begin\{equation\*?\}([\s\S]*?)\\end\{equation\*?\}/g,
+    '<div class="math-display">\\[$1\\]</div>'
+  );
+  body = body.replace(
+    /\\begin\{align\*?\}([\s\S]*?)\\end\{align\*?\}/g,
+    '<div class="math-display">\\[$1\\]</div>'
+  );
+  body = body.replace(/(?<!\$)\$(?!\$)([^$]+?)\$(?!\$)/g, '<span class="math-inline">\\($1\\)</span>');
+  body = body.replace(/\\begin\{itemize\}/g, "<ul>");
+  body = body.replace(/\\end\{itemize\}/g, "</ul>");
+  body = body.replace(/\\begin\{enumerate\}/g, "<ol>");
+  body = body.replace(/\\end\{enumerate\}/g, "</ol>");
+  body = body.replace(/\\item\s*/g, "<li>");
+  body = body.replace(
+    /\\begin\{quote\}([\s\S]*?)\\end\{quote\}/g,
+    "<blockquote>$1</blockquote>"
+  );
+  body = body.replace(
+    /\\begin\{verbatim\}([\s\S]*?)\\end\{verbatim\}/g,
+    "<pre><code>$1</code></pre>"
+  );
+  body = body.replace(
+    /\\begin\{figure\}[\s\S]*?\\caption\{([^}]*)\}[\s\S]*?\\end\{figure\}/g,
+    '<figure class="figure-placeholder"><figcaption>$1</figcaption></figure>'
+  );
+  body = body.replace(
+    /\\begin\{table\}[\s\S]*?\\caption\{([^}]*)\}[\s\S]*?\\end\{table\}/g,
+    '<figure class="table-placeholder"><figcaption>Table: $1</figcaption></figure>'
+  );
+  body = body.replace(/\\footnote\{([^}]*)\}/g, '<sup class="footnote" title="$1">[*]</sup>');
+  body = body.replace(/\\bibliography\{[^}]*\}/g, "");
+  body = body.replace(/\\bibliographystyle\{[^}]*\}/g, "");
+  body = body.replace(/\\usepackage\{[^}]*\}/g, "");
+  body = body.replace(/\\documentclass[^{]*\{[^}]*\}/g, "");
+  body = body.replace(/\\begin\{document\}/g, "");
+  body = body.replace(/\\end\{document\}/g, "");
+  body = body.replace(/\\newcommand[^{]*\{[^}]*\}\{[^}]*\}/g, "");
+  body = body.replace(/\\\\/g, "<br>");
+  body = body.replace(/\\newline/g, "<br>");
+  body = body.replace(/\\noindent\s*/g, "");
+  body = body.replace(/\\vspace\{[^}]*\}/g, "");
+  body = body.replace(/\\hspace\{[^}]*\}/g, "");
+  body = body.replace(/\n\s*\n/g, "</p><p>");
+  body = `<p>${body}</p>`;
+  body = body.replace(/<p>\s*<\/p>/g, "");
+  body = body.replace(/<p>\s*<(h[2-5])/g, "<$1");
+  body = body.replace(/<\/(h[2-5])>\s*<\/p>/g, "</$1>");
+  const titleHtml = titleMatch ? `<h1 class="title">${titleMatch[1]}</h1>` : "";
+  const authorHtml = authorMatch ? `<p class="author">${authorMatch[1]}</p>` : "";
+  const dateHtml = dateMatch ? `<p class="date">${dateMatch[1]}</p>` : "";
+  const abstractHtml = abstractMatch ? `<div class="abstract"><h3>Abstract</h3><p>${abstractMatch[1].trim()}</p></div>` : "";
+  return `${titleHtml}${authorHtml}${dateHtml}${abstractHtml}${body}`;
+}
+
+// src/lib/preview/server.ts
+var HTML_TEMPLATE = `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Open Research \u2014 LaTeX Preview</title>
+  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.16.11/dist/katex.min.css">
+  <script defer src="https://cdn.jsdelivr.net/npm/katex@0.16.11/dist/katex.min.js"></script>
+  <script defer src="https://cdn.jsdelivr.net/npm/katex@0.16.11/dist/contrib/auto-render.min.js"
+    onload="renderMathInElement(document.body, {
+      delimiters: [
+        {left: '\\\\[', right: '\\\\]', display: true},
+        {left: '\\\\(', right: '\\\\)', display: false}
+      ],
+      throwOnError: false
+    });">
+  </script>
+  <style>
+    :root {
+      --bg: #1a1a2e;
+      --surface: #16213e;
+      --text: #e0e0e0;
+      --text-dim: #8892b0;
+      --accent: #64ffda;
+      --heading: #ccd6f6;
+      --citation: #64ffda;
+      --border: #233554;
+    }
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body {
+      font-family: 'Charter', 'Georgia', 'Times New Roman', serif;
+      background: var(--bg);
+      color: var(--text);
+      line-height: 1.8;
+      max-width: 780px;
+      margin: 0 auto;
+      padding: 3rem 2rem;
+    }
+    h1.title {
+      font-size: 2rem;
+      color: var(--heading);
+      text-align: center;
+      margin-bottom: 0.5rem;
+      line-height: 1.3;
+    }
+    .author {
+      text-align: center;
+      color: var(--text-dim);
+      font-style: italic;
+      margin-bottom: 0.3rem;
+    }
+    .date {
+      text-align: center;
+      color: var(--text-dim);
+      margin-bottom: 2rem;
+    }
+    .abstract {
+      background: var(--surface);
+      border-left: 3px solid var(--accent);
+      padding: 1.2rem 1.5rem;
+      margin: 2rem 0;
+      border-radius: 0 4px 4px 0;
+    }
+    .abstract h3 {
+      color: var(--accent);
+      font-size: 0.9rem;
+      text-transform: uppercase;
+      letter-spacing: 0.1em;
+      margin-bottom: 0.5rem;
+    }
+    h2.section {
+      font-size: 1.4rem;
+      color: var(--heading);
+      margin: 2.5rem 0 1rem;
+      padding-bottom: 0.3rem;
+      border-bottom: 1px solid var(--border);
+    }
+    h3.subsection {
+      font-size: 1.15rem;
+      color: var(--heading);
+      margin: 1.8rem 0 0.8rem;
+    }
+    h4.subsubsection {
+      font-size: 1rem;
+      color: var(--text-dim);
+      margin: 1.2rem 0 0.5rem;
+    }
+    p { margin: 0.8rem 0; }
+    strong { color: var(--heading); }
+    code {
+      background: var(--surface);
+      padding: 0.15rem 0.4rem;
+      border-radius: 3px;
+      font-size: 0.9em;
+      font-family: 'JetBrains Mono', 'Fira Code', monospace;
+    }
+    pre {
+      background: var(--surface);
+      padding: 1rem;
+      border-radius: 4px;
+      overflow-x: auto;
+      margin: 1rem 0;
+    }
+    pre code { background: none; padding: 0; }
+    blockquote {
+      border-left: 3px solid var(--border);
+      padding-left: 1rem;
+      color: var(--text-dim);
+      font-style: italic;
+      margin: 1rem 0;
+    }
+    ul, ol { padding-left: 1.5rem; margin: 0.8rem 0; }
+    li { margin: 0.3rem 0; }
+    .citation {
+      color: var(--citation);
+      font-weight: 500;
+      cursor: help;
+    }
+    .ref { color: var(--accent); font-style: italic; }
+    .footnote { color: var(--accent); cursor: help; }
+    .math-display {
+      margin: 1.2rem 0;
+      overflow-x: auto;
+      text-align: center;
+    }
+    .figure-placeholder, .table-placeholder {
+      background: var(--surface);
+      border: 1px dashed var(--border);
+      padding: 2rem;
+      margin: 1.5rem 0;
+      text-align: center;
+      border-radius: 4px;
+    }
+    .figure-placeholder::before { content: '[Figure placeholder]'; display: block; color: var(--text-dim); margin-bottom: 0.5rem; }
+    .table-placeholder::before { content: '[Table placeholder]'; display: block; color: var(--text-dim); margin-bottom: 0.5rem; }
+    figcaption { font-style: italic; color: var(--text-dim); font-size: 0.9rem; }
+
+    /* Live reload indicator */
+    .live-badge {
+      position: fixed;
+      top: 1rem;
+      right: 1rem;
+      background: #0d7337;
+      color: white;
+      padding: 0.3rem 0.8rem;
+      border-radius: 20px;
+      font-size: 0.75rem;
+      font-family: sans-serif;
+      opacity: 0.8;
+    }
+    .live-badge.disconnected { background: #7d3030; }
+  </style>
+</head>
+<body>
+  <div class="live-badge" id="status">LIVE</div>
+  <div id="content">
+    {{CONTENT}}
+  </div>
+  <script>
+    // Auto-reload via polling (simple, no WebSocket dependency)
+    let lastHash = "";
+    async function checkForUpdates() {
+      try {
+        const res = await fetch("/__hash");
+        const hash = await res.text();
+        if (lastHash && hash !== lastHash) {
+          location.reload();
+        }
+        lastHash = hash;
+        document.getElementById("status").textContent = "LIVE";
+        document.getElementById("status").className = "live-badge";
+      } catch {
+        document.getElementById("status").textContent = "DISCONNECTED";
+        document.getElementById("status").className = "live-badge disconnected";
+      }
+    }
+    setInterval(checkForUpdates, 1000);
+    checkForUpdates();
+  </script>
+</body>
+</html>`;
+function startPreviewServer(texPath) {
+  const resolved = path17.resolve(texPath);
+  let currentHash = "";
+  function getContentHash() {
+    try {
+      const content = fs18.readFileSync(resolved, "utf8");
+      return `${content.length}-${content.slice(0, 100)}-${content.slice(-100)}`;
+    } catch {
+      return "error";
+    }
+  }
+  function renderPage() {
+    try {
+      const latex = fs18.readFileSync(resolved, "utf8");
+      const htmlContent = latexToHtml(latex);
+      currentHash = getContentHash();
+      return HTML_TEMPLATE.replace("{{CONTENT}}", htmlContent);
+    } catch (err) {
+      return HTML_TEMPLATE.replace(
+        "{{CONTENT}}",
+        `<p style="color: #ff6b6b;">Error reading ${resolved}: ${err instanceof Error ? err.message : String(err)}</p>`
+      );
+    }
+  }
+  return new Promise((resolve) => {
+    const server = http2.createServer((req, res) => {
+      if (req.url === "/__hash") {
+        const hash = getContentHash();
+        res.writeHead(200, { "Content-Type": "text/plain", "Cache-Control": "no-cache" });
+        res.end(hash);
+        return;
+      }
+      res.writeHead(200, { "Content-Type": "text/html; charset=utf-8", "Cache-Control": "no-cache" });
+      res.end(renderPage());
+    });
+    server.listen(0, "127.0.0.1", () => {
+      const addr = server.address();
+      if (!addr || typeof addr === "string") return;
+      const port = addr.port;
+      const url = `http://127.0.0.1:${port}`;
+      resolve({
+        url,
+        port,
+        close: () => server.close()
+      });
+    });
+  });
+}
+
 // src/tui/commands.ts
 var SLASH_COMMANDS = [
   { name: "auth", aliases: ["/connect", "/login"], description: "Connect your OpenAI account via browser OAuth", category: "auth" },
@@ -5306,6 +5743,14 @@ var SLASH_COMMANDS = [
   { name: "clear", aliases: ["/new"], description: "Clear conversation and start fresh", category: "session" },
   { name: "help", aliases: ["/commands"], description: "Show available commands", category: "system" },
   { name: "config", aliases: ["/settings"], description: "View or change settings (e.g. /config theme dark)", category: "system" },
+  { name: "compact", aliases: [], description: "Manually compress conversation to save context (e.g. /compact keep the statistics)", category: "session" },
+  { name: "cost", aliases: ["/tokens", "/usage"], description: "Show token usage and cost for the current session", category: "system" },
+  { name: "context", aliases: [], description: "Show context window usage \u2014 how full it is", category: "system" },
+  { name: "btw", aliases: ["/aside"], description: "Ask a side question without affecting the main conversation", category: "session" },
+  { name: "export", aliases: [], description: "Export conversation as markdown to a file", category: "session" },
+  { name: "diff", aliases: ["/changes"], description: "Show files the agent has changed in this session", category: "workspace" },
+  { name: "doctor", aliases: [], description: "Diagnose auth, connectivity, and tool availability", category: "system" },
+  { name: "preview", aliases: [], description: "Live preview a LaTeX file in browser (e.g. /preview papers/draft.tex)", category: "workspace" },
   { name: "memory", aliases: ["/memories"], description: "View or clear stored memories about you", category: "system" },
   { name: "exit", aliases: ["/quit", "/q"], description: "Exit Open Research", category: "system" }
 ];
@@ -5843,6 +6288,7 @@ function App({
   const deferredPendingUpdates = useDeferredValue(pendingUpdates);
   const activityFrame = useAnimatedFrame(busy);
   const [agentQuestion, setAgentQuestion] = useState3(null);
+  const previewRef = useRef(null);
   const isHome = deferredMessages.length === 0 && !busy;
   const hasWorkspace = workspacePath !== null;
   const hasAuth = authStatus === "connected";
@@ -6132,6 +6578,201 @@ function App({
         addSystemMessage("  Esc  unfocus prompt");
         break;
       }
+      case "compact": {
+        if (history.length === 0) {
+          addSystemMessage("Nothing to compact \u2014 conversation is empty.");
+          break;
+        }
+        const customInstructions = args || void 0;
+        addSystemMessage(customInstructions ? `Compacting conversation (preserving: ${customInstructions})...` : "Compacting conversation...");
+        setBusy(true);
+        try {
+          const provider = await createProviderFromStoredAuth({ homeDir });
+          const msgs = [{ role: "system", content: "compaction" }, ...history.map((m) => m)];
+          const { messages: compacted, didCompact } = await manualCompact(
+            msgs,
+            config?.defaults.model ?? "gpt-5.4",
+            provider,
+            sessionTokens,
+            customInstructions
+          );
+          if (didCompact) {
+            const newHistory = compacted.filter((m) => m.role !== "system").map((m) => ({
+              role: m.role,
+              content: m.content
+            }));
+            setHistory(newHistory);
+            const k = (n) => n >= 1e3 ? `${(n / 1e3).toFixed(1)}k` : String(n);
+            setTokenDisplay(`${k(sessionTokens.estimatedCurrentTokens)} ctx \xB7 ${k(sessionTokens.totalTokens)} total`);
+            addSystemMessage(`Compacted. Context reduced to ~${Math.round(sessionTokens.estimatedCurrentTokens / 1e3)}k tokens.`);
+          } else {
+            addSystemMessage("Nothing to compact \u2014 conversation too short.");
+          }
+        } catch (err) {
+          addSystemMessage(`Compaction failed: ${err instanceof Error ? err.message : String(err)}`);
+        } finally {
+          setBusy(false);
+        }
+        break;
+      }
+      case "cost": {
+        const k = (n) => n >= 1e3 ? `${(n / 1e3).toFixed(1)}k` : String(n);
+        const c = sessionTokens.cumulative;
+        addSystemMessage("Session token usage:");
+        addSystemMessage(`  Input:     ${k(c.input)} tokens`);
+        addSystemMessage(`  Output:    ${k(c.output)} tokens`);
+        if (c.reasoning > 0) addSystemMessage(`  Reasoning: ${k(c.reasoning)} tokens`);
+        if (c.cache.read > 0) addSystemMessage(`  Cache read:  ${k(c.cache.read)} tokens`);
+        if (c.cache.write > 0) addSystemMessage(`  Cache write: ${k(c.cache.write)} tokens`);
+        addSystemMessage(`  Total:     ${k(c.total)} tokens`);
+        addSystemMessage(`  Context:   ~${k(sessionTokens.estimatedCurrentTokens)} (current window)`);
+        addSystemMessage(`  Compactions: ${sessionTokens.compactionCount}`);
+        break;
+      }
+      case "context": {
+        const model = config?.defaults.model ?? "gpt-5.4";
+        const window = getContextWindow(model);
+        const threshold = getCompactThreshold(model);
+        const current = sessionTokens.estimatedCurrentTokens || estimateConversationTokens(
+          history.map((m) => m)
+        );
+        const pct = Math.round(current / window * 100);
+        const barWidth = 40;
+        const filled = Math.round(pct / 100 * barWidth);
+        const bar = "\u2588".repeat(filled) + "\u2591".repeat(barWidth - filled);
+        const color = pct > 90 ? "red" : pct > 70 ? "yellow" : "green";
+        addSystemMessage(`Context window: ${model} (${(window / 1e3).toFixed(0)}k)`);
+        addSystemMessage(`  [${bar}] ${pct}%`);
+        addSystemMessage(`  ${(current / 1e3).toFixed(1)}k / ${(window / 1e3).toFixed(0)}k tokens used`);
+        addSystemMessage(`  Auto-compact at ${(threshold / 1e3).toFixed(0)}k (90%)`);
+        if (pct > 80) {
+          addSystemMessage("  Tip: run /compact to free space, or /clear to start fresh.");
+        }
+        break;
+      }
+      case "btw": {
+        if (!args) {
+          addSystemMessage("Usage: /btw <your side question>");
+          break;
+        }
+        if (!hasAuth) {
+          addSystemMessage("Not connected. Run /auth first.");
+          break;
+        }
+        addSystemMessage(`Side question: ${args}`);
+        setBusy(true);
+        try {
+          const provider = await createProviderFromStoredAuth({ homeDir });
+          const response = await provider.callLLM({
+            messages: [
+              { role: "system", content: "Answer this quick side question concisely. Do not reference any prior conversation." },
+              { role: "user", content: args }
+            ],
+            model: config?.defaults.model ?? "gpt-5.4",
+            maxTokens: 1e3
+          });
+          addSystemMessage(`Answer: ${response.content}`);
+        } catch (err) {
+          addSystemMessage(`Error: ${err instanceof Error ? err.message : String(err)}`);
+        } finally {
+          setBusy(false);
+        }
+        break;
+      }
+      case "export": {
+        const fileName = args?.trim() || "conversation-export.md";
+        const exportPath = __require("path").resolve(workspacePath ?? process.cwd(), fileName);
+        const lines = [`# Open Research \u2014 Conversation Export
+`];
+        for (const msg of messages) {
+          if (msg.role === "user") lines.push(`## You
+${msg.text}
+`);
+          else if (msg.role === "assistant") lines.push(`## Agent
+${msg.text}
+`);
+          else lines.push(`> ${msg.text}
+`);
+        }
+        try {
+          const fsModule = __require("fs/promises");
+          await fsModule.writeFile(exportPath, lines.join("\n"), "utf8");
+          addSystemMessage(`Exported ${messages.length} messages to ${exportPath}`);
+        } catch (err) {
+          addSystemMessage(`Export failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        break;
+      }
+      case "diff": {
+        if (!workspacePath) {
+          addSystemMessage("No workspace active.");
+          break;
+        }
+        try {
+          const { execSync } = __require("child_process");
+          const gitStatus = execSync("git status --short 2>/dev/null || echo 'Not a git repo'", {
+            cwd: workspacePath,
+            encoding: "utf8"
+          }).trim();
+          if (!gitStatus || gitStatus === "Not a git repo") {
+            addSystemMessage("No changes detected (not a git repo or no modifications).");
+          } else {
+            addSystemMessage("Changed files:");
+            for (const line of gitStatus.split("\n")) {
+              addSystemMessage(`  ${line}`);
+            }
+          }
+        } catch {
+          addSystemMessage("Could not check changes.");
+        }
+        break;
+      }
+      case "doctor": {
+        addSystemMessage("Running diagnostics...");
+        const authResult = await getAuthStatus({ homeDir });
+        addSystemMessage(`  Auth: ${authResult.connected ? "connected" : "not connected"} \u2014 ${authResult.message}`);
+        addSystemMessage(`  Workspace: ${workspacePath ? workspacePath : "none"}`);
+        addSystemMessage(`  Files: ${workspaceFiles.length}`);
+        addSystemMessage(`  Skills: ${skills2.length} loaded`);
+        const mems = await loadMemories({ homeDir });
+        addSystemMessage(`  Memories: ${mems.length} stored`);
+        addSystemMessage(`  Node: ${process.version}`);
+        const toolChecks = ["python3 --version", "pdflatex --version", "git --version"];
+        for (const cmd2 of toolChecks) {
+          try {
+            const { execSync } = __require("child_process");
+            const out = execSync(cmd2 + " 2>&1", { encoding: "utf8", timeout: 3e3 }).trim().split("\n")[0];
+            addSystemMessage(`  ${cmd2.split(" ")[0]}: ${out}`);
+          } catch {
+            addSystemMessage(`  ${cmd2.split(" ")[0]}: not found`);
+          }
+        }
+        addSystemMessage("Diagnostics complete.");
+        break;
+      }
+      case "preview": {
+        if (!args) {
+          addSystemMessage("Usage: /preview <path-to-tex-file>");
+          addSystemMessage("Example: /preview papers/draft.tex");
+          break;
+        }
+        const texPath = args.trim();
+        const resolvedTex = __require("path").isAbsolute(texPath) ? texPath : __require("path").resolve(workspacePath ?? process.cwd(), texPath);
+        try {
+          if (previewRef.current) {
+            previewRef.current.close();
+          }
+          const preview = await startPreviewServer(resolvedTex);
+          previewRef.current = preview;
+          addSystemMessage(`Live preview started at ${preview.url}`);
+          addSystemMessage("Auto-reloads when the file changes. Close with /preview stop");
+          const openModule = await import("open");
+          await openModule.default(preview.url);
+        } catch (err) {
+          addSystemMessage(`Preview failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        break;
+      }
       case "memory": {
         if (args === "clear") {
           await clearMemories({ homeDir });
@@ -6807,7 +7448,7 @@ function App({
         statusParts,
         statusColor,
         tokenDisplay,
-        workspaceName: hasWorkspace ? path17.basename(workspacePath) : process.cwd(),
+        workspaceName: hasWorkspace ? path18.basename(workspacePath) : process.cwd(),
         mode: agentMode,
         planningStatus: planningState.status
       }
@@ -6819,7 +7460,7 @@ function App({
 var program = new Command();
 program.name("open-research").description("Local-first research CLI powered by ChatGPT/Codex auth.").argument("[workspacePath]", "Optional workspace path to open").action(async (workspacePath) => {
   await ensureOpenResearchConfig();
-  const target = workspacePath ? path18.resolve(workspacePath) : process.cwd();
+  const target = workspacePath ? path19.resolve(workspacePath) : process.cwd();
   const project = await loadWorkspaceProject(target);
   const auth2 = await loadStoredAuth();
   render(
@@ -6841,7 +7482,7 @@ program.name("open-research").description("Local-first research CLI powered by C
 });
 program.command("init").argument("[workspacePath]").description("Initialize an Open Research workspace.").action(async (workspacePath) => {
   await ensureOpenResearchConfig();
-  const target = path18.resolve(workspacePath ?? process.cwd());
+  const target = path19.resolve(workspacePath ?? process.cwd());
   const project = await initWorkspace({ workspaceDir: target });
   console.log(`Initialized workspace: ${target}`);
   console.log(`Title: ${project.title}`);
@@ -6910,8 +7551,8 @@ skills.command("create").argument("[name]").description("Scaffold a new user ski
 });
 skills.command("edit").argument("<name>").description("Open a user skill in $EDITOR.").action(async (name) => {
   await ensureOpenResearchConfig();
-  const skillDir = path18.join(getOpenResearchSkillsDir(), name);
-  openInEditor(path18.join(skillDir, "SKILL.md"));
+  const skillDir = path19.join(getOpenResearchSkillsDir(), name);
+  openInEditor(path19.join(skillDir, "SKILL.md"));
   const validation = await validateSkillDirectory({ skillDir });
   if (!validation.ok) {
     console.error(validation.errors.join("\n"));
@@ -6922,9 +7563,9 @@ skills.command("edit").argument("<name>").description("Open a user skill in $EDI
 });
 skills.command("validate").argument("[nameOrPath]").description("Validate one user skill.").action(async (nameOrPath) => {
   await ensureOpenResearchConfig();
-  const skillDir = nameOrPath ? path18.isAbsolute(nameOrPath) ? nameOrPath : path18.join(getOpenResearchSkillsDir(), nameOrPath) : getOpenResearchSkillsDir();
+  const skillDir = nameOrPath ? path19.isAbsolute(nameOrPath) ? nameOrPath : path19.join(getOpenResearchSkillsDir(), nameOrPath) : getOpenResearchSkillsDir();
   const stat = await import("fs/promises").then(
-    (fs18) => fs18.stat(skillDir).catch(() => null)
+    (fs19) => fs19.stat(skillDir).catch(() => null)
   );
   if (!stat) {
     throw new Error(`Skill path not found: ${skillDir}`);