@foxden-app/foxclaw 0.6.5 → 0.6.7

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 All notable FoxClaw changes are listed here. Each release note is bilingual so GitHub Releases and the npm package are useful to both Chinese and English readers.
 
+## 0.6.7 - 2026-08-12
+
+### 中文
+- 修复从 `/threads` 观察正在由 Codex CLI 执行的线程时错误调用 `thread/resume`、抢占 writer 并报 `already has an active writer` 的问题。观察现在只读绑定线程，并直接尾随 CLI session 文件。
+- 打开被其他 Codex 客户端占用的线程时，仅对明确的 active-writer 冲突降级为只读选中并提示使用 `/watch`；其他错误仍然显式失败。
+
+### English
+- Fixed `/threads` Watch attempting `thread/resume` for a thread currently running in Codex CLI, which tried to acquire its writer and failed with `already has an active writer`. Watch now binds read-only and tails the CLI session file directly.
+- Opening a thread owned by another Codex client now falls back to an explicit read-only selection with a `/watch` hint only for the specific active-writer conflict. Other errors still fail visibly.
+
+## 0.6.6 - 2026-08-10
+
+### 中文
+- Telegram 远端初始化从断网中恢复后会立即刷新桥接状态，使 `/status` 和运行时状态继续显示 bot 用户名，而不是停留在离线启动时的空值。
+
+### English
+- Refreshes bridge status as soon as Telegram remote initialization recovers, so `/status` and runtime state show the bot username instead of retaining the empty offline-start value.
+
 ## 0.6.5 - 2026-08-10
 
 ### 中文

package/dist/controller/controller.d.ts

@@ -259,6 +259,7 @@ export declare class BridgeSessionCore {
     private expireApproval;
     private tryRevealThread;
     private bindCachedThread;
+    private bindCachedThreadReadOnly;
     private resumeThreadForScope;
     private setChatAccessPreset;
     private clearAttachedThreadsForScope;

package/dist/controller/controller.js

@@ -174,6 +174,10 @@ export class BridgeSessionCore {
     }
     /** Wire Telegram inbound events. Call before {@link startCodexApp}. */
     registerTelegramInboundHandlers() {
+        this.bot.on('remoteReady', () => {
+            this.botUsername = this.bot.username;
+            this.updateStatus();
+        });
         this.bot.on('text', (event) => {
             void this.withLock(event.scopeId, async () => this.handleText(event)).catch((error) => {
                 void this.handleAsyncError('telegram.text', error, event.scopeId);
@@ -646,6 +650,7 @@ export class BridgeSessionCore {
                 this.store.cancelQueuedTurnInputs(scopeId);
                 await this.stopWatchingScopeThread(scopeId, thread.threadId);
                 let binding;
+                let readOnly = false;
                 try {
                     binding = await this.bindCachedThread(scopeId, thread.threadId);
                 }
@@ -654,7 +659,10 @@ export class BridgeSessionCore {
                         await this.sendMessage(scopeId, t(locale, 'cached_thread_unavailable'));
                         return;
                     }
-                    throw error;
+                    if (!isThreadActiveWriterError(error))
+                        throw error;
+                    binding = this.bindCachedThreadReadOnly(scopeId, thread);
+                    readOnly = true;
                 }
                 const settings = this.store.getChatSettings(scopeId);
                 const lines = [
@@ -664,7 +672,10 @@ export class BridgeSessionCore {
                     t(locale, 'status_configured_effort', { value: settings?.reasoningEffort ?? t(locale, 'server_default') }),
                     t(locale, 'line_cwd', { value: binding.cwd ?? this.config.defaultCwd }),
                 ];
-                if (this.config.codexAppSyncOnOpen) {
+                if (readOnly) {
+                    lines.push(t(locale, 'thread_active_writer_read_only'));
+                }
+                if (!readOnly && this.config.codexAppSyncOnOpen) {
                     const revealError = await this.tryRevealThread(scopeId, binding.threadId, 'open');
                     lines.push(revealError ? t(locale, 'codex_sync_failed', { error: revealError }) : t(locale, 'opened_in_codex'));
                 }
@@ -977,16 +988,7 @@ export class BridgeSessionCore {
                 await this.sendMessage(scopeId, t(locale, 'thread_is_archived_use_unarchive'));
                 return;
             }
-            try {
-                binding = await this.bindCachedThread(scopeId, cached.threadId);
-            }
-            catch (error) {
-                if (isThreadNotFoundError(error)) {
-                    await this.sendMessage(scopeId, t(locale, 'cached_thread_unavailable'));
-                    return;
-                }
-                throw error;
-            }
+            binding = this.bindCachedThreadReadOnly(scopeId, cached);
         }
         else {
             binding = this.store.getBinding(scopeId);
@@ -3717,6 +3719,18 @@ export class BridgeSessionCore {
         const session = await this.resumeThreadForScope(scopeId, { threadId, cwd: null });
         return this.storeThreadSession(scopeId, session, 'replace');
     }
+    bindCachedThreadReadOnly(scopeId, thread) {
+        const binding = {
+            chatId: scopeId,
+            threadId: thread.threadId,
+            cwd: thread.cwd,
+            updatedAt: Date.now(),
+        };
+        this.store.setBinding(scopeId, binding.threadId, binding.cwd);
+        this.attachedThreads.delete(attachedThreadKey(scopeId, binding.threadId));
+        this.updateStatus();
+        return binding;
+    }
     async resumeThreadForScope(scopeId, binding) {
         const settings = this.store.getChatSettings(scopeId);
         const access = this.resolveEffectiveAccess(scopeId, settings);
@@ -7003,6 +7017,7 @@ export class BridgeSessionCore {
         }
         await this.stopWatchingScopeThread(scopeId, threadId);
         let binding;
+        let readOnly = false;
         try {
             binding = await this.bindCachedThread(scopeId, threadId);
         }
@@ -7011,7 +7026,10 @@ export class BridgeSessionCore {
                 await this.messaging.answerCallback(event.callbackQueryId, t(locale, 'thread_no_longer_available'));
                 return;
             }
-            throw error;
+            if (!cached || !isThreadActiveWriterError(error))
+                throw error;
+            binding = this.bindCachedThreadReadOnly(scopeId, cached);
+            readOnly = true;
         }
         const threads = this.store.listCachedThreads(scopeId);
         if (threads.length > 0) {
@@ -7042,8 +7060,8 @@ export class BridgeSessionCore {
             await this.editHtmlMessage(scopeId, event.messageId, text, keyboard);
             this.scheduleStalePanelDeletion(scopeId, event.messageId);
         }
-        let callbackText = t(locale, 'thread_opened');
-        if (this.config.codexAppSyncOnOpen) {
+        let callbackText = readOnly ? t(locale, 'thread_opened_read_only') : t(locale, 'thread_opened');
+        if (!readOnly && this.config.codexAppSyncOnOpen) {
             const revealError = await this.tryRevealThread(scopeId, binding.threadId, 'open');
             callbackText = revealError ? t(locale, 'opened_sync_failed_short') : t(locale, 'opened_in_codex_short');
         }
@@ -7076,17 +7094,7 @@ export class BridgeSessionCore {
                 await this.messaging.answerCallback(event.callbackQueryId, t(locale, 'thread_is_archived_use_unarchive'));
                 return;
             }
-            let binding;
-            try {
-                binding = await this.bindCachedThread(scopeId, threadId);
-            }
-            catch (error) {
-                if (isThreadNotFoundError(error)) {
-                    await this.messaging.answerCallback(event.callbackQueryId, t(locale, 'thread_no_longer_available'));
-                    return;
-                }
-                throw error;
-            }
+            const binding = this.bindCachedThreadReadOnly(scopeId, cached);
             const target = resolveScopeMessageTarget(scopeId);
             if (!target) {
                 await this.messaging.answerCallback(event.callbackQueryId, t(locale, 'unsupported_action'));
@@ -11670,6 +11678,9 @@ function formatShortStatusError(error) {
 function isThreadNotFoundError(error) {
     return error instanceof Error && /(thread not found|no rollout found for thread id)/i.test(error.message);
 }
+function isThreadActiveWriterError(error) {
+    return error instanceof Error && /thread\s+\S+\s+already has an active writer/i.test(error.message);
+}
 function isNoActiveTurnToSteerError(error) {
     return error instanceof Error && /no active turn to steer/i.test(error.message);
 }

package/dist/i18n.d.ts

@@ -325,6 +325,7 @@ declare const MESSAGES: {
         readonly attachment_batch_button_analyze: "Analyze";
         readonly attachment_batch_button_clear: "Clear";
         readonly bound_to_thread: "Bound to thread {threadId}";
+        readonly thread_active_writer_read_only: "Another Codex client is currently writing this thread. It is selected read-only; use /watch to mirror live output.";
         readonly line_title: "Title: {value}";
         readonly line_cwd: "CWD: {value}";
         readonly codex_sync_failed: "Codex.app sync failed: {error}";
@@ -407,6 +408,7 @@ declare const MESSAGES: {
         readonly fast_configured: "Fast: {value}";
         readonly thread_no_longer_available: "Thread is no longer available";
         readonly thread_opened: "Thread opened";
+        readonly thread_opened_read_only: "Selected read-only; tap Watch for live output";
         readonly opened_sync_failed_short: "Opened, Codex.app sync failed";
         readonly opened_in_codex_short: "Opened in Codex.app";
         readonly turn_already_finished: "Turn already finished";
@@ -1049,6 +1051,7 @@ declare const MESSAGES: {
         readonly attachment_batch_button_analyze: "分析";
         readonly attachment_batch_button_clear: "清除";
         readonly bound_to_thread: "已绑定到线程 {threadId}";
+        readonly thread_active_writer_read_only: "另一个 Codex 客户端正在写入这个线程。现已只读选中；使用 /watch 可同步实时输出。";
         readonly line_title: "标题：{value}";
         readonly line_cwd: "工作目录：{value}";
         readonly codex_sync_failed: "同步到 Codex.app 失败：{error}";
@@ -1131,6 +1134,7 @@ declare const MESSAGES: {
         readonly fast_configured: "Fast：{value}";
         readonly thread_no_longer_available: "这个线程已经不可用";
         readonly thread_opened: "线程已打开";
+        readonly thread_opened_read_only: "已只读选中；点观察可同步输出";
         readonly opened_sync_failed_short: "已打开，但同步到 Codex.app 失败";
         readonly opened_in_codex_short: "已在 Codex.app 中打开";
         readonly turn_already_finished: "这轮回复已经结束了";

package/dist/i18n.js

@@ -323,6 +323,7 @@ const MESSAGES = {
         attachment_batch_button_analyze: 'Analyze',
         attachment_batch_button_clear: 'Clear',
         bound_to_thread: 'Bound to thread {threadId}',
+        thread_active_writer_read_only: 'Another Codex client is currently writing this thread. It is selected read-only; use /watch to mirror live output.',
         line_title: 'Title: {value}',
         line_cwd: 'CWD: {value}',
         codex_sync_failed: 'Codex.app sync failed: {error}',
@@ -405,6 +406,7 @@ const MESSAGES = {
         fast_configured: 'Fast: {value}',
         thread_no_longer_available: 'Thread is no longer available',
         thread_opened: 'Thread opened',
+        thread_opened_read_only: 'Selected read-only; tap Watch for live output',
         opened_sync_failed_short: 'Opened, Codex.app sync failed',
         opened_in_codex_short: 'Opened in Codex.app',
         turn_already_finished: 'Turn already finished',
@@ -1047,6 +1049,7 @@ const MESSAGES = {
         attachment_batch_button_analyze: '分析',
         attachment_batch_button_clear: '清除',
         bound_to_thread: '已绑定到线程 {threadId}',
+        thread_active_writer_read_only: '另一个 Codex 客户端正在写入这个线程。现已只读选中；使用 /watch 可同步实时输出。',
         line_title: '标题：{value}',
         line_cwd: '工作目录：{value}',
         codex_sync_failed: '同步到 Codex.app 失败：{error}',
@@ -1129,6 +1132,7 @@ const MESSAGES = {
         fast_configured: 'Fast：{value}',
         thread_no_longer_available: '这个线程已经不可用',
         thread_opened: '线程已打开',
+        thread_opened_read_only: '已只读选中；点观察可同步输出',
         opened_sync_failed_short: '已打开，但同步到 Codex.app 失败',
         opened_in_codex_short: '已在 Codex.app 中打开',
         turn_already_finished: '这轮回复已经结束了',

package/dist/telegram/gateway.js

@@ -246,6 +246,9 @@ export class TelegramGateway extends EventEmitter {
                     await this.resolveBotIdentity(true);
                     await this.registerCommands();
                     remoteInitialized = true;
+                    this.emit('remoteReady');
+                    if (!this.running)
+                        return;
                 }
                 const offset = this.store.getTelegramOffset(this.botKey) + 1;
                 const result = await callTelegramApi(this.botToken, 'getUpdates', {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foxden-app/foxclaw",
-  "version": "0.6.5",
+  "version": "0.6.7",
   "description": "Foxden local execution claw for controlling Codex and OpenCode from trusted chat interfaces.",
   "type": "module",
   "main": "dist/main.js",