@openscout/scout 0.2.16 → 0.2.17

package/dist/main.mjs

@@ -5441,6 +5441,12 @@ function findGlobalRuntimeDir() {
   const bunCandidate = join7(homedir4(), ".bun", "node_modules", "@openscout", "runtime");
   if (isInstalledRuntimePackageDir(bunCandidate))
     return bunCandidate;
+  const bunGlobalCandidate = join7(homedir4(), ".bun", "install", "global", "node_modules", "@openscout", "runtime");
+  if (isInstalledRuntimePackageDir(bunGlobalCandidate))
+    return bunGlobalCandidate;
+  const bunScoutNested = join7(homedir4(), ".bun", "install", "global", "node_modules", "@openscout", "scout", "node_modules", "@openscout", "runtime");
+  if (isInstalledRuntimePackageDir(bunScoutNested))
+    return bunScoutNested;
   return null;
 }
 function findWorkspaceRuntimeDir(startDir) {
@@ -8928,6 +8934,8 @@ var init_down = __esm(async () => {
 import { spawn as spawn3 } from "node:child_process";
 import { basename as basename5, dirname as dirname6, join as join10 } from "node:path";
 import { existsSync as existsSync6 } from "node:fs";
+import { fileURLToPath as fileURLToPath5 } from "node:url";
+import { homedir as homedir5 } from "node:os";
 function tryWhich(executableName) {
   const pathEnv = process.env.PATH ?? "";
   const sep = process.platform === "win32" ? ";" : ":";
@@ -8948,6 +8956,23 @@ function tryWhich(executableName) {
   }
   return null;
 }
+function findNodeModulesRuntimeBin() {
+  const runtimeBinRel = join10("node_modules", "@openscout", "runtime", "bin", "openscout-runtime.mjs");
+  let dir = dirname6(fileURLToPath5(import.meta.url));
+  for (let i = 0;i < 24; i++) {
+    const candidate = join10(dir, runtimeBinRel);
+    if (existsSync6(candidate))
+      return candidate;
+    const parent = dirname6(dir);
+    if (parent === dir)
+      break;
+    dir = parent;
+  }
+  const bunGlobal = join10(homedir5(), ".bun", "install", "global", "node_modules", "@openscout", "runtime", "bin", "openscout-runtime.mjs");
+  if (existsSync6(bunGlobal))
+    return bunGlobal;
+  return null;
+}
 function findMonorepoOpenscoutRuntimeBin() {
   let dir = process.cwd();
   for (let i = 0;i < 24; i++) {
@@ -9004,6 +9029,10 @@ function resolveRuntimeServiceEntrypoint() {
   if (onPath) {
     return onPath;
   }
+  const fromNodeModules = findNodeModulesRuntimeBin();
+  if (fromNodeModules) {
+    return fromNodeModules;
+  }
   const monorepo = findMonorepoOpenscoutRuntimeBin();
   if (monorepo) {
     return monorepo;
@@ -9121,7 +9150,7 @@ var init_service3 = __esm(() => {
 // ../../apps/desktop/src/shared/paths.ts
 import { existsSync as existsSync7, readFileSync as readFileSync3 } from "node:fs";
 import { dirname as dirname7, join as join11, resolve as resolve7 } from "node:path";
-import { fileURLToPath as fileURLToPath5 } from "node:url";
+import { fileURLToPath as fileURLToPath6 } from "node:url";
 function looksLikeWorkspaceRoot(candidate) {
   const packageJsonPath = join11(candidate, "package.json");
   if (!existsSync7(packageJsonPath)) {
@@ -9175,7 +9204,7 @@ function findMatchingAncestor(startDirectory, predicate) {
   }
 }
 function defaultModuleDirectory() {
-  return dirname7(fileURLToPath5(import.meta.url));
+  return dirname7(fileURLToPath6(import.meta.url));
 }
 function uniqueResolutionStarts(options) {
   const starts = [
@@ -9578,10 +9607,10 @@ var init_env = __esm(async () => {
 
 // ../../apps/desktop/src/core/pairing/runtime/config.ts
 import { existsSync as existsSync9, mkdirSync as mkdirSync3, readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "node:fs";
-import { homedir as homedir5 } from "node:os";
+import { homedir as homedir6 } from "node:os";
 import path from "node:path";
 function pairingPaths() {
-  const rootDir = path.join(homedir5(), ".scout/pairing");
+  const rootDir = path.join(homedir6(), ".scout/pairing");
   return {
     rootDir,
     configPath: path.join(rootDir, "config.json"),
@@ -11683,7 +11712,7 @@ var init_noise = __esm(() => {
 // ../../apps/desktop/src/core/pairing/runtime/security/identity.ts
 import { existsSync as existsSync10, mkdirSync as mkdirSync4, readFileSync as readFileSync5, writeFileSync as writeFileSync4 } from "fs";
 import { join as join13 } from "path";
-import { homedir as homedir6 } from "os";
+import { homedir as homedir7 } from "os";
 function loadOrCreateIdentity() {
   if (existsSync10(IDENTITY_FILE)) {
     return loadIdentity();
@@ -11745,7 +11774,7 @@ function hexToBytes2(hex) {
 var PAIRING_DIR, IDENTITY_FILE, TRUSTED_PEERS_FILE, QR_VERSION = 1, QR_EXPIRY_MS;
 var init_identity = __esm(() => {
   init_noise();
-  PAIRING_DIR = join13(homedir6(), ".scout/pairing");
+  PAIRING_DIR = join13(homedir7(), ".scout/pairing");
   IDENTITY_FILE = join13(PAIRING_DIR, "identity.json");
   TRUSTED_PEERS_FILE = join13(PAIRING_DIR, "trusted-peers.json");
   QR_EXPIRY_MS = 5 * 60 * 1000;
@@ -12362,7 +12391,7 @@ Referenced files: ${prompt.files.join(", ")}` });
 });
 
 // ../../apps/desktop/src/core/pairing/runtime/adapters/codex.ts
-import { homedir as homedir7 } from "node:os";
+import { homedir as homedir8 } from "node:os";
 import { join as join14 } from "node:path";
 var CodexAdapter, createAdapter2 = (config) => new CodexAdapter(config);
 var init_codex = __esm(() => {
@@ -12463,7 +12492,7 @@ var init_codex = __esm(() => {
       this.setStatus("closed");
     }
     get codexOptions() {
-      const runtimeRoot = join14(homedir7(), ".scout/pairing", "codex", this.session.id);
+      const runtimeRoot = join14(homedir8(), ".scout/pairing", "codex", this.session.id);
       return {
         agentName: this.session.name,
         sessionId: this.session.id,
@@ -13937,7 +13966,7 @@ class StateTracker {
 // ../../apps/desktop/src/core/pairing/runtime/bridge/log.ts
 import { appendFileSync, mkdirSync as mkdirSync6 } from "fs";
 import { join as join15 } from "path";
-import { homedir as homedir8 } from "os";
+import { homedir as homedir9 } from "os";
 function write(level, category, message, data) {
   const ts = new Date().toISOString().slice(11, 23);
   const lvl = level.toUpperCase().padEnd(5);
@@ -13953,7 +13982,7 @@ function write(level, category, message, data) {
 }
 var LOG_DIR, LOG_FILE, log;
 var init_log = __esm(() => {
-  LOG_DIR = join15(homedir8(), ".scout/pairing");
+  LOG_DIR = join15(homedir9(), ".scout/pairing");
   LOG_FILE = join15(LOG_DIR, "bridge.log");
   mkdirSync6(LOG_DIR, { recursive: true });
   log = {
@@ -14119,7 +14148,7 @@ var init_bridge = __esm(() => {
 // ../../apps/desktop/src/core/pairing/runtime/bridge/config.ts
 import { existsSync as existsSync12, readFileSync as readFileSync7 } from "fs";
 import { join as join16 } from "path";
-import { homedir as homedir9 } from "os";
+import { homedir as homedir10 } from "os";
 function loadConfigFile() {
   if (!existsSync12(CONFIG_FILE)) {
     return {};
@@ -14182,17 +14211,17 @@ var init_config2 = __esm(() => {
     port: 7888,
     secure: true
   };
-  CONFIG_DIR = join16(homedir9(), ".scout/pairing");
+  CONFIG_DIR = join16(homedir10(), ".scout/pairing");
   CONFIG_FILE = join16(CONFIG_DIR, "config.json");
 });
 
 // ../../apps/desktop/src/core/pairing/runtime/bridge/fileserver.ts
 import { isAbsolute as isAbsolute2 } from "path";
-import { homedir as homedir10 } from "os";
+import { homedir as homedir11 } from "os";
 function isAllowedPath(filePath) {
   if (!isAbsolute2(filePath))
     return false;
-  const relToHome = filePath.slice(homedir10().length + 1);
+  const relToHome = filePath.slice(homedir11().length + 1);
   if (relToHome.startsWith(".") && !relToHome.startsWith(".claude") && !relToHome.startsWith(".scout/pairing")) {
     return false;
   }
@@ -14251,7 +14280,7 @@ function serveFile(url) {
 }
 var ALLOWED_ROOTS;
 var init_fileserver = __esm(() => {
-  ALLOWED_ROOTS = [homedir10(), "/tmp"];
+  ALLOWED_ROOTS = [homedir11(), "/tmp"];
 });
 
 // ../../apps/desktop/src/core/mobile/service.ts
@@ -14781,7 +14810,7 @@ var init_service4 = __esm(async () => {
 import { readdirSync, readFileSync as readFileSync8, realpathSync, statSync as statSync2 } from "fs";
 import { execSync as execSync2 } from "child_process";
 import { basename as basename7, isAbsolute as isAbsolute3, join as join17, relative as relative2 } from "path";
-import { homedir as homedir11 } from "os";
+import { homedir as homedir12 } from "os";
 async function handleRPC(bridge, req, deviceId) {
   const rpcStart = Date.now();
   const paramsSnippet = summarizeRPCParams(req.method, req.params);
@@ -15192,12 +15221,12 @@ function resolveMobileCurrentDirectory() {
   }
 }
 function resolveWorkspaceRoot(root) {
-  const expandedRoot = root.replace(/^~/, homedir11());
+  const expandedRoot = root.replace(/^~/, homedir12());
   return realpathSync(expandedRoot);
 }
 function resolveWorkspacePath(root, requestedPath) {
   const normalizedRoot = resolveWorkspaceRoot(root);
-  const expandedPath = requestedPath?.replace(/^~/, homedir11());
+  const expandedPath = requestedPath?.replace(/^~/, homedir12());
   const candidate = expandedPath ? isAbsolute3(expandedPath) ? expandedPath : join17(normalizedRoot, expandedPath) : normalizedRoot;
   const resolvedCandidate = realpathSync(candidate);
   const rel = relative2(normalizedRoot, resolvedCandidate);
@@ -15236,7 +15265,7 @@ function listDirectories(dirPath) {
   return entries.sort((a, b) => a.name.localeCompare(b.name));
 }
 async function discoverSessionFiles(maxAgeDays, limit) {
-  const home = homedir11();
+  const home = homedir12();
   const results = [];
   const searchPaths = [
     { pattern: `${home}/.claude/projects`, agent: "claude-code" },
@@ -30142,10 +30171,10 @@ var init_zod = __esm(() => {
 
 // ../../apps/desktop/src/server/db-queries.ts
 import { Database } from "bun:sqlite";
-import { homedir as homedir12 } from "node:os";
+import { homedir as homedir13 } from "node:os";
 import { join as join18 } from "node:path";
 function resolveDbPath() {
-  const controlHome = process.env.OPENSCOUT_CONTROL_HOME ?? join18(homedir12(), ".openscout", "control-plane");
+  const controlHome = process.env.OPENSCOUT_CONTROL_HOME ?? join18(homedir13(), ".openscout", "control-plane");
   return join18(controlHome, "control-plane.sqlite");
 }
 function db() {
@@ -30307,14 +30336,14 @@ function queryMobileWorkspaces(limit = 50) {
 }
 var _db = null, HOME;
 var init_db_queries = __esm(() => {
-  HOME = homedir12();
+  HOME = homedir13();
 });
 
 // ../../apps/desktop/src/core/pairing/runtime/bridge/router.ts
 import { readFileSync as readFileSync9, readdirSync as readdirSync2, realpathSync as realpathSync2, statSync as statSync3 } from "fs";
 import { execSync as execSync3 } from "child_process";
 import { basename as basename8, isAbsolute as isAbsolute4, join as join19, relative as relative3 } from "path";
-import { homedir as homedir13 } from "os";
+import { homedir as homedir14 } from "os";
 function resolveMobileCurrentDirectory2() {
   const config2 = resolveConfig();
   const configuredRoot = config2.workspace?.root;
@@ -30327,12 +30356,12 @@ function resolveMobileCurrentDirectory2() {
   }
 }
 function resolveWorkspaceRoot2(root) {
-  const expandedRoot = root.replace(/^~/, homedir13());
+  const expandedRoot = root.replace(/^~/, homedir14());
   return realpathSync2(expandedRoot);
 }
 function resolveWorkspacePath2(root, requestedPath) {
   const normalizedRoot = resolveWorkspaceRoot2(root);
-  const expandedPath = requestedPath?.replace(/^~/, homedir13());
+  const expandedPath = requestedPath?.replace(/^~/, homedir14());
   const candidate = expandedPath ? isAbsolute4(expandedPath) ? expandedPath : join19(normalizedRoot, expandedPath) : normalizedRoot;
   const resolvedCandidate = realpathSync2(candidate);
   const rel = relative3(normalizedRoot, resolvedCandidate);
@@ -30387,7 +30416,7 @@ function detectAgent2(filePath) {
   return "unknown";
 }
 async function discoverSessionFiles2(maxAgeDays, limit) {
-  const home = homedir13();
+  const home = homedir14();
   const results = [];
   const searchPaths = [
     { pattern: `${home}/.claude/projects`, agent: "claude-code" },
@@ -34969,14 +34998,14 @@ var init_observable = __esm(() => {
 
 // ../../apps/desktop/src/core/pairing/runtime/bridge/server-trpc.ts
 import { realpathSync as realpathSync3 } from "fs";
-import { homedir as homedir14 } from "os";
+import { homedir as homedir15 } from "os";
 function resolveCurrentDirectory() {
   try {
     const config2 = resolveConfig();
     const configuredRoot = config2.workspace?.root;
     if (!configuredRoot)
       return process.cwd();
-    const expanded = configuredRoot.replace(/^~/, homedir14());
+    const expanded = configuredRoot.replace(/^~/, homedir15());
     return realpathSync3(expanded);
   } catch {
     return process.cwd();
@@ -35392,7 +35421,7 @@ var init_server_trpc = __esm(async () => {
 });
 
 // ../../apps/desktop/src/core/pairing/runtime/runtime.ts
-import { homedir as homedir15 } from "node:os";
+import { homedir as homedir16 } from "node:os";
 function createPairingAdapterRegistry(configAdapters) {
   const adapters = {
     "claude-code": createAdapter,
@@ -35469,7 +35498,7 @@ async function autoStartConfiguredSessions(bridge, sessions3) {
     try {
       const session = await bridge.createSession(entry.adapter, {
         name: entry.name,
-        cwd: entry.cwd?.replace(/^~/, homedir15()),
+        cwd: entry.cwd?.replace(/^~/, homedir16()),
         options: entry.options
       });
       console.log(`[bridge] session started: ${session.name} (${entry.adapter})`);
@@ -35745,7 +35774,7 @@ var BRIDGE_ABSENCE_GRACE_MS = 30000, ROOM_IDLE_TIMEOUT_MS = 60000;
 // ../../apps/desktop/src/core/pairing/runtime/relay-runtime.ts
 import { execSync as execSync4 } from "node:child_process";
 import { existsSync as existsSync13, mkdirSync as mkdirSync8, readdirSync as readdirSync3 } from "node:fs";
-import { homedir as homedir16 } from "node:os";
+import { homedir as homedir17 } from "node:os";
 import { join as join20 } from "node:path";
 function findStoredCerts() {
   if (!existsSync13(PAIRING_DIR2)) {
@@ -35865,7 +35894,7 @@ function startManagedRelay(port = 7889) {
 var PAIRING_DIR2;
 var init_relay_runtime = __esm(() => {
   init_log2();
-  PAIRING_DIR2 = join20(homedir16(), ".scout/pairing");
+  PAIRING_DIR2 = join20(homedir17(), ".scout/pairing");
 });
 
 // ../../node_modules/.bun/uqr@0.1.3/node_modules/uqr/dist/index.mjs
@@ -36838,7 +36867,7 @@ __export(exports_server, {
 import { spawn as spawn4 } from "node:child_process";
 import { existsSync as existsSync14 } from "node:fs";
 import { dirname as dirname8, join as join21 } from "node:path";
-import { fileURLToPath as fileURLToPath6 } from "node:url";
+import { fileURLToPath as fileURLToPath7 } from "node:url";
 function renderServerCommandHelp() {
   return [
     "scout server — desktop web UI (Bun runtime)",
@@ -36866,24 +36895,24 @@ function renderServerCommandHelp() {
 `);
 }
 function resolveScoutWebServerEntry() {
-  const mainDir = dirname8(fileURLToPath6(import.meta.url));
+  const mainDir = dirname8(fileURLToPath7(import.meta.url));
   const bundled = join21(mainDir, "scout-web-server.mjs");
   if (existsSync14(bundled)) {
     return bundled;
   }
-  const source = fileURLToPath6(new URL("../../server/index.ts", import.meta.url));
+  const source = fileURLToPath7(new URL("../../server/index.ts", import.meta.url));
   if (existsSync14(source)) {
     return source;
   }
   throw new ScoutCliError("Could not find Scout web server entry. Rebuild @openscout/scout or run from the OpenScout repository.");
 }
 function resolveScoutControlPlaneWebServerEntry() {
-  const mainDir = dirname8(fileURLToPath6(import.meta.url));
+  const mainDir = dirname8(fileURLToPath7(import.meta.url));
   const bundled = join21(mainDir, "scout-control-plane-web.mjs");
   if (existsSync14(bundled)) {
     return bundled;
   }
-  const source = fileURLToPath6(new URL("../../server/control-plane-index.ts", import.meta.url));
+  const source = fileURLToPath7(new URL("../../server/control-plane-index.ts", import.meta.url));
   if (existsSync14(source)) {
     return source;
   }
@@ -37315,7 +37344,7 @@ function findScoutCommandRegistration(name) {
 }
 
 // ../../apps/desktop/src/cli/help.ts
-function renderScoutHelp(version2 = "0.2.16") {
+function renderScoutHelp(version2 = "0.2.17") {
   const commandLines = listScoutPrimaryCommands().map((command) => `  ${command.name.padEnd(12, " ")} ${command.summary}`).join(`
 `);
   const deprecatedLines = listScoutDeprecatedCommands().map((command) => `  ${command.name.padEnd(12, " ")} ${command.summary}`).join(`
@@ -37353,7 +37382,7 @@ function renderScoutHelp(version2 = "0.2.16") {
 init_options();
 
 // ../../apps/desktop/src/shared/product.ts
-var SCOUT_APP_VERSION = "0.2.16";
+var SCOUT_APP_VERSION = "0.2.17";
 
 // ../../apps/desktop/src/cli/main.ts
 async function main2() {

package/dist/scout-control-plane-web.mjs

@@ -4141,6 +4141,12 @@ function findGlobalRuntimeDir() {
   const bunCandidate = join8(homedir5(), ".bun", "node_modules", "@openscout", "runtime");
   if (isInstalledRuntimePackageDir(bunCandidate))
     return bunCandidate;
+  const bunGlobalCandidate = join8(homedir5(), ".bun", "install", "global", "node_modules", "@openscout", "runtime");
+  if (isInstalledRuntimePackageDir(bunGlobalCandidate))
+    return bunGlobalCandidate;
+  const bunScoutNested = join8(homedir5(), ".bun", "install", "global", "node_modules", "@openscout", "scout", "node_modules", "@openscout", "runtime");
+  if (isInstalledRuntimePackageDir(bunScoutNested))
+    return bunScoutNested;
   return null;
 }
 function findWorkspaceRuntimeDir(startDir) {

package/dist/scout-web-server.mjs

@@ -4760,9 +4760,9 @@ 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 { homedir as homedir4 } from "os";
+import { homedir as homedir5 } from "os";
 import { basename as basename3, dirname as dirname5, join as join8, resolve as resolve3 } from "path";
-import { fileURLToPath as fileURLToPath3 } from "url";
+import { fileURLToPath as fileURLToPath4 } from "url";
 function buildDefaultBrokerUrl(host = DEFAULT_BROKER_HOST, port = DEFAULT_BROKER_PORT) {
   return `http://${host}:${port}`;
 }
@@ -4776,16 +4776,22 @@ function runtimePackageDir() {
   const fromCwd = findWorkspaceRuntimeDir(process.cwd());
   if (fromCwd)
     return fromCwd;
-  const moduleDir = dirname5(fileURLToPath3(import.meta.url));
+  const moduleDir = dirname5(fileURLToPath4(import.meta.url));
   return resolve3(moduleDir, "..");
 }
 function isInstalledRuntimePackageDir(candidate) {
   return existsSync4(join8(candidate, "package.json")) && existsSync4(join8(candidate, "bin", "openscout-runtime.mjs"));
 }
 function findGlobalRuntimeDir() {
-  const bunCandidate = join8(homedir4(), ".bun", "node_modules", "@openscout", "runtime");
+  const bunCandidate = join8(homedir5(), ".bun", "node_modules", "@openscout", "runtime");
   if (isInstalledRuntimePackageDir(bunCandidate))
     return bunCandidate;
+  const bunGlobalCandidate = join8(homedir5(), ".bun", "install", "global", "node_modules", "@openscout", "runtime");
+  if (isInstalledRuntimePackageDir(bunGlobalCandidate))
+    return bunGlobalCandidate;
+  const bunScoutNested = join8(homedir5(), ".bun", "install", "global", "node_modules", "@openscout", "scout", "node_modules", "@openscout", "runtime");
+  if (isInstalledRuntimePackageDir(bunScoutNested))
+    return bunScoutNested;
   return null;
 }
 function findWorkspaceRuntimeDir(startDir) {
@@ -4816,7 +4822,7 @@ function resolveBunExecutable() {
       return candidate;
     }
   }
-  const homeBun = join8(homedir4(), ".bun", "bin", "bun");
+  const homeBun = join8(homedir5(), ".bun", "bin", "bun");
   if (existsSync4(homeBun)) {
     return homeBun;
   }
@@ -4865,7 +4871,7 @@ function resolveBrokerServiceConfig() {
   const brokerHost = process.env.OPENSCOUT_BROKER_HOST ?? DEFAULT_BROKER_HOST;
   const brokerPort = Number.parseInt(process.env.OPENSCOUT_BROKER_PORT ?? String(DEFAULT_BROKER_PORT), 10);
   const brokerUrl = process.env.OPENSCOUT_BROKER_URL ?? buildDefaultBrokerUrl(brokerHost, brokerPort);
-  const launchAgentPath = join8(homedir4(), "Library", "LaunchAgents", `${label}.plist`);
+  const launchAgentPath = join8(homedir5(), "Library", "LaunchAgents", `${label}.plist`);
   return {
     label,
     mode,
@@ -4894,7 +4900,7 @@ function renderLaunchAgentPlist(config) {
     OPENSCOUT_CONTROL_HOME: config.controlHome,
     OPENSCOUT_BROKER_SERVICE_MODE: config.mode,
     OPENSCOUT_BROKER_SERVICE_LABEL: config.label,
-    HOME: homedir4(),
+    HOME: homedir5(),
     PATH: launchPath,
     ...collectOptionalEnvVars([
       "OPENSCOUT_MESH_ID",
@@ -4956,7 +4962,7 @@ function collectOptionalEnvVars(keys) {
 function resolveLaunchAgentPATH() {
   const entries = [
     ...(process.env.PATH ?? "").split(":").filter(Boolean),
-    join8(homedir4(), ".bun", "bin"),
+    join8(homedir5(), ".bun", "bin"),
     "/opt/homebrew/bin",
     "/usr/local/bin",
     "/usr/bin",
@@ -5227,7 +5233,7 @@ var DEFAULT_BROKER_HOST = "127.0.0.1", DEFAULT_BROKER_PORT = 65535, BROKER_SERVI
 var init_broker_service = __esm(async () => {
   init_support_paths();
   DEFAULT_BROKER_URL = buildDefaultBrokerUrl();
-  if (process.argv[1] && fileURLToPath3(import.meta.url) === process.argv[1]) {
+  if (process.argv[1] && fileURLToPath4(import.meta.url) === process.argv[1]) {
     await main();
   }
 });
@@ -5247,7 +5253,7 @@ import { execFileSync as execFileSync3, execSync } from "child_process";
 import { existsSync as existsSync5, readFileSync as readFileSync2 } 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 fileURLToPath4 } from "url";
+import { fileURLToPath as fileURLToPath5 } from "url";
 function resolveRelayHub() {
   return resolveOpenScoutSupportPaths().relayHubDirectory;
 }
@@ -6381,7 +6387,7 @@ var init_local_agents = __esm(async () => {
   init_local_agent_template();
   await init_broker_service();
   BUILT_IN_LOCAL_AGENT_IDS = new Set(["scout", "builder", "reviewer", "research"]);
-  MODULE_DIRECTORY = dirname6(fileURLToPath4(import.meta.url));
+  MODULE_DIRECTORY = dirname6(fileURLToPath5(import.meta.url));
   OPENSCOUT_REPO_ROOT = resolve4(MODULE_DIRECTORY, "..", "..", "..");
   DEFAULT_LOCAL_AGENT_CAPABILITIES = ["chat", "invoke", "deliver"];
   SUPPORTED_LOCAL_AGENT_HARNESSES = ["claude", "codex"];
@@ -6389,7 +6395,7 @@ var init_local_agents = __esm(async () => {
 
 // apps/desktop/src/server/create-scout-web-server.ts
 import { dirname as dirname9, resolve as resolve7 } from "path";
-import { fileURLToPath as fileURLToPath6 } from "url";
+import { fileURLToPath as fileURLToPath7 } from "url";
 
 // node_modules/.bun/hono@4.12.10/node_modules/hono/dist/compose.js
 var compose = (middleware, onError, onNotFound) => {
@@ -7934,7 +7940,7 @@ init_setup();
 
 // apps/desktop/src/shared/product.ts
 var SCOUT_PRODUCT_NAME = "Scout";
-var SCOUT_APP_VERSION = "0.2.16";
+var SCOUT_APP_VERSION = "0.2.17";
 
 // apps/desktop/src/shared/surface-capabilities.ts
 function resolveScoutSurfaceCapabilities(surface) {
@@ -7982,6 +7988,8 @@ import path3 from "path";
 import { spawn } from "child_process";
 import { basename as basename2, dirname as dirname4, join as join5 } from "path";
 import { existsSync as existsSync3 } from "fs";
+import { fileURLToPath as fileURLToPath3 } from "url";
+import { homedir as homedir4 } from "os";
 function tryWhich(executableName) {
   const pathEnv = process.env.PATH ?? "";
   const sep = process.platform === "win32" ? ";" : ":";
@@ -8002,6 +8010,23 @@ function tryWhich(executableName) {
   }
   return null;
 }
+function findNodeModulesRuntimeBin() {
+  const runtimeBinRel = join5("node_modules", "@openscout", "runtime", "bin", "openscout-runtime.mjs");
+  let dir = dirname4(fileURLToPath3(import.meta.url));
+  for (let i = 0;i < 24; i++) {
+    const candidate = join5(dir, runtimeBinRel);
+    if (existsSync3(candidate))
+      return candidate;
+    const parent = dirname4(dir);
+    if (parent === dir)
+      break;
+    dir = parent;
+  }
+  const bunGlobal = join5(homedir4(), ".bun", "install", "global", "node_modules", "@openscout", "runtime", "bin", "openscout-runtime.mjs");
+  if (existsSync3(bunGlobal))
+    return bunGlobal;
+  return null;
+}
 function findMonorepoOpenscoutRuntimeBin() {
   let dir = process.cwd();
   for (let i = 0;i < 24; i++) {
@@ -8058,6 +8083,10 @@ function resolveRuntimeServiceEntrypoint() {
   if (onPath) {
     return onPath;
   }
+  const fromNodeModules = findNodeModulesRuntimeBin();
+  if (fromNodeModules) {
+    return fromNodeModules;
+  }
   const monorepo = findMonorepoOpenscoutRuntimeBin();
   if (monorepo) {
     return monorepo;
@@ -8638,7 +8667,7 @@ import path2 from "path";
 
 // apps/desktop/src/app/desktop/shell-utils.ts
 import { execFileSync as execFileSync4 } from "child_process";
-import { homedir as homedir5 } from "os";
+import { homedir as homedir6 } from "os";
 import path from "path";
 function normalizeTimestamp(value) {
   if (!value)
@@ -8689,15 +8718,15 @@ function formatDateTimeLabel(value) {
 function compactHomePath2(value) {
   if (!value)
     return null;
-  const home = homedir5();
+  const home = homedir6();
   return value.startsWith(home) ? value.replace(home, "~") : value;
 }
 function expandHomePath4(value) {
   if (value === "~") {
-    return homedir5();
+    return homedir6();
   }
   if (value.startsWith("~/")) {
-    return path.join(homedir5(), value.slice(2));
+    return path.join(homedir6(), value.slice(2));
   }
   return value;
 }
@@ -11625,7 +11654,7 @@ import path5 from "path";
 // apps/desktop/src/shared/paths.ts
 import { existsSync as existsSync7, readFileSync as readFileSync4 } from "fs";
 import { dirname as dirname7, join as join10, resolve as resolve5 } from "path";
-import { fileURLToPath as fileURLToPath5 } from "url";
+import { fileURLToPath as fileURLToPath6 } from "url";
 function looksLikeWorkspaceRoot(candidate) {
   const packageJsonPath = join10(candidate, "package.json");
   if (!existsSync7(packageJsonPath)) {
@@ -11679,7 +11708,7 @@ function findMatchingAncestor(startDirectory, predicate) {
   }
 }
 function defaultModuleDirectory() {
-  return dirname7(fileURLToPath5(import.meta.url));
+  return dirname7(fileURLToPath6(import.meta.url));
 }
 function uniqueResolutionStarts(options) {
   const starts = [
@@ -11744,7 +11773,7 @@ import {
   unlinkSync,
   writeFileSync as writeFileSync3
 } from "fs";
-import { homedir as homedir6 } from "os";
+import { homedir as homedir7 } from "os";
 import { join as join11 } from "path";
 
 // apps/desktop/src/core/pairing/runtime/protocol/approval-normalization.ts
@@ -11829,7 +11858,7 @@ var SCOUT_PAIRING_RUNTIME_SCRIPT = "pair-supervisor.ts";
 var SCOUT_PAIRING_BRIDGE_CONNECT_TIMEOUT_MS = 1500;
 var SCOUT_PAIRING_BRIDGE_REQUEST_TIMEOUT_MS = 2500;
 function resolveScoutPairingPaths() {
-  const rootDir = join11(homedir6(), SCOUT_PAIRING_HOME_DIRECTORY);
+  const rootDir = join11(homedir7(), SCOUT_PAIRING_HOME_DIRECTORY);
   return {
     rootDir,
     configPath: join11(rootDir, SCOUT_PAIRING_CONFIG_FILE),
@@ -12211,12 +12240,12 @@ function resolveScoutBunExecutable() {
   }
   const pathEntries = (process.env.PATH ?? "").split(":").filter(Boolean);
   const commonDirectories = [
-    join11(homedir6(), ".bun", "bin"),
+    join11(homedir7(), ".bun", "bin"),
     "/opt/homebrew/bin",
     "/usr/local/bin"
   ];
   for (const directory of [...pathEntries, ...commonDirectories]) {
-    const candidate = join11(directory.replace(/^~(?=$|\/)/, homedir6()), "bun");
+    const candidate = join11(directory.replace(/^~(?=$|\/)/, homedir7()), "bun");
     if (isExecutable2(candidate)) {
       return candidate;
     }
@@ -12449,7 +12478,7 @@ init_support_paths();
 await init_local_agents();
 import { spawn as spawn5 } from "child_process";
 import { existsSync as existsSync9 } from "fs";
-import { homedir as homedir7 } from "os";
+import { homedir as homedir8 } from "os";
 import path4 from "path";
 
 // apps/desktop/src/core/telegram/bindings.ts
@@ -12578,12 +12607,12 @@ function resolveScoutElectronScoutExecutable() {
   }
   const pathEntries = (process.env.PATH ?? "").split(":").filter(Boolean);
   const commonDirectories = [
-    path4.join(homedir7(), ".bun", "bin"),
+    path4.join(homedir8(), ".bun", "bin"),
     "/opt/homebrew/bin",
     "/usr/local/bin"
   ];
   for (const directory of [...pathEntries, ...commonDirectories]) {
-    const candidate = path4.join(directory.replace(/^~(?=$|\/)/, homedir7()), SCOUT_ELECTRON_OPENER);
+    const candidate = path4.join(directory.replace(/^~(?=$|\/)/, homedir8()), SCOUT_ELECTRON_OPENER);
     if (isExecutable3(candidate)) {
       return candidate;
     }
@@ -15580,7 +15609,7 @@ function registerScoutWebAssets(app, options) {
 
 // apps/desktop/src/server/create-scout-web-server.ts
 function defaultMonorepoStaticClientRoot(moduleUrl = import.meta.url) {
-  return resolve7(dirname9(fileURLToPath6(moduleUrl)), "../../../../packages/electron-app/dist/client");
+  return resolve7(dirname9(fileURLToPath7(moduleUrl)), "../../../../packages/electron-app/dist/client");
 }
 function parseOptionalPositiveInt(value, fallback) {
   if (typeof value !== "string" || value.trim().length === 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openscout/scout",
-  "version": "0.2.16",
+  "version": "0.2.17",
   "description": "Published Scout package that installs the `scout` command",
   "license": "UNLICENSED",
   "type": "module",
@@ -22,6 +22,6 @@
     "access": "public"
   },
   "dependencies": {
-    "@openscout/runtime": "0.2.16"
+    "@openscout/runtime": "0.2.17"
   }
 }