@router-agent/channel 0.0.0-stage → 0.3.31

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/dist/sources/feishu-bot-admin.js

@@ -0,0 +1,119 @@
+import { mkdirSync } from 'node:fs';
+import { LARK_PROFILE_HOME, parseAuthStatus, parseDeviceLogin, } from './lark.js';
+/**
+ * router-agent 实际用到的飞书业务域。
+ *
+ * 不要用默认的「全部域」授权：router-agent 只需要 IM（消息/群/成员）、
+ * 云文档、云空间与通讯录，避免用户被要求授予日历、邮箱、审批等无关权限。
+ */
+export const FEISHU_AUTH_DOMAINS = ['im', 'docs', 'drive', 'contact'];
+/**
+ * 业务域之外必须显式申请的 scope。
+ *
+ * lark-cli 的 `contact` 域只映射到 `contact:user.basic_profile:readonly` 与
+ * `contact:user:search`，**不含** `contact:user.id:readonly`。而 router-agent 要用
+ * `contact/v3/users/batch_get_id` 把允许名单里的邮箱解析成 open_id，这个接口要的正是
+ * `contact:user.id:readonly`：域映射不覆盖它 → 用户授权成功、token 里却没有这个权限，
+ * 表现成「用户已经授权好飞书，但没有该权限」。
+ *
+ * lark-cli 的 `--scope` 与 `--domain` 是叠加关系，所以在这里补一个显式 scope：
+ * 用户在授权页会看到这一项，授权后应用侧也一并开通。
+ */
+export const FEISHU_AUTH_SCOPES = ['contact:user.id:readonly'];
+/** 授权参数：业务域 + 显式 scope（lark-cli 两者叠加）。 */
+export function feishuAuthScopeArgs() {
+    return ['--domain', FEISHU_AUTH_DOMAINS.join(','), '--scope', FEISHU_AUTH_SCOPES.join(',')];
+}
+/**
+ * 飞书机器人凭据与授权管理。
+ *
+ * 所有命令都通过已绑定固定 profile 的 lark-cli runner 执行：
+ * - App Secret 只走 stdin，不写 config.yaml，也不进 argv / 日志；
+ * - 授权走 Device Flow，先拿 verification_url，再由用户确认后完成轮询。
+ */
+export class FeishuBotAdmin {
+    lark;
+    profileHome;
+    constructor(opts) {
+        this.lark = opts.lark;
+        this.profileHome = opts.profileHome ?? LARK_PROFILE_HOME;
+    }
+    /** 把 App ID / App Secret 写入 lark-cli 的加密存储并校验。 */
+    async configure(appId, appSecret) {
+        const id = appId.trim();
+        const secret = appSecret.trim();
+        if (!id)
+            return { ok: false, message: 'App ID 不能为空' };
+        if (!secret)
+            return { ok: false, message: 'App Secret 不能为空' };
+        try {
+            mkdirSync(this.profileHome, { recursive: true });
+        }
+        catch (error) {
+            return { ok: false, message: `无法创建 lark-cli profile 目录：${errorMessage(error)}` };
+        }
+        const res = await this.lark.run(['config', 'init', '--app-id', id, '--app-secret-stdin'], { input: `${secret}\n`, timeoutMs: 30_000 });
+        const detail = redact(`${res.stdout}\n${res.stderr}`, secret);
+        if (res.code !== 0) {
+            return { ok: false, message: detail || `lark-cli 退出码 ${res.code}` };
+        }
+        if (!/configuration saved|配置已保存/i.test(res.stdout)) {
+            return { ok: false, message: detail || 'lark-cli 未确认配置已保存' };
+        }
+        return { ok: true, message: 'App Secret 已写入 lark-cli 加密存储' };
+    }
+    /** 读取机器人身份与用户授权状态。 */
+    async status() {
+        try {
+            const res = await this.lark.run(['auth', 'status', '--json']);
+            if (res.code !== 0)
+                return this.emptyStatus(redact(`${res.stdout}\n${res.stderr}`));
+            return parseAuthStatus(res.stdout);
+        }
+        catch (error) {
+            return this.emptyStatus(errorMessage(error));
+        }
+    }
+    /** 发起 Device Flow 授权，返回验证链接与 device code。 */
+    async startLogin() {
+        const res = await this.lark.run(['auth', 'login', '--no-wait', '--json', ...feishuAuthScopeArgs()], { timeoutMs: 30_000 });
+        if (res.code !== 0) {
+            throw new Error(redact(`${res.stdout}\n${res.stderr}`) || `lark-cli 退出码 ${res.code}`);
+        }
+        const parsed = parseDeviceLogin(res.stdout, res.stderr);
+        if (!parsed.deviceCode) {
+            throw new Error(`lark-cli 未返回 device code：${redact(`${res.stdout}\n${res.stderr}`) || '无输出'}`);
+        }
+        if (!parsed.verificationUrl) {
+            throw new Error(`lark-cli 未返回验证链接：${redact(`${res.stdout}\n${res.stderr}`) || '无输出'}`);
+        }
+        return parsed;
+    }
+    /** 完成授权轮询；最长等待 3 分钟。 */
+    async completeLogin(deviceCode) {
+        const code = deviceCode.trim();
+        if (!code)
+            throw new Error('device code 不能为空');
+        const res = await this.lark.run(['auth', 'login', '--device-code', code, '--json'], { timeoutMs: 180_000 });
+        if (res.code !== 0) {
+            throw new Error(redact(`${res.stdout}\n${res.stderr}`) || `lark-cli 退出码 ${res.code}`);
+        }
+        return this.status();
+    }
+    emptyStatus(message) {
+        return {
+            appId: '',
+            bot: { available: false, status: '', message },
+            user: { available: false, status: '', message: '', openId: '', userName: '' },
+        };
+    }
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/** 截断并去掉可能的敏感值，避免错误响应里回显 App Secret。 */
+function redact(text, secret = '') {
+    const cleaned = secret ? text.split(secret).join('***') : text;
+    return cleaned.trim().slice(0, 240);
+}
+//# sourceMappingURL=feishu-bot-admin.js.map

package/dist/sources/feishu-bot-admin.js.map

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

package/dist/sources/feishu-directory.js

@@ -0,0 +1,77 @@
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { noopLogger, errorMessage } from '@router-agent/infra/logger.js';
+/** 群名目录：定期从 lark-cli 拉取并缓存，用于面板与通知里的可读名称。 */
+export class ChatDirectory {
+    file;
+    logger;
+    names = new Map();
+    constructor(file, logger = noopLogger) {
+        this.file = file;
+        this.logger = logger;
+        this.load();
+    }
+    nameOf(chatId) {
+        return this.names.get(chatId) ?? '';
+    }
+    entries() {
+        return [...this.names.entries()].map(([chatId, name]) => ({ chatId, name }));
+    }
+    /** 用 lark-cli 的真实返回刷新缓存；失败保留旧值。 */
+    async refresh(runner) {
+        const res = await runner.run(['im', '+chat-list', '--as', 'bot', '--format', 'json']);
+        if (res.code !== 0) {
+            this.logger.warn('chats:refresh-failed', { code: res.code, message: res.stderr.slice(0, 200) });
+            return 0;
+        }
+        const parsed = parseChatList(res.stdout, this.logger);
+        for (const entry of parsed)
+            this.names.set(entry.chatId, entry.name);
+        this.save();
+        return parsed.length;
+    }
+    load() {
+        if (!existsSync(this.file))
+            return;
+        try {
+            const doc = JSON.parse(readFileSync(this.file, 'utf8'));
+            for (const entry of doc.chats ?? [])
+                this.names.set(entry.chatId, entry.name);
+        }
+        catch (error) {
+            // 缓存损坏时当作空，但留一条日志，避免群名一直显示为空却查不到原因。
+            this.logger.warn('chats:cache-invalid', { path: this.file, message: errorMessage(error) });
+        }
+    }
+    save() {
+        writeFileSync(this.file, `${JSON.stringify({ chats: this.entries() }, null, 2)}\n`, 'utf8');
+    }
+}
+/** 兼容 `{data:{chats:[...]}}` / `{data:{items:[...]}}` / 裸数组。 */
+export function parseChatList(stdout, logger = noopLogger) {
+    let json;
+    try {
+        json = JSON.parse(stdout);
+    }
+    catch (error) {
+        if (stdout.trim())
+            logger.warn('chats:parse-failed', { message: errorMessage(error), sample: stdout.slice(0, 200) });
+        return [];
+    }
+    if (Array.isArray(json))
+        return normalize(json);
+    const root = json;
+    const data = root?.data ?? root;
+    const list = data?.chats ?? data?.items ?? [];
+    return Array.isArray(list) ? normalize(list) : [];
+}
+function normalize(list) {
+    const out = [];
+    for (const raw of list) {
+        const chatId = String(raw.chat_id ?? raw.chatId ?? '');
+        const name = String(raw.name ?? raw.chat_name ?? '');
+        if (chatId)
+            out.push({ chatId, name });
+    }
+    return out;
+}
+//# sourceMappingURL=feishu-directory.js.map

package/dist/sources/feishu-directory.js.map

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