@foxden-app/foxclaw 0.6.3 → 0.6.5

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.5 - 2026-08-10
+
+### 中文
+- Telegram bot 身份现在直接从标准 token 的数字前缀获得，FoxClaw 启动不再依赖远端 `getMe` 成功；断网重启时服务会保持运行，也不会因 systemd 连续重试而进入 `Start request repeated too quickly`。
+- `getMe`、命令菜单注册和消息轮询统一在后台恢复循环中执行。Telegram 恢复后会自动完成初始化并继续收发消息，无需人工重启；Telegram 可用而 Codex 上游不可用时，既有桥接错误仍会正常发回聊天。
+
+### English
+- Telegram bot identity is now derived from the numeric prefix of a standard token, so FoxClaw startup no longer depends on a successful remote `getMe` call. The service stays alive across offline restarts instead of exhausting systemd retries with `Start request repeated too quickly`.
+- `getMe`, command registration, and update polling now recover through the same background loop. Telegram automatically resumes without a manual restart, while existing bridge errors remain chat-visible when Telegram is reachable but the Codex upstream is unavailable.
+
+## 0.6.4 - 2026-08-09
+
+### 中文
+- 将 Codex 上游 `willRetry: true` 的 `responseStreamDisconnected` 识别为自动恢复中的传输事件，不再把 `Reconnecting... n/5` 写入 Telegram 最终回复或桥接错误状态。
+- WebSocket 重试耗尽后自动切换 HTTPS 的 `Falling back from WebSockets to HTTPS transport` 提示改为仅记录内部 info 日志，不再单独打扰聊天；若 HTTPS 最终仍失败且 `willRetry: false`，真实错误继续正常展示。
+
+### English
+- Treats Codex `responseStreamDisconnected` events with `willRetry: true` as in-progress transport recovery, so `Reconnecting... n/5` no longer replaces Telegram output or becomes the bridge's last error.
+- Records the automatic `Falling back from WebSockets to HTTPS transport` notice as internal info instead of a separate chat warning. A final HTTPS failure with `willRetry: false` remains user-visible.
+
 ## 0.6.3 - 2026-08-09
 
 ### 中文

package/dist/controller/controller.js

@@ -1425,6 +1425,14 @@ export class BridgeSessionCore {
         this.updateStatus();
     }
     async handleCodexErrorNotification(params) {
+        if (isRetryableCodexTransportError(params)) {
+            this.logger.info('codex.transport.retrying', {
+                message: stringOrNull(params?.error?.message),
+                threadId: stringOrNull(params?.threadId),
+                turnId: stringOrNull(params?.turnId),
+            });
+            return;
+        }
         const message = formatCodexNotificationError(params);
         this.lastError = message;
         this.logger.error('codex.notification.error', params);
@@ -1859,6 +1867,13 @@ export class BridgeSessionCore {
         await this.notifyBoundScopes(message);
     }
     async handleBridgeWarningNotification(method, params) {
+        if (isCodexTransportFallbackWarning(method, params)) {
+            this.logger.info('codex.transport.fallback', {
+                message: stringOrNull(params?.message),
+                threadId: stringOrNull(params?.threadId),
+            });
+            return;
+        }
         const threadId = stringOrNull(params?.threadId);
         const scopeId = threadId ? this.findChatByThread(threadId) : null;
         const locale = scopeId ? this.localeForChat(scopeId) : 'en';
@@ -9856,6 +9871,12 @@ function formatWarningNotification(locale, method, params) {
     }
     return `${t(locale, 'warning_title')}\n${String(params?.message ?? t(locale, 'unknown'))}`;
 }
+function isCodexTransportFallbackWarning(method, params) {
+    if (method !== 'warning') {
+        return false;
+    }
+    return /falling back from websockets? to https transport/i.test(String(params?.message ?? ''));
+}
 function normalizeThreadStatusLabel(raw) {
     if (typeof raw === 'string') {
         return raw;
@@ -10933,6 +10954,13 @@ function formatCodexNotificationError(params) {
     }
     return clipUserFacingError(cleanUserFacingError(JSON.stringify(params?.error ?? params ?? {})));
 }
+function isRetryableCodexTransportError(params) {
+    if (params?.willRetry !== true) {
+        return false;
+    }
+    const errorInfo = params?.error?.codexErrorInfo;
+    return Boolean(errorInfo && typeof errorInfo === 'object' && 'responseStreamDisconnected' in errorInfo);
+}
 function collectCodexErrorText(params) {
     const parts = [
         stringOrNull(params?.error?.message),

package/dist/telegram/gateway.d.ts

@@ -103,3 +103,4 @@ export declare class TelegramGateway extends EventEmitter {
     private handleUpdate;
     private isAllowedChat;
 }
+export declare function parseTelegramBotId(botToken: string): number | null;

package/dist/telegram/gateway.js

@@ -27,7 +27,10 @@ export class TelegramGateway extends EventEmitter {
         this.logger = logger;
         this.namespacedScopes = namespacedScopes;
         this.commandProvider = commandProvider;
-        this.botKey = `telegram:${crypto.createHash('sha256').update(this.botToken).digest('hex').slice(0, 8)}`;
+        const tokenHash = crypto.createHash('sha256').update(this.botToken).digest('hex').slice(0, 8);
+        const tokenBotId = parseTelegramBotId(this.botToken);
+        this.botUserId = tokenBotId;
+        this.botKey = tokenBotId === null ? `telegram:${tokenHash}` : `telegram:bot${tokenBotId}`;
     }
     get username() {
         return this.botUsername;
@@ -36,6 +39,8 @@ export class TelegramGateway extends EventEmitter {
         return this.botUserId === null ? null : `bot${this.botUserId}`;
     }
     async initializeIdentity() {
+        if (this.identity)
+            return this.identity;
         await this.resolveBotIdentity(true);
         return this.identity;
     }
@@ -43,10 +48,6 @@ export class TelegramGateway extends EventEmitter {
         if (this.running)
             return;
         this.running = true;
-        if (this.botUserId === null) {
-            await this.resolveBotIdentity(this.namespacedScopes);
-        }
-        await this.registerCommands();
         void this.pollLoop();
     }
     stop() {
@@ -238,8 +239,14 @@ export class TelegramGateway extends EventEmitter {
         });
     }
     async pollLoop() {
+        let remoteInitialized = false;
         while (this.running) {
             try {
+                if (!remoteInitialized) {
+                    await this.resolveBotIdentity(true);
+                    await this.registerCommands();
+                    remoteInitialized = true;
+                }
                 const offset = this.store.getTelegramOffset(this.botKey) + 1;
                 const result = await callTelegramApi(this.botToken, 'getUpdates', {
                     timeout: Math.max(1, Math.floor(this.pollIntervalMs / 1000)),
@@ -340,6 +347,13 @@ export class TelegramGateway extends EventEmitter {
 function sleep(ms) {
     return new Promise(resolve => setTimeout(resolve, ms));
 }
+export function parseTelegramBotId(botToken) {
+    const match = /^(\d+):/.exec(botToken.trim());
+    if (!match)
+        return null;
+    const botId = Number(match[1]);
+    return Number.isSafeInteger(botId) && botId > 0 ? botId : null;
+}
 function extractAttachments(message) {
     const attachments = [];
     const largestPhoto = pickLargestPhoto(message.photo ?? []);

package/package.json

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