botmux 2.56.0-canary.0 → 2.57.0

package/README.en.md

@@ -15,14 +15,14 @@
   <a href="#design-philosophy">Design</a> &middot;
   <a href="#key-advantages">Advantages</a> &middot;
   <a href="#5-minute-setup">Quick Start</a> &middot;
-  <a href="https://magic.solutionsuite.cn/html-box/vkWHeJn1Fn2"><b>📖 Docs</b></a>
+  <a href="https://bytedance.aiforce.cloud/app/app_4k9smq6rdxher/"><b>📖 Docs</b></a>
 </p>
 
 [中文](README.md) | English
 
 **Plug any AI coding CLI into Lark (Feishu) topic groups — one thread per session, streaming cards, web terminal, zero glue code.**
 
-> 📖 **Full docs** (commands / config / best practices / troubleshooting): **<https://magic.solutionsuite.cn/html-box/vkWHeJn1Fn2>** — this README only covers why and how to get started fast.
+> 📖 **Full docs** (commands / config / best practices / troubleshooting): **<https://bytedance.aiforce.cloud/app/app_4k9smq6rdxher/>** — this README only covers why and how to get started fast.
 
 | Lark Streaming Cards | Web Terminal | tmux Session Management | Multi-Bot Collaboration |
 |:-:|:-:|:-:|:-:|
@@ -197,7 +197,7 @@ On mobile/tablet, a floating shortcut toolbar provides Esc, Ctrl+C, Tab, arrow k
 
 ### Multi-Bot Collaboration
 
-Run multiple Lark bots on a single machine, each mapped to a different CLI. In the same group chat, messages are routed via @mention — each bot gets its own isolated CLI process. With a single bot in the group, it responds automatically without @. In a regular (non-topic) group, `@<bot1> @<bot2> /t xxx` spawns one independent thread per mentioned bot anchored at the same message. Send `@<bot1> @<bot2> /introduce` once so they register each other's open_id; afterwards each bot can explicitly @-mention the others from within its own session (commands: [📖 Docs · Slash Commands](https://magic.solutionsuite.cn/html-box/vkWHeJn1Fn2#/slash-commands)).
+Run multiple Lark bots on a single machine, each mapped to a different CLI. In the same group chat, messages are routed via @mention — each bot gets its own isolated CLI process. With a single bot in the group, it responds automatically without @. In a regular (non-topic) group, `@<bot1> @<bot2> /t xxx` spawns one independent thread per mentioned bot anchored at the same message. Send `@<bot1> @<bot2> /introduce` once so they register each other's open_id; afterwards each bot can explicitly @-mention the others from within its own session (commands: [📖 Docs · Slash Commands](https://bytedance.aiforce.cloud/app/app_4k9smq6rdxher/slash-commands)).
 
 ### Multi-Topic Collaboration
 
@@ -333,16 +333,16 @@ Gemini / OpenCode / Antigravity), with no MCP protocol support required.
 
 The full reference — commands, config, best practices, troubleshooting — lives in the docs site; not duplicated here —
 
-### 👉 https://magic.solutionsuite.cn/html-box/vkWHeJn1Fn2
+### 👉 https://bytedance.aiforce.cloud/app/app_4k9smq6rdxher/
 
 | Topic | Docs |
 |-------|------|
-| Slash commands / CLI commands / agent-facing subcommands | [Commands](https://magic.solutionsuite.cn/html-box/vkWHeJn1Fn2#/slash-commands) |
-| `bots.json` fields / env vars / file locations | [Configuration](https://magic.solutionsuite.cn/html-box/vkWHeJn1Fn2#/bots-json) |
-| Multi-CLI adapters (incl. wrapper / gateway integration) | [Adapters](https://magic.solutionsuite.cn/html-box/vkWHeJn1Fn2#/adapters) |
-| Scenario-based best practices (Oncall / alerting-ops / solo dev / team) | [Best Practices](https://magic.solutionsuite.cn/html-box/vkWHeJn1Fn2#/best-practices) |
-| Common pitfalls / FAQ | [Pitfalls](https://magic.solutionsuite.cn/html-box/vkWHeJn1Fn2#/pitfalls) · [FAQ](https://magic.solutionsuite.cn/html-box/vkWHeJn1Fn2#/faq) |
-| Features: scheduled tasks / Oncall / Dashboard / multi-bot / session relay | [Schedule](https://magic.solutionsuite.cn/html-box/vkWHeJn1Fn2#/schedule) · [Oncall](https://magic.solutionsuite.cn/html-box/vkWHeJn1Fn2#/oncall) · [Dashboard](https://magic.solutionsuite.cn/html-box/vkWHeJn1Fn2#/dashboard) · [Multi-bot](https://magic.solutionsuite.cn/html-box/vkWHeJn1Fn2#/multi-bot) · [Relay](https://magic.solutionsuite.cn/html-box/vkWHeJn1Fn2#/relay) |
+| Slash commands / CLI commands / agent-facing subcommands | [Commands](https://bytedance.aiforce.cloud/app/app_4k9smq6rdxher/slash-commands) |
+| `bots.json` fields / env vars / file locations | [Configuration](https://bytedance.aiforce.cloud/app/app_4k9smq6rdxher/bots-json) |
+| Multi-CLI adapters (incl. wrapper / gateway integration) | [Adapters](https://bytedance.aiforce.cloud/app/app_4k9smq6rdxher/adapters) |
+| Scenario-based best practices (Oncall / alerting-ops / solo dev / team) | [Best Practices](https://bytedance.aiforce.cloud/app/app_4k9smq6rdxher/best-practices) |
+| Common pitfalls / FAQ | [Pitfalls](https://bytedance.aiforce.cloud/app/app_4k9smq6rdxher/pitfalls) · [FAQ](https://bytedance.aiforce.cloud/app/app_4k9smq6rdxher/faq) |
+| Features: scheduled tasks / Oncall / Dashboard / multi-bot / session relay | [Schedule](https://bytedance.aiforce.cloud/app/app_4k9smq6rdxher/schedule) · [Oncall](https://bytedance.aiforce.cloud/app/app_4k9smq6rdxher/oncall) · [Dashboard](https://bytedance.aiforce.cloud/app/app_4k9smq6rdxher/dashboard) · [Multi-bot](https://bytedance.aiforce.cloud/app/app_4k9smq6rdxher/multi-bot) · [Relay](https://bytedance.aiforce.cloud/app/app_4k9smq6rdxher/relay) |
 
 ## Contributing
 

package/README.md

@@ -12,7 +12,7 @@
 </p>
 
 <p align="center">
-  <a href="#设计理念">设计理念</a> · <a href="#核心优势">核心优势</a> · <a href="#5-分钟快速接入">快速接入</a> · <a href="https://magic.solutionsuite.cn/html-box/vkWHeJn1Fn2"><b>📖 文档</b></a>
+  <a href="#设计理念">设计理念</a> · <a href="#核心优势">核心优势</a> · <a href="#5-分钟快速接入">快速接入</a> · <a href="https://bytedance.aiforce.cloud/app/app_4k9smq6rdxher/"><b>📖 文档</b></a>
 </p>
 
 <p align="center">
@@ -23,7 +23,7 @@
 
 **飞书话题群 + AI 编程 CLI，一条消息启动编程会话。** Daemon 监听飞书消息，为每个新话题自动启动独立 CLI 进程（Claude Code / Codex / Cursor / Gemini / OpenCode / Antigravity），提供实时流式卡片和可交互 Web 终端。
 
-> 📖 **完整文档**（命令 / 配置 / 最佳实践 / 排错）：**<https://magic.solutionsuite.cn/html-box/vkWHeJn1Fn2>** ——本 README 只讲为什么用它和怎么快速上手。
+> 📖 **完整文档**（命令 / 配置 / 最佳实践 / 排错）：**<https://bytedance.aiforce.cloud/app/app_4k9smq6rdxher/>** ——本 README 只讲为什么用它和怎么快速上手。
 
 ## 演示
 
@@ -88,7 +88,7 @@ botmux 不重新实现 Agent 能力，而是直接桥接已有的 AI 编程 CLI
 
 ### 多机器人协作
 
-同一台机器上可运行多个飞书机器人，每个机器人可对应不同的 CLI。同一群聊中通过 @mention 路由消息，仅有一个机器人时无需 @ 自动响应；多机器人时 `@<bot1> @<bot2> /t xxx` 可让每个被 @ 的机器人在同一条消息上各自独立开新话题。先发一次 `@<bot1> @<bot2> /introduce` 让它们互相登记 open_id，之后各 bot 就能在自己的会话里显式 @mention 对方协作（命令详见 [📖 文档 · 斜杠命令](https://magic.solutionsuite.cn/html-box/vkWHeJn1Fn2#/slash-commands)）。
+同一台机器上可运行多个飞书机器人，每个机器人可对应不同的 CLI。同一群聊中通过 @mention 路由消息，仅有一个机器人时无需 @ 自动响应；多机器人时 `@<bot1> @<bot2> /t xxx` 可让每个被 @ 的机器人在同一条消息上各自独立开新话题。先发一次 `@<bot1> @<bot2> /introduce` 让它们互相登记 open_id，之后各 bot 就能在自己的会话里显式 @mention 对方协作（命令详见 [📖 文档 · 斜杠命令](https://bytedance.aiforce.cloud/app/app_4k9smq6rdxher/slash-commands)）。
 
 ### 多话题协作模式
 
@@ -326,16 +326,16 @@ PersonalAgent 默认配好事件订阅 + bot 能力，正常情况下不用动
 
 命令、配置、最佳实践、排错的完整内容都在文档站，这里不再重复 ——
 
-### 👉 https://magic.solutionsuite.cn/html-box/vkWHeJn1Fn2
+### 👉 https://bytedance.aiforce.cloud/app/app_4k9smq6rdxher/
 
 | 主题 | 文档 |
 |------|------|
-| 斜杠命令 / CLI 命令 / 会话内子命令 | [命令参考](https://magic.solutionsuite.cn/html-box/vkWHeJn1Fn2#/slash-commands) |
-| `bots.json` 字段 / 环境变量 / 文件位置 | [配置参考](https://magic.solutionsuite.cn/html-box/vkWHeJn1Fn2#/bots-json) |
-| 多 CLI 适配器（含 wrapper / 网关接入） | [适配器](https://magic.solutionsuite.cn/html-box/vkWHeJn1Fn2#/adapters) |
-| 按场景的最佳实践（Oncall / 报警运维 / 个人研发 / 多人协作） | [最佳实践](https://magic.solutionsuite.cn/html-box/vkWHeJn1Fn2#/best-practices) |
-| 常见踩坑 / FAQ 排错 | [踩坑](https://magic.solutionsuite.cn/html-box/vkWHeJn1Fn2#/pitfalls) · [FAQ](https://magic.solutionsuite.cn/html-box/vkWHeJn1Fn2#/faq) |
-| 功能详解：定时任务 / Oncall / Dashboard / 多机器人协作 / 会话接力 | [定时](https://magic.solutionsuite.cn/html-box/vkWHeJn1Fn2#/schedule) · [Oncall](https://magic.solutionsuite.cn/html-box/vkWHeJn1Fn2#/oncall) · [Dashboard](https://magic.solutionsuite.cn/html-box/vkWHeJn1Fn2#/dashboard) · [多 bot](https://magic.solutionsuite.cn/html-box/vkWHeJn1Fn2#/multi-bot) · [接力](https://magic.solutionsuite.cn/html-box/vkWHeJn1Fn2#/relay) |
+| 斜杠命令 / CLI 命令 / 会话内子命令 | [命令参考](https://bytedance.aiforce.cloud/app/app_4k9smq6rdxher/slash-commands) |
+| `bots.json` 字段 / 环境变量 / 文件位置 | [配置参考](https://bytedance.aiforce.cloud/app/app_4k9smq6rdxher/bots-json) |
+| 多 CLI 适配器（含 wrapper / 网关接入） | [适配器](https://bytedance.aiforce.cloud/app/app_4k9smq6rdxher/adapters) |
+| 按场景的最佳实践（Oncall / 报警运维 / 个人研发 / 多人协作） | [最佳实践](https://bytedance.aiforce.cloud/app/app_4k9smq6rdxher/best-practices) |
+| 常见踩坑 / FAQ 排错 | [踩坑](https://bytedance.aiforce.cloud/app/app_4k9smq6rdxher/pitfalls) · [FAQ](https://bytedance.aiforce.cloud/app/app_4k9smq6rdxher/faq) |
+| 功能详解：定时任务 / Oncall / Dashboard / 多机器人协作 / 会话接力 | [定时](https://bytedance.aiforce.cloud/app/app_4k9smq6rdxher/schedule) · [Oncall](https://bytedance.aiforce.cloud/app/app_4k9smq6rdxher/oncall) · [Dashboard](https://bytedance.aiforce.cloud/app/app_4k9smq6rdxher/dashboard) · [多 bot](https://bytedance.aiforce.cloud/app/app_4k9smq6rdxher/multi-bot) · [接力](https://bytedance.aiforce.cloud/app/app_4k9smq6rdxher/relay) |
 
 ## 贡献
 

package/dist/adapters/backend/herdr-backend.d.ts

@@ -0,0 +1,80 @@
+import type { BackendType, SessionBackend, SpawnOpts } from './types.js';
+export type PersistentBackendType = Exclude<BackendType, 'pty'>;
+export interface HerdrExternalTarget {
+    sessionName: string;
+    target: string;
+    paneId?: string;
+}
+export declare class HerdrBackend implements SessionBackend {
+    private readonly sessionName;
+    private readonly opts;
+    private serverProcess;
+    private pollTimer;
+    private statusWaitProcesses;
+    private readonly dataCbs;
+    private readonly exitCbs;
+    private readonly agentName;
+    private paneId;
+    private lastText;
+    private exited;
+    private started;
+    private cols;
+    private rows;
+    private agentProbeFailures;
+    private childEnv;
+    claudeJsonlPath?: string;
+    cliPid?: number;
+    cliCwd?: string;
+    constructor(sessionName: string, opts?: {
+        createSession?: boolean;
+        isReattach?: boolean;
+        externalTarget?: HerdrExternalTarget;
+    });
+    static isAvailable(): boolean;
+    static sessionName(sessionId: string): string;
+    static hasSession(name: string): boolean;
+    static killSession(name: string): void;
+    static listBotmuxSessions(): string[];
+    get isReattach(): boolean;
+    spawn(bin: string, args: string[], opts: SpawnOpts): void;
+    write(data: string): void;
+    sendText(text: string): void;
+    sendSpecialKeys(...keys: string[]): void;
+    pasteText(text: string): void;
+    resize(cols: number, rows: number): void;
+    onData(cb: (data: string) => void): void;
+    onExit(cb: (code: number | null, signal: string | null) => void): void;
+    kill(): void;
+    destroySession(): void;
+    getChildPid(): number | null;
+    getAttachInfo(): null;
+    captureCurrentScreen(): string;
+    captureViewport(): string;
+    getPaneSize(): {
+        cols: number;
+        rows: number;
+    } | null;
+    private ensureServer;
+    private getAgent;
+    private listAgents;
+    private readVisibleAnsi;
+    private readRecentAnsi;
+    private startPolling;
+    private stopPolling;
+    private poll;
+    /** Read herdr pane recent output and emit the delta vs. last snapshot. */
+    private readAndEmitDelta;
+    /**
+     * Spawn one `herdr wait agent-status` child per "result settled" status
+     * (done / blocked / idle). The first to fire wins → we read+emit, then
+     * tear down the losers and re-arm a fresh cohort. Parallel watchers are
+     * needed because the herdr CLI only accepts one --status at a time, and
+     * we genuinely care about all three transitions: `done` is "turn finished
+     * with output", `blocked` is "agent wants user input", `idle` is the
+     * degraded form of done after herdr's UI marks it seen.
+     */
+    private startStatusWatcher;
+    private stopStatusWatcher;
+    private handleExit;
+}
+//# sourceMappingURL=herdr-backend.d.ts.map

package/dist/adapters/backend/herdr-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"herdr-backend.d.ts","sourceRoot":"","sources":["../../../src/adapters/backend/herdr-backend.ts"],"names":[],"mappings":"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"}