@router-agent/channel 0.0.0-stage → 0.3.31

package/dist/config.d.ts

@@ -0,0 +1,12 @@
+/** 飞书通道自己的配置视图；宿主 AppConfig 结构上兼容，通道包不反向依赖宿主。 */
+export interface FeishuChannelSettings {
+    appId: string;
+    allowed: string[];
+    chats: import('@router-agent/core/config.js').ChatAdmissionSettings[];
+    directMessages: boolean;
+    botOpenIds: string[];
+    botNames: string[];
+}
+export interface FeishuIdentityConfigView {
+    feishu: FeishuChannelSettings;
+}

package/dist/config.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../packages/channel/src/config.ts"],"names":[],"mappings":""}

package/dist/errors.d.ts

@@ -0,0 +1,7 @@
+/** 通道层错误：区分可重试与永久失败，避免 Outbox 对永久错误无限退避。 */
+export declare class ChannelError extends Error {
+    readonly channelId: string;
+    readonly code: string;
+    readonly retryable: boolean;
+    constructor(channelId: string, code: string, message: string, retryable?: boolean);
+}

package/dist/errors.js

@@ -0,0 +1,14 @@
+/** 通道层错误：区分可重试与永久失败，避免 Outbox 对永久错误无限退避。 */
+export class ChannelError extends Error {
+    channelId;
+    code;
+    retryable;
+    constructor(channelId, code, message, retryable = true) {
+        super(message);
+        this.channelId = channelId;
+        this.code = code;
+        this.retryable = retryable;
+        this.name = 'ChannelError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../packages/channel/src/errors.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,MAAM,OAAO,YAAa,SAAQ,KAAK;IAE1B;IACA;IAEA;IAJX,YACW,SAAiB,EACjB,IAAY,EACrB,OAAe,EACN,YAAY,IAAI;QAEzB,KAAK,CAAC,OAAO,CAAC,CAAA;QALL,cAAS,GAAT,SAAS,CAAQ;QACjB,SAAI,GAAJ,IAAI,CAAQ;QAEZ,cAAS,GAAT,SAAS,CAAO;QAGzB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAA;IAC5B,CAAC;CACF"}

package/dist/feishu/index.js

@@ -0,0 +1,146 @@
+import { noopLogger } from '@router-agent/infra/logger.js';
+import { FeishuBotAdmin } from '../sources/feishu-bot-admin.js';
+import { attachImageText } from '../sources/feishu-image.js';
+import { FeishuConsumer, FeishuSender, attachQuotedMessage, normalizeFeishuEventDetailed, shouldSendAsText, } from '../sources/feishu.js';
+import { createLarkRunner, larkEnv } from '../sources/lark.js';
+import { DEFAULT_CHANNEL_ID } from '../port.js';
+/**
+ * 飞书通道适配器。
+ *
+ * 把原先散在 CLI 与 Service 里的飞书细节收口到这里：事件消费、归一化、引用/图片富化、
+ * 文本/卡片渲染、回执、云文档、凭据与授权。内核只看到 `ChannelAdapter`。
+ */
+export class FeishuChannel {
+    id = DEFAULT_CHANNEL_ID;
+    kind = 'feishu';
+    capabilities;
+    admin;
+    config;
+    runner;
+    reaction;
+    directory;
+    transcriber;
+    logger;
+    sender;
+    opts;
+    consumer = null;
+    constructor(opts) {
+        this.opts = opts;
+        this.config = opts.config;
+        this.runner = opts.runner;
+        this.reaction = opts.reaction ?? '';
+        this.directory = opts.directory;
+        this.transcriber = opts.transcriber;
+        this.logger = opts.logger ?? noopLogger;
+        this.sender = opts.sender ?? new FeishuSender(opts.runner, this.logger);
+        this.admin = opts.admin ?? new FeishuBotAdmin({ lark: opts.runner });
+        this.capabilities = {
+            threadReply: true,
+            ack: Boolean(opts.reaction),
+            richText: true,
+            documents: true,
+            directory: true,
+            attachmentsIn: true,
+            attachmentsOut: false,
+            idempotency: true,
+            maxTextLength: 3500,
+            directMessage: opts.config.directMessages,
+        };
+    }
+    normalize(raw) {
+        const event = (raw && typeof raw === 'object' ? raw : {});
+        const chatId = String(event.chat_id ?? '');
+        const targetName = this.directory?.nameOf(chatId) ?? '';
+        const result = normalizeFeishuEventDetailed(event, this.config, targetName, this.opts.allowUnaddressed);
+        if (!result.trigger) {
+            return {
+                dropped: result.dropped,
+                ...(result.chatId ? { targetId: result.chatId } : {}),
+                ...(result.chatId ? { targetName } : {}),
+                ...(result.actorId ? { actorId: result.actorId } : {}),
+            };
+        }
+        return {
+            trigger: { ...result.trigger, channelId: this.id },
+            targetId: result.chatId,
+            targetName,
+            ...(result.actorId ? { actorId: result.actorId } : {}),
+        };
+    }
+    /** 图片消息要先下载识别，耗时较久；CLI 据此决定是否提前加回执。 */
+    needsEnrichment(trigger) {
+        const raw = trigger.raw;
+        return Boolean(trigger.mediaOnly) || Array.isArray(raw?.imageKeys);
+    }
+    async enrich(trigger) {
+        const quoted = await attachQuotedMessage(trigger, this.runner, { logger: this.logger });
+        return attachImageText(quoted, {
+            runner: this.runner,
+            transcriber: this.transcriber,
+            ...(this.opts.imagesRoot ? { imagesRoot: this.opts.imagesRoot } : {}),
+            logger: this.logger,
+        });
+    }
+    async send(message) {
+        const text = message.text.trim();
+        if (!text)
+            return {};
+        const key = message.idempotencyKey;
+        if (shouldSendAsText(text)) {
+            if (message.threadRef)
+                await this.sender.reply(message.threadRef, text, key);
+            else
+                await this.sender.send(message.targetId, text, key);
+            return { degradedTo: 'plain' };
+        }
+        // Markdown 走互动卡片；卡片失败时 FeishuSender 内部降级为 post 富文本。
+        if (message.threadRef)
+            await this.sender.replyCard(message.threadRef, text, key);
+        else
+            await this.sender.sendCard(message.targetId, text, key);
+        return { degradedTo: 'rich' };
+    }
+    async ack(messageId) {
+        if (!this.reaction)
+            return null;
+        return this.sender.react(messageId, this.reaction);
+    }
+    async clearAck(messageId, handle) {
+        await this.sender.unreact(messageId, handle);
+    }
+    async createDocument(title, markdown) {
+        return this.sender.createDocument(title, markdown);
+    }
+    async start(sink) {
+        if (this.consumer)
+            return;
+        this.consumer = new FeishuConsumer({
+            ...(this.opts.bin ? { bin: this.opts.bin } : {}),
+            env: this.opts.env ?? larkEnv(),
+            onEvent: sink,
+            ...(this.opts.hooks?.onReady ? { onReady: this.opts.hooks.onReady } : {}),
+            ...(this.opts.hooks?.onReconnect ? { onReconnect: this.opts.hooks.onReconnect } : {}),
+            ...(this.opts.hooks?.onError ? { onError: this.opts.hooks.onError } : {}),
+            ...(this.opts.hooks?.onLine ? { onLine: this.opts.hooks.onLine } : {}),
+        });
+        this.consumer.start();
+    }
+    stop() {
+        this.consumer?.stop();
+        this.consumer = null;
+    }
+}
+/** 生产装配：用固定 profile 的 lark-cli runner 构造飞书通道。 */
+export function createFeishuChannel(opts) {
+    return new FeishuChannel({ ...opts, runner: opts.runner ?? createLarkRunner() });
+}
+/**
+ * `ra doc` 用的轻量文档器。
+ *
+ * 一期仍直连飞书；等接入第二通道时改走 Router API，按工单所在通道选择实现。
+ */
+export function createFeishuDocumenter(opts = {}) {
+    const sender = new FeishuSender(opts.runner ?? createLarkRunner());
+    return { createDocument: (title, markdown) => sender.createDocument(title, markdown) };
+}
+//# sourceMappingURL=index.js.map

package/dist/feishu/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/channel/src/feishu/index.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from './port.js';
+export { ChannelRegistry } from './registry.js';
+export { ChannelRouter } from './router.js';
+export { ChannelError } from './errors.js';
+export { ChannelIngress, type AckStore, type IngressSink } from './ingress.js';
+export * from './plugins/types.js';
+export { DEFAULT_CHANNEL_PLUGINS, channelPluginEntryOf, describeChannelPluginLoadError, loadChannelPlugins, } from './plugins/loader.js';
+export type { ChannelPluginConfigView, ChannelPluginDeps, LoadedChannelPlugins } from './plugins/loader.js';
+export * from './config.js';

package/dist/index.js

@@ -0,0 +1,9 @@
+export * from './port.js';
+export { ChannelRegistry } from './registry.js';
+export { ChannelRouter } from './router.js';
+export { ChannelError } from './errors.js';
+export { ChannelIngress } from './ingress.js';
+export * from './plugins/types.js';
+export { DEFAULT_CHANNEL_PLUGINS, channelPluginEntryOf, describeChannelPluginLoadError, loadChannelPlugins, } from './plugins/loader.js';
+export * from './config.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/channel/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,cAAc,EAAmC,MAAM,cAAc,CAAA;AAC9E,cAAc,oBAAoB,CAAA;AAClC,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,8BAA8B,EAC9B,kBAAkB,GACnB,MAAM,qBAAqB,CAAA;AAE5B,cAAc,aAAa,CAAA"}

package/dist/ingress.d.ts

@@ -0,0 +1,46 @@
+import type { Trigger } from '@router-agent/core/model.js';
+import { type Logger } from '@router-agent/infra/logger.js';
+import type { ChannelAdapter } from './port.js';
+/**
+ * 入库端口：通道包只要求「能把 Trigger 落库」，不依赖宿主 Engine 的具体实现。
+ * `false` 表示重复投递（已被去重）。
+ */
+export interface IngressSink {
+    ingest(trigger: Trigger): boolean;
+}
+/** 回执存储端口：只读写「消息 → 回执句柄」这一条最小信息。 */
+export interface AckStore {
+    getReaction(messageId: string): {
+        messageId: string;
+        reactionId: string;
+    } | null;
+}
+export interface ChannelIngressOptions {
+    adapter: ChannelAdapter;
+    engine: IngressSink;
+    store: AckStore;
+    logger?: Logger;
+    /** 这条消息是否会被回复；决定是否加回执。 */
+    shouldReply: (trigger: Trigger) => boolean;
+    /** 回执句柄落盘，回复成功后用于撤销。 */
+    onAck?: (messageId: string, handle: string) => void;
+}
+/**
+ * 入站管线：归一化 -> 富化 -> 入库 -> 回执。
+ *
+ * 顺序与原先 CLI 内联逻辑保持一致：
+ * - 图片消息需要下载识别，先加回执再富化；
+ * - 其他消息先富化入库，再补回执；
+ * - 重复投递只记日志，不重复回执。
+ */
+export declare class ChannelIngress {
+    private readonly adapter;
+    private readonly engine;
+    private readonly store;
+    private readonly logger;
+    private readonly shouldReply;
+    private readonly onAck?;
+    constructor(opts: ChannelIngressOptions);
+    handleRaw(raw: unknown): void;
+    private react;
+}

package/dist/ingress.js

@@ -0,0 +1,90 @@
+import { errorMessage, noopLogger } from '@router-agent/infra/logger.js';
+/**
+ * 入站管线：归一化 -> 富化 -> 入库 -> 回执。
+ *
+ * 顺序与原先 CLI 内联逻辑保持一致：
+ * - 图片消息需要下载识别，先加回执再富化；
+ * - 其他消息先富化入库，再补回执；
+ * - 重复投递只记日志，不重复回执。
+ */
+export class ChannelIngress {
+    adapter;
+    engine;
+    store;
+    logger;
+    shouldReply;
+    onAck;
+    constructor(opts) {
+        this.adapter = opts.adapter;
+        this.engine = opts.engine;
+        this.store = opts.store;
+        this.logger = opts.logger ?? noopLogger;
+        this.shouldReply = opts.shouldReply;
+        this.onAck = opts.onAck;
+    }
+    handleRaw(raw) {
+        const result = this.adapter.normalize(raw);
+        if (!result.trigger) {
+            // 收到了但被过滤：把原因写进日志，否则用户只会看到「没反应」。
+            this.logger.info('trigger:dropped', {
+                channel: this.adapter.id,
+                reason: result.dropped,
+                chat: result.targetId,
+                name: result.targetName,
+                actor: result.actorId,
+            });
+            return;
+        }
+        const base = result.trigger;
+        const willReply = this.shouldReply(base);
+        const needsEnrichment = this.adapter.needsEnrichment?.(base) ?? false;
+        const canAck = this.adapter.capabilities.ack && Boolean(this.adapter.ack);
+        if (canAck && willReply && needsEnrichment && !this.store.getReaction(base.externalId)) {
+            this.react(base.externalId);
+        }
+        void (async () => {
+            const trigger = this.adapter.enrich ? await this.adapter.enrich(base) : base;
+            const stored = this.engine.ingest(trigger);
+            if (!stored) {
+                // 重放 / 重复投递：消息已入库但被去重，日志里说清楚，避免误判成「消息丢了」。
+                this.logger.info('trigger:duplicate', { channel: this.adapter.id, id: trigger.id, chat: trigger.chatId });
+                return;
+            }
+            const raw = trigger.raw;
+            const threadKeys = trigger.threadKeys ?? [];
+            this.logger.info('trigger:ingested', {
+                channel: this.adapter.id,
+                id: trigger.id,
+                chat: trigger.chatId,
+                addressed: trigger.addressed,
+                // 没 @ 但被放行的消息（tk-59）：处理它是因为话题绑着在办工单，不是「漏了 @ 判断」。
+                admitted: Boolean(trigger.unaddressedAdmitted),
+                quoted: Boolean(raw?.quote),
+                images: Array.isArray(raw?.images) ? raw.images.length : 0,
+                // 事件到底带了哪些线程标识：排查「消息没进工单」时先看 topic 是否为 true。
+                threadKeys: threadKeys.length,
+                topic: threadKeys.some(key => key.startsWith('omt_')),
+            });
+            // 纯附件在入库前已经加过，这里跳过避免重复。
+            if (canAck && willReply && !needsEnrichment)
+                this.react(trigger.externalId);
+        })().catch(error => {
+            this.logger.warn('trigger:ingest-failed', { channel: this.adapter.id, message: errorMessage(error) });
+        });
+    }
+    react(messageId) {
+        void this.adapter.ack(messageId)
+            .then(handle => {
+            if (handle)
+                this.onAck?.(messageId, handle);
+        })
+            .catch(error => {
+            this.logger.warn('channel:ack-failed', {
+                channel: this.adapter.id,
+                messageId,
+                message: errorMessage(error),
+            });
+        });
+    }
+}
+//# sourceMappingURL=ingress.js.map

package/dist/ingress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingress.js","sourceRoot":"","sources":["../../../../packages/channel/src/ingress.ts"],"names":[],"mappings":"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"}

package/dist/legacy.js

@@ -0,0 +1,26 @@
+import { shouldSendAsText } from './sources/feishu.js';
+export function createEffectsSender(sender) {
+    return {
+        async send(item) {
+            if (item.channelKind !== 'feishu')
+                return;
+            const text = item.text.trim();
+            if (!text)
+                return;
+            // 简单消息走纯文本：不开卡片，少一次渲染、少一类兼容问题。
+            if (shouldSendAsText(text)) {
+                if (item.threadId)
+                    await sender.reply(item.threadId, text, item.key);
+                else
+                    await sender.send(item.channelId, text, item.key);
+                return;
+            }
+            // 其余走互动卡片：Markdown 先在 feishuCard 内归一化，卡片失败时 Sender 内部降级为 post。
+            if (item.threadId)
+                await sender.replyCard(item.threadId, text, item.key);
+            else
+                await sender.sendCard(item.channelId, text, item.key);
+        },
+    };
+}
+//# sourceMappingURL=legacy.js.map

package/dist/legacy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy.js","sourceRoot":"","sources":["../../../../packages/channel/src/legacy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAwBtD,MAAM,UAAU,mBAAmB,CAAC,MAAsB;IACxD,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,IAAI;YACb,IAAI,IAAI,CAAC,WAAW,KAAK,QAAQ;gBAAE,OAAM;YACzC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;YAC7B,IAAI,CAAC,IAAI;gBAAE,OAAM;YACjB,+BAA+B;YAC/B,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3B,IAAI,IAAI,CAAC,QAAQ;oBAAE,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAA;;oBAC/D,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAA;gBACtD,OAAM;YACR,CAAC;YACD,+DAA+D;YAC/D,IAAI,IAAI,CAAC,QAAQ;gBAAE,MAAM,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAA;;gBACnE,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAA;QAC5D,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/plugins/loader.d.ts

@@ -0,0 +1,33 @@
+import { type Logger } from '@router-agent/infra/logger.js';
+import type { CommandRunner } from '@router-agent/infra/process.js';
+import { type PluginFailure } from '@router-agent/infra/plugin-loader.js';
+import { ChannelRegistry } from '../registry.js';
+import type { ChannelAdapter } from '../port.js';
+import type { ChannelPluginEntry, ChannelPluginMeta, ChannelPluginModuleLoader } from './types.js';
+export declare const DEFAULT_CHANNEL_PLUGINS: Readonly<Record<string, string>>;
+export interface ChannelPluginConfigView {
+    home?: string;
+    channels?: Record<string, ChannelPluginEntry>;
+}
+export declare function channelPluginEntryOf(config: ChannelPluginConfigView, id: string): string;
+export declare function describeChannelPluginLoadError(id: string, error: unknown): string;
+export interface ChannelPluginDeps {
+    home?: string;
+    env?: NodeJS.ProcessEnv;
+    logger?: Logger;
+    runner?: (bin: string) => CommandRunner;
+    services?: Record<string, unknown>;
+    loader?: ChannelPluginModuleLoader;
+    /** 测试注入：跳过内置包加载。 */
+    builtins?: readonly string[];
+}
+export interface LoadedChannelPlugins {
+    registry: ChannelRegistry;
+    metas: ChannelPluginMeta[];
+    adapters: ChannelAdapter[];
+    /** 配置 id → 实际注册的通道实例 id；一个插件包可以注册多个。 */
+    loadedIds: Record<string, string[]>;
+    failures: PluginFailure[];
+}
+/** 加载 channel 插件并注册 adapter；单个插件失败只记录，不阻塞其它通道。 */
+export declare function loadChannelPlugins(config: ChannelPluginConfigView, deps?: ChannelPluginDeps): Promise<LoadedChannelPlugins>;

package/dist/plugins/loader.js

@@ -0,0 +1,79 @@
+import { errorMessage, noopLogger } from '@router-agent/infra/logger.js';
+import { loadPluginModules, pluginEntryTarget, pluginSpecifier, throwRunner, } from '@router-agent/infra/plugin-loader.js';
+import { ChannelRegistry } from '../registry.js';
+export const DEFAULT_CHANNEL_PLUGINS = {
+    feishu: '@router-agent/channel-feishu',
+};
+export function channelPluginEntryOf(config, id) {
+    return pluginSpecifier(config.channels?.[id]) ?? DEFAULT_CHANNEL_PLUGINS[id] ?? id;
+}
+export function describeChannelPluginLoadError(id, error) {
+    return `channel 插件 ${id} 加载失败：${errorMessage(error)}`;
+}
+/** 加载 channel 插件并注册 adapter；单个插件失败只记录，不阻塞其它通道。 */
+export async function loadChannelPlugins(config, deps = {}) {
+    const logger = deps.logger ?? noopLogger;
+    const home = deps.home ?? config.home ?? '';
+    const ids = [...new Set([...(deps.builtins ?? Object.keys(DEFAULT_CHANNEL_PLUGINS)), ...Object.keys(config.channels ?? {})])];
+    const registry = new ChannelRegistry(logger);
+    const metas = [];
+    const adapters = [];
+    const loadedIds = {};
+    const failures = [];
+    const loaded = await loadPluginModules({
+        kind: 'channel',
+        home,
+        ids,
+        ...(deps.loader ? { loader: deps.loader } : {}),
+        logger,
+        specifierOf: id => {
+            const entry = config.channels?.[id];
+            if (entry !== undefined)
+                return pluginSpecifier(entry);
+            return DEFAULT_CHANNEL_PLUGINS[id] ?? id;
+        },
+        entryOf: id => pluginEntryTarget(config.channels?.[id]),
+    });
+    failures.push(...loaded.failures);
+    for (const { id: configId, plugin } of loaded.entries) {
+        try {
+            const ctx = {
+                home,
+                config: config,
+                env: deps.env ?? process.env,
+                logger,
+                runner: deps.runner ?? (bin => throwRunner('channel', bin)),
+                ...(deps.services ? { services: deps.services } : {}),
+            };
+            const created = plugin.createAll ? await plugin.createAll(ctx) : [await plugin.create(ctx)];
+            const ids = [];
+            for (const adapter of created) {
+                if (!adapter)
+                    continue;
+                registry.register(adapter);
+                adapters.push(adapter);
+                ids.push(adapter.id);
+                logger.info('plugin:loaded', { kind: 'channel', id: adapter.id });
+            }
+            loadedIds[configId] = ids;
+            if (plugin.meta) {
+                if (plugin.meta.id !== configId) {
+                    logger.warn('plugin:id-mismatch', {
+                        kind: 'channel',
+                        id: configId,
+                        declared: plugin.meta.id,
+                        detail: '配置里的插件 id 与插件声明的 meta.id 不一致，请改成一致以便面板回链',
+                    });
+                }
+                metas.push({ ...plugin.meta, id: configId });
+            }
+        }
+        catch (error) {
+            const failureId = configId || plugin.meta?.id || 'unknown';
+            logger.error('plugin:create-failed', { kind: 'channel', id: failureId, detail: errorMessage(error) });
+            failures.push({ kind: 'channel', id: failureId, specifier: channelPluginEntryOf(config, failureId), message: errorMessage(error) });
+        }
+    }
+    return { registry, metas, adapters, loadedIds, failures };
+}
+//# sourceMappingURL=loader.js.map

package/dist/plugins/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../../../../packages/channel/src/plugins/loader.ts"],"names":[],"mappings":"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"}

package/dist/plugins/types.d.ts

@@ -0,0 +1,30 @@
+import type { CommandRunner } from '@router-agent/infra/process.js';
+import type { Logger } from '@router-agent/infra/logger.js';
+import type { PluginEntry, PluginModuleLoader } from '@router-agent/infra/plugin-loader.js';
+import type { ChannelAdapter } from '../port.js';
+export type ChannelPluginEntry = PluginEntry;
+export type ChannelPluginModuleLoader = PluginModuleLoader;
+export interface ChannelPluginMeta {
+    id: string;
+    name: string;
+    hint: string;
+    default?: boolean;
+    packageName?: string;
+}
+export interface ChannelPluginContext {
+    home: string;
+    config: Record<string, unknown>;
+    env: NodeJS.ProcessEnv;
+    logger: Logger;
+    /** 插件自行创建的运行器；宿主不假设通道实现。 */
+    runner(bin: string): CommandRunner;
+    /** 宿主已有的可选服务（如目录、附件转写）；插件按需取用。 */
+    services?: Record<string, unknown>;
+}
+export interface ChannelPlugin {
+    kind: 'channel';
+    meta?: ChannelPluginMeta;
+    create(ctx: ChannelPluginContext): ChannelAdapter | null | Promise<ChannelAdapter | null>;
+    /** 一个通道包可以注册多个实例；不实现时等价于 create()。 */
+    createAll?(ctx: ChannelPluginContext): Array<ChannelAdapter | null> | Promise<Array<ChannelAdapter | null>>;
+}

package/dist/plugins/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/plugins/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../packages/channel/src/plugins/types.ts"],"names":[],"mappings":""}