@foxden-app/foxclaw 0.5.77 → 0.6.3

package/dist/controller/controller.js

@@ -523,7 +523,11 @@ export class BridgeSessionCore {
                 }
                 lines.push(...codexUsageLines);
                 lines.push(...codexLocalUsageLines);
-                await this.sendRichInternalMessage(scopeId, '/status', lines.join('\n'));
+                lines.splice(5, 0, t(locale, 'status_codex_home', {
+                    value: this.config.codexHome ?? path.join(os.homedir(), '.codex'),
+                }));
+                const messageId = await this.sendRichInternalMessage(scopeId, '/status', lines.join('\n'));
+                this.scheduleStalePanelDeletion(scopeId, messageId);
                 return;
             }
             case 'account': {
@@ -4948,7 +4952,7 @@ export class BridgeSessionCore {
             await this.sendMessage(scopeId, message);
             return;
         }
-        if (action === 'audit' || action === 'check') {
+        if (action === 'audit' || action === 'check' || action === 'safe') {
             if (!this.canRunGlobalAuthRefresh()) {
                 await this.sendMessage(scopeId, t(locale, 'auth_cluster_audit_blocked_active'));
                 return;
@@ -4959,10 +4963,10 @@ export class BridgeSessionCore {
                 await this.sendMessage(scopeId, t(locale, 'auth_sync_disabled'));
                 return;
             }
-            await this.sendRichInternalMessage(scopeId, '/auth sync audit', formatAuthClusterAuditResult(locale, outcome));
+            await this.sendRichInternalMessage(scopeId, '/auth sync safe', formatAuthClusterAuditResult(locale, outcome));
             return;
         }
-        if (action === 'safe' || (action === 'push' && args[1]?.toLowerCase() === 'all')) {
+        if (action === 'push' && args[1]?.toLowerCase() === 'all') {
             if (!this.canRunGlobalAuthRefresh()) {
                 await this.sendMessage(scopeId, t(locale, 'auth_sync_push_blocked_active'));
                 return;
@@ -5803,8 +5807,20 @@ export class BridgeSessionCore {
             if (record.messageId !== null) {
                 await this.editAuthPanelMessage(event.scopeId, record.messageId, t(locale, 'auth_sync_safe_starting'), []);
             }
-            const result = await this.runAuthSafeSyncAll();
-            if (!result) {
+            if (record.messageId !== null) {
+                this.pauseStalePanelDeletion(event.scopeId, record.messageId);
+            }
+            let outcome;
+            try {
+                outcome = await this.runAuthClusterAudit();
+            }
+            catch (error) {
+                if (record.messageId !== null) {
+                    await this.editAuthPanelMessage(event.scopeId, record.messageId, t(locale, 'auth_cluster_audit_failed', { error: formatUserError(error) }), authChoiceKeyboard(locale, record));
+                }
+                return;
+            }
+            if (!outcome) {
                 if (record.messageId !== null) {
                     await this.editAuthPanelMessage(event.scopeId, record.messageId, t(locale, 'auth_sync_disabled'), authChoiceKeyboard(locale, record));
                 }
@@ -5816,12 +5832,7 @@ export class BridgeSessionCore {
             record.createdAt = Date.now();
             clampCodexAuthListOffset(record);
             if (record.messageId !== null) {
-                await this.editAuthPanelMessage(event.scopeId, record.messageId, `${t(locale, 'auth_sync_safe_done', {
-                    localSynced: result.localSynced,
-                    localSkipped: result.localSkipped,
-                    sent: result.sent,
-                    skipped: result.skipped,
-                })}\n\n${renderAuthListMessage(locale, state, this.authDisplayBotLabel(), parseWeixinBridgeScope(event.scopeId) !== null, record)}`, authChoiceKeyboard(locale, record));
+                await this.editAuthPanelMessage(event.scopeId, record.messageId, `${formatAuthClusterAuditResult(locale, outcome)}\n\n${renderAuthListMessage(locale, state, this.authDisplayBotLabel(), parseWeixinBridgeScope(event.scopeId) !== null, record)}`, authChoiceKeyboard(locale, record));
             }
             return;
         }
@@ -10493,17 +10504,8 @@ function authChoiceKeyboard(locale, record) {
     if (record.searchTerm) {
         rows.push([{ text: t(locale, 'button_clear_filter'), callback_data: `auth:${record.localId}:clear_search` }]);
     }
-    rows.push([
-        { text: t(locale, 'button_permissions'), callback_data: 'nav:permissions' },
-        { text: t(locale, 'button_login_device'), callback_data: `auth:${record.localId}:login_device` },
-    ]);
-    rows.push([
-        { text: t(locale, 'button_auth_cluster_audit'), callback_data: `auth:${record.localId}:cluster_audit` },
-    ]);
-    rows.push([
-        { text: t(locale, 'button_auth_safe_sync'), callback_data: `auth:${record.localId}:safe_sync` },
-        { text: t(locale, 'button_auth_reload'), callback_data: `auth:${record.localId}:reload` },
-    ]);
+    rows.push([{ text: t(locale, 'button_login_device'), callback_data: `auth:${record.localId}:login_device` }]);
+    rows.push([{ text: t(locale, 'button_auth_safe_sync'), callback_data: `auth:${record.localId}:safe_sync` }]);
     return rows;
 }
 function formatCodexAuthCandidateDisplayName(name) {

package/dist/controller/presentation.js

@@ -542,7 +542,9 @@ export function normalizeRequestedEffort(value) {
         || normalized === 'low'
         || normalized === 'medium'
         || normalized === 'high'
-        || normalized === 'xhigh') {
+        || normalized === 'xhigh'
+        || normalized === 'max'
+        || normalized === 'ultra') {
         return normalized;
     }
     return null;

package/dist/i18n.d.ts

@@ -95,6 +95,7 @@ declare const MESSAGES: {
         readonly status_user_agent: "Codex/FoxClaw agent: {value}";
         readonly status_current_thread: "Current thread: {value}";
         readonly status_configured_model: "Configured model: {value}";
+        readonly status_codex_home: "Codex home: {value}";
         readonly status_configured_effort: "Configured effort: {value}";
         readonly status_fast: "Fast: {value}";
         readonly status_collaboration_mode: "Mode: {value}";
@@ -245,7 +246,7 @@ declare const MESSAGES: {
         readonly auth_sync_test_sent: "Auth sync test complete: sent {sent}, replies {replied}.";
         readonly auth_sync_test_missing: "Missing replies: {value}";
         readonly auth_sync_push_blocked_active: "Cannot push auth sync while any runtime, approval, input, login, or auth mirror write is active.";
-        readonly auth_sync_safe_starting: "Safely syncing auth across local bot runtimes and cross-node peers...";
+        readonly auth_sync_safe_starting: "Auditing every node, selecting the newest valid auth, and safely synchronizing the cluster...";
         readonly auth_sync_safe_done: "Safe auth sync complete: local synced {localSynced}, local skipped {localSkipped}; cross-node sent {sent}, skipped {skipped}.";
         readonly auth_cluster_audit_starting: "Asking all auth-sync peers to validate accounts, reconcile the newest usable credentials, and refresh credentials at least 8 days old...";
         readonly auth_cluster_audit_blocked_active: "Cluster auth check requires every local runtime, approval, input, login, and auth mirror write to be idle.";
@@ -282,7 +283,7 @@ declare const MESSAGES: {
         readonly auth_sync_trace_missing: "Usage: /auth sync trace <requestId>";
         readonly button_login_device: "🔑 Login";
         readonly button_auth_reload: "🔄 Reload auth";
-        readonly button_auth_safe_sync: "🧷 Safe sync";
+        readonly button_auth_safe_sync: "🩺 Safe sync";
         readonly button_auth_cluster_audit: "🩺 Check all nodes and reconcile auth";
         readonly button_auth_refresh_all_confirm: "⚠️ Accept risk & refresh";
         readonly button_auth_repair_login: "🔑 Login repair";
@@ -394,7 +395,7 @@ declare const MESSAGES: {
         readonly effort_adjusted_model: "Effort {effort} is not supported by {model}, so it was adjusted.";
         readonly effort_change_blocked: "Cannot change reasoning effort while a turn is active. Use /interrupt or wait.";
         readonly effort_reset: "Configured effort reset to server default.";
-        readonly usage_effort: "Usage: /effort <none|minimal|low|medium|high|xhigh|default>\nOr just use /models and tap buttons.";
+        readonly usage_effort: "Usage: /effort <none|minimal|low|medium|high|xhigh|max|ultra|default>\nOr just use /models and tap buttons.";
         readonly model_does_not_support_effort: "{model} does not support {effort}.\nSupported: {supported}";
         readonly effort_configured: "Configured effort: {effort}";
         readonly usage_fast: "Usage: /fast <on|off|toggle>";
@@ -818,6 +819,7 @@ declare const MESSAGES: {
         readonly status_user_agent: "Codex/FoxClaw 标识：{value}";
         readonly status_current_thread: "当前线程：{value}";
         readonly status_configured_model: "已配置模型：{value}";
+        readonly status_codex_home: "Codex Home：{value}";
         readonly status_configured_effort: "已配置推理强度：{value}";
         readonly status_fast: "Fast：{value}";
         readonly status_collaboration_mode: "模式：{value}";
@@ -968,7 +970,7 @@ declare const MESSAGES: {
         readonly auth_sync_test_sent: "auth sync 测试完成：已发送 {sent}，收到回应 {replied}。";
         readonly auth_sync_test_missing: "未回应：{value}";
         readonly auth_sync_push_blocked_active: "当前有任一 runtime、审批、待输入、登录或 auth 镜像写入在进行中，不能推送 auth 同步。";
-        readonly auth_sync_safe_starting: "正在安全同步本机多 bot runtime 和跨节点 auth...";
+        readonly auth_sync_safe_starting: "正在自检全部节点、选择最新有效 auth，并安全同步整个集群...";
         readonly auth_sync_safe_done: "安全 auth 同步完成：本机同步 {localSynced}，本机跳过 {localSkipped}；跨节点发送 {sent}，跳过 {skipped}。";
         readonly auth_cluster_audit_starting: "正在通知所有 auth sync 节点逐账号自检，协商最新有效凭据，并由本节点刷新已满 8 天的 auth...";
         readonly auth_cluster_audit_blocked_active: "集群 auth 自检要求本机所有 runtime、审批、待输入、登录和 auth 镜像写入均为空闲。";
@@ -1005,7 +1007,7 @@ declare const MESSAGES: {
         readonly auth_sync_trace_missing: "用法：/auth sync trace <requestId>";
         readonly button_login_device: "🔑 设备登录";
         readonly button_auth_reload: "🔄 重载 auth";
-        readonly button_auth_safe_sync: "🧷 安全同步";
+        readonly button_auth_safe_sync: "🩺 安全同步";
         readonly button_auth_cluster_audit: "🩺 全节点自检并同步";
         readonly button_auth_refresh_all_confirm: "⚠️ 接受风险并刷新";
         readonly button_auth_repair_login: "🔑 登录修复";
@@ -1117,7 +1119,7 @@ declare const MESSAGES: {
         readonly effort_adjusted_model: "{model} 不支持 {effort}，所以已自动调整推理强度。";
         readonly effort_change_blocked: "当前有回复在进行中，暂时不能切换推理强度。请先等待，或使用 /interrupt。";
         readonly effort_reset: "推理强度已重置为服务端默认值。";
-        readonly usage_effort: "用法：/effort <none|minimal|low|medium|high|xhigh|default>\n或者直接使用 /models 点按钮。";
+        readonly usage_effort: "用法：/effort <none|minimal|low|medium|high|xhigh|max|ultra|default>\n或者直接使用 /models 点按钮。";
         readonly model_does_not_support_effort: "{model} 不支持 {effort}。\n支持的强度：{supported}";
         readonly effort_configured: "已配置推理强度：{effort}";
         readonly usage_fast: "用法：/fast <on|off|toggle>";
@@ -1455,4 +1457,8 @@ export declare function getTelegramCommands(locale: AppLocale): Array<{
     command: string;
     description: string;
 }>;
+export declare function getOpencodeTelegramCommands(locale: AppLocale): Array<{
+    command: string;
+    description: string;
+}>;
 export {};

package/dist/i18n.js

@@ -93,6 +93,7 @@ const MESSAGES = {
         status_user_agent: 'Codex/FoxClaw agent: {value}',
         status_current_thread: 'Current thread: {value}',
         status_configured_model: 'Configured model: {value}',
+        status_codex_home: 'Codex home: {value}',
         status_configured_effort: 'Configured effort: {value}',
         status_fast: 'Fast: {value}',
         status_collaboration_mode: 'Mode: {value}',
@@ -243,7 +244,7 @@ const MESSAGES = {
         auth_sync_test_sent: 'Auth sync test complete: sent {sent}, replies {replied}.',
         auth_sync_test_missing: 'Missing replies: {value}',
         auth_sync_push_blocked_active: 'Cannot push auth sync while any runtime, approval, input, login, or auth mirror write is active.',
-        auth_sync_safe_starting: 'Safely syncing auth across local bot runtimes and cross-node peers...',
+        auth_sync_safe_starting: 'Auditing every node, selecting the newest valid auth, and safely synchronizing the cluster...',
         auth_sync_safe_done: 'Safe auth sync complete: local synced {localSynced}, local skipped {localSkipped}; cross-node sent {sent}, skipped {skipped}.',
         auth_cluster_audit_starting: 'Asking all auth-sync peers to validate accounts, reconcile the newest usable credentials, and refresh credentials at least 8 days old...',
         auth_cluster_audit_blocked_active: 'Cluster auth check requires every local runtime, approval, input, login, and auth mirror write to be idle.',
@@ -280,7 +281,7 @@ const MESSAGES = {
         auth_sync_trace_missing: 'Usage: /auth sync trace <requestId>',
         button_login_device: '🔑 Login',
         button_auth_reload: '🔄 Reload auth',
-        button_auth_safe_sync: '🧷 Safe sync',
+        button_auth_safe_sync: '🩺 Safe sync',
         button_auth_cluster_audit: '🩺 Check all nodes and reconcile auth',
         button_auth_refresh_all_confirm: '⚠️ Accept risk & refresh',
         button_auth_repair_login: '🔑 Login repair',
@@ -392,7 +393,7 @@ const MESSAGES = {
         effort_adjusted_model: 'Effort {effort} is not supported by {model}, so it was adjusted.',
         effort_change_blocked: 'Cannot change reasoning effort while a turn is active. Use /interrupt or wait.',
         effort_reset: 'Configured effort reset to server default.',
-        usage_effort: 'Usage: /effort <none|minimal|low|medium|high|xhigh|default>\nOr just use /models and tap buttons.',
+        usage_effort: 'Usage: /effort <none|minimal|low|medium|high|xhigh|max|ultra|default>\nOr just use /models and tap buttons.',
         model_does_not_support_effort: '{model} does not support {effort}.\nSupported: {supported}',
         effort_configured: 'Configured effort: {effort}',
         usage_fast: 'Usage: /fast <on|off|toggle>',
@@ -816,6 +817,7 @@ const MESSAGES = {
         status_user_agent: 'Codex/FoxClaw 标识：{value}',
         status_current_thread: '当前线程：{value}',
         status_configured_model: '已配置模型：{value}',
+        status_codex_home: 'Codex Home：{value}',
         status_configured_effort: '已配置推理强度：{value}',
         status_fast: 'Fast：{value}',
         status_collaboration_mode: '模式：{value}',
@@ -966,7 +968,7 @@ const MESSAGES = {
         auth_sync_test_sent: 'auth sync 测试完成：已发送 {sent}，收到回应 {replied}。',
         auth_sync_test_missing: '未回应：{value}',
         auth_sync_push_blocked_active: '当前有任一 runtime、审批、待输入、登录或 auth 镜像写入在进行中，不能推送 auth 同步。',
-        auth_sync_safe_starting: '正在安全同步本机多 bot runtime 和跨节点 auth...',
+        auth_sync_safe_starting: '正在自检全部节点、选择最新有效 auth，并安全同步整个集群...',
         auth_sync_safe_done: '安全 auth 同步完成：本机同步 {localSynced}，本机跳过 {localSkipped}；跨节点发送 {sent}，跳过 {skipped}。',
         auth_cluster_audit_starting: '正在通知所有 auth sync 节点逐账号自检，协商最新有效凭据，并由本节点刷新已满 8 天的 auth...',
         auth_cluster_audit_blocked_active: '集群 auth 自检要求本机所有 runtime、审批、待输入、登录和 auth 镜像写入均为空闲。',
@@ -1003,7 +1005,7 @@ const MESSAGES = {
         auth_sync_trace_missing: '用法：/auth sync trace <requestId>',
         button_login_device: '🔑 设备登录',
         button_auth_reload: '🔄 重载 auth',
-        button_auth_safe_sync: '🧷 安全同步',
+        button_auth_safe_sync: '🩺 安全同步',
         button_auth_cluster_audit: '🩺 全节点自检并同步',
         button_auth_refresh_all_confirm: '⚠️ 接受风险并刷新',
         button_auth_repair_login: '🔑 登录修复',
@@ -1115,7 +1117,7 @@ const MESSAGES = {
         effort_adjusted_model: '{model} 不支持 {effort}，所以已自动调整推理强度。',
         effort_change_blocked: '当前有回复在进行中，暂时不能切换推理强度。请先等待，或使用 /interrupt。',
         effort_reset: '推理强度已重置为服务端默认值。',
-        usage_effort: '用法：/effort <none|minimal|low|medium|high|xhigh|default>\n或者直接使用 /models 点按钮。',
+        usage_effort: '用法：/effort <none|minimal|low|medium|high|xhigh|max|ultra|default>\n或者直接使用 /models 点按钮。',
         model_does_not_support_effort: '{model} 不支持 {effort}。\n支持的强度：{supported}',
         effort_configured: '已配置推理强度：{effort}',
         usage_fast: '用法：/fast <on|off|toggle>',
@@ -1505,3 +1507,40 @@ export function getTelegramCommands(locale) {
         { command: 'interrupt', description: t(locale, 'cmd_desc_interrupt') },
     ];
 }
+export function getOpencodeTelegramCommands(locale) {
+    const descriptions = locale === 'zh' ? {
+        help: '查看命令', setup: 'OpenCode 设置', status: '桥接状态', update: '请改用 Codex Bot', threads: '最近会话', open: '打开会话',
+        watch: '观察会话', unwatch: '停止观察', new: '新建会话', models: '模型列表', model: '选择模型',
+        effort: '推理档位', fast: 'Fast 能力说明', mode: 'Agent 或 Plan', plan: '下一轮 Plan', agent: '选择 Agent', permissions: '权限设置',
+        active: '运行中新消息', steer: '引导当前回复', queue: '排队下一轮', takeover: '中断并接管',
+        history: '最近消息', files: '查找文件', fork: 'Fork 会话', undo: '原生回退', redo: '原生重做', rename: '重命名会话',
+        review: '原生代码审查', archive: '归档当前会话', unarchive: '恢复归档会话', rich: '富文本测试', voice: '朗读文本或发送语音',
+        diff: '会话文件变更', where: '当前会话信息', reveal: '当前会话信息', compact: '压缩上下文', loaded: '已加载会话', skills: 'OpenCode Skills',
+        mcp: 'MCP 状态', apps: 'MCP 应用', provider: '模型 Provider', auth: 'Provider 认证状态', auth_reload: '无 OpenCode 等价 API',
+        account: '无 OpenCode 账户 API', quota: '无 OpenCode 配额 API', login_device: '请用终端 opencode auth', goal: '无 OpenCode Goal 原语', remote: 'Codex Remote 专用',
+        plugins: 'OpenCode Plugins', hooks: 'Plugin hooks', features: '实验能力', config: '配置摘要', approve: '待审批', answer: '待回答', interrupt: '中断回复',
+    } : {
+        help: 'Show commands', setup: 'OpenCode settings', status: 'Bridge status', update: 'Use the Codex bot', threads: 'Recent sessions', open: 'Open a session',
+        watch: 'Watch a session', unwatch: 'Stop watching', new: 'New session', models: 'Model list', model: 'Select model',
+        effort: 'Reasoning variant', fast: 'Fast capability note', mode: 'Agent or Plan', plan: 'Plan next turn', agent: 'Select agent', permissions: 'Access settings',
+        active: 'Active-turn messages', steer: 'Steer active turn', queue: 'Queue next turn', takeover: 'Interrupt and take over',
+        history: 'Recent messages', files: 'Find files', fork: 'Fork session', undo: 'Native undo', redo: 'Native redo', rename: 'Rename session',
+        review: 'Native code review', archive: 'Archive current session', unarchive: 'Restore archived session', rich: 'Rich-text test', voice: 'Read text or send voice',
+        diff: 'Session file changes', where: 'Current session', reveal: 'Current session', compact: 'Compact context', loaded: 'Loaded sessions', skills: 'OpenCode skills',
+        mcp: 'MCP status', apps: 'MCP apps', provider: 'Model providers', auth: 'Provider auth status', auth_reload: 'No OpenCode equivalent',
+        account: 'No OpenCode account API', quota: 'No OpenCode quota API', login_device: 'Use opencode auth terminal', goal: 'No OpenCode Goal primitive', remote: 'Codex Remote only',
+        plugins: 'OpenCode plugins', hooks: 'Plugin hooks', features: 'Experimental capabilities', config: 'Config summary', approve: 'Pending approvals', answer: 'Pending questions', interrupt: 'Stop active turn',
+    };
+    const localized = descriptions;
+    const codexMenu = getTelegramCommands(locale).map((entry) => ({
+        command: entry.command,
+        description: localized[entry.command] ?? entry.description,
+    }));
+    const shared = new Set(codexMenu.map((entry) => entry.command));
+    return [
+        ...codexMenu,
+        ...Object.entries(localized)
+            .filter(([command]) => !shared.has(command))
+            .map(([command, description]) => ({ command, description })),
+    ];
+}

package/dist/main.js

@@ -552,7 +552,7 @@ function truncateStatusLine(value, maxLength) {
     return normalized.length <= maxLength ? normalized : `${normalized.slice(0, Math.max(0, maxLength - 1))}…`;
 }
 async function runServeCli() {
-    const [{ BridgeMessagingRouter }, { TelegramMessagingPort }, { WeixinChannelAdapter }, { WeixinMessagingPort }, { attachIlinkRuntimeFromBridgeLogger }, { loadWeixinAccount }, { Logger }, { BridgeStore }, { TelegramGateway }, { CodexAppClient }, { BridgeSessionCore }, { TelegramChannelAdapter }, { AuthCandidateMirror }, { CrossNodeAuthSync },] = await Promise.all([
+    const [{ BridgeMessagingRouter }, { TelegramMessagingPort }, { WeixinChannelAdapter }, { WeixinMessagingPort }, { attachIlinkRuntimeFromBridgeLogger }, { loadWeixinAccount }, { Logger }, { BridgeStore }, { TelegramGateway }, { CodexAppClient }, { BridgeSessionCore }, { TelegramChannelAdapter }, { AuthCandidateMirror }, { CrossNodeAuthSync }, { OpencodeTelegramRuntime },] = await Promise.all([
         import('./channels/bridge_messaging_router.js'),
         import('./channels/telegram/telegram_messaging_port.js'),
         import('./channels/weixin/weixin_channel_adapter.js'),
@@ -567,6 +567,7 @@ async function runServeCli() {
         import('./channels/telegram/telegram_channel_adapter.js'),
         import('./auth/mirror.js'),
         import('./auth/cross_node_sync.js'),
+        import('./opencode/runtime.js'),
     ]);
     const config = loadConfig();
     const logger = new Logger(config.logLevel, config.logPath);
@@ -581,8 +582,14 @@ async function runServeCli() {
     let managedApps = [];
     let activeAuthMirror = null;
     let activeAuthSync = null;
+    let activeOpencodeRuntime = null;
     try {
         store = new BridgeStore(config.storePath);
+        if (config.opencodeBotToken) {
+            activeOpencodeRuntime = new OpencodeTelegramRuntime(config, store, logger);
+            await activeOpencodeRuntime.start();
+            logger.info('opencode.bridge.started', activeOpencodeRuntime.getRuntimeStatus());
+        }
         if (config.tgMultiBotMode) {
             const seeds = [];
             const canonicalAuthDir = config.codexAuthDir ?? config.codexHome ?? path.join(os.homedir(), '.codex');
@@ -881,6 +888,7 @@ async function runServeCli() {
                 await weixinAdapter?.stop();
                 await activeWeixinCore?.stop();
                 await Promise.all(runtimes.map((runtime) => runtime.telegram.stop()));
+                await activeOpencodeRuntime?.stop();
                 writeAggregateStatus(false);
                 await Promise.all(managedApps.map((app) => app.stop({ terminateServer: true }).catch((error) => {
                     logger.warn('codex.app-server.stop_failed', { error: serializeError(error) });
@@ -1060,6 +1068,7 @@ async function runServeCli() {
             singleMirror?.stop();
             await weixinAdapter?.stop();
             await telegram.stop();
+            await activeOpencodeRuntime?.stop();
             writeRuntimeStatus(config.statusPath, {
                 running: false,
                 connected: false,
@@ -1093,6 +1102,7 @@ async function runServeCli() {
         await weixinAdapter?.stop().catch(() => { });
         await activeWeixinCore?.stop().catch(() => { });
         await Promise.allSettled(activeTelegramAdapters.map((adapter) => adapter.stop()));
+        await activeOpencodeRuntime?.stop().catch(() => { });
         await Promise.allSettled(managedApps.map((app) => app.stop({ terminateServer: true })));
         store?.close();
         processLock.release();
@@ -1778,6 +1788,15 @@ function runDoctorChecks() {
         ['telegram bot token(s) configured', Boolean(process.env.TG_BOT_TOKENS?.trim() || process.env.TG_BOT_TOKEN?.trim())],
         ['telegram allowed user configured', Boolean(process.env.TG_ALLOWED_USER_ID)],
     ];
+    if (process.env.OPENCODE_BOT_TOKEN?.trim()) {
+        const configuredOpencodeBin = process.env.OPENCODE_CLI_BIN;
+        checks.push(['opencode cli available', hasConfiguredCodexBin(configuredOpencodeBin) || hasCommand('opencode')]);
+        const codexTokens = [
+            ...(process.env.TG_BOT_TOKENS ?? '').split(','),
+            process.env.TG_BOT_TOKEN ?? '',
+        ].map((value) => value.trim()).filter(Boolean);
+        checks.push(['OpenCode uses an independent Telegram bot', !codexTokens.includes(process.env.OPENCODE_BOT_TOKEN.trim())]);
+    }
     if (process.env.WX_ENABLED === 'true' || process.env.WX_ENABLED === '1') {
         const accountsDir = process.env.WEIXIN_ACCOUNTS_DIR || path.join(APP_HOME, 'weixin', 'accounts');
         let hasAccounts = false;

package/dist/opencode/client.d.ts

@@ -0,0 +1,66 @@
+import { EventEmitter } from 'node:events';
+import { type OpencodeClient } from '@opencode-ai/sdk/v2';
+import type { Logger } from '../logger.js';
+import { type OpencodeBridgeEvent } from './events.js';
+export interface OpencodeServerRuntimeStatus {
+    pid: number | null;
+    port: number | null;
+    running: boolean;
+    connected: boolean;
+    url: string | null;
+    version: string | null;
+    managed: boolean;
+}
+export interface OpencodeAppClientEvents {
+    event: [event: OpencodeBridgeEvent];
+    connected: [];
+    disconnected: [detail: {
+        source: string;
+        message?: string;
+    }];
+}
+/** Owns one password-protected localhost `opencode serve` process. */
+export declare class OpencodeAppClient extends EventEmitter<OpencodeAppClientEvents> {
+    private readonly cliBin;
+    private readonly configuredPassword;
+    private readonly statePath;
+    private readonly logPath;
+    private readonly logger;
+    private readonly childEnv;
+    private readonly normalizer;
+    private client;
+    private child;
+    private serverState;
+    private connected;
+    private sseAbort;
+    private sseLoop;
+    private readonly pollers;
+    private desiredRunning;
+    private starting;
+    private reconnectTimer;
+    constructor(cliBin: string, configuredPassword: string | null, statePath: string, logPath: string, logger: Logger, childEnv?: NodeJS.ProcessEnv | null);
+    getClient(): OpencodeClient;
+    isConnected(): boolean;
+    getServerStatus(): OpencodeServerRuntimeStatus;
+    start(): Promise<void>;
+    stop(options?: {
+        terminateServer?: boolean;
+    }): Promise<void>;
+    restart(): Promise<void>;
+    watchSessionUntilIdle(sessionId: string, directory: string): void;
+    recoverPendingRequests(directories: readonly string[]): Promise<void>;
+    private pollSession;
+    private attachPersistedServer;
+    private spawnServer;
+    private adoptServer;
+    private startSseLoop;
+    private runSseLoop;
+    private acceptEvent;
+    private recoverPendingForDirectory;
+    private handleDisconnect;
+    private scheduleReconnect;
+    private writeState;
+    private readState;
+    private clearStateForPid;
+}
+export declare function formatSdkError(error: unknown): string;