@foxden-app/foxclaw 0.11.1 → 0.13.0

package/.env.example

@@ -1,4 +1,5 @@
-# Required: one or more Telegram bot tokens for Codex execution.
+# Configure at least one Codex, Antigravity, or DSH Telegram bot below.
+# For DSH-only execution, leave CODEX_BOT_TOKENS empty.
 # Comma-separated bot tokens. The 1st bot shares the default terminal CODEX_HOME (~/.codex).
 # Additional bots receive independent isolated homes (~/.foxclaw/codex/telegram/@TelegramUsername/home).
 CODEX_BOT_TOKENS=<codex_telegram_bot_token>
@@ -7,6 +8,22 @@ CODEX_BOT_TOKENS=<codex_telegram_bot_token>
 # Comma-separated bot tokens. The 1st bot shares the default Antigravity home (~/.gemini/antigravity-cli).
 # Additional bots receive independent isolated homes (~/.foxclaw/antigravity/telegram/@TelegramUsername/home).
 # ANTIGRAVITY_BOT_TOKENS=<antigravity_telegram_bot_token>
+
+# Optional DeepSeek Harness backend for existing Codex/Antigravity bots.
+# After enabling it, use /backend dsh in Telegram.
+# DSH_ENABLED=true
+# DSH_SOURCE_DIR=/absolute/path/to/deepseek-harness
+# Alternatively, use an installed CLI or its .js entry point:
+# DSH_CLI_BIN=/absolute/path/to/dsh
+# Optional independent DSH bot; also enables the backend automatically.
+# DSH_BOT_TOKEN=<different_telegram_bot_token>
+# DSH_HOME=/absolute/path/to/.dsh
+# DSH_PROFILE=acp
+# DSH_PATCHES=["/absolute/path/to/patch.yml"]
+# DSH_STARTUP_TIMEOUT_MS=60000
+# Provider credentials are managed by DSH. Environment-based keys can be set here.
+# DEEPSEEK_API_KEY=
+# See docs/dsh.md for setup, permissions, and plugin management.
 
 # Required: only this Telegram user can control the bridge
 TG_ALLOWED_USER_ID=<telegram_user_id>

package/CHANGELOG.md

@@ -2,6 +2,42 @@
 
 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.13.0 - 2026-10-06
+
+### 中文
+
+- **Telegram 主任务减少刷屏**：Codex、Antigravity、DSH 统一任务使用单条进度卡；私聊优先使用可停止的临时草稿，群聊编辑同一消息。完成后显示回答并折叠执行摘要，长摘要按完整记录限长。
+- **停止操作绑定具体任务**：原生停止事件与卡片按钮验证会话、主题及任务编号，旧按钮不会误停新任务；等待后端取消完成，保留已生成内容与排队任务。
+- **任务恢复覆盖入站到交付**：增加持久收件箱、原始输入与执行配置快照、事务队列及结果交付游标。结果已知时只补发消息；执行结果未知时暂停并通过 `/recover continue|retry|cancel` 确认，避免自动重复工具操作。
+- **后端与通道边界重构**：后端定义统一注册执行器、默认设置及原生面板；执行器使用通用入站和附件契约。DSH 保留原生模型、推理档位、权限与插件入口；微信增加 `/choose` 文字菜单。
+- **资源退出与竞态修复**：统一登记共享客户端、数据库和进程锁；关闭时等待取消、交付、审批及后台操作，覆盖部分启动失败。修复 Codex 控制面重复渲染、旧任务回调污染与队列抢跑。
+- 仓库依赖安装、构建和 CI 统一使用 pnpm。上述验收范围是 Telegram 的 Codex / AGY / DSH 统一任务路径；微信存量执行路径、独立 OpenCode 和外部观察展示尚未完整迁移。
+
+### English
+
+- **Less Telegram message noise**: unified Codex, Antigravity and DSH tasks update one progress card. Private chats prefer stoppable temporary drafts; groups edit the same message. Final answers include a collapsed execution summary with bounded complete records.
+- **Task-specific stopping**: native stop events and card actions validate scope, topic and task identity. Stale actions cannot stop replacement tasks; cancellation waits for the backend and preserves partial output and queued tasks.
+- **Recovery from intake to delivery**: added a durable inbox, original input/configuration snapshots, transactional queue updates and saved delivery cursors. Known results are redelivered without rerunning tools; unknown outcomes pause for `/recover continue|retry|cancel` confirmation.
+- **Backend and channel boundaries**: registered backend definitions own execution defaults and native panels; executors consume shared inbound/attachment contracts. DSH retains native models, reasoning, permissions and plugin inspection. Weixin adds `/choose` text menus.
+- **Owned resource shutdown and race fixes**: registered clients, database and process lock are cleaned up in dependency order, waiting for cancellations, deliveries, approvals and background work. Fixed duplicate Codex rendering, stale task callbacks and queue races.
+- Dependency installation, builds and CI now use pnpm. Acceptance covers the unified Telegram Codex / AGY / DSH path; legacy Weixin execution, standalone OpenCode and external observation presentation remain outside that migration.
+
+## 0.12.0 - 2026-10-05
+
+### 中文
+
+- 新增 **DeepSeek Harness (DSH) 后端**：通过 DSH 原生 ACP profile 接入，现有 Codex/Antigravity Bot 可使用 `/backend dsh` 切换，也支持 `DSH_BOT_TOKEN` 独立运行。
+- 新增 DSH 专用 Telegram 设置面板：原生模型与推理档位、只读/工作区写入/完全访问、工具审批、持久会话列表与恢复；隐藏 Codex 多账号、认证同步和 Fast tier 控件。
+- 支持 DSH 工具进度、最终回答、图片与 JSON 文件附件、排队、中断接管和新建会话。修复中断后的队列抢跑，以及服务重启时跨 Bot 恢复会话和队列的问题。
+- 新增 `/plugins` 配置查看入口及中英文接入文档；插件安装/移除沿用 DSH 终端命令。状态页明确标注 ACP 尚未提供的逐轮 token 统计，现有统一 Bot 的 `/update` 在 DSH 模式下继续可用。
+
+### English
+
+- Added a **DeepSeek Harness (DSH) backend** using the native ACP profile. Existing Codex/Antigravity bots can switch with `/backend dsh`; a dedicated bot can run with `DSH_BOT_TOKEN`.
+- Added DSH-specific Telegram settings for native models and reasoning levels, read-only/workspace-write/full-access presets, tool approvals, and persistent session listing/resume. Codex account, auth-sync, and Fast tier controls are omitted.
+- Added tool progress, final answers, image/JSON attachments, queueing, interruption, takeover, and new sessions. Fixed queue races after interruption and cross-bot session/queue recovery on service restart.
+- Added `/plugins` configuration inspection and bilingual setup documentation; package installation/removal stays in the DSH CLI. Status explicitly marks per-turn token counts as unavailable, and unified bots retain `/update` while using DSH.
+
 ## 0.11.1 - 2026-09-30
 
 ### 中文

package/README.md

@@ -4,7 +4,7 @@
 
 **狸爪：一个更适配编程需求的移动端 Codex 控制器。**
 
-FoxClaw（狸爪）的目标很直接：让你用手机控制本机的 Codex、OpenCode 或 Antigravity (AGY)，把移动端变成一个真正能用的 web coding 入口。Telegram 或微信负责交互，`codex app-server` / `opencode serve` / `agy` 负责本地执行；你发任务、看进度、批审批、切线程，Agent 在电脑上继续写代码。
+FoxClaw（狸爪）的目标很直接：让你用手机控制本机的 Codex、OpenCode、Antigravity (AGY) 或 DeepSeek Harness (DSH)，把移动端变成一个真正能用的 web coding 入口。Telegram 或微信负责交互，各后端负责本地执行；你发任务、看进度、批审批、切线程，Agent 在电脑上继续写代码。DSH 通过 Telegram 接入，支持独立 Bot 或在现有 Bot 中切换。
 
 这适合你离开办公桌去吃饭、在旅途中、在跑步机上，或者陪小孩逛公园的时候继续工作。人可以离开电脑，Codex 不必停；它会把关键进展、错误、审批请求和最终结果同步回手机。
 
@@ -38,12 +38,13 @@ FoxClaw（狸爪）的目标很直接：让你用手机控制本机的 Codex、O
 - 对 Node、Telegram 机器人、Codex CLI 不太熟？看 [新手安装指南](./docs/zh/install-for-beginners.md)。
 - 已经装好，想系统了解 `/help`、`/setup`、`/threads`、`/watch`、`/auth` 和账号轮转？看 [用户手册](./docs/zh/user-manual.md)。
 - 想把同一组合法 ChatGPT auth 候选同步到多台机器？看 [跨节点 auth 同步配置指南](./docs/zh/cross-node-auth-sync.md)。
+- 想接入 DeepSeek Harness，切换模型、推理档位、权限或查看插件配置？看 [DSH 后端配置](./docs/zh/dsh.md)。
 - 想了解每个版本改了什么？看 [更新日志](./CHANGELOG.md)。
 - 维护者准备发版？看 [发布 runbook](./docs/zh/release.md)。
 - Git、Node、`.env` 都玩得转？直接往下看快速设置。
 - 卡住了？看 [故障排查](./docs/zh/troubleshooting.md)。
 
-最低要求：一个或多个 Telegram bot token、你的 Telegram 数字用户 ID、Node.js 24+、一份已登录的 `codex` CLI。首次安装大约 10–20 分钟。新安装请使用 `TG_BOT_TOKENS`；`TG_BOT_TOKEN` 兼容旧的单 runtime 配置，也可在多 bot 模式中标记一个“默认/终端共享”bot。
+最低要求：一个或多个 Telegram bot token、你的 Telegram 数字用户 ID、Node.js 24+，以及已配置的执行后端。Codex 使用 `CODEX_BOT_TOKENS`；DSH 独立运行使用 `DSH_BOT_TOKEN`，无需安装或登录 Codex。首次安装大约 10–20 分钟。
 
 **30 秒体验**：启动 FoxClaw 后，给你的 Telegram 机器人发一句 `List files in DEFAULT_CWD`。Codex 会在本地检查那个目录，然后把结果发回 Telegram。
 
@@ -79,7 +80,7 @@ foxclaw start
 跑 `doctor` 或 `start` 之前先把 `.env` 填好。私聊模式最小配置：
 
 ```dotenv
-TG_BOT_TOKENS=123456:telegram-token
+CODEX_BOT_TOKENS=123456:telegram-token
 TG_ALLOWED_USER_ID=123456789
 DEFAULT_CWD=/absolute/path/to/workspace
 DEFAULT_APPROVAL_POLICY=on-request

package/README_EN.md

@@ -4,7 +4,7 @@
 
 **A mobile Codex controller built for real programming workflows.**
 
-FoxClaw turns your phone into a practical web coding cockpit for local Codex, OpenCode, or Antigravity (AGY). Telegram or Weixin handles the chat interface, `codex app-server` / `opencode serve` / `agy` handles local execution, and you can send tasks, inspect progress, approve actions, switch sessions, and keep working without opening a laptop.
+FoxClaw turns your phone into a practical web coding cockpit for local Codex, OpenCode, Antigravity (AGY), or DeepSeek Harness (DSH). Telegram or Weixin handles the chat interface, each backend handles local execution, and you can send tasks, inspect progress, approve actions, switch sessions, and keep working without opening a laptop. DSH connects through Telegram, using a dedicated bot or backend switching in an existing bot.
 
 It is built for the moments when you leave your desk for lunch, commute, travel, use a treadmill, or take the kids to the park. You can step away from the keyboard while Codex keeps coding and sends progress, errors, approval requests, and final results back to your phone.
 
@@ -38,12 +38,13 @@ FoxClaw is more than message forwarding. It provides Telegram panels for Codex w
 - New to Node, Telegram bots, or Codex CLI? Use the [Beginner Install Guide](./docs/install-for-beginners.md).
 - Already installed and want the full command guide for `/help`, `/setup`, `/threads`, `/watch`, `/auth`, and auth rotation? Read the [User Manual](./docs/user-manual.md).
 - Want to sync the same legally owned ChatGPT auth candidate pool across multiple machines? Read the [Cross-Node Auth Sync Setup Guide](./docs/cross-node-auth-sync.md).
+- Want DeepSeek Harness with native models, reasoning, permissions, and plugin configuration? Read [DSH Backend Setup](./docs/dsh.md).
 - Want to see what changed in each release? Read the [Changelog](./CHANGELOG.md).
 - Maintaining a release? Use the [Release Runbook](./docs/release.md).
 - Already comfortable with Git, Node, and `.env` files? Use the quick setup below.
 - Something failed? Check [Troubleshooting](./docs/troubleshooting.md).
 
-The minimum install needs one or more Telegram bot tokens, your numeric Telegram user id, Node.js 24+, and a logged-in `codex` CLI. A first install usually takes 10–20 minutes. New installs should use `TG_BOT_TOKENS`; `TG_BOT_TOKEN` remains compatible with legacy single-runtime setups and can mark one multi-bot runtime as default/shared-terminal.
+The minimum install needs one or more Telegram bot tokens, your numeric Telegram user id, Node.js 24+, and a configured execution backend. Codex uses `CODEX_BOT_TOKENS`; standalone DSH uses `DSH_BOT_TOKEN` and does not require Codex installation or login. A first install usually takes 10–20 minutes.
 
 **30-second demo**: after FoxClaw is running, send `List files in DEFAULT_CWD` to your Telegram bot. FoxClaw asks local Codex to inspect that folder on your computer and sends the answer back to Telegram.
 
@@ -79,7 +80,7 @@ foxclaw start
 Fill `.env` before running `doctor` or `start`. Minimum private-chat config:
 
 ```dotenv
-TG_BOT_TOKENS=123456:telegram-token
+CODEX_BOT_TOKENS=123456:telegram-token
 TG_ALLOWED_USER_ID=123456789
 DEFAULT_CWD=/absolute/path/to/workspace
 DEFAULT_APPROVAL_POLICY=on-request

package/dist/antigravity/account_ui.d.ts

@@ -0,0 +1,34 @@
+import type { AppLocale } from '../types.js';
+import { type AntigravityAccount } from './auth.js';
+import type { AppConfig } from '../config.js';
+import type { BridgeStore } from '../store/database.js';
+import type { Logger } from '../logger.js';
+import type { BackendUiHost } from '../core/backend_ui.js';
+import type { IEngineAdapter } from '../core/engine_spi.js';
+import type { AntigravityAuthManager } from './auth.js';
+interface PanelUi {
+    sendMessage: BackendUiHost['sendMessage'];
+    editMessage: BackendUiHost['editMessage'];
+    scheduleStalePanelDeletion: BackendUiHost['scheduleStalePanelDeletion'];
+}
+interface ExecutionView {
+    syncCurrentBackendSettings(scopeId: string): void;
+    hasActiveTurn(scopeId: string): boolean;
+    getAdapterForScope(scopeId: string): IEngineAdapter;
+}
+export declare function formatCandidateButtonPrefix(c: AntigravityAccount): string;
+export declare function formatCandidateDisplayName(c: AntigravityAccount): string;
+export declare function formatAccountExpiry(expiryMs: number | null, locale: AppLocale, isActive?: boolean): string;
+export declare class AntigravityAccountUi {
+    private readonly config;
+    private readonly store;
+    private readonly logger;
+    private readonly auth;
+    private readonly ui;
+    private readonly orchestrator;
+    constructor(config: AppConfig, store: BridgeStore, logger: Logger, auth: AntigravityAuthManager, ui: PanelUi, orchestrator: ExecutionView);
+    sendAuthMenu(scopeId: string, args: string, locale: AppLocale, editMessageId?: number): Promise<void>;
+    startLoginFlow(scopeId: string, locale: AppLocale, editMessageId?: number): Promise<void>;
+    sendEffortMenu(scopeId: string, arg: string, locale: AppLocale, editMessageId?: number): Promise<void>;
+}
+export {};

package/dist/antigravity/account_ui.js

@@ -0,0 +1,354 @@
+import { AGY_AUTH_CALLBACK_PREFIX, AGY_EFFORT_CALLBACK_PREFIX } from './ui_callbacks.js';
+import { formatQuotaResetTime } from './auth.js';
+export function formatCandidateButtonPrefix(c) {
+    const p5h = typeof c.quota?.fiveHourPercent === 'number' ? `${c.quota.fiveHourPercent}%` : '—';
+    const pw = typeof c.quota?.weeklyPercent === 'number' ? `${c.quota.weeklyPercent}%` : '—';
+    return `${p5h}|${pw}`;
+}
+export function formatCandidateDisplayName(c) {
+    if (c.email) {
+        return c.email.replace(/@gmail\.com$/i, '');
+    }
+    return c.name.replace(/^antigravity-oauth-token_/, '');
+}
+export function formatAccountExpiry(expiryMs, locale, isActive = false) {
+    if (!expiryMs)
+        return locale === 'zh' ? '未知' : 'unknown';
+    const now = Date.now();
+    if (expiryMs <= now) {
+        if (isActive) {
+            return locale === 'zh' ? '待命中 (发任务时即时刷新)' : 'standby (refreshes on task)';
+        }
+        return locale === 'zh' ? '待命中 (就绪 · 切号时即时激活)' : 'standby (ready · refreshes on switch)';
+    }
+    const remainingMins = Math.round((expiryMs - now) / 60000);
+    const timeStr = new Date(expiryMs).toTimeString().slice(0, 5);
+    return locale === 'zh'
+        ? `${timeStr} (剩 ${remainingMins} 分钟)`
+        : `${timeStr} (${remainingMins}m left)`;
+}
+export class AntigravityAccountUi {
+    config;
+    store;
+    logger;
+    auth;
+    ui;
+    orchestrator;
+    constructor(config, store, logger, auth, ui, orchestrator) {
+        this.config = config;
+        this.store = store;
+        this.logger = logger;
+        this.auth = auth;
+        this.ui = ui;
+        this.orchestrator = orchestrator;
+    }
+    async sendAuthMenu(scopeId, args, locale, editMessageId) {
+        const trimmedArgs = (args || '').trim();
+        let currentFilter = 'all';
+        if (trimmedArgs.startsWith('filter:')) {
+            const f = trimmedArgs.slice('filter:'.length).toLowerCase();
+            if (f === 'enabled' || f === 'attention' || f === 'all') {
+                currentFilter = f;
+            }
+        }
+        else if (trimmedArgs) {
+            if (trimmedArgs.startsWith('pause ')) {
+                const target = trimmedArgs.slice('pause '.length).trim();
+                this.auth.pauseAccount(target);
+                await this.ui.sendMessage(scopeId, locale === 'zh' ? `⏸ 账号 \`${target}\` 已暂停使用。` : `⏸ Account \`${target}\` paused.`);
+                return;
+            }
+            if (trimmedArgs.startsWith('resume ')) {
+                const target = trimmedArgs.slice('resume '.length).trim();
+                this.auth.resumeAccount(target);
+                await this.ui.sendMessage(scopeId, locale === 'zh' ? `▶️ 账号 \`${target}\` 已恢复启用。` : `▶️ Account \`${target}\` resumed.`);
+                return;
+            }
+            if (trimmedArgs === 'repair_all' || trimmedArgs === 'repair all') {
+                const res = await this.auth.diagnoseAndRepairAll();
+                await this.ui.sendMessage(scopeId, locale === 'zh'
+                    ? `🩺 **账号池体检与修复结果**\n\n• 总账号数: ${res.total}\n• 正常/已修复: ${res.healthy + res.repaired}\n• 需关注/失败: ${res.failed}\n\n${res.summary.join('\n')}`
+                    : `🩺 **Account Diagnostics & Repair**\n\n• Total: ${res.total}\n• Healthy/Repaired: ${res.healthy + res.repaired}\n• Failed: ${res.failed}\n\n${res.summary.join('\n')}`);
+                return;
+            }
+            if (trimmedArgs.startsWith('repair ') || trimmedArgs === 'repair') {
+                const target = trimmedArgs === 'repair' ? 'active' : trimmedArgs.slice('repair '.length).trim();
+                const res = await this.auth.diagnoseAndRepairAccount(target);
+                await this.ui.sendMessage(scopeId, res.ok
+                    ? (locale === 'zh' ? `🩺 账号 \`${res.email || res.accountName}\` 检查修复成功：${res.message}` : `🩺 Account \`${res.email || res.accountName}\` repaired: ${res.message}`)
+                    : (locale === 'zh' ? `❌ 检查修复失败：${res.message}` : `❌ Repair failed: ${res.message}`));
+                return;
+            }
+            if (trimmedArgs === 'rotate') {
+                try {
+                    const res = await this.auth.rotateNextCandidate();
+                    await this.ui.sendMessage(scopeId, locale === 'zh'
+                        ? `🔄 已成功轮转到下一个账号: \`${res.account.email ?? res.account.name}\``
+                        : `🔄 Successfully rotated to next account: \`${res.account.email ?? res.account.name}\``);
+                }
+                catch (err) {
+                    await this.ui.sendMessage(scopeId, `❌ ${err instanceof Error ? err.message : String(err)}`);
+                }
+                return;
+            }
+            if (trimmedArgs === 'refresh') {
+                const active = await this.auth.getActiveAccount();
+                if (!active) {
+                    await this.ui.sendMessage(scopeId, locale === 'zh' ? '❌ 当前无活跃账号。' : '❌ No active account.');
+                    return;
+                }
+                const res = await this.auth.refreshTokenForAccount(active.name);
+                if (res.success) {
+                    await this.ui.sendMessage(scopeId, locale === 'zh'
+                        ? `⚡ 账号 \`${active.email || active.name}\` Token 刷新成功！`
+                        : `⚡ Account \`${active.email || active.name}\` refreshed successfully!`);
+                }
+                else {
+                    await this.ui.sendMessage(scopeId, `❌ 刷新失败: ${res.error}`);
+                }
+                return;
+            }
+            if (trimmedArgs === 'refresh all' || trimmedArgs === 'refresh_all') {
+                const res = await this.auth.refreshAllTokens();
+                await this.auth.populateQuotas(await this.auth.listCandidates(false), true);
+                await this.ui.sendMessage(scopeId, locale === 'zh'
+                    ? `⚡ 全部 Token 与额度已刷新完成: 成功 ${res.refreshed} / 共 ${res.total} 个${res.failed > 0 ? ` (失败 ${res.failed})` : ''}`
+                    : `⚡ All tokens and quotas refreshed: ${res.refreshed} / ${res.total} succeeded`);
+                return;
+            }
+            if (trimmedArgs.startsWith('add ') || trimmedArgs.startsWith('{')) {
+                const jsonContent = trimmedArgs.startsWith('add ') ? trimmedArgs.slice('add '.length).trim() : trimmedArgs;
+                const res = await this.auth.importAccountFromJson(jsonContent);
+                if (res.success && res.account) {
+                    const candidates = await this.auth.listCandidates();
+                    await this.ui.sendMessage(scopeId, locale === 'zh'
+                        ? `🎉 **Antigravity 账号导入成功！**\n• 账号名称: \`${res.account.name}\`\n• 绑定邮箱: \`${res.account.email || '未知'}\`\n• 候选池总数: 共 ${candidates.length} 个账号`
+                        : `🎉 **Account Imported!**\n• Name: \`${res.account.name}\`\n• Email: \`${res.account.email || 'unknown'}\`\n• Pool: ${candidates.length} accounts`);
+                }
+                else {
+                    await this.ui.sendMessage(scopeId, `❌ 导入失败: ${res.error || '未知错误'}`);
+                }
+                return;
+            }
+            // Direct switch
+            try {
+                const res = await this.auth.switchAccount(trimmedArgs);
+                await this.ui.sendMessage(scopeId, locale === 'zh'
+                    ? `✅ 已成功切换到账号: \`${res.account.email ?? res.account.name}\``
+                    : `✅ Successfully switched to account: \`${res.account.email ?? res.account.name}\``);
+                return;
+            }
+            catch (err) {
+                await this.ui.sendMessage(scopeId, `❌ ${err instanceof Error ? err.message : String(err)}`);
+                return;
+            }
+        }
+        const candidates = await this.auth.listCandidates(true);
+        const active = candidates.find((c) => c.isActive) || candidates[0];
+        const filtered = candidates.filter((c) => {
+            if (currentFilter === 'enabled') {
+                return !c.isPaused && !c.isCooldown && c.hasRefreshToken;
+            }
+            if (currentFilter === 'attention') {
+                return c.isPaused || c.isCooldown || !c.hasRefreshToken;
+            }
+            return true;
+        });
+        const keyboard = [];
+        for (const c of filtered) {
+            const prefix = formatCandidateButtonPrefix(c);
+            let icon = '🔐 ';
+            if (c.isPaused) {
+                icon = '⏸ ';
+            }
+            else if (c.isActive) {
+                icon = '🟢 ';
+            }
+            else if (c.isCooldown) {
+                icon = '⏳ ';
+            }
+            const label = `${icon}${prefix}|${formatCandidateDisplayName(c)}${c.isPaused ? ' · off' : ''}`;
+            let rightBtnText = '⏸';
+            let rightBtnAction = `${AGY_AUTH_CALLBACK_PREFIX}toggle_pause:${c.name}`;
+            if (!c.hasRefreshToken || c.isCooldown) {
+                rightBtnText = '🩺';
+                rightBtnAction = `${AGY_AUTH_CALLBACK_PREFIX}repair:${c.name}`;
+            }
+            else if (c.isPaused) {
+                rightBtnText = '▶️';
+                rightBtnAction = `${AGY_AUTH_CALLBACK_PREFIX}toggle_pause:${c.name}`;
+            }
+            else if (c.isActive) {
+                rightBtnText = '✅';
+                rightBtnAction = `${AGY_AUTH_CALLBACK_PREFIX}toggle_pause:${c.name}`;
+            }
+            keyboard.push([
+                {
+                    text: label.length > 28 ? `${label.slice(0, 27)}…` : label,
+                    callback_data: `${AGY_AUTH_CALLBACK_PREFIX}switch:${c.name}`,
+                },
+                {
+                    text: rightBtnText,
+                    callback_data: rightBtnAction,
+                },
+            ]);
+        }
+        // Filter tab row matching Codex
+        keyboard.push([
+            {
+                text: currentFilter === 'all' ? '☑️ 全部' : '全部',
+                callback_data: `${AGY_AUTH_CALLBACK_PREFIX}filter:all`,
+            },
+            {
+                text: currentFilter === 'enabled' ? '☑️ 已启用' : '已启用',
+                callback_data: `${AGY_AUTH_CALLBACK_PREFIX}filter:enabled`,
+            },
+            {
+                text: currentFilter === 'attention' ? '☑️ 需关注' : '需关注',
+                callback_data: `${AGY_AUTH_CALLBACK_PREFIX}filter:attention`,
+            },
+        ]);
+        keyboard.push([
+            { text: '🔑 设备登录', callback_data: `${AGY_AUTH_CALLBACK_PREFIX}login` },
+            { text: '🩺 账号体检与修复', callback_data: `${AGY_AUTH_CALLBACK_PREFIX}repair_all` },
+        ]);
+        keyboard.push([
+            { text: '🔄 轮转切号', callback_data: `${AGY_AUTH_CALLBACK_PREFIX}rotate` },
+            { text: '⚡ 刷新额度与Token', callback_data: `${AGY_AUTH_CALLBACK_PREFIX}refresh_all` },
+        ]);
+        keyboard.push([
+            { text: '📥 账号导入指南', callback_data: `${AGY_AUTH_CALLBACK_PREFIX}import_help` },
+            { text: '◀️ 返回控制面板', callback_data: 'engine:setup:main' },
+        ]);
+        const activeExpiry = formatAccountExpiry(active?.expiry ?? null, locale, true);
+        const activeLabel = active ? `${active.email || active.name}` : locale === 'zh' ? '无' : 'None';
+        let quotaDetails = '';
+        if (active?.quota) {
+            const q = active.quota;
+            const p5h = typeof q.fiveHourPercent === 'number' ? `${q.fiveHourPercent}%` : '未知';
+            const pw = typeof q.weeklyPercent === 'number' ? `${q.weeklyPercent}%` : '未知';
+            const r5h = q.resetTime5h ? formatQuotaResetTime(q.resetTime5h) : '—';
+            const rw = q.resetTimeWeekly ? formatQuotaResetTime(q.resetTimeWeekly) : '—';
+            quotaDetails =
+                locale === 'zh'
+                    ? `\n• **Gemini 5h 额度**: \`${p5h}\` (重置于 ${r5h})` +
+                        `\n• **Gemini 7d 额度**: \`${pw}\` (重置于 ${rw})`
+                    : `\n• **Gemini 5h Quota**: \`${p5h}\` (resets ${r5h})` +
+                        `\n• **Gemini 7d Quota**: \`${pw}\` (resets ${rw})`;
+            if (typeof q.thirdPartyWeeklyPercent === 'number') {
+                const p3pw = `${q.thirdPartyWeeklyPercent}%`;
+                const r3pw = q.resetTimeWeekly ? formatQuotaResetTime(q.resetTimeWeekly) : '—';
+                quotaDetails +=
+                    locale === 'zh'
+                        ? `\n• **3P (Claude/GPT)**: \`${p3pw}\` (重置于 ${r3pw})`
+                        : `\n• **3P (Claude/GPT)**: \`${p3pw}\` (resets ${r3pw})`;
+            }
+        }
+        else {
+            quotaDetails =
+                locale === 'zh'
+                    ? `\n• **5h/7d 额度**: \`未获取到\` (点击【⚡ 刷新额度与Token】实时获取)`
+                    : `\n• **5h/7d Quota**: \`Not available\` (tap [⚡ Refresh Quota & Token])`;
+        }
+        const text = locale === 'zh'
+            ? `👤 **Antigravity 账号管理池**\n\n` +
+                `• **当前活跃账号**: \`${activeLabel}\`\n` +
+                `• **活跃 Token 状态**: ${activeExpiry}` +
+                quotaDetails +
+                `\n• **账号池总数**: 共 ${candidates.length} 个账号\n` +
+                `• **按键前缀说明**: \`5h剩余% | 7d剩余% | 账号别名\` (数值为剩余额度百分比，非时间)\n\n` +
+                `点击下方账号名称可即时无缝热切换；点击【🔑 设备登录】可在 Telegram 内直接授权绑定新账号。`
+            : `👤 **Antigravity Account Pool**\n\n` +
+                `• **Active**: \`${activeLabel}\`\n` +
+                `• **Status**: ${activeExpiry}` +
+                quotaDetails +
+                `\n• **Pool Size**: ${candidates.length} accounts\n` +
+                `• **Prefix Meaning**: \`5h% | 7d% | account\` (values represent remaining quota %, not time)\n\n` +
+                `Tap candidate below to switch seamlessly. Tap [🔑 Device Login] to sign in.`;
+        if (editMessageId) {
+            await this.ui.editMessage(scopeId, editMessageId, text, keyboard);
+            this.ui.scheduleStalePanelDeletion(scopeId, editMessageId);
+        }
+        else {
+            const msgId = await this.ui.sendMessage(scopeId, text, keyboard);
+            this.ui.scheduleStalePanelDeletion(scopeId, msgId);
+        }
+    }
+    async startLoginFlow(scopeId, locale, editMessageId) {
+        const session = this.auth.startBrowserLogin(scopeId);
+        const keyboard = [
+            [{ text: '❌ 取消登录会话', callback_data: `${AGY_AUTH_CALLBACK_PREFIX}cancel_login` }],
+            [{ text: '◀️ 返回账号列表', callback_data: `${AGY_AUTH_CALLBACK_PREFIX}filter:all` }],
+        ];
+        const text = locale === 'zh'
+            ? `🔑 **Google / Antigravity 设备授权登录**\n\n` +
+                `1️⃣ **点击授权链接**（在浏览器中打开）：\n` +
+                `[👉 点击打开 Google 授权登录页面](${session.authUrl})\n\n` +
+                `2️⃣ 在浏览器中完成账号选择与权限授予；\n` +
+                `3️⃣ 授权完成后，浏览器页面可能提示复制授权码（Authorization Code），或重定向至空白页；\n` +
+                `4️⃣ 直接将**授权码**或**重定向完整 URL**复制并作为消息发送给本机器人即可！\n\n` +
+                `*临时会话有效期 10 分钟。随时发送 \`/auth cancel\` 可取消。*`
+            : `🔑 **Google / Antigravity OAuth Login**\n\n` +
+                `1️⃣ **Click authorization link**:\n` +
+                `[👉 Open Google Authorization](${session.authUrl})\n\n` +
+                `2️⃣ Approve requested permissions;\n` +
+                `3️⃣ Paste the authorization code or redirect URL back into this chat!\n\n` +
+                `*Valid for 10 minutes. Send /auth cancel to abort.*`;
+        if (editMessageId) {
+            await this.ui.editMessage(scopeId, editMessageId, text, keyboard);
+        }
+        else {
+            await this.ui.sendMessage(scopeId, text, keyboard);
+        }
+    }
+    async sendEffortMenu(scopeId, arg, locale, editMessageId) {
+        const settings = this.store.getChatSettings(scopeId);
+        const isBoost = settings?.serviceTier === 'boost';
+        if (arg) {
+            const target = arg.toLowerCase();
+            if (target === 'low' || target === 'medium' || target === 'high') {
+                if (target !== 'high' && isBoost) {
+                    this.store.setChatServiceTier(scopeId, null);
+                }
+                this.store.setChatEffort(scopeId, target);
+                this.orchestrator.syncCurrentBackendSettings(scopeId);
+                await this.ui.sendMessage(scopeId, locale === 'zh' ? `✅ 思考深度已切换为: \`${target}\`` : `✅ Effort switched to: \`${target}\``);
+                return;
+            }
+        }
+        const current = isBoost ? 'high' : (settings?.reasoningEffort ?? 'high');
+        const keyboard = [
+            [
+                {
+                    text: `${current === 'low' ? '✅ ' : ''}Low (快速)`,
+                    callback_data: `${AGY_EFFORT_CALLBACK_PREFIX}low`,
+                },
+                {
+                    text: `${current === 'medium' ? '✅ ' : ''}Medium (平衡)`,
+                    callback_data: `${AGY_EFFORT_CALLBACK_PREFIX}medium`,
+                },
+                {
+                    text: `${current === 'high' ? '✅ ' : ''}High (深度思考)`,
+                    callback_data: `${AGY_EFFORT_CALLBACK_PREFIX}high`,
+                },
+            ],
+            [{ text: '◀️ 返回控制面板', callback_data: 'engine:setup:main' }],
+        ];
+        const boostHint = isBoost
+            ? locale === 'zh'
+                ? '\n\n*(当前处于 Boost 模式，深度锁定为 High)*'
+                : '\n\n*(Locked to High in Boost Mode)*'
+            : '';
+        const text = locale === 'zh'
+            ? `⚡ **选择思考深度 (Reasoning Effort)**\n当前深度: \`${current}\`${boostHint}`
+            : `⚡ **Select Reasoning Effort**\nCurrent: \`${current}\`${boostHint}`;
+        if (editMessageId) {
+            await this.ui.editMessage(scopeId, editMessageId, text, keyboard);
+            this.ui.scheduleStalePanelDeletion(scopeId, editMessageId);
+        }
+        else {
+            const msgId = await this.ui.sendMessage(scopeId, text, keyboard);
+            this.ui.scheduleStalePanelDeletion(scopeId, msgId);
+        }
+    }
+}

package/dist/antigravity/adapter.js

@@ -2,7 +2,7 @@ import { EventEmitter } from 'node:events';
 import path from 'node:path';
 import { normalizeAgyModelId } from './client.js';
 import { isCapacityOrUnavailableError, isVerificationError, isQuotaOrAuthError, isTransientNetworkError, } from './events.js';
-import { buildAttachmentPrompt } from '../telegram/media.js';
+import { buildAttachmentPrompt } from '../core/attachment_files.js';
 import { AntigravitySubagentTracker } from './subagents.js';
 function extractToolSummary(name, parameters) {
     if (!parameters)

package/dist/antigravity/auth.d.ts

@@ -62,6 +62,9 @@ export declare class AntigravityAuthManager {
     private readonly quotaCache;
     private readonly pausedAccounts;
     private keepAliveTimer;
+    private keepAliveWork;
+    private keepAliveCheck;
+    private keepAliveInitialTimer;
     constructor(authDir?: string, logger?: Logger, fetchFn?: typeof fetch);
     startBrowserLogin(scopeId: string): {
         authUrl: string;
@@ -112,7 +115,7 @@ export declare class AntigravityAuthManager {
     ensureActiveTokenFresh(thresholdSec?: number): Promise<boolean>;
     importAccountFromJson(rawJson: string, preferredName?: string): Promise<ImportAccountResult>;
     startKeepAlive(intervalMs?: number): void;
-    stopKeepAlive(): void;
+    stopKeepAlive(): Promise<void>;
     runKeepAliveCheck(): Promise<void>;
     private parseAccountFile;
     private readActiveTokenContent;

package/dist/antigravity/auth.js

@@ -80,6 +80,11 @@ export class AntigravityAuthManager {
     quotaCache = new Map();
     pausedAccounts = new Set();
     keepAliveTimer;
+    keepAliveWork = null;
+    keepAliveCheck() {
+        return this.keepAliveWork ??= this.runKeepAliveCheck().finally(() => { this.keepAliveWork = null; });
+    }
+    keepAliveInitialTimer;
     constructor(authDir, logger, fetchFn = fetch) {
         this.authDir = authDir || path.join(os.homedir(), '.gemini', 'antigravity-cli');
         this.activeTokenPath = path.join(this.authDir, 'antigravity-oauth-token');
@@ -816,21 +821,28 @@ export class AntigravityAuthManager {
         if (this.keepAliveTimer)
             clearInterval(this.keepAliveTimer);
         this.keepAliveTimer = setInterval(() => {
-            this.runKeepAliveCheck().catch((err) => {
+            this.keepAliveCheck().catch((err) => {
                 this.logger?.warn('antigravity.auth.keepalive_error', { error: String(err) });
             });
         }, intervalMs);
         this.keepAliveTimer?.unref?.();
-        const initialTimer = setTimeout(() => {
-            this.runKeepAliveCheck().catch(() => { });
+        if (this.keepAliveInitialTimer)
+            clearTimeout(this.keepAliveInitialTimer);
+        this.keepAliveInitialTimer = setTimeout(() => {
+            this.keepAliveInitialTimer = undefined;
+            this.keepAliveCheck().catch(() => { });
         }, 3000);
-        initialTimer?.unref?.();
+        this.keepAliveInitialTimer?.unref?.();
     }
-    stopKeepAlive() {
+    async stopKeepAlive() {
+        if (this.keepAliveInitialTimer)
+            clearTimeout(this.keepAliveInitialTimer);
+        this.keepAliveInitialTimer = undefined;
         if (this.keepAliveTimer) {
             clearInterval(this.keepAliveTimer);
             this.keepAliveTimer = undefined;
         }
+        await this.keepAliveWork?.catch(() => { });
     }
     async runKeepAliveCheck() {
         // Only refresh the active account to keep the active session warm without spamming Google OAuth