@adhdev/daemon-core 0.8.25 → 0.8.28

package/dist/index.mjs

@@ -233,7 +233,7 @@ var init_config = __esm({
 
 // src/logging/logger.ts
 import * as fs2 from "fs";
-import * as path4 from "path";
+import * as path6 from "path";
 import * as os4 from "os";
 function setLogLevel(level) {
   currentLevel = level;
@@ -249,13 +249,13 @@ function getDaemonLogDir() {
   return LOG_DIR;
 }
 function getCurrentDaemonLogPath(date = /* @__PURE__ */ new Date()) {
-  return path4.join(LOG_DIR, `daemon-${date.toISOString().slice(0, 10)}.log`);
+  return path6.join(LOG_DIR, `daemon-${date.toISOString().slice(0, 10)}.log`);
 }
 function checkDateRotation() {
   const today = getDateStr();
   if (today !== currentDate) {
     currentDate = today;
-    currentLogFile = path4.join(LOG_DIR, `daemon-${currentDate}.log`);
+    currentLogFile = path6.join(LOG_DIR, `daemon-${currentDate}.log`);
     cleanOldLogs();
   }
 }
@@ -269,7 +269,7 @@ function cleanOldLogs() {
       const dateMatch = file.match(/daemon-(\d{4}-\d{2}-\d{2})/);
       if (dateMatch && dateMatch[1] < cutoffStr) {
         try {
-          fs2.unlinkSync(path4.join(LOG_DIR, file));
+          fs2.unlinkSync(path6.join(LOG_DIR, file));
         } catch {
         }
       }
@@ -393,7 +393,7 @@ var init_logger = __esm({
     LEVEL_NUM = { debug: 0, info: 1, warn: 2, error: 3 };
     LEVEL_LABEL = { debug: "DBG", info: "INF", warn: "WRN", error: "ERR" };
     currentLevel = "info";
-    LOG_DIR = process.platform === "win32" ? path4.join(process.env.LOCALAPPDATA || process.env.APPDATA || path4.join(os4.homedir(), "AppData", "Local"), "adhdev", "logs") : process.platform === "darwin" ? path4.join(os4.homedir(), "Library", "Logs", "adhdev") : path4.join(os4.homedir(), ".local", "share", "adhdev", "logs");
+    LOG_DIR = process.platform === "win32" ? path6.join(process.env.LOCALAPPDATA || process.env.APPDATA || path6.join(os4.homedir(), "AppData", "Local"), "adhdev", "logs") : process.platform === "darwin" ? path6.join(os4.homedir(), "Library", "Logs", "adhdev") : path6.join(os4.homedir(), ".local", "share", "adhdev", "logs");
     MAX_LOG_SIZE = 5 * 1024 * 1024;
     MAX_LOG_DAYS = 7;
     try {
@@ -401,16 +401,16 @@ var init_logger = __esm({
     } catch {
     }
     currentDate = getDateStr();
-    currentLogFile = path4.join(LOG_DIR, `daemon-${currentDate}.log`);
+    currentLogFile = path6.join(LOG_DIR, `daemon-${currentDate}.log`);
     cleanOldLogs();
     try {
-      const oldLog = path4.join(LOG_DIR, "daemon.log");
+      const oldLog = path6.join(LOG_DIR, "daemon.log");
       if (fs2.existsSync(oldLog)) {
         const stat = fs2.statSync(oldLog);
         const oldDate = stat.mtime.toISOString().slice(0, 10);
-        fs2.renameSync(oldLog, path4.join(LOG_DIR, `daemon-${oldDate}.log`));
+        fs2.renameSync(oldLog, path6.join(LOG_DIR, `daemon-${oldDate}.log`));
       }
-      const oldLogBackup = path4.join(LOG_DIR, "daemon.log.old");
+      const oldLogBackup = path6.join(LOG_DIR, "daemon.log.old");
       if (fs2.existsSync(oldLogBackup)) {
         fs2.unlinkSync(oldLogBackup);
       }
@@ -442,7 +442,7 @@ var init_logger = __esm({
       }
     };
     interceptorInstalled = false;
-    LOG_PATH = path4.join(LOG_DIR, `daemon-${getDateStr()}.log`);
+    LOG_PATH = path6.join(LOG_DIR, `daemon-${getDateStr()}.log`);
   }
 });
 
@@ -802,7 +802,7 @@ __export(provider_cli_adapter_exports, {
   normalizeCliProviderForRuntime: () => normalizeCliProviderForRuntime
 });
 import * as os8 from "os";
-import * as path7 from "path";
+import * as path9 from "path";
 import { execSync as execSync3 } from "child_process";
 function stripAnsi(str) {
   return str.replace(/\x1B\][^\x07]*\x07/g, "").replace(/\x1B\][\s\S]*?\x1B\\/g, "").replace(/\x1B[P^_X][\s\S]*?(?:\x07|\x1B\\)/g, "").replace(/\x1B\[\d*[A-HJKSTfG]/g, " ").replace(/\x1B(?:[@-Z\\-_]|\[[0-?]*[ -/]*[@-~])/g, "").replace(/  +/g, " ");
@@ -873,16 +873,22 @@ function computeTerminalQueryTail(buffer) {
   return "";
 }
 function findBinary(name) {
+  const trimmed = String(name || "").trim();
+  if (!trimmed) return trimmed;
+  const expanded = trimmed.startsWith("~") ? path9.join(os8.homedir(), trimmed.slice(1)) : trimmed;
+  if (path9.isAbsolute(expanded) || expanded.includes("/") || expanded.includes("\\")) {
+    return path9.isAbsolute(expanded) ? expanded : path9.resolve(expanded);
+  }
   const isWin = os8.platform() === "win32";
   try {
-    const cmd = isWin ? `where ${name}` : `which ${name}`;
+    const cmd = isWin ? `where ${trimmed}` : `which ${trimmed}`;
     return execSync3(cmd, { encoding: "utf-8", timeout: 5e3, stdio: ["pipe", "pipe", "pipe"] }).trim().split("\n")[0].trim();
   } catch {
-    return isWin ? `${name}.cmd` : name;
+    return isWin ? `${trimmed}.cmd` : trimmed;
   }
 }
 function isScriptBinary(binaryPath) {
-  if (!path7.isAbsolute(binaryPath)) return false;
+  if (!path9.isAbsolute(binaryPath)) return false;
   try {
     const fs15 = __require("fs");
     const resolved = fs15.realpathSync(binaryPath);
@@ -898,7 +904,7 @@ function isScriptBinary(binaryPath) {
   }
 }
 function looksLikeMachOOrElf(filePath) {
-  if (!path7.isAbsolute(filePath)) return false;
+  if (!path9.isAbsolute(filePath)) return false;
   try {
     const fs15 = __require("fs");
     const resolved = fs15.realpathSync(filePath);
@@ -1379,16 +1385,17 @@ var init_provider_cli_adapter = __esm({
       async spawn() {
         if (this.ptyProcess) return;
         const { spawn: spawnConfig } = this.provider;
-        const binaryPath = findBinary(spawnConfig.command);
+        const configuredCommand = typeof this.runtimeSettings.executablePath === "string" && this.runtimeSettings.executablePath.trim() ? this.runtimeSettings.executablePath.trim() : spawnConfig.command;
+        const binaryPath = findBinary(configuredCommand);
         const isWin = os8.platform() === "win32";
         const allArgs = [...spawnConfig.args, ...this.extraArgs];
         LOG.info("CLI", `[${this.cliType}] Spawning in ${this.workingDir}`);
         this.resetTraceSession();
         let shellCmd;
         let shellArgs;
-        const useShellUnix = !isWin && (!!spawnConfig.shell || !path7.isAbsolute(binaryPath) || isScriptBinary(binaryPath) || !looksLikeMachOOrElf(binaryPath));
+        const useShellUnix = !isWin && (!!spawnConfig.shell || !path9.isAbsolute(binaryPath) || isScriptBinary(binaryPath) || !looksLikeMachOOrElf(binaryPath));
         const isCmdShim = isWin && /\.(cmd|bat)$/i.test(binaryPath);
-        const useShellWin = !!spawnConfig.shell || isCmdShim || !path7.isAbsolute(binaryPath) || isScriptBinary(binaryPath);
+        const useShellWin = !!spawnConfig.shell || isCmdShim || !path9.isAbsolute(binaryPath) || isScriptBinary(binaryPath);
         const useShell = isWin ? useShellWin : useShellUnix;
         if (useShell) {
           if (!spawnConfig.shell && !isWin) {
@@ -1762,7 +1769,7 @@ var init_provider_cli_adapter = __esm({
               `[${this.cliType}] Waiting for interactive prompt: hasPrompt=${hasPrompt} stableMs=${stableMs} recentOutputMs=${recentlyOutput} status=${status} startup=${startupLikelyActive} screen=${JSON.stringify(this.summarizeTraceText(screenText, 220)).slice(0, 260)}`
             );
           }
-          await new Promise((resolve9) => setTimeout(resolve9, 50));
+          await new Promise((resolve12) => setTimeout(resolve12, 50));
         }
         const finalScreenText = this.terminalScreen.getText() || "";
         LOG.warn(
@@ -2273,7 +2280,7 @@ ${data.message || ""}`.trim();
           const deadline = Date.now() + 1e4;
           while (this.startupParseGate && Date.now() < deadline) {
             this.resolveStartupState("send_wait");
-            await new Promise((resolve9) => setTimeout(resolve9, 50));
+            await new Promise((resolve12) => setTimeout(resolve12, 50));
           }
         }
         await this.waitForInteractivePrompt();
@@ -2498,17 +2505,17 @@ ${data.message || ""}`.trim();
         }
       }
       waitForStopped(timeoutMs) {
-        return new Promise((resolve9) => {
+        return new Promise((resolve12) => {
           const startedAt = Date.now();
           const timer = setInterval(() => {
             if (!this.ptyProcess || this.currentStatus === "stopped") {
               clearInterval(timer);
-              resolve9(true);
+              resolve12(true);
               return;
             }
             if (Date.now() - startedAt >= timeoutMs) {
               clearInterval(timer);
-              resolve9(false);
+              resolve12(false);
             }
           }, 100);
         });
@@ -3124,6 +3131,7 @@ function resetState() {
 import { execSync } from "child_process";
 import { existsSync as existsSync4 } from "fs";
 import { platform, homedir as homedir3 } from "os";
+import * as path4 from "path";
 var BUILTIN_IDE_DEFINITIONS = [];
 var registeredIDEs = /* @__PURE__ */ new Map();
 function registerIDEDefinition(def) {
@@ -3140,9 +3148,16 @@ function getMergedDefinitions() {
   return [...merged.values()];
 }
 function findCliCommand(command) {
+  const trimmed = String(command || "").trim();
+  if (!trimmed) return null;
+  if (path4.isAbsolute(trimmed) || trimmed.includes("/") || trimmed.includes("\\") || trimmed.startsWith("~")) {
+    const candidate = trimmed.startsWith("~") ? path4.join(homedir3(), trimmed.slice(1)) : trimmed;
+    const resolved = path4.isAbsolute(candidate) ? candidate : path4.resolve(candidate);
+    return existsSync4(resolved) ? resolved : null;
+  }
   try {
     const result = execSync(
-      platform() === "win32" ? `where ${command}` : `which ${command}`,
+      platform() === "win32" ? `where ${trimmed}` : `which ${trimmed}`,
       { encoding: "utf-8", timeout: 5e3, stdio: ["pipe", "pipe", "pipe"] }
     ).trim();
     return result.split("\n")[0] || null;
@@ -3165,23 +3180,23 @@ function getIdeVersion(cliCommand) {
 function checkPathExists(paths) {
   const home = homedir3();
   for (const p of paths) {
-    if (p.includes("*")) {
+    const normalized = p.startsWith("~") ? path4.join(home, p.slice(1)) : p;
+    if (normalized.includes("*")) {
       const username = home.split(/[\\/]/).pop() || "";
-      const resolved = p.replace("*", username);
+      const resolved = normalized.replace("*", username);
       if (existsSync4(resolved)) return resolved;
     } else {
-      if (existsSync4(p)) return p;
+      if (existsSync4(normalized)) return normalized;
     }
   }
   return null;
 }
-async function detectIDEs() {
+async function detectIDEs(providerLoader) {
   const os18 = platform();
   const results = [];
   for (const def of getMergedDefinitions()) {
-    const cliPath = findCliCommand(def.cli);
-    const appPath = checkPathExists(def.paths[os18] || []);
-    const installed = !!(cliPath || appPath);
+    const cliPath = findCliCommand(providerLoader?.getIdeCliCommand(def.id, def.cli) || def.cli);
+    const appPath = checkPathExists(providerLoader?.getIdePathCandidates(def.id, def.paths[os18] || []) || []);
     let resolvedCli = cliPath;
     if (!resolvedCli && appPath && os18 === "darwin") {
       const bundledCli = `${appPath}/Contents/Resources/app/bin/${def.cli}`;
@@ -3204,6 +3219,7 @@ async function detectIDEs() {
         }
       }
     }
+    const installed = os18 === "darwin" ? !!(resolvedCli || appPath) : !!resolvedCli;
     const version = resolvedCli ? getIdeVersion(resolvedCli) : null;
     results.push({
       id: def.id,
@@ -3222,48 +3238,77 @@ async function detectIDEs() {
 // src/detection/cli-detector.ts
 import { exec } from "child_process";
 import * as os2 from "os";
+import * as path5 from "path";
+import { existsSync as existsSync5 } from "fs";
 function parseVersion(raw) {
   const match = raw.match(/v?(\d+\.\d+(?:\.\d+)?(?:-[a-zA-Z0-9.]+)?)/);
   return match ? match[1] : raw.split("\n")[0].slice(0, 100);
 }
+function shellQuote(value) {
+  if (/^[a-zA-Z0-9_./:@%+=,-]+$/.test(value)) return value;
+  return `"${value.replace(/(["\\$`])/g, "\\$1")}"`;
+}
+function expandHome(value) {
+  const trimmed = value.trim();
+  if (!trimmed.startsWith("~")) return trimmed;
+  return path5.join(os2.homedir(), trimmed.slice(1));
+}
+function isExplicitCommandPath(command) {
+  const trimmed = command.trim();
+  return path5.isAbsolute(trimmed) || trimmed.includes("/") || trimmed.includes("\\") || trimmed.startsWith("~");
+}
+function resolveCommandPath(command) {
+  const trimmed = command.trim();
+  if (!trimmed) return null;
+  if (isExplicitCommandPath(trimmed)) {
+    const expanded = expandHome(trimmed);
+    const candidate = path5.isAbsolute(expanded) ? expanded : path5.resolve(expanded);
+    return existsSync5(candidate) ? candidate : null;
+  }
+  return null;
+}
 function execAsync(cmd, timeoutMs = 5e3) {
-  return new Promise((resolve9) => {
+  return new Promise((resolve12) => {
     const child = exec(cmd, { encoding: "utf-8", timeout: timeoutMs }, (err, stdout) => {
       if (err || !stdout?.trim()) {
-        resolve9(null);
+        resolve12(null);
       } else {
-        resolve9(stdout.trim());
+        resolve12(stdout.trim());
       }
     });
-    child.on("error", () => resolve9(null));
+    child.on("error", () => resolve12(null));
   });
 }
-async function detectCLIs(providerLoader) {
+async function detectCLIs(providerLoader, options) {
   const platform9 = os2.platform();
   const whichCmd = platform9 === "win32" ? "where" : "which";
+  const includeVersion = options?.includeVersion !== false;
   const cliList = providerLoader ? providerLoader.getCliDetectionList() : [];
   const results = await Promise.all(
     cliList.map(async (cli) => {
       try {
-        const pathResult = await execAsync(`${whichCmd} ${cli.command}`);
+        const explicitPath = resolveCommandPath(cli.command);
+        const pathResult = explicitPath || await execAsync(`${whichCmd} ${shellQuote(cli.command)}`);
         if (!pathResult) return { ...cli, installed: false };
-        const firstPath = pathResult.split("\n")[0];
+        const firstPath = explicitPath || pathResult.split("\n")[0];
         let version;
-        try {
+        if (includeVersion) {
           const versionCommands = [
-            cli.versionCommand,
-            `${cli.command} --version`,
-            `${cli.command} -V`,
-            `${cli.command} -v`
+            `"${firstPath}" --version`,
+            `"${firstPath}" -V`,
+            `"${firstPath}" -v`,
+            cli.versionCommand
           ].filter((v) => !!v);
-          for (const versionCommand of versionCommands) {
-            const versionResult = await execAsync(versionCommand, 3e3);
-            if (versionResult) {
-              version = parseVersion(versionResult);
-              break;
+          try {
+            for (const versionCommand of versionCommands) {
+              const versionResult = await execAsync(versionCommand, 3e3);
+              if (versionResult) {
+                version = parseVersion(versionResult);
+                break;
+              }
             }
+          } catch {
           }
-        } catch {
         }
         return { ...cli, installed: true, version, path: firstPath };
       } catch {
@@ -3273,7 +3318,7 @@ async function detectCLIs(providerLoader) {
   );
   return results;
 }
-async function detectCLI(cliId, providerLoader) {
+async function detectCLI(cliId, providerLoader, options) {
   const resolvedId = providerLoader ? providerLoader.resolveAlias(cliId) : cliId;
   if (providerLoader) {
     const cliList = providerLoader.getCliDetectionList();
@@ -3282,25 +3327,28 @@ async function detectCLI(cliId, providerLoader) {
       const platform9 = os2.platform();
       const whichCmd = platform9 === "win32" ? "where" : "which";
       try {
-        const pathResult = await execAsync(`${whichCmd} ${target.command}`);
+        const explicitPath = resolveCommandPath(target.command);
+        const pathResult = explicitPath || await execAsync(`${whichCmd} ${shellQuote(target.command)}`);
         if (!pathResult) return null;
-        const firstPath = pathResult.split("\n")[0];
+        const firstPath = explicitPath || pathResult.split("\n")[0];
         let version;
-        try {
+        if (options?.includeVersion !== false) {
           const versionCommands = [
-            target.versionCommand,
-            `${target.command} --version`,
-            `${target.command} -V`,
-            `${target.command} -v`
+            `"${firstPath}" --version`,
+            `"${firstPath}" -V`,
+            `"${firstPath}" -v`,
+            target.versionCommand
           ].filter((v) => !!v);
-          for (const versionCommand of versionCommands) {
-            const versionResult = await execAsync(versionCommand, 3e3);
-            if (versionResult) {
-              version = parseVersion(versionResult);
-              break;
+          try {
+            for (const versionCommand of versionCommands) {
+              const versionResult = await execAsync(versionCommand, 3e3);
+              if (versionResult) {
+                version = parseVersion(versionResult);
+                break;
+              }
             }
+          } catch {
           }
-        } catch {
         }
         return { ...target, installed: true, version, path: firstPath };
       } catch {
@@ -3308,7 +3356,7 @@ async function detectCLI(cliId, providerLoader) {
       }
     }
   }
-  const all = await detectCLIs(providerLoader);
+  const all = await detectCLIs(providerLoader, options);
   return all.find((c) => c.id === resolvedId && c.installed) || null;
 }
 
@@ -3435,7 +3483,7 @@ var DaemonCdpManager = class {
   * Returns multiple entries if multiple IDE windows are open on same port
   */
   static listAllTargets(port) {
-    return new Promise((resolve9) => {
+    return new Promise((resolve12) => {
       const req = http.get(`http://127.0.0.1:${port}/json`, (res) => {
         let data = "";
         res.on("data", (chunk) => data += chunk.toString());
@@ -3451,16 +3499,16 @@ var DaemonCdpManager = class {
               (t) => !isNonMain(t.title || "") && t.url?.includes("workbench.html") && !t.url?.includes("agent")
             );
             const fallbackPages = pages.filter((t) => !isNonMain(t.title || ""));
-            resolve9(mainPages.length > 0 ? mainPages : fallbackPages);
+            resolve12(mainPages.length > 0 ? mainPages : fallbackPages);
           } catch {
-            resolve9([]);
+            resolve12([]);
           }
         });
       });
-      req.on("error", () => resolve9([]));
+      req.on("error", () => resolve12([]));
       req.setTimeout(2e3, () => {
         req.destroy();
-        resolve9([]);
+        resolve12([]);
       });
     });
   }
@@ -3500,7 +3548,7 @@ var DaemonCdpManager = class {
     }
   }
   findTargetOnPort(port) {
-    return new Promise((resolve9) => {
+    return new Promise((resolve12) => {
       const req = http.get(`http://127.0.0.1:${port}/json`, (res) => {
         let data = "";
         res.on("data", (chunk) => data += chunk.toString());
@@ -3511,7 +3559,7 @@ var DaemonCdpManager = class {
               (t) => (t.type === "page" || t.type === "browser" || t.type === "Page") && t.webSocketDebuggerUrl
             );
             if (pages.length === 0) {
-              resolve9(targets.find((t) => t.webSocketDebuggerUrl) || null);
+              resolve12(targets.find((t) => t.webSocketDebuggerUrl) || null);
               return;
             }
             const mainPages = pages.filter((t) => !this.isNonMainTitle(t.title || ""));
@@ -3521,24 +3569,24 @@ var DaemonCdpManager = class {
               const specific = list.find((t) => t.id === this._targetId);
               if (specific) {
                 this._pageTitle = specific.title || "";
-                resolve9(specific);
+                resolve12(specific);
               } else {
                 this.log(`[CDP] Target ${this._targetId} not found in page list`);
-                resolve9(null);
+                resolve12(null);
               }
               return;
             }
             this._pageTitle = list[0]?.title || "";
-            resolve9(list[0]);
+            resolve12(list[0]);
           } catch {
-            resolve9(null);
+            resolve12(null);
           }
         });
       });
-      req.on("error", () => resolve9(null));
+      req.on("error", () => resolve12(null));
       req.setTimeout(2e3, () => {
         req.destroy();
-        resolve9(null);
+        resolve12(null);
       });
     });
   }
@@ -3549,7 +3597,7 @@ var DaemonCdpManager = class {
     this.extensionProviders = providers;
   }
   connectToTarget(wsUrl) {
-    return new Promise((resolve9) => {
+    return new Promise((resolve12) => {
       this.ws = new WebSocket(wsUrl);
       this.ws.on("open", async () => {
         this._connected = true;
@@ -3559,17 +3607,17 @@ var DaemonCdpManager = class {
         }
         this.connectBrowserWs().catch(() => {
         });
-        resolve9(true);
+        resolve12(true);
       });
       this.ws.on("message", (data) => {
         try {
           const msg = JSON.parse(data.toString());
           if (msg.id && this.pending.has(msg.id)) {
-            const { resolve: resolve10, reject } = this.pending.get(msg.id);
+            const { resolve: resolve13, reject } = this.pending.get(msg.id);
             this.pending.delete(msg.id);
             this.failureCount = 0;
             if (msg.error) reject(new Error(msg.error.message));
-            else resolve10(msg.result);
+            else resolve13(msg.result);
           } else if (msg.method === "Runtime.executionContextCreated") {
             this.contexts.add(msg.params.context.id);
           } else if (msg.method === "Runtime.executionContextDestroyed") {
@@ -3592,7 +3640,7 @@ var DaemonCdpManager = class {
       this.ws.on("error", (err) => {
         this.log(`[CDP] WebSocket error: ${err.message}`);
         this._connected = false;
-        resolve9(false);
+        resolve12(false);
       });
     });
   }
@@ -3606,7 +3654,7 @@ var DaemonCdpManager = class {
         return;
       }
       this.log(`[CDP] Connecting browser WS for target discovery...`);
-      await new Promise((resolve9, reject) => {
+      await new Promise((resolve12, reject) => {
         this.browserWs = new WebSocket(browserWsUrl);
         this.browserWs.on("open", async () => {
           this._browserConnected = true;
@@ -3616,16 +3664,16 @@ var DaemonCdpManager = class {
           } catch (e) {
             this.log(`[CDP] setDiscoverTargets failed: ${e.message}`);
           }
-          resolve9();
+          resolve12();
         });
         this.browserWs.on("message", (data) => {
           try {
             const msg = JSON.parse(data.toString());
             if (msg.id && this.browserPending.has(msg.id)) {
-              const { resolve: resolve10, reject: reject2 } = this.browserPending.get(msg.id);
+              const { resolve: resolve13, reject: reject2 } = this.browserPending.get(msg.id);
               this.browserPending.delete(msg.id);
               if (msg.error) reject2(new Error(msg.error.message));
-              else resolve10(msg.result);
+              else resolve13(msg.result);
             }
           } catch {
           }
@@ -3645,31 +3693,31 @@ var DaemonCdpManager = class {
     }
   }
   getBrowserWsUrl() {
-    return new Promise((resolve9) => {
+    return new Promise((resolve12) => {
       const req = http.get(`http://127.0.0.1:${this.port}/json/version`, (res) => {
         let data = "";
         res.on("data", (chunk) => data += chunk.toString());
         res.on("end", () => {
           try {
             const info = JSON.parse(data);
-            resolve9(info.webSocketDebuggerUrl || null);
+            resolve12(info.webSocketDebuggerUrl || null);
           } catch {
-            resolve9(null);
+            resolve12(null);
           }
         });
       });
-      req.on("error", () => resolve9(null));
+      req.on("error", () => resolve12(null));
       req.setTimeout(3e3, () => {
         req.destroy();
-        resolve9(null);
+        resolve12(null);
       });
     });
   }
   sendBrowser(method, params = {}, timeoutMs = 15e3) {
-    return new Promise((resolve9, reject) => {
+    return new Promise((resolve12, reject) => {
       if (!this.browserWs || !this._browserConnected) return reject(new Error("Browser WS not connected"));
       const id = this.browserMsgId++;
-      this.browserPending.set(id, { resolve: resolve9, reject });
+      this.browserPending.set(id, { resolve: resolve12, reject });
       this.browserWs.send(JSON.stringify({ id, method, params }));
       setTimeout(() => {
         if (this.browserPending.has(id)) {
@@ -3709,11 +3757,11 @@ var DaemonCdpManager = class {
   }
   // ─── CDP Protocol ────────────────────────────────────────
   sendInternal(method, params = {}, timeoutMs = 15e3) {
-    return new Promise((resolve9, reject) => {
+    return new Promise((resolve12, reject) => {
       if (!this.ws || !this._connected) return reject(new Error("CDP not connected"));
       if (this.ws.readyState !== WebSocket.OPEN) return reject(new Error("WebSocket not open"));
       const id = this.msgId++;
-      this.pending.set(id, { resolve: resolve9, reject });
+      this.pending.set(id, { resolve: resolve12, reject });
       this.ws.send(JSON.stringify({ id, method, params }));
       setTimeout(() => {
         if (this.pending.has(id)) {
@@ -3962,7 +4010,7 @@ var DaemonCdpManager = class {
     const browserWs = this.browserWs;
     let msgId = this.browserMsgId;
     const sendWs = (method, params = {}, sessionId) => {
-      return new Promise((resolve9, reject) => {
+      return new Promise((resolve12, reject) => {
         const mid = msgId++;
         this.browserMsgId = msgId;
         const handler = (raw) => {
@@ -3971,7 +4019,7 @@ var DaemonCdpManager = class {
             if (msg.id === mid) {
               browserWs.removeListener("message", handler);
               if (msg.error) reject(new Error(msg.error.message || JSON.stringify(msg.error)));
-              else resolve9(msg.result);
+              else resolve12(msg.result);
             }
           } catch {
           }
@@ -4162,14 +4210,14 @@ var DaemonCdpManager = class {
     if (!ws || ws.readyState !== WebSocket.OPEN) {
       throw new Error("CDP not connected");
     }
-    return new Promise((resolve9, reject) => {
+    return new Promise((resolve12, reject) => {
       const id = getNextId();
       pendingMap.set(id, {
         resolve: (result) => {
           if (result?.result?.subtype === "error") {
             reject(new Error(result.result.description));
           } else {
-            resolve9(result?.result?.value);
+            resolve12(result?.result?.value);
           }
         },
         reject
@@ -4201,10 +4249,10 @@ var DaemonCdpManager = class {
       throw new Error("CDP not connected");
     }
     const sendViaSession = (method, params = {}) => {
-      return new Promise((resolve9, reject) => {
+      return new Promise((resolve12, reject) => {
         const pendingMap = this._browserConnected ? this.browserPending : this.pending;
         const id = this._browserConnected ? this.browserMsgId++ : this.msgId++;
-        pendingMap.set(id, { resolve: resolve9, reject });
+        pendingMap.set(id, { resolve: resolve12, reject });
         ws.send(JSON.stringify({ id, sessionId, method, params }));
         setTimeout(() => {
           if (pendingMap.has(id)) {
@@ -4832,9 +4880,9 @@ function normalizeControlValue(value) {
 
 // src/config/chat-history.ts
 import * as fs3 from "fs";
-import * as path5 from "path";
+import * as path7 from "path";
 import * as os5 from "os";
-var HISTORY_DIR = path5.join(os5.homedir(), ".adhdev", "history");
+var HISTORY_DIR = path7.join(os5.homedir(), ".adhdev", "history");
 var RETAIN_DAYS = 30;
 var ChatHistoryWriter = class {
   /** Last seen message count per agent (deduplication) */
@@ -4879,11 +4927,11 @@ var ChatHistoryWriter = class {
         });
       }
       if (newMessages.length === 0) return;
-      const dir = path5.join(HISTORY_DIR, this.sanitize(agentType));
+      const dir = path7.join(HISTORY_DIR, this.sanitize(agentType));
       fs3.mkdirSync(dir, { recursive: true });
       const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
       const filePrefix = effectiveHistoryKey ? `${this.sanitize(effectiveHistoryKey)}_` : "";
-      const filePath = path5.join(dir, `${filePrefix}${date}.jsonl`);
+      const filePath = path7.join(dir, `${filePrefix}${date}.jsonl`);
       const lines = newMessages.map((m) => JSON.stringify(m)).join("\n") + "\n";
       fs3.appendFileSync(filePath, lines, "utf-8");
       const prevCount = this.lastSeenCounts.get(dedupKey) || 0;
@@ -4937,14 +4985,14 @@ var ChatHistoryWriter = class {
         this.lastSeenCounts.set(toDedupKey, Math.max(fromCount, this.lastSeenCounts.get(toDedupKey) || 0));
         this.lastSeenCounts.delete(fromDedupKey);
       }
-      const dir = path5.join(HISTORY_DIR, this.sanitize(agentType));
+      const dir = path7.join(HISTORY_DIR, this.sanitize(agentType));
       if (!fs3.existsSync(dir)) return;
       const fromPrefix = `${this.sanitize(fromId)}_`;
       const toPrefix = `${this.sanitize(toId)}_`;
       const files = fs3.readdirSync(dir).filter((file) => file.startsWith(fromPrefix) && file.endsWith(".jsonl"));
       for (const file of files) {
-        const sourcePath = path5.join(dir, file);
-        const targetPath = path5.join(dir, `${toPrefix}${file.slice(fromPrefix.length)}`);
+        const sourcePath = path7.join(dir, file);
+        const targetPath = path7.join(dir, `${toPrefix}${file.slice(fromPrefix.length)}`);
         const sourceLines = fs3.readFileSync(sourcePath, "utf-8").split("\n").filter(Boolean);
         const rewritten = sourceLines.map((line) => {
           try {
@@ -4985,10 +5033,10 @@ var ChatHistoryWriter = class {
       const cutoff = Date.now() - RETAIN_DAYS * 24 * 60 * 60 * 1e3;
       const agentDirs = fs3.readdirSync(HISTORY_DIR, { withFileTypes: true }).filter((d) => d.isDirectory());
       for (const dir of agentDirs) {
-        const dirPath = path5.join(HISTORY_DIR, dir.name);
+        const dirPath = path7.join(HISTORY_DIR, dir.name);
         const files = fs3.readdirSync(dirPath).filter((f) => f.endsWith(".jsonl") || f.endsWith(".terminal.log"));
         for (const file of files) {
-          const filePath = path5.join(dirPath, file);
+          const filePath = path7.join(dirPath, file);
           const stat = fs3.statSync(filePath);
           if (stat.mtimeMs < cutoff) {
             fs3.unlinkSync(filePath);
@@ -5006,7 +5054,7 @@ var ChatHistoryWriter = class {
 function readChatHistory(agentType, offset = 0, limit = 30, historySessionId) {
   try {
     const sanitized = agentType.replace(/[^a-zA-Z0-9_-]/g, "_");
-    const dir = path5.join(HISTORY_DIR, sanitized);
+    const dir = path7.join(HISTORY_DIR, sanitized);
     if (!fs3.existsSync(dir)) return { messages: [], hasMore: false };
     const sanitizedInstance = historySessionId?.replace(/[^a-zA-Z0-9_-]/g, "_");
     const files = fs3.readdirSync(dir).filter((f) => {
@@ -5020,7 +5068,7 @@ function readChatHistory(agentType, offset = 0, limit = 30, historySessionId) {
     const needed = offset + limit + 1;
     for (const file of files) {
       if (allMessages.length >= needed) break;
-      const filePath = path5.join(dir, file);
+      const filePath = path7.join(dir, file);
       const content = fs3.readFileSync(filePath, "utf-8");
       const lines = content.trim().split("\n").filter(Boolean);
       for (let i = lines.length - 1; i >= 0; i--) {
@@ -5042,7 +5090,7 @@ function readChatHistory(agentType, offset = 0, limit = 30, historySessionId) {
 function listSavedHistorySessions(agentType, options = {}) {
   try {
     const sanitized = agentType.replace(/[^a-zA-Z0-9_-]/g, "_");
-    const dir = path5.join(HISTORY_DIR, sanitized);
+    const dir = path7.join(HISTORY_DIR, sanitized);
     if (!fs3.existsSync(dir)) return { sessions: [], hasMore: false };
     const groupedFiles = /* @__PURE__ */ new Map();
     const filePattern = /^([A-Za-z0-9_-]+)_\d{4}-\d{2}-\d{2}\.jsonl$/;
@@ -5063,7 +5111,7 @@ function listSavedHistorySessions(agentType, options = {}) {
       let sessionTitle = "";
       let preview = "";
       for (const file of files.sort()) {
-        const filePath = path5.join(dir, file);
+        const filePath = path7.join(dir, file);
         const content = fs3.readFileSync(filePath, "utf-8");
         const lines = content.split("\n").filter(Boolean);
         for (const line of lines) {
@@ -5116,6 +5164,7 @@ var ExtensionProviderInstance = class {
   currentStatus = "idle";
   agentStreams = [];
   messages = [];
+  prevMessageHashes = /* @__PURE__ */ new Map();
   activeModal = null;
   currentModel = "";
   currentMode = "";
@@ -5181,7 +5230,7 @@ var ExtensionProviderInstance = class {
   onEvent(event, data) {
     if (event === "stream_update") {
       if (data?.streams) this.agentStreams = data.streams;
-      if (data?.messages) this.messages = data.messages;
+      if (data?.messages) this.messages = this.assignReceivedAt(data.messages);
       if (data?.activeModal !== void 0) this.activeModal = data.activeModal;
       if (data?.model) this.currentModel = data.model;
       if (data?.mode) this.currentMode = data.mode;
@@ -5207,6 +5256,7 @@ var ExtensionProviderInstance = class {
   dispose() {
     this.agentStreams = [];
     this.messages = [];
+    this.prevMessageHashes.clear();
     this.monitor.reset();
     this.appliedEffectKeys.clear();
     this.runtimeMessages = [];
@@ -5362,6 +5412,23 @@ var ExtensionProviderInstance = class {
       this.chatId || this.instanceId
     );
   }
+  /**
+   * Assign stable receivedAt to extension messages.
+   * Same pattern as IdeProviderInstance.readChat() prevByHash —
+   * preserves first-seen timestamp across polling cycles.
+   */
+  assignReceivedAt(messages) {
+    const now = Date.now();
+    const nextHashes = /* @__PURE__ */ new Map();
+    for (const msg of messages) {
+      const hash = `${msg.role}:${(msg.content || "").slice(0, 100)}`;
+      const prevTime = this.prevMessageHashes.get(hash);
+      msg.receivedAt = prevTime || now;
+      nextHashes.set(hash, msg.receivedAt);
+    }
+    this.prevMessageHashes = nextHashes;
+    return messages;
+  }
   mergeConversationMessages(messages) {
     if (this.runtimeMessages.length === 0) return messages;
     return [...messages, ...this.runtimeMessages.map((entry) => entry.message)].map((message, index) => ({ message, index })).sort((a, b) => {
@@ -5418,6 +5485,7 @@ ${effect.notification.body || ""}`.trim();
     }
     this.agentStreams = [];
     this.messages = [];
+    this.prevMessageHashes.clear();
     this.activeModal = null;
     this.currentModel = "";
     this.currentMode = "";
@@ -6403,16 +6471,28 @@ function trimMessageForStatus(message, stringLimit) {
   if (!message || typeof message !== "object") return message;
   return trimStructuredStrings(message, stringLimit);
 }
+function normalizeMessageTime(message) {
+  if (!message || typeof message !== "object") return message;
+  const msg = message;
+  if (msg.receivedAt == null) {
+    const fallback = msg.timestamp ?? msg.createdAt;
+    if (fallback != null) {
+      const ts2 = typeof fallback === "string" ? Date.parse(fallback) : Number(fallback);
+      if (Number.isFinite(ts2) && ts2 > 0) msg.receivedAt = ts2;
+    }
+  }
+  return msg;
+}
 function trimMessagesForStatus(messages) {
   if (!Array.isArray(messages) || messages.length === 0) return [];
   const recent = messages.slice(-STATUS_ACTIVE_CHAT_MESSAGE_LIMIT);
   const kept = [];
   let totalBytes = 0;
   for (let i = recent.length - 1; i >= 0; i -= 1) {
-    let normalized = trimMessageForStatus(recent[i], STATUS_ACTIVE_CHAT_STRING_LIMIT);
+    let normalized = normalizeMessageTime(trimMessageForStatus(recent[i], STATUS_ACTIVE_CHAT_STRING_LIMIT));
     let size = estimateBytes(normalized);
     if (size > STATUS_ACTIVE_CHAT_TOTAL_BYTES_LIMIT) {
-      normalized = trimMessageForStatus(recent[i], STATUS_ACTIVE_CHAT_FALLBACK_STRING_LIMIT);
+      normalized = normalizeMessageTime(trimMessageForStatus(recent[i], STATUS_ACTIVE_CHAT_FALLBACK_STRING_LIMIT));
       size = estimateBytes(normalized);
     }
     if (kept.length > 0 && totalBytes + size > STATUS_ACTIVE_CHAT_TOTAL_BYTES_LIMIT) {
@@ -7035,7 +7115,7 @@ async function handleSendChat(h, args) {
   if (isExtensionTransport(transport)) {
     _log(`Extension: ${provider?.type || "unknown_extension"}`);
     try {
-      const evalResult = await h.evaluateProviderScript("sendMessage", { MESSAGE: text }, 3e4);
+      const evalResult = await h.evaluateProviderScript("sendMessage", { message: text }, 3e4);
       if (evalResult?.result) {
         const parsed = parseMaybeJson(evalResult.result);
         if (didProviderConfirmSend(parsed)) {
@@ -7066,7 +7146,7 @@ async function handleSendChat(h, args) {
     return { success: false, error: `CDP for ${managerKey || "unknown"} not connected` };
   }
   _log(`Targeting IDE: ${getCurrentManagerKey(h)}`);
-  const sendScript = h.getProviderScript("sendMessage", { MESSAGE: text });
+  const sendScript = h.getProviderScript("sendMessage", { message: text });
   if (sendScript) {
     try {
       const result = await targetCdp.evaluate(sendScript, 3e4);
@@ -7206,6 +7286,14 @@ async function handleListChats(h, args) {
         } catch {
         }
       }
+      if (parsed?.sessions && Array.isArray(parsed.sessions)) {
+        LOG.info("Command", `[list_chats] OK: ${parsed.sessions.length} chats`);
+        return { success: true, chats: parsed.sessions };
+      }
+      if (parsed?.chats && Array.isArray(parsed.chats)) {
+        LOG.info("Command", `[list_chats] OK: ${parsed.chats.length} chats`);
+        return { success: true, chats: parsed.chats };
+      }
       if (Array.isArray(parsed)) {
         LOG.info("Command", `[list_chats] OK: ${parsed.length} chats`);
         return { success: true, chats: parsed };
@@ -7275,7 +7363,13 @@ async function handleSwitchChat(h, args) {
   } catch (e) {
     return { success: false, error: `webviewSwitchSession failed: ${e.message}` };
   }
-  const script = h.getProviderScript("switchSession", { SESSION_ID: JSON.stringify(sessionId) }) || h.getProviderScript("switch_session", { SESSION_ID: JSON.stringify(sessionId) });
+  const switchParams = {
+    sessionId,
+    title: sessionId,
+    id: sessionId,
+    SESSION_ID: JSON.stringify(sessionId)
+  };
+  const script = h.getProviderScript("switchSession", switchParams) || h.getProviderScript("switch_session", switchParams);
   if (!script) return { success: false, error: "switch_session script not available" };
   try {
     const raw = await cdp.evaluate(script, 15e3);
@@ -7354,8 +7448,8 @@ async function handleSetMode(h, args) {
     const adapter = getTargetedCliAdapter(h, args, provider?.type);
     if (adapter) {
       const acpInstance = adapter._acpInstance;
-      if (acpInstance && typeof acpInstance.onEvent === "function") {
-        acpInstance.onEvent("set_mode", { mode });
+      if (acpInstance && typeof acpInstance.setMode === "function") {
+        await acpInstance.setMode(mode);
         return { success: true, mode };
       }
     }
@@ -7412,9 +7506,9 @@ async function handleChangeModel(h, args) {
     LOG.info("Command", `[change_model] ACP adapter found: ${!!adapter}, type=${adapter?.cliType}, hasAcpInstance=${!!adapter?._acpInstance}`);
     if (adapter) {
       const acpInstance = adapter._acpInstance;
-      if (acpInstance && typeof acpInstance.onEvent === "function") {
-        acpInstance.onEvent("change_model", { model });
-        LOG.info("Command", `[change_model] Dispatched change_model event to ACP instance`);
+      if (acpInstance && typeof acpInstance.setConfigOption === "function") {
+        await acpInstance.setConfigOption("model", model);
+        LOG.info("Command", `[change_model] Updated ACP model to ${model}`);
         return { success: true, model };
       }
     }
@@ -7534,6 +7628,18 @@ async function handleResolveAction(h, args) {
     const ok = await h.agentStream.resolveSessionAction(h.getCdp(), h.currentSession.sessionId, action);
     return { success: ok };
   }
+  if (transport === "acp") {
+    const adapter = getTargetedCliAdapter(h, args, provider?.type);
+    const acpInstance = adapter?._acpInstance;
+    if (!acpInstance) return { success: false, error: "ACP instance not found" };
+    try {
+      await acpInstance.resolvePermission(action === "approve" || action === "accept" || action === "always");
+      LOG.info("Command", `[resolveAction] ACP \u2192 ${action}`);
+      return { success: true, action };
+    } catch (e) {
+      return { success: false, error: e?.message || "ACP resolve action failed" };
+    }
+  }
   if (provider?.scripts?.webviewResolveAction || provider?.scripts?.webview_resolve_action) {
     const script = h.getProviderScript("webviewResolveAction", { action, button, buttonText: button }) || h.getProviderScript("webview_resolve_action", { action, button, buttonText: button });
     if (script) {
@@ -7612,7 +7718,7 @@ async function handleResolveAction(h, args) {
 
 // src/commands/cdp-commands.ts
 import * as fs4 from "fs";
-import * as path6 from "path";
+import * as path8 from "path";
 import * as os6 from "os";
 var KEY_TO_VK = {
   Backspace: 8,
@@ -7864,25 +7970,25 @@ function resolveSafePath(requestedPath) {
   const inputPath = rawPath || ".";
   const home = os6.homedir();
   if (inputPath.startsWith("~")) {
-    return path6.resolve(path6.join(home, inputPath.slice(1)));
+    return path8.resolve(path8.join(home, inputPath.slice(1)));
   }
   if (process.platform === "win32") {
     const normalized = normalizeWindowsRequestedPath(inputPath);
-    if (path6.win32.isAbsolute(normalized)) {
-      return path6.win32.normalize(normalized);
+    if (path8.win32.isAbsolute(normalized)) {
+      return path8.win32.normalize(normalized);
     }
-    return path6.win32.resolve(normalized);
+    return path8.win32.resolve(normalized);
   }
-  if (path6.isAbsolute(inputPath)) {
-    return path6.normalize(inputPath);
+  if (path8.isAbsolute(inputPath)) {
+    return path8.normalize(inputPath);
   }
-  return path6.resolve(inputPath);
+  return path8.resolve(inputPath);
 }
 function listDirectoryEntriesSafe(dirPath) {
   const entries = fs4.readdirSync(dirPath, { withFileTypes: true });
   const files = [];
   for (const entry of entries) {
-    const entryPath = path6.join(dirPath, entry.name);
+    const entryPath = path8.join(dirPath, entry.name);
     try {
       if (entry.isDirectory()) {
         files.push({ name: entry.name, type: "directory" });
@@ -7921,7 +8027,7 @@ async function handleFileRead(h, args) {
 async function handleFileWrite(h, args) {
   try {
     const filePath = resolveSafePath(args?.path);
-    fs4.mkdirSync(path6.dirname(filePath), { recursive: true });
+    fs4.mkdirSync(path8.dirname(filePath), { recursive: true });
     fs4.writeFileSync(filePath, args?.content || "", "utf-8");
     return { success: true, path: filePath };
   } catch (e) {
@@ -8009,7 +8115,7 @@ function handleGetProviderSettings(h, args) {
   }
   return { success: true, settings: allSettings, values: allValues };
 }
-function handleSetProviderSetting(h, args) {
+async function handleSetProviderSetting(h, args) {
   const loader = h.ctx.providerLoader;
   const { providerType, key, value } = args || {};
   if (!providerType || !key || value === void 0) {
@@ -8022,6 +8128,7 @@ function handleSetProviderSetting(h, args) {
       const updated = h.ctx.instanceManager.updateInstanceSettings(providerType, allSettings);
       LOG.info("Command", `[set_provider_setting] ${providerType}.${key}=${JSON.stringify(value)} \u2192 ${updated} instance(s) updated`);
     }
+    await h.ctx.onProviderSettingChanged?.(providerType, key, value);
     return { success: true, providerType, key, value };
   }
   return { success: false, error: `Failed to set ${providerType}.${key} \u2014 invalid key, value, or not a public setting` };
@@ -8059,10 +8166,10 @@ function getCliScriptCommand(payload) {
   }
   const command = payload.command;
   if (!command || typeof command !== "object") return null;
-  if (command.type !== "send_message") return null;
+  if (command.type !== "send_message" && command.type !== "pty_write") return null;
   const text = typeof command.text === "string" ? command.text.trim() : typeof command.message === "string" ? command.message.trim() : "";
   if (!text) return null;
-  return { type: "send_message", text };
+  return { type: command.type, text };
 }
 function applyProviderPatch(h, args, payload) {
   if (!payload || typeof payload !== "object") return;
@@ -8103,6 +8210,8 @@ async function executeProviderScript(h, args, scriptName) {
       const cliCommand = getCliScriptCommand(parsed.payload);
       if (cliCommand?.type === "send_message" && cliCommand.text) {
         await adapter.sendMessage(cliCommand.text);
+      } else if (cliCommand?.type === "pty_write" && cliCommand.text && adapter.writeRaw) {
+        adapter.writeRaw(cliCommand.text + "\r");
       }
       applyProviderPatch(h, args, parsed.payload);
       return { success: true, ...parsed.payload && typeof parsed.payload === "object" ? parsed.payload : { result: parsed.payload } };
@@ -8468,9 +8577,26 @@ var DaemonCommandHandler = class {
     if (provider?.scripts) {
       const fn = provider.scripts[scriptName];
       if (typeof fn === "function") {
-        const firstVal = params ? Object.values(params)[0] : void 0;
-        const script = firstVal ? fn(firstVal) : fn();
-        if (script) return script;
+        if (params && Object.keys(params).length > 0) {
+          const firstVal = Object.values(params)[0];
+          if (scriptName === "sendMessage" && typeof firstVal === "string") {
+            const legacyScript = fn(firstVal);
+            if (legacyScript) return legacyScript;
+          }
+          const script = fn(params);
+          if (script) {
+            const likelyLegacyObjectLeak = typeof script === "string" && script.includes("[object Object]") && typeof firstVal === "string";
+            if (!likelyLegacyObjectLeak) return script;
+          }
+          if (firstVal !== void 0) {
+            const legacyScript = fn(firstVal);
+            if (legacyScript) return legacyScript;
+          }
+          if (script) return script;
+        } else {
+          const script = fn();
+          if (script) return script;
+        }
       }
     }
     return null;
@@ -8764,7 +8890,7 @@ var DaemonCommandHandler = class {
     try {
       const http3 = await import("http");
       const postData = JSON.stringify(body);
-      const result = await new Promise((resolve9, reject) => {
+      const result = await new Promise((resolve12, reject) => {
         const req = http3.request({
           hostname: "127.0.0.1",
           port: 19280,
@@ -8776,9 +8902,9 @@ var DaemonCommandHandler = class {
           res.on("data", (chunk) => data += chunk);
           res.on("end", () => {
             try {
-              resolve9(JSON.parse(data));
+              resolve12(JSON.parse(data));
             } catch {
-              resolve9({ raw: data });
+              resolve12({ raw: data });
             }
           });
         });
@@ -8796,15 +8922,15 @@ var DaemonCommandHandler = class {
     if (!providerType) return { success: false, error: "providerType required" };
     try {
       const http3 = await import("http");
-      const result = await new Promise((resolve9, reject) => {
+      const result = await new Promise((resolve12, reject) => {
         http3.get(`http://127.0.0.1:19280/api/providers/${providerType}/${endpoint}`, (res) => {
           let data = "";
           res.on("data", (chunk) => data += chunk);
           res.on("end", () => {
             try {
-              resolve9(JSON.parse(data));
+              resolve12(JSON.parse(data));
             } catch {
-              resolve9({ raw: data });
+              resolve12({ raw: data });
             }
           });
         }).on("error", reject);
@@ -8818,7 +8944,7 @@ var DaemonCommandHandler = class {
     try {
       const http3 = await import("http");
       const postData = JSON.stringify(args || {});
-      const result = await new Promise((resolve9, reject) => {
+      const result = await new Promise((resolve12, reject) => {
         const req = http3.request({
           hostname: "127.0.0.1",
           port: 19280,
@@ -8830,9 +8956,9 @@ var DaemonCommandHandler = class {
           res.on("data", (chunk) => data += chunk);
           res.on("end", () => {
             try {
-              resolve9(JSON.parse(data));
+              resolve12(JSON.parse(data));
             } catch {
-              resolve9({ raw: data });
+              resolve12({ raw: data });
             }
           });
         });
@@ -8850,7 +8976,7 @@ var DaemonCommandHandler = class {
 // src/commands/cli-manager.ts
 init_provider_cli_adapter();
 import * as os10 from "os";
-import * as path9 from "path";
+import * as path11 from "path";
 import * as crypto4 from "crypto";
 import chalk from "chalk";
 init_config();
@@ -8858,7 +8984,7 @@ init_config();
 // src/providers/cli-provider-instance.ts
 init_provider_cli_adapter();
 import * as os9 from "os";
-import * as path8 from "path";
+import * as path10 from "path";
 import * as crypto3 from "crypto";
 import * as fs5 from "fs";
 import { createRequire } from "module";
@@ -8866,7 +8992,7 @@ init_logger();
 var CachedDatabaseSync = null;
 function getDatabaseSync() {
   if (CachedDatabaseSync) return CachedDatabaseSync;
-  const requireFn = typeof __require === "function" ? __require : createRequire(path8.join(process.cwd(), "__adhdev_sqlite_loader__.js"));
+  const requireFn = typeof __require === "function" ? __require : createRequire(path10.join(process.cwd(), "__adhdev_sqlite_loader__.js"));
   const sqliteModule = requireFn(`node:${"sqlite"}`);
   CachedDatabaseSync = sqliteModule.DatabaseSync;
   if (!CachedDatabaseSync) {
@@ -8931,6 +9057,7 @@ var CliProviderInstance = class {
       this.detectStatusTransition();
     });
     await this.adapter.spawn();
+    this.maybeAppendRuntimeRecoveryMessage(this.adapter.getRuntimeMetadata());
     if (this.providerSessionId) {
       const restoredHistory = readChatHistory(this.type, 0, 200, this.providerSessionId);
       if (restoredHistory.messages.length > 0) {
@@ -9025,6 +9152,7 @@ var CliProviderInstance = class {
       this.promoteProviderSessionId(parsedProviderSessionId);
     }
     const runtime = this.adapter.getRuntimeMetadata();
+    this.maybeAppendRuntimeRecoveryMessage(runtime);
     const parsedMessages = Array.isArray(parsedStatus?.messages) ? parsedStatus.messages : [];
     const controlValues = extractProviderControlValues(this.provider.controls, parsedStatus);
     if (controlValues) {
@@ -9351,6 +9479,28 @@ ${effect.notification.body || ""}`.trim();
     const pad = (value) => String(value).padStart(2, "0");
     return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}`;
   }
+  maybeAppendRuntimeRecoveryMessage(runtime) {
+    if (!runtime?.restoredFromStorage || !runtime.runtimeId) return;
+    const recoveryState = String(runtime.recoveryState || "").trim();
+    if (!recoveryState) return;
+    let content = "";
+    if (recoveryState === "auto_resumed") {
+      content = "Session host restored this CLI after restart and reattached it from a saved snapshot.";
+    } else if (recoveryState === "resume_failed") {
+      const errorSuffix = runtime.recoveryError ? ` Resume failed: ${runtime.recoveryError}` : "";
+      content = `Session host found this CLI after restart, but automatic resume failed.${errorSuffix}`;
+    } else if (recoveryState === "host_restart_interrupted") {
+      content = "Session host found this CLI in interrupted state after restart and is attempting to resume it.";
+    } else if (recoveryState === "orphan_snapshot") {
+      content = "Session host restored the last snapshot for this CLI, but the original runtime was not resumed automatically.";
+    } else {
+      content = `Session host restored this CLI after restart (${recoveryState}).`;
+    }
+    this.appendRuntimeSystemMessage(
+      content,
+      `runtime_recovery:${runtime.runtimeId}:${recoveryState}`
+    );
+  }
   appendRuntimeSystemMessage(content, dedupKey, receivedAt = Date.now()) {
     const normalizedContent = String(content || "").trim();
     if (!normalizedContent) return;
@@ -9676,8 +9826,9 @@ var AcpProviderInstance = class {
   async setConfigOption(category, value) {
     const opt = this.configOptions.find((c) => c.category === category);
     if (!opt) {
-      this.log.warn(`[${this.type}] No config option for category: ${category}`);
-      return;
+      const message = `[${this.type}] No config option for category: ${category}`;
+      this.log.warn(message);
+      throw new Error(message);
     }
     if (this.useStaticConfig) {
       opt.currentValue = value;
@@ -9689,8 +9840,9 @@ var AcpProviderInstance = class {
       return;
     }
     if (!this.connection || !this.sessionId) {
-      this.log.warn(`[${this.type}] Cannot set config: no active connection/session`);
-      return;
+      const message = `[${this.type}] Cannot set config: no active connection/session`;
+      this.log.warn(message);
+      throw new Error(message);
     }
     try {
       this.log.info(`[${this.type}] Sending session/set_config_option: configId=${opt.configId} value=${value} sessionId=${this.sessionId}`);
@@ -9704,7 +9856,9 @@ var AcpProviderInstance = class {
       if (result?.configOptions) this.parseConfigOptions(result.configOptions);
       this.log.info(`[${this.type}] Config ${category} set to: ${value} | response: ${JSON.stringify(result)?.slice(0, 300)}`);
     } catch (e) {
-      this.log.warn(`[${this.type}] set_config_option failed: ${e?.message}`);
+      const message = e?.message || "Unknown ACP config error";
+      this.log.warn(`[${this.type}] set_config_option failed: ${message}`);
+      throw new Error(message);
     }
   }
   async setMode(modeId) {
@@ -9720,8 +9874,9 @@ var AcpProviderInstance = class {
       return;
     }
     if (!this.connection || !this.sessionId) {
-      this.log.warn(`[${this.type}] Cannot set mode: no active connection/session`);
-      return;
+      const message = `[${this.type}] Cannot set mode: no active connection/session`;
+      this.log.warn(message);
+      throw new Error(message);
     }
     try {
       await this.connection.setSessionMode({
@@ -9731,7 +9886,9 @@ var AcpProviderInstance = class {
       this.currentMode = modeId;
       this.log.info(`[${this.type}] Mode set to: ${modeId}`);
     } catch (e) {
-      this.log.warn(`[${this.type}] set_mode failed: ${e?.message}`);
+      const message = e?.message || "Unknown ACP mode error";
+      this.log.warn(`[${this.type}] set_mode failed: ${message}`);
+      throw new Error(message);
     }
   }
   /** Static config: kill process and restart with new args */
@@ -9779,7 +9936,7 @@ var AcpProviderInstance = class {
     if (!spawnConfig) {
       throw new Error(`[ACP:${this.type}] No spawn config defined`);
     }
-    const command = spawnConfig.command;
+    const command = typeof this.settings.executablePath === "string" && this.settings.executablePath.trim() ? this.settings.executablePath.trim() : spawnConfig.command;
     let baseArgs = spawnConfig.args || [];
     if (this.provider.spawnArgBuilder && Object.keys(this.selectedConfig).length > 0) {
       baseArgs = this.provider.spawnArgBuilder(this.selectedConfig);
@@ -9895,13 +10052,13 @@ var AcpProviderInstance = class {
         }
         this.currentStatus = "waiting_approval";
         this.detectStatusTransition();
-        const approved = await new Promise((resolve9) => {
-          this.permissionResolvers.push(resolve9);
+        const approved = await new Promise((resolve12) => {
+          this.permissionResolvers.push(resolve12);
           setTimeout(() => {
-            const idx = this.permissionResolvers.indexOf(resolve9);
+            const idx = this.permissionResolvers.indexOf(resolve12);
             if (idx >= 0) {
               this.permissionResolvers.splice(idx, 1);
-              resolve9(false);
+              resolve12(false);
             }
           }, 3e5);
         });
@@ -10608,7 +10765,7 @@ var DaemonCliManager = class {
   async startSession(cliType, workingDir, cliArgs, initialModel, options) {
     const trimmed = (workingDir || "").trim();
     if (!trimmed) throw new Error("working directory required");
-    const resolvedDir = trimmed.startsWith("~") ? trimmed.replace(/^~/, os10.homedir()) : path9.resolve(trimmed);
+    const resolvedDir = trimmed.startsWith("~") ? trimmed.replace(/^~/, os10.homedir()) : path11.resolve(trimmed);
     const normalizedType = this.providerLoader.resolveAlias(cliType);
     const provider = this.providerLoader.getByAlias(cliType);
     const key = crypto4.randomUUID();
@@ -10695,10 +10852,10 @@ ${installInfo}`
     if (!cliInfo) {
       const installHint = provider?.install || "";
       const displayName = provider?.displayName || provider?.name || cliType;
-      const spawnCmd = provider?.spawn?.command || cliType;
+      const spawnCmd = this.providerLoader.getSpawnCommand(normalizedType, provider?.spawn?.command || cliType);
       throw new Error(
         `${displayName} is not installed.
-Command '${spawnCmd}' not found on PATH.
+Command '${spawnCmd}' is not available.
 ` + (installHint ? `
 ${installHint}
 ` : "") + `
@@ -11058,16 +11215,17 @@ Run 'adhdev doctor' for detailed diagnostics.`
 import { execSync as execSync4, spawn as spawn2 } from "child_process";
 import * as net from "net";
 import * as os12 from "os";
-import * as path11 from "path";
+import * as path13 from "path";
 
 // src/providers/provider-loader.ts
 import * as fs6 from "fs";
-import * as path10 from "path";
+import * as path12 from "path";
 import * as os11 from "os";
 import * as chokidar from "chokidar";
 init_logger();
 var ProviderLoader = class _ProviderLoader {
   providers = /* @__PURE__ */ new Map();
+  providerAvailability = /* @__PURE__ */ new Map();
   userDir;
   upstreamDir;
   disableUpstream;
@@ -11083,12 +11241,12 @@ var ProviderLoader = class _ProviderLoader {
   static META_FILE = ".meta.json";
   constructor(options) {
     this.logFn = options?.logFn || LOG.forComponent("Provider").asLogFn();
-    const defaultProvidersDir = path10.join(os11.homedir(), ".adhdev", "providers");
+    const defaultProvidersDir = path12.join(os11.homedir(), ".adhdev", "providers");
     if (options?.userDir) {
       this.userDir = options.userDir;
       this.log(`Config 'providerDir' applied: ${this.userDir}`);
     } else {
-      const localRepoPath = path10.resolve(__dirname, "../../../../../adhdev-providers");
+      const localRepoPath = path12.resolve(__dirname, "../../../../../adhdev-providers");
       if (fs6.existsSync(localRepoPath)) {
         this.userDir = localRepoPath;
         this.log(`Auto-detected local public repository: ${this.userDir} (Dev workspace speedup)`);
@@ -11097,7 +11255,7 @@ var ProviderLoader = class _ProviderLoader {
         this.log(`Using default user providers directory: ${this.userDir}`);
       }
     }
-    this.upstreamDir = path10.join(defaultProvidersDir, ".upstream");
+    this.upstreamDir = path12.join(defaultProvidersDir, ".upstream");
     this.disableUpstream = options?.disableUpstream ?? false;
   }
   log(msg) {
@@ -11127,7 +11285,7 @@ var ProviderLoader = class _ProviderLoader {
   * Canonical provider directory shape for a given root.
   */
   getProviderDir(root, category, type) {
-    return path10.join(root, category, type);
+    return path12.join(root, category, type);
   }
   /**
   * Canonical user override directory for a provider.
@@ -11154,7 +11312,7 @@ var ProviderLoader = class _ProviderLoader {
   resolveProviderFile(type, ...segments) {
     const dir = this.findProviderDirInternal(type);
     if (!dir) return null;
-    return path10.join(dir, ...segments);
+    return path12.join(dir, ...segments);
   }
   /**
   * Load all providers (3-tier priority)
@@ -11165,6 +11323,7 @@ var ProviderLoader = class _ProviderLoader {
   */
   loadAll() {
     this.providers.clear();
+    this.providerAvailability.clear();
     let upstreamCount = 0;
     if (!this.disableUpstream && fs6.existsSync(this.upstreamDir)) {
       upstreamCount = this.loadDir(this.upstreamDir);
@@ -11192,7 +11351,7 @@ var ProviderLoader = class _ProviderLoader {
     if (!fs6.existsSync(this.upstreamDir)) return false;
     try {
       return fs6.readdirSync(this.upstreamDir).some(
-        (d) => fs6.statSync(path10.join(this.upstreamDir, d)).isDirectory()
+        (d) => fs6.statSync(path12.join(this.upstreamDir, d)).isDirectory()
       );
     } catch {
       return false;
@@ -11235,11 +11394,12 @@ var ProviderLoader = class _ProviderLoader {
       if ((p.category === "cli" || p.category === "acp") && p.spawn?.command) {
         const verCmdConfig = p.versionCommand;
         const versionCommand = typeof verCmdConfig === "object" && verCmdConfig !== null ? verCmdConfig[process.platform] : verCmdConfig;
+        const command = this.getSpawnCommand(p.type, p.spawn.command);
         result.push({
           id: p.type,
           displayName: p.displayName || p.name,
           icon: p.icon || "\u{1F527}",
-          command: p.spawn.command,
+          command,
           category: p.category,
           ...typeof versionCommand === "string" && versionCommand.trim() ? { versionCommand: versionCommand.trim() } : {}
         });
@@ -11368,6 +11528,71 @@ var ProviderLoader = class _ProviderLoader {
   getAvailableIdeTypes() {
     return [...this.providers.values()].filter((p) => p.category === "ide" && p.cdpPorts).map((p) => p.type);
   }
+  getSpawnCommand(type, fallback) {
+    const override = this.getOptionalStringSetting(type, "executablePath");
+    if (override) return override;
+    return fallback || this.providers.get(type)?.spawn?.command || type;
+  }
+  getIdeCliCommand(type, fallback) {
+    const override = this.getOptionalStringSetting(type, "cliPathOverride");
+    if (override) return override;
+    return fallback || this.providers.get(type)?.cli || null;
+  }
+  getIdePathCandidates(type, fallback) {
+    const override = this.getOptionalStringSetting(type, "appPathOverride");
+    if (override) return [override];
+    if (fallback && fallback.length > 0) return fallback;
+    const osPaths = this.providers.get(type)?.paths?.[process.platform];
+    return Array.isArray(osPaths) ? [...osPaths] : [];
+  }
+  setProviderAvailability(type, state) {
+    this.providerAvailability.set(type, {
+      installed: !!state.installed,
+      detectedPath: state.detectedPath ?? null
+    });
+  }
+  setCliDetectionResults(results, replace = true) {
+    if (replace) {
+      for (const provider of this.providers.values()) {
+        if (provider.category === "cli" || provider.category === "acp") {
+          this.providerAvailability.set(provider.type, { installed: false, detectedPath: null });
+        }
+      }
+    }
+    for (const result of results) {
+      this.setProviderAvailability(result.id, {
+        installed: !!result.installed,
+        detectedPath: result.path || null
+      });
+    }
+  }
+  setIdeDetectionResults(results, replace = true) {
+    if (replace) {
+      for (const provider of this.providers.values()) {
+        if (provider.category === "ide") {
+          this.providerAvailability.set(provider.type, { installed: false, detectedPath: null });
+        }
+      }
+    }
+    for (const result of results) {
+      this.setProviderAvailability(result.id, {
+        installed: !!result.installed,
+        detectedPath: result.cliCommand || result.path || null
+      });
+    }
+  }
+  getAvailableProviderInfos() {
+    return this.getAll().map((provider) => {
+      const availability = this.providerAvailability.get(provider.type);
+      return {
+        ...provider,
+        ...availability ? {
+          installed: availability.installed,
+          detectedPath: availability.detectedPath
+        } : {}
+      };
+    });
+  }
   /**
   * Register IDE providers to core/detector registry
   * → Enables detectIDEs() to detect provider.js-based IDEs
@@ -11442,8 +11667,8 @@ var ProviderLoader = class _ProviderLoader {
               resolved._resolvedScriptDir = entry.scriptDir;
               resolved._resolvedScriptsSource = `compatibility:${entry.ideVersion}`;
               if (providerDir) {
-                const fullDir = path10.join(providerDir, entry.scriptDir);
-                resolved._resolvedScriptsPath = fs6.existsSync(path10.join(fullDir, "scripts.js")) ? path10.join(fullDir, "scripts.js") : fullDir;
+                const fullDir = path12.join(providerDir, entry.scriptDir);
+                resolved._resolvedScriptsPath = fs6.existsSync(path12.join(fullDir, "scripts.js")) ? path12.join(fullDir, "scripts.js") : fullDir;
               }
               matched = true;
             }
@@ -11458,8 +11683,8 @@ var ProviderLoader = class _ProviderLoader {
             resolved._resolvedScriptDir = base.defaultScriptDir;
             resolved._resolvedScriptsSource = "defaultScriptDir:version_miss";
             if (providerDir) {
-              const fullDir = path10.join(providerDir, base.defaultScriptDir);
-              resolved._resolvedScriptsPath = fs6.existsSync(path10.join(fullDir, "scripts.js")) ? path10.join(fullDir, "scripts.js") : fullDir;
+              const fullDir = path12.join(providerDir, base.defaultScriptDir);
+              resolved._resolvedScriptsPath = fs6.existsSync(path12.join(fullDir, "scripts.js")) ? path12.join(fullDir, "scripts.js") : fullDir;
             }
           }
           resolved._versionWarning = `Version ${currentVersion} not in compatibility matrix. Using default scripts.`;
@@ -11476,8 +11701,8 @@ var ProviderLoader = class _ProviderLoader {
               resolved._resolvedScriptDir = dirOverride;
               resolved._resolvedScriptsSource = `versions:${range}`;
               if (providerDir) {
-                const fullDir = path10.join(providerDir, dirOverride);
-                resolved._resolvedScriptsPath = fs6.existsSync(path10.join(fullDir, "scripts.js")) ? path10.join(fullDir, "scripts.js") : fullDir;
+                const fullDir = path12.join(providerDir, dirOverride);
+                resolved._resolvedScriptsPath = fs6.existsSync(path12.join(fullDir, "scripts.js")) ? path12.join(fullDir, "scripts.js") : fullDir;
               }
             }
           } else if (override.scripts) {
@@ -11493,8 +11718,8 @@ var ProviderLoader = class _ProviderLoader {
         resolved._resolvedScriptDir = base.defaultScriptDir;
         resolved._resolvedScriptsSource = "defaultScriptDir:no_version";
         if (providerDir) {
-          const fullDir = path10.join(providerDir, base.defaultScriptDir);
-          resolved._resolvedScriptsPath = fs6.existsSync(path10.join(fullDir, "scripts.js")) ? path10.join(fullDir, "scripts.js") : fullDir;
+          const fullDir = path12.join(providerDir, base.defaultScriptDir);
+          resolved._resolvedScriptsPath = fs6.existsSync(path12.join(fullDir, "scripts.js")) ? path12.join(fullDir, "scripts.js") : fullDir;
         }
       }
     }
@@ -11519,14 +11744,14 @@ var ProviderLoader = class _ProviderLoader {
       this.log(`  [loadScriptsFromDir] ${type}: providerDir not found`);
       return null;
     }
-    const dir = path10.join(providerDir, scriptDir);
+    const dir = path12.join(providerDir, scriptDir);
     if (!fs6.existsSync(dir)) {
       this.log(`  [loadScriptsFromDir] ${type}: dir not found: ${dir}`);
       return null;
     }
     const cached = this.scriptsCache.get(dir);
     if (cached) return cached;
-    const scriptsJs = path10.join(dir, "scripts.js");
+    const scriptsJs = path12.join(dir, "scripts.js");
     if (fs6.existsSync(scriptsJs)) {
       try {
         delete __require.cache[__require.resolve(scriptsJs)];
@@ -11568,7 +11793,7 @@ var ProviderLoader = class _ProviderLoader {
             return;
           }
           if (filePath.endsWith(".js") || filePath.endsWith(".json")) {
-            this.log(`File changed: ${path10.basename(filePath)}, reloading...`);
+            this.log(`File changed: ${path12.basename(filePath)}, reloading...`);
             this.reload();
           }
         };
@@ -11623,7 +11848,7 @@ var ProviderLoader = class _ProviderLoader {
     }
     const https = __require("https");
     const { execSync: execSync7 } = __require("child_process");
-    const metaPath = path10.join(this.upstreamDir, _ProviderLoader.META_FILE);
+    const metaPath = path12.join(this.upstreamDir, _ProviderLoader.META_FILE);
     let prevEtag = "";
     let prevTimestamp = 0;
     try {
@@ -11640,7 +11865,7 @@ var ProviderLoader = class _ProviderLoader {
       return { updated: false };
     }
     try {
-      const etag = await new Promise((resolve9, reject) => {
+      const etag = await new Promise((resolve12, reject) => {
         const options = {
           method: "HEAD",
           hostname: "github.com",
@@ -11658,7 +11883,7 @@ var ProviderLoader = class _ProviderLoader {
               headers: { "User-Agent": "adhdev-launcher" },
               timeout: 1e4
             }, (res2) => {
-              resolve9(res2.headers.etag || res2.headers["last-modified"] || "");
+              resolve12(res2.headers.etag || res2.headers["last-modified"] || "");
             });
             req2.on("error", reject);
             req2.on("timeout", () => {
@@ -11667,7 +11892,7 @@ var ProviderLoader = class _ProviderLoader {
             });
             req2.end();
           } else {
-            resolve9(res.headers.etag || res.headers["last-modified"] || "");
+            resolve12(res.headers.etag || res.headers["last-modified"] || "");
           }
         });
         req.on("error", reject);
@@ -11683,17 +11908,17 @@ var ProviderLoader = class _ProviderLoader {
         return { updated: false };
       }
       this.log("Downloading latest providers from GitHub...");
-      const tmpTar = path10.join(os11.tmpdir(), `adhdev-providers-${Date.now()}.tar.gz`);
-      const tmpExtract = path10.join(os11.tmpdir(), `adhdev-providers-extract-${Date.now()}`);
+      const tmpTar = path12.join(os11.tmpdir(), `adhdev-providers-${Date.now()}.tar.gz`);
+      const tmpExtract = path12.join(os11.tmpdir(), `adhdev-providers-extract-${Date.now()}`);
       await this.downloadFile(_ProviderLoader.GITHUB_TARBALL_URL, tmpTar);
       fs6.mkdirSync(tmpExtract, { recursive: true });
       execSync7(`tar -xzf "${tmpTar}" -C "${tmpExtract}"`, { timeout: 3e4 });
       const extracted = fs6.readdirSync(tmpExtract);
       const rootDir = extracted.find(
-        (d) => fs6.statSync(path10.join(tmpExtract, d)).isDirectory() && d.startsWith("adhdev-providers")
+        (d) => fs6.statSync(path12.join(tmpExtract, d)).isDirectory() && d.startsWith("adhdev-providers")
       );
       if (!rootDir) throw new Error("Unexpected tarball structure");
-      const sourceDir = path10.join(tmpExtract, rootDir);
+      const sourceDir = path12.join(tmpExtract, rootDir);
       const backupDir = this.upstreamDir + ".bak";
       if (fs6.existsSync(this.upstreamDir)) {
         if (fs6.existsSync(backupDir)) fs6.rmSync(backupDir, { recursive: true, force: true });
@@ -11731,7 +11956,7 @@ var ProviderLoader = class _ProviderLoader {
   downloadFile(url, destPath) {
     const https = __require("https");
     const http3 = __require("http");
-    return new Promise((resolve9, reject) => {
+    return new Promise((resolve12, reject) => {
       const doRequest = (reqUrl, redirectCount = 0) => {
         if (redirectCount > 5) {
           reject(new Error("Too many redirects"));
@@ -11751,7 +11976,7 @@ var ProviderLoader = class _ProviderLoader {
           res.pipe(ws);
           ws.on("finish", () => {
             ws.close();
-            resolve9();
+            resolve12();
           });
           ws.on("error", reject);
         });
@@ -11768,8 +11993,8 @@ var ProviderLoader = class _ProviderLoader {
   copyDirRecursive(src, dest) {
     fs6.mkdirSync(dest, { recursive: true });
     for (const entry of fs6.readdirSync(src, { withFileTypes: true })) {
-      const srcPath = path10.join(src, entry.name);
-      const destPath = path10.join(dest, entry.name);
+      const srcPath = path12.join(src, entry.name);
+      const destPath = path12.join(dest, entry.name);
       if (entry.isDirectory()) {
         this.copyDirRecursive(srcPath, destPath);
       } else {
@@ -11780,7 +12005,7 @@ var ProviderLoader = class _ProviderLoader {
   /** .meta.json save */
   writeMeta(metaPath, etag, timestamp) {
     try {
-      fs6.mkdirSync(path10.dirname(metaPath), { recursive: true });
+      fs6.mkdirSync(path12.dirname(metaPath), { recursive: true });
       fs6.writeFileSync(metaPath, JSON.stringify({
         etag,
         timestamp,
@@ -11797,7 +12022,7 @@ var ProviderLoader = class _ProviderLoader {
     const scan = (d) => {
       try {
         for (const entry of fs6.readdirSync(d, { withFileTypes: true })) {
-          if (entry.isDirectory()) scan(path10.join(d, entry.name));
+          if (entry.isDirectory()) scan(path12.join(d, entry.name));
           else if (entry.name === "provider.json") count++;
         }
       } catch {
@@ -11811,9 +12036,8 @@ var ProviderLoader = class _ProviderLoader {
   * Get public settings schema for a provider (for dashboard UI rendering)
   */
   getPublicSettings(type) {
-    const provider = this.providers.get(type);
-    if (!provider?.settings) return [];
-    return Object.entries(provider.settings).filter(([, def]) => def.public === true).map(([key, def]) => ({ key, ...def }));
+    const settings = this.getSettingsSchema(type);
+    return Object.entries(settings).filter(([, def]) => def.public === true).map(([key, def]) => ({ key, ...def }));
   }
   /**
   * Get public settings schema for all providers
@@ -11830,8 +12054,7 @@ var ProviderLoader = class _ProviderLoader {
   * Resolved setting value for a provider (default + user override)
   */
   getSettingValue(type, key) {
-    const provider = this.providers.get(type);
-    const schemaDef = provider?.settings?.[key];
+    const schemaDef = this.getSettingsSchema(type)[key];
     const defaultVal = schemaDef ? schemaDef.default : void 0;
     try {
       const { loadConfig: loadConfig2 } = (init_config(), __toCommonJS(config_exports));
@@ -11846,10 +12069,9 @@ var ProviderLoader = class _ProviderLoader {
   * All resolved settings for a provider (default + user override)
   */
   getSettings(type) {
-    const provider = this.providers.get(type);
-    if (!provider?.settings) return {};
+    const settings = this.getSettingsSchema(type);
     const result = {};
-    for (const [key, def] of Object.entries(provider.settings)) {
+    for (const [key] of Object.entries(settings)) {
       result[key] = this.getSettingValue(type, key);
     }
     return result;
@@ -11858,11 +12080,11 @@ var ProviderLoader = class _ProviderLoader {
   * Save provider setting value (writes to config.json)
   */
   setSetting(type, key, value) {
-    const provider = this.providers.get(type);
-    const schemaDef = provider?.settings?.[key];
+    const schemaDef = this.getSettingsSchema(type)[key];
     if (!schemaDef) return false;
     if (!schemaDef.public) return false;
     if (schemaDef.type === "boolean" && typeof value !== "boolean") return false;
+    if (schemaDef.type === "string" && typeof value !== "string") return false;
     if (schemaDef.type === "number") {
       if (typeof value !== "number") return false;
       if (schemaDef.min !== void 0 && value < schemaDef.min) return false;
@@ -11883,6 +12105,53 @@ var ProviderLoader = class _ProviderLoader {
       return false;
     }
   }
+  getOptionalStringSetting(type, key) {
+    const value = this.getSettingValue(type, key);
+    if (typeof value !== "string") return null;
+    const trimmed = value.trim();
+    return trimmed ? trimmed : null;
+  }
+  getSettingsSchema(type) {
+    const provider = this.providers.get(type);
+    if (!provider) return {};
+    return {
+      ...this.getSyntheticSettings(type, provider),
+      ...provider.settings || {}
+    };
+  }
+  getSyntheticSettings(type, provider) {
+    const result = {};
+    if ((provider.category === "cli" || provider.category === "acp") && provider.spawn?.command && !provider.settings?.executablePath) {
+      result.executablePath = {
+        type: "string",
+        default: "",
+        public: true,
+        label: "Executable path",
+        description: "Optional absolute path for this provider binary. Leave blank to use the default PATH lookup."
+      };
+    }
+    if (provider.category === "ide") {
+      if (provider.cli && !provider.settings?.cliPathOverride) {
+        result.cliPathOverride = {
+          type: "string",
+          default: "",
+          public: true,
+          label: "CLI path override",
+          description: "Optional absolute path for the IDE CLI launcher. Leave blank to use the detected default."
+        };
+      }
+      if (provider.paths && !provider.settings?.appPathOverride) {
+        result.appPathOverride = {
+          type: "string",
+          default: "",
+          public: true,
+          label: "App path override",
+          description: "Optional absolute path for the IDE app bundle or executable. Leave blank to use the default install locations."
+        };
+      }
+    }
+    return result;
+  }
   // ─── Private ───────────────────────────────────
   /**
    * Find the on-disk directory for a provider by type.
@@ -11896,17 +12165,17 @@ var ProviderLoader = class _ProviderLoader {
     for (const root of searchRoots) {
       if (!fs6.existsSync(root)) continue;
       const candidate = this.getProviderDir(root, cat, type);
-      if (fs6.existsSync(path10.join(candidate, "provider.json"))) return candidate;
-      const catDir = path10.join(root, cat);
+      if (fs6.existsSync(path12.join(candidate, "provider.json"))) return candidate;
+      const catDir = path12.join(root, cat);
       if (fs6.existsSync(catDir)) {
         try {
           for (const entry of fs6.readdirSync(catDir, { withFileTypes: true })) {
             if (!entry.isDirectory()) continue;
-            const jsonPath = path10.join(catDir, entry.name, "provider.json");
+            const jsonPath = path12.join(catDir, entry.name, "provider.json");
             if (fs6.existsSync(jsonPath)) {
               try {
                 const data = JSON.parse(fs6.readFileSync(jsonPath, "utf-8"));
-                if (data.type === type) return path10.join(catDir, entry.name);
+                if (data.type === type) return path12.join(catDir, entry.name);
               } catch {
               }
             }
@@ -11923,7 +12192,7 @@ var ProviderLoader = class _ProviderLoader {
    * (template substitution is NOT applied here — scripts.js handles that)
    */
   buildScriptWrappersFromDir(dir) {
-    const scriptsJs = path10.join(dir, "scripts.js");
+    const scriptsJs = path12.join(dir, "scripts.js");
     if (fs6.existsSync(scriptsJs)) {
       try {
         delete __require.cache[__require.resolve(scriptsJs)];
@@ -11937,7 +12206,7 @@ var ProviderLoader = class _ProviderLoader {
       for (const file of fs6.readdirSync(dir)) {
         if (!file.endsWith(".js")) continue;
         const scriptName = toCamel(file.replace(".js", ""));
-        const filePath = path10.join(dir, file);
+        const filePath = path12.join(dir, file);
         result[scriptName] = (...args) => {
           try {
             let content = fs6.readFileSync(filePath, "utf-8");
@@ -11997,7 +12266,7 @@ var ProviderLoader = class _ProviderLoader {
       }
       const hasJson = entries.some((e) => e.name === "provider.json");
       if (hasJson) {
-        const jsonPath = path10.join(d, "provider.json");
+        const jsonPath = path12.join(d, "provider.json");
         try {
           const raw = fs6.readFileSync(jsonPath, "utf-8");
           const mod = JSON.parse(raw);
@@ -12010,7 +12279,7 @@ var ProviderLoader = class _ProviderLoader {
               delete mod.extensionIdPattern_flags;
             }
             const hasCompatibility = Array.isArray(mod.compatibility);
-            const scriptsPath = path10.join(d, "scripts.js");
+            const scriptsPath = path12.join(d, "scripts.js");
             if (!hasCompatibility && fs6.existsSync(scriptsPath)) {
               try {
                 delete __require.cache[__require.resolve(scriptsPath)];
@@ -12036,7 +12305,7 @@ var ProviderLoader = class _ProviderLoader {
           if (!entry.isDirectory()) continue;
           if (entry.name.startsWith("_") || entry.name.startsWith(".")) continue;
           if (excludeDirs && d === dir && excludeDirs.includes(entry.name)) continue;
-          scan(path10.join(d, entry.name));
+          scan(path12.join(d, entry.name));
         }
       }
     };
@@ -12132,17 +12401,17 @@ async function findFreePort(ports) {
   throw new Error("No free port found");
 }
 function checkPortFree(port) {
-  return new Promise((resolve9) => {
+  return new Promise((resolve12) => {
     const server = net.createServer();
     server.unref();
-    server.on("error", () => resolve9(false));
+    server.on("error", () => resolve12(false));
     server.listen(port, "127.0.0.1", () => {
-      server.close(() => resolve9(true));
+      server.close(() => resolve12(true));
     });
   });
 }
 async function isCdpActive(port) {
-  return new Promise((resolve9) => {
+  return new Promise((resolve12) => {
     const req = __require("http").get(`http://127.0.0.1:${port}/json/version`, {
       timeout: 2e3
     }, (res) => {
@@ -12151,16 +12420,16 @@ async function isCdpActive(port) {
       res.on("end", () => {
         try {
           const info = JSON.parse(data);
-          resolve9(!!info["WebKit-Version"] || !!info["Browser"]);
+          resolve12(!!info["WebKit-Version"] || !!info["Browser"]);
         } catch {
-          resolve9(false);
+          resolve12(false);
         }
       });
     });
-    req.on("error", () => resolve9(false));
+    req.on("error", () => resolve12(false));
     req.on("timeout", () => {
       req.destroy();
-      resolve9(false);
+      resolve12(false);
     });
   });
 }
@@ -12294,8 +12563,8 @@ function detectCurrentWorkspace(ideId) {
       const appNameMap = getMacAppIdentifiers();
       const appName = appNameMap[ideId];
       if (appName) {
-        const storagePath = path11.join(
-          process.env.APPDATA || path11.join(os12.homedir(), "AppData", "Roaming"),
+        const storagePath = path13.join(
+          process.env.APPDATA || path13.join(os12.homedir(), "AppData", "Roaming"),
           appName,
           "storage.json"
         );
@@ -12319,7 +12588,7 @@ function detectCurrentWorkspace(ideId) {
 async function launchWithCdp(options = {}) {
   const platform9 = os12.platform();
   let targetIde;
-  const ides = await detectIDEs();
+  const ides = await detectIDEs(getProviderLoader());
   if (options.ideId) {
     targetIde = ides.find((i) => i.id === options.ideId && i.installed);
     if (!targetIde) {
@@ -12473,9 +12742,9 @@ init_logger();
 
 // src/logging/command-log.ts
 import * as fs7 from "fs";
-import * as path12 from "path";
+import * as path14 from "path";
 import * as os13 from "os";
-var LOG_DIR2 = process.platform === "win32" ? path12.join(process.env.LOCALAPPDATA || process.env.APPDATA || path12.join(os13.homedir(), "AppData", "Local"), "adhdev", "logs") : process.platform === "darwin" ? path12.join(os13.homedir(), "Library", "Logs", "adhdev") : path12.join(os13.homedir(), ".local", "share", "adhdev", "logs");
+var LOG_DIR2 = process.platform === "win32" ? path14.join(process.env.LOCALAPPDATA || process.env.APPDATA || path14.join(os13.homedir(), "AppData", "Local"), "adhdev", "logs") : process.platform === "darwin" ? path14.join(os13.homedir(), "Library", "Logs", "adhdev") : path14.join(os13.homedir(), ".local", "share", "adhdev", "logs");
 var MAX_FILE_SIZE = 5 * 1024 * 1024;
 var MAX_DAYS = 7;
 try {
@@ -12513,13 +12782,13 @@ function getDateStr2() {
   return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
 }
 var currentDate2 = getDateStr2();
-var currentFile = path12.join(LOG_DIR2, `commands-${currentDate2}.jsonl`);
+var currentFile = path14.join(LOG_DIR2, `commands-${currentDate2}.jsonl`);
 var writeCount2 = 0;
 function checkRotation() {
   const today = getDateStr2();
   if (today !== currentDate2) {
     currentDate2 = today;
-    currentFile = path12.join(LOG_DIR2, `commands-${currentDate2}.jsonl`);
+    currentFile = path14.join(LOG_DIR2, `commands-${currentDate2}.jsonl`);
     cleanOldFiles();
   }
 }
@@ -12533,7 +12802,7 @@ function cleanOldFiles() {
       const dateMatch = file.match(/commands-(\d{4}-\d{2}-\d{2})/);
       if (dateMatch && dateMatch[1] < cutoffStr) {
         try {
-          fs7.unlinkSync(path12.join(LOG_DIR2, file));
+          fs7.unlinkSync(path14.join(LOG_DIR2, file));
         } catch {
         }
       }
@@ -12625,12 +12894,15 @@ function buildDetectedIdeInfos(detectedIdes, cdpManagers) {
   }));
 }
 function buildAvailableProviders(providerLoader) {
-  return providerLoader.getAll().map((provider) => ({
+  const providers = providerLoader.getAvailableProviderInfos?.() || providerLoader.getAll();
+  return providers.map((provider) => ({
     type: provider.type,
     name: provider.displayName || provider.type,
     displayName: provider.displayName || provider.type,
     icon: provider.icon || "\u{1F4BB}",
-    category: provider.category
+    category: provider.category,
+    ...provider.installed !== void 0 ? { installed: provider.installed } : {},
+    ...provider.detectedPath !== void 0 ? { detectedPath: provider.detectedPath } : {}
   }));
 }
 function parseMessageTime(value) {
@@ -12644,17 +12916,17 @@ function parseMessageTime(value) {
 function getSessionMessageUpdatedAt(session) {
   const lastMessage = session.activeChat?.messages?.at?.(-1);
   if (!lastMessage) return 0;
-  return parseMessageTime(lastMessage.timestamp) || parseMessageTime(lastMessage.receivedAt) || parseMessageTime(lastMessage.createdAt) || 0;
+  return parseMessageTime(lastMessage.receivedAt) || 0;
 }
 function getSessionCompletionMarker(session) {
   const lastMessage = session.activeChat?.messages?.at?.(-1);
   if (!lastMessage) return "";
   const role = typeof lastMessage.role === "string" ? lastMessage.role : "";
-  if (role === "user" || role === "human") return "";
+  if (role === "user" || role === "human" || role === "system") return "";
   if (typeof lastMessage._turnKey === "string" && lastMessage._turnKey) return `turn:${lastMessage._turnKey}`;
   if (typeof lastMessage.id === "string" && lastMessage.id) return `id:${lastMessage.id}`;
   if (typeof lastMessage.index === "number" && Number.isFinite(lastMessage.index)) return `idx:${lastMessage.index}`;
-  const timestamp = parseMessageTime(lastMessage.timestamp) || parseMessageTime(lastMessage.receivedAt) || parseMessageTime(lastMessage.createdAt);
+  const timestamp = parseMessageTime(lastMessage.receivedAt);
   return timestamp > 0 ? `ts:${timestamp}` : "";
 }
 function getSessionLastUsedAt(session) {
@@ -12671,7 +12943,7 @@ function getUnreadState(hasContentChange, status, lastUsedAt, lastSeenAt, lastRo
   if (status === "generating" || status === "starting") {
     return { unread: false, inboxBucket: "working" };
   }
-  const unread = completionMarker ? completionMarker !== seenCompletionMarker : hasContentChange && lastUsedAt > lastSeenAt && lastRole !== "user" && lastRole !== "human";
+  const unread = completionMarker ? completionMarker !== seenCompletionMarker : hasContentChange && lastUsedAt > lastSeenAt && lastRole !== "user" && lastRole !== "human" && lastRole !== "system";
   return { unread, inboxBucket: unread ? "task_complete" : "idle" };
 }
 function buildRecentLaunches(recentActivity) {
@@ -12758,13 +13030,13 @@ import { execFileSync } from "child_process";
 import { spawn as spawn3 } from "child_process";
 import * as fs8 from "fs";
 import * as os15 from "os";
-import * as path13 from "path";
+import * as path15 from "path";
 var UPGRADE_HELPER_ENV = "ADHDEV_DAEMON_UPGRADE_HELPER";
 function getUpgradeLogPath() {
   const home = os15.homedir();
-  const dir = path13.join(home, ".adhdev");
+  const dir = path15.join(home, ".adhdev");
   fs8.mkdirSync(dir, { recursive: true });
-  return path13.join(dir, "daemon-upgrade.log");
+  return path15.join(dir, "daemon-upgrade.log");
 }
 function appendUpgradeLog(message) {
   const line = `[${(/* @__PURE__ */ new Date()).toISOString()}] ${message}
@@ -12797,14 +13069,14 @@ async function waitForPidExit(pid, timeoutMs) {
   while (Date.now() - start < timeoutMs) {
     try {
       process.kill(pid, 0);
-      await new Promise((resolve9) => setTimeout(resolve9, 250));
+      await new Promise((resolve12) => setTimeout(resolve12, 250));
     } catch {
       return;
     }
   }
 }
 function stopSessionHostProcesses(appName) {
-  const pidFile = path13.join(os15.homedir(), ".adhdev", `${appName}-session-host.pid`);
+  const pidFile = path15.join(os15.homedir(), ".adhdev", `${appName}-session-host.pid`);
   try {
     if (fs8.existsSync(pidFile)) {
       const pid = Number.parseInt(fs8.readFileSync(pidFile, "utf8").trim(), 10);
@@ -12833,7 +13105,7 @@ function stopSessionHostProcesses(appName) {
   }
 }
 function removeDaemonPidFile() {
-  const pidFile = path13.join(os15.homedir(), ".adhdev", "daemon.pid");
+  const pidFile = path15.join(os15.homedir(), ".adhdev", "daemon.pid");
   try {
     fs8.unlinkSync(pidFile);
   } catch {
@@ -12844,7 +13116,7 @@ function cleanupStaleGlobalInstallDirs(pkgName) {
   const npmRoot = execFileSync(getNpmExecutable(), ["root", "-g"], { encoding: "utf8", ...npmExecOpts }).trim();
   if (!npmRoot) return;
   const npmPrefix = execFileSync(getNpmExecutable(), ["prefix", "-g"], { encoding: "utf8", ...npmExecOpts }).trim();
-  const binDir = process.platform === "win32" ? npmPrefix : path13.join(npmPrefix, "bin");
+  const binDir = process.platform === "win32" ? npmPrefix : path15.join(npmPrefix, "bin");
   const packageBaseName = pkgName.startsWith("@") ? pkgName.split("/")[1] : pkgName;
   const binNames = /* @__PURE__ */ new Set([packageBaseName]);
   if (pkgName === "@adhdev/daemon-standalone") {
@@ -12852,25 +13124,25 @@ function cleanupStaleGlobalInstallDirs(pkgName) {
   }
   if (pkgName.startsWith("@")) {
     const [scope, name] = pkgName.split("/");
-    const scopeDir = path13.join(npmRoot, scope);
+    const scopeDir = path15.join(npmRoot, scope);
     if (!fs8.existsSync(scopeDir)) return;
     for (const entry of fs8.readdirSync(scopeDir)) {
       if (!entry.startsWith(`.${name}-`)) continue;
-      fs8.rmSync(path13.join(scopeDir, entry), { recursive: true, force: true });
-      appendUpgradeLog(`Removed stale scoped staging dir: ${path13.join(scopeDir, entry)}`);
+      fs8.rmSync(path15.join(scopeDir, entry), { recursive: true, force: true });
+      appendUpgradeLog(`Removed stale scoped staging dir: ${path15.join(scopeDir, entry)}`);
     }
   } else {
     for (const entry of fs8.readdirSync(npmRoot)) {
       if (!entry.startsWith(`.${pkgName}-`)) continue;
-      fs8.rmSync(path13.join(npmRoot, entry), { recursive: true, force: true });
-      appendUpgradeLog(`Removed stale staging dir: ${path13.join(npmRoot, entry)}`);
+      fs8.rmSync(path15.join(npmRoot, entry), { recursive: true, force: true });
+      appendUpgradeLog(`Removed stale staging dir: ${path15.join(npmRoot, entry)}`);
     }
   }
   if (fs8.existsSync(binDir)) {
     for (const entry of fs8.readdirSync(binDir)) {
       if (![...binNames].some((name) => entry.startsWith(`.${name}-`))) continue;
-      fs8.rmSync(path13.join(binDir, entry), { recursive: true, force: true });
-      appendUpgradeLog(`Removed stale bin staging entry: ${path13.join(binDir, entry)}`);
+      fs8.rmSync(path15.join(binDir, entry), { recursive: true, force: true });
+      appendUpgradeLog(`Removed stale bin staging entry: ${path15.join(binDir, entry)}`);
     }
   }
 }
@@ -12912,7 +13184,7 @@ async function runDaemonUpgradeHelper(payload) {
     appendUpgradeLog(installOutput.trim());
   }
   if (process.platform === "win32") {
-    await new Promise((resolve9) => setTimeout(resolve9, 500));
+    await new Promise((resolve12) => setTimeout(resolve12, 500));
     cleanupStaleGlobalInstallDirs(payload.packageName);
     appendUpgradeLog("Post-install staging cleanup complete");
   }
@@ -12956,6 +13228,25 @@ var CHAT_COMMANDS = [
   "change_model"
 ];
 var READ_DEBUG_ENABLED2 = process.argv.includes("--dev") || process.env.ADHDEV_READ_DEBUG === "1";
+function toHostedCliRuntimeDescriptor(record) {
+  if (!record || typeof record !== "object") return null;
+  const runtimeId = typeof record.sessionId === "string" ? record.sessionId : "";
+  const cliType = typeof record.providerType === "string" ? record.providerType : "";
+  const workspace = typeof record.workspace === "string" ? record.workspace : "";
+  if (!runtimeId || !cliType || !workspace) return null;
+  return {
+    runtimeId,
+    runtimeKey: typeof record.runtimeKey === "string" ? record.runtimeKey : void 0,
+    displayName: typeof record.displayName === "string" ? record.displayName : void 0,
+    workspaceLabel: typeof record.workspaceLabel === "string" ? record.workspaceLabel : void 0,
+    lifecycle: typeof record.lifecycle === "string" ? record.lifecycle : void 0,
+    recoveryState: typeof record.meta?.runtimeRecoveryState === "string" ? String(record.meta.runtimeRecoveryState) : null,
+    cliType,
+    workspace,
+    cliArgs: Array.isArray(record.meta?.cliArgs) ? record.meta.cliArgs : [],
+    providerSessionId: typeof record.meta?.providerSessionId === "string" ? String(record.meta.providerSessionId) : void 0
+  };
+}
 var DaemonCommandRouter = class {
   deps;
   constructor(deps) {
@@ -13029,6 +13320,90 @@ var DaemonCommandRouter = class {
           return { success: false, error: e.message };
         }
       }
+      case "session_host_get_diagnostics": {
+        if (!this.deps.sessionHostControl) return { success: false, error: "Session host control unavailable" };
+        const diagnostics = await this.deps.sessionHostControl.getDiagnostics({
+          includeSessions: args?.includeSessions !== false,
+          limit: Number(args?.limit) || void 0
+        });
+        return { success: true, diagnostics };
+      }
+      case "session_host_list_sessions": {
+        if (!this.deps.sessionHostControl) return { success: false, error: "Session host control unavailable" };
+        const sessions = await this.deps.sessionHostControl.listSessions();
+        return { success: true, sessions };
+      }
+      case "session_host_stop_session": {
+        if (!this.deps.sessionHostControl) return { success: false, error: "Session host control unavailable" };
+        const sessionId = typeof args?.sessionId === "string" ? args.sessionId : "";
+        if (!sessionId) return { success: false, error: "sessionId required" };
+        const record = await this.deps.sessionHostControl.stopSession(sessionId);
+        return { success: true, record };
+      }
+      case "session_host_resume_session": {
+        if (!this.deps.sessionHostControl) return { success: false, error: "Session host control unavailable" };
+        const sessionId = typeof args?.sessionId === "string" ? args.sessionId : "";
+        if (!sessionId) return { success: false, error: "sessionId required" };
+        const record = await this.deps.sessionHostControl.resumeSession(sessionId);
+        const hosted = toHostedCliRuntimeDescriptor(record);
+        if (hosted) {
+          await this.deps.cliManager.restoreHostedSessions([hosted]);
+        }
+        return { success: true, record };
+      }
+      case "session_host_restart_session": {
+        if (!this.deps.sessionHostControl) return { success: false, error: "Session host control unavailable" };
+        const sessionId = typeof args?.sessionId === "string" ? args.sessionId : "";
+        if (!sessionId) return { success: false, error: "sessionId required" };
+        const record = await this.deps.sessionHostControl.restartSession(sessionId);
+        const hosted = toHostedCliRuntimeDescriptor(record);
+        if (hosted) {
+          await this.deps.cliManager.restoreHostedSessions([hosted]);
+        }
+        return { success: true, record };
+      }
+      case "session_host_send_signal": {
+        if (!this.deps.sessionHostControl) return { success: false, error: "Session host control unavailable" };
+        const sessionId = typeof args?.sessionId === "string" ? args.sessionId : "";
+        const signal = typeof args?.signal === "string" ? args.signal : "";
+        if (!sessionId) return { success: false, error: "sessionId required" };
+        if (!signal) return { success: false, error: "signal required" };
+        const record = await this.deps.sessionHostControl.sendSignal(sessionId, signal);
+        return { success: true, record };
+      }
+      case "session_host_force_detach_client": {
+        if (!this.deps.sessionHostControl) return { success: false, error: "Session host control unavailable" };
+        const sessionId = typeof args?.sessionId === "string" ? args.sessionId : "";
+        const clientId = typeof args?.clientId === "string" ? args.clientId : "";
+        if (!sessionId) return { success: false, error: "sessionId required" };
+        if (!clientId) return { success: false, error: "clientId required" };
+        const record = await this.deps.sessionHostControl.forceDetachClient(sessionId, clientId);
+        return { success: true, record };
+      }
+      case "session_host_acquire_write": {
+        if (!this.deps.sessionHostControl) return { success: false, error: "Session host control unavailable" };
+        const sessionId = typeof args?.sessionId === "string" ? args.sessionId : "";
+        const clientId = typeof args?.clientId === "string" ? args.clientId : "";
+        const ownerType = args?.ownerType === "agent" ? "agent" : "user";
+        if (!sessionId) return { success: false, error: "sessionId required" };
+        if (!clientId) return { success: false, error: "clientId required" };
+        const record = await this.deps.sessionHostControl.acquireWrite({
+          sessionId,
+          clientId,
+          ownerType,
+          force: args?.force !== false
+        });
+        return { success: true, record };
+      }
+      case "session_host_release_write": {
+        if (!this.deps.sessionHostControl) return { success: false, error: "Session host control unavailable" };
+        const sessionId = typeof args?.sessionId === "string" ? args.sessionId : "";
+        const clientId = typeof args?.clientId === "string" ? args.clientId : "";
+        if (!sessionId) return { success: false, error: "sessionId required" };
+        if (!clientId) return { success: false, error: "clientId required" };
+        const record = await this.deps.sessionHostControl.releaseWrite({ sessionId, clientId });
+        return { success: true, record };
+      }
       case "list_saved_sessions": {
         const providerType = typeof args?.providerType === "string" ? args.providerType.trim() : typeof args?.agentType === "string" ? args.agentType.trim() : "";
         const kind = args?.kind === "acp" ? "acp" : "cli";
@@ -13087,6 +13462,12 @@ var DaemonCommandRouter = class {
         if (!ideType) throw new Error("ideType required");
         const killProcess = args?.killProcess !== false;
         await this.stopIde(ideType, killProcess);
+        try {
+          const results = await detectIDEs(this.deps.providerLoader);
+          this.deps.detectedIdes.value = results;
+          this.deps.providerLoader.setIdeDetectionResults(results, true);
+        } catch {
+        }
         return { success: true, ideType, stopped: true, processKilled: killProcess };
       }
       // ─── IDE restart ───
@@ -13129,6 +13510,12 @@ var DaemonCommandRouter = class {
           }
         }
         this.deps.onIdeConnected?.();
+        try {
+          const results = await detectIDEs(this.deps.providerLoader);
+          this.deps.detectedIdes.value = results;
+          this.deps.providerLoader.setIdeDetectionResults(results, true);
+        } catch {
+        }
         if (result.success && resolvedWorkspace) {
           try {
             const next = appendRecentActivity(loadState(), {
@@ -13156,8 +13543,9 @@ var DaemonCommandRouter = class {
       }
       // ─── Detect IDEs ───
       case "detect_ides": {
-        const results = await detectIDEs();
+        const results = await detectIDEs(this.deps.providerLoader);
         this.deps.detectedIdes.value = results;
+        this.deps.providerLoader.setIdeDetectionResults(results, true);
         return { success: true, detectedInfo: results };
       }
       // ─── Set User Name ───
@@ -13557,6 +13945,14 @@ var ProviderStreamAdapter = class {
   hasScript(name) {
     return typeof this.provider.scripts?.[name] === "function";
   }
+  parseMaybeJson(raw) {
+    if (typeof raw !== "string") return raw;
+    try {
+      return JSON.parse(raw);
+    } catch {
+      return raw;
+    }
+  }
   summarizeRaw(raw) {
     try {
       if (typeof raw === "string") return raw.replace(/\s+/g, " ").trim().slice(0, 240);
@@ -13617,12 +14013,30 @@ var ProviderStreamAdapter = class {
     }
   }
   async sendMessage(evaluate, text) {
-    const script = this.callScript("sendMessage", text);
+    const params = { message: text };
+    const script = this.callScript("sendMessage", params) || this.callScript("sendMessage", text);
     if (!script) throw new Error(`[${this.agentName}] sendMessage script not available`);
     const result = await evaluate(script);
     if (result && typeof result === "string" && result.startsWith("error:")) {
       throw new Error(`[${this.agentName}] sendMessage failed: ${result}`);
     }
+    const parsed = this.parseMaybeJson(result);
+    if (parsed === true) return;
+    if (typeof parsed === "string") {
+      const normalized = parsed.trim().toLowerCase();
+      if (normalized === "ok" || normalized === "sent" || normalized === "success" || normalized === "true") {
+        return;
+      }
+    }
+    if (parsed && typeof parsed === "object") {
+      if (parsed.sent === true || parsed.success === true || parsed.ok === true || parsed.submitted === true || parsed.dispatched === true) {
+        return;
+      }
+      if (typeof parsed.error === "string" && parsed.error.trim()) {
+        throw new Error(`[${this.agentName}] sendMessage failed: ${parsed.error}`);
+      }
+    }
+    throw new Error(`[${this.agentName}] sendMessage was not confirmed`);
   }
   async resolveAction(evaluate, action, button) {
     const script = this.callScript("resolveAction", { action, button });
@@ -13645,7 +14059,10 @@ var ProviderStreamAdapter = class {
       const raw = await evaluate(script, 1e4);
       const data = typeof raw === "string" ? JSON.parse(raw) : raw;
       if (data?.error) return [];
-      return Array.isArray(data) ? data : [];
+      if (Array.isArray(data)) return data;
+      if (Array.isArray(data?.sessions)) return data.sessions;
+      if (Array.isArray(data?.chats)) return data.chats;
+      return [];
     } catch {
       return [];
     }
@@ -13653,7 +14070,17 @@ var ProviderStreamAdapter = class {
   async switchSession(evaluate, sessionId) {
     const script = this.callScript("switchSession", sessionId);
     if (!script) return false;
-    return await evaluate(script, 1e4) === true;
+    const raw = await evaluate(script, 1e4);
+    const data = this.parseMaybeJson(raw);
+    if (data === true) return true;
+    if (typeof data === "string") {
+      const normalized = data.trim().toLowerCase();
+      return normalized === "true" || normalized === "ok" || normalized === "switched" || normalized === "success";
+    }
+    if (data && typeof data === "object") {
+      return data.switched === true || data.success === true || data.ok === true;
+    }
+    return false;
   }
   async focusEditor(evaluate) {
     const script = this.callScript("focusEditor");
@@ -14343,11 +14770,11 @@ var ProviderInstanceManager = class {
 
 // src/providers/version-archive.ts
 import * as fs10 from "fs";
-import * as path14 from "path";
+import * as path16 from "path";
 import * as os16 from "os";
 import { execSync as execSync5 } from "child_process";
 import { platform as platform7 } from "os";
-var ARCHIVE_PATH = path14.join(os16.homedir(), ".adhdev", "version-history.json");
+var ARCHIVE_PATH = path16.join(os16.homedir(), ".adhdev", "version-history.json");
 var MAX_ENTRIES_PER_PROVIDER = 20;
 var VersionArchive = class {
   history = {};
@@ -14394,7 +14821,7 @@ var VersionArchive = class {
   }
   save() {
     try {
-      fs10.mkdirSync(path14.dirname(ARCHIVE_PATH), { recursive: true });
+      fs10.mkdirSync(path16.dirname(ARCHIVE_PATH), { recursive: true });
       fs10.writeFileSync(ARCHIVE_PATH, JSON.stringify(this.history, null, 2));
     } catch {
     }
@@ -14435,7 +14862,7 @@ function checkPathExists2(paths) {
   for (const p of paths) {
     if (p.includes("*")) {
       const home = os16.homedir();
-      const resolved = p.replace(/\*/g, home.split(path14.sep).pop() || "");
+      const resolved = p.replace(/\*/g, home.split(path16.sep).pop() || "");
       if (fs10.existsSync(resolved)) return resolved;
     } else {
       if (fs10.existsSync(p)) return p;
@@ -14445,7 +14872,7 @@ function checkPathExists2(paths) {
 }
 function getMacAppVersion(appPath) {
   if (platform7() !== "darwin" || !appPath.endsWith(".app")) return null;
-  const plistPath = path14.join(appPath, "Contents", "Info.plist");
+  const plistPath = path16.join(appPath, "Contents", "Info.plist");
   if (!fs10.existsSync(plistPath)) return null;
   const raw = runCommand(`/usr/libexec/PlistBuddy -c "Print CFBundleShortVersionString" "${plistPath}"`);
   return raw || null;
@@ -14472,7 +14899,7 @@ async function detectAllVersions(loader, archive) {
       const cliBin = provider.cli ? findBinary2(provider.cli) : null;
       let resolvedBin = cliBin;
       if (!resolvedBin && appPath && currentOs === "darwin") {
-        const bundled = path14.join(appPath, "Contents", "Resources", "app", "bin", provider.cli || "");
+        const bundled = path16.join(appPath, "Contents", "Resources", "app", "bin", provider.cli || "");
         if (provider.cli && fs10.existsSync(bundled)) resolvedBin = bundled;
       }
       info.installed = !!(appPath || resolvedBin);
@@ -14513,7 +14940,7 @@ async function detectAllVersions(loader, archive) {
 // src/daemon/dev-server.ts
 import * as http2 from "http";
 import * as fs14 from "fs";
-import * as path18 from "path";
+import * as path20 from "path";
 
 // src/daemon/scaffold-template.ts
 function generateFiles(type, name, category, opts = {}) {
@@ -14850,7 +15277,7 @@ init_logger();
 // src/daemon/dev-cdp-handlers.ts
 init_logger();
 import * as fs11 from "fs";
-import * as path15 from "path";
+import * as path17 from "path";
 async function handleCdpEvaluate(ctx, req, res) {
   const body = await ctx.readBody(req);
   const { expression, timeout, ideType } = body;
@@ -15028,17 +15455,17 @@ async function handleScriptHints(ctx, type, _req, res) {
     return;
   }
   let scriptsPath = "";
-  const directScripts = path15.join(dir, "scripts.js");
+  const directScripts = path17.join(dir, "scripts.js");
   if (fs11.existsSync(directScripts)) {
     scriptsPath = directScripts;
   } else {
-    const scriptsDir = path15.join(dir, "scripts");
+    const scriptsDir = path17.join(dir, "scripts");
     if (fs11.existsSync(scriptsDir)) {
       const versions = fs11.readdirSync(scriptsDir).filter((d) => {
-        return fs11.statSync(path15.join(scriptsDir, d)).isDirectory();
+        return fs11.statSync(path17.join(scriptsDir, d)).isDirectory();
       }).sort().reverse();
       for (const ver of versions) {
-        const p = path15.join(scriptsDir, ver, "scripts.js");
+        const p = path17.join(scriptsDir, ver, "scripts.js");
         if (fs11.existsSync(p)) {
           scriptsPath = p;
           break;
@@ -15857,7 +16284,7 @@ async function handleDomContext(ctx, type, req, res) {
 
 // src/daemon/dev-cli-debug.ts
 import * as fs12 from "fs";
-import * as path16 from "path";
+import * as path18 from "path";
 function slugifyFixtureName(value) {
   const normalized = String(value || "").trim().toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "");
   return normalized || `fixture-${Date.now()}`;
@@ -15867,11 +16294,11 @@ function getCliFixtureDir(ctx, type) {
   if (!providerDir) {
     throw new Error(`Provider directory not found for '${type}'`);
   }
-  return path16.join(providerDir, "fixtures");
+  return path18.join(providerDir, "fixtures");
 }
 function readCliFixture(ctx, type, name) {
   const fixtureDir = getCliFixtureDir(ctx, type);
-  const filePath = path16.join(fixtureDir, `${name}.json`);
+  const filePath = path18.join(fixtureDir, `${name}.json`);
   if (!fs12.existsSync(filePath)) {
     throw new Error(`Fixture not found: ${filePath}`);
   }
@@ -16031,7 +16458,7 @@ function getCliTargetBundle(ctx, type, instanceId) {
   return { target, instance, adapter };
 }
 function sleep(ms) {
-  return new Promise((resolve9) => setTimeout(resolve9, ms));
+  return new Promise((resolve12) => setTimeout(resolve12, ms));
 }
 async function waitForCliReady(ctx, type, instanceId, timeoutMs) {
   const startedAt = Date.now();
@@ -16630,7 +17057,7 @@ async function handleCliFixtureCapture(ctx, req, res) {
       },
       notes: typeof body?.notes === "string" ? body.notes : void 0
     };
-    const filePath = path16.join(fixtureDir, `${name}.json`);
+    const filePath = path18.join(fixtureDir, `${name}.json`);
     fs12.writeFileSync(filePath, JSON.stringify(fixture, null, 2));
     ctx.json(res, 200, {
       saved: true,
@@ -16654,7 +17081,7 @@ async function handleCliFixtureList(ctx, type, _req, res) {
       return;
     }
     const fixtures = fs12.readdirSync(fixtureDir).filter((file) => file.endsWith(".json")).sort((a, b) => b.localeCompare(a, void 0, { numeric: true, sensitivity: "base" })).map((file) => {
-      const fullPath = path16.join(fixtureDir, file);
+      const fullPath = path18.join(fixtureDir, file);
       try {
         const raw = JSON.parse(fs12.readFileSync(fullPath, "utf-8"));
         return {
@@ -16790,7 +17217,7 @@ async function handleCliRaw(ctx, req, res) {
 
 // src/daemon/dev-auto-implement.ts
 import * as fs13 from "fs";
-import * as path17 from "path";
+import * as path19 from "path";
 import * as os17 from "os";
 function getAutoImplPid(ctx) {
   const proc = ctx.autoImplProcess;
@@ -16830,22 +17257,22 @@ function getLatestScriptVersionDir(scriptsDir) {
   if (!fs13.existsSync(scriptsDir)) return null;
   const versions = fs13.readdirSync(scriptsDir).filter((d) => {
     try {
-      return fs13.statSync(path17.join(scriptsDir, d)).isDirectory();
+      return fs13.statSync(path19.join(scriptsDir, d)).isDirectory();
     } catch {
       return false;
     }
   }).sort((a, b) => b.localeCompare(a, void 0, { numeric: true, sensitivity: "base" }));
   if (versions.length === 0) return null;
-  return path17.join(scriptsDir, versions[0]);
+  return path19.join(scriptsDir, versions[0]);
 }
 function resolveAutoImplWritableProviderDir(ctx, category, type, requestedDir) {
-  const canonicalUserDir = path17.resolve(ctx.providerLoader.getUserProviderDir(category, type));
-  const desiredDir = requestedDir ? path17.resolve(requestedDir) : canonicalUserDir;
-  const upstreamRoot = path17.resolve(ctx.providerLoader.getUpstreamDir());
-  if (desiredDir === upstreamRoot || desiredDir.startsWith(`${upstreamRoot}${path17.sep}`)) {
+  const canonicalUserDir = path19.resolve(ctx.providerLoader.getUserProviderDir(category, type));
+  const desiredDir = requestedDir ? path19.resolve(requestedDir) : canonicalUserDir;
+  const upstreamRoot = path19.resolve(ctx.providerLoader.getUpstreamDir());
+  if (desiredDir === upstreamRoot || desiredDir.startsWith(`${upstreamRoot}${path19.sep}`)) {
     return { dir: null, reason: `Refusing to write into upstream provider directory: ${desiredDir}` };
   }
-  if (path17.basename(desiredDir) !== type) {
+  if (path19.basename(desiredDir) !== type) {
     return { dir: null, reason: `Requested writable provider directory must end with '${type}': ${desiredDir}` };
   }
   const sourceDir = ctx.findProviderDir(type);
@@ -16853,11 +17280,11 @@ function resolveAutoImplWritableProviderDir(ctx, category, type, requestedDir) {
     return { dir: null, reason: `Provider source directory not found for '${type}'` };
   }
   if (!fs13.existsSync(desiredDir)) {
-    fs13.mkdirSync(path17.dirname(desiredDir), { recursive: true });
+    fs13.mkdirSync(path19.dirname(desiredDir), { recursive: true });
     fs13.cpSync(sourceDir, desiredDir, { recursive: true });
     ctx.log(`Auto-implement writable copy created: ${desiredDir}`);
   }
-  const providerJson = path17.join(desiredDir, "provider.json");
+  const providerJson = path19.join(desiredDir, "provider.json");
   if (!fs13.existsSync(providerJson)) {
     return { dir: null, reason: `provider.json not found in writable provider directory: ${desiredDir}` };
   }
@@ -16880,13 +17307,13 @@ function loadAutoImplReferenceScripts(ctx, referenceType) {
   const refDir = ctx.findProviderDir(referenceType);
   if (!refDir || !fs13.existsSync(refDir)) return {};
   const referenceScripts = {};
-  const scriptsDir = path17.join(refDir, "scripts");
+  const scriptsDir = path19.join(refDir, "scripts");
   const latestDir = getLatestScriptVersionDir(scriptsDir);
   if (!latestDir) return referenceScripts;
   for (const file of fs13.readdirSync(latestDir)) {
     if (!file.endsWith(".js")) continue;
     try {
-      referenceScripts[file] = fs13.readFileSync(path17.join(latestDir, file), "utf-8");
+      referenceScripts[file] = fs13.readFileSync(path19.join(latestDir, file), "utf-8");
     } catch {
     }
   }
@@ -16994,9 +17421,9 @@ async function handleAutoImplement(ctx, type, req, res) {
     });
     const referenceScripts = loadAutoImplReferenceScripts(ctx, resolvedReference);
     const prompt = buildAutoImplPrompt(ctx, type, provider, providerDir, functions, domContext, referenceScripts, comment, resolvedReference, verification);
-    const tmpDir = path17.join(os17.tmpdir(), "adhdev-autoimpl");
+    const tmpDir = path19.join(os17.tmpdir(), "adhdev-autoimpl");
     if (!fs13.existsSync(tmpDir)) fs13.mkdirSync(tmpDir, { recursive: true });
-    const promptFile = path17.join(tmpDir, `prompt-${type}-${Date.now()}.md`);
+    const promptFile = path19.join(tmpDir, `prompt-${type}-${Date.now()}.md`);
     fs13.writeFileSync(promptFile, prompt, "utf-8");
     ctx.log(`Auto-implement prompt written to ${promptFile} (${prompt.length} chars)`);
     const agentProvider = ctx.providerLoader.resolve(agent) || ctx.providerLoader.getMeta(agent);
@@ -17423,7 +17850,7 @@ function buildAutoImplPrompt(ctx, type, provider, providerDir, functions, domCon
     setMode: "set_mode.js"
   };
   const targetFileNames = new Set(functions.map((fn) => funcToFile[fn]).filter(Boolean));
-  const scriptsDir = path17.join(providerDir, "scripts");
+  const scriptsDir = path19.join(providerDir, "scripts");
   const latestScriptsDir = getLatestScriptVersionDir(scriptsDir);
   if (latestScriptsDir) {
     lines.push(`Scripts version directory: \`${latestScriptsDir}\``);
@@ -17434,7 +17861,7 @@ function buildAutoImplPrompt(ctx, type, provider, providerDir, functions, domCon
     for (const file of fs13.readdirSync(latestScriptsDir)) {
       if (file.endsWith(".js") && targetFileNames.has(file)) {
         try {
-          const content = fs13.readFileSync(path17.join(latestScriptsDir, file), "utf-8");
+          const content = fs13.readFileSync(path19.join(latestScriptsDir, file), "utf-8");
           lines.push(`### \`${file}\` \u270F\uFE0F EDIT`);
           lines.push("```javascript");
           lines.push(content);
@@ -17451,7 +17878,7 @@ function buildAutoImplPrompt(ctx, type, provider, providerDir, functions, domCon
       lines.push("");
       for (const file of refFiles) {
         try {
-          const content = fs13.readFileSync(path17.join(latestScriptsDir, file), "utf-8");
+          const content = fs13.readFileSync(path19.join(latestScriptsDir, file), "utf-8");
           lines.push(`### \`${file}\` \u{1F512}`);
           lines.push("```javascript");
           lines.push(content);
@@ -17492,10 +17919,10 @@ function buildAutoImplPrompt(ctx, type, provider, providerDir, functions, domCon
       lines.push("");
     }
   }
-  const docsDir = path17.join(providerDir, "../../docs");
+  const docsDir = path19.join(providerDir, "../../docs");
   const loadGuide = (name) => {
     try {
-      const p = path17.join(docsDir, name);
+      const p = path19.join(docsDir, name);
       if (fs13.existsSync(p)) return fs13.readFileSync(p, "utf-8");
     } catch {
     }
@@ -17730,7 +18157,7 @@ function buildCliAutoImplPrompt(ctx, type, provider, providerDir, functions, ref
     parseApproval: "parse_approval.js"
   };
   const targetFileNames = new Set(functions.map((fn) => funcToFile[fn]).filter(Boolean));
-  const scriptsDir = path17.join(providerDir, "scripts");
+  const scriptsDir = path19.join(providerDir, "scripts");
   const latestScriptsDir = getLatestScriptVersionDir(scriptsDir);
   if (latestScriptsDir) {
     lines.push(`Scripts version directory: \`${latestScriptsDir}\``);
@@ -17742,7 +18169,7 @@ function buildCliAutoImplPrompt(ctx, type, provider, providerDir, functions, ref
       if (!file.endsWith(".js")) continue;
       if (!targetFileNames.has(file)) continue;
       try {
-        const content = fs13.readFileSync(path17.join(latestScriptsDir, file), "utf-8");
+        const content = fs13.readFileSync(path19.join(latestScriptsDir, file), "utf-8");
         lines.push(`### \`${file}\` \u270F\uFE0F EDIT`);
         lines.push("```javascript");
         lines.push(content);
@@ -17758,7 +18185,7 @@ function buildCliAutoImplPrompt(ctx, type, provider, providerDir, functions, ref
       lines.push("");
       for (const file of refFiles) {
         try {
-          const content = fs13.readFileSync(path17.join(latestScriptsDir, file), "utf-8");
+          const content = fs13.readFileSync(path19.join(latestScriptsDir, file), "utf-8");
           lines.push(`### \`${file}\` \u{1F512}`);
           lines.push("```javascript");
           lines.push(content);
@@ -17791,10 +18218,10 @@ function buildCliAutoImplPrompt(ctx, type, provider, providerDir, functions, ref
       lines.push("");
     }
   }
-  const docsDir = path17.join(providerDir, "../../docs");
+  const docsDir = path19.join(providerDir, "../../docs");
   const loadGuide = (name) => {
     try {
-      const p = path17.join(docsDir, name);
+      const p = path19.join(docsDir, name);
       if (fs13.existsSync(p)) return fs13.readFileSync(p, "utf-8");
     } catch {
     }
@@ -18205,8 +18632,8 @@ var DevServer = class _DevServer {
   }
   getEndpointList() {
     return this.routes.map((r) => {
-      const path19 = typeof r.pattern === "string" ? r.pattern : r.pattern.source.replace(/\\\//g, "/").replace(/\(\[.*?\]\+\)/g, ":type").replace(/[\^$]/g, "");
-      return `${r.method.padEnd(5)} ${path19}`;
+      const path21 = typeof r.pattern === "string" ? r.pattern : r.pattern.source.replace(/\\\//g, "/").replace(/\(\[.*?\]\+\)/g, ":type").replace(/[\^$]/g, "");
+      return `${r.method.padEnd(5)} ${path21}`;
     });
   }
   async start(port = DEV_SERVER_PORT) {
@@ -18237,15 +18664,15 @@ var DevServer = class _DevServer {
         this.json(res, 500, { error: e.message });
       }
     });
-    return new Promise((resolve9, reject) => {
+    return new Promise((resolve12, reject) => {
       this.server.listen(port, "127.0.0.1", () => {
         this.log(`Dev server listening on http://127.0.0.1:${port}`);
-        resolve9();
+        resolve12();
       });
       this.server.on("error", (e) => {
         if (e.code === "EADDRINUSE") {
           this.log(`Port ${port} in use, skipping dev server`);
-          resolve9();
+          resolve12();
         } else {
           reject(e);
         }
@@ -18328,20 +18755,20 @@ var DevServer = class _DevServer {
       child.stderr?.on("data", (d) => {
         stderr += d.toString().slice(0, 2e3);
       });
-      await new Promise((resolve9) => {
+      await new Promise((resolve12) => {
         const timer = setTimeout(() => {
           child.kill();
-          resolve9();
+          resolve12();
         }, 3e3);
         child.on("exit", () => {
           clearTimeout(timer);
-          resolve9();
+          resolve12();
         });
         child.stdout?.once("data", () => {
           setTimeout(() => {
             child.kill();
             clearTimeout(timer);
-            resolve9();
+            resolve12();
           }, 500);
         });
       });
@@ -18488,12 +18915,12 @@ var DevServer = class _DevServer {
   // ─── DevConsole SPA ───
   getConsoleDistDir() {
     const candidates = [
-      path18.resolve(__dirname, "../../web-devconsole/dist"),
-      path18.resolve(__dirname, "../../../web-devconsole/dist"),
-      path18.join(process.cwd(), "packages/web-devconsole/dist")
+      path20.resolve(__dirname, "../../web-devconsole/dist"),
+      path20.resolve(__dirname, "../../../web-devconsole/dist"),
+      path20.join(process.cwd(), "packages/web-devconsole/dist")
     ];
     for (const dir of candidates) {
-      if (fs14.existsSync(path18.join(dir, "index.html"))) return dir;
+      if (fs14.existsSync(path20.join(dir, "index.html"))) return dir;
     }
     return null;
   }
@@ -18503,7 +18930,7 @@ var DevServer = class _DevServer {
       this.json(res, 500, { error: "DevConsole not found. Run: npm run build -w packages/web-devconsole" });
       return;
     }
-    const htmlPath = path18.join(distDir, "index.html");
+    const htmlPath = path20.join(distDir, "index.html");
     try {
       const html = fs14.readFileSync(htmlPath, "utf-8");
       res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
@@ -18528,15 +18955,15 @@ var DevServer = class _DevServer {
       this.json(res, 404, { error: "Not found" });
       return;
     }
-    const safePath = path18.normalize(pathname).replace(/^\.\.\//, "");
-    const filePath = path18.join(distDir, safePath);
+    const safePath = path20.normalize(pathname).replace(/^\.\.\//, "");
+    const filePath = path20.join(distDir, safePath);
     if (!filePath.startsWith(distDir)) {
       this.json(res, 403, { error: "Forbidden" });
       return;
     }
     try {
       const content = fs14.readFileSync(filePath);
-      const ext = path18.extname(filePath);
+      const ext = path20.extname(filePath);
       const contentType = _DevServer.MIME_MAP[ext] || "application/octet-stream";
       res.writeHead(200, { "Content-Type": contentType, "Cache-Control": "public, max-age=31536000, immutable" });
       res.end(content);
@@ -18649,9 +19076,9 @@ var DevServer = class _DevServer {
           const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
           if (entry.isDirectory()) {
             files.push({ path: rel, size: 0, type: "dir" });
-            scan(path18.join(d, entry.name), rel);
+            scan(path20.join(d, entry.name), rel);
           } else {
-            const stat = fs14.statSync(path18.join(d, entry.name));
+            const stat = fs14.statSync(path20.join(d, entry.name));
             files.push({ path: rel, size: stat.size, type: "file" });
           }
         }
@@ -18674,7 +19101,7 @@ var DevServer = class _DevServer {
       this.json(res, 404, { error: `Provider directory not found: ${type}` });
       return;
     }
-    const fullPath = path18.resolve(dir, path18.normalize(filePath));
+    const fullPath = path20.resolve(dir, path20.normalize(filePath));
     if (!fullPath.startsWith(dir)) {
       this.json(res, 403, { error: "Forbidden" });
       return;
@@ -18699,14 +19126,14 @@ var DevServer = class _DevServer {
       this.json(res, 404, { error: `Provider directory not found: ${type}` });
       return;
     }
-    const fullPath = path18.resolve(dir, path18.normalize(filePath));
+    const fullPath = path20.resolve(dir, path20.normalize(filePath));
     if (!fullPath.startsWith(dir)) {
       this.json(res, 403, { error: "Forbidden" });
       return;
     }
     try {
       if (fs14.existsSync(fullPath)) fs14.copyFileSync(fullPath, fullPath + ".bak");
-      fs14.mkdirSync(path18.dirname(fullPath), { recursive: true });
+      fs14.mkdirSync(path20.dirname(fullPath), { recursive: true });
       fs14.writeFileSync(fullPath, content, "utf-8");
       this.log(`File saved: ${fullPath} (${content.length} chars)`);
       this.providerLoader.reload();
@@ -18723,7 +19150,7 @@ var DevServer = class _DevServer {
       return;
     }
     for (const name of ["scripts.js", "provider.json"]) {
-      const p = path18.join(dir, name);
+      const p = path20.join(dir, name);
       if (fs14.existsSync(p)) {
         const source = fs14.readFileSync(p, "utf-8");
         this.json(res, 200, { type, path: p, source, lines: source.split("\n").length });
@@ -18744,8 +19171,8 @@ var DevServer = class _DevServer {
       this.json(res, 404, { error: `Provider not found: ${type}` });
       return;
     }
-    const target = fs14.existsSync(path18.join(dir, "scripts.js")) ? "scripts.js" : "provider.json";
-    const targetPath = path18.join(dir, target);
+    const target = fs14.existsSync(path20.join(dir, "scripts.js")) ? "scripts.js" : "provider.json";
+    const targetPath = path20.join(dir, target);
     try {
       if (fs14.existsSync(targetPath)) fs14.copyFileSync(targetPath, targetPath + ".bak");
       fs14.writeFileSync(targetPath, source, "utf-8");
@@ -18850,14 +19277,14 @@ var DevServer = class _DevServer {
       child.stderr?.on("data", (d) => {
         stderr += d.toString();
       });
-      await new Promise((resolve9) => {
+      await new Promise((resolve12) => {
         const timer = setTimeout(() => {
           child.kill();
-          resolve9();
+          resolve12();
         }, timeout);
         child.on("exit", () => {
           clearTimeout(timer);
-          resolve9();
+          resolve12();
         });
       });
       const elapsed = Date.now() - start;
@@ -18905,7 +19332,7 @@ var DevServer = class _DevServer {
     }
     let targetDir;
     targetDir = this.providerLoader.getUserProviderDir(category, type);
-    const jsonPath = path18.join(targetDir, "provider.json");
+    const jsonPath = path20.join(targetDir, "provider.json");
     if (fs14.existsSync(jsonPath)) {
       this.json(res, 409, { error: `Provider already exists at ${targetDir}`, path: targetDir });
       return;
@@ -18917,8 +19344,8 @@ var DevServer = class _DevServer {
       const createdFiles = ["provider.json"];
       if (result.files) {
         for (const [relPath, content] of Object.entries(result.files)) {
-          const fullPath = path18.join(targetDir, relPath);
-          fs14.mkdirSync(path18.dirname(fullPath), { recursive: true });
+          const fullPath = path20.join(targetDir, relPath);
+          fs14.mkdirSync(path20.dirname(fullPath), { recursive: true });
           fs14.writeFileSync(fullPath, content, "utf-8");
           createdFiles.push(relPath);
         }
@@ -18971,22 +19398,22 @@ var DevServer = class _DevServer {
     if (!fs14.existsSync(scriptsDir)) return null;
     const versions = fs14.readdirSync(scriptsDir).filter((d) => {
       try {
-        return fs14.statSync(path18.join(scriptsDir, d)).isDirectory();
+        return fs14.statSync(path20.join(scriptsDir, d)).isDirectory();
       } catch {
         return false;
       }
     }).sort((a, b) => b.localeCompare(a, void 0, { numeric: true, sensitivity: "base" }));
     if (versions.length === 0) return null;
-    return path18.join(scriptsDir, versions[0]);
+    return path20.join(scriptsDir, versions[0]);
   }
   resolveAutoImplWritableProviderDir(category, type, requestedDir) {
-    const canonicalUserDir = path18.resolve(this.providerLoader.getUserProviderDir(category, type));
-    const desiredDir = requestedDir ? path18.resolve(requestedDir) : canonicalUserDir;
-    const upstreamRoot = path18.resolve(this.providerLoader.getUpstreamDir());
-    if (desiredDir === upstreamRoot || desiredDir.startsWith(`${upstreamRoot}${path18.sep}`)) {
+    const canonicalUserDir = path20.resolve(this.providerLoader.getUserProviderDir(category, type));
+    const desiredDir = requestedDir ? path20.resolve(requestedDir) : canonicalUserDir;
+    const upstreamRoot = path20.resolve(this.providerLoader.getUpstreamDir());
+    if (desiredDir === upstreamRoot || desiredDir.startsWith(`${upstreamRoot}${path20.sep}`)) {
       return { dir: null, reason: `Refusing to write into upstream provider directory: ${desiredDir}` };
     }
-    if (path18.basename(desiredDir) !== type) {
+    if (path20.basename(desiredDir) !== type) {
       return { dir: null, reason: `Requested writable provider directory must end with '${type}': ${desiredDir}` };
     }
     const sourceDir = this.findProviderDir(type);
@@ -18994,11 +19421,11 @@ var DevServer = class _DevServer {
       return { dir: null, reason: `Provider source directory not found for '${type}'` };
     }
     if (!fs14.existsSync(desiredDir)) {
-      fs14.mkdirSync(path18.dirname(desiredDir), { recursive: true });
+      fs14.mkdirSync(path20.dirname(desiredDir), { recursive: true });
       fs14.cpSync(sourceDir, desiredDir, { recursive: true });
       this.log(`Auto-implement writable copy created: ${desiredDir}`);
     }
-    const providerJson = path18.join(desiredDir, "provider.json");
+    const providerJson = path20.join(desiredDir, "provider.json");
     if (!fs14.existsSync(providerJson)) {
       return { dir: null, reason: `provider.json not found in writable provider directory: ${desiredDir}` };
     }
@@ -19046,7 +19473,7 @@ var DevServer = class _DevServer {
       setMode: "set_mode.js"
     };
     const targetFileNames = new Set(functions.map((fn) => funcToFile[fn]).filter(Boolean));
-    const scriptsDir = path18.join(providerDir, "scripts");
+    const scriptsDir = path20.join(providerDir, "scripts");
     const latestScriptsDir = this.getLatestScriptVersionDir(scriptsDir);
     if (latestScriptsDir) {
       lines.push(`Scripts version directory: \`${latestScriptsDir}\``);
@@ -19057,7 +19484,7 @@ var DevServer = class _DevServer {
       for (const file of fs14.readdirSync(latestScriptsDir)) {
         if (file.endsWith(".js") && targetFileNames.has(file)) {
           try {
-            const content = fs14.readFileSync(path18.join(latestScriptsDir, file), "utf-8");
+            const content = fs14.readFileSync(path20.join(latestScriptsDir, file), "utf-8");
             lines.push(`### \`${file}\` \u270F\uFE0F EDIT`);
             lines.push("```javascript");
             lines.push(content);
@@ -19074,7 +19501,7 @@ var DevServer = class _DevServer {
         lines.push("");
         for (const file of refFiles) {
           try {
-            const content = fs14.readFileSync(path18.join(latestScriptsDir, file), "utf-8");
+            const content = fs14.readFileSync(path20.join(latestScriptsDir, file), "utf-8");
             lines.push(`### \`${file}\` \u{1F512}`);
             lines.push("```javascript");
             lines.push(content);
@@ -19115,10 +19542,10 @@ var DevServer = class _DevServer {
         lines.push("");
       }
     }
-    const docsDir = path18.join(providerDir, "../../docs");
+    const docsDir = path20.join(providerDir, "../../docs");
     const loadGuide = (name) => {
       try {
-        const p = path18.join(docsDir, name);
+        const p = path20.join(docsDir, name);
         if (fs14.existsSync(p)) return fs14.readFileSync(p, "utf-8");
       } catch {
       }
@@ -19292,7 +19719,7 @@ var DevServer = class _DevServer {
       parseApproval: "parse_approval.js"
     };
     const targetFileNames = new Set(functions.map((fn) => funcToFile[fn]).filter(Boolean));
-    const scriptsDir = path18.join(providerDir, "scripts");
+    const scriptsDir = path20.join(providerDir, "scripts");
     const latestScriptsDir = this.getLatestScriptVersionDir(scriptsDir);
     if (latestScriptsDir) {
       lines.push(`Scripts version directory: \`${latestScriptsDir}\``);
@@ -19304,7 +19731,7 @@ var DevServer = class _DevServer {
         if (!file.endsWith(".js")) continue;
         if (!targetFileNames.has(file)) continue;
         try {
-          const content = fs14.readFileSync(path18.join(latestScriptsDir, file), "utf-8");
+          const content = fs14.readFileSync(path20.join(latestScriptsDir, file), "utf-8");
           lines.push(`### \`${file}\` \u270F\uFE0F EDIT`);
           lines.push("```javascript");
           lines.push(content);
@@ -19320,7 +19747,7 @@ var DevServer = class _DevServer {
         lines.push("");
         for (const file of refFiles) {
           try {
-            const content = fs14.readFileSync(path18.join(latestScriptsDir, file), "utf-8");
+            const content = fs14.readFileSync(path20.join(latestScriptsDir, file), "utf-8");
             lines.push(`### \`${file}\` \u{1F512}`);
             lines.push("```javascript");
             lines.push(content);
@@ -19353,10 +19780,10 @@ var DevServer = class _DevServer {
         lines.push("");
       }
     }
-    const docsDir = path18.join(providerDir, "../../docs");
+    const docsDir = path20.join(providerDir, "../../docs");
     const loadGuide = (name) => {
       try {
-        const p = path18.join(docsDir, name);
+        const p = path20.join(docsDir, name);
         if (fs14.existsSync(p)) return fs14.readFileSync(p, "utf-8");
       } catch {
       }
@@ -19532,14 +19959,14 @@ data: ${JSON.stringify(msg.data)}
     res.end(JSON.stringify(data, null, 2));
   }
   async readBody(req) {
-    return new Promise((resolve9) => {
+    return new Promise((resolve12) => {
       let body = "";
       req.on("data", (chunk) => body += chunk);
       req.on("end", () => {
         try {
-          resolve9(JSON.parse(body));
+          resolve12(JSON.parse(body));
         } catch {
-          resolve9({});
+          resolve12({});
         }
       });
     });
@@ -19875,6 +20302,7 @@ var SessionHostRuntimeTransport = class {
     }
   }
   handleEvent(event) {
+    if (!("sessionId" in event)) return;
     if (event.sessionId !== this.options.runtimeId) return;
     if ((event.type === "session_started" || event.type === "session_resumed") && typeof event.pid === "number") {
       this.currentPid = event.pid;
@@ -19950,7 +20378,10 @@ var SessionHostRuntimeTransport = class {
         clientId: client.clientId,
         type: client.type,
         readOnly: client.readOnly
-      }))
+      })),
+      restoredFromStorage: record.meta?.restoredFromStorage === true,
+      recoveryState: typeof record.meta?.runtimeRecoveryState === "string" ? String(record.meta.runtimeRecoveryState) : null,
+      recoveryError: typeof record.meta?.runtimeRecoveryError === "string" ? String(record.meta.runtimeRecoveryError) : null
     };
   }
   enqueue(action) {
@@ -20008,7 +20439,7 @@ async function waitForReady(endpoint, timeoutMs = STARTUP_TIMEOUT_MS) {
   const deadline = Date.now() + timeoutMs;
   while (Date.now() < deadline) {
     if (await canConnect(endpoint)) return;
-    await new Promise((resolve9) => setTimeout(resolve9, STARTUP_POLL_MS));
+    await new Promise((resolve12) => setTimeout(resolve12, STARTUP_POLL_MS));
   }
   throw new Error(`Session host did not become ready within ${timeoutMs}ms`);
 }
@@ -20164,10 +20595,10 @@ async function installExtension(ide, extension) {
         const buffer = Buffer.from(await res.arrayBuffer());
         const fs15 = await import("fs");
         fs15.writeFileSync(vsixPath, buffer);
-        return new Promise((resolve9) => {
+        return new Promise((resolve12) => {
           const cmd = `"${ide.cliCommand}" --install-extension "${vsixPath}" --force`;
           exec2(cmd, { timeout: 6e4 }, (error, _stdout, stderr) => {
-            resolve9({
+            resolve12({
               extensionId: extension.id,
               marketplaceId: extension.marketplaceId,
               success: !error,
@@ -20180,11 +20611,11 @@ async function installExtension(ide, extension) {
     } catch (e) {
     }
   }
-  return new Promise((resolve9) => {
+  return new Promise((resolve12) => {
     const cmd = `"${ide.cliCommand}" --install-extension ${extension.marketplaceId} --force`;
     exec2(cmd, { timeout: 6e4 }, (error, stdout, stderr) => {
       if (error) {
-        resolve9({
+        resolve12({
           extensionId: extension.id,
           marketplaceId: extension.marketplaceId,
           success: false,
@@ -20192,7 +20623,7 @@ async function installExtension(ide, extension) {
           error: stderr || error.message
         });
       } else {
-        resolve9({
+        resolve12({
           extensionId: extension.id,
           marketplaceId: extension.marketplaceId,
           success: true,
@@ -20328,13 +20759,32 @@ async function initDaemonComponents(config) {
   const detectedIdesRef = { value: [] };
   let agentStreamManager = null;
   let poller = null;
+  const refreshProviderAvailability = async (providerType) => {
+    const targetProvider = providerType ? providerLoader.getMeta(providerLoader.resolveAlias(providerType)) : null;
+    const targetCategory = targetProvider?.category;
+    if (!providerType || targetCategory === "cli" || targetCategory === "acp") {
+      if (providerType && targetProvider) {
+        const detected = await detectCLI(targetProvider.type, providerLoader, { includeVersion: false });
+        providerLoader.setProviderAvailability(targetProvider.type, {
+          installed: !!detected,
+          detectedPath: detected?.path || null
+        });
+      } else {
+        providerLoader.setCliDetectionResults(await detectCLIs(providerLoader, { includeVersion: false }), true);
+      }
+    }
+    if (!providerType || targetCategory === "ide") {
+      detectedIdesRef.value = await detectIDEs(providerLoader);
+      providerLoader.setIdeDetectionResults(detectedIdesRef.value, true);
+    }
+  };
   const cliManager = new DaemonCliManager({
     ...config.cliManagerDeps,
     getInstanceManager: () => instanceManager,
     getSessionRegistry: () => sessionRegistry
   }, providerLoader);
   LOG.info("Init", "Detecting IDEs...");
-  detectedIdesRef.value = await detectIDEs();
+  await refreshProviderAvailability();
   const installed = detectedIdesRef.value.filter((i) => i.installed);
   LOG.info("Init", `Found ${installed.length} IDE(s): ${installed.map((i) => i.id).join(", ") || "none"}`);
   const cdpSetupContext = {
@@ -20374,7 +20824,11 @@ async function initDaemonComponents(config) {
     adapters: cliManager.adapters,
     providerLoader,
     instanceManager,
-    sessionRegistry
+    sessionRegistry,
+    onProviderSettingChanged: async (providerType) => {
+      await refreshProviderAvailability(providerType);
+      config.onStatusChange?.();
+    }
   });
   agentStreamManager = new DaemonAgentStreamManager(
     LOG.forComponent("AgentStream").asLogFn(),
@@ -20397,6 +20851,7 @@ async function initDaemonComponents(config) {
     onIdeConnected: () => poller?.start(),
     onStatusChange: config.onStatusChange,
     onPostChatCommand: config.onPostChatCommand,
+    sessionHostControl: config.sessionHostControl,
     getCdpLogFn: config.getCdpLogFn || ((ideType) => LOG.forComponent(`CDP:${ideType}`).asLogFn())
   });
   poller = new AgentStreamPoller({