bit-office 1.2.0 → 1.2.1

package/dist/index.js

@@ -4391,7 +4391,8 @@ var ProjectListEvent = external_exports.object({
     endedAt: external_exports.number(),
     agentNames: external_exports.array(external_exports.string()),
     eventCount: external_exports.number(),
-    preview: ProjectPreviewSchema
+    preview: ProjectPreviewSchema,
+    tokenUsage: external_exports.object({ inputTokens: external_exports.number(), outputTokens: external_exports.number() }).optional()
   }))
 });
 var ProjectDataEvent = external_exports.object({
@@ -5335,14 +5336,14 @@ var CONFIG = {
 };
 
 // ../../packages/orchestrator/src/agent-session.ts
-import { spawn as spawn2, execSync as execSync3 } from "child_process";
-import path5 from "path";
-import { readFileSync as readFileSync4, writeFileSync as writeFileSync4, mkdirSync as mkdirSync4, existsSync as existsSync7 } from "fs";
+import { spawn, execSync as execSync2 } from "child_process";
+import path4 from "path";
+import { readFileSync as readFileSync4, writeFileSync as writeFileSync4, mkdirSync as mkdirSync4, existsSync as existsSync6 } from "fs";
 import { homedir as homedir4 } from "os";
 
 // ../../packages/orchestrator/src/preview-resolver.ts
-import { existsSync as existsSync6 } from "fs";
-import path4 from "path";
+import { existsSync as existsSync5 } from "fs";
+import path3 from "path";
 
 // ../../packages/orchestrator/src/resolve-path.ts
 import path2 from "path";
@@ -5362,157 +5363,19 @@ function resolveAgentPath(filePath, projectDir, workspace) {
   return void 0;
 }
 
-// ../../packages/orchestrator/src/preview-server.ts
-import { spawn, execSync as execSync2 } from "child_process";
-import { existsSync as existsSync5 } from "fs";
-import path3 from "path";
-var STATIC_PORT = 9100;
-var PreviewServer = class {
-  process = null;
-  currentDir = null;
-  isDetached = false;
-  /**
-   * Mode 1: Serve a static file directory on a fixed port.
-   * Returns the preview URL for the given file.
-   */
-  serve(filePath) {
-    if (!existsSync5(filePath)) {
-      console.log(`[PreviewServer] File not found: ${filePath}`);
-      return void 0;
-    }
-    const dir = path3.dirname(filePath);
-    const fileName = path3.basename(filePath);
-    this.stop();
-    try {
-      this.process = spawn("npx", ["serve", dir, "-l", String(STATIC_PORT), "--no-clipboard"], {
-        stdio: "ignore",
-        detached: true
-      });
-      this.process.unref();
-      this.currentDir = dir;
-      this.isDetached = true;
-      const url = `http://localhost:${STATIC_PORT}/${fileName}`;
-      console.log(`[PreviewServer] Serving ${dir} on port ${STATIC_PORT}`);
-      return url;
-    } catch (e) {
-      console.log(`[PreviewServer] Failed to start static serve: ${e}`);
-      return void 0;
-    }
-  }
-  /**
-   * Mode 2: Run a command (e.g. "python app.py") and use the specified port.
-   * The command is expected to start a server on the given port.
-   * Returns the preview URL.
-   */
-  runCommand(cmd, cwd, port) {
-    this.stop();
-    try {
-      this.process = spawn(cmd, {
-        shell: true,
-        cwd,
-        stdio: "ignore",
-        detached: true
-      });
-      this.process.unref();
-      this.currentDir = cwd;
-      this.isDetached = true;
-      const url = `http://localhost:${port}`;
-      console.log(`[PreviewServer] Running "${cmd}" in ${cwd}, preview at port ${port}`);
-      return url;
-    } catch (e) {
-      console.log(`[PreviewServer] Failed to run command: ${e}`);
-      return void 0;
-    }
-  }
-  /**
-   * Mode 3: Launch a desktop/CLI process (no web preview URL).
-   * Used for Pygame, Tkinter, Electron, terminal apps, etc.
-   * NOT detached — GUI apps need the login session to access WindowServer (macOS).
-   */
-  launchProcess(cmd, cwd) {
-    this.stop();
-    try {
-      this.process = spawn(cmd, {
-        shell: true,
-        cwd,
-        stdio: ["ignore", "ignore", "pipe"]
-      });
-      this.currentDir = cwd;
-      this.isDetached = false;
-      console.log(`[PreviewServer] Launched "${cmd}" in ${cwd} (pid=${this.process.pid})`);
-      this.process.stderr?.on("data", (data) => {
-        const msg = data.toString().trim();
-        if (msg) console.log(`[PreviewServer] stderr: ${msg.slice(0, 200)}`);
-      });
-      this.process.on("exit", (code) => {
-        console.log(`[PreviewServer] Process exited with code ${code}`);
-      });
-    } catch (e) {
-      console.log(`[PreviewServer] Failed to launch process: ${e}`);
-    }
-  }
-  /** Kill the current process and any orphan process on the static port */
-  stop() {
-    if (this.process) {
-      try {
-        if (this.isDetached && this.process.pid) {
-          process.kill(-this.process.pid, "SIGTERM");
-        } else {
-          this.process.kill("SIGTERM");
-        }
-      } catch {
-        try {
-          this.process.kill("SIGTERM");
-        } catch {
-        }
-      }
-      this.process = null;
-      this.currentDir = null;
-      this.isDetached = false;
-      console.log(`[PreviewServer] Stopped`);
-    }
-    this.killPortHolder(STATIC_PORT);
-  }
-  /** Kill whatever process is listening on the given port (best-effort). */
-  killPortHolder(port) {
-    try {
-      const out = execSync2(`lsof -ti :${port}`, { encoding: "utf-8", timeout: 3e3 }).trim();
-      if (out) {
-        for (const pid of out.split("\n")) {
-          const n = parseInt(pid, 10);
-          if (n > 0) {
-            try {
-              process.kill(n, "SIGKILL");
-            } catch {
-            }
-          }
-        }
-        console.log(`[PreviewServer] Killed orphan process(es) on port ${port}: ${out.replace(/\n/g, ", ")}`);
-      }
-    } catch {
-    }
-  }
-};
-var previewServer = new PreviewServer();
-
 // ../../packages/orchestrator/src/preview-resolver.ts
 var EMPTY = { previewUrl: void 0, previewPath: void 0 };
 function resolvePreview(input) {
   const { cwd, workspace } = input;
   if (input.previewCmd && input.previewPort) {
-    const url = previewServer.runCommand(input.previewCmd, cwd, input.previewPort);
-    if (url) return { previewUrl: url, previewPath: void 0 };
+    return EMPTY;
   }
   if (input.previewCmd && !input.previewPort) {
-    console.log(`[PreviewResolver] Desktop app ready (user can Launch): ${input.previewCmd}`);
     return EMPTY;
   }
   if (input.entryFile && /\.html?$/i.test(input.entryFile)) {
     const absPath = resolveAgentPath(input.entryFile, cwd, workspace);
-    if (absPath) {
-      const url = previewServer.serve(absPath);
-      if (url) return { previewUrl: url, previewPath: absPath };
-    }
+    if (absPath) return { previewUrl: void 0, previewPath: absPath };
   }
   if (input.stdout) {
     const match = input.stdout.match(/PREVIEW:\s*(https?:\/\/[^\s*)\]>]+)/i);
@@ -5524,28 +5387,19 @@ function resolvePreview(input) {
     const fileMatch = input.stdout.match(/(?:open\s+)?((?:\/[\w./_-]+|[\w./_-]+)\.html?)\b/i);
     if (fileMatch) {
       const absPath = resolveAgentPath(fileMatch[1], cwd, workspace);
-      if (absPath) {
-        const url = previewServer.serve(absPath);
-        if (url) return { previewUrl: url, previewPath: absPath };
-      }
+      if (absPath) return { previewUrl: void 0, previewPath: absPath };
     }
   }
   if (input.changedFiles) {
     for (const f of input.changedFiles) {
       if (!/\.html?$/i.test(f)) continue;
       const absPath = resolveAgentPath(f, cwd, workspace);
-      if (absPath) {
-        const url = previewServer.serve(absPath);
-        if (url) return { previewUrl: url, previewPath: absPath };
-      }
+      if (absPath) return { previewUrl: void 0, previewPath: absPath };
     }
   }
   for (const candidate of CONFIG.preview.buildOutputCandidates) {
-    const absPath = path4.join(cwd, candidate);
-    if (existsSync6(absPath)) {
-      const url = previewServer.serve(absPath);
-      if (url) return { previewUrl: url, previewPath: absPath };
-    }
+    const absPath = path3.join(cwd, candidate);
+    if (existsSync5(absPath)) return { previewUrl: void 0, previewPath: absPath };
   }
   return EMPTY;
 }
@@ -5611,10 +5465,10 @@ function extractFallbackSummary(raw, _hasFiles, _entryFile, _projectDir) {
 
 // ../../packages/orchestrator/src/agent-session.ts
 import { nanoid as nanoid3 } from "nanoid";
-var SESSION_FILE = path5.join(homedir4(), ".bit-office", "agent-sessions.json");
+var SESSION_FILE = path4.join(homedir4(), ".bit-office", "agent-sessions.json");
 function loadSessionMap() {
   try {
-    if (existsSync7(SESSION_FILE)) return JSON.parse(readFileSync4(SESSION_FILE, "utf-8"));
+    if (existsSync6(SESSION_FILE)) return JSON.parse(readFileSync4(SESSION_FILE, "utf-8"));
   } catch {
   }
   return {};
@@ -5623,8 +5477,8 @@ function clearSessionId(agentId) {
   saveSessionId(agentId, null);
 }
 function saveSessionId(agentId, sessionId) {
-  const dir = path5.dirname(SESSION_FILE);
-  if (!existsSync7(dir)) mkdirSync4(dir, { recursive: true });
+  const dir = path4.dirname(SESSION_FILE);
+  if (!existsSync6(dir)) mkdirSync4(dir, { recursive: true });
   const map = loadSessionMap();
   if (sessionId) {
     map[agentId] = sessionId;
@@ -5656,6 +5510,8 @@ var AgentSession = class {
   stderrBuffer = "";
   taskInputTokens = 0;
   taskOutputTokens = 0;
+  /** Dedup same-turn repeated usage in assistant messages */
+  lastUsageSignature = "";
   hasHistory;
   sessionId;
   taskQueue = [];
@@ -5761,6 +5617,7 @@ var AgentSession = class {
     this.stderrBuffer = "";
     this.taskInputTokens = 0;
     this.taskOutputTokens = 0;
+    this.lastUsageSignature = "";
     this.onEvent({
       type: "task:started",
       agentId: this.agentId,
@@ -5812,12 +5669,12 @@ var AgentSession = class {
         skipResume: isFirstExecute && this.hasHistory
       });
       try {
-        const whichPath = execSync3(`which ${this.backend.command}`, { env: cleanEnv, encoding: "utf-8", timeout: 3e3 }).trim();
+        const whichPath = execSync2(`which ${this.backend.command}`, { env: cleanEnv, encoding: "utf-8", timeout: 3e3 }).trim();
         console.log(`[Agent ${this.name}] Binary: ${whichPath}, CLAUDECODE=${cleanEnv.CLAUDECODE ?? "unset"}, ENTRYPOINT=${cleanEnv.CLAUDE_CODE_ENTRYPOINT ?? "unset"}`);
       } catch {
       }
       console.log(`[Agent ${this.name}] Spawning: ${this.backend.command} ${args.map((a) => a.length > 80 ? a.slice(0, 80) + "..." : a).join(" ")}`);
-      this.process = spawn2(this.backend.command, args, {
+      this.process = spawn(this.backend.command, args, {
         cwd,
         env: cleanEnv,
         stdio: ["ignore", "pipe", "pipe"],
@@ -5910,8 +5767,20 @@ var AgentSession = class {
               if (msg.type === "assistant" && msg.message?.content) {
                 if (msg.message.usage) {
                   const usage = msg.message.usage;
-                  if (typeof usage.input_tokens === "number") this.taskInputTokens += usage.input_tokens;
-                  if (typeof usage.output_tokens === "number") this.taskOutputTokens += usage.output_tokens;
+                  const turnIn = (usage.input_tokens ?? 0) + (usage.cache_creation_input_tokens ?? 0) + (usage.cache_read_input_tokens ?? 0);
+                  const turnOut = usage.output_tokens ?? 0;
+                  const sig = `${turnIn}:${turnOut}`;
+                  if (sig !== this.lastUsageSignature) {
+                    this.lastUsageSignature = sig;
+                    this.taskInputTokens += turnIn;
+                    this.taskOutputTokens += turnOut;
+                    this.onEvent({
+                      type: "token:update",
+                      agentId: this.agentId,
+                      inputTokens: this.taskInputTokens,
+                      outputTokens: this.taskOutputTokens
+                    });
+                  }
                 }
                 for (const block of msg.message.content) {
                   if (block.type === "text" && block.text) {
@@ -5922,12 +5791,27 @@ var AgentSession = class {
                     console.log(`[Agent ${this.name} thinking] ${block.thinking.slice(0, 120)}...`);
                   }
                 }
-              } else if (msg.type === "result" && msg.result) {
-                if (!this.stdoutBuffer) {
-                  this.stdoutBuffer = msg.result;
-                  handleTextLine(msg.result);
+              } else if (msg.type === "result") {
+                if (msg.usage) {
+                  const usage = msg.usage;
+                  const totalIn = (usage.input_tokens ?? 0) + (usage.cache_creation_input_tokens ?? 0) + (usage.cache_read_input_tokens ?? 0);
+                  const totalOut = usage.output_tokens ?? 0;
+                  this.taskInputTokens = totalIn;
+                  this.taskOutputTokens = totalOut;
+                  this.onEvent({
+                    type: "token:update",
+                    agentId: this.agentId,
+                    inputTokens: this.taskInputTokens,
+                    outputTokens: this.taskOutputTokens
+                  });
+                }
+                if (msg.result) {
+                  if (!this.stdoutBuffer) {
+                    this.stdoutBuffer = msg.result;
+                    handleTextLine(msg.result);
+                  }
+                  this._lastResultText = msg.result;
                 }
-                this._lastResultText = msg.result;
               }
               continue;
             } catch {
@@ -5948,11 +5832,18 @@ var AgentSession = class {
         }
       });
       this.process.on("close", (code) => {
+        const agentPid = this.process?.pid;
         this.process = null;
         if (this.taskTimeout) {
           clearTimeout(this.taskTimeout);
           this.taskTimeout = null;
         }
+        if (agentPid) {
+          try {
+            process.kill(-agentPid, "SIGTERM");
+          } catch {
+          }
+        }
         const remaining = jsonLineBuf.trim();
         if (remaining) {
           jsonLineBuf = "";
@@ -6078,7 +5969,7 @@ var AgentSession = class {
   detectPreview() {
     const result = this.extractResult();
     const baseCwd = this.currentCwd ?? this.workspace;
-    const cwd = result.projectDir ? path5.isAbsolute(result.projectDir) ? result.projectDir : path5.join(baseCwd, result.projectDir) : baseCwd;
+    const cwd = result.projectDir ? path4.isAbsolute(result.projectDir) ? result.projectDir : path4.join(baseCwd, result.projectDir) : baseCwd;
     return resolvePreview({
       entryFile: result.entryFile,
       previewCmd: result.previewCmd,
@@ -6293,7 +6184,7 @@ var AgentManager = class {
 
 // ../../packages/orchestrator/src/delegation.ts
 import { nanoid as nanoid4 } from "nanoid";
-import path6 from "path";
+import path5 from "path";
 var DelegationRouter = class {
   /** All per-task delegation metadata, keyed by taskId */
   tasks = /* @__PURE__ */ new Map();
@@ -6480,7 +6371,7 @@ var DelegationRouter = class {
           const dirPart = dirMatch[1].replace(/\/$/, "");
           const leaderSession = this.agentManager.get(fromAgentId);
           if (leaderSession) {
-            repoPath = path6.resolve(leaderSession.workspaceDir, dirPart);
+            repoPath = path5.resolve(leaderSession.workspaceDir, dirPart);
           }
         }
       }
@@ -6767,8 +6658,8 @@ ${resultLines2}`,
 };
 
 // ../../packages/orchestrator/src/prompt-templates.ts
-import { readFileSync as readFileSync5, writeFileSync as writeFileSync5, mkdirSync as mkdirSync5, existsSync as existsSync8 } from "fs";
-import path7 from "path";
+import { readFileSync as readFileSync5, writeFileSync as writeFileSync5, mkdirSync as mkdirSync5, existsSync as existsSync7 } from "fs";
+import path6 from "path";
 var PROMPT_DEFAULTS = {
   "leader-initial": `You are {{name}}, the Team Lead. {{personality}}
 You CANNOT write code, run commands, or use any tools. You can ONLY delegate.
@@ -6862,7 +6753,7 @@ Check WHO sent this result, then follow the matching branch:
 
 ENTRY_FILE: <from dev \u2014 e.g. index.html, dist/index.html. OMIT if dev didn't provide one>
 PREVIEW_CMD: <from dev \u2014 e.g. "python app.py". OMIT if dev didn't provide one. NEVER use "npm run dev" or "npm start"!>
-PREVIEW_PORT: <from dev \u2014 e.g. 5000, 3000. OMIT if dev didn't provide one>
+PREVIEW_PORT: <from dev \u2014 e.g. 5000. OMIT if dev didn't provide one>
 SUMMARY: <2-3 sentence description of what was built>
 
 RULES:
@@ -6873,95 +6764,65 @@ RULES:
 - Do NOT include PROJECT_DIR \u2014 the system manages project directories automatically.`,
   "worker-initial": `Your name is {{name}}, your role is {{role}}. {{personality}}
 
-CONVERGENCE RULES (follow strictly):
-- Do the MINIMUM needed to satisfy the task. Simple and working beats perfect and slow.
-- Only touch files directly required by this task. Do NOT refactor, clean up, or "improve" unrelated code.
-- If you are uncertain between two approaches, choose the simpler one and note it in SUMMARY.
-- Do NOT add features, error handling, or improvements that were not explicitly asked for.
-
-HARD LIMITS:
-- NEVER run "npm run dev", "npm start", "npx vite", "python -m http.server", or ANY command that starts a long-running server. These will hang forever and waste your budget. The system handles preview serving automatically.
-- Do NOT create backend servers, WebSocket servers, or any server-side code UNLESS the task explicitly requires one. Default to static HTML/CSS/JS.
-- You MAY install dependencies (npm install, pip install) and run ONE-SHOT build commands (npm run build, npx tsc). Never run watch/serve/dev commands.
+RULES:
+- Do the MINIMUM needed. Simple and working beats perfect.
+- NEVER run long-running commands (npm run dev, npm start, npx vite, live-server, python -m http.server). They hang forever and you will be killed. The system serves previews automatically.
+- Do NOT launch GUI apps (Pygame, Tkinter, Electron) or dev servers. You CANNOT see UI.
+- You MAY run one-shot commands: npm install, npm run build, npx tsc, syntax checks.
+- Default to static HTML/CSS/JS unless a backend is explicitly required.
 {{soloHint}}
 {{memory}}
-Start with one sentence describing your approach. Then do the work.
-
-You are responsible for the COMPLETE deliverable \u2014 not just source files. This means:
-1. Project setup: create all config files needed (package.json, tsconfig, build config, requirements.txt, etc.)
-2. All source code
-3. Build & verify: if the project has a build step, RUN IT and fix errors until it passes
-4. Report how to run/preview the result (see deliverable types below)
-
-VERIFICATION (MANDATORY before reporting STATUS: done):
-- If you created a package.json with a build script \u2192 run "npm run build" (ONE-SHOT), fix errors until it succeeds, confirm the output file exists. NEVER run "npm run dev" or "npm start" \u2014 these hang forever.
-- If your deliverable is an HTML file \u2192 confirm it exists and references valid scripts/styles
-- If your deliverable is a script (Python, Node, etc.) \u2192 run a syntax check (python -c "import ast; ast.parse(open('app.py').read())" or node --check app.js)
-- If NONE of the above apply \u2192 at minimum list the files and confirm the entry point exists
-- IMPORTANT: Do NOT launch GUI/desktop applications (Pygame, Tkinter, Electron, etc.) \u2014 they open windows that cannot be controlled. Do NOT start dev servers (vite, webpack-dev-server, live-server) \u2014 they never exit.
-- FINAL CHECK: confirm you can fill in at least ENTRY_FILE or PREVIEW_CMD (see deliverable types). If you cannot, your deliverable is incomplete \u2014 fix it before reporting.
-- Do NOT report STATUS: done unless verification passes. Fix problems yourself first.
-- STATUS: failed is ONLY for truly unsolvable problems (missing API keys, no network, system-level issues).
-
-===== DELIVERABLE TYPES =====
-ALWAYS prefer type A (static web) unless the task EXPLICITLY requires a server or desktop app.
-Games, interactive demos, visualizations, and web pages should ALL be static HTML.
 
-A) STATIC WEB (HTML/CSS/JS \u2014 no server needed) \u2014 DEFAULT CHOICE:
-   ENTRY_FILE: index.html  (the HTML file to open \u2014 e.g. index.html, dist/index.html, build/index.html)
-   This is the preferred approach. Put everything in a single HTML file or a small set of static files.
+OUTPUT STYLE:
+- While working, output a SHORT status line (\u22648 words) at each major step, prefixed with \u2192. Example: "\u2192 Setting up project" or "\u2192 Building game logic". No other prose or narration. Do NOT write "Let me...", "I'll now...", "Looking at..." \u2014 just do the work.
+- After all work is done, output ONLY the structured result block below.
 
-B) WEB SERVER \u2014 ONLY if the task explicitly requires a backend (database, API proxy, user auth, etc.):
-   PREVIEW_CMD: python app.py  (the command to start the server)
-   PREVIEW_PORT: 5000  (the port the server listens on \u2014 REQUIRED for web servers)
+DELIVERABLE:
+- You own the COMPLETE deliverable: project setup, all source code, build & verify.
+- STATUS: failed is ONLY for truly unsolvable problems (missing API keys, system issues).
 
-C) DESKTOP/CLI APP (Pygame, Tkinter, Electron, JavaFX, terminal tool, native GUI, etc.):
-   PREVIEW_CMD: python game.py  (the command to launch the app \u2014 NO PREVIEW_PORT needed)
+VERIFY BEFORE REPORTING DONE (mandatory):
+- If package.json has a build script \u2192 run "npm run build" (one-shot), fix errors until it passes.
+- If HTML deliverable \u2192 confirm the file exists and references valid scripts/styles.
+- If script (Python/Node) \u2192 run syntax check (node --check / python -c "import ast; ...").
+- FINAL CHECK: you MUST be able to fill in ENTRY_FILE or PREVIEW_CMD below. If not, your deliverable is incomplete \u2014 fix it first.
 
-OUTPUT:
+DELIVERABLE TYPES (prefer A):
+A) STATIC WEB \u2192 ENTRY_FILE: index.html
+B) WEB SERVER (only if backend needed) \u2192 PREVIEW_CMD + PREVIEW_PORT
+C) DESKTOP/CLI \u2192 PREVIEW_CMD only
 
+RESULT FORMAT:
 STATUS: done | failed
-FILES_CHANGED: (list all files created or modified, one per line)
-ENTRY_FILE: (type A only \u2014 path to the HTML file)
-PREVIEW_CMD: (types B and C ONLY \u2014 OMIT this field entirely for static web projects)
-PREVIEW_PORT: (type B only \u2014 the port the server listens on)
-SUMMARY: (one sentence: what you built + how to run/preview it)
-
-You MUST provide at least ENTRY_FILE or PREVIEW_CMD. For games and interactive projects, ENTRY_FILE is almost always correct.
+FILES_CHANGED: (one per line)
+ENTRY_FILE: (type A)
+PREVIEW_CMD: (types B/C only)
+PREVIEW_PORT: (type B only)
+SUMMARY: (one sentence)
 
 {{prompt}}`,
   "worker-reviewer-initial": `Your name is {{name}}, your role is {{role}}. {{personality}}
 
-CONVERGENCE RULES (follow strictly):
-- Do the MINIMUM needed to satisfy the task. Simple and working beats perfect and slow.
-- Only touch files directly required by this task. Do NOT refactor, clean up, or "improve" unrelated code.
-- If you are uncertain between two approaches, choose the simpler one and note it in SUMMARY.
-- Do NOT add features, error handling, or improvements that were not explicitly asked for.
-
-HARD LIMITS:
-- NEVER run "npm run dev", "npm start", "npx vite", or ANY long-running server command. These hang forever. Only use one-shot commands like "npm run build" or "node --check".
-- Do NOT launch GUI/desktop applications (Pygame, Tkinter, Electron, etc.) to test them \u2014 they open windows that cannot be controlled. Use syntax checks, import checks, and code reading only.
-
-Code Quality (must check):
-- Correctness: crashes, broken logic, missing files, syntax errors.
-- Verify the deliverable can actually run: check that entry point exists, dependencies are declared, build output is present. For GUI/desktop apps, verify via code review and syntax checks \u2014 do NOT run them.
-- VERIFY WITH TOOLS, not just the developer's summary. Run "ls" to confirm reported files exist. If ENTRY_FILE is claimed, check the file is there and references valid scripts/styles. Do not trust STATUS: done at face value.
-- Do NOT flag security issues in prototypes \u2014 this is a demo, not production code.
+RULES:
+- NEVER run servers, dev commands, or GUI apps. You CANNOT see UI.
+- ONLY use: code reading, "ls" to check files, "npm run build" (one-shot), syntax checks.
+- This is a prototype \u2014 do NOT nitpick style, naming, formatting, or security.
 
-Feature Completeness (must check):
-- Compare the deliverable against the key features listed in your task assignment.
-- Flag CORE features that are completely missing or non-functional as ISSUES.
-- Do NOT fail for polish, extras, or stretch goals \u2014 this is a prototype. Focus on whether the main functionality works.
+OUTPUT STYLE:
+- While reviewing, output a SHORT status line (\u22648 words) at each step, prefixed with \u2192. Example: "\u2192 Checking file structure" or "\u2192 Reading game logic". No other prose.
+- After review, output ONLY the verdict block below.
 
-Do NOT nitpick style, naming, formatting, or security hardening. This is a prototype, not production code.
-Focus ONLY on: does it run? Does it do what was asked?
+REVIEW CHECKLIST:
+1. VERIFY files exist with "ls" \u2014 do NOT trust the developer's summary at face value. Check ENTRY_FILE is real and references valid scripts/styles.
+2. READ the code to verify logic. Check for crashes, broken logic, missing files, syntax errors.
+3. Feature completeness: compare against key features in your task. Flag CORE features missing/broken as ISSUES. Ignore polish/extras.
 
 VERDICT: PASS | FAIL
-- PASS = code runs without crashes AND core features are implemented (even if rough)
-- FAIL = crashes/bugs that prevent usage OR core features are missing/broken
-ISSUES: (numbered list \u2014 bugs, security problems, or missing core features)
-SUGGESTIONS: (optional \u2014 minor non-blocking observations, keep brief)
-SUMMARY: (one sentence overall assessment)
+- PASS = runs without crashes AND core features implemented
+- FAIL = crashes/bugs prevent usage OR core features missing
+ISSUES: (numbered list)
+SUGGESTIONS: (optional, brief)
+SUMMARY: (one sentence)
 
 {{prompt}}`,
   "worker-continue": `{{prompt}}`,
@@ -7112,12 +6973,12 @@ var PromptEngine = class {
       console.log(`[Prompts] No promptsDir configured, using ${Object.keys(PROMPT_DEFAULTS).length} default templates`);
       return;
     }
-    if (!existsSync8(this.promptsDir)) {
+    if (!existsSync7(this.promptsDir)) {
       mkdirSync5(this.promptsDir, { recursive: true });
     }
     let written = 0;
     for (const [name, content] of Object.entries(PROMPT_DEFAULTS)) {
-      const filePath = path7.join(this.promptsDir, `${name}.md`);
+      const filePath = path6.join(this.promptsDir, `${name}.md`);
       writeFileSync5(filePath, content, "utf-8");
       written++;
     }
@@ -7133,8 +6994,8 @@ var PromptEngine = class {
     let defaulted = 0;
     if (this.promptsDir) {
       for (const name of Object.keys(PROMPT_DEFAULTS)) {
-        const filePath = path7.join(this.promptsDir, `${name}.md`);
-        if (existsSync8(filePath)) {
+        const filePath = path6.join(this.promptsDir, `${name}.md`);
+        if (existsSync7(filePath)) {
           try {
             merged[name] = readFileSync5(filePath, "utf-8");
             loaded++;
@@ -7397,7 +7258,7 @@ var PhaseMachine = class {
 };
 
 // ../../packages/orchestrator/src/result-finalizer.ts
-import path8 from "path";
+import path7 from "path";
 function finalizeTeamResult(ctx) {
   const { result, teamPreview, teamChangedFiles, projectDir, workspace } = ctx;
   if (teamChangedFiles.size > 0) {
@@ -7419,7 +7280,7 @@ function finalizeTeamResult(ctx) {
   }
   validateEntryFile(result, projectDir ?? workspace, workspace);
   autoConstructPreviewCmd(result);
-  if (!result.previewUrl) {
+  if (!result.previewUrl && !result.previewPath) {
     resolvePreviewUrlFromTeam(result, ctx);
   }
 }
@@ -7427,12 +7288,12 @@ function validateEntryFile(result, projectDir, workspace) {
   if (!result.entryFile) return;
   const resolved = resolveAgentPath(result.entryFile, projectDir, workspace);
   if (resolved) {
-    result.entryFile = path8.relative(projectDir, resolved);
+    result.entryFile = path7.relative(projectDir, resolved);
     return;
   }
   const allFiles = result.changedFiles ?? [];
-  const ext = path8.extname(result.entryFile).toLowerCase();
-  const candidate = allFiles.map((f) => path8.basename(f)).find((f) => path8.extname(f).toLowerCase() === ext);
+  const ext = path7.extname(result.entryFile).toLowerCase();
+  const candidate = allFiles.map((f) => path7.basename(f)).find((f) => path7.extname(f).toLowerCase() === ext);
   if (candidate) {
     console.log(`[ResultFinalizer] entryFile "${result.entryFile}" not found, using "${candidate}" from changedFiles`);
     result.entryFile = candidate;
@@ -7443,7 +7304,7 @@ function validateEntryFile(result, projectDir, workspace) {
 }
 function autoConstructPreviewCmd(result) {
   if (!result.entryFile || result.previewCmd || /\.html?$/i.test(result.entryFile)) return;
-  const ext = path8.extname(result.entryFile).toLowerCase();
+  const ext = path7.extname(result.entryFile).toLowerCase();
   const runner = CONFIG.preview.runners[ext];
   if (runner) {
     result.previewCmd = `${runner} ${result.entryFile}`;
@@ -7454,9 +7315,9 @@ function resolvePreviewUrlFromTeam(result, ctx) {
   const { projectDir, workspace } = ctx;
   const resolveDir = projectDir ?? workspace;
   const workerPreview = ctx.detectWorkerPreview();
-  if (workerPreview?.previewUrl) {
-    result.previewUrl = workerPreview.previewUrl;
-    result.previewPath = workerPreview.previewPath;
+  if (workerPreview?.previewUrl || workerPreview?.previewPath) {
+    if (workerPreview.previewUrl) result.previewUrl = workerPreview.previewUrl;
+    if (workerPreview.previewPath) result.previewPath = workerPreview.previewPath;
     return;
   }
   const allChangedFiles = result.changedFiles ?? [];
@@ -7468,19 +7329,17 @@ function resolvePreviewUrlFromTeam(result, ctx) {
     cwd: resolveDir,
     workspace
   });
-  if (preview.previewUrl) {
-    result.previewUrl = preview.previewUrl;
-    result.previewPath = preview.previewPath;
-  }
+  if (preview.previewUrl) result.previewUrl = preview.previewUrl;
+  if (preview.previewPath) result.previewPath = preview.previewPath;
 }
 
 // ../../packages/orchestrator/src/worktree.ts
-import { execSync as execSync4 } from "child_process";
-import path9 from "path";
+import { execSync as execSync3 } from "child_process";
+import path8 from "path";
 var TIMEOUT = 5e3;
 function isGitRepo(cwd) {
   try {
-    execSync4("git rev-parse --is-inside-work-tree", { cwd, stdio: "ignore", timeout: TIMEOUT });
+    execSync3("git rev-parse --is-inside-work-tree", { cwd, stdio: "ignore", timeout: TIMEOUT });
     return true;
   } catch {
     return false;
@@ -7488,12 +7347,12 @@ function isGitRepo(cwd) {
 }
 function createWorktree(workspace, agentId, taskId, agentName) {
   if (!isGitRepo(workspace)) return null;
-  const worktreeDir = path9.join(workspace, ".worktrees");
+  const worktreeDir = path8.join(workspace, ".worktrees");
   const worktreeName = `${agentId}-${taskId}`;
-  const worktreePath = path9.join(worktreeDir, worktreeName);
+  const worktreePath = path8.join(worktreeDir, worktreeName);
   const branch = `agent/${agentName.toLowerCase().replace(/\s+/g, "-")}/${taskId}`;
   try {
-    execSync4(`git worktree add "${worktreePath}" -b "${branch}"`, {
+    execSync3(`git worktree add "${worktreePath}" -b "${branch}"`, {
       cwd: workspace,
       stdio: "pipe",
       timeout: TIMEOUT
@@ -7506,61 +7365,61 @@ function createWorktree(workspace, agentId, taskId, agentName) {
 }
 function mergeWorktree(workspace, worktreePath, branch) {
   try {
-    execSync4(`git merge --no-ff "${branch}"`, {
+    execSync3(`git merge --no-ff "${branch}"`, {
       cwd: workspace,
       stdio: "pipe",
       timeout: TIMEOUT
     });
     try {
-      execSync4(`git worktree remove "${worktreePath}"`, { cwd: workspace, stdio: "pipe", timeout: TIMEOUT });
+      execSync3(`git worktree remove "${worktreePath}"`, { cwd: workspace, stdio: "pipe", timeout: TIMEOUT });
     } catch {
     }
     try {
-      execSync4(`git branch -d "${branch}"`, { cwd: workspace, stdio: "pipe", timeout: TIMEOUT });
+      execSync3(`git branch -d "${branch}"`, { cwd: workspace, stdio: "pipe", timeout: TIMEOUT });
     } catch {
     }
     return { success: true };
   } catch (err) {
     let conflictFiles = [];
     try {
-      const output = execSync4("git diff --name-only --diff-filter=U", {
+      const output = execSync3("git diff --name-only --diff-filter=U", {
         cwd: workspace,
         encoding: "utf-8",
         timeout: TIMEOUT
       }).trim();
       conflictFiles = output ? output.split("\n") : [];
-      execSync4("git merge --abort", { cwd: workspace, stdio: "pipe", timeout: TIMEOUT });
+      execSync3("git merge --abort", { cwd: workspace, stdio: "pipe", timeout: TIMEOUT });
     } catch {
     }
     return { success: false, conflictFiles };
   }
 }
 function removeWorktree(worktreePath, branch, workspace) {
-  const cwd = workspace ?? path9.dirname(path9.dirname(worktreePath));
+  const cwd = workspace ?? path8.dirname(path8.dirname(worktreePath));
   try {
-    execSync4(`git worktree remove --force "${worktreePath}"`, { cwd, stdio: "pipe", timeout: TIMEOUT });
+    execSync3(`git worktree remove --force "${worktreePath}"`, { cwd, stdio: "pipe", timeout: TIMEOUT });
   } catch {
   }
   try {
-    execSync4(`git branch -D "${branch}"`, { cwd, stdio: "pipe", timeout: TIMEOUT });
+    execSync3(`git branch -D "${branch}"`, { cwd, stdio: "pipe", timeout: TIMEOUT });
   } catch {
   }
 }
 
 // ../../packages/orchestrator/src/memory.ts
-import { readFileSync as readFileSync6, writeFileSync as writeFileSync6, mkdirSync as mkdirSync6, existsSync as existsSync9 } from "fs";
-import path10 from "path";
+import { readFileSync as readFileSync6, writeFileSync as writeFileSync6, mkdirSync as mkdirSync6, existsSync as existsSync8 } from "fs";
+import path9 from "path";
 import { homedir as homedir5 } from "os";
-var MEMORY_DIR = path10.join(homedir5(), ".bit-office", "memory");
+var MEMORY_DIR = path9.join(homedir5(), ".bit-office", "memory");
 function ensureDir() {
-  if (!existsSync9(MEMORY_DIR)) {
+  if (!existsSync8(MEMORY_DIR)) {
     mkdirSync6(MEMORY_DIR, { recursive: true });
   }
 }
 function loadStore() {
-  const filePath = path10.join(MEMORY_DIR, "memory.json");
+  const filePath = path9.join(MEMORY_DIR, "memory.json");
   try {
-    if (existsSync9(filePath)) {
+    if (existsSync8(filePath)) {
       return JSON.parse(readFileSync6(filePath, "utf-8"));
     }
   } catch {
@@ -7569,7 +7428,7 @@ function loadStore() {
 }
 function saveStore(store) {
   ensureDir();
-  const filePath = path10.join(MEMORY_DIR, "memory.json");
+  const filePath = path9.join(MEMORY_DIR, "memory.json");
   writeFileSync6(filePath, JSON.stringify(store, null, 2), "utf-8");
 }
 function recordReviewFeedback(reviewOutput) {
@@ -8210,6 +8069,149 @@ var Orchestrator = class extends EventEmitter {
   }
 };
 
+// ../../packages/orchestrator/src/preview-server.ts
+import { spawn as spawn2, execSync as execSync4 } from "child_process";
+import { existsSync as existsSync9 } from "fs";
+import path10 from "path";
+var STATIC_PORT = 9100;
+var COMMAND_PORT = 9101;
+var PreviewServer = class {
+  process = null;
+  currentDir = null;
+  isDetached = false;
+  /**
+   * Mode 1: Serve a static file directory on a fixed port.
+   * Returns the preview URL for the given file.
+   */
+  serve(filePath) {
+    if (!existsSync9(filePath)) {
+      console.log(`[PreviewServer] File not found: ${filePath}`);
+      return void 0;
+    }
+    const dir = path10.dirname(filePath);
+    const fileName = path10.basename(filePath);
+    this.stop();
+    try {
+      this.process = spawn2("npx", ["serve", dir, "-l", String(STATIC_PORT), "--no-clipboard"], {
+        stdio: "ignore",
+        detached: true
+      });
+      this.process.unref();
+      this.currentDir = dir;
+      this.isDetached = true;
+      const url = `http://localhost:${STATIC_PORT}/${fileName}`;
+      console.log(`[PreviewServer] Serving ${dir} on port ${STATIC_PORT}`);
+      return url;
+    } catch (e) {
+      console.log(`[PreviewServer] Failed to start static serve: ${e}`);
+      return void 0;
+    }
+  }
+  /**
+   * Mode 2: Run a command (e.g. "python app.py") and use a controlled port.
+   * The agent-specified port is ALWAYS replaced with COMMAND_PORT to prevent
+   * conflicts with the host system (e.g. Next.js on 3000).
+   * Returns the preview URL.
+   */
+  runCommand(cmd, cwd, agentPort) {
+    this.stop();
+    const port = COMMAND_PORT;
+    cmd = cmd.replace(/\s+(?:--port|-p)\s+\d+/gi, "");
+    if (agentPort) cmd = cmd.replace(new RegExp(`\\b${agentPort}\\b`, "g"), String(port));
+    cmd = `${cmd} --port ${port}`;
+    console.log(`[PreviewServer] Command: "${cmd}" (forced port ${port})`);
+    this.killPortHolder(port);
+    try {
+      this.process = spawn2(cmd, {
+        shell: true,
+        cwd,
+        stdio: "ignore",
+        detached: true,
+        env: { ...process.env, PORT: String(port) }
+      });
+      this.process.unref();
+      this.currentDir = cwd;
+      this.isDetached = true;
+      const url = `http://localhost:${port}`;
+      console.log(`[PreviewServer] Running "${cmd}" in ${cwd}, preview at port ${port}`);
+      return url;
+    } catch (e) {
+      console.log(`[PreviewServer] Failed to run command: ${e}`);
+      return void 0;
+    }
+  }
+  /**
+   * Mode 3: Launch a desktop/CLI process (no web preview URL).
+   * Used for Pygame, Tkinter, Electron, terminal apps, etc.
+   * NOT detached — GUI apps need the login session to access WindowServer (macOS).
+   */
+  launchProcess(cmd, cwd) {
+    this.stop();
+    try {
+      this.process = spawn2(cmd, {
+        shell: true,
+        cwd,
+        stdio: ["ignore", "ignore", "pipe"]
+      });
+      this.currentDir = cwd;
+      this.isDetached = false;
+      console.log(`[PreviewServer] Launched "${cmd}" in ${cwd} (pid=${this.process.pid})`);
+      this.process.stderr?.on("data", (data) => {
+        const msg = data.toString().trim();
+        if (msg) console.log(`[PreviewServer] stderr: ${msg.slice(0, 200)}`);
+      });
+      this.process.on("exit", (code) => {
+        console.log(`[PreviewServer] Process exited with code ${code}`);
+      });
+    } catch (e) {
+      console.log(`[PreviewServer] Failed to launch process: ${e}`);
+    }
+  }
+  /** Kill the current process and any orphan process on managed ports */
+  stop() {
+    if (this.process) {
+      try {
+        if (this.isDetached && this.process.pid) {
+          process.kill(-this.process.pid, "SIGTERM");
+        } else {
+          this.process.kill("SIGTERM");
+        }
+      } catch {
+        try {
+          this.process.kill("SIGTERM");
+        } catch {
+        }
+      }
+      this.process = null;
+      this.currentDir = null;
+      this.isDetached = false;
+      console.log(`[PreviewServer] Stopped`);
+    }
+    this.killPortHolder(STATIC_PORT);
+    this.killPortHolder(COMMAND_PORT);
+  }
+  /** Kill whatever process is listening on the given port (best-effort). */
+  killPortHolder(port) {
+    try {
+      const out = execSync4(`lsof -ti :${port}`, { encoding: "utf-8", timeout: 3e3 }).trim();
+      if (out) {
+        for (const pid of out.split("\n")) {
+          const n = parseInt(pid, 10);
+          if (n > 0) {
+            try {
+              process.kill(n, "SIGKILL");
+            } catch {
+            }
+          }
+        }
+        console.log(`[PreviewServer] Killed orphan process(es) on port ${port}: ${out.replace(/\n/g, ", ")}`);
+      }
+    } catch {
+    }
+  }
+};
+var previewServer = new PreviewServer();
+
 // ../../packages/orchestrator/src/index.ts
 function createOrchestrator(options) {
   return new Orchestrator(options);
@@ -8799,6 +8801,15 @@ function archiveProject(agents, team) {
       }
     }
   }
+  let totalInputTokens = 0;
+  let totalOutputTokens = 0;
+  for (const e of projectEvents) {
+    if (e.type === "TASK_DONE" && e.result?.tokenUsage) {
+      totalInputTokens += e.result.tokenUsage.inputTokens ?? 0;
+      totalOutputTokens += e.result.tokenUsage.outputTokens ?? 0;
+    }
+  }
+  const tokenUsage = totalInputTokens > 0 || totalOutputTokens > 0 ? { inputTokens: totalInputTokens, outputTokens: totalOutputTokens } : void 0;
   const id = `${projectStartedAt}-${projectName || "project"}`;
   const archive = {
     id,
@@ -8808,7 +8819,8 @@ function archiveProject(agents, team) {
     agents,
     team,
     events: projectEvents,
-    preview
+    preview,
+    tokenUsage
   };
   try {
     const filePath = path12.join(PROJECTS_DIR, `${id}.json`);
@@ -8836,7 +8848,8 @@ function listProjects() {
           endedAt: raw.endedAt,
           agentNames: raw.agents.map((a) => a.name),
           eventCount: raw.events.length,
-          preview: raw.preview
+          preview: raw.preview,
+          tokenUsage: raw.tokenUsage
         });
       } catch {
       }
@@ -9015,6 +9028,8 @@ function mapOrchestratorEvent(e) {
       persistTeamState();
       return null;
     }
+    case "token:update":
+      return { type: "TOKEN_UPDATE", agentId: e.agentId, inputTokens: e.inputTokens, outputTokens: e.outputTokens };
     // New events (worktree, retry) — log only, no wire protocol equivalent yet
     case "task:retrying":
       console.log(`[Retry] Agent ${e.agentId} retrying task ${e.taskId} (attempt ${e.attempt}/${e.maxRetries})`);
@@ -9541,6 +9556,7 @@ async function main() {
   orc.on("task:queued", forwardEvent);
   orc.on("worktree:created", forwardEvent);
   orc.on("worktree:merged", forwardEvent);
+  orc.on("token:update", forwardEvent);
   orc.on("agent:created", forwardEvent);
   orc.on("agent:fired", forwardEvent);
   orc.on("task:result-returned", forwardEvent);