@foxden-app/foxclaw 0.5.31 → 0.5.33

package/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 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.5.33 - 2026-06-16
+
+### 中文
+- 新增 Telegram Rich Message 适配专项盘点，明确现有 HTML 通道、Bot API 10.1 rich message 能力、FoxClaw 可用功能面和分阶段接入路线。
+- 接入 `sendRichMessage` / rich HTML 发送链路，新增 `/rich` 诊断命令用于在 Telegram 客户端直接查看 heading、table、details、pre/code、list 的 RichMessage 渲染效果。
+- 集中 Telegram HTML 转义与常用标签 helper，并把 `/diff` 改为优先使用 RichMessage details + diff code block；发送失败时回退到原 Telegram HTML 折叠展示。
+
+### English
+- Added a Telegram Rich Message adaptation check covering the current HTML path, Bot API 10.1 rich message capabilities, FoxClaw candidate surfaces, and a phased rollout plan.
+- Wired the `sendRichMessage` / rich HTML send path and added `/rich` as a diagnostic command for checking heading, table, details, pre/code, and list rendering in Telegram clients.
+- Centralized Telegram HTML escaping/tag helpers and changed `/diff` to prefer RichMessage details plus a diff code block, falling back to the previous Telegram HTML collapsible rendering if rich sending fails.
+
+## 0.5.32 - 2026-06-11
+
+### 中文
+- 补齐 macOS launchd 适配检查：`doctor` 现在会检查已安装 plist 中记录的 Node 路径是否存在且为 Node 24+，并新增 `uninstall-launchd` 命令。
+- 新增 launchd plist 生成/解析的单元测试，并补充 macOS 服务状态、日志、代理和 Node 路径排障文档。
+
+### English
+- Filled macOS launchd adaptation gaps: `doctor` now checks that the Node path recorded in the installed plist exists and is Node 24+, and `uninstall-launchd` is available.
+- Added unit coverage for launchd plist generation/parsing and expanded macOS service status, log, proxy, and Node-path troubleshooting docs.
+
 ## 0.5.31 - 2026-06-09
 
 ### 中文

package/README.md

@@ -148,13 +148,20 @@ FoxClaw 的一大特色是自动多账号切换。当一个账号触发用量限
 foxclaw start
 ```
 
-Linux 上会安装/重启用户级 systemd 服务，macOS 上安装/重载 launchd。查看状态：
+Linux 上会安装/重启用户级 systemd 服务，macOS 上安装/重载 launchd。Linux 查看状态：
 
 ```bash
 systemctl --user status foxclaw.service
 journalctl --user -u foxclaw.service -f
 ```
 
+macOS 查看状态和启动日志：
+
+```bash
+launchctl print "gui/$(id -u)/app.foxden.foxclaw"
+tail -f ~/.foxclaw/logs/launchd.err.log ~/.foxclaw/logs/service.log
+```
+
 也可以直接用包装命令：
 
 ```bash
@@ -319,6 +326,7 @@ foxclaw restart
 foxclaw update
 foxclaw stop
 foxclaw uninstall-systemd
+foxclaw uninstall-launchd
 ```
 
 ## 贡献

package/README_EN.md

@@ -155,6 +155,13 @@ systemctl --user status foxclaw.service
 journalctl --user -u foxclaw.service -f
 ```
 
+To inspect macOS launchd state and startup logs:
+
+```bash
+launchctl print "gui/$(id -u)/app.foxden.foxclaw"
+tail -f ~/.foxclaw/logs/launchd.err.log ~/.foxclaw/logs/service.log
+```
+
 You can also use the wrapper commands:
 
 ```bash
@@ -319,6 +326,7 @@ foxclaw restart
 foxclaw update
 foxclaw stop
 foxclaw uninstall-systemd
+foxclaw uninstall-launchd
 ```
 
 ## Contributing

package/dist/channels/bridge_messaging_router.d.ts

@@ -15,8 +15,10 @@ export declare class BridgeMessagingRouter {
     private requireWeixinTransport;
     sendPlain(scopeId: string, text: string, keyboard?: InlineKeyboard): Promise<number>;
     sendHtml(scopeId: string, text: string, keyboard?: InlineKeyboard): Promise<number>;
+    sendRichHtml(scopeId: string, html: string, fallbackHtml: string, keyboard?: InlineKeyboard): Promise<number>;
     editPlain(scopeId: string, messageId: number, text: string, keyboard?: InlineKeyboard): Promise<void>;
     editHtml(scopeId: string, messageId: number, text: string, keyboard?: InlineKeyboard): Promise<void>;
+    editRichHtml(scopeId: string, messageId: number, html: string, fallbackHtml: string, keyboard?: InlineKeyboard): Promise<void>;
     deleteMessage(scopeId: string, messageId: number): Promise<void>;
     sendTypingInScope(scopeId: string): Promise<void>;
     clearInlineKeyboard(scopeId: string, messageId: number): Promise<void>;

package/dist/channels/bridge_messaging_router.js

@@ -37,6 +37,12 @@ export class BridgeMessagingRouter {
         }
         return this.telegram.sendHtml(scopeId, text, keyboard);
     }
+    sendRichHtml(scopeId, html, fallbackHtml, keyboard) {
+        if (this.isWeixinScope(scopeId)) {
+            return this.requireWeixinTransport(scopeId).sendHtml(scopeId, fallbackHtml, keyboard);
+        }
+        return this.telegram.sendRichHtml(scopeId, html, keyboard);
+    }
     editPlain(scopeId, messageId, text, keyboard) {
         if (this.isWeixinScope(scopeId)) {
             return this.requireWeixinTransport(scopeId).editPlain(scopeId, messageId, text, keyboard);
@@ -49,6 +55,12 @@ export class BridgeMessagingRouter {
         }
         return this.telegram.editHtml(scopeId, messageId, text, keyboard);
     }
+    editRichHtml(scopeId, messageId, html, fallbackHtml, keyboard) {
+        if (this.isWeixinScope(scopeId)) {
+            return this.requireWeixinTransport(scopeId).editHtml(scopeId, messageId, fallbackHtml, keyboard);
+        }
+        return this.telegram.editRichHtml(scopeId, messageId, html, keyboard);
+    }
     deleteMessage(scopeId, messageId) {
         if (this.isWeixinScope(scopeId)) {
             return this.requireWeixinTransport(scopeId).deleteMessage(scopeId, messageId);

package/dist/channels/telegram/telegram_messaging_port.d.ts

@@ -13,8 +13,10 @@ export declare class TelegramMessagingPort implements ChannelPort {
     constructor(gateway: TelegramGateway);
     sendPlain(bridgeScopeId: string, text: string, inlineKeyboard?: InlineKeyboard): Promise<number>;
     sendHtml(bridgeScopeId: string, text: string, inlineKeyboard?: InlineKeyboard): Promise<number>;
+    sendRichHtml(bridgeScopeId: string, html: string, inlineKeyboard?: InlineKeyboard): Promise<number>;
     editPlain(bridgeScopeId: string, messageId: number, text: string, inlineKeyboard?: InlineKeyboard): Promise<void>;
     editHtml(bridgeScopeId: string, messageId: number, text: string, inlineKeyboard?: InlineKeyboard): Promise<void>;
+    editRichHtml(bridgeScopeId: string, messageId: number, html: string, inlineKeyboard?: InlineKeyboard): Promise<void>;
     deleteMessage(bridgeScopeId: string, messageId: number): Promise<void>;
     sendTypingInScope(bridgeScopeId: string): Promise<void>;
     clearInlineKeyboard(bridgeScopeId: string, messageId: number): Promise<void>;

package/dist/channels/telegram/telegram_messaging_port.js

@@ -1,4 +1,5 @@
 import { parseTelegramTargetFromBridgeScope } from '../../core/bridge_scope.js';
+import { telegramRichHtml } from '../../telegram/rich.js';
 /**
  * Telegram outbound operations addressed by bridge scope id (`telegram:…`).
  */
@@ -15,6 +16,10 @@ export class TelegramMessagingPort {
         const target = parseTelegramTargetFromBridgeScope(bridgeScopeId);
         return this.gateway.sendHtmlMessage(target.chatId, text, inlineKeyboard, target.topicId);
     }
+    async sendRichHtml(bridgeScopeId, html, inlineKeyboard) {
+        const target = parseTelegramTargetFromBridgeScope(bridgeScopeId);
+        return this.gateway.sendRichMessage(target.chatId, telegramRichHtml(html, { skipEntityDetection: true }), inlineKeyboard, target.topicId);
+    }
     async editPlain(bridgeScopeId, messageId, text, inlineKeyboard) {
         const target = parseTelegramTargetFromBridgeScope(bridgeScopeId);
         await this.gateway.editMessage(target.chatId, messageId, text, inlineKeyboard);
@@ -23,6 +28,10 @@ export class TelegramMessagingPort {
         const target = parseTelegramTargetFromBridgeScope(bridgeScopeId);
         await this.gateway.editHtmlMessage(target.chatId, messageId, text, inlineKeyboard);
     }
+    async editRichHtml(bridgeScopeId, messageId, html, inlineKeyboard) {
+        const target = parseTelegramTargetFromBridgeScope(bridgeScopeId);
+        await this.gateway.editRichMessage(target.chatId, messageId, telegramRichHtml(html, { skipEntityDetection: true }), inlineKeyboard);
+    }
     async deleteMessage(bridgeScopeId, messageId) {
         const target = parseTelegramTargetFromBridgeScope(bridgeScopeId);
         await this.gateway.deleteMessage(target.chatId, messageId);

package/dist/controller/controller.d.ts

@@ -227,8 +227,10 @@ export declare class BridgeSessionCore {
     private updateStatus;
     private sendMessage;
     private sendHtmlMessage;
+    private sendRichHtmlMessage;
     private editMessage;
     private editHtmlMessage;
+    private editRichHtmlMessage;
     private deleteMessage;
     private sendTyping;
     private sendObservedCliUserMessage;
@@ -318,6 +320,7 @@ export declare class BridgeSessionCore {
     private handleArchiveCommand;
     private handleUnarchiveCommand;
     private handleReviewCommand;
+    private handleRichCommand;
     private handleDiffCommand;
     private handleLoadedCommand;
     private handleSkillsCommand;

package/dist/controller/controller.js

@@ -9,6 +9,8 @@ import { buildAccessSettingsKeyboard, buildModelSettingsKeyboard, buildSetupPane
 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';
+import { escapeTelegramHtml, telegramBold, telegramDetails, telegramExpandableBlockquote, telegramPre, telegramPreCode, } from '../telegram/html.js';
+import { TELEGRAM_RICH_MESSAGE_TEXT_LIMIT } from '../telegram/rich.js';
 import { isDefaultTelegramScope, resolveTelegramAddressing } from '../telegram/addressing.js';
 import { BRIDGE_SCOPE_WEIXIN_PREFIX, parseTelegramTargetFromBridgeScope, parseWeixinBridgeScope } from '../core/bridge_scope.js';
 import { resolveTelegramRenderRoute } from '../telegram/rendering.js';
@@ -50,6 +52,7 @@ const PINNED_HELP_COMMANDS = [
 const DYNAMIC_HELP_COMMANDS = [
     { key: 'fast', line: '/fast <on|off|toggle>' },
     { key: 'active', line: '/active <steer|queue>' },
+    { key: 'rich', line: '/rich' },
     { key: 'account', line: '/account' },
     { key: 'quota', line: '/quota' },
     { key: 'update', line: '/update' },
@@ -717,6 +720,10 @@ export class BridgeSessionCore {
                 await this.handleReviewCommand(event, locale, args);
                 return;
             }
+            case 'rich': {
+                await this.handleRichCommand(scopeId, locale);
+                return;
+            }
             case 'diff': {
                 await this.handleDiffCommand(scopeId, locale);
                 return;
@@ -3356,12 +3363,30 @@ export class BridgeSessionCore {
     async sendHtmlMessage(scopeId, text, inlineKeyboard) {
         return this.messaging.sendHtml(scopeId, text, inlineKeyboard);
     }
+    async sendRichHtmlMessage(scopeId, html, fallbackHtml, inlineKeyboard) {
+        try {
+            return await this.messaging.sendRichHtml(scopeId, html, fallbackHtml, inlineKeyboard);
+        }
+        catch (error) {
+            this.logger.warn('telegram.rich_message_send_failed', { scopeId, error: toErrorMeta(error) });
+            return this.sendHtmlMessage(scopeId, fallbackHtml, inlineKeyboard);
+        }
+    }
     async editMessage(scopeId, messageId, text, inlineKeyboard) {
         await this.messaging.editPlain(scopeId, messageId, text, inlineKeyboard);
     }
     async editHtmlMessage(scopeId, messageId, text, inlineKeyboard) {
         await this.messaging.editHtml(scopeId, messageId, text, inlineKeyboard);
     }
+    async editRichHtmlMessage(scopeId, messageId, html, fallbackHtml, inlineKeyboard) {
+        try {
+            await this.messaging.editRichHtml(scopeId, messageId, html, fallbackHtml, inlineKeyboard);
+        }
+        catch (error) {
+            this.logger.warn('telegram.rich_message_edit_failed', { scopeId, messageId, error: toErrorMeta(error) });
+            await this.editHtmlMessage(scopeId, messageId, fallbackHtml, inlineKeyboard);
+        }
+    }
     async deleteMessage(scopeId, messageId) {
         await this.messaging.deleteMessage(scopeId, messageId);
     }
@@ -3373,8 +3398,8 @@ export class BridgeSessionCore {
         for (let index = 0; index < chunks.length; index += 1) {
             const chunk = chunks[index];
             const body = index === 0
-                ? `<b>${escapeTelegramHtml(OBSERVED_CLI_USER_LABEL)}</b>\n<pre>${escapeTelegramHtml(chunk)}</pre>`
-                : `<pre>${escapeTelegramHtml(chunk)}</pre>`;
+                ? `${telegramBold(OBSERVED_CLI_USER_LABEL)}\n${telegramPre(chunk)}`
+                : telegramPre(chunk);
             await this.sendHtmlMessage(scopeId, body);
         }
     }
@@ -5052,13 +5077,16 @@ export class BridgeSessionCore {
             await this.registerActiveTurn(event.scopeId, event.chatId, event.chatType, event.topicId, result.reviewThreadId, result.turnId, 0);
         }
     }
+    async handleRichCommand(scopeId, locale) {
+        await this.sendRichHtmlMessage(scopeId, formatRichDemoMessage(locale), formatRichDemoFallbackMessage(locale));
+    }
     async handleDiffCommand(scopeId, locale) {
         const diff = this.latestTurnDiffs.get(scopeId);
         if (!diff?.diff.trim()) {
             await this.sendMessage(scopeId, t(locale, 'diff_unavailable'));
             return;
         }
-        await this.sendMessage(scopeId, formatDiffMessage(locale, diff.diff));
+        await this.sendRichHtmlMessage(scopeId, formatRichDiffMessage(locale, diff.diff), formatDiffMessage(locale, diff.diff));
     }
     async handleLoadedCommand(scopeId, locale) {
         const threadIds = await this.app.listLoadedThreads();
@@ -7990,10 +8018,9 @@ function renderArchivedToolBatchStatus(locale, counts, actionLines) {
         return { text, html: null };
     }
     const heading = formatToolBatchHeading(locale, counts, false);
-    const detailLines = actionLines.slice(0, 12).map(line => escapeTelegramHtml(line));
     const html = [
-        `<b>${escapeTelegramHtml(heading)}</b>`,
-        `<blockquote expandable>${detailLines.join('\n')}</blockquote>`,
+        telegramBold(heading),
+        telegramExpandableBlockquote(actionLines.slice(0, 12).join('\n')),
     ].join('\n');
     return { text, html };
 }
@@ -8142,12 +8169,6 @@ function truncateInline(value, limit) {
     }
     return `${value.slice(0, Math.max(0, limit - 1))}…`;
 }
-function escapeTelegramHtml(value) {
-    return value
-        .replaceAll('&', '&amp;')
-        .replaceAll('<', '&lt;')
-        .replaceAll('>', '&gt;');
-}
 function parseReviewTarget(args) {
     if (args.length === 0) {
         return { type: 'uncommittedChanges' };
@@ -8260,7 +8281,97 @@ function formatMcpResourceMessage(locale, server, uri, contents) {
 }
 function formatDiffMessage(locale, diff) {
     const clipped = diff.length > 3500 ? `${diff.slice(0, 3500)}\n...` : diff;
-    return `${t(locale, 'diff_title')}\n${clipped}`;
+    return [
+        telegramBold(t(locale, 'diff_title')),
+        telegramExpandableBlockquote(clipped),
+    ].join('\n');
+}
+function formatRichDiffMessage(locale, diff) {
+    const clipped = clipRichMessageText(diff, Math.min(24_000, TELEGRAM_RICH_MESSAGE_TEXT_LIMIT - 1024));
+    const summary = locale === 'zh' ? '展开 diff' : 'Expand diff';
+    const footer = locale === 'zh'
+        ? 'FoxClaw · sendRichMessage · details/pre/code'
+        : 'FoxClaw · sendRichMessage · details/pre/code';
+    return [
+        `<h3>${escapeTelegramHtml(t(locale, 'diff_title'))}</h3>`,
+        telegramDetails(summary, telegramPreCode(clipped, 'diff')),
+        `<footer>${escapeTelegramHtml(footer)}</footer>`,
+    ].join('\n');
+}
+function formatRichDemoMessage(locale) {
+    const title = 'FoxClaw RichMessage';
+    const intro = locale === 'zh'
+        ? '这条消息通过 Telegram Bot API sendRichMessage 发送，用来验证 Rich Message 在真实客户端里的渲染。'
+        : 'This message is sent through Telegram Bot API sendRichMessage to verify Rich Message rendering in a real client.';
+    const detailsSummary = locale === 'zh' ? '展开 details + pre 示例' : 'Open details + pre sample';
+    const diffSample = [
+        'diff --git a/src/telegram/rich.ts b/src/telegram/rich.ts',
+        '+ sendRichMessage({ rich_message: { html } })',
+        '+ <details><summary>Expandable</summary>...</details>',
+        '+ <table bordered striped>...</table>',
+    ].join('\n');
+    const tableCaption = locale === 'zh' ? 'FoxClaw 可用 rich 面' : 'FoxClaw rich surfaces';
+    const surfaceHeader = locale === 'zh' ? '功能面' : 'Surface';
+    const richHeader = locale === 'zh' ? 'Rich 用法' : 'Rich usage';
+    const tableRows = locale === 'zh'
+        ? [
+            ['`/diff`', 'details + pre/code'],
+            ['工具状态', 'details/list'],
+            ['`/status`', 'table'],
+        ]
+        : [
+            ['`/diff`', 'details + pre/code'],
+            ['Tool status', 'details/list'],
+            ['`/status`', 'table'],
+        ];
+    const listItems = locale === 'zh'
+        ? ['Gateway 已接入 sendRichMessage', '/diff 已优先使用 RichMessage', '失败会回退到 Telegram HTML']
+        : ['Gateway now supports sendRichMessage', '/diff prefers RichMessage', 'Failures fall back to Telegram HTML'];
+    const detailBody = [
+        `<p>${escapeTelegramHtml(locale === 'zh' ? '下面是 rich pre/code block，客户端支持时会按代码块渲染。' : 'This is a rich pre/code block rendered as code by supported clients.')}</p>`,
+        telegramPreCode(diffSample, 'diff'),
+    ].join('\n');
+    return [
+        `<h2>${escapeTelegramHtml(title)}</h2>`,
+        `<p><b>Bot API 10.1</b> ${escapeTelegramHtml(intro)}</p>`,
+        '<hr/>',
+        '<table bordered striped>',
+        `<caption>${escapeTelegramHtml(tableCaption)}</caption>`,
+        `<tr><th>${escapeTelegramHtml(surfaceHeader)}</th><th>${escapeTelegramHtml(richHeader)}</th></tr>`,
+        ...tableRows.map(([surface, usage]) => `<tr><td>${escapeTelegramHtml(surface)}</td><td>${escapeTelegramHtml(usage)}</td></tr>`),
+        '</table>',
+        telegramDetails(detailsSummary, detailBody, true),
+        '<ul>',
+        ...listItems.map(item => `<li>${escapeTelegramHtml(item)}</li>`),
+        '</ul>',
+        '<footer>FoxClaw · sendRichMessage</footer>',
+    ].join('\n');
+}
+function formatRichDemoFallbackMessage(locale) {
+    const lines = locale === 'zh'
+        ? [
+            'RichMessage fallback 预览',
+            'Gateway 已接入 sendRichMessage',
+            '/diff 已优先使用 RichMessage',
+            '如果你看到这条 HTML fallback，说明 Telegram rich API 返回了失败，正常功能仍可用。',
+        ]
+        : [
+            'RichMessage fallback preview',
+            'Gateway now supports sendRichMessage',
+            '/diff prefers RichMessage',
+            'If you see this HTML fallback, Telegram rich API failed but normal messaging still works.',
+        ];
+    return [
+        telegramBold('FoxClaw RichMessage'),
+        telegramExpandableBlockquote(lines.join('\n')),
+        telegramPreCode('sendRichMessage({ rich_message: { html } })', 'typescript'),
+    ].join('\n');
+}
+function clipRichMessageText(value, limit) {
+    if (value.length <= limit) {
+        return value;
+    }
+    return `${value.slice(0, Math.max(0, limit - 4))}\n...`;
 }
 function formatLoadedThreadsMessage(locale, threadIds) {
     const lines = [t(locale, 'loaded_title')];

package/dist/controller/presentation.js

@@ -1,5 +1,6 @@
 import path from 'node:path';
 import { t } from '../i18n.js';
+import { escapeTelegramHtml } from '../telegram/html.js';
 import { resolveFastTierForModel } from './service_tier.js';
 export function formatThreadsMessage(locale, threads, currentThreadId, searchTerm, listState) {
     if (threads.length === 0) {
@@ -642,12 +643,6 @@ function formatIsoTime(locale, unixSeconds) {
         return t(locale, 'unknown');
     return new Date(unixSeconds * 1000).toISOString();
 }
-function escapeTelegramHtml(value) {
-    return value
-        .replaceAll('&', '&')
-        .replaceAll('<', '&lt;')
-        .replaceAll('>', '&gt;');
-}
 function chunkButtons(buttons, width) {
     const rows = [];
     for (let index = 0; index < buttons.length; index += width) {

package/dist/i18n.d.ts

@@ -45,6 +45,7 @@ declare const MESSAGES: {
         readonly cmd_desc_setup: "Unified preference panel";
         readonly cmd_desc_fast: "Toggle Fast mode";
         readonly cmd_desc_active: "Active-turn message behavior";
+        readonly cmd_desc_rich: "Telegram RichMessage demo";
         readonly cmd_desc_status: "Bridge status";
         readonly cmd_desc_update: "Update and restart FoxClaw";
         readonly cmd_desc_account: "Codex account";
@@ -742,6 +743,7 @@ declare const MESSAGES: {
         readonly cmd_desc_setup: "统一偏好面板";
         readonly cmd_desc_fast: "切换 Fast 模式";
         readonly cmd_desc_active: "运行中新消息处理方式";
+        readonly cmd_desc_rich: "Telegram RichMessage 演示";
         readonly cmd_desc_status: "查看桥接状态";
         readonly cmd_desc_update: "升级并重启 FoxClaw";
         readonly cmd_desc_account: "Codex 账号";

package/dist/i18n.js

@@ -43,6 +43,7 @@ const MESSAGES = {
         cmd_desc_setup: 'Unified preference panel',
         cmd_desc_fast: 'Toggle Fast mode',
         cmd_desc_active: 'Active-turn message behavior',
+        cmd_desc_rich: 'Telegram RichMessage demo',
         cmd_desc_status: 'Bridge status',
         cmd_desc_update: 'Update and restart FoxClaw',
         cmd_desc_account: 'Codex account',
@@ -740,6 +741,7 @@ const MESSAGES = {
         cmd_desc_setup: '统一偏好面板',
         cmd_desc_fast: '切换 Fast 模式',
         cmd_desc_active: '运行中新消息处理方式',
+        cmd_desc_rich: 'Telegram RichMessage 演示',
         cmd_desc_status: '查看桥接状态',
         cmd_desc_update: '升级并重启 FoxClaw',
         cmd_desc_account: 'Codex 账号',
@@ -1412,6 +1414,7 @@ export function getTelegramCommands(locale) {
         { command: 'auth', description: t(locale, 'cmd_desc_auth') },
         { command: 'fast', description: t(locale, 'cmd_desc_fast') },
         { command: 'active', description: t(locale, 'cmd_desc_active') },
+        { command: 'rich', description: t(locale, 'cmd_desc_rich') },
         { command: 'account', description: t(locale, 'cmd_desc_account') },
         { command: 'quota', description: t(locale, 'cmd_desc_quota') },
         { command: 'login_device', description: t(locale, 'cmd_desc_login_device') },

package/dist/launchd.d.ts

@@ -0,0 +1,18 @@
+export interface FoxclawLaunchdPlistOptions {
+    label: string;
+    nodePath: string;
+    nodeArgs: string[];
+    entryPoint: string;
+    workingDirectory: string;
+    pathValue: string;
+    home: string;
+    user: string;
+    logname: string;
+    envPath: string;
+    proxyEnv: Record<string, string>;
+    stdoutPath: string;
+    stderrPath: string;
+}
+export declare function buildFoxclawLaunchdPlistText(options: FoxclawLaunchdPlistOptions): string;
+export declare function extractNodePathFromLaunchdPlist(plistText: string): string;
+export declare function xmlEscape(value: string): string;

package/dist/launchd.js

@@ -0,0 +1,75 @@
+export function buildFoxclawLaunchdPlistText(options) {
+    const nodeArgXml = options.nodeArgs.map((arg) => `    <string>${xmlEscape(arg)}</string>`).join('\n');
+    const proxyEnvXml = buildEnvironmentVariablesXml(options.proxyEnv, 4);
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>${xmlEscape(options.label)}</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${xmlEscape(options.nodePath)}</string>
+${nodeArgXml ? `${nodeArgXml}\n` : ''}    <string>${xmlEscape(options.entryPoint)}</string>
+    <string>serve</string>
+  </array>
+  <key>WorkingDirectory</key>
+  <string>${xmlEscape(options.workingDirectory)}</string>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>PATH</key>
+    <string>${xmlEscape(options.pathValue)}</string>
+    <key>HOME</key>
+    <string>${xmlEscape(options.home)}</string>
+    <key>USER</key>
+    <string>${xmlEscape(options.user)}</string>
+    <key>LOGNAME</key>
+    <string>${xmlEscape(options.logname)}</string>
+    <key>FOXCLAW_ENV</key>
+    <string>${xmlEscape(options.envPath)}</string>
+${proxyEnvXml}
+  </dict>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${xmlEscape(options.stdoutPath)}</string>
+  <key>StandardErrorPath</key>
+  <string>${xmlEscape(options.stderrPath)}</string>
+</dict>
+</plist>
+`;
+}
+export function extractNodePathFromLaunchdPlist(plistText) {
+    const programArguments = plistText.match(/<key>\s*ProgramArguments\s*<\/key>\s*<array>([\s\S]*?)<\/array>/);
+    const firstArgument = programArguments?.[1]?.match(/<string>([\s\S]*?)<\/string>/)?.[1] ?? '';
+    return firstArgument ? xmlUnescape(firstArgument.trim()) : '';
+}
+export function xmlEscape(value) {
+    return value
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
+}
+function xmlUnescape(value) {
+    return value
+        .replace(/&apos;/g, "'")
+        .replace(/&quot;/g, '"')
+        .replace(/&gt;/g, '>')
+        .replace(/&lt;/g, '<')
+        .replace(/&amp;/g, '&');
+}
+function buildEnvironmentVariablesXml(values, indent) {
+    const prefix = ' '.repeat(indent);
+    const entries = [];
+    for (const [key, value] of Object.entries(values)) {
+        if (!value)
+            continue;
+        entries.push(`${prefix}<key>${xmlEscape(key)}</key>`);
+        entries.push(`${prefix}<string>${xmlEscape(value)}</string>`);
+    }
+    return entries.length > 0 ? `${entries.join('\n')}\n` : '';
+}