weacpx 0.3.1 → 0.4.0-beta.0

package/README.md

@@ -1,6 +1,6 @@
 # weacpx
 
-> 用微信远程驱动 Codex、Claude Code 等 acpx 会话。
+> 用微信、飞书或元宝远程驱动 Codex、Claude Code 等 acpx 会话。
 
 [![npm](https://img.shields.io/npm/v/weacpx?style=flat-square)](https://www.npmjs.com/package/weacpx)
 [![Node.js Version](https://img.shields.io/node/v/weacpx?style=flat-square)](https://nodejs.org)
@@ -11,21 +11,21 @@
 
 ## 这是什么
 
-`weacpx` 是一个微信控制台。它把微信消息接到 `acpx` 会话上，让你直接在手机里：
+`weacpx` 是一个可以通过微信、飞书或元宝直接控制 Codex / Claude Code / Gemini / OpenCode 的工具。它把聊天消息通过 `acpx` 连接到 Agent CLI 会话上，让你直接在手机里：
 
-- 新建和切换 Codex / Claude Code 会话
+- 新建和切换会话
 - 让 Agent 继续在指定项目目录里工作
 - 查看流式回复、最终结果和工具调用摘要
 - 调整权限策略
-- 在需要时做最小可用的多 Agent 编排
+- 在需要时做多 Agent 编排
 
-如果你已经习惯在本地终端里用 `acpx`，`weacpx` 提供的是一个**远程入口**，而不是另一套全新的工作流。
+如果你需要临时远程编码或办公，`weacpx` 提供的是一个方便快捷的**远程入口**，让你在微信或飞书里就能随时随地干活。
 
 ## 适合谁
 
-`weacpx` 适合已经在用 Codex、Claude Code 或其他 `acpx` driver 的开发者。你可以用微信盯任务、发指令、看结果，并在同一个聊天里管理多个会话。
+`weacpx` 适合轻量临时使用多 Agent 办公的用户。你可以用微信、飞书或元宝盯任务、发指令、看结果，并在同一个聊天里管理多个会话。
 
-它不是云端 IDE，也不是可视化编排平台。
+> `weacpx` 的会话是跟本地隔离的，它目前还不能使用 CLI 已有的会话，你在 weacpx 也无法看到本地的 CLI 会话记录。
 
 ## 5 分钟快速开始
 
@@ -34,15 +34,15 @@
 开始前，你至少需要：
 
 - Node.js 22+ 或 Bun
-- 已可用的 Codex、Claude Code 或其他 `acpx` driver
-- 一台装了微信的手机
+- 已可用的 Codex / Claude Code / Gemini / OpenCode
+- 一台装了微信、飞书或元宝的手机
 
-> `weacpx` 基于 `weixin-agent-sdk` 和 `acpx` 工作。正常情况下，你不需要额外全局安装 `acpx`。
+> 微信频道基于 `weixin-agent-sdk` 工作，飞书频道使用飞书自建应用凭据，元宝频道使用 `appKey` / `appSecret`；底层 Agent 会话由 `acpx` 驱动。正常情况下，你不需要额外全局安装 `acpx`。
 
 ### 安装
 
 ```bash
-npm install -g weacpx
+npm install -g weacpx --registry=https://registry.npmjs.org
 # 或
 bun add -g weacpx
 ```
@@ -53,7 +53,9 @@ bun add -g weacpx
 weacpx login
 ```
 
-终端会显示二维码。你用微信扫码登录。
+终端会显示二维码，请继续用微信扫码登录。
+
+如果你想使用飞书或元宝而不是微信，请先看下面的“切换/添加其它频道”。
 
 ### 启动服务
 
@@ -78,6 +80,29 @@ hello
 
 如果一切正常，普通文本会进入当前会话，Agent 的回复会回到微信。
 
+### 切换/添加其它频道
+
+微信是内置默认频道。飞书和元宝以官方插件包分发，第三方频道也走同样的插件流程。如果记不住包名，先看一眼官方插件清单：
+
+```bash
+weacpx plugin known
+# 安装：weacpx plugin add <package>
+```
+
+```bash
+# 飞书
+weacpx plugin add @ganglion/weacpx-channel-feishu
+weacpx channel add feishu     # 按提示输入 appId/appSecret
+weacpx restart
+
+# 元宝
+weacpx plugin add @ganglion/weacpx-channel-yuanbao
+weacpx channel add yuanbao    # 按提示输入 appKey/appSecret
+weacpx restart
+```
+
+完整的密钥配置、参数、`enable/disable/rm` 等管理命令见 [docs/channel-management.md](./docs/channel-management.md)。如果你想自己写一个频道插件，见 [docs/plugin-development.md](./docs/plugin-development.md)。
+
 ## 你的日常使用流程
 
 最常见的使用顺序只有四步：
@@ -85,7 +110,7 @@ hello
 1. **启动后台服务**：`weacpx start`
 2. **创建或切换会话**：`/ss ...`、`/use ...`
 3. **直接发普通文本**：让当前会话继续工作
-4. **必要时查看状态或取消**：`/status`、`/cancel`
+4. **必要时查看状态或取消当前任务**：`/status`、`/cancel`
 
 ### 1) 创建会话
 
@@ -95,7 +120,7 @@ hello
 /ss codex -d /absolute/path/to/your/repo
 ```
 
-它会使用 `codex`，绑定这个目录，并自动切换到新会话。
+它会使用 `codex`，绑定这个工作目录，并自动切换到新会话。
 
 ### 2) 发普通消息
 
@@ -109,9 +134,9 @@ hello
 
 `weacpx` 支持三种常用回复模式：
 
-- `stream`：默认，流式返回中间文本
+- `stream`：流式返回中间文本
 - `final`：只返回最终结果
-- `verbose`：在流式文本之外，额外显示工具调用摘要
+- `verbose`：默认，在流式文本之外，额外显示工具调用摘要
 
 例如 `verbose` 模式下，你会看到：
 
@@ -143,6 +168,11 @@ hello
 | `weacpx start` | 后台启动服务 |
 | `weacpx status` | 查看后台状态、PID、配置路径、日志路径 |
 | `weacpx stop` | 停止后台实例 |
+| `weacpx restart` | 重启后台实例，让频道配置变更生效 |
+| `weacpx channel list` | 查看已配置的消息频道 |
+| `weacpx plugin known` | 查看官方插件清单（飞书/元宝包名） |
+| `weacpx plugin add @ganglion/weacpx-channel-feishu && weacpx channel add feishu` | 安装并添加飞书频道，会提示输入飞书应用凭据 |
+| `weacpx plugin add @ganglion/weacpx-channel-yuanbao && weacpx channel add yuanbao` | 安装并添加元宝频道，会提示输入元宝 appKey/appSecret |
 | `weacpx doctor` | 运行环境诊断 |
 | `weacpx version` | 查看当前版本 |
 | `weacpx workspace list` | 查看本机已注册的 workspace |
@@ -206,19 +236,21 @@ weacpx doctor --smoke --agent codex --workspace backend
 - `--agent` / `--workspace` 只影响 `--smoke`
 - 如果不传 `--smoke`，相关检查会显示为 `SKIP`
 
-## 常用微信命令
+## 常用聊天命令
 
-下面这部分保留一份**中等长度**的日常手册。够你上手和日常使用，但不把 README 写成完整参考手册。
-
-完整微信命令参考见：[docs/commands.md](./docs/commands.md)。
+这些命令在微信或飞书聊天里发送。完整命令参考见：[docs/commands.md](./docs/commands.md)。
 
 ### Agent 管理
 
+已内置常用的 Codex 与 Claude Code；
+
+可以使用 `/agent add opencode` 添加你所需要的 agents。
+
 | 命令 | 说明 |
 |------|------|
 | `/agents` | 查看 agent 列表 |
-| `/agent add codex` | 添加 `codex` |
-| `/agent add claude` | 添加 `claude` |
+| `/agent add gemini` | 添加 `Gemini` Agent |
+| `/agent add opencode` | 添加 `OpenCode` Agent |
 | `/agent rm <name>` | 删除 agent |
 
 ### Workspace 管理
@@ -226,7 +258,7 @@ weacpx doctor --smoke --agent codex --workspace backend
 | 命令 | 说明 |
 |------|------|
 | `/workspaces` / `/workspace` / `/ws` | 查看 workspace 列表 |
-| `/ws new <name> -d <path>` | 添加 workspace，`path` 是电脑上的绝对路径 |
+| `/ws new <name> -d <path>` | 添加 workspace，`path` 是电脑上的绝对路径，Windows 不用区分正反斜杠 |
 | `/workspace rm <name>` | 删除 workspace |
 
 ### Session 会话
@@ -246,7 +278,7 @@ weacpx doctor --smoke --agent codex --workspace backend
 | `/replymode reset` | 回退到全局默认 reply mode |
 | `/session reset` | 重置当前会话上下文 |
 | `/clear` | `/session reset` 的快捷别名 |
-| `/cancel` / `/stop` | 取消当前会话 |
+| `/cancel` / `/stop` | 停止当前任务 |
 
 建议你优先记住这三个：
 
@@ -260,7 +292,7 @@ weacpx doctor --smoke --agent codex --workspace backend
 
 | 命令 | 说明 |
 |------|------|
-| `/config` | 查看支持通过微信修改的配置路径 |
+| `/config` | 查看支持通过聊天命令修改的配置路径 |
 | `/config set <path> <value>` | 修改一个白名单配置项 |
 | `/pm` / `/permission` | 查看当前权限模式 |
 | `/pm set allow` | 切到 `approve-all` |
@@ -316,6 +348,55 @@ README 里只保留用户视角的最常用命令。
 
 - [docs/weacpx-group-usage-guide.md](./docs/weacpx-group-usage-guide.md)
 
+
+### MCP 集成：外部 coordinator
+
+如果你想让 Codex、Claude Code 等外部 MCP host 直接使用 weacpx 的多 Agent 编排能力，可以把 `weacpx mcp-stdio` 配成一个 stdio MCP server。
+
+先启动 daemon：
+
+```bash
+weacpx start
+```
+
+MCP 配置推荐保持简单，不要在启动参数里绑定 workspace：
+
+```json
+{
+  "mcpServers": {
+    "weacpx": {
+      "command": "weacpx",
+      "args": ["mcp-stdio"]
+    }
+  }
+}
+```
+
+外部 host 调用 `delegate_request` 时传 `workingDirectory`，weacpx 会让被委派的 worker 在这个目录工作：
+
+```json
+{
+  "targetAgent": "claude",
+  "task": "审查这个改动的风险点",
+  "workingDirectory": "/absolute/path/to/your/repo"
+}
+```
+
+Windows 上如果 MCP host 不会帮你解析带参数的 `command`，把 `node.exe` 放在 `command`，把 weacpx 脚本和参数放在 `args`：
+
+```json
+{
+  "type": "stdio",
+  "command": "D:\\Users\\you\\.nvmd\\versions\\22.19.0\\node.exe",
+  "args": [
+    "E:\\projects\\weacpx\\dist\\cli.js",
+    "mcp-stdio"
+  ]
+}
+```
+
+更多身份规则、`workingDirectory` 语义、工具列表、流程图和故障排查见：[docs/external-mcp.md](./docs/external-mcp.md)。
+
 ## 常见场景
 
 ### 在手机上继续盯一个本地项目
@@ -395,12 +476,14 @@ bun run dev
 
 ### 安装与配置
 
+- 想配置微信、飞书、元宝、或第三方插件频道：[docs/channel-management.md](./docs/channel-management.md)
+- 想自己写一个频道插件：[docs/plugin-development.md](./docs/plugin-development.md)
 - 想看完整配置字段：[docs/config-reference.md](./docs/config-reference.md)
 - 想在微信里改配置：[docs/config-command.md](./docs/config-command.md)
 
 ### 日常使用
 
-- 想查看完整微信命令参考：[docs/commands.md](./docs/commands.md)
+- 想查看完整聊天命令参考：[docs/commands.md](./docs/commands.md)
 - 想理解什么时候该用 delegate、什么时候该开 group：[docs/weacpx-group-usage-guide.md](./docs/weacpx-group-usage-guide.md)
 
 ### 排错与验证

package/config.example.json

@@ -11,9 +11,16 @@
     "maxFiles": 5,
     "retentionDays": 7
   },
-  "wechat": {
+  "channel": {
     "replyMode": "stream"
   },
+  "channels": [
+    {
+      "id": "weixin",
+      "type": "weixin",
+      "enabled": true
+    }
+  ],
   "agents": {
     "codex": {
       "driver": "codex"

package/dist/bridge/bridge-main.js

@@ -212,6 +212,137 @@ var init_spawn_command = __esm(() => {
   SCRIPT_FILE_PATTERN = /\.(c|m)?js$/i;
 });
 
+// src/transport/prompt-media.ts
+import { mkdtemp, open, rm, writeFile } from "node:fs/promises";
+import { tmpdir as defaultTmpdir } from "node:os";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+async function createStructuredPromptFile(text, media, deps = defaultStructuredPromptFileDeps) {
+  const mediaList = normalizePromptMedia(media);
+  if (mediaList.length === 0) {
+    return null;
+  }
+  const blocks = [];
+  if (text.trim().length > 0) {
+    blocks.push({ type: "text", text });
+  }
+  const nonImages = mediaList.filter((item) => item.type !== "image");
+  if (nonImages.length > 0) {
+    blocks.push({ type: "text", text: buildAttachmentSummary(nonImages) });
+  }
+  for (const item of mediaList) {
+    if (item.type === "image") {
+      const imageData = await deps.readImageFile(item.filePath, MAX_STRUCTURED_IMAGE_BYTES);
+      if (imageData.byteLength === 0)
+        throw new Error("image prompt must not be empty");
+      if (imageData.byteLength > MAX_STRUCTURED_IMAGE_BYTES) {
+        throw new Error(`image prompt exceeds ${MAX_STRUCTURED_IMAGE_BYTES} bytes`);
+      }
+      blocks.push({
+        type: "image",
+        mimeType: resolveImageMimeType(imageData, item.mimeType),
+        data: imageData.toString("base64")
+      });
+      continue;
+    }
+    blocks.push({
+      type: "resource",
+      resource: {
+        uri: pathToFileURL(item.filePath).toString(),
+        text: `${item.fileName ?? path.basename(item.filePath)} ${item.mimeType} ${item.type}`
+      }
+    });
+  }
+  return await writeStructuredPromptBlocks(blocks, deps);
+}
+function normalizePromptMedia(media) {
+  if (!media)
+    return [];
+  return Array.isArray(media) ? media : [media];
+}
+function buildAttachmentSummary(items) {
+  const lines = ["Attachments available as local files:"];
+  for (const [index, item] of items.entries()) {
+    lines.push(`${index + 1}. ${item.type} ${item.fileName ?? path.basename(item.filePath)} ${item.mimeType} ${item.filePath}`);
+  }
+  return lines.join(`
+`);
+}
+async function writeStructuredPromptBlocks(blocks, deps) {
+  let dir = "";
+  try {
+    dir = await deps.mkdtemp(path.join(deps.tmpdir(), "weacpx-acp-prompt-"));
+    const filePath = path.join(dir, "prompt.json");
+    await deps.writeFile(filePath, JSON.stringify(blocks), "utf8");
+    return { filePath, cleanup: async () => deps.rm(dir, { recursive: true, force: true }) };
+  } catch (error) {
+    if (dir)
+      await deps.rm(dir, { recursive: true, force: true }).catch(() => {});
+    throw error;
+  }
+}
+async function readImageFileBounded(filePath, maxBytes) {
+  const handle = await open(filePath, "r");
+  try {
+    const imageStats = await handle.stat();
+    if (!imageStats.isFile()) {
+      throw new Error("image prompt path must be a regular file");
+    }
+    if (imageStats.size > maxBytes) {
+      throw new Error(`image prompt exceeds ${maxBytes} bytes`);
+    }
+    const chunks = [];
+    let total = 0;
+    let position = 0;
+    const chunkSize = 1024 * 1024;
+    while (total <= maxBytes) {
+      const buffer = Buffer.allocUnsafe(Math.min(chunkSize, maxBytes + 1 - total));
+      const { bytesRead } = await handle.read(buffer, 0, buffer.length, position);
+      if (bytesRead === 0)
+        break;
+      chunks.push(buffer.subarray(0, bytesRead));
+      total += bytesRead;
+      position += bytesRead;
+    }
+    return Buffer.concat(chunks, total);
+  } finally {
+    await handle.close();
+  }
+}
+function resolveImageMimeType(buffer, declaredMimeType) {
+  if (/^image\/[A-Za-z0-9.+-]+$/.test(declaredMimeType) && declaredMimeType !== "image/*") {
+    return declaredMimeType;
+  }
+  if (buffer.subarray(0, 8).equals(Buffer.from("89504e470d0a1a0a", "hex"))) {
+    return "image/png";
+  }
+  if (buffer.length >= 3 && buffer[0] === 255 && buffer[1] === 216 && buffer[2] === 255) {
+    return "image/jpeg";
+  }
+  const header6 = buffer.subarray(0, 6).toString("ascii");
+  if (header6 === "GIF87a" || header6 === "GIF89a") {
+    return "image/gif";
+  }
+  if (buffer.length >= 12 && buffer.subarray(0, 4).toString("ascii") === "RIFF" && buffer.subarray(8, 12).toString("ascii") === "WEBP") {
+    return "image/webp";
+  }
+  if (buffer.length >= 2 && buffer.subarray(0, 2).toString("ascii") === "BM") {
+    return "image/bmp";
+  }
+  return "image/png";
+}
+var MAX_STRUCTURED_IMAGE_BYTES, defaultStructuredPromptFileDeps;
+var init_prompt_media = __esm(() => {
+  MAX_STRUCTURED_IMAGE_BYTES = 100 * 1024 * 1024;
+  defaultStructuredPromptFileDeps = {
+    readImageFile: readImageFileBounded,
+    mkdtemp,
+    writeFile,
+    rm,
+    tmpdir: defaultTmpdir
+  };
+});
+
 // src/transport/streaming-prompt.ts
 function createStreamingPromptState(formatToolCalls = false) {
   return {
@@ -417,9 +548,9 @@ function isUnder(child, parent) {
   const p = parent.replace(/[\\/]+$/, "");
   return c === p || c.startsWith(p + "/") || c.startsWith(p + "\\");
 }
-async function defaultFsExists(path) {
+async function defaultFsExists(path2) {
   try {
-    await access(path);
+    await access(path2);
     return true;
   } catch {
     return false;
@@ -787,6 +918,7 @@ class BridgeRequestScheduler {
 // src/bridge/bridge-runtime.ts
 init_spawn_command();
 init_prompt_output();
+init_prompt_media();
 init_streaming_prompt();
 import { copyFile, readdir } from "node:fs/promises";
 import { homedir as homedir3 } from "node:os";
@@ -933,15 +1065,22 @@ class BridgeRuntime {
   }
   async prompt(input, onEvent) {
     await this.launchMcpQueueOwnerIfNeeded(input);
+    const structuredPrompt = await createStructuredPromptFile(input.text, input.media);
     const spawnSpec = resolveSpawnCommand(this.command, this.buildPromptArgs(input, [
       "prompt",
       "-s",
       input.name,
-      input.text
+      ...structuredPrompt ? ["--file", structuredPrompt.filePath] : [input.text]
     ]));
     const formatToolCalls = input.replyMode === "verbose";
-    const result = onEvent ? await this.runPromptCommand(spawnSpec.command, spawnSpec.args, onEvent, { formatToolCalls }) : await this.run(spawnSpec.command, spawnSpec.args);
-    return { text: getPromptText(result) };
+    try {
+      const result = onEvent ? await this.runPromptCommand(spawnSpec.command, spawnSpec.args, onEvent, { formatToolCalls }) : await this.run(spawnSpec.command, spawnSpec.args);
+      return { text: getPromptText(result) };
+    } finally {
+      try {
+        await structuredPrompt?.cleanup();
+      } catch {}
+    }
   }
   async launchMcpQueueOwnerIfNeeded(input) {
     if (!input.mcpCoordinatorSession) {
@@ -1335,6 +1474,7 @@ class BridgeServer {
           }
         });
       case "prompt":
+        const media = asOptionalPromptMediaInput(params.media);
         return await this.runtime.prompt({
           agent: requireString(params, "agent"),
           agentCommand: asOptionalString(params.agentCommand),
@@ -1342,8 +1482,9 @@ class BridgeServer {
           name: requireString(params, "name"),
           mcpCoordinatorSession: asOptionalString(params.mcpCoordinatorSession),
           mcpSourceHandle: asOptionalString(params.mcpSourceHandle),
-          text: requireString(params, "text"),
-          replyMode: asOptionalReplyMode(params.replyMode)
+          text: requirePromptText(params, media),
+          replyMode: asOptionalReplyMode(params.replyMode),
+          media
         }, (event) => {
           if (event.type === "prompt.segment") {
             writeLine?.(encodeBridgePromptSegmentEvent({
@@ -1449,6 +1590,17 @@ function requireString(params, key) {
   }
   return value;
 }
+function requirePromptText(params, media) {
+  const value = params.text;
+  if (typeof value !== "string") {
+    throw new BridgeInvalidRequestError("text must be a non-empty string");
+  }
+  const hasMedia = Array.isArray(media) ? media.length > 0 : Boolean(media);
+  if (value.length === 0 && !hasMedia) {
+    throw new BridgeInvalidRequestError("text must be a non-empty string unless media is provided");
+  }
+  return value;
+}
 function requirePermissionMode(params, key) {
   const value = params[key];
   if (value === "approve-all" || value === "approve-reads" || value === "deny-all") {
@@ -1469,6 +1621,35 @@ function asOptionalString(value) {
   }
   return value;
 }
+function asOptionalPromptMediaInput(value) {
+  if (value === undefined)
+    return;
+  if (Array.isArray(value))
+    return value.map(asPromptMedia);
+  return asPromptMedia(value);
+}
+function asPromptMedia(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw new BridgeInvalidRequestError("media must be an object or array of objects when provided");
+  }
+  const record = value;
+  const type = record.type;
+  if (type !== "image" && type !== "audio" && type !== "video" && type !== "file") {
+    throw new BridgeInvalidRequestError("media.type must be image, audio, video, or file");
+  }
+  if (typeof record.filePath !== "string" || record.filePath.trim().length === 0) {
+    throw new BridgeInvalidRequestError("media.filePath must be a non-empty string");
+  }
+  if (typeof record.mimeType !== "string" || record.mimeType.trim().length === 0) {
+    throw new BridgeInvalidRequestError("media.mimeType must be a non-empty string");
+  }
+  return {
+    type,
+    filePath: record.filePath,
+    mimeType: record.mimeType,
+    ...typeof record.fileName === "string" && record.fileName ? { fileName: record.fileName } : {}
+  };
+}
 var VALID_REPLY_MODES = new Set(["stream", "final", "verbose"]);
 function asOptionalReplyMode(value) {
   if (typeof value !== "string" || !VALID_REPLY_MODES.has(value)) {

package/dist/channels/channel-scope.d.ts

@@ -0,0 +1,9 @@
+export declare function registerKnownChannelId(channelId: string): void;
+export declare function listKnownChannelIds(): string[];
+export declare function getChannelIdFromChatKey(chatKey: string): string;
+export declare function isLegacyWeixinChatKey(chatKey: string): boolean;
+export declare function toInternalSessionAlias(channelId: string, displayAlias: string): string;
+export declare function toDisplaySessionAlias(internalAlias: string): string;
+export declare function isSessionAliasVisibleInChannel(alias: string, channelId: string): boolean;
+export declare function resolveSessionAliasForInput(channelId: string, displayAlias: string, existingAliases: Iterable<string>): string;
+export declare function buildDefaultTransportSession(channelId: string, displayAlias: string): string;

package/dist/channels/cli/provider.d.ts

@@ -0,0 +1,73 @@
+import type { ChannelRuntimeConfig } from "../../config/types";
+export type ChannelCliInput = Record<string, string | boolean | undefined>;
+export type ChannelCliParseResult = {
+    ok: true;
+    input: ChannelCliInput;
+} | {
+    ok: false;
+    message: string;
+};
+export type ChannelCliValidationIssue = {
+    kind: "missing-required-field";
+    flag: string;
+    message: string;
+} | {
+    kind: "invalid-config";
+    message: string;
+};
+export interface ChannelCliIo {
+    print: (line: string) => void;
+    stderr: (text: string) => void;
+    isInteractive: () => boolean;
+    promptText: (message: string) => Promise<string>;
+    promptSecret: (message: string) => Promise<string>;
+}
+export interface ChannelCliProvider {
+    type: string;
+    displayName: string;
+    supportsLogin: boolean;
+    parseAddArgs(args: string[]): ChannelCliParseResult;
+    buildDefaultConfig(input: ChannelCliInput): ChannelRuntimeConfig;
+    validateConfig(config: ChannelRuntimeConfig): ChannelCliValidationIssue[];
+    renderSummary(config: ChannelRuntimeConfig): string[];
+    promptForMissingFields(input: ChannelCliInput, io: ChannelCliIo): Promise<ChannelCliInput>;
+    /**
+     * Optional: declares this plugin supports the `weacpx channel ... --account <id>`
+     * multi-bot CLI surface. Plugins that opt in must also implement
+     * {@link buildAccountOverride} and {@link channelLevelOptionKeys}.
+     */
+    supportsMultipleAccounts?: boolean;
+    /**
+     * Optional: builds the per-account override object that core nests under
+     * `options.accounts.<accountId>`. Should NOT include channel-level fields
+     * (those live on top-level `options`).
+     */
+    buildAccountOverride?(input: ChannelCliInput): Record<string, unknown>;
+    /**
+     * Optional: option keys that stay on top-level `options` (not duplicated into
+     * each account). Used to migrate a legacy flat single-bot config into the
+     * accounts shape on first `--account` add.
+     */
+    channelLevelOptionKeys?: readonly string[];
+    /**
+     * Optional: renders summary lines for a single account inside a multi-bot
+     * channel. Falls back to {@link renderSummary} on the whole channel when
+     * unspecified.
+     */
+    renderAccountSummary?(config: ChannelRuntimeConfig, accountId: string): string[] | null;
+}
+export declare function parseBooleanFlag(value: string, flagName: string): {
+    ok: true;
+    value: boolean;
+} | {
+    ok: false;
+    message: string;
+};
+export declare function takeFlagValue(args: string[], index: number, flagName: string): {
+    ok: true;
+    value: string;
+    nextIndex: number;
+} | {
+    ok: false;
+    message: string;
+};

package/dist/channels/cli/registry.d.ts

@@ -0,0 +1,7 @@
+import type { ChannelCliProvider } from "./provider";
+export declare function registerChannelCliProvider(provider: ChannelCliProvider): void;
+export declare function hasChannelCliProvider(type: string): boolean;
+export declare function getRegisteredChannelCliProviderTypes(): string[];
+export declare function bootstrapBuiltinChannelCliProviders(): void;
+export declare function listChannelCliProviders(): ChannelCliProvider[];
+export declare function getChannelCliProvider(type: string): ChannelCliProvider | null;

package/dist/channels/cli/weixin-provider.d.ts

@@ -0,0 +1,2 @@
+import type { ChannelCliProvider } from "./provider";
+export declare const weixinCliProvider: ChannelCliProvider;

package/dist/channels/create-channel.d.ts

@@ -0,0 +1,16 @@
+import type { ChannelConfig, ChannelRuntimeConfig } from "../config/types.js";
+import type { MessageChannelRuntime } from "./types.js";
+import type { RuntimeMediaStore } from "./media-store.js";
+export declare function getMovedChannelInstallHint(type: string): string | null;
+export interface CreateChannelDeps {
+    mediaStore?: RuntimeMediaStore;
+    allowedMediaRoots?: string[];
+}
+export type ChannelFactory = (options: Record<string, unknown> | undefined, deps?: CreateChannelDeps) => MessageChannelRuntime;
+export declare function registerChannelFactory(type: string, factory: ChannelFactory): void;
+export declare function hasChannelFactory(type: string): boolean;
+export declare function getRegisteredChannelTypes(): string[];
+export declare function bootstrapBuiltinChannelFactories(): void;
+export declare function createMessageChannel(type: string, config?: Partial<ChannelConfig>, deps?: CreateChannelDeps): MessageChannelRuntime;
+export declare function createMessageChannelFromRuntimeConfig(config: ChannelRuntimeConfig, deps?: CreateChannelDeps): MessageChannelRuntime;
+export declare function createMessageChannels(configs: ChannelRuntimeConfig[], deps?: CreateChannelDeps): MessageChannelRuntime[];

package/dist/channels/media-store.d.ts

@@ -0,0 +1,29 @@
+import type { ChannelId, ChannelMediaAttachment, ChannelMediaKind } from "./media-types";
+export declare const DEFAULT_IMAGE_MAX_BYTES: number;
+export declare const DEFAULT_ATTACHMENT_MAX_BYTES: number;
+export declare const DEFAULT_MAX_ATTACHMENTS_PER_MESSAGE = 10;
+export declare const DEFAULT_MEDIA_RETENTION_MS: number;
+export interface RuntimeMediaStoreOptions {
+    rootDir: string;
+    retentionMs?: number;
+}
+export interface SaveMediaBufferInput {
+    channelId: ChannelId;
+    accountId: string;
+    chatKey: string;
+    messageId: string;
+    fileName?: string;
+    mimeType: string;
+    kind: ChannelMediaKind;
+    buffer: Buffer;
+    sourceResourceId?: string;
+    maxBytes: number;
+}
+export declare class RuntimeMediaStore {
+    readonly rootDir: string;
+    readonly retentionMs: number;
+    constructor(options: RuntimeMediaStoreOptions);
+    saveMediaBuffer(input: SaveMediaBufferInput): Promise<ChannelMediaAttachment>;
+    cleanupExpired(now?: Date): Promise<void>;
+}
+export declare function sanitizeMediaFileName(fileName: string, mimeType: string): string;