@foxden-app/foxclaw 0.3.12 → 0.3.13

package/dist/codex_app/local_usage.d.ts

@@ -11,6 +11,14 @@ export interface CodexLocalUsageStats {
     turns: number;
     usageEvents: number;
     totals: CodexLocalUsageTotals;
+    outputSpeed: CodexLocalOutputSpeedStats;
     latestSessionMtimeMs: number | null;
 }
+export interface CodexLocalOutputSpeedStats {
+    samples: number;
+    outputTokens: number;
+    seconds: number;
+    latestTokensPerSecond: number | null;
+    latestSampleAtMs: number | null;
+}
 export declare function readCodexLocalUsageStats(codexHome?: string): Promise<CodexLocalUsageStats>;

package/dist/codex_app/local_usage.js

@@ -13,6 +13,7 @@ export async function readCodexLocalUsageStats(codexHome = resolveCodexHome()) {
     let sessionsWithUsage = 0;
     let usageEvents = 0;
     let latestSessionMtimeMs = null;
+    const outputSpeed = emptyOutputSpeedStats();
     for (const filePath of sessionFiles) {
         const stat = await fs.stat(filePath).catch(() => null);
         if (stat) {
@@ -20,6 +21,7 @@ export async function readCodexLocalUsageStats(codexHome = resolveCodexHome()) {
         }
         const fileUsage = await readSessionUsage(filePath, turnIds);
         usageEvents += fileUsage.usageEvents;
+        addOutputSpeed(outputSpeed, fileUsage.outputSpeed);
         if (fileUsage.totalUsage) {
             sessionsWithUsage += 1;
             addUsage(totals, fileUsage.totalUsage);
@@ -31,6 +33,7 @@ export async function readCodexLocalUsageStats(codexHome = resolveCodexHome()) {
         turns: turnIds.size,
         usageEvents,
         totals,
+        outputSpeed,
         latestSessionMtimeMs,
     };
 }
@@ -66,6 +69,8 @@ async function readSessionUsage(filePath, turnIds) {
     const reader = readline.createInterface({ input: stream, crlfDelay: Infinity });
     let totalUsage = null;
     let usageEvents = 0;
+    let generationStartMs = null;
+    const outputSpeed = emptyOutputSpeedStats();
     try {
         for await (const line of reader) {
             if (!line.trim())
@@ -77,13 +82,22 @@ async function readSessionUsage(filePath, turnIds) {
             catch {
                 continue;
             }
+            const timestampMs = parseTimestampMs(event?.timestamp);
             const turnId = typeof event?.payload?.turn_id === 'string' ? event.payload.turn_id : null;
             if (turnId) {
                 turnIds.add(turnId);
             }
+            if (timestampMs !== null && isGenerationBoundary(event)) {
+                generationStartMs = timestampMs;
+            }
             const info = event?.payload?.info;
-            if (info?.last_token_usage || info?.lastTokenUsage) {
+            const lastTokenUsage = info?.last_token_usage ?? info?.lastTokenUsage;
+            if (lastTokenUsage) {
                 usageEvents += 1;
+                addOutputSpeedSample(outputSpeed, lastTokenUsage, generationStartMs, timestampMs);
+                if (timestampMs !== null) {
+                    generationStartMs = timestampMs;
+                }
             }
             const totalTokenUsage = info?.total_token_usage ?? info?.totalTokenUsage;
             if (totalTokenUsage) {
@@ -94,7 +108,7 @@ async function readSessionUsage(filePath, turnIds) {
     finally {
         reader.close();
     }
-    return { usageEvents, totalUsage };
+    return { usageEvents, totalUsage, outputSpeed };
 }
 function emptyTotals() {
     return {
@@ -105,6 +119,15 @@ function emptyTotals() {
         totalTokens: 0,
     };
 }
+function emptyOutputSpeedStats() {
+    return {
+        samples: 0,
+        outputTokens: 0,
+        seconds: 0,
+        latestTokensPerSecond: null,
+        latestSampleAtMs: null,
+    };
+}
 function addUsage(totals, usage) {
     const inputTokens = numberField(usage, 'input_tokens', 'inputTokens');
     const outputTokens = numberField(usage, 'output_tokens', 'outputTokens');
@@ -115,9 +138,57 @@ function addUsage(totals, usage) {
     totals.reasoningOutputTokens += numberField(usage, 'reasoning_output_tokens', 'reasoningOutputTokens');
     totals.totalTokens += totalTokens || inputTokens + outputTokens;
 }
+function addOutputSpeed(target, source) {
+    target.samples += source.samples;
+    target.outputTokens += source.outputTokens;
+    target.seconds += source.seconds;
+    if (source.latestTokensPerSecond !== null
+        && source.latestSampleAtMs !== null
+        && (target.latestSampleAtMs === null || source.latestSampleAtMs > target.latestSampleAtMs)) {
+        target.latestTokensPerSecond = source.latestTokensPerSecond;
+        target.latestSampleAtMs = source.latestSampleAtMs;
+    }
+}
+function addOutputSpeedSample(stats, usage, generationStartMs, timestampMs) {
+    if (generationStartMs === null || timestampMs === null || timestampMs <= generationStartMs) {
+        return;
+    }
+    const outputTokens = numberField(usage, 'output_tokens', 'outputTokens');
+    if (outputTokens <= 0) {
+        return;
+    }
+    const seconds = (timestampMs - generationStartMs) / 1000;
+    if (!Number.isFinite(seconds) || seconds <= 0) {
+        return;
+    }
+    stats.samples += 1;
+    stats.outputTokens += outputTokens;
+    stats.seconds += seconds;
+    stats.latestTokensPerSecond = outputTokens / seconds;
+    stats.latestSampleAtMs = timestampMs;
+}
 function numberField(source, snakeKey, camelKey) {
     const snakeValue = source[snakeKey];
     const value = snakeValue === undefined || snakeValue === null ? source[camelKey] : snakeValue;
     const numeric = Number(value);
     return Number.isFinite(numeric) ? numeric : 0;
 }
+function parseTimestampMs(value) {
+    if (typeof value !== 'string' || value.trim().length === 0) {
+        return null;
+    }
+    const timestamp = Date.parse(value);
+    return Number.isFinite(timestamp) ? timestamp : null;
+}
+function isGenerationBoundary(event) {
+    const payload = event?.payload;
+    if (event?.type === 'response_item' && payload?.type === 'function_call_output') {
+        return true;
+    }
+    if (event?.type !== 'event_msg') {
+        return false;
+    }
+    return payload?.type === 'task_started'
+        || payload?.type === 'exec_command_end'
+        || payload?.type === 'user_message';
+}

package/dist/controller/controller.d.ts

@@ -255,8 +255,10 @@ export declare class BridgeSessionCore {
     private buildNativeCollaborationMode;
     private buildCodexUsageStatusLines;
     private buildCodexLocalUsageStatusLines;
+    private formatCodexLocalOutputSpeedStatusLines;
     private resolveFastStatusLabel;
     private readCachedCodexLocalUsageStats;
+    private sendThreadContextSummary;
     private handleModelCommand;
     private handleEffortCommand;
     private handleThreadOpenCallback;

package/dist/controller/controller.js

@@ -4,7 +4,7 @@ import os from 'node:os';
 import path from 'node:path';
 import { normalizeLocale, t } from '../i18n.js';
 import { parseCommand } from './commands.js';
-import { buildAccessSettingsKeyboard, buildModelSettingsKeyboard, buildSetupPanelKeyboard, buildThreadListKeyboard, buildThreadsKeyboard, clampEffortToModel, formatAccessPresetLabel, formatActiveTurnMessageModeLabel, formatAccessSettingsMessage, formatApprovalPolicyLabel, formatCollaborationModeLabel, formatModelSettingsMessage, formatSandboxModeLabel, formatServiceTierStatusLabel, formatSetupPanelMessage, formatThreadsMessage, formatWeixinAccessCopyPaste, formatWeixinModelCopyPaste, formatWeixinThreadsCopyPaste, formatWeixinWhereNavCopyPaste, formatWhereMessage, normalizeRequestedEffort, resolveCurrentModel, resolveActiveTurnMessageMode, resolveRequestedModel, } from './presentation.js';
+import { buildAccessSettingsKeyboard, buildModelSettingsKeyboard, buildSetupPanelKeyboard, buildThreadListKeyboard, buildThreadsKeyboard, clampEffortToModel, formatAccessPresetLabel, formatActiveTurnMessageModeLabel, formatAccessSettingsMessage, formatApprovalPolicyLabel, formatCollaborationModeLabel, formatModelSettingsMessage, formatSandboxModeLabel, formatServiceTierStatusLabel, formatSetupPanelMessage, formatThreadContextSummary, formatThreadsMessage, formatWeixinAccessCopyPaste, formatWeixinModelCopyPaste, formatWeixinThreadsCopyPaste, formatWeixinWhereNavCopyPaste, formatWhereMessage, normalizeRequestedEffort, resolveCurrentModel, resolveActiveTurnMessageMode, resolveRequestedModel, } from './presentation.js';
 import { clampServiceTierToModel, resolveFastTierForModel } from './service_tier.js';
 import { TELEGRAM_BOT_API_DOWNLOAD_LIMIT_BYTES, buildAttachmentPrompt, isNativeImageAttachment, planAttachmentStoragePath, summarizeTelegramInput, } from '../telegram/media.js';
 import { TELEGRAM_MESSAGE_LIMIT, chunkTelegramMessage, chunkTelegramStreamMessage, clipTelegramDraftMessage, } from '../telegram/text.js';
@@ -505,6 +505,7 @@ export class BridgeSessionCore {
                     lines.push(revealError ? t(locale, 'codex_sync_failed', { error: revealError }) : t(locale, 'opened_in_codex'));
                 }
                 await this.sendMessage(scopeId, lines.join('\n'));
+                await this.sendThreadContextSummary(scopeId, locale, binding.threadId);
                 return;
             }
             case 'watch': {
@@ -831,13 +832,16 @@ export class BridgeSessionCore {
         const mode = watch.mode;
         if (mode === 'already') {
             await this.sendMessage(scopeId, t(locale, 'watch_already_enabled', { threadId: watchedThreadId }));
+            await this.sendThreadContextSummary(scopeId, locale, watchedThreadId);
             return;
         }
         if (mode === 'active') {
             await this.sendMessage(scopeId, t(locale, 'watch_started_active', { threadId: watchedThreadId }));
+            await this.sendThreadContextSummary(scopeId, locale, watchedThreadId);
             return;
         }
         await this.sendMessage(scopeId, t(locale, 'watch_started_idle', { threadId: watchedThreadId }));
+        await this.sendThreadContextSummary(scopeId, locale, watchedThreadId);
     }
     async handleThreadArchiveIndexCommand(scopeId, locale, args) {
         const index = Number.parseInt(args[0] || '', 10);
@@ -4439,6 +4443,7 @@ export class BridgeSessionCore {
                     cached: formatTokenCount(stats.totals.cachedInputTokens),
                     reasoning: formatTokenCount(stats.totals.reasoningOutputTokens),
                 }),
+                ...this.formatCodexLocalOutputSpeedStatusLines(locale, stats),
             ];
         }
         catch (error) {
@@ -4446,6 +4451,18 @@ export class BridgeSessionCore {
             return [t(locale, 'status_codex_local_usage_unavailable', { error: formatShortStatusError(error) })];
         }
     }
+    formatCodexLocalOutputSpeedStatusLines(locale, stats) {
+        const speed = stats.outputSpeed;
+        if (speed.samples === 0 || speed.outputTokens <= 0 || speed.seconds <= 0) {
+            return [];
+        }
+        const avg = speed.outputTokens / speed.seconds;
+        return [t(locale, 'status_codex_local_speed', {
+                avg: formatCompactNumber(avg),
+                latest: speed.latestTokensPerSecond === null ? t(locale, 'unknown') : formatCompactNumber(speed.latestTokensPerSecond),
+                samples: formatTokenCount(speed.samples),
+            })];
+    }
     async resolveFastStatusLabel(locale, settings) {
         try {
             const models = await this.app.listModels();
@@ -4466,6 +4483,22 @@ export class BridgeSessionCore {
         this.localUsageCache = { stats, expiresAt: now + CODEX_LOCAL_USAGE_CACHE_MS };
         return stats;
     }
+    async sendThreadContextSummary(scopeId, locale, threadId) {
+        try {
+            const turns = await this.app.listThreadTurns(threadId, 5);
+            const text = formatThreadContextSummary(locale, turns);
+            if (text) {
+                await this.sendMessage(scopeId, text);
+            }
+        }
+        catch (error) {
+            this.logger.warn('codex.thread_context_summary_failed', {
+                scopeId,
+                threadId,
+                error: formatUserError(error),
+            });
+        }
+    }
     async handleModelCommand(event, locale, args) {
         const scopeId = event.scopeId;
         if (args.length === 0) {
@@ -4627,6 +4660,7 @@ export class BridgeSessionCore {
             callbackText = revealError ? t(locale, 'opened_sync_failed_short') : t(locale, 'opened_in_codex_short');
         }
         await this.messaging.answerCallback(event.callbackQueryId, callbackText);
+        await this.sendThreadContextSummary(scopeId, locale, binding.threadId);
     }
     async handleThreadActionCallback(event, action, threadId, locale) {
         const scopeId = event.scopeId;
@@ -4673,6 +4707,7 @@ export class BridgeSessionCore {
             const watch = await this.watchThread(scopeId, target.chatId, target.chatType, target.topicId, binding);
             await this.showThreadsPanelFromStoredState(scopeId, event.messageId, locale, false);
             await this.messaging.answerCallback(event.callbackQueryId, formatWatchCallbackText(locale, watch.mode, watch.threadId));
+            await this.sendThreadContextSummary(scopeId, locale, watch.threadId);
             return;
         }
         if (action === 'archive') {

package/dist/controller/presentation.d.ts

@@ -1,4 +1,4 @@
-import type { AccessPresetValue, ActiveTurnMessageMode, AppLocale, AppThread, ApprovalPolicyValue, ChatSessionSettings, CollaborationModeValue, ModelInfo, ReasoningEffortValue, SandboxModeValue } from '../types.js';
+import type { AccessPresetValue, ActiveTurnMessageMode, AppLocale, AppThread, AppTurnSnapshot, ApprovalPolicyValue, ChatSessionSettings, CollaborationModeValue, ModelInfo, ReasoningEffortValue, SandboxModeValue } from '../types.js';
 import type { ResolvedAccessMode } from './access.js';
 type InlineButton = {
     text: string;
@@ -60,6 +60,7 @@ pageOffset?: number): string;
 export declare function formatWeixinModelCopyPaste(locale: AppLocale, models: ModelInfo[], settings: ChatSessionSettings | null): string;
 export declare function formatWeixinAccessCopyPaste(locale: AppLocale): string;
 export declare function formatWeixinWhereNavCopyPaste(locale: AppLocale, hasBinding: boolean, defaultCwd?: string): string;
+export declare function formatThreadContextSummary(locale: AppLocale, turns: AppTurnSnapshot[]): string | null;
 export declare function formatSetupPanelMessage(locale: AppLocale, ctx: SetupPanelContext): string;
 export declare function buildSetupPanelKeyboard(locale: AppLocale, ctx: SetupPanelContext): InlineButton[][];
 export declare function resolveSetupSummaryLine(ctx: SetupPanelContext, locale?: AppLocale): string;

package/dist/controller/presentation.js

@@ -225,6 +225,20 @@ export function formatWeixinWhereNavCopyPaste(locale, hasBinding, defaultCwd) {
     }
     return lines.join('\n');
 }
+export function formatThreadContextSummary(locale, turns) {
+    const context = selectRecentThreadContext(turns);
+    if (!context) {
+        return null;
+    }
+    return [
+        t(locale, 'thread_context_title'),
+        t(locale, 'thread_context_user'),
+        context.userText || t(locale, 'empty'),
+        '',
+        t(locale, 'thread_context_codex'),
+        context.codexText || t(locale, 'empty'),
+    ].join('\n');
+}
 export function formatSetupPanelMessage(locale, ctx) {
     const currentModel = resolveCurrentModel(ctx.models, ctx.settings?.model ?? null);
     const fastTier = resolveFastTierForModel(currentModel);
@@ -393,6 +407,52 @@ function formatFastSetupLabel(locale, supported, enabled, tierName) {
 function resolveCollaborationMode(mode) {
     return mode === 'plan' ? 'plan' : 'default';
 }
+function selectRecentThreadContext(turns) {
+    for (const turn of turns) {
+        const userText = lastItemText(turn.items, isUserTurnItem);
+        const codexText = lastItemText(turn.items, isCodexTurnItem);
+        if (userText || codexText) {
+            return { userText, codexText };
+        }
+    }
+    return null;
+}
+function lastItemText(items, predicate) {
+    for (let index = items.length - 1; index >= 0; index -= 1) {
+        const item = items[index];
+        if (!predicate(item)) {
+            continue;
+        }
+        const text = normalizeThreadContextText(item.text ?? item.aggregatedOutput ?? item.command ?? '');
+        if (text) {
+            return text;
+        }
+    }
+    return null;
+}
+function isUserTurnItem(item) {
+    const type = normalizeTurnItemType(item.type);
+    return type === 'user'
+        || type === 'usermessage'
+        || type === 'humanmessage'
+        || type === 'userinput'
+        || type === 'userrequest';
+}
+function isCodexTurnItem(item) {
+    const type = normalizeTurnItemType(item.type);
+    return type === 'agent'
+        || type === 'assistant'
+        || type === 'agentmessage'
+        || type === 'assistantmessage'
+        || type === 'plan';
+}
+function normalizeTurnItemType(value) {
+    return value.replace(/[^a-z]/gi, '').toLowerCase();
+}
+function normalizeThreadContextText(value) {
+    const trimmed = value.replace(/\r\n/g, '\n').trim().replace(/\n{3,}/g, '\n\n');
+    return truncate(trimmed, 1200);
+}
 function selectedButtonText(selected, label) {
     return `${selected ? '• ' : ''}${label}`;
 }

package/dist/i18n.d.ts

@@ -111,6 +111,7 @@ declare const MESSAGES: {
         readonly status_codex_usage_unavailable: "Codex usage: unavailable ({error})";
         readonly status_codex_local_history: "Codex local history: {sessions} sessions, {turns} turns, {events} usage records";
         readonly status_codex_local_tokens: "Codex local tokens: total {total}; input {input}, output {output}, cached input {cached}, reasoning output {reasoning}";
+        readonly status_codex_local_speed: "Codex local output speed: avg {avg} token/s, latest {latest} token/s ({samples} samples)";
         readonly status_codex_local_usage_unavailable: "Codex local history: unavailable ({error})";
         readonly status_codex_credits: "Codex credits: {value}";
         readonly status_codex_limit_reached: "Codex limit: {value}";
@@ -315,6 +316,9 @@ declare const MESSAGES: {
         readonly threads_filter: "Filter: <code>{searchTerm}</code>";
         readonly threads_range: "Showing {start}-{end}";
         readonly threads_filter_cleared_short: "Filter cleared";
+        readonly thread_context_title: "Recent context:";
+        readonly thread_context_user: "User:";
+        readonly thread_context_codex: "Codex:";
         readonly button_prev_page: "⬅️ Prev";
         readonly button_next_page: "➡️ Next";
         readonly button_clear_filter: "🧹 Clear";
@@ -661,6 +665,7 @@ declare const MESSAGES: {
         readonly status_codex_usage_unavailable: "Codex 用量：无法获取（{error}）";
         readonly status_codex_local_history: "Codex 本地历史：{sessions} 个会话，{turns} 轮，{events} 条用量记录";
         readonly status_codex_local_tokens: "Codex 本地 Token：总计 {total}；输入 {input}，输出 {output}，缓存输入 {cached}，推理输出 {reasoning}";
+        readonly status_codex_local_speed: "Codex 本地输出速度：平均 {avg} token/s，最近 {latest} token/s（{samples} 个样本）";
         readonly status_codex_local_usage_unavailable: "Codex 本地历史：无法获取（{error}）";
         readonly status_codex_credits: "Codex 额度：{value}";
         readonly status_codex_limit_reached: "Codex 限制：{value}";
@@ -865,6 +870,9 @@ declare const MESSAGES: {
         readonly threads_filter: "筛选：<code>{searchTerm}</code>";
         readonly threads_range: "显示第 {start}-{end} 条";
         readonly threads_filter_cleared_short: "已清除筛选";
+        readonly thread_context_title: "最近上下文：";
+        readonly thread_context_user: "用户指令：";
+        readonly thread_context_codex: "Codex 最后输出：";
         readonly button_prev_page: "⬅️ 上一页";
         readonly button_next_page: "➡️ 下一页";
         readonly button_clear_filter: "🧹 清除";

package/dist/i18n.js

@@ -109,6 +109,7 @@ const MESSAGES = {
         status_codex_usage_unavailable: 'Codex usage: unavailable ({error})',
         status_codex_local_history: 'Codex local history: {sessions} sessions, {turns} turns, {events} usage records',
         status_codex_local_tokens: 'Codex local tokens: total {total}; input {input}, output {output}, cached input {cached}, reasoning output {reasoning}',
+        status_codex_local_speed: 'Codex local output speed: avg {avg} token/s, latest {latest} token/s ({samples} samples)',
         status_codex_local_usage_unavailable: 'Codex local history: unavailable ({error})',
         status_codex_credits: 'Codex credits: {value}',
         status_codex_limit_reached: 'Codex limit: {value}',
@@ -313,6 +314,9 @@ const MESSAGES = {
         threads_filter: 'Filter: <code>{searchTerm}</code>',
         threads_range: 'Showing {start}-{end}',
         threads_filter_cleared_short: 'Filter cleared',
+        thread_context_title: 'Recent context:',
+        thread_context_user: 'User:',
+        thread_context_codex: 'Codex:',
         button_prev_page: '⬅️ Prev',
         button_next_page: '➡️ Next',
         button_clear_filter: '🧹 Clear',
@@ -659,6 +663,7 @@ const MESSAGES = {
         status_codex_usage_unavailable: 'Codex 用量：无法获取（{error}）',
         status_codex_local_history: 'Codex 本地历史：{sessions} 个会话，{turns} 轮，{events} 条用量记录',
         status_codex_local_tokens: 'Codex 本地 Token：总计 {total}；输入 {input}，输出 {output}，缓存输入 {cached}，推理输出 {reasoning}',
+        status_codex_local_speed: 'Codex 本地输出速度：平均 {avg} token/s，最近 {latest} token/s（{samples} 个样本）',
         status_codex_local_usage_unavailable: 'Codex 本地历史：无法获取（{error}）',
         status_codex_credits: 'Codex 额度：{value}',
         status_codex_limit_reached: 'Codex 限制：{value}',
@@ -863,6 +868,9 @@ const MESSAGES = {
         threads_filter: '筛选：<code>{searchTerm}</code>',
         threads_range: '显示第 {start}-{end} 条',
         threads_filter_cleared_short: '已清除筛选',
+        thread_context_title: '最近上下文：',
+        thread_context_user: '用户指令：',
+        thread_context_codex: 'Codex 最后输出：',
         button_prev_page: '⬅️ 上一页',
         button_next_page: '➡️ 下一页',
         button_clear_filter: '🧹 清除',

package/package.json

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