weacpx 0.3.2 → 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,7 +11,7 @@
 
 ## 这是什么
 
-`weacpx` 是一个可以通过微信直接控制 Codex / Claude Code / Gemini / OpenCode 的工具。它把微信消息通过 `acpx` 连接到 Agent CLI 会话上，让你直接在手机里：
+`weacpx` 是一个可以通过微信、飞书或元宝直接控制 Codex / Claude Code / Gemini / OpenCode 的工具。它把聊天消息通过 `acpx` 连接到 Agent CLI 会话上，让你直接在手机里：
 
 - 新建和切换会话
 - 让 Agent 继续在指定项目目录里工作
@@ -19,11 +19,11 @@
 - 调整权限策略
 - 在需要时做多 Agent 编排
 
-如果你需要临时远程编码或办公，`weacpx` 提供的是一个方便快捷的**远程入口**，让你在微信里就能随时随地干活。
+如果你需要临时远程编码或办公，`weacpx` 提供的是一个方便快捷的**远程入口**，让你在微信或飞书里就能随时随地干活。
 
 ## 适合谁
 
-`weacpx` 适合轻量临时使用多 Agent 办公的用户。你可以用微信盯任务、发指令、看结果，并在同一个聊天里管理多个会话。
+`weacpx` 适合轻量临时使用多 Agent 办公的用户。你可以用微信、飞书或元宝盯任务、发指令、看结果，并在同一个聊天里管理多个会话。
 
 > `weacpx` 的会话是跟本地隔离的，它目前还不能使用 CLI 已有的会话，你在 weacpx 也无法看到本地的 CLI 会话记录。
 
@@ -35,9 +35,9 @@
 
 - Node.js 22+ 或 Bun
 - 已可用的 Codex / Claude Code / Gemini / OpenCode
-- 一台装了微信的手机
+- 一台装了微信、飞书或元宝的手机
 
-> `weacpx` 基于 `weixin-agent-sdk` 和 `acpx` 工作。正常情况下，你不需要额外全局安装 `acpx`。
+> 微信频道基于 `weixin-agent-sdk` 工作，飞书频道使用飞书自建应用凭据，元宝频道使用 `appKey` / `appSecret`；底层 Agent 会话由 `acpx` 驱动。正常情况下，你不需要额外全局安装 `acpx`。
 
 ### 安装
 
@@ -55,6 +55,8 @@ weacpx login
 
 终端会显示二维码，请继续用微信扫码登录。
 
+如果你想使用飞书或元宝而不是微信，请先看下面的“切换/添加其它频道”。
+
 ### 启动服务
 
 ```bash
@@ -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)。
+
 ## 你的日常使用流程
 
 最常见的使用顺序只有四步：
@@ -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,9 +236,9 @@ weacpx doctor --smoke --agent codex --workspace backend
 - `--agent` / `--workspace` 只影响 `--smoke`
 - 如果不传 `--smoke`，相关检查会显示为 `SKIP`
 
-## 常用微信命令
+## 常用聊天命令
 
-完整微信命令参考见：[docs/commands.md](./docs/commands.md)。
+这些命令在微信或飞书聊天里发送。完整命令参考见：[docs/commands.md](./docs/commands.md)。
 
 ### Agent 管理
 
@@ -262,7 +292,7 @@ weacpx doctor --smoke --agent codex --workspace backend
 
 | 命令 | 说明 |
 |------|------|
-| `/config` | 查看支持通过微信修改的配置路径 |
+| `/config` | 查看支持通过聊天命令修改的配置路径 |
 | `/config set <path> <value>` | 修改一个白名单配置项 |
 | `/pm` / `/permission` | 查看当前权限模式 |
 | `/pm set allow` | 切到 `approve-all` |
@@ -446,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

@@ -216,46 +216,68 @@ var init_spawn_command = __esm(() => {
 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) {
-  if (!media) {
+  const mediaList = normalizePromptMedia(media);
+  if (mediaList.length === 0) {
     return null;
   }
-  if (media.type !== "image") {
-    throw new Error("prompt media type is not supported; only image media is supported");
-  }
-  const imageData = await deps.readImageFile(media.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`);
-  }
   const blocks = [];
   if (text.trim().length > 0) {
     blocks.push({ type: "text", text });
   }
-  blocks.push({
-    type: "image",
-    mimeType: resolveImageMimeType(imageData, media.mimeType),
-    data: imageData.toString("base64")
-  });
+  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 () => {
-        await deps.rm(dir, { recursive: true, force: true });
-      }
-    };
+    return { filePath, cleanup: async () => deps.rm(dir, { recursive: true, force: true }) };
   } catch (error) {
-    if (dir) {
-      try {
-        await deps.rm(dir, { recursive: true, force: true });
-      } catch {}
-    }
+    if (dir)
+      await deps.rm(dir, { recursive: true, force: true }).catch(() => {});
     throw error;
   }
 }
@@ -1452,7 +1474,7 @@ class BridgeServer {
           }
         });
       case "prompt":
-        const media = asOptionalPromptMedia(params.media);
+        const media = asOptionalPromptMediaInput(params.media);
         return await this.runtime.prompt({
           agent: requireString(params, "agent"),
           agentCommand: asOptionalString(params.agentCommand),
@@ -1573,8 +1595,9 @@ function requirePromptText(params, media) {
   if (typeof value !== "string") {
     throw new BridgeInvalidRequestError("text must be a non-empty string");
   }
-  if (value.length === 0 && media?.type !== "image") {
-    throw new BridgeInvalidRequestError("text must be a non-empty string unless image media is provided");
+  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;
 }
@@ -1598,31 +1621,33 @@ function asOptionalString(value) {
   }
   return value;
 }
-function asOptionalPromptMedia(value) {
-  if (value === undefined) {
+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 when provided");
+    throw new BridgeInvalidRequestError("media must be an object or array of objects when provided");
   }
   const record = value;
   const type = record.type;
-  const filePath = record.filePath;
-  const mimeType = record.mimeType;
-  if (type !== "image") {
-    throw new BridgeInvalidRequestError("media.type must be image");
+  if (type !== "image" && type !== "audio" && type !== "video" && type !== "file") {
+    throw new BridgeInvalidRequestError("media.type must be image, audio, video, or file");
   }
-  if (typeof filePath !== "string" || filePath.length === 0) {
+  if (typeof record.filePath !== "string" || record.filePath.trim().length === 0) {
     throw new BridgeInvalidRequestError("media.filePath must be a non-empty string");
   }
-  if (typeof mimeType !== "string" || mimeType.length === 0) {
+  if (typeof record.mimeType !== "string" || record.mimeType.trim().length === 0) {
     throw new BridgeInvalidRequestError("media.mimeType must be a non-empty string");
   }
   return {
     type,
-    filePath,
-    mimeType,
-    ...typeof record.fileName === "string" && record.fileName.length > 0 ? { fileName: record.fileName } : {}
+    filePath: record.filePath,
+    mimeType: record.mimeType,
+    ...typeof record.fileName === "string" && record.fileName ? { fileName: record.fileName } : {}
   };
 }
 var VALID_REPLY_MODES = new Set(["stream", "final", "verbose"]);

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;

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

@@ -0,0 +1,28 @@
+export type ChannelId = string;
+export type ChannelMediaKind = "image" | "file" | "audio" | "video";
+export interface ChannelMediaAttachment {
+    kind: ChannelMediaKind;
+    /** @deprecated Legacy field — prefer `kind`. Kept for backward compat during migration. */
+    type?: string;
+    filePath: string;
+    mimeType: string;
+    fileName?: string;
+    sizeBytes: number;
+    source: {
+        channelId: ChannelId;
+        accountId: string;
+        chatKey: string;
+        messageId: string;
+        resourceId?: string;
+    };
+}
+export interface OutboundChannelMedia {
+    kind: ChannelMediaKind;
+    filePath: string;
+    mimeType?: string;
+    fileName?: string;
+    caption?: string;
+}
+export type MaybeArray<T> = T | T[] | undefined;
+export declare function normalizeMediaArray<T>(media: MaybeArray<T>): T[];
+export declare function firstMediaOrUndefined<T>(media: T[]): T | undefined;

package/dist/channels/outbound-media-safety.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Resolve an outbound media file path to a safe absolute realpath.
+ * Rejects remote URLs, non-existent paths, symlinks that escape allowed roots,
+ * and paths outside all allowed root directories.
+ * Returns the resolved realpath on success, or null on rejection.
+ */
+export declare function resolveSafeOutboundMediaPath(mediaPath: string, allowedRoots: string[]): Promise<string | null>;

package/dist/channels/plugin.d.ts

@@ -0,0 +1,9 @@
+import type { ChannelFactory } from "./create-channel.js";
+import type { ChannelCliProvider } from "./cli/provider.js";
+export interface ChannelPluginDefinition {
+    /** Stable channel type used in channels[].type and chatKey prefix. */
+    type: string;
+    factory: ChannelFactory;
+    cliProvider?: ChannelCliProvider;
+}
+export declare function registerChannelPlugin(plugin: ChannelPluginDefinition): void;

package/dist/channels/types.d.ts

@@ -0,0 +1,61 @@
+import type { Agent as ChatAgent } from "../weixin/agent/interface.js";
+import type { OrchestrationTaskRecord } from "../orchestration/orchestration-types.js";
+import type { AppLogger } from "../logging/app-logger.js";
+import type { PendingFinalChunk } from "../weixin/messaging/quota-manager.js";
+export type { ChatAgent };
+export interface OutboundQuota {
+    onInbound(chatKey: string): void;
+    reserveMidSegment(chatKey: string): boolean;
+    reserveFinal(chatKey: string): boolean;
+    finalRemaining(chatKey: string): number;
+    hasPendingFinal(chatKey: string): boolean;
+    drainPendingFinalUpToBudget(chatKey: string, available: number): PendingFinalChunk[];
+    prependPendingFinal(chatKey: string, chunks: PendingFinalChunk[]): void;
+    enqueuePendingFinal(chatKey: string, chunks: PendingFinalChunk[]): void;
+    clearPendingFinal(chatKey: string): void;
+}
+export interface CoordinatorMessageInput {
+    coordinatorSession: string;
+    chatKey: string;
+    accountId?: string;
+    replyContextToken?: string;
+    text: string;
+}
+export interface ChannelStartInput {
+    agent: ChatAgent;
+    abortSignal: AbortSignal;
+    quota: OutboundQuota;
+    logger: AppLogger;
+}
+export interface OrchestrationDeliveryCallbacks {
+    markTaskNoticeDelivered: (taskId: string, accountId: string) => Promise<void>;
+    markTaskNoticeFailed: (taskId: string, errorMessage: string) => Promise<void>;
+}
+export interface ConsumerLockMetadata {
+    pid: number;
+    mode: "foreground" | "daemon";
+    startedAt: string;
+    configPath: string;
+    statePath: string;
+    hostname?: string;
+}
+export interface ConsumerLock {
+    acquire(meta: ConsumerLockMetadata): Promise<void>;
+    release(): Promise<void>;
+}
+export interface ConsumerLockOptions {
+    lockFilePath?: string;
+    onDiagnostic?: (event: string, context: Record<string, string | number | boolean | undefined>) => void | Promise<void>;
+}
+export interface MessageChannelRuntime {
+    id: string;
+    isLoggedIn(): boolean;
+    login(): Promise<string>;
+    logout(): void;
+    start(input: ChannelStartInput): Promise<void>;
+    createConsumerLock?(options?: ConsumerLockOptions): ConsumerLock;
+    configureOrchestration?(callbacks: OrchestrationDeliveryCallbacks): void;
+    notifyTaskCompletion(task: OrchestrationTaskRecord): Promise<void>;
+    notifyTaskProgress(task: OrchestrationTaskRecord, text: string): Promise<void>;
+    sendCoordinatorMessage(input: CoordinatorMessageInput): Promise<void>;
+}

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

@@ -0,0 +1,22 @@
+import type { MessageChannelRuntime, ChannelStartInput, CoordinatorMessageInput, OrchestrationDeliveryCallbacks, ConsumerLock, ConsumerLockOptions } from "./types.js";
+import type { RuntimeMediaStore } from "./media-store.js";
+import type { OrchestrationTaskRecord } from "../orchestration/orchestration-types.js";
+export declare class WeixinChannel implements MessageChannelRuntime {
+    readonly id = "weixin";
+    private quota;
+    private logger;
+    private markDelivered;
+    private markFailed;
+    private mediaStore;
+    private allowedMediaRoots;
+    constructor(mediaStore?: RuntimeMediaStore, allowedMediaRoots?: string[]);
+    isLoggedIn(): boolean;
+    login(): Promise<string>;
+    logout(): void;
+    createConsumerLock(options?: ConsumerLockOptions): ConsumerLock;
+    configureOrchestration(callbacks: OrchestrationDeliveryCallbacks): void;
+    start(input: ChannelStartInput): Promise<void>;
+    notifyTaskCompletion(task: OrchestrationTaskRecord): Promise<void>;
+    notifyTaskProgress(task: OrchestrationTaskRecord, text: string): Promise<void>;
+    sendCoordinatorMessage(input: CoordinatorMessageInput): Promise<void>;
+}