@router-agent/channel 0.0.0-stage → 0.3.32

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/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/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":""}

package/dist/port.d.ts

@@ -0,0 +1,111 @@
+import type { Trigger } from '@router-agent/core/model.js';
+/**
+ * 默认通道实例 ID。
+ *
+ * 一期只有飞书一个通道，所有历史数据都归属于这个实例；等接入第二个通道时，
+ * 实例 ID 会来自配置（`channels.<id>`），这里的常量只作为兼容默认值。
+ */
+export declare const DEFAULT_CHANNEL_ID = "feishu";
+/** 通道能力声明。内核按能力降级，不假设所有通道长得一样。 */
+export interface ChannelCapabilities {
+    /** 支持话题/线程内回复。 */
+    threadReply: boolean;
+    /** 支持消息回执（表情或已读）。 */
+    ack: boolean;
+    /** 支持富文本渲染。 */
+    richText: boolean;
+    /** 支持创建可分享的长文档。 */
+    documents: boolean;
+    /** 支持枚举可接收目标。 */
+    directory: boolean;
+    /** 支持拉取入站附件。 */
+    attachmentsIn: boolean;
+    /** 支持发送出站附件（一期全部 false）。 */
+    attachmentsOut: boolean;
+    /** 支持服务端幂等键。 */
+    idempotency: boolean;
+    /** 单条消息字符上限，用于切块。 */
+    maxTextLength: number;
+    /** 私聊是否可用。 */
+    directMessage: boolean;
+}
+/** 出站消息的中立形态；具体渲染由通道适配器负责。 */
+export interface OutboundMessage {
+    channelId: string;
+    targetId: string;
+    /** 希望回复到的话题根；为空时发到 targetId。 */
+    threadRef?: string;
+    text: string;
+    format: 'plain' | 'markdown';
+    idempotencyKey: string;
+    /** 触发这条回复的用户消息，用于发送成功后撤销回执。 */
+    originMessageId?: string;
+}
+export interface SendReceipt {
+    messageId?: string;
+    /** 实际发生的降级，便于日志与排障。 */
+    degradedTo?: 'plain' | 'rich' | 'document';
+}
+/** 归一化结果：要么得到领域 Trigger，要么给出丢弃原因。 */
+export interface NormalizedInbound {
+    trigger?: Trigger;
+    dropped?: string;
+    targetId?: string;
+    targetName?: string;
+    actorId?: string;
+}
+export interface ChannelStatus {
+    appId?: string;
+    bot?: {
+        available?: boolean;
+        status?: string;
+        message?: string;
+    };
+    user?: {
+        available?: boolean;
+        status?: string;
+        message?: string;
+        openId?: string;
+        userName?: string;
+    };
+}
+export interface ChannelAdmin {
+    readonly profileHome: string;
+    status(): Promise<ChannelStatus>;
+    configure(appId: string, appSecret: string): Promise<{
+        ok: boolean;
+        message?: string;
+    }>;
+    startLogin(): Promise<any>;
+    completeLogin(code: string): Promise<any>;
+}
+/**
+ * 通道公共契约。
+ *
+ * 内核只依赖这个接口；飞书的 lark-cli 调用、事件过滤、卡片渲染全部封装在实现里。
+ * 一期只实现飞书，但签名预留了话题、回执、文档与附件能力，接第二通道时不用改内核。
+ */
+export interface ChannelAdapter {
+    readonly id: string;
+    readonly kind: string;
+    readonly capabilities: ChannelCapabilities;
+    /** 启动入站消费；主动拉取型通道可以不实现。 */
+    start?(sink: (raw: unknown) => void): Promise<void> | void;
+    stop?(): void;
+    /** 原始事件 -> 领域 Trigger；只做传输合法性，不做需要跨消息的富化。 */
+    normalize(raw: unknown): NormalizedInbound;
+    /** 这条消息入库前是否需要富化（引用回查、附件下载/OCR）。 */
+    needsEnrichment?(trigger: Trigger): boolean;
+    /** 通道内富化；失败不应阻塞主流程，实现方负责降级与记日志。 */
+    enrich?(trigger: Trigger): Promise<Trigger>;
+    send(message: OutboundMessage): Promise<SendReceipt>;
+    /** 给一条消息加回执，返回通道侧句柄；不支持时返回 null。 */
+    ack?(messageId: string): Promise<string | null>;
+    clearAck?(messageId: string, handle: string): Promise<void>;
+    listTargets?(): Promise<{
+        id: string;
+        name: string;
+    }[]>;
+    createDocument?(title: string, markdown: string): Promise<string>;
+    readonly admin?: ChannelAdmin;
+}

package/dist/port.js

@@ -0,0 +1,8 @@
+/**
+ * 默认通道实例 ID。
+ *
+ * 一期只有飞书一个通道，所有历史数据都归属于这个实例；等接入第二个通道时，
+ * 实例 ID 会来自配置（`channels.<id>`），这里的常量只作为兼容默认值。
+ */
+export const DEFAULT_CHANNEL_ID = 'feishu';
+//# sourceMappingURL=port.js.map

package/dist/port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.js","sourceRoot":"","sources":["../../../../packages/channel/src/port.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,CAAA"}

package/dist/registry.d.ts

@@ -0,0 +1,21 @@
+import { type Logger } from '@router-agent/infra/logger.js';
+import type { ChannelAdapter, ChannelCapabilities } from './port.js';
+/**
+ * 通道注册表：按实例 ID 管理适配器。
+ *
+ * 一期只注册飞书；接第二通道时只需在这里多注册一个实现，内核代码不动。
+ */
+export declare class ChannelRegistry {
+    private readonly adapters;
+    private readonly logger;
+    constructor(logger?: Logger);
+    register(adapter: ChannelAdapter): void;
+    get(id: string): ChannelAdapter | undefined;
+    /** 未注册属于永久失败：重试也不会变好，交给调用方决定是否进死信。 */
+    require(id: string): ChannelAdapter;
+    capabilities(id: string): ChannelCapabilities;
+    list(): ChannelAdapter[];
+    /** 依次启动所有实现 `start` 的适配器，并把原始事件标上通道 ID。 */
+    startAll(sink: (channelId: string, raw: unknown) => void): Promise<void>;
+    stopAll(): void;
+}

package/dist/registry.js

@@ -0,0 +1,50 @@
+import { noopLogger } from '@router-agent/infra/logger.js';
+import { ChannelError } from './errors.js';
+/**
+ * 通道注册表：按实例 ID 管理适配器。
+ *
+ * 一期只注册飞书；接第二通道时只需在这里多注册一个实现，内核代码不动。
+ */
+export class ChannelRegistry {
+    adapters = new Map();
+    logger;
+    constructor(logger = noopLogger) {
+        this.logger = logger;
+    }
+    register(adapter) {
+        if (this.adapters.has(adapter.id)) {
+            this.logger.warn('channel:duplicate-id', { channel: adapter.id, kind: adapter.kind });
+        }
+        this.adapters.set(adapter.id, adapter);
+    }
+    get(id) {
+        return this.adapters.get(id);
+    }
+    /** 未注册属于永久失败：重试也不会变好，交给调用方决定是否进死信。 */
+    require(id) {
+        const adapter = this.adapters.get(id);
+        if (!adapter) {
+            throw new ChannelError(id, 'channel:not-registered', `通道未注册: ${id}`, false);
+        }
+        return adapter;
+    }
+    capabilities(id) {
+        return this.require(id).capabilities;
+    }
+    list() {
+        return [...this.adapters.values()];
+    }
+    /** 依次启动所有实现 `start` 的适配器，并把原始事件标上通道 ID。 */
+    async startAll(sink) {
+        for (const adapter of this.adapters.values()) {
+            if (!adapter.start)
+                continue;
+            await adapter.start(raw => sink(adapter.id, raw));
+        }
+    }
+    stopAll() {
+        for (const adapter of this.adapters.values())
+            adapter.stop?.();
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../packages/channel/src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAe,MAAM,+BAA+B,CAAA;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG1C;;;;GAIG;AACH,MAAM,OAAO,eAAe;IACT,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAA;IAC5C,MAAM,CAAQ;IAE/B,YAAY,SAAiB,UAAU;QACrC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAED,QAAQ,CAAC,OAAuB;QAC9B,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;YAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;QACvF,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;IACxC,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAC9B,CAAC;IAED,sCAAsC;IACtC,OAAO,CAAC,EAAU;QAChB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACrC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,YAAY,CAAC,EAAE,EAAE,wBAAwB,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,CAAC,CAAA;QAC7E,CAAC;QACD,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,YAAY,CAAC,EAAU;QACrB,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,YAAY,CAAA;IACtC,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;IACpC,CAAC;IAED,2CAA2C;IAC3C,KAAK,CAAC,QAAQ,CAAC,IAA+C;QAC5D,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YAC7C,IAAI,CAAC,OAAO,CAAC,KAAK;gBAAE,SAAQ;YAC5B,MAAM,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAA;QACnD,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE;YAAE,OAAO,CAAC,IAAI,EAAE,EAAE,CAAA;IAChE,CAAC;CACF"}

package/dist/router.d.ts

@@ -0,0 +1,24 @@
+import { type Logger } from '@router-agent/infra/logger.js';
+import type { ChannelRegistry } from './registry.js';
+/** Outbox 交给通道层的最小字段集；与 store 的 OutboxItem 结构兼容。 */
+export interface ChannelOutboxItem {
+    channelKind: string;
+    channelId: string;
+    threadId: string;
+    text: string;
+    key: string;
+    originMessageId?: string;
+}
+/**
+ * 出站分发：按通道实例 ID 找到适配器，把中立消息交给它渲染与发送。
+ *
+ * 一期 `channelKind` 仍然是 `'feishu'`，与实例 ID 相同；接第二通道时
+ * 由配置把实例 ID 与实现 ID 分开。未知通道按旧行为跳过并记日志，
+ * 避免历史脏数据把 Outbox 卡死。
+ */
+export declare class ChannelRouter {
+    private readonly registry;
+    private readonly logger;
+    constructor(registry: ChannelRegistry, logger?: Logger);
+    send(item: ChannelOutboxItem): Promise<void>;
+}

package/dist/router.js

@@ -0,0 +1,36 @@
+import { noopLogger } from '@router-agent/infra/logger.js';
+/**
+ * 出站分发：按通道实例 ID 找到适配器，把中立消息交给它渲染与发送。
+ *
+ * 一期 `channelKind` 仍然是 `'feishu'`，与实例 ID 相同；接第二通道时
+ * 由配置把实例 ID 与实现 ID 分开。未知通道按旧行为跳过并记日志，
+ * 避免历史脏数据把 Outbox 卡死。
+ */
+export class ChannelRouter {
+    registry;
+    logger;
+    constructor(registry, logger = noopLogger) {
+        this.registry = registry;
+        this.logger = logger;
+    }
+    async send(item) {
+        const text = item.text.trim();
+        if (!text)
+            return;
+        const adapter = this.registry.get(item.channelKind);
+        if (!adapter) {
+            this.logger.warn('channel:not-registered', { channel: item.channelKind, target: item.channelId, key: item.key });
+            return;
+        }
+        await adapter.send({
+            channelId: item.channelKind,
+            targetId: item.channelId,
+            ...(item.threadId ? { threadRef: item.threadId } : {}),
+            text,
+            format: 'markdown',
+            idempotencyKey: item.key,
+            ...(item.originMessageId ? { originMessageId: item.originMessageId } : {}),
+        });
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../../../packages/channel/src/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAe,MAAM,+BAA+B,CAAA;AAavE;;;;;;GAMG;AACH,MAAM,OAAO,aAAa;IAEL;IACA;IAFnB,YACmB,QAAyB,EACzB,SAAiB,UAAU;QAD3B,aAAQ,GAAR,QAAQ,CAAiB;QACzB,WAAM,GAAN,MAAM,CAAqB;IAC3C,CAAC;IAEJ,KAAK,CAAC,IAAI,CAAC,IAAuB;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;QAC7B,IAAI,CAAC,IAAI;YAAE,OAAM;QACjB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QACnD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,wBAAwB,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAA;YAChH,OAAM;QACR,CAAC;QACD,MAAM,OAAO,CAAC,IAAI,CAAC;YACjB,SAAS,EAAE,IAAI,CAAC,WAAW;YAC3B,QAAQ,EAAE,IAAI,CAAC,SAAS;YACxB,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,IAAI;YACJ,MAAM,EAAE,UAAU;YAClB,cAAc,EAAE,IAAI,CAAC,GAAG;YACxB,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC3E,CAAC,CAAA;IACJ,CAAC;CACF"}

package/package.json

@@ -1,6 +1,37 @@
 {
   "name": "@router-agent/channel",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.32",
+  "type": "module",
+  "description": "消息通道 SDK：端口、注册表、插件协议与入站管线",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/blankPen/router-agent.git",
+    "directory": "packages/channel"
+  },
+  "homepage": "https://github.com/blankPen/router-agent#readme",
+  "bugs": {
+    "url": "https://github.com/blankPen/router-agent/issues"
+  },
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./*.js": "./dist/*.js",
+    "./*": "./dist/*"
+  },
+  "files": [
+    "dist"
+  ],
+  "types": "./dist/index.d.ts",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@router-agent/core": "0.3.32",
+    "@router-agent/infra": "0.3.32"
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.