@openscout/scout 0.2.19 → 0.2.21

package/dist/scout-web-server.mjs

@@ -1998,6 +1998,7 @@ var init_user_project_hints = __esm(() => {
 
 // packages/runtime/src/setup.ts
 import { execFileSync as execFileSync2 } from "child_process";
+import { existsSync as existsSync3, readFileSync } from "fs";
 import { access, mkdir as mkdir2, readdir as readdir2, readFile as readFile3, realpath, rm, stat as stat2, writeFile as writeFile2 } from "fs/promises";
 import { homedir as homedir3, hostname, userInfo } from "os";
 import { basename, dirname as dirname3, isAbsolute, join as join4, relative, resolve as resolve2 } from "path";
@@ -2175,7 +2176,25 @@ function normalizeTelegramConversationId(value) {
   return normalized;
 }
 function resolveNodeQualifier() {
-  return normalizeAgentSelectorSegment(process.env.OPENSCOUT_NODE_QUALIFIER?.trim() || hostname() || "local") || "local";
+  const fromEnv = process.env.OPENSCOUT_NODE_QUALIFIER?.trim();
+  if (fromEnv) {
+    return normalizeAgentSelectorSegment(fromEnv) || "local";
+  }
+  const alias = readNodeAliasSync();
+  if (alias) {
+    return normalizeAgentSelectorSegment(alias) || "local";
+  }
+  return normalizeAgentSelectorSegment(hostname() || "local") || "local";
+}
+function readNodeAliasSync() {
+  try {
+    const settingsPath = resolveOpenScoutSupportPaths().settingsPath;
+    const raw2 = readFileSync(settingsPath, "utf8");
+    const settings = JSON.parse(raw2);
+    return settings.node?.alias?.trim() || null;
+  } catch {
+    return null;
+  }
 }
 function detectGitBranchUncached(projectRoot) {
   try {
@@ -2376,6 +2395,9 @@ function defaultSettings() {
       completedAt: null,
       skippedAt: null
     },
+    node: {
+      alias: ""
+    },
     discovery: {
       contextRoot: null,
       workspaceRoots: [],
@@ -2775,6 +2797,7 @@ async function normalizeSettingsRecord(value, options = {}) {
   const candidate = typeof value === "object" && value ? value : {};
   const profile = typeof candidate.profile === "object" && candidate.profile ? candidate.profile : {};
   const onboarding = typeof candidate.onboarding === "object" && candidate.onboarding ? candidate.onboarding : {};
+  const node = typeof candidate.node === "object" && candidate.node ? candidate.node : {};
   const discovery = typeof candidate.discovery === "object" && candidate.discovery ? candidate.discovery : {};
   const agents = typeof candidate.agents === "object" && candidate.agents ? candidate.agents : {};
   const bridges = typeof candidate.bridges === "object" && candidate.bridges ? candidate.bridges : {};
@@ -2814,6 +2837,9 @@ async function normalizeSettingsRecord(value, options = {}) {
       completedAt: normalizeOptionalTimestamp(onboarding.completedAt),
       skippedAt: normalizeOptionalTimestamp(onboarding.skippedAt)
     },
+    node: {
+      alias: normalizeOptionalString(node.alias)
+    },
     discovery: {
       contextRoot,
       workspaceRoots,
@@ -2891,6 +2917,10 @@ async function writeOpenScoutSettings(settings, options = {}) {
       ...current.onboarding,
       ...settings.onboarding ?? {}
     },
+    node: {
+      ...current.node,
+      ...settings.node ?? {}
+    },
     discovery: {
       ...current.discovery,
       ...settings.discovery ?? {},
@@ -3822,6 +3852,9 @@ function resolveClaudeStreamJsonOutput(result, fallbackParts) {
 function sessionKey(options) {
   return `${options.agentName}:${options.sessionId}`;
 }
+function errorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
 async function readOptionalFile(filePath) {
   try {
     const raw2 = await readFile4(filePath, "utf8");
@@ -3974,17 +4007,35 @@ class ClaudeStreamJsonSession {
     if (this.claudeSessionId) {
       args.push("--resume", this.claudeSessionId);
     }
-    this.process = spawn2("claude", args, {
-      cwd: this.options.cwd,
-      env: buildManagedAgentEnvironment({
-        agentName: this.options.agentName,
-        currentDirectory: this.options.cwd,
-        baseEnv: process.env
-      })
+    let child;
+    try {
+      child = spawn2("claude", args, {
+        cwd: this.options.cwd,
+        env: buildManagedAgentEnvironment({
+          agentName: this.options.agentName,
+          currentDirectory: this.options.cwd,
+          baseEnv: process.env
+        })
+      });
+    } catch (error) {
+      throw new Error(`Failed to spawn claude: ${errorMessage(error)}`);
+    }
+    this.process = child;
+    child.on("error", (error) => {
+      console.error(`[openscout-runtime] claude process error for ${this.options.agentName}: ${error.message}`);
+      this.process = null;
+      if (this.activeTurn) {
+        const turn = this.activeTurn;
+        this.activeTurn = null;
+        if (turn.timer) {
+          clearTimeout(turn.timer);
+        }
+        turn.reject(new Error(`Claude process error: ${error.message}`));
+      }
     });
-    this.process.stdout.setEncoding("utf8");
-    this.process.stderr.setEncoding("utf8");
-    this.process.stdout.on("data", (chunk) => {
+    child.stdout.setEncoding("utf8");
+    child.stderr.setEncoding("utf8");
+    child.stdout.on("data", (chunk) => {
       appendFile(this.stdoutLogPath, chunk).catch(() => {
         return;
       });
@@ -4000,12 +4051,12 @@ class ClaudeStreamJsonSession {
         this.handleEvent(JSON.parse(trimmed));
       }
     });
-    this.process.stderr.on("data", (chunk) => {
+    child.stderr.on("data", (chunk) => {
       appendFile(this.stderrLogPath, chunk).catch(() => {
         return;
       });
     });
-    this.process.on("exit", (code) => {
+    child.on("exit", (code) => {
       if (code !== 0 && this.activeTurn) {
         const turn = this.activeTurn;
         this.activeTurn = null;
@@ -4150,7 +4201,7 @@ function parseJsonLine(line) {
     return null;
   }
 }
-function errorMessage(error) {
+function errorMessage2(error) {
   if (error instanceof Error) {
     return error.message;
   }
@@ -4175,7 +4226,7 @@ async function readOptionalFile2(filePath) {
   }
 }
 function isMissingCodexRolloutError(error) {
-  const message = errorMessage(error).toLowerCase();
+  const message = errorMessage2(error).toLowerCase();
   return message.includes("no rollout found for thread id");
 }
 
@@ -4248,7 +4299,7 @@ class CodexAppServerSession {
           await this.persistState();
         } catch (error) {
           this.clearActiveTurn(turn);
-          reject(error instanceof Error ? error : new Error(errorMessage(error)));
+          reject(error instanceof Error ? error : new Error(errorMessage2(error)));
         }
       });
       return {
@@ -4376,7 +4427,7 @@ class CodexAppServerSession {
       });
     });
     child.once("error", (error) => {
-      this.failSession(new Error(`Codex app-server failed for ${this.options.agentName}: ${errorMessage(error)}`));
+      this.failSession(new Error(`Codex app-server failed for ${this.options.agentName}: ${errorMessage2(error)}`));
     });
     child.once("exit", (code, signal) => {
       this.failSession(new Error(`Codex app-server exited for ${this.options.agentName}` + (code !== null ? ` with code ${code}` : "") + (signal ? ` (${signal})` : "")));
@@ -4412,7 +4463,7 @@ class CodexAppServerSession {
         await this.persistThreadId();
         return;
       } catch (error) {
-        await appendFile2(this.stderrLogPath, `[openscout] failed to resume stored Codex thread ${storedThreadId}: ${errorMessage(error)}
+        await appendFile2(this.stderrLogPath, `[openscout] failed to resume stored Codex thread ${storedThreadId}: ${errorMessage2(error)}
 `).catch(() => {
           return;
         });
@@ -4682,7 +4733,7 @@ class CodexAppServerSession {
         });
       } catch (error) {
         this.pendingRequests.delete(id);
-        reject(error instanceof Error ? error : new Error(errorMessage(error)));
+        reject(error instanceof Error ? error : new Error(errorMessage2(error)));
       }
     });
   }
@@ -4759,7 +4810,7 @@ function buildCollaborationContractPrompt(agentId) {
 
 // packages/runtime/src/broker-service.ts
 import { spawnSync } from "child_process";
-import { existsSync as existsSync4, mkdirSync as mkdirSync2, readFileSync, rmSync as rmSync2, writeFileSync as writeFileSync2 } from "fs";
+import { existsSync as existsSync5, mkdirSync as mkdirSync2, readFileSync as readFileSync2, rmSync as rmSync2, writeFileSync as writeFileSync2 } from "fs";
 import { homedir as homedir5 } from "os";
 import { basename as basename3, dirname as dirname5, join as join8, resolve as resolve3 } from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
@@ -4780,7 +4831,7 @@ function runtimePackageDir() {
   return resolve3(moduleDir, "..");
 }
 function isInstalledRuntimePackageDir(candidate) {
-  return existsSync4(join8(candidate, "package.json")) && existsSync4(join8(candidate, "bin", "openscout-runtime.mjs"));
+  return existsSync5(join8(candidate, "package.json")) && existsSync5(join8(candidate, "bin", "openscout-runtime.mjs"));
 }
 function findGlobalRuntimeDir() {
   const bunCandidate = join8(homedir5(), ".bun", "node_modules", "@openscout", "runtime");
@@ -4798,7 +4849,7 @@ function findWorkspaceRuntimeDir(startDir) {
   let current = resolve3(startDir);
   while (true) {
     const candidate = join8(current, "packages", "runtime");
-    if (existsSync4(join8(candidate, "package.json")) && existsSync4(join8(candidate, "src"))) {
+    if (existsSync5(join8(candidate, "package.json")) && existsSync5(join8(candidate, "src"))) {
       return candidate;
     }
     const parent = dirname5(current);
@@ -4812,18 +4863,18 @@ function resolveBunExecutable() {
   if (explicit && explicit.trim().length > 0) {
     return explicit;
   }
-  if (basename3(process.execPath).startsWith("bun") && existsSync4(process.execPath)) {
+  if (basename3(process.execPath).startsWith("bun") && existsSync5(process.execPath)) {
     return process.execPath;
   }
   const pathEntries = (process.env.PATH ?? "").split(":").filter(Boolean);
   for (const entry of pathEntries) {
     const candidate = join8(entry, "bun");
-    if (existsSync4(candidate)) {
+    if (existsSync5(candidate)) {
       return candidate;
     }
   }
   const homeBun = join8(homedir5(), ".bun", "bin", "bun");
-  if (existsSync4(homeBun)) {
+  if (existsSync5(homeBun)) {
     return homeBun;
   }
   return "bun";
@@ -5009,10 +5060,10 @@ function launchctlPath() {
   return "/bin/launchctl";
 }
 function readLogLines(path) {
-  if (!existsSync4(path)) {
+  if (!existsSync5(path)) {
     return [];
   }
-  return readFileSync(path, "utf8").split(`
+  return readFileSync2(path, "utf8").split(`
 `).map((line) => line.trim()).filter(Boolean);
 }
 function isPackageScriptBanner(line) {
@@ -5109,7 +5160,7 @@ async function brokerServiceStatus(config = resolveBrokerServiceConfig()) {
   ensureServiceDirectories(config);
   const launchctl = inspectLaunchctl(config);
   const health = await fetchHealthSnapshot(config);
-  const installed = existsSync4(config.launchAgentPath);
+  const installed = existsSync5(config.launchAgentPath);
   const lastLogLine = health.reachable ? readLastLogLine([config.stdoutLogPath, config.stderrLogPath]) : readLastLogLine([config.stderrLogPath, config.stdoutLogPath]);
   return {
     label: config.label,
@@ -5171,7 +5222,7 @@ async function restartBrokerService(config = resolveBrokerServiceConfig()) {
 }
 async function uninstallBrokerService(config = resolveBrokerServiceConfig()) {
   await stopBrokerService(config);
-  if (existsSync4(config.launchAgentPath)) {
+  if (existsSync5(config.launchAgentPath)) {
     rmSync2(config.launchAgentPath, { force: true });
   }
   return brokerServiceStatus(config);
@@ -5250,7 +5301,7 @@ var init_local_agent_template = __esm(() => {
 
 // packages/runtime/src/local-agents.ts
 import { execFileSync as execFileSync3, execSync } from "child_process";
-import { existsSync as existsSync5, readFileSync as readFileSync2 } from "fs";
+import { existsSync as existsSync6, readFileSync as readFileSync3 } from "fs";
 import { mkdir as mkdir5, rm as rm4, stat as stat3, writeFile as writeFile5 } from "fs/promises";
 import { basename as basename4, dirname as dirname6, join as join9, resolve as resolve4 } from "path";
 import { fileURLToPath as fileURLToPath5 } from "url";
@@ -5263,10 +5314,10 @@ function resolveProjectsRoot(projectPath) {
   }
   try {
     const supportPaths = resolveOpenScoutSupportPaths();
-    if (!existsSync5(supportPaths.settingsPath)) {
+    if (!existsSync6(supportPaths.settingsPath)) {
       return dirname6(projectPath);
     }
-    const raw2 = JSON.parse(readFileSync2(supportPaths.settingsPath, "utf8"));
+    const raw2 = JSON.parse(readFileSync3(supportPaths.settingsPath, "utf8"));
     const workspaceRoot = raw2.discovery?.workspaceRoots?.find((entry) => typeof entry === "string" && entry.trim().length > 0);
     return workspaceRoot ? resolve4(workspaceRoot) : dirname6(projectPath);
   } catch {
@@ -5293,7 +5344,7 @@ function resolveScoutSkillPath() {
     join9(process.env.HOME ?? "", ".agents", "skills", "relay-agent-comms", "SKILL.md")
   ];
   for (const path of candidatePaths) {
-    if (existsSync5(path)) {
+    if (existsSync6(path)) {
       return path;
     }
   }
@@ -5925,11 +5976,33 @@ function killAgentSession(sessionName) {
     execSync(`tmux kill-session -t ${JSON.stringify(sessionName)}`, { stdio: "pipe" });
   } catch {}
 }
+function isHarnessBinaryAvailable(transport) {
+  const binaryMap = {
+    claude_stream_json: "claude",
+    codex_app_server: "codex"
+  };
+  const binary = binaryMap[transport];
+  if (!binary)
+    return true;
+  try {
+    execFileSync3("sh", ["-lc", `command -v ${binary}`], {
+      stdio: ["ignore", "pipe", "ignore"],
+      encoding: "utf8"
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
 async function ensureLocalAgentOnline(agentName, record) {
   const normalizedRecord = normalizeLocalAgentRecord(agentName, record);
   if (isLocalAgentRecordOnline(agentName, normalizedRecord)) {
     return normalizedRecord;
   }
+  if (!isHarnessBinaryAvailable(normalizedRecord.transport)) {
+    console.warn(`[openscout-runtime] skipping warmup for ${agentName}: harness binary for ${normalizedRecord.transport} not found in PATH`);
+    return normalizedRecord;
+  }
   const projectPath = normalizedRecord.cwd;
   const projectName = normalizedRecord.project || basename4(projectPath);
   const systemPromptTemplate = normalizedRecord.systemPrompt || buildLocalAgentSystemPromptTemplate();
@@ -6039,7 +6112,7 @@ async function ensureLocalAgentOnline(agentName, record) {
     await new Promise((resolve5) => setTimeout(resolve5, 100));
   }
   if (!isLocalAgentSessionAlive(normalizedRecord.tmuxSession)) {
-    const stderrTail = existsSync5(stderrLogFile) ? readFileSync2(stderrLogFile, "utf8").trim().split(/\r?\n/).slice(-10).join(`
+    const stderrTail = existsSync6(stderrLogFile) ? readFileSync3(stderrLogFile, "utf8").trim().split(/\r?\n/).slice(-10).join(`
 `).trim() : "";
     throw new Error(stderrTail ? `Relay agent ${agentName} failed to stay online:
 ${stderrTail}` : `Relay agent ${agentName} failed to stay online.`);
@@ -6320,15 +6393,26 @@ async function loadRegisteredLocalAgentBindings(nodeId, options = {}) {
   ]);
   const requestedAgentIds = new Set((options.agentIds ?? []).filter(Boolean));
   const selectedEntries = Object.entries(registry).filter(([agentId]) => requestedAgentIds.size === 0 || requestedAgentIds.has(agentId));
-  return Promise.all(selectedEntries.map(async ([agentId, record]) => {
+  const results = await Promise.all(selectedEntries.map(async ([agentId, record]) => {
     const baseRecord = overrides[agentId]?.projectRoot ? {
       ...record,
       projectRoot: overrides[agentId].projectRoot
     } : record;
     const harnessRecord = options.harness ? recordForHarness(baseRecord, options.harness) : baseRecord;
-    const effectiveRecord = options.ensureOnline ? await ensureLocalAgentOnline(agentId, harnessRecord) : normalizeLocalAgentRecord(agentId, harnessRecord);
+    let effectiveRecord;
+    if (options.ensureOnline) {
+      try {
+        effectiveRecord = await ensureLocalAgentOnline(agentId, harnessRecord);
+      } catch (error) {
+        console.error(`[openscout-runtime] failed to warm agent ${agentId}: ${error instanceof Error ? error.message : error}`);
+        effectiveRecord = normalizeLocalAgentRecord(agentId, harnessRecord);
+      }
+    } else {
+      effectiveRecord = normalizeLocalAgentRecord(agentId, harnessRecord);
+    }
     return buildLocalAgentBinding(agentId, effectiveRecord, isLocalAgentRecordOnline(agentId, effectiveRecord), nodeId, "relay-agent-registry");
   }));
+  return results;
 }
 async function inferLocalAgentBinding(agentId, nodeId) {
   if (!agentId || BUILT_IN_LOCAL_AGENT_IDS.has(agentId)) {
@@ -7940,7 +8024,7 @@ init_setup();
 
 // apps/desktop/src/shared/product.ts
 var SCOUT_PRODUCT_NAME = "Scout";
-var SCOUT_APP_VERSION = "0.2.19";
+var SCOUT_APP_VERSION = "0.2.21";
 
 // apps/desktop/src/shared/surface-capabilities.ts
 function resolveScoutSurfaceCapabilities(surface) {
@@ -7987,7 +8071,7 @@ import path3 from "path";
 // apps/desktop/src/app/host/runtime-service-client.ts
 import { spawn } from "child_process";
 import { basename as basename2, dirname as dirname4, join as join5 } from "path";
-import { existsSync as existsSync3 } from "fs";
+import { existsSync as existsSync4 } from "fs";
 import { fileURLToPath as fileURLToPath3 } from "url";
 import { homedir as homedir4 } from "os";
 function tryWhich(executableName) {
@@ -7997,13 +8081,13 @@ function tryWhich(executableName) {
     if (!dir)
       continue;
     const candidate = join5(dir, executableName);
-    if (existsSync3(candidate)) {
+    if (existsSync4(candidate)) {
       return candidate;
     }
     if (process.platform === "win32") {
       for (const ext of [".cmd", ".exe", ".bat"]) {
         const withExt = candidate + ext;
-        if (existsSync3(withExt))
+        if (existsSync4(withExt))
           return withExt;
       }
     }
@@ -8015,7 +8099,7 @@ function findNodeModulesRuntimeBin() {
   let dir = dirname4(fileURLToPath3(import.meta.url));
   for (let i = 0;i < 24; i++) {
     const candidate = join5(dir, runtimeBinRel);
-    if (existsSync3(candidate))
+    if (existsSync4(candidate))
       return candidate;
     const parent = dirname4(dir);
     if (parent === dir)
@@ -8023,7 +8107,7 @@ function findNodeModulesRuntimeBin() {
     dir = parent;
   }
   const bunGlobal = join5(homedir4(), ".bun", "install", "global", "node_modules", "@openscout", "runtime", "bin", "openscout-runtime.mjs");
-  if (existsSync3(bunGlobal))
+  if (existsSync4(bunGlobal))
     return bunGlobal;
   return null;
 }
@@ -8031,7 +8115,7 @@ function findMonorepoOpenscoutRuntimeBin() {
   let dir = process.cwd();
   for (let i = 0;i < 24; i++) {
     const candidate = join5(dir, "packages", "runtime", "bin", "openscout-runtime.mjs");
-    if (existsSync3(candidate)) {
+    if (existsSync4(candidate)) {
       return candidate;
     }
     const parent = dirname4(dir);
@@ -8044,7 +8128,7 @@ function findMonorepoOpenscoutRuntimeBin() {
 function resolveJavaScriptRuntimeExecutable() {
   const explicit = process.env.OPENSCOUT_RUNTIME_NODE_BIN?.trim();
   if (explicit) {
-    if (existsSync3(explicit)) {
+    if (existsSync4(explicit)) {
       return explicit;
     }
     const found = tryWhich(explicit);
@@ -8070,7 +8154,7 @@ function resolveJavaScriptRuntimeExecutable() {
 function resolveRuntimeServiceEntrypoint() {
   const explicit = process.env.OPENSCOUT_RUNTIME_BIN?.trim();
   if (explicit) {
-    if (existsSync3(explicit)) {
+    if (existsSync4(explicit)) {
       return explicit;
     }
     const found = tryWhich(explicit);
@@ -8662,7 +8746,7 @@ function createScoutVoiceState(input = {}) {
 // apps/desktop/src/app/desktop/shell-probes.ts
 init_setup();
 init_support_paths();
-import { existsSync as existsSync6, readFileSync as readFileSync3 } from "fs";
+import { existsSync as existsSync7, readFileSync as readFileSync4 } from "fs";
 import path2 from "path";
 
 // apps/desktop/src/app/desktop/shell-utils.ts
@@ -8747,7 +8831,7 @@ var PROJECT_GIT_ACTIVITY_CACHE_TTL_MS = 60000;
 var projectGitActivityCache = new Map;
 function readHelperStatus() {
   const statusPath = resolveOpenScoutSupportPaths().desktopStatusPath;
-  if (!existsSync6(statusPath)) {
+  if (!existsSync7(statusPath)) {
     return {
       running: false,
       detail: null,
@@ -8755,7 +8839,7 @@ function readHelperStatus() {
     };
   }
   try {
-    const raw2 = JSON.parse(readFileSync3(statusPath, "utf8"));
+    const raw2 = JSON.parse(readFileSync4(statusPath, "utf8"));
     return {
       running: raw2.state === "running",
       detail: typeof raw2.detail === "string" ? raw2.detail : null,
@@ -8793,7 +8877,7 @@ function readTmuxSessionOutput() {
 }
 function readDesktopSettingsRecord() {
   try {
-    return JSON.parse(readFileSync3(resolveOpenScoutSupportPaths().settingsPath, "utf8"));
+    return JSON.parse(readFileSync4(resolveOpenScoutSupportPaths().settingsPath, "utf8"));
   } catch {
     return {};
   }
@@ -11648,22 +11732,22 @@ async function sendScoutElectronRelayMessage(input, options = {}) {
 init_support_paths();
 import { execFileSync as execFileSync5 } from "child_process";
 import { randomUUID as randomUUID2 } from "crypto";
-import { existsSync as existsSync10, readFileSync as readFileSync6 } from "fs";
+import { existsSync as existsSync11, readFileSync as readFileSync7 } from "fs";
 import { open as open2 } from "fs/promises";
 import os from "os";
 import path5 from "path";
 
 // apps/desktop/src/shared/paths.ts
-import { existsSync as existsSync7, readFileSync as readFileSync4 } from "fs";
+import { existsSync as existsSync8, readFileSync as readFileSync5 } from "fs";
 import { dirname as dirname7, join as join10, resolve as resolve5 } from "path";
 import { fileURLToPath as fileURLToPath6 } from "url";
 function looksLikeWorkspaceRoot(candidate) {
   const packageJsonPath = join10(candidate, "package.json");
-  if (!existsSync7(packageJsonPath)) {
+  if (!existsSync8(packageJsonPath)) {
     return false;
   }
   try {
-    const parsed = JSON.parse(readFileSync4(packageJsonPath, "utf8"));
+    const parsed = JSON.parse(readFileSync5(packageJsonPath, "utf8"));
     return Array.isArray(parsed.workspaces);
   } catch {
     return false;
@@ -11671,11 +11755,11 @@ function looksLikeWorkspaceRoot(candidate) {
 }
 function looksLikePackagedAppRoot(candidate) {
   const packageJsonPath = join10(candidate, "package.json");
-  if (!existsSync7(packageJsonPath)) {
+  if (!existsSync8(packageJsonPath)) {
     return false;
   }
   try {
-    const parsed = JSON.parse(readFileSync4(packageJsonPath, "utf8"));
+    const parsed = JSON.parse(readFileSync5(packageJsonPath, "utf8"));
     return parsed.name === "@scout/electron-app";
   } catch {
     return false;
@@ -11683,18 +11767,18 @@ function looksLikePackagedAppRoot(candidate) {
 }
 function looksLikeInstalledCliRoot(candidate) {
   const packageJsonPath = join10(candidate, "package.json");
-  if (!existsSync7(packageJsonPath)) {
+  if (!existsSync8(packageJsonPath)) {
     return false;
   }
   try {
-    const parsed = JSON.parse(readFileSync4(packageJsonPath, "utf8"));
+    const parsed = JSON.parse(readFileSync5(packageJsonPath, "utf8"));
     return parsed.name === "@openscout/scout" || parsed.name === "@openscout/cli";
   } catch {
     return false;
   }
 }
 function looksLikeSourceAppRoot(candidate) {
-  return existsSync7(join10(candidate, "bin", "scout.ts"));
+  return existsSync8(join10(candidate, "bin", "scout.ts"));
 }
 function findMatchingAncestor(startDirectory, predicate) {
   let current = resolve5(startDirectory);
@@ -11768,9 +11852,9 @@ import { spawn as spawn4 } from "child_process";
 import {
   accessSync,
   constants as constants2,
-  existsSync as existsSync8,
+  existsSync as existsSync9,
   mkdirSync as mkdirSync3,
-  readFileSync as readFileSync5,
+  readFileSync as readFileSync6,
   statSync as statSync2,
   unlinkSync,
   writeFileSync as writeFileSync3
@@ -12009,11 +12093,11 @@ async function loadScoutPairingPendingApprovals(port) {
 }
 function loadScoutPairingConfig() {
   const { configPath } = resolveScoutPairingPaths();
-  if (!existsSync8(configPath)) {
+  if (!existsSync9(configPath)) {
     return {};
   }
   try {
-    const payload = JSON.parse(readFileSync5(configPath, "utf8"));
+    const payload = JSON.parse(readFileSync6(configPath, "utf8"));
     return typeof payload === "object" && payload ? payload : {};
   } catch {
     return {};
@@ -12044,11 +12128,11 @@ async function resolveDefaultScoutPairingWorkspaceRoot(currentDirectory) {
 }
 function readScoutPairingRuntimeSnapshot() {
   const { runtimeStatePath } = resolveScoutPairingPaths();
-  if (!existsSync8(runtimeStatePath)) {
+  if (!existsSync9(runtimeStatePath)) {
     return null;
   }
   try {
-    const parsed = JSON.parse(readFileSync5(runtimeStatePath, "utf8"));
+    const parsed = JSON.parse(readFileSync6(runtimeStatePath, "utf8"));
     return parsed?.version === SCOUT_PAIRING_RUNTIME_VERSION ? parsed : null;
   } catch {
     return null;
@@ -12062,11 +12146,11 @@ function clearScoutPairingRuntimeSnapshot() {
 }
 function readScoutPairingRuntimePid() {
   const { runtimePidPath } = resolveScoutPairingPaths();
-  if (!existsSync8(runtimePidPath)) {
+  if (!existsSync9(runtimePidPath)) {
     return null;
   }
   try {
-    const raw2 = readFileSync5(runtimePidPath, "utf8").trim();
+    const raw2 = readFileSync6(runtimePidPath, "utf8").trim();
     const pid = Number(raw2);
     return Number.isInteger(pid) && pid > 0 ? pid : null;
   } catch {
@@ -12118,22 +12202,22 @@ function clearStaleScoutPairingRuntimeFiles() {
   clearScoutPairingRuntimeSnapshot();
 }
 function readScoutPairingIdentityFingerprint(identityPath) {
-  if (!existsSync8(identityPath)) {
+  if (!existsSync9(identityPath)) {
     return null;
   }
   try {
-    const payload = JSON.parse(readFileSync5(identityPath, "utf8"));
+    const payload = JSON.parse(readFileSync6(identityPath, "utf8"));
     return typeof payload.publicKey === "string" && payload.publicKey.length > 0 ? payload.publicKey.slice(0, 16) : null;
   } catch {
     return null;
   }
 }
 function readScoutPairingTrustedPeerCount(trustedPeersPath) {
-  if (!existsSync8(trustedPeersPath)) {
+  if (!existsSync9(trustedPeersPath)) {
     return 0;
   }
   try {
-    const payload = JSON.parse(readFileSync5(trustedPeersPath, "utf8"));
+    const payload = JSON.parse(readFileSync6(trustedPeersPath, "utf8"));
     return Array.isArray(payload) ? payload.length : 0;
   } catch {
     return 0;
@@ -12155,11 +12239,11 @@ function formatScoutPairingHistoryTimestamp(value) {
   }).format(date);
 }
 function readScoutPairingTrustedPeers(trustedPeersPath) {
-  if (!existsSync8(trustedPeersPath)) {
+  if (!existsSync9(trustedPeersPath)) {
     return [];
   }
   try {
-    const payload = JSON.parse(readFileSync5(trustedPeersPath, "utf8"));
+    const payload = JSON.parse(readFileSync6(trustedPeersPath, "utf8"));
     if (!Array.isArray(payload)) {
       return [];
     }
@@ -12183,7 +12267,7 @@ function readScoutPairingTrustedPeers(trustedPeersPath) {
   }
 }
 function readScoutPairingLogTail(logPath) {
-  if (!existsSync8(logPath)) {
+  if (!existsSync9(logPath)) {
     return {
       body: "",
       updatedAtLabel: null,
@@ -12191,7 +12275,7 @@ function readScoutPairingLogTail(logPath) {
       truncated: false
     };
   }
-  const body = readFileSync5(logPath, "utf8");
+  const body = readFileSync6(logPath, "utf8");
   const lines = body.split(/\r?\n/g);
   const visibleLines = lines.slice(-SCOUT_PAIRING_LOG_TAIL_LINE_LIMIT);
   const stats = statSync2(logPath);
@@ -12262,7 +12346,7 @@ function resolveScoutPairingRuntimeScriptPath() {
     join11(appRoot, "..", "..", "packages", "electron-app", "dist", "electron", SCOUT_PAIRING_RUNTIME_SCRIPT.replace(/\.ts$/, ".js"))
   ];
   for (const candidate of candidates) {
-    if (existsSync8(candidate)) {
+    if (existsSync9(candidate)) {
       return candidate;
     }
   }
@@ -12479,7 +12563,7 @@ init_setup();
 init_support_paths();
 await init_local_agents();
 import { spawn as spawn5 } from "child_process";
-import { existsSync as existsSync9 } from "fs";
+import { existsSync as existsSync10 } from "fs";
 import { homedir as homedir8 } from "os";
 import path4 from "path";
 
@@ -12600,7 +12684,7 @@ function defaultOnboardingContextRoot(explicitRoot, workspaceRoots, fallback) {
   return path4.resolve(expandHomePath5(chosenRoot));
 }
 function isExecutable3(candidate) {
-  return existsSync9(candidate);
+  return existsSync10(candidate);
 }
 function resolveScoutElectronScoutExecutable() {
   const explicit = process.env.OPENSCOUT_SCOUT_BIN ?? process.env.SCOUT_BIN;
@@ -12702,7 +12786,7 @@ function buildOnboardingSteps(input) {
 }
 function resolveCurrentProjectConfigPath(onboardingContextRoot) {
   const candidate = path4.join(onboardingContextRoot, ".openscout", "project.json");
-  return existsSync9(candidate) ? candidate : null;
+  return existsSync10(candidate) ? candidate : null;
 }
 async function loadScoutElectronSettingsBase(currentDirectory, services = {}, input = {}) {
   const settingsDirectory = resolveSettingsDirectory(currentDirectory);
@@ -12796,7 +12880,7 @@ function buildScoutElectronAppSettingsState(base, input) {
       return {
         root: compactHomePath4(normalizedRoot) ?? normalizedRoot,
         title: path4.basename(normalizedRoot) || normalizedRoot,
-        projectConfigPath: existsSync9(projectConfigFilePath) ? compactHomePath4(projectConfigFilePath) ?? projectConfigFilePath : null
+        projectConfigPath: existsSync10(projectConfigFilePath) ? compactHomePath4(projectConfigFilePath) ?? projectConfigFilePath : null
       };
     }),
     workspaceRootsNote: "Scan folders are user-configured. Scout walks them recursively to find repos, project roots, and harness evidence.",
@@ -13196,11 +13280,11 @@ function runOptionalCommand3(command, args) {
   }
 }
 function readPackageVersion(candidate) {
-  if (!existsSync10(candidate)) {
+  if (!existsSync11(candidate)) {
     return null;
   }
   try {
-    const payload = JSON.parse(readFileSync6(candidate, "utf8"));
+    const payload = JSON.parse(readFileSync7(candidate, "utf8"));
     if (typeof payload.version === "string" && payload.version.trim().length > 0) {
       return payload.version.trim();
     }
@@ -13373,8 +13457,8 @@ function appModeLabel() {
   try {
     const appRoot = resolveScoutAppRoot();
     const packageJsonPath = path5.join(appRoot, "package.json");
-    if (existsSync10(packageJsonPath)) {
-      const payload = JSON.parse(readFileSync6(packageJsonPath, "utf8"));
+    if (existsSync11(packageJsonPath)) {
+      const payload = JSON.parse(readFileSync7(packageJsonPath, "utf8"));
       if (payload.name === "@scout/electron-app") {
         return "packaged";
       }
@@ -13504,7 +13588,7 @@ async function tailScoutLogSource(source, tailLines = DEFAULT_LOG_TAIL_LINES) {
   let truncated = false;
   let foundAny = false;
   for (const filePath of source.paths) {
-    if (!existsSync10(filePath)) {
+    if (!existsSync11(filePath)) {
       continue;
     }
     foundAny = true;
@@ -13769,7 +13853,7 @@ async function submitScoutElectronFeedbackReport(input, currentDirectory = proce
 }
 
 // apps/desktop/src/app/electron/host.ts
-import { existsSync as existsSync11 } from "fs";
+import { existsSync as existsSync12 } from "fs";
 import { stat as stat5 } from "fs/promises";
 import path6 from "path";
 function expandHomePath6(value) {
@@ -13809,16 +13893,16 @@ async function revealScoutElectronPath(filePath, host = {}) {
   if (!targetPath) {
     return false;
   }
-  if (existsSync11(targetPath)) {
+  if (existsSync12(targetPath)) {
     try {
       const targetStats = await stat5(targetPath);
       if (targetStats.isDirectory()) {
         if (!host.openPath) {
           throw new Error("Scout path opening is unavailable.");
         }
-        const errorMessage2 = await host.openPath(targetPath);
-        if (errorMessage2) {
-          throw new Error(errorMessage2);
+        const errorMessage3 = await host.openPath(targetPath);
+        if (errorMessage3) {
+          throw new Error(errorMessage3);
         }
         return true;
       }
@@ -14052,7 +14136,7 @@ function releaseScoutKeepAliveLease(leaseId) {
 
 // apps/desktop/src/app/host/agent-session.ts
 import { execFileSync as execFileSync6 } from "child_process";
-import { existsSync as existsSync12 } from "fs";
+import { existsSync as existsSync13 } from "fs";
 import { open as open3 } from "fs/promises";
 import path7 from "path";
 init_support_paths();
@@ -14205,7 +14289,7 @@ async function readAgentSessionLogs(agentId, tailLines) {
   let foundAny = false;
   let targetPath = null;
   for (const filePath of sources) {
-    if (!existsSync12(filePath)) {
+    if (!existsSync13(filePath)) {
       continue;
     }
     foundAny = true;
@@ -14384,9 +14468,9 @@ async function openScoutElectronAgentSession(agentId, host = {}) {
     if (!host.openPath) {
       throw new Error("Scout agent-session path opening is unavailable.");
     }
-    const errorMessage2 = await host.openPath(targetPath);
-    if (errorMessage2) {
-      throw new Error(errorMessage2);
+    const errorMessage3 = await host.openPath(targetPath);
+    if (errorMessage3) {
+      throw new Error(errorMessage3);
     }
     return true;
   }
@@ -15116,7 +15200,7 @@ async function deriveNewAgentName(projectName, branch, harness) {
 async function createGitWorktree(projectRoot, agentName) {
   const { execSync: execSync2 } = await import("child_process");
   const { join: join12 } = await import("path");
-  const { mkdirSync: mkdirSync4, existsSync: existsSync13 } = await import("fs");
+  const { mkdirSync: mkdirSync4, existsSync: existsSync14 } = await import("fs");
   try {
     execSync2("git rev-parse --git-dir", { cwd: projectRoot, stdio: "pipe" });
   } catch {
@@ -15125,7 +15209,7 @@ async function createGitWorktree(projectRoot, agentName) {
   const branchName = `scout/${agentName}`;
   const worktreeDir = join12(projectRoot, ".scout-worktrees");
   const worktreePath = join12(worktreeDir, agentName);
-  if (existsSync13(worktreePath)) {
+  if (existsSync14(worktreePath)) {
     return { path: worktreePath, branch: branchName };
   }
   mkdirSync4(worktreeDir, { recursive: true });