cli-wechat-bridge 1.1.7 → 1.2.0

package/bin/_run-entry.mjs

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
-
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import { spawn } from "node:child_process";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
@@ -8,6 +13,8 @@ const BIN_DIR = path.dirname(fileURLToPath(import.meta.url));
 const PROJECT_DIR = path.resolve(BIN_DIR, "..");
 export const MIN_NODE_VERSION = Object.freeze([22, 13, 0]);
 export const MIN_NODE_VERSION_TEXT = MIN_NODE_VERSION.join(".");
+export const MIN_PI_NODE_VERSION = Object.freeze([22, 19, 0]);
+export const MIN_PI_NODE_VERSION_TEXT = MIN_PI_NODE_VERSION.join(".");
 
 export function isSupportedNodeVersion(version) {
   const match = /^v?(\d+)(?:\.(\d+))?(?:\.(\d+))?/.exec(version);
@@ -24,19 +31,21 @@ export function isSupportedNodeVersion(version) {
   return true;
 }
 
-function ensureSupportedNodeVersion() {
+function ensureSupportedNodeVersion(extraArgs = []) {
   if (process.env.CLI_BRIDGE_SKIP_NODE_CHECK === "1") {
     return;
   }
 
+  const piRequested = extraArgs.some((arg, index) => arg === "pi" && extraArgs[index - 1] === "--adapter");
   if (isSupportedNodeVersion(process.versions.node)) {
-    return;
+    if (!piRequested || compareNodeVersion(process.versions.node, MIN_PI_NODE_VERSION) >= 0) return;
   }
 
+  const minimumText = piRequested ? MIN_PI_NODE_VERSION_TEXT : MIN_NODE_VERSION_TEXT;
   process.stderr.write(
     [
-      `[cli-wechat-bridge] Node.js >= ${MIN_NODE_VERSION_TEXT} is required, but you are running ${process.version}.`,
-      `[cli-wechat-bridge] 需要 Node.js >= ${MIN_NODE_VERSION_TEXT}，当前版本为 ${process.version}。`,
+      `[cli-wechat-bridge] Node.js >= ${minimumText} is required, but you are running ${process.version}.`,
+      `[cli-wechat-bridge] 需要 Node.js >= ${minimumText}，当前版本为 ${process.version}。`,
       "Install the latest LTS from https://nodejs.org/ (or via nvm), then retry.",
       "Set CLI_BRIDGE_SKIP_NODE_CHECK=1 to bypass this check at your own risk.",
       "",
@@ -45,8 +54,22 @@ function ensureSupportedNodeVersion() {
   process.exit(1);
 }
 
+function compareNodeVersion(version, minimum) {
+  const match = /^v?(\d+)(?:\.(\d+))?(?:\.(\d+))?/.exec(version);
+  if (!match) return -1;
+  const current = [Number(match[1]), Number(match[2] ?? 0), Number(match[3] ?? 0)];
+  for (let index = 0; index < minimum.length; index += 1) {
+    if (current[index] !== minimum[index]) return current[index] > minimum[index] ? 1 : -1;
+  }
+  return 0;
+}
+
+export function isSupportedPiNodeVersion(version) {
+  return compareNodeVersion(version, MIN_PI_NODE_VERSION) >= 0;
+}
+
 export function runJsEntry(relativeEntryPath, extraArgs = []) {
-  ensureSupportedNodeVersion();
+  ensureSupportedNodeVersion([...extraArgs, ...process.argv.slice(2)]);
   const entryPath = path.join(PROJECT_DIR, relativeEntryPath);
   const child = spawn(
     process.execPath,

package/bin/wechat-check-update.mjs

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
-
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import { runJsEntry } from "./_run-entry.mjs";
 
 runJsEntry("dist/commands/check-update.js", []);

package/bin/wechat-claude.mjs

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
-
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import { runJsEntry } from "./_run-entry.mjs";
 
 runJsEntry("dist/companion/local-companion-start.js", ["--adapter", "claude"]);

package/bin/wechat-codex.mjs

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
-
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import { runJsEntry } from "./_run-entry.mjs";
 
 runJsEntry("dist/companion/local-companion-start.js", ["--adapter", "codex"]);

package/bin/wechat-daemon.mjs

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
-
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import { runJsEntry } from "./_run-entry.mjs";
 
 runJsEntry("dist/daemon/wechat-daemon.js");

package/bin/wechat-opencode.mjs

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
-
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import { runJsEntry } from "./_run-entry.mjs";
 
 runJsEntry("dist/companion/local-companion-start.js", ["--adapter", "opencode"]);

package/bin/wechat-pi.mjs

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
-
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import { runJsEntry } from "./_run-entry.mjs";
 
 runJsEntry("dist/companion/local-companion-start.js", ["--adapter", "pi"]);

package/bin/wechat-setup.mjs

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
-
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import { runJsEntry } from "./_run-entry.mjs";
 
 runJsEntry("dist/wechat/setup.js");

package/bin/wecom-check-update.mjs

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
-
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import { runJsEntry } from "./_run-entry.mjs";
 
 runJsEntry("dist/commands/check-update.js");

package/bin/wecom-claude.mjs

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
-
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import { runJsEntry } from "./_run-entry.mjs";
 
 runJsEntry("dist/companion/local-companion-start.js", ["--adapter", "claude", "--channel", "wecom"]);

package/bin/wecom-codex.mjs

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
-
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import { runJsEntry } from "./_run-entry.mjs";
 
 runJsEntry("dist/companion/local-companion-start.js", ["--adapter", "codex", "--channel", "wecom"]);

package/bin/wecom-daemon.mjs

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
-
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import { runJsEntry } from "./_run-entry.mjs";
 
 runJsEntry("dist/daemon/wechat-daemon.js", ["--channel", "wecom"]);

package/bin/wecom-opencode.mjs

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
-
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import { runJsEntry } from "./_run-entry.mjs";
 
 runJsEntry("dist/companion/local-companion-start.js", ["--adapter", "opencode", "--channel", "wecom"]);

package/bin/wecom-pi.mjs

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
-
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import { runJsEntry } from "./_run-entry.mjs";
 
 runJsEntry("dist/companion/local-companion-start.js", ["--adapter", "pi", "--channel", "wecom"]);

package/bin/wecom-setup.mjs

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
-
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import { runJsEntry } from "./_run-entry.mjs";
 
 runJsEntry("dist/channels/wecom/setup-cli.js");

package/dist/bridge/adapter-control.js

@@ -0,0 +1,58 @@
+const snapshots = new WeakMap();
+export const MODEL_SNAPSHOT_TTL_MS = 5 * 60_000;
+export function invalidateModelSnapshot(adapter) {
+    snapshots.delete(adapter);
+}
+function snapshotOwner(adapter, senderId) {
+    const state = adapter.getState();
+    return JSON.stringify([
+        senderId, state.kind, state.cwd, state.pid, state.startedAt,
+        state.resumeConversationId ?? state.sharedSessionId ?? state.sharedThreadId,
+        state.lastSessionSwitchAt ?? state.lastThreadSwitchAt,
+    ]);
+}
+export async function handleAdapterControl(adapter, senderId, command) {
+    const kind = adapter.getState().kind;
+    const name = kind === "claude" ? "Claude Code" : kind === "opencode" ? "OpenCode" : kind === "codex" ? "Codex" : "Pi";
+    try {
+        if (command.type === "plan") {
+            if (!adapter.setPlanMode)
+                throw new Error(`Plan mode is not available for ${name}.`);
+            const enabled = await adapter.setPlanMode(command.enabled);
+            return enabled
+                ? `${name} plan mode enabled. Send /plan off to restore the previous mode.`
+                : `${name} plan mode disabled.`;
+        }
+        if (!adapter.listModels || !adapter.selectModel)
+            throw new Error(`Model selection is not available for ${name}.`);
+        const owner = snapshotOwner(adapter, senderId);
+        if (!command.target) {
+            snapshots.delete(adapter);
+            const models = await adapter.listModels();
+            if (snapshotOwner(adapter, senderId) !== owner)
+                throw new Error("The active session changed. Send /model again.");
+            if (!models.length)
+                return `${name} did not return any available models.`;
+            snapshots.set(adapter, { owner, createdAtMs: Date.now(), models });
+            return [
+                `Available ${name} models:`, "",
+                ...models.map((model, index) => `${index + 1}. ${model.displayName}${model.isCurrent ? "  (current)" : ""}`),
+                "", "Reply with /model <number> to switch. The list is valid for 5 minutes.",
+            ].join("\n");
+        }
+        const snapshot = snapshots.get(adapter);
+        if (!snapshot || snapshot.owner !== owner || Date.now() - snapshot.createdAtMs > MODEL_SNAPSHOT_TTL_MS) {
+            throw new Error("The model list has expired or belongs to another session. Send /model again.");
+        }
+        const index = Number(command.target);
+        if (!/^\d+$/.test(command.target) || !Number.isSafeInteger(index) || index < 1 || index > snapshot.models.length) {
+            throw new Error("Model selection is outside the displayed range. Send /model again to refresh the list.");
+        }
+        const model = await adapter.selectModel(snapshot.models[index - 1].id);
+        snapshots.delete(adapter);
+        return `${name} model switched to ${model.displayName}.`;
+    }
+    catch (error) {
+        return error instanceof Error ? error.message : String(error);
+    }
+}

package/dist/bridge/bridge-adapters.claude.js

@@ -1,3 +1,11 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
+import { NativeTerminalControl, readClaudePermissionMode } from "./native-terminal-control.js";
+import { ClaudeNativeControls } from "./claude-native-controls.js";
 import fs from "node:fs";
 import net from "node:net";
 import os from "node:os";
@@ -345,6 +353,20 @@ export class ClaudeCompanionAdapter extends AbstractPtyAdapter {
     remoteSubmitRetryTimer = null;
     remoteSubmitRetryIndex = 0;
     remoteSubmitText = null;
+    terminalControl = new NativeTerminalControl({
+        write: (text) => this.writeToPty(text),
+        identity: () => JSON.stringify([this.state.pid, this.runtimeSessionId, this.resumeConversationId]),
+        isPromptEmpty: () => readClaudePermissionMode(this.terminalControl.text) !== null,
+        assertReady: () => {
+            if (!this.pty || this.state.status !== "idle" || this.pendingApproval || this.pendingResume) {
+                throw new Error("Claude must be idle with no pending approval before using remote controls.");
+            }
+        },
+    });
+    nativeControls = new ClaudeNativeControls(this.terminalControl, () => this.resumeConversationId ?? this.runtimeSessionId ?? "");
+    async listModels() { return this.nativeControls.listModels(); }
+    async selectModel(modelId) { return this.nativeControls.selectModel(modelId); }
+    async setPlanMode(enabled) { return this.nativeControls.setPlanMode(enabled); }
     constructor(options) {
         super(options);
         const shouldRestoreInitialSession = options.sessionStartMode !== "new";
@@ -408,6 +430,8 @@ export class ClaudeCompanionAdapter extends AbstractPtyAdapter {
         }
     }
     async sendInput(text) {
+        if (this.terminalControl.active)
+            throw new Error("A Claude control operation is in progress.");
         if (!this.pty) {
             throw new Error("claude adapter is not running.");
         }
@@ -452,6 +476,8 @@ export class ClaudeCompanionAdapter extends AbstractPtyAdapter {
         return listClaudeResumeSessions(this.options.cwd, limit);
     }
     async resumeSession(sessionId) {
+        if (this.terminalControl.active)
+            throw new Error("A CLI control operation is in progress. Wait for it to finish before switching sessions.");
         if (!this.pty) {
             throw new Error("Claude is not running yet.");
         }
@@ -548,6 +574,7 @@ export class ClaudeCompanionAdapter extends AbstractPtyAdapter {
         return findClaudeResumeSessionFile(this.options.cwd, sessionId);
     }
     async interrupt() {
+        this.terminalControl.cancel("The remote control operation was interrupted.");
         if (!this.pty) {
             return false;
         }
@@ -578,6 +605,8 @@ export class ClaudeCompanionAdapter extends AbstractPtyAdapter {
         return true;
     }
     async reset() {
+        if (this.terminalControl.active)
+            throw new Error("A CLI control operation is in progress. Wait for it to finish before switching sessions.");
         this.rejectPendingResume(new Error("Claude was reset during session switching."));
         this.clearWechatWorkingNotice(true);
         this.pendingCliApprovalHints = null;
@@ -647,6 +676,7 @@ export class ClaudeCompanionAdapter extends AbstractPtyAdapter {
         return ok ? 1 : 0;
     }
     async dispose() {
+        this.terminalControl.cancel("Claude is shutting down.");
         this.rejectPendingResume(new Error("Claude is shutting down during session switching."));
         this.detachLocalTerminal();
         this.clearWechatWorkingNotice(true);
@@ -676,6 +706,7 @@ export class ClaudeCompanionAdapter extends AbstractPtyAdapter {
         this.startHookHealthCheck();
     }
     handleData(rawText) {
+        this.terminalControl.feed(rawText);
         this.renderLocalOutput(rawText);
         const text = normalizeOutput(rawText);
         if (!text) {
@@ -747,6 +778,7 @@ export class ClaudeCompanionAdapter extends AbstractPtyAdapter {
         return true;
     }
     handleExit(exitCode) {
+        this.terminalControl.cancel("Claude exited during the control operation.");
         this.detachLocalTerminal();
         this.clearWechatWorkingNotice(true);
         this.clearRemoteSubmitRetry();
@@ -903,6 +935,7 @@ export class ClaudeCompanionAdapter extends AbstractPtyAdapter {
         }
         this.localTerminalInputListener = (chunk) => {
             const text = typeof chunk === "string" ? chunk : chunk.toString("utf8");
+            this.terminalControl.localInput(text);
             this.writeToPty(text);
         };
         process.stdin.on("data", this.localTerminalInputListener);
@@ -931,10 +964,11 @@ export class ClaudeCompanionAdapter extends AbstractPtyAdapter {
         }
     }
     resizePtyToTerminal() {
-        if (!this.pty || !process.stdout.isTTY) {
+        if (!this.pty) {
             return;
         }
         try {
+            this.terminalControl.resize(process.stdout.columns || DEFAULT_COLS, process.stdout.rows || DEFAULT_ROWS);
             this.pty.resize?.(process.stdout.columns || DEFAULT_COLS, process.stdout.rows || DEFAULT_ROWS);
         }
         catch {

package/dist/bridge/bridge-adapters.codex.js

@@ -1,3 +1,9 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import fs from "node:fs";
 import path from "node:path";
 import crypto from "node:crypto";
@@ -7,7 +13,8 @@ import { normalizeOutput, nowIso, summarizeOutput, truncatePreview, } from "../c
 import { AbstractPtyAdapter } from "./bridge-adapters.core.js";
 import { killProcessTreeSync } from "./bridge-process-reaper.js";
 import * as shared from "./bridge-adapters.shared.js";
-import { requestCodexVisibleThreadSwitch } from "../companion/codex-visible-client-link.js";
+import { requestCodexVisibleClientShutdown, requestCodexVisibleThreadSwitch, } from "../companion/codex-visible-client-link.js";
+import { readLocalCompanionEndpoint } from "../companion/local-companion-link.js";
 import { ensureWorkspaceChannelDir } from "../wechat/channel-config.js";
 import { CODEX_REMOTE_AUTH_TOKEN_ENV, LOCAL_CLIENT_PROTOCOL_VERSION, } from "../runtime/runtime-types.js";
 export function parseCodexCliVersion(output) {
@@ -21,7 +28,7 @@ export function isCodexVersionInCompatibilityRange(version) {
     }
     const major = parts[0] ?? -1;
     const minor = parts[1] ?? -1;
-    return major === 0 && minor >= 149 && minor <= 151;
+    return major === 0 && minor >= 149 && minor <= 155;
 }
 const { CODEX_APP_SERVER_HOST, CODEX_APP_SERVER_READY_TIMEOUT_MS, CODEX_FINAL_REPLY_SETTLE_DELAY_MS, CODEX_RECENT_SESSION_KEY_LIMIT, CODEX_RPC_CONNECT_RETRY_MS, CODEX_RPC_RECONNECT_TIMEOUT_MS, CODEX_SESSION_FALLBACK_SCAN_INTERVAL_MS, CODEX_SESSION_LOCAL_MIRROR_FALLBACK_WINDOW_MS, CODEX_SESSION_POLL_INTERVAL_MS, CODEX_STARTUP_WARMUP_MS, CODEX_THREAD_SIGNAL_TTL_MS, INTERRUPT_SETTLE_DELAY_MS, appendBoundedLog, buildCodexApprovalRequest, buildCodexCliArgs, buildCodexDynamicToolCallFailureResponse, buildCodexMcpServerElicitationDeclineResponse, buildCodexPermissionsRequestApprovalResponse, buildCodexUserInputRequest, coerceWebSocketMessageData, delay, describeUnknownError, extractCodexFinalTextFromItem, extractCodexThreadFollowIdFromStatusChanged, extractCodexThreadStartedThreadId, extractCodexUserMessageText, findCodexSessionFile, findRecentCodexSessionFileForCwd, getCodexRpcRequestId, getCodexApprovalAutoResponse, getCodexWechatOutboundAttachmentDenyMessage, getNotificationThreadId, getNotificationTurnId, isRecord, isRecentIsoTimestamp, listCodexResumeSessions, normalizeComparablePath, normalizeCodexRpcError, reserveLocalPort, resolveSpawnTarget, shouldAutoCompleteCodexWechatTurnAfterFinalReply, shouldIgnoreCodexSessionReplayEntry, shouldRecoverCodexStaleBusyState, waitForTcpPort, } = shared;
 const CODEX_LOCAL_THREAD_ANNOUNCE_SETTLE_MS = 150;
@@ -78,6 +85,7 @@ export class CodexPtyAdapter extends AbstractPtyAdapter {
     appServerAuthToken = null;
     appServerAuthTokenFilePath = null;
     rpcSocket = null;
+    lastRpcCloseDetail = "";
     rpcShuttingDown = false;
     rpcReconnectPromise = null;
     cleanPanelExitInProgress = false;
@@ -86,6 +94,7 @@ export class CodexPtyAdapter extends AbstractPtyAdapter {
     subscribedThreadIds = new Set();
     pendingThreadSubscriptions = new Map();
     sharedThreadId = null;
+    previousCollaborationMode = null;
     announcedThreadId = null;
     localThreadFollowBlockedUntilMs = 0;
     pendingThreadStatusChecks = new Map();
@@ -182,6 +191,13 @@ export class CodexPtyAdapter extends AbstractPtyAdapter {
             throw err;
         }
     }
+    async prepareVisibleClientSession() {
+        if (this.isNativePanelMode() || this.sharedThreadId) {
+            return Boolean(this.sharedThreadId);
+        }
+        const threadId = await this.ensureThreadStarted();
+        return Boolean(threadId);
+    }
     buildSpawnArgs() {
         if (!this.appServerPort) {
             throw new Error("Codex app-server is not ready.");
@@ -248,6 +264,74 @@ export class CodexPtyAdapter extends AbstractPtyAdapter {
         }
         await this.resumeVisibleSharedThread(threadId);
     }
+    async listModels() {
+        if (!this.usesRpcTurnTransport() || !this.sharedThreadId) {
+            throw new Error("Codex model selection requires an active app-server thread.");
+        }
+        const response = await this.sendRpcRequest("model/list", { includeHidden: false });
+        const data = isRecord(response) && Array.isArray(response.data) ? response.data : [];
+        const current = await this.readCodexThreadSettings();
+        const models = data.flatMap((item) => {
+            if (!isRecord(item))
+                return [];
+            const id = typeof item.id === "string" ? item.id : typeof item.model === "string" ? item.model : "";
+            if (!id)
+                return [];
+            const displayName = typeof item.displayName === "string" ? item.displayName : id;
+            const efforts = Array.isArray(item.supportedReasoningEfforts)
+                ? item.supportedReasoningEfforts.filter((value) => typeof value === "string")
+                : undefined;
+            return [{ id, displayName, isCurrent: id === current.model, supportedReasoningEfforts: efforts }];
+        });
+        return models;
+    }
+    async selectModel(modelId) {
+        const models = await this.listModels();
+        const selected = models.find((model) => model.id === modelId);
+        if (!selected)
+            throw new Error(`Codex model ${modelId} is not available.`);
+        await this.sendRpcRequest("thread/settings/update", { threadId: this.sharedThreadId, model: selected.id });
+        return selected;
+    }
+    async setPlanMode(enabled) {
+        if (!this.usesRpcTurnTransport() || !this.sharedThreadId) {
+            throw new Error("Codex plan mode requires an active app-server thread.");
+        }
+        const settings = await this.readCodexThreadSettings();
+        if (enabled) {
+            const response = await this.sendRpcRequest("collaborationMode/list", {});
+            const modes = isRecord(response) && Array.isArray(response.data) ? response.data : [];
+            const plan = modes.find((item) => isRecord(item) && (item.mode === "plan" || item.name?.toString().toLowerCase() === "plan"));
+            if (!isRecord(plan))
+                throw new Error("Codex plan mode is not available in this app-server.");
+            this.previousCollaborationMode = isRecord(settings.collaborationMode) ? settings.collaborationMode : null;
+            const mode = typeof plan.mode === "string" ? plan.mode : "plan";
+            const model = typeof plan.model === "string" ? plan.model : settings.model;
+            const effort = plan.reasoning_effort ?? plan.reasoningEffort ?? null;
+            await this.sendRpcRequest("thread/settings/update", {
+                threadId: this.sharedThreadId,
+                collaborationMode: { mode, settings: { model, reasoning_effort: effort, developer_instructions: null } },
+            });
+            return true;
+        }
+        const previous = this.previousCollaborationMode ?? {
+            mode: "default",
+            settings: { model: settings.model, reasoning_effort: settings.effort ?? null, developer_instructions: null },
+        };
+        await this.sendRpcRequest("thread/settings/update", {
+            threadId: this.sharedThreadId,
+            collaborationMode: previous,
+        });
+        this.previousCollaborationMode = null;
+        return false;
+    }
+    async readCodexThreadSettings() {
+        const response = await this.sendRpcRequest("thread/read", { threadId: this.sharedThreadId, includeTurns: false });
+        const thread = isRecord(response) && isRecord(response.thread) ? response.thread : null;
+        if (!thread || typeof thread.model !== "string")
+            throw new Error("Codex did not return the current thread model.");
+        return { model: thread.model, effort: thread.reasoningEffort, collaborationMode: thread.collaborationMode };
+    }
     async interrupt() {
         if (this.usesRpcTurnTransport()) {
             return await this.interruptPanelTurn();
@@ -315,6 +399,7 @@ export class CodexPtyAdapter extends AbstractPtyAdapter {
         return true;
     }
     async dispose() {
+        await this.shutdownVisibleClient();
         this.resetTurnTracking({ preserveThread: false });
         if (this.isEmbeddedCliMode()) {
             this.detachLocalInputForwarding();
@@ -346,6 +431,25 @@ export class CodexPtyAdapter extends AbstractPtyAdapter {
         }
         await this.stopAppServer();
     }
+    async shutdownVisibleClient() {
+        const endpoint = readLocalCompanionEndpoint(this.options.cwd, { adapter: "codex" });
+        if (!endpoint?.companionPid ||
+            endpoint.instanceId !== this.localClientInstanceId ||
+            !endpoint.codexControlPort ||
+            !endpoint.codexControlToken) {
+            return;
+        }
+        try {
+            await requestCodexVisibleClientShutdown({
+                cwd: this.options.cwd,
+                instanceId: endpoint.instanceId,
+            });
+        }
+        catch {
+            // The visible client may already be exiting. Its endpoint is cleared
+            // by the supervisor when the child process finishes.
+        }
+    }
     getLocalClientEndpoint() {
         if (!this.isHeadlessRuntimeMode() || !this.appServerPort || !this.appServerAuthToken) {
             return null;
@@ -1192,8 +1296,8 @@ export class CodexPtyAdapter extends AbstractPtyAdapter {
         socket.addEventListener("message", (event) => {
             this.handleRpcMessageData(event.data);
         });
-        socket.addEventListener("close", () => {
-            this.handleRpcSocketClosed();
+        socket.addEventListener("close", (event) => {
+            this.handleRpcSocketClosed(event.code, event.reason);
         });
     }
     async disconnectRpcClient() {
@@ -1231,13 +1335,14 @@ export class CodexPtyAdapter extends AbstractPtyAdapter {
         });
         this.rpcShuttingDown = false;
     }
-    handleRpcSocketClosed() {
+    handleRpcSocketClosed(code, reason) {
         const expectedShutdown = shouldSuppressCodexTransportFatalError({
             transportShuttingDown: this.rpcShuttingDown,
             shuttingDown: this.shuttingDown,
             cleanPanelExitInProgress: this.cleanPanelExitInProgress,
         });
         this.rpcSocket = null;
+        this.lastRpcCloseDetail = `close_code=${code ?? "unknown"}${reason ? ` reason=${truncatePreview(reason, 240)}` : ""}`;
         this.subscribedThreadIds.clear();
         this.rejectPendingRpcRequests("Codex websocket connection closed.");
         this.rpcShuttingDown = false;
@@ -1269,7 +1374,7 @@ export class CodexPtyAdapter extends AbstractPtyAdapter {
                 const details = this.describeAppServerLog();
                 this.emit({
                     type: "fatal_error",
-                    message: `codex app-server websocket closed unexpectedly.${details}`,
+                    message: `codex app-server websocket closed unexpectedly (${this.lastRpcCloseDetail || "no close details"}).${details}`,
                     timestamp: nowIso(),
                 });
                 this.terminateCodexClient();
@@ -1307,7 +1412,7 @@ export class CodexPtyAdapter extends AbstractPtyAdapter {
             }
             this.emit({
                 type: "fatal_error",
-                message: `codex app-server websocket closed unexpectedly and could not reconnect: ${lastError}.${details}`,
+                message: `codex app-server websocket closed unexpectedly and could not reconnect (${this.lastRpcCloseDetail || "no close details"}): ${lastError}.${details}`,
                 timestamp: nowIso(),
             });
             this.terminateCodexClient();
@@ -1460,6 +1565,9 @@ export class CodexPtyAdapter extends AbstractPtyAdapter {
         if (typeof thread.parentThreadId === "string") {
             throw new Error(`Codex thread ${targetThreadId} is a subagent thread and cannot be resumed.`);
         }
+        if (thread.canAcceptDirectInput === false) {
+            throw new Error(`Codex thread ${targetThreadId} is owned by a parent agent and cannot accept direct input.`);
+        }
         if (thread.ephemeral === true) {
             throw new Error(`Codex thread ${targetThreadId} is ephemeral and cannot be resumed.`);
         }
@@ -1483,6 +1591,9 @@ export class CodexPtyAdapter extends AbstractPtyAdapter {
         if (typeof thread.parentThreadId === "string") {
             throw new Error(`Codex thread ${targetThreadId} is a subagent thread.`);
         }
+        if (thread.canAcceptDirectInput === false) {
+            throw new Error(`Codex thread ${targetThreadId} is owned by a parent agent.`);
+        }
         if (thread.ephemeral === true) {
             throw new Error(`Codex thread ${targetThreadId} is ephemeral.`);
         }