@foxden-app/foxclaw 0.6.6 → 0.6.8

package/CHANGELOG.md

@@ -2,6 +2,26 @@
 
 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.8 - 2026-08-15
+
+### 中文
+- 修复只读观察 Codex CLI 0.147.0 会话时只显示“正在思考...”和“已完成。”、遗漏实际回复的问题。会话日志观察器现在识别新的 `item_completed` / `AgentMessage` 结构，并沿用 Codex 消息 ID，避免同一正文与 `response_item` 镜像重复发送。
+- 识别新日志中的 `turn_aborted` 和 `turn_interrupted`，让被中断的外部 CLI 轮次明确结束为“已中断”，不再残留为进行中状态。
+
+### English
+- Fixed read-only observation of Codex CLI 0.147.0 sessions showing only “Thinking...” and “Completed.” while dropping the actual response. The session-log observer now recognizes the new `item_completed` / `AgentMessage` shape and preserves Codex message IDs without duplicating the mirrored `response_item`.
+- Recognizes `turn_aborted` and `turn_interrupted` in new session logs so interrupted external CLI turns finish explicitly instead of remaining active.
+
+## 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
 
 ### 中文

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

@@ -650,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);
                 }
@@ -658,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 = [
@@ -668,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'));
                 }
@@ -981,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);
@@ -3721,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);
@@ -7007,6 +7017,7 @@ export class BridgeSessionCore {
         }
         await this.stopWatchingScopeThread(scopeId, threadId);
         let binding;
+        let readOnly = false;
         try {
             binding = await this.bindCachedThread(scopeId, threadId);
         }
@@ -7015,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) {
@@ -7046,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');
         }
@@ -7080,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'));
@@ -11674,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/controller/session_observer.js

@@ -104,6 +104,16 @@ function applySessionRecord(record, cursor) {
     if (type === 'event_msg' && payload?.type === 'agent_message' && typeof payload.message === 'string') {
         return createSessionTextEvents(activeTurnId, cursor, payload.message, typeof payload.phase === 'string' ? payload.phase : null, false);
     }
+    if (type === 'event_msg'
+        && payload?.type === 'item_completed'
+        && payload?.turn_id === activeTurnId
+        && normalizeSessionItemType(payload?.item) === 'agentmessage') {
+        const text = extractSessionItemText(payload.item);
+        if (text === null) {
+            return { cursor, events: [], startedTurnId: null, turnCompleted: false };
+        }
+        return createSessionTextEvents(activeTurnId, cursor, text, typeof payload.item.phase === 'string' ? payload.item.phase : null, false, false, typeof payload.item.id === 'string' ? payload.item.id : null);
+    }
     if (type === 'response_item' && payload?.type === 'plan' && typeof payload.text === 'string') {
         return createSessionTextEvents(activeTurnId, cursor, payload.text, 'commentary', true, true);
     }
@@ -169,6 +179,20 @@ function applySessionRecord(record, cursor) {
             turnCompleted: true,
         };
     }
+    if (type === 'event_msg'
+        && (payload?.type === 'turn_aborted' || payload?.type === 'turn_interrupted')
+        && payload?.turn_id === activeTurnId) {
+        return {
+            cursor: { activeTurnId: null, nextMessageIndex: 0 },
+            events: [{
+                    kind: 'turn_completed',
+                    turnId: activeTurnId,
+                    state: 'interrupted',
+                }],
+            startedTurnId: null,
+            turnCompleted: true,
+        };
+    }
     return {
         cursor,
         events: [],
@@ -179,8 +203,8 @@ function applySessionRecord(record, cursor) {
 function buildSessionItemId(turnId, index) {
     return `${turnId}:session:${index}`;
 }
-function createSessionTextEvents(activeTurnId, cursor, text, phase, forceCommentary, isPlan = false) {
-    const itemId = buildSessionItemId(activeTurnId, cursor.nextMessageIndex + 1);
+function createSessionTextEvents(activeTurnId, cursor, text, phase, forceCommentary, isPlan = false, sourceItemId = null) {
+    const itemId = sourceItemId ?? buildSessionItemId(activeTurnId, cursor.nextMessageIndex + 1);
     const outputKind = forceCommentary ? 'commentary' : classifyAgentOutput(phase, true);
     const streamOutputKind = forceCommentary ? 'commentary' : classifyAgentOutput(phase, false);
     return {
@@ -219,6 +243,24 @@ function createSessionTextEvents(activeTurnId, cursor, text, phase, forceComment
         turnCompleted: false,
     };
 }
+function normalizeSessionItemType(item) {
+    if (typeof item?.type !== 'string') {
+        return null;
+    }
+    return item.type.replace(/[^a-z]/gi, '').toLowerCase();
+}
+function extractSessionItemText(item) {
+    if (typeof item?.text === 'string') {
+        return item.text;
+    }
+    if (!Array.isArray(item?.content)) {
+        return null;
+    }
+    const parts = item.content
+        .map((entry) => typeof entry?.text === 'string' ? entry.text : '')
+        .filter(Boolean);
+    return parts.length > 0 ? parts.join('') : null;
+}
 function createExecStartEvent(turnId, payload) {
     const callId = typeof payload.call_id === 'string' ? payload.call_id : null;
     if (!callId) {

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/package.json

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