@foxden-app/foxclaw 0.6.4 → 0.6.6

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.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
+
+### 中文
+- 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
 
 ### 中文

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);

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,17 @@ 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;
+                    this.emit('remoteReady');
+                    if (!this.running)
+                        return;
+                }
                 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 +350,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.4",
+  "version": "0.6.6",
   "description": "Foxden local execution claw for controlling Codex and OpenCode from trusted chat interfaces.",
   "type": "module",
   "main": "dist/main.js",