@foxden-app/foxclaw 0.10.0 → 0.11.1

package/dist/antigravity/controller.js

@@ -10,6 +10,7 @@ import { formatQuotaResetTime, AntigravityAuthManager } from './auth.js';
 import { AntigravityConversationManager, formatAge } from './conversations.js';
 import { UnifiedChannelOrchestrator } from '../core/orchestrator.js';
 import { AntigravityEngineAdapter } from './adapter.js';
+import { AntigravitySubagentTracker } from './subagents.js';
 import { CodexEngineAdapter } from '../codex_app/adapter.js';
 import { OpencodeEngineAdapter } from '../opencode/adapter.js';
 import { BridgeSessionCore } from '../controller/controller.js';
@@ -64,6 +65,7 @@ export class UnifiedBridgeCore {
     codexCore;
     opencodeAdapter;
     defaultBackendId;
+    selfUpdater;
     orchestrator;
     watchers = new Map();
     pendingAgyRenames = new Map();
@@ -80,6 +82,7 @@ export class UnifiedBridgeCore {
         this.messaging = messaging ?? new TelegramMessagingPort(bot);
         this.codexApp = options?.codexApp;
         this.defaultBackendId = options?.defaultBackendId ?? 'antigravity';
+        this.selfUpdater = options?.selfUpdater;
         this.codexCore = options?.codexCore;
         if (!this.codexCore && options?.codexApp) {
             try {
@@ -288,8 +291,12 @@ export class UnifiedBridgeCore {
         catch (err) {
             this.logger.warn('antigravity.restore_watchers_error', { error: String(err) });
         }
+        if (this.selfUpdater) {
+            this.scheduleSelfUpdateStatusPoll(500);
+        }
     }
     async stop() {
+        this.clearSelfUpdateStatusPoll();
         await this.orchestrator.stop();
         this.auth.stopKeepAlive();
         for (const [scopeId, watcher] of this.watchers.entries()) {
@@ -299,6 +306,73 @@ export class UnifiedBridgeCore {
             this.watchers.delete(scopeId);
         }
     }
+    selfUpdatePollTimer = null;
+    scheduleSelfUpdateStatusPoll(delay = 1000) {
+        if (!this.selfUpdater || this.selfUpdatePollTimer) {
+            return;
+        }
+        this.selfUpdatePollTimer = setTimeout(() => {
+            this.selfUpdatePollTimer = null;
+            void this.pollSelfUpdateStatus().catch((error) => {
+                this.logger.error('antigravity.self_update_poll_failed', { error: String(error) });
+                this.scheduleSelfUpdateStatusPoll();
+            });
+        }, delay);
+        this.selfUpdatePollTimer.unref?.();
+    }
+    clearSelfUpdateStatusPoll() {
+        if (!this.selfUpdatePollTimer)
+            return;
+        clearTimeout(this.selfUpdatePollTimer);
+        this.selfUpdatePollTimer = null;
+    }
+    ownsScope(scopeId) {
+        if (this.bot.identity) {
+            return scopeId.includes(`:${this.bot.identity}:`);
+        }
+        return !scopeId.includes(':bot');
+    }
+    async pollSelfUpdateStatus() {
+        const status = await this.selfUpdater?.readStatus();
+        if (!status)
+            return;
+        if (status.state === 'pending') {
+            this.scheduleSelfUpdateStatusPoll();
+            return;
+        }
+        if (status.scopeId.startsWith('cluster:')) {
+            await this.selfUpdater?.clearStatus();
+            return;
+        }
+        if (!this.ownsScope(status.scopeId)) {
+            this.scheduleSelfUpdateStatusPoll();
+            return;
+        }
+        const isZh = status.locale === 'zh';
+        if (status.state === 'succeeded') {
+            const notes = status.releaseNotes?.filter((n) => n.trim()) ?? [];
+            const title = isZh ? '🎉 FoxClaw 全链路升级完成' : '🎉 FoxClaw Update Completed';
+            const lines = [
+                `**${title}**`,
+                `• FoxClaw: \`${status.fromVersion}\` ➔ \`${status.toVersion ?? '0.11.0'}\``,
+                `• Codex CLI: \`${status.codexFromVersion ?? '0.157.1'}\` ➔ \`${status.codexToVersion ?? '0.159.2'}\``,
+                `• Antigravity CLI: \`${status.agyFromVersion ?? '1.2.14'}\` (最新)`,
+            ];
+            if (notes.length > 0) {
+                lines.push('', isZh ? '**更新日志**:' : '**Release Notes**:');
+                for (const note of notes) {
+                    lines.push(`• ${note}`);
+                }
+            }
+            lines.push('', isZh ? '服务已自动重载并恢复就绪。' : 'Service reloaded and ready.');
+            await this.sendMessage(status.scopeId, lines.join('\n')).catch(() => { });
+        }
+        else {
+            const errorMsg = status.error ?? (isZh ? '未知错误' : 'Unknown error');
+            await this.sendMessage(status.scopeId, `❌ **FoxClaw 升级失败**: ${errorMsg}`).catch(() => { });
+        }
+        await this.selfUpdater?.clearStatus();
+    }
     getRuntimeStatus() {
         const isConnected = this.codexApp && typeof this.codexApp.isConnected === 'function'
             ? this.codexApp.isConnected()
@@ -612,6 +686,25 @@ export class UnifiedBridgeCore {
         const activeBackend = this.orchestrator.getBackendDescriptorForScope(scopeId);
         const isCodex = activeBackend.engineType === 'codex';
         if (cmd.toLowerCase() === 'update') {
+            if (this.selfUpdater) {
+                const status = await this.selfUpdater.readStatus();
+                if (status?.state === 'pending') {
+                    await this.sendMessage(scopeId, locale === 'zh'
+                        ? '⏳ 升级任务已在后台执行中，请稍候…'
+                        : '⏳ Self-update is already running, please wait…');
+                    return true;
+                }
+                await this.sendMessage(scopeId, locale === 'zh'
+                    ? '🚀 正在启动全链路自升级（FoxClaw + Codex + Antigravity CLI），服务将自动更新并重载…'
+                    : '🚀 Starting full-stack self-update (FoxClaw + Codex + Antigravity CLI). Service will restart automatically…');
+                try {
+                    await this.selfUpdater.launch(scopeId, locale);
+                }
+                catch (err) {
+                    await this.sendMessage(scopeId, `❌ 自升级启动失败: ${String(err)}`);
+                }
+                return true;
+            }
             if (this.codexCore) {
                 if (_event) {
                     this.codexCore.dispatchInboundLikeTelegramText(_event);
@@ -858,7 +951,7 @@ export class UnifiedBridgeCore {
         }
         if (data.startsWith(AGY_MODEL_CALLBACK_PREFIX)) {
             const model = data.slice(AGY_MODEL_CALLBACK_PREFIX.length);
-            this.store.setChatSettings(scopeId, model, null);
+            this.store.setChatModel(scopeId, model === 'default' ? null : model);
             this.orchestrator.syncCurrentBackendSettings(scopeId);
             await this.messaging.answerCallback(data, `Model: ${model}`);
             await this.orchestrator.sendModelsMenu(scopeId, locale, messageId);
@@ -870,7 +963,7 @@ export class UnifiedBridgeCore {
             if (effort !== 'high' && settings?.serviceTier === 'boost') {
                 this.store.setChatServiceTier(scopeId, null);
             }
-            this.store.setChatSettings(scopeId, null, effort);
+            this.store.setChatEffort(scopeId, effort);
             this.orchestrator.syncCurrentBackendSettings(scopeId);
             await this.messaging.answerCallback(data, `Effort: ${effort}`);
             await this.sendEffortMenu(scopeId, '', locale, messageId);
@@ -1401,6 +1494,7 @@ export class UnifiedBridgeCore {
             messageId: null,
             currentToolLines: [],
             lastContentPreview: '',
+            subagentTracker: new AntigravitySubagentTracker(conv.conversationId, undefined, this.logger),
         };
         this.watchers.set(scopeId, watcher);
         this.store.setWatchedThread(scopeId, conv.conversationId);
@@ -1472,9 +1566,45 @@ export class UnifiedBridgeCore {
         }, 1500);
         watcher.timer?.unref?.();
     }
+    getScopeLocale(scopeId) {
+        return this.store.getChatSettings(scopeId)?.locale || 'zh';
+    }
+    async renderWatcherProgressUpdate(watcher) {
+        const locale = this.getScopeLocale(watcher.scopeId);
+        let messageText = `👁 <b>[Antigravity 观察中]</b>\n\n`;
+        if (watcher.currentToolLines.length > 0) {
+            const recent = watcher.currentToolLines.slice(-8);
+            messageText += `<blockquote expandable>🛠️ <b>主会话工具 (${watcher.currentToolLines.length} 项)</b>\n${recent.join('\n')}</blockquote>\n\n`;
+        }
+        const subBlock = watcher.subagentTracker.renderTelegramBlock(locale);
+        if (subBlock) {
+            messageText += `${subBlock}\n\n`;
+        }
+        const activeSubSummary = watcher.subagentTracker.getActiveSummaryLine(locale);
+        if (activeSubSummary) {
+            messageText += `⏳ <b>${escapeTelegramHtml(activeSubSummary)}</b>`;
+        }
+        else if (watcher.lastContentPreview) {
+            messageText += watcher.lastContentPreview.slice(-3000);
+        }
+        else {
+            messageText += `⏳ 正在执行中…`;
+        }
+        if (watcher.messageId) {
+            await this.editMessage(watcher.scopeId, watcher.messageId, messageText).catch(() => { });
+        }
+        else {
+            watcher.messageId = await this.sendMessage(watcher.scopeId, messageText).catch(() => null);
+        }
+    }
     async pollWatcher(watcher) {
         if (watcher.stopped)
             return;
+        const currentBinding = this.store.getBinding(watcher.scopeId);
+        if (currentBinding?.threadId && currentBinding.threadId !== watcher.conversationId) {
+            await this.unwatchConversation(watcher.scopeId, this.getScopeLocale(watcher.scopeId), false);
+            return;
+        }
         if (this.orchestrator.hasActiveTurn(watcher.scopeId)) {
             try {
                 if (fs.existsSync(watcher.transcriptPath)) {
@@ -1487,31 +1617,32 @@ export class UnifiedBridgeCore {
             return;
         }
         try {
-            if (!fs.existsSync(watcher.transcriptPath)) {
-                return;
-            }
-            const stats = fs.statSync(watcher.transcriptPath);
-            if (stats.size < watcher.fileOffset) {
-                watcher.fileOffset = 0;
-                watcher.remainder = '';
-                return;
-            }
-            if (stats.size === watcher.fileOffset) {
-                return;
-            }
-            const bytesToRead = stats.size - watcher.fileOffset;
-            const buffer = Buffer.alloc(bytesToRead);
-            const fd = fs.openSync(watcher.transcriptPath, 'r');
-            try {
-                fs.readSync(fd, buffer, 0, bytesToRead, watcher.fileOffset);
-            }
-            finally {
-                fs.closeSync(fd);
+            let hasParentLines = false;
+            const lines = [];
+            if (fs.existsSync(watcher.transcriptPath)) {
+                const stats = fs.statSync(watcher.transcriptPath);
+                if (stats.size < watcher.fileOffset) {
+                    watcher.fileOffset = 0;
+                    watcher.remainder = '';
+                }
+                else if (stats.size > watcher.fileOffset) {
+                    const bytesToRead = stats.size - watcher.fileOffset;
+                    const buffer = Buffer.alloc(bytesToRead);
+                    const fd = fs.openSync(watcher.transcriptPath, 'r');
+                    try {
+                        fs.readSync(fd, buffer, 0, bytesToRead, watcher.fileOffset);
+                    }
+                    finally {
+                        fs.closeSync(fd);
+                    }
+                    watcher.fileOffset = stats.size;
+                    const chunk = watcher.remainder + buffer.toString('utf8');
+                    const splitLines = chunk.split('\n');
+                    watcher.remainder = splitLines.pop() ?? '';
+                    lines.push(...splitLines);
+                    hasParentLines = splitLines.length > 0;
+                }
             }
-            watcher.fileOffset = stats.size;
-            const chunk = watcher.remainder + buffer.toString('utf8');
-            const lines = chunk.split('\n');
-            watcher.remainder = lines.pop() ?? '';
             for (const line of lines) {
                 const trimmed = line.trim();
                 if (!trimmed)
@@ -1525,12 +1656,19 @@ export class UnifiedBridgeCore {
                 }
                 await this.handleWatcherTranscriptEntry(watcher, entry);
             }
+            // Poll subagents
+            const subResult = await watcher.subagentTracker.poll();
+            // If subagents had new tool events or status updates while the parent has no new lines
+            if (subResult.hasUpdates && !hasParentLines) {
+                await this.renderWatcherProgressUpdate(watcher);
+            }
         }
         catch (err) {
             this.logger.debug('antigravity.poll_watcher_error', { error: String(err) });
         }
     }
     async handleWatcherTranscriptEntry(watcher, entry) {
+        const locale = this.getScopeLocale(watcher.scopeId);
         if (entry.type === 'USER_INPUT') {
             const text = typeof entry.content === 'string' ? entry.content : '';
             const preview = text.length > 300 ? text.slice(0, 300) + '…' : text;
@@ -1540,6 +1678,16 @@ export class UnifiedBridgeCore {
             watcher.lastContentPreview = '';
             return;
         }
+        if (entry.type === 'GENERIC') {
+            const content = typeof entry.content === 'string' ? entry.content : '';
+            if (content.includes('Created the following subagents') || content.includes('conversationId')) {
+                const subResult = await watcher.subagentTracker.poll();
+                if (subResult.hasUpdates) {
+                    await this.renderWatcherProgressUpdate(watcher);
+                }
+            }
+            return;
+        }
         if (entry.type === 'PLANNER_RESPONSE') {
             let hasUpdate = false;
             if (Array.isArray(entry.tool_calls) && entry.tool_calls.length > 0) {
@@ -1573,6 +1721,10 @@ export class UnifiedBridgeCore {
                             : '';
                         progressFinal += `\n\n<blockquote expandable>🛠️ <b>已调用工具 (${watcher.currentToolLines.length} 项)</b>\n${recent.join('\n')}${hiddenNote}</blockquote>`;
                     }
+                    const subBlock = watcher.subagentTracker.renderTelegramBlock(locale);
+                    if (subBlock) {
+                        progressFinal += `\n\n<blockquote expandable>${subBlock}</blockquote>`;
+                    }
                     await this.editMessage(watcher.scopeId, watcher.messageId, progressFinal).catch(() => { });
                 }
                 const chunks = chunkTelegramMessage(entry.content.trim(), 4000);
@@ -1582,6 +1734,7 @@ export class UnifiedBridgeCore {
                 watcher.messageId = null;
                 watcher.currentToolLines = [];
                 watcher.lastContentPreview = '';
+                watcher.subagentTracker = new AntigravitySubagentTracker(watcher.conversationId, undefined, this.logger);
                 return;
             }
             if (entry.content) {
@@ -1594,7 +1747,15 @@ export class UnifiedBridgeCore {
                     const recent = watcher.currentToolLines.slice(-8);
                     messageText += `<blockquote expandable>🛠️ <b>已调用工具 (${watcher.currentToolLines.length} 项)</b>\n${recent.join('\n')}</blockquote>\n\n`;
                 }
-                if (watcher.lastContentPreview) {
+                const subBlock = watcher.subagentTracker.renderTelegramBlock(locale);
+                if (subBlock) {
+                    messageText += `${subBlock}\n\n`;
+                }
+                const activeSubSummary = watcher.subagentTracker.getActiveSummaryLine(locale);
+                if (activeSubSummary) {
+                    messageText += `⏳ <b>${escapeTelegramHtml(activeSubSummary)}</b>`;
+                }
+                else if (watcher.lastContentPreview) {
                     messageText += watcher.lastContentPreview.slice(-3000);
                 }
                 else {
@@ -1877,7 +2038,7 @@ export class UnifiedBridgeCore {
                 if (target !== 'high' && isBoost) {
                     this.store.setChatServiceTier(scopeId, null);
                 }
-                this.store.setChatSettings(scopeId, null, target);
+                this.store.setChatEffort(scopeId, target);
                 this.orchestrator.syncCurrentBackendSettings(scopeId);
                 await this.sendMessage(scopeId, locale === 'zh' ? `✅ 思考深度已切换为: \`${target}\`` : `✅ Effort switched to: \`${target}\``);
                 return;

package/dist/antigravity/events.d.ts

@@ -90,6 +90,7 @@ export type AntigravityBridgeEvent = AgInitBridgeEvent | AgTextEvent | AgToolEve
 export declare function isVerificationError(errorMessage: string): boolean;
 export declare function isQuotaOrAuthError(errorMessage: string): boolean;
 export declare function isCapacityOrUnavailableError(errorMessage: string): boolean;
+export declare function isTransientNetworkError(errorMessage: string): boolean;
 /**
  * Normalizes raw NDJSON stream events from `agy` into clean bridge events.
  */

package/dist/antigravity/events.js

@@ -28,6 +28,35 @@ export function isCapacityOrUnavailableError(errorMessage) {
         lower.includes('overloaded') ||
         lower.includes('high load'));
 }
+export function isTransientNetworkError(errorMessage) {
+    if (!errorMessage)
+        return false;
+    const lower = errorMessage.toLowerCase();
+    return (lower.includes('client network socket disconnected') ||
+        lower.includes('connection timed out') ||
+        lower.includes('timed out') ||
+        lower.includes('timeout') ||
+        lower.includes('econnreset') ||
+        lower.includes('etimedout') ||
+        lower.includes('enotfound') ||
+        lower.includes('eai_again') ||
+        lower.includes('econnrefused') ||
+        lower.includes('socket hang up') ||
+        lower.includes('network socket disconnected') ||
+        lower.includes('retryable') ||
+        lower.includes('grpc') ||
+        lower.includes('network error') ||
+        lower.includes('fetch failed') ||
+        lower.includes('502 bad gateway') ||
+        lower.includes('504 gateway timeout') ||
+        lower.includes('proxy error') ||
+        lower.includes('read tcp') ||
+        lower.includes('und_err_') ||
+        lower.includes('broken pipe') ||
+        lower.includes('ehostunreach') ||
+        lower.includes('enetunreach') ||
+        lower.includes('exited unexpectedly'));
+}
 /**
  * Normalizes raw NDJSON stream events from `agy` into clean bridge events.
  */

package/dist/antigravity/runtime.d.ts

@@ -6,6 +6,7 @@ import { AntigravityAppClient } from './client.js';
 import { AntigravityAuthManager } from './auth.js';
 import { AntigravityBridgeCore } from './controller.js';
 import type { CodexAppClient } from '../codex_app/client.js';
+import type { SelfUpdateRuntime } from '../update.js';
 export interface AntigravityRuntimeOptions {
     botToken?: string | undefined;
     botId?: string | undefined;
@@ -16,6 +17,7 @@ export interface AntigravityRuntimeOptions {
     codexApp?: CodexAppClient | undefined;
     app?: AntigravityAppClient | undefined;
     auth?: AntigravityAuthManager | undefined;
+    selfUpdater?: SelfUpdateRuntime | undefined;
 }
 /** Keeps the optional Antigravity Telegram bot lifecycle decoupled from Codex and OpenCode runtimes. */
 export declare class AntigravityTelegramRuntime {

package/dist/antigravity/subagents.d.ts

@@ -0,0 +1,66 @@
+import type { Logger } from '../logger.js';
+import type { AppLocale } from '../types.js';
+export interface SubagentProgressInfo {
+    conversationId: string;
+    parentConversationId: string;
+    agentName: string;
+    role?: string | undefined;
+    typeName?: string | undefined;
+    status: 'running' | 'idle' | 'done';
+    stepIndex: number;
+    toolCount: number;
+    currentTool: string | null;
+    recentTools: string[];
+    lastAction: string;
+    lastContentPreview: string;
+    updatedAt: number;
+    completedAt?: number | undefined;
+}
+export interface SubagentToolEvent {
+    subagentName: string;
+    conversationId: string;
+    toolName: string;
+    args?: Record<string, unknown> | string | undefined;
+    summary?: string | undefined;
+    status: 'running' | 'completed' | 'failed';
+    stepIndex?: number | undefined;
+}
+export interface SubagentPollResult {
+    subagents: SubagentProgressInfo[];
+    activeSubagents: SubagentProgressInfo[];
+    newToolEvents: SubagentToolEvent[];
+    hasUpdates: boolean;
+}
+export declare function cleanParameterValue(val: unknown): string;
+export declare function extractSubagentToolSummary(name: string, parameters?: Record<string, unknown> | string | undefined): string | undefined;
+export declare function escapeTelegramHtml(value: string): string;
+export declare class AntigravitySubagentTracker {
+    private readonly baseDir;
+    private readonly dbPath;
+    private readonly logger;
+    private readonly parentConversationId;
+    private readonly subagents;
+    private parentTranscriptOffset;
+    private parentTranscriptRemainder;
+    constructor(parentConversationId: string, baseDir?: string, logger?: Logger);
+    get trackedCount(): number;
+    getSubagents(): SubagentProgressInfo[];
+    getActiveSubagents(): SubagentProgressInfo[];
+    getTranscriptPath(conversationId: string): string;
+    /**
+     * Discovers and polls active subagents for new steps, tool calls, and completion status.
+     */
+    poll(): Promise<SubagentPollResult>;
+    private discoverSubagentsFromDb;
+    private discoverSubagentsFromParentTranscript;
+    private extractSubagentsFromTranscriptEntry;
+    private pollSubagentTranscript;
+    /**
+     * Renders subagent progress for Telegram messages (watch mode or stream preview).
+     */
+    renderTelegramBlock(locale?: AppLocale): string;
+    /**
+     * One-line summary of what active subagents are currently doing.
+     */
+    getActiveSummaryLine(locale?: AppLocale): string | null;
+}