wtagent 0.3.0 → 0.4.0

package/src/browser/claude-web-adapter.js

@@ -22,6 +22,19 @@ export class ClaudeWebAdapter extends BaseWebAdapter {
     return /^\/chat\//;
   }
 
+  freshConversationUrlPattern() {
+    return /^\/new\/?$/;
+  }
+
+  pendingAttachmentLocators() {
+    return [
+      this.page.locator(
+        'form [data-testid="file-thumbnail"], '
+          + 'form button[aria-label*="remove file" i]',
+      ),
+    ];
+  }
+
   composerLocators() {
     return [
       this.page.locator('[data-testid="chat-input"]'),

package/src/browser/fake-web-model-adapter.js

@@ -7,17 +7,110 @@ export class FakeWebModelAdapter {
     this.mode = null;
     this.conversationUrl = "https://chatgpt.com/";
     this.lastAssistantMessageId = null;
+    this.lastAssistantTurn = null;
     this.responseNumber = 0;
     this.startConversationCalls = [];
     this.startConversationOptions = [];
+    this.startConversationOutcome = null;
     this.sentAttachments = [];
+    this.sentOutboundIds = [];
+    this.targetId = "fake-target";
+    this.lastUserMessageId = null;
+    this.lastSendStatus = "not-submitted";
+    this.conversationIdentityListener = null;
+    this.pendingOutboundRecoverySupported = true;
+    this.recoveryTargetCalls = [];
+    this.reconciliationCalls = [];
+    this.reconciliationOutcome = null;
     // Records window-state calls so tests can assert restore/minimize ordering.
     this.windowStateCalls = [];
   }
 
-  async launch(preferredUrl = null) {
+  async launch(preferredUrl = null, options = {}) {
     this.launched = true;
     this.lastLaunchUrl = preferredUrl;
+    this.lastLaunchOptions = options;
+  }
+
+  supportsPendingOutboundRecovery() {
+    return this.pendingOutboundRecoverySupported;
+  }
+
+  async launchRecoveryTarget(targetId) {
+    this.launched = true;
+    this.recoveryTargetCalls.push(targetId);
+    if (!targetId || targetId !== this.targetId) {
+      const error = new Error("The fake recovery target is unavailable.");
+      error.code = "RECOVERY_TARGET_UNAVAILABLE";
+      throw error;
+    }
+    return {
+      conversationUrl: this.conversationUrl,
+      targetId,
+    };
+  }
+
+  async reconcilePendingOutbound(options = {}) {
+    this.reconciliationCalls.push(options);
+    const outcome = typeof this.reconciliationOutcome === "function"
+      ? await this.reconciliationOutcome(options)
+      : this.reconciliationOutcome;
+    if (!outcome) {
+      const error = new Error("The fake pending outbound remains uncertain.");
+      error.code = "OUTBOUND_COMMIT_UNCERTAIN";
+      throw error;
+    }
+    if (outcome.conversationUrl) {
+      this.conversationUrl = outcome.conversationUrl;
+    }
+    if (outcome.conversationTargetId) {
+      this.targetId = outcome.conversationTargetId;
+    }
+    this.lastUserMessageId = outcome.userMessageId ?? this.lastUserMessageId;
+    if (outcome.status === "complete") {
+      this.lastAssistantMessageId = outcome.assistantMessageId
+        ?? this.lastAssistantMessageId;
+      this.lastAssistantTurn = outcome.assistantTurn ?? this.lastAssistantTurn;
+    }
+    return outcome;
+  }
+
+  classifyConversationUrl(value) {
+    try {
+      const url = new URL(value);
+      if (url.protocol !== "https:" || url.origin !== "https://chatgpt.com") {
+        return "invalid";
+      }
+      if (/^\/c\/WEB:/.test(url.pathname)) {
+        return "provisional";
+      }
+      if (/^\/c\//.test(url.pathname)) {
+        return "restorable";
+      }
+      return url.pathname === "/" ? "fresh" : "unknown";
+    } catch {
+      return "invalid";
+    }
+  }
+
+  setConversationIdentityListener(listener) {
+    this.conversationIdentityListener = listener;
+  }
+
+  getConversationIdentity() {
+    return {
+      conversationUrl: this.conversationUrl,
+      targetId: this.targetId,
+      kind: this.classifyConversationUrl(this.conversationUrl),
+    };
+  }
+
+  getLastSendStatus() {
+    return this.lastSendStatus;
+  }
+
+  async getLastUserMessageId() {
+    return this.lastUserMessageId;
   }
 
   async close() {
@@ -46,6 +139,19 @@ export class FakeWebModelAdapter {
     } else {
       this.conversationUrl = "https://chatgpt.com/";
     }
+    const configuredOutcome = typeof this.startConversationOutcome === "function"
+      ? await this.startConversationOutcome(conversationUrl, options)
+      : this.startConversationOutcome;
+    const isConversation = /^\/c\//.test(new URL(this.conversationUrl).pathname);
+    const outcome = configuredOutcome ?? {
+      status: isConversation ? "restored-existing" : "verified-fresh",
+      conversationUrl: this.conversationUrl,
+      targetId: this.targetId,
+    };
+    if (outcome.conversationUrl) {
+      this.conversationUrl = outcome.conversationUrl;
+    }
+    return outcome;
   }
 
   async selectMode(mode) {
@@ -63,13 +169,36 @@ export class FakeWebModelAdapter {
     return this.conversationUrl;
   }
 
-  async sendMessage(text, { files = [] } = {}) {
+  async sendMessage(text, { files = [], outboundId = null } = {}) {
+    const priorUserMessageId = this.lastUserMessageId;
+    const priorAssistantMessageId = this.lastAssistantMessageId;
+    this.lastSendStatus = "commit-unknown";
     this.sentMessages.push(text);
     this.sentAttachments.push(files);
+    this.sentOutboundIds.push(outboundId);
     if (this.conversationUrl === "https://chatgpt.com/") {
       this.conversationUrl = "https://chatgpt.com/c/fake";
     }
-    return { attachment: files.length ? { attached: files, failed: [] } : null };
+    this.lastSendStatus = "confirmed";
+    this.lastUserMessageId = `user-${this.sentMessages.length}`;
+    await this.conversationIdentityListener?.(this.getConversationIdentity());
+    return {
+      attachment: files.length ? { attached: files, failed: [] } : null,
+      userMessageId: this.lastUserMessageId,
+      userTurn: (this.sentMessages.length * 2) - 1,
+      conversationUrl: this.conversationUrl,
+      conversationTargetId: this.targetId,
+      assistantBaseline: {
+        ids: priorAssistantMessageId ? [priorAssistantMessageId] : [],
+        count: priorAssistantMessageId ? 1 : 0,
+        maxTurn: priorAssistantMessageId ? (this.responseNumber * 2) : null,
+        lastText: "",
+      },
+      preOutboundMarkerIds: [
+        priorUserMessageId,
+        priorAssistantMessageId,
+      ].filter(Boolean),
+    };
   }
 
   async waitForTurnComplete({ onDelta } = {}) {
@@ -79,6 +208,7 @@ export class FakeWebModelAdapter {
     const response = this.responses.shift();
     this.responseNumber += 1;
     this.lastAssistantMessageId = `assistant-${this.responseNumber}`;
+    this.lastAssistantTurn = this.responseNumber * 2;
     if (response instanceof Error) {
       throw response;
     }
@@ -89,4 +219,8 @@ export class FakeWebModelAdapter {
   async getLastAssistantMessageId() {
     return this.lastAssistantMessageId;
   }
+
+  async getLastAssistantTurn() {
+    return this.lastAssistantTurn;
+  }
 }

package/src/browser/gemini-web-adapter.js

@@ -25,6 +25,16 @@ export class GeminiWebAdapter extends BaseWebAdapter {
     return /^\/app\/[^/]+/;
   }
 
+  pendingAttachmentLocators() {
+    return [
+      this.page.locator(
+        '[data-test-id="textarea-wrapper"] .attachment-container, '
+          + '[data-test-id="textarea-wrapper"] '
+          + 'button[aria-label*="remove" i]',
+      ),
+    ];
+  }
+
   composerLocators() {
     return [
       this.page.locator(

package/src/browser/glm-web-adapter.js

@@ -152,8 +152,8 @@ export class GLMWebAdapter extends BaseWebAdapter {
     return 5;
   }
 
-  sentUserWaitAttempts() {
-    return 120;
+  sendConfirmationTimeoutMs() {
+    return 30_000;
   }
 
 }

package/src/cli/i18n.js

@@ -68,7 +68,7 @@ const MESSAGES = Object.freeze({
     "session.savedAt": "Session saved at: {directory}",
     "session.ctrlC": "Ctrl+C — cancelling. Press again to force quit.",
     "session.cancelledHint": "Turn cancelled. Type a new message or quit.",
-    "session.recoveryHint": "Type /retry to ask {provider} to continue again, enter a new instruction, or quit",
+    "session.recoveryHint": "Type /retry to recover the pending {provider} turn, or quit",
     "session.processesRunning": "Managed processes still running:",
     "session.resumeWith": "Resume this conversation with: wtagent resume {sessionId}",
     "attachment.attaching": "Attaching: {files}",
@@ -154,7 +154,7 @@ const MESSAGES = Object.freeze({
     "session.savedAt": "会话已保存到：{directory}",
     "session.ctrlC": "Ctrl+C — 正在取消。再次按下可强制退出。",
     "session.cancelledHint": "本轮已取消。请输入新消息或退出。",
-    "session.recoveryHint": "输入 /retry 让 {provider} 再次继续，或输入新指令，也可以退出",
+    "session.recoveryHint": "输入 /retry 恢复待处理的 {provider} 回合，或退出",
     "session.processesRunning": "仍在运行的托管进程：",
     "session.resumeWith": "继续此对话：wtagent resume {sessionId}",
     "attachment.attaching": "正在附加：{files}",
@@ -241,7 +241,7 @@ const MESSAGES = Object.freeze({
     "session.savedAt": "工作階段已儲存到：{directory}",
     "session.ctrlC": "Ctrl+C — 正在取消。再次按下可強制退出。",
     "session.cancelledHint": "本輪已取消。請輸入新訊息或退出。",
-    "session.recoveryHint": "輸入 /retry 讓 {provider} 再次繼續，或輸入新指令，也可以退出",
+    "session.recoveryHint": "輸入 /retry 恢復待處理的 {provider} 回合，或退出",
     "session.processesRunning": "仍在執行的受管程序：",
     "session.resumeWith": "繼續此對話：wtagent resume {sessionId}",
     "attachment.attaching": "正在附加：{files}",
@@ -327,7 +327,7 @@ const MESSAGES = Object.freeze({
     "session.savedAt": "セッション保存先: {directory}",
     "session.ctrlC": "Ctrl+C — キャンセル中です。もう一度押すと強制終了します。",
     "session.cancelledHint": "このターンはキャンセルされました。新しいメッセージを入力するか終了してください。",
-    "session.recoveryHint": "/retry で {provider} に再度続行させるか、新しい指示を入力するか、終了してください",
+    "session.recoveryHint": "/retry で保留中の {provider} ターンを復旧するか、終了してください",
     "session.processesRunning": "管理対象プロセスが実行中です:",
     "session.resumeWith": "この会話を再開: wtagent resume {sessionId}",
     "attachment.attaching": "添付中: {files}",
@@ -413,7 +413,7 @@ const MESSAGES = Object.freeze({
     "session.savedAt": "세션 저장 위치: {directory}",
     "session.ctrlC": "Ctrl+C — 취소 중입니다. 다시 누르면 강제 종료합니다.",
     "session.cancelledHint": "이번 턴이 취소되었습니다. 새 메시지를 입력하거나 종료하세요.",
-    "session.recoveryHint": "/retry로 {provider}에 다시 계속하도록 요청하거나 새 지시를 입력하거나 종료하세요",
+    "session.recoveryHint": "/retry로 보류 중인 {provider} 턴을 복구하거나 종료하세요",
     "session.processesRunning": "관리 중인 프로세스가 실행 중입니다:",
     "session.resumeWith": "이 대화 재개: wtagent resume {sessionId}",
     "attachment.attaching": "첨부 중: {files}",
@@ -499,7 +499,7 @@ const MESSAGES = Object.freeze({
     "session.savedAt": "Sesión guardada en: {directory}",
     "session.ctrlC": "Ctrl+C — cancelando. Pulsa de nuevo para forzar la salida.",
     "session.cancelledHint": "Turno cancelado. Escribe un nuevo mensaje o sal.",
-    "session.recoveryHint": "Escribe /retry para pedir a {provider} que continúe de nuevo, introduce otra instrucción o sal",
+    "session.recoveryHint": "Escribe /retry para recuperar el turno pendiente de {provider}, o sal",
     "session.processesRunning": "Procesos administrados aún en ejecución:",
     "session.resumeWith": "Reanuda esta conversación con: wtagent resume {sessionId}",
     "attachment.attaching": "Adjuntando: {files}",
@@ -585,7 +585,7 @@ const MESSAGES = Object.freeze({
     "session.savedAt": "Session enregistrée dans : {directory}",
     "session.ctrlC": "Ctrl+C — annulation en cours. Appuyez encore pour forcer l’arrêt.",
     "session.cancelledHint": "Tour annulé. Saisissez un nouveau message ou quittez.",
-    "session.recoveryHint": "Saisissez /retry pour demander à {provider} de continuer, entrez une nouvelle instruction ou quittez",
+    "session.recoveryHint": "Saisissez /retry pour récupérer le tour {provider} en attente, ou quittez",
     "session.processesRunning": "Processus gérés encore actifs :",
     "session.resumeWith": "Reprendre cette conversation avec : wtagent resume {sessionId}",
     "attachment.attaching": "Ajout de pièces jointes : {files}",
@@ -671,7 +671,7 @@ const MESSAGES = Object.freeze({
     "session.savedAt": "Sitzung gespeichert unter: {directory}",
     "session.ctrlC": "Ctrl+C — wird abgebrochen. Erneut drücken, um das Beenden zu erzwingen.",
     "session.cancelledHint": "Durchgang abgebrochen. Neue Nachricht eingeben oder beenden.",
-    "session.recoveryHint": "Gib /retry ein, um {provider} erneut fortsetzen zu lassen, gib eine neue Anweisung ein oder beende",
+    "session.recoveryHint": "Gib /retry ein, um den ausstehenden {provider}-Durchlauf wiederherzustellen, oder beende",
     "session.processesRunning": "Verwaltete Prozesse laufen noch:",
     "session.resumeWith": "Diese Unterhaltung fortsetzen mit: wtagent resume {sessionId}",
     "attachment.attaching": "Anhängen: {files}",
@@ -757,7 +757,7 @@ const MESSAGES = Object.freeze({
     "session.savedAt": "Sessão salva em: {directory}",
     "session.ctrlC": "Ctrl+C — cancelando. Pressione novamente para forçar a saída.",
     "session.cancelledHint": "Turno cancelado. Digite uma nova mensagem ou saia.",
-    "session.recoveryHint": "Digite /retry para pedir que {provider} continue novamente, insira uma nova instrução ou saia",
+    "session.recoveryHint": "Digite /retry para recuperar o turno pendente do {provider}, ou saia",
     "session.processesRunning": "Processos gerenciados ainda em execução:",
     "session.resumeWith": "Retome esta conversa com: wtagent resume {sessionId}",
     "attachment.attaching": "Anexando: {files}",
@@ -843,7 +843,7 @@ const MESSAGES = Object.freeze({
     "session.savedAt": "Сессия сохранена в: {directory}",
     "session.ctrlC": "Ctrl+C — отмена. Нажмите ещё раз для принудительного выхода.",
     "session.cancelledHint": "Ход отменён. Введите новое сообщение или выйдите.",
-    "session.recoveryHint": "Введите /retry, чтобы снова попросить {provider} продолжить, введите новую инструкцию или выйдите",
+    "session.recoveryHint": "Введите /retry, чтобы восстановить ожидающий ход {provider}, или выйдите",
     "session.processesRunning": "Управляемые процессы всё ещё запущены:",
     "session.resumeWith": "Продолжить этот диалог: wtagent resume {sessionId}",
     "attachment.attaching": "Прикрепление: {files}",

package/src/cli/main.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import fs from "node:fs/promises";
 import path from "node:path";
+import { pathToFileURL } from "node:url";
 import { Command } from "commander";
 import { confirm, select } from "@inquirer/prompts";
 import { launchNativeLoginBrowser } from "../browser/native-login.js";
@@ -15,6 +16,7 @@ import {
 } from "../browser/provider-registry.js";
 import {
   ensureDirectory,
+  formatHomePath,
   getAppDataDir,
   getSessionsDir,
   getTasksDir,
@@ -32,6 +34,7 @@ import { ApprovalStore } from "../policy/approval-store.js";
 import { createDefaultToolRegistry } from "../tools/default-tools.js";
 import { ProcessManager } from "../tools/process-manager.js";
 import { resolveLimits } from "../shared/limits.js";
+import { BrowserAdapterError } from "../shared/errors.js";
 import { EXPORTERS } from "../session/session-export.js";
 import { getPackageVersion } from "../shared/package-info.js";
 import { extractAtMentions } from "./at-files.js";
@@ -301,13 +304,13 @@ class ConversationRunner {
           await this.approvalStore.save();
           console.log(t("approval.savedTool", {
             tool: toolCall.name,
-            file: this.approvalStore.filePath,
+            file: formatHomePath(this.approvalStore.filePath),
           }));
         } else if (choice === "always-all") {
           this.approvalStore.setAlwaysAllowAll();
           await this.approvalStore.save();
           console.log(t("approval.savedAll", {
-            file: this.approvalStore.filePath,
+            file: formatHomePath(this.approvalStore.filePath),
           }));
         }
         return true;
@@ -435,8 +438,14 @@ async function waitForProcessToExit(pid, timeoutMs = 60_000) {
 // session, ask the user how to proceed instead of failing outright: kill the
 // other session, or have the user close its Chrome window so that session
 // fails and releases the profile. Returns true when the turn should be retried.
-async function promptToResolveProfileLock(error) {
+export async function promptToResolveProfileLock(error) {
   const pid = Number(error.details?.pid);
+  if (pid === process.pid) {
+    throw new Error(
+      "The current WTAgent process still holds its browser profile lock. Refusing to terminate itself.",
+      { cause: error },
+    );
+  }
   console.log(`\n${"\x1b[33m"}${error.message}${"\x1b[0m"}`);
   const choice = await promptForSelect({
     message: t("profileLock.how"),
@@ -470,7 +479,7 @@ async function promptToResolveProfileLock(error) {
   return true;
 }
 
-async function executeSession({
+export async function executeSession({
   session,
   options,
   resume = false,
@@ -478,11 +487,14 @@ async function executeSession({
   files = [],
   chatInput = null,
   mode = null,
-}) {
+}, {
+  interactive = !options.once && process.stdin.isTTY && process.stdout.isTTY,
+  createRunner = (config) => new ConversationRunner(config),
+  readNextMessage = promptForNextMessage,
+} = {}) {
   const paths = resolveRuntimePaths(options);
   await ensureDirectory(paths.sessionsDir);
-  const interactive = !options.once && process.stdin.isTTY && process.stdout.isTTY;
-  const runner = new ConversationRunner({ session, options, interactive });
+  const runner = createRunner({ session, options, interactive });
 
   const onInterrupt = () => {
     if (runner.interrupted) {
@@ -545,9 +557,8 @@ async function executeSession({
           throw result.error;
         }
         runner.renderer.hint(t("session.cancelledHint"));
-        turnResume = true;
-        turnInPlaceRecovery = false;
-        continue;
+        // Fall through to the same input prompt as a completed turn. Never
+        // resume automatically or reuse the cancelled instruction/attachments.
       }
       if (result?.recoveryRequired) {
         if (!interactive) {
@@ -558,11 +569,30 @@ async function executeSession({
             provider: runner.renderer.providerLabel,
           }),
         );
-        const next = await promptForNextMessage(runner, activeChatInput);
+        const pendingRecovery = session.state.pendingOutbound != null
+          || session.state.pendingAssistantTurn != null;
+        let next;
+        let retryOnly = false;
+        for (;;) {
+          next = await readNextMessage(runner, activeChatInput, {
+            resolveAttachments: !pendingRecovery,
+          });
+          if (next == null) {
+            break;
+          }
+          retryOnly = next.text.trim().toLowerCase() === "/retry";
+          if (!pendingRecovery || retryOnly) {
+            break;
+          }
+          runner.renderer.hint(
+            t("session.recoveryHint", {
+              provider: runner.renderer.providerLabel,
+            }),
+          );
+        }
         if (next == null) {
           break;
         }
-        const retryOnly = next.text.trim().toLowerCase() === "/retry";
         if (!retryOnly) {
           await session.appendInstruction(next.text, { files: next.files });
         }
@@ -593,7 +623,7 @@ async function executeSession({
         }
       }
 
-      const next = await promptForNextMessage(runner, activeChatInput);
+      const next = await readNextMessage(runner, activeChatInput);
       if (next == null) {
         break;
       }
@@ -630,7 +660,11 @@ function printResumeHint(sessionId) {
 // re-prompts. Returns null for an explicit exit command, Ctrl+C, Ctrl+D, or EOF;
 // otherwise returns
 // { text, files } where files are resolved @file attachments.
-async function promptForNextMessage(runner, chatInput) {
+async function promptForNextMessage(
+  runner,
+  chatInput,
+  { resolveAttachments = true } = {},
+) {
   for (;;) {
     const answer = chatInput
       ? await chatInput.read()
@@ -651,7 +685,9 @@ async function promptForNextMessage(runner, chatInput) {
       return null;
     }
     const { text } = classified;
-    const files = await resolveMessageAttachments(runner, text);
+    const files = resolveAttachments
+      ? await resolveMessageAttachments(runner, text)
+      : [];
     return { text, files };
   }
 }
@@ -782,7 +818,7 @@ function printChatBanner(projectRoot, provider) {
   const DIM = "\x1b[2m";
   const RESET = "\x1b[0m";
   console.log("");
-  console.log(`${CYAN}WTAgent${RESET} ${DIM}· ${provider.label} · ${projectRoot}${RESET}`);
+  console.log(`${CYAN}WTAgent${RESET} ${DIM}· ${provider.label} · ${formatHomePath(projectRoot)}${RESET}`);
   console.log(`${DIM}${t("banner.controls")}${RESET}`);
   console.log("");
 }
@@ -812,6 +848,19 @@ async function runResume(sessionId, instructionParts, options) {
   await ensureDirectory(paths.sessionsDir);
   const session = await loadSession(paths, sessionId);
   await assertDirectory(session.state.projectRoot);
+  const instruction = instructionParts.join(" ").trim();
+  if (
+    instruction
+    && (
+      session.state.pendingOutbound != null
+      || session.state.pendingAssistantTurn != null
+    )
+  ) {
+    throw new BrowserAdapterError(
+      "This session has a pending browser handoff. Resume it without an instruction or attachment first.",
+      { code: "RECOVERY_REQUIRES_BARE_RESUME", recoverable: false },
+    );
+  }
 
   const provider = resolveProvider(session.state.provider ?? DEFAULT_PROVIDER);
   // A conversation belongs to one provider. --model on resume is only allowed
@@ -828,7 +877,6 @@ async function runResume(sessionId, instructionParts, options) {
     return null;
   }
 
-  const instruction = instructionParts.join(" ").trim();
   let files = [];
   if (instruction) {
     const projectRoot = session.state.projectRoot;
@@ -1002,26 +1050,33 @@ program
     await runExport(sessionId, { ...command.optsWithGlobals(), ...options });
   });
 
-program.parseAsync().catch((error) => {
-  // Expected, actionable failures carry a plain message instead of a stack
-  // trace (e.g. the provider's Chrome profile is locked by another session).
-  if (error?.code === "PROFILE_LOCKED") {
-    console.error(`Error: ${error.message}`);
+// Resolve npm's executable symlink as well as direct `node main.js` invocations.
+// Importing the session runner in tests must not start the CLI.
+const entryPath = process.argv[1]
+  ? await fs.realpath(process.argv[1]).catch(() => null)
+  : null;
+if (entryPath && import.meta.url === pathToFileURL(entryPath).href) {
+  await program.parseAsync().catch((error) => {
+    // Expected, actionable failures carry a plain message instead of a stack
+    // trace (e.g. the provider's Chrome profile is locked by another session).
+    if (error?.code === "PROFILE_LOCKED") {
+      console.error(`Error: ${error.message}`);
+      process.exitCode = 1;
+      return;
+    }
+    console.error(error.stack ?? error.message);
     process.exitCode = 1;
-    return;
-  }
-  console.error(error.stack ?? error.message);
-  process.exitCode = 1;
-}).finally(() => {
-  // By the time every command finishes, all per-command cleanup (browser
-  // detach/close, stdin raw-mode restore, process stop) has already run. A
-  // stray tty handle (e.g. a keypress-machinery listener left behind on a
-  // failed turn) can still pin the event loop, leaving a dead prompt that
-  // never returns to the shell — exit hard instead of relying on the loop
-  // to drain naturally.
-  if (process.exitCode != null && process.exitCode !== 0) {
-    process.stdin.setRawMode?.(false);
-    process.stdin.pause?.();
-    process.exit(process.exitCode);
-  }
-});
+  }).finally(() => {
+    // By the time every command finishes, all per-command cleanup (browser
+    // detach/close, stdin raw-mode restore, process stop) has already run. A
+    // stray tty handle (e.g. a keypress-machinery listener left behind on a
+    // failed turn) can still pin the event loop, leaving a dead prompt that
+    // never returns to the shell — exit hard instead of relying on the loop
+    // to drain naturally.
+    if (process.exitCode != null && process.exitCode !== 0) {
+      process.stdin.setRawMode?.(false);
+      process.stdin.pause?.();
+      process.exit(process.exitCode);
+    }
+  });
+}

package/src/platform/command-launcher.js

@@ -178,7 +178,7 @@ function buildBatchCommand(scriptPath, argv, {
 export function resolveLaunchPlan({
   program,
   argv = [],
-  cwd,
+  cwd = process.cwd(),
   env = process.env,
   platform = process.platform,
   existsSync = fs.existsSync,

package/src/platform/paths.js

@@ -7,6 +7,25 @@ import { getEnvCaseInsensitive } from "./command-launcher.js";
 const APP_NAME = "wtagent";
 const LEGACY_APP_NAME = "webagent";
 
+export function formatHomePath(filePath, {
+  platform = process.platform,
+  homeDir = os.homedir(),
+} = {}) {
+  const pathApi = platform === "win32" ? path.win32 : path.posix;
+  if (!pathApi.isAbsolute(filePath)) {
+    return filePath;
+  }
+  const relative = pathApi.relative(homeDir, filePath);
+  if (relative === "") {
+    return "~";
+  }
+  if (relative === ".." || relative.startsWith(`..${pathApi.sep}`)
+    || pathApi.isAbsolute(relative)) {
+    return filePath;
+  }
+  return `~${pathApi.sep}${relative}`;
+}
+
 function platformAppDataDir(appName, {
   env,
   platform,

package/src/platform/windows-diagnostics.js

@@ -8,11 +8,12 @@ import { promisify } from "node:util";
 import { discoverChromeExecutable } from "./chrome-discovery.js";
 import { resolveLaunchPlan } from "./command-launcher.js";
 import { inspectCdpProfileState } from "../browser/cdp-state.js";
+import { getPackageInfo } from "../shared/package-info.js";
 
 const execFileAsync = promisify(execFile);
 
 function parseMajorMinorPatch(version) {
-  const match = String(version ?? "").replace(/^v/, "").match(/^(\d+)\.(\d+)\.(\d+)/);
+  const match = String(version ?? "").replace(/^v/, "").match(/^(\d+)\.(\d+)\.(\d+)$/);
   if (!match) {
     return null;
   }
@@ -24,20 +25,12 @@ export function isSupportedNodeVersion(version = process.version) {
   if (!parsed) {
     return false;
   }
-  const [major, minor, patch] = parsed;
-  if (major > 20) {
-    return true;
-  }
-  if (major < 20) {
-    return false;
-  }
-  if (minor > 17) {
-    return true;
-  }
-  if (minor < 17) {
-    return false;
-  }
-  return patch >= 0;
+  const [major, minor] = parsed;
+  // Keep aligned with package.json and Inquirer's supported Node releases.
+  return (major === 20 && minor >= 17)
+    || (major === 22 && minor >= 13)
+    || (major === 23 && minor >= 5)
+    || major >= 24;
 }
 
 export function detectWsl({
@@ -126,7 +119,7 @@ export function assertNativeRuntimeSupported(context = {}) {
   const version = context.version ?? process.version;
   if (!isSupportedNodeVersion(version)) {
     throw new Error(
-      `WTAgent requires Node.js 20.17.0 or newer; current runtime is ${version}.`,
+      `WTAgent requires Node.js ${getPackageInfo().engines.node}; current runtime is ${version}.`,
     );
   }