@foxden-app/foxclaw 0.6.7 → 0.6.9

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.9 - 2026-08-15
+
+### 中文
+- 补齐 Codex CLI 0.147.0 会话日志的其他观察兼容：新的 `item_completed` / `UserMessage` 会继续把 CLI 侧补充输入镜像到 Telegram，保持原有 `codex-cli-user` 体验。
+- 识别新的 `custom_tool_call`、`function_call` 及其 output 记录，严格按 `call_id` 跨轮询分片配对，让长时间工具调用恢复“正在运行/已运行”状态；未知或孤立 output 保持静默，不猜测配对。`Reasoning`、`ContextCompaction`、`Extension` 等内部记录仍不会污染聊天。
+
+### English
+- Completed the remaining Codex CLI 0.147.0 session-log observation compatibility. New `item_completed` / `UserMessage` records continue mirroring CLI-side follow-up input to Telegram with the existing `codex-cli-user` experience.
+- Recognizes new `custom_tool_call`, `function_call`, and matching output records across polling chunks, pairing them strictly by `call_id` so long-running tools regain Running/Completed status. Unknown or orphan outputs stay silent, while internal `Reasoning`, `ContextCompaction`, and `Extension` records remain chat-invisible.
+
+## 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
 
 ### 中文

package/dist/controller/session_observer.d.ts

@@ -2,6 +2,7 @@ import { type TurnActivityEvent } from './activity.js';
 export interface SessionLogCursor {
     activeTurnId: string | null;
     nextMessageIndex: number;
+    pendingToolCalls?: SessionToolCall[];
 }
 export interface SessionLogBootstrap {
     cursor: SessionLogCursor;
@@ -17,6 +18,12 @@ export interface SplitJsonlChunk {
     lines: string[];
     remainder: string;
 }
+interface SessionToolCall {
+    callId: string;
+    kind: 'custom' | 'function';
+    name: string;
+}
 export declare function splitJsonlChunk(remainder: string, chunk: string): SplitJsonlChunk;
 export declare function bootstrapSessionLog(lines: string[]): SessionLogBootstrap;
 export declare function applySessionLog(lines: string[], cursor: SessionLogCursor): SessionLogDiff;
+export {};

package/dist/controller/session_observer.js

@@ -13,34 +13,30 @@ export function splitJsonlChunk(remainder, chunk) {
 }
 export function bootstrapSessionLog(lines) {
     const records = parseRecords(lines);
-    let activeTurnId = null;
-    let nextMessageIndex = 0;
+    let state = { activeTurnId: null, nextMessageIndex: 0 };
     let events = [];
     for (const record of records) {
-        const next = applySessionRecord(record, { activeTurnId, nextMessageIndex });
+        const next = applySessionRecord(record, state);
         if (next.startedTurnId) {
-            activeTurnId = next.startedTurnId;
-            nextMessageIndex = 0;
+            state = next.cursor;
             events = [];
             continue;
         }
-        if (!activeTurnId) {
+        if (!state.activeTurnId) {
             continue;
         }
         if (next.turnCompleted) {
-            activeTurnId = null;
-            nextMessageIndex = 0;
+            state = next.cursor;
             events = [];
             continue;
         }
         events.push(...next.events);
-        activeTurnId = next.cursor.activeTurnId;
-        nextMessageIndex = next.cursor.nextMessageIndex;
+        state = next.cursor;
     }
     return {
-        cursor: { activeTurnId, nextMessageIndex },
+        cursor: state,
         events,
-        startedTurnId: activeTurnId,
+        startedTurnId: state.activeTurnId,
     };
 }
 export function applySessionLog(lines, cursor) {
@@ -51,10 +47,7 @@ export function applySessionLog(lines, cursor) {
     for (const record of records) {
         const next = applySessionRecord(record, state);
         if (next.startedTurnId) {
-            state = {
-                activeTurnId: next.startedTurnId,
-                nextMessageIndex: 0,
-            };
+            state = next.cursor;
             startedTurnIds.push(next.startedTurnId);
             continue;
         }
@@ -104,6 +97,35 @@ 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 === 'event_msg'
+        && payload?.type === 'item_completed'
+        && payload?.turn_id === activeTurnId
+        && normalizeSessionItemType(payload?.item) === 'usermessage') {
+        const text = extractSessionItemText(payload.item)?.trim() ?? '';
+        if (!text) {
+            return { cursor, events: [], startedTurnId: null, turnCompleted: false };
+        }
+        return {
+            cursor,
+            events: [{
+                    kind: 'user_message',
+                    turnId: activeTurnId,
+                    text,
+                }],
+            startedTurnId: null,
+            turnCompleted: false,
+        };
+    }
     if (type === 'response_item' && payload?.type === 'plan' && typeof payload.text === 'string') {
         return createSessionTextEvents(activeTurnId, cursor, payload.text, 'commentary', true, true);
     }
@@ -140,6 +162,18 @@ function applySessionRecord(record, cursor) {
             turnCompleted: false,
         };
     }
+    if (type === 'response_item' && payload?.type === 'custom_tool_call') {
+        return createSessionToolStart(activeTurnId, cursor, payload, 'custom');
+    }
+    if (type === 'response_item' && payload?.type === 'function_call') {
+        return createSessionToolStart(activeTurnId, cursor, payload, 'function');
+    }
+    if (type === 'response_item' && payload?.type === 'custom_tool_call_output') {
+        return createSessionToolEnd(activeTurnId, cursor, payload, 'custom');
+    }
+    if (type === 'response_item' && payload?.type === 'function_call_output') {
+        return createSessionToolEnd(activeTurnId, cursor, payload, 'function');
+    }
     if (type === 'event_msg' && payload?.type === 'exec_command_end' && payload?.turn_id === activeTurnId) {
         const exec = createExecEndEvent(payload);
         if (!exec) {
@@ -169,6 +203,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,12 +227,13 @@ 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 {
         cursor: {
+            ...cursor,
             activeTurnId,
             nextMessageIndex: cursor.nextMessageIndex + 1,
         },
@@ -219,6 +268,80 @@ function createSessionTextEvents(activeTurnId, cursor, text, phase, forceComment
         turnCompleted: false,
     };
 }
+function createSessionToolStart(turnId, cursor, payload, kind) {
+    const callId = typeof payload?.call_id === 'string' ? payload.call_id : null;
+    const name = typeof payload?.name === 'string' ? payload.name.trim() : '';
+    if (!callId || !name) {
+        return { cursor, events: [], startedTurnId: null, turnCompleted: false };
+    }
+    const pendingToolCalls = [
+        ...(cursor.pendingToolCalls ?? []).filter(call => call.callId !== callId),
+        { callId, kind, name },
+    ];
+    const exec = createSessionToolEvent(turnId, callId, name);
+    return {
+        cursor: { ...cursor, pendingToolCalls },
+        events: [{
+                kind: 'tool_started',
+                turnId,
+                exec,
+                state: inferToolActivityState(exec),
+            }],
+        startedTurnId: null,
+        turnCompleted: false,
+    };
+}
+function createSessionToolEnd(turnId, cursor, payload, kind) {
+    const callId = typeof payload?.call_id === 'string' ? payload.call_id : null;
+    const pending = callId
+        ? (cursor.pendingToolCalls ?? []).find(call => call.callId === callId && call.kind === kind)
+        : null;
+    if (!pending) {
+        return { cursor, events: [], startedTurnId: null, turnCompleted: false };
+    }
+    const exec = createSessionToolEvent(turnId, pending.callId, pending.name);
+    return {
+        cursor: {
+            ...cursor,
+            pendingToolCalls: (cursor.pendingToolCalls ?? []).filter(call => call !== pending),
+        },
+        events: [{
+                kind: 'tool_completed',
+                turnId,
+                exec,
+                state: inferToolActivityState(exec),
+            }],
+        startedTurnId: null,
+        turnCompleted: false,
+    };
+}
+function createSessionToolEvent(turnId, callId, name) {
+    return {
+        callId,
+        turnId,
+        command: [`Tool ${name}`],
+        cwd: null,
+        parsedCmd: [],
+    };
+}
+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/package.json

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