@coralai/sps-cli 0.57.15 → 0.58.1

package/dist/im/adapters/feishuAdapter.d.ts

@@ -0,0 +1,44 @@
+import type { IMAdapter, IMMessageHandler } from '../IMAdapter.js';
+import type { IMEvent, MessageChain, SendTarget } from '../types.js';
+export interface FeishuConfig {
+    /** 应用 App ID。 */
+    appId: string;
+    /** 应用 App Secret。 */
+    appSecret: string;
+    /** 事件订阅的 Verification Token(校验来源)。 */
+    verificationToken?: string;
+    /** Encrypt Key(设了则事件体 AES 加密,需解密)。 */
+    encryptKey?: string;
+    /** 本机监听端口(反代把公网 webhook 打到这)。默认 9800。 */
+    port?: number;
+    /** 监听路径。默认 /feishu。 */
+    path?: string;
+    /** 允许的 chat_id 白名单(空=全放)。 */
+    allowedChats?: string[];
+}
+export declare class FeishuAdapter implements IMAdapter {
+    private readonly cfg;
+    readonly kind = "feishu";
+    private readonly allow;
+    private handler;
+    private server;
+    private token;
+    private tokenExp;
+    constructor(cfg: FeishuConfig);
+    onMessage(handler: IMMessageHandler): void;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private onWebhook;
+    private toEvent;
+    send(target: SendTarget, message: MessageChain): Promise<void>;
+    reply(event: IMEvent, message: MessageChain): Promise<void>;
+    supportsStream(): boolean;
+    private sendToChat;
+    /** tenant_access_token(缓存到过期前)。 */
+    private tenantToken;
+    /** 飞书事件 AES 解密:key=sha256(encryptKey),iv=密文前16字节,AES-256-CBC。 */
+    private decrypt;
+    private passAllow;
+    private log;
+}
+//# sourceMappingURL=feishuAdapter.d.ts.map

package/dist/im/adapters/feishuAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feishuAdapter.d.ts","sourceRoot":"","sources":["../../../src/im/adapters/feishuAdapter.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAY,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG/E,MAAM,WAAW,YAAY;IAC3B,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAID,qBAAa,aAAc,YAAW,SAAS;IAQjC,OAAO,CAAC,QAAQ,CAAC,GAAG;IAPhC,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,QAAQ,CAAK;gBAEQ,GAAG,EAAE,YAAY;IAK9C,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAIpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,OAAO,CAAC,SAAS;IA+BjB,OAAO,CAAC,OAAO;IAsBT,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9D,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjE,cAAc,IAAI,OAAO;YAIX,UAAU;IAUxB,mCAAmC;YACrB,WAAW;IAczB,iEAAiE;IACjE,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,GAAG;CAGZ"}

package/dist/im/adapters/feishuAdapter.js

@@ -0,0 +1,154 @@
+/**
+ * @module        im/adapters/feishuAdapter
+ * @description   飞书/Lark 适配器,移植自 LangBot `sources/lark.py`。飞书是**事件订阅(webhook)**模型:
+ *                起一个 HTTP 监听收事件(**需公网可达 + 反代到本机**),URL 校验回 challenge,可选 AES 解密,
+ *                im.message.receive_v1 → IMEvent;出站用 tenant_access_token 调 im/v1/messages。
+ *                用 node:http + node:crypto + fetch,不引飞书 SDK。
+ * @layer         im
+ * @boundedContext im-gateway
+ */
+import { createServer } from 'node:http';
+import { createDecipheriv, createHash } from 'node:crypto';
+import { chainToText } from '../types.js';
+const BASE = 'https://open.feishu.cn';
+export class FeishuAdapter {
+    cfg;
+    kind = 'feishu';
+    allow;
+    handler = null;
+    server = null;
+    token = '';
+    tokenExp = 0;
+    constructor(cfg) {
+        this.cfg = cfg;
+        if (!cfg.appId || !cfg.appSecret)
+            throw new Error('feishu 适配器需要 appId + appSecret');
+        this.allow = cfg.allowedChats?.length ? new Set(cfg.allowedChats) : null;
+    }
+    onMessage(handler) {
+        this.handler = handler;
+    }
+    async start() {
+        const port = this.cfg.port ?? 9800;
+        const path = this.cfg.path ?? '/feishu';
+        this.server = createServer((req, res) => {
+            if (req.method !== 'POST' || (req.url ?? '').split('?')[0] !== path) {
+                res.writeHead(404).end();
+                return;
+            }
+            let body = '';
+            req.on('data', (c) => (body += c));
+            req.on('end', () => this.onWebhook(body, res));
+        });
+        await new Promise((resolve) => this.server.listen(port, () => resolve()));
+        this.log(`webhook 监听 :${port}${path}(需公网反代打到这)`);
+    }
+    async stop() {
+        await new Promise((resolve) => (this.server ? this.server.close(() => resolve()) : resolve()));
+    }
+    onWebhook(raw, res) {
+        let payload;
+        try {
+            payload = JSON.parse(raw);
+            if (payload.encrypt)
+                payload = JSON.parse(this.decrypt(payload.encrypt)); // AES 解密
+        }
+        catch {
+            res.writeHead(400).end();
+            return;
+        }
+        // URL 校验(接入时飞书发一次)
+        if (payload.type === 'url_verification') {
+            res.writeHead(200, { 'content-type': 'application/json' }).end(JSON.stringify({ challenge: payload.challenge }));
+            return;
+        }
+        // 校验来源 token
+        const token = payload.header?.token ?? payload.token;
+        if (this.cfg.verificationToken && token !== this.cfg.verificationToken) {
+            res.writeHead(401).end();
+            return;
+        }
+        res.writeHead(200).end(); // 先回 200,别让飞书重投
+        if (payload.header?.event_type === 'im.message.receive_v1') {
+            const evt = this.toEvent(payload.event);
+            if (evt && this.passAllow(evt.chatId) && this.handler) {
+                this.log(`recv from ${evt.chatId}: ${chainToText(evt.chain).slice(0, 60)}`);
+                Promise.resolve(this.handler(evt)).catch((e) => this.log(`handler error: ${e instanceof Error ? e.message : String(e)}`));
+            }
+        }
+    }
+    toEvent(e) {
+        const m = e?.message;
+        if (!m || m.message_type !== 'text')
+            return null; // 只处理文本
+        let text = '';
+        try {
+            text = String(JSON.parse(m.content ?? '{}').text ?? '').trim();
+        }
+        catch {
+            return null;
+        }
+        if (!text || !m.chat_id)
+            return null;
+        const chatType = m.chat_type === 'p2p' ? 'private' : 'group';
+        return {
+            platform: this.kind,
+            chatType,
+            chatId: m.chat_id,
+            sender: { id: e.sender?.sender_id?.open_id ?? '' },
+            chain: [{ type: 'text', text }],
+            messageId: m.message_id,
+            raw: e,
+        };
+    }
+    async send(target, message) {
+        await this.sendToChat(target.chatId, message);
+    }
+    async reply(event, message) {
+        await this.sendToChat(event.chatId, message);
+    }
+    supportsStream() {
+        return false; // 简化:攒完整段一次发(飞书可 patch 消息,后续再加)
+    }
+    async sendToChat(chatId, message) {
+        const token = await this.tenantToken();
+        const res = await fetch(`${BASE}/open-apis/im/v1/messages?receive_id_type=chat_id`, {
+            method: 'POST',
+            headers: { authorization: `Bearer ${token}`, 'content-type': 'application/json' },
+            body: JSON.stringify({ receive_id: chatId, msg_type: 'text', content: JSON.stringify({ text: chainToText(message) }) }),
+        });
+        if (!res.ok)
+            throw new Error(`feishu send → HTTP ${res.status}`);
+    }
+    /** tenant_access_token(缓存到过期前)。 */
+    async tenantToken() {
+        if (this.token && Date.now() < this.tokenExp)
+            return this.token;
+        const res = await fetch(`${BASE}/open-apis/auth/v3/tenant_access_token/internal`, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ app_id: this.cfg.appId, app_secret: this.cfg.appSecret }),
+        });
+        const j = (await res.json());
+        if (!j.tenant_access_token)
+            throw new Error(`取 tenant_access_token 失败:${j.msg ?? 'unknown'}`);
+        this.token = j.tenant_access_token;
+        this.tokenExp = Date.now() + (j.expire ?? 7200) * 1000 - 60_000; // 提前 60s 过期
+        return this.token;
+    }
+    /** 飞书事件 AES 解密:key=sha256(encryptKey),iv=密文前16字节,AES-256-CBC。 */
+    decrypt(encrypt) {
+        const key = createHash('sha256').update(this.cfg.encryptKey ?? '').digest();
+        const data = Buffer.from(encrypt, 'base64');
+        const iv = data.subarray(0, 16);
+        const d = createDecipheriv('aes-256-cbc', key, iv);
+        return Buffer.concat([d.update(data.subarray(16)), d.final()]).toString('utf8');
+    }
+    passAllow(chatId) {
+        return this.allow == null || this.allow.has(chatId);
+    }
+    log(msg) {
+        process.stderr.write(`[im/feishu] ${msg}\n`);
+    }
+}
+//# sourceMappingURL=feishuAdapter.js.map

package/dist/im/adapters/feishuAdapter.js.map

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

package/dist/im/adapters/matrixAdapter.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @module        im/adapters/matrixAdapter
+ * @description   Matrix 适配器,移植自 LangBot `sources/matrix.py`(Client-Server API,/sync 长轮询入站,免公网)。
+ *                入站:GET /sync?since=&timeout 长轮询 → m.room.message → IMEvent;出站:PUT rooms/{room}/send。
+ *                复用 sps-cli 已有的 Matrix 配置约定(homeserver + accessToken)。原生 fetch,不引 SDK。
+ * @layer         im
+ * @boundedContext im-gateway
+ */
+import type { IMAdapter, IMMessageHandler } from '../IMAdapter.js';
+import type { IMEvent, MessageChain, SendTarget } from '../types.js';
+export interface MatrixConfig {
+    /** homeserver 基址,如 https://matrix.org。 */
+    homeserver: string;
+    /** bot 的 access token。 */
+    accessToken: string;
+    /** 允许的 roomId 白名单(空=全放)。 */
+    allowedRooms?: string[];
+}
+export declare class MatrixAdapter implements IMAdapter {
+    private readonly cfg;
+    readonly kind = "matrix";
+    private readonly base;
+    private readonly allow;
+    private handler;
+    private stopped;
+    private selfId;
+    private txn;
+    constructor(cfg: MatrixConfig);
+    onMessage(handler: IMMessageHandler): void;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    send(target: SendTarget, message: MessageChain): Promise<void>;
+    reply(event: IMEvent, message: MessageChain): Promise<void>;
+    supportsStream(): boolean;
+    private toEvent;
+    private sendToRoom;
+    private passAllow;
+    private get;
+    private req;
+    private log;
+}
+//# sourceMappingURL=matrixAdapter.d.ts.map

package/dist/im/adapters/matrixAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matrixAdapter.d.ts","sourceRoot":"","sources":["../../../src/im/adapters/matrixAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGrE,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,qBAAa,aAAc,YAAW,SAAS;IASjC,OAAO,CAAC,QAAQ,CAAC,GAAG;IARhC,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,GAAG,CAAK;gBAEa,GAAG,EAAE,YAAY;IAM9C,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAIpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgCtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9D,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjE,cAAc,IAAI,OAAO;IAIzB,OAAO,CAAC,OAAO;YAiBD,UAAU;IASxB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,GAAG;YAIG,GAAG;IAUjB,OAAO,CAAC,GAAG;CAGZ"}

package/dist/im/adapters/matrixAdapter.js

@@ -0,0 +1,106 @@
+import { chainToText } from '../types.js';
+export class MatrixAdapter {
+    cfg;
+    kind = 'matrix';
+    base;
+    allow;
+    handler = null;
+    stopped = false;
+    selfId = '';
+    txn = 0;
+    constructor(cfg) {
+        this.cfg = cfg;
+        if (!cfg.homeserver || !cfg.accessToken)
+            throw new Error('matrix 适配器需要 homeserver + accessToken');
+        this.base = cfg.homeserver.replace(/\/+$/, '');
+        this.allow = cfg.allowedRooms?.length ? new Set(cfg.allowedRooms) : null;
+    }
+    onMessage(handler) {
+        this.handler = handler;
+    }
+    async start() {
+        this.stopped = false;
+        // 自己的 userId(过滤自己发的消息,避免回环)。
+        const who = (await this.get('/_matrix/client/v3/account/whoami').catch(() => ({})));
+        this.selfId = who.user_id ?? '';
+        // 初次 sync 只取 next_batch,跳过历史(只处理启动后的新消息)。
+        let since = (await this.get('/_matrix/client/v3/sync?timeout=0')).next_batch ?? '';
+        while (!this.stopped) {
+            try {
+                const res = (await this.get(`/_matrix/client/v3/sync?since=${encodeURIComponent(since)}&timeout=30000`));
+                since = res.next_batch ?? since;
+                for (const [roomId, room] of Object.entries(res.rooms?.join ?? {})) {
+                    for (const ev of room.timeline?.events ?? []) {
+                        const evt = this.toEvent(roomId, ev);
+                        if (evt && this.passAllow(roomId) && this.handler) {
+                            this.log(`recv from ${roomId}: ${chainToText(evt.chain).slice(0, 60)}`);
+                            Promise.resolve(this.handler(evt)).catch((e) => this.log(`handler error: ${e instanceof Error ? e.message : String(e)}`));
+                        }
+                    }
+                }
+            }
+            catch (e) {
+                if (this.stopped)
+                    break;
+                this.log(`sync 错误:${e instanceof Error ? e.message : String(e)}`);
+                await new Promise((r) => setTimeout(r, 3000));
+            }
+        }
+    }
+    async stop() {
+        this.stopped = true;
+    }
+    async send(target, message) {
+        await this.sendToRoom(target.chatId, message);
+    }
+    async reply(event, message) {
+        await this.sendToRoom(event.chatId, message);
+    }
+    supportsStream() {
+        return false; // 简化:攒完整段一次发(Matrix 可用 m.replace 编辑,后续再加)
+    }
+    toEvent(roomId, ev) {
+        if (ev?.type !== 'm.room.message')
+            return null;
+        if (ev.sender === this.selfId)
+            return null; // 跳过自己
+        if (ev.content?.msgtype !== 'm.text')
+            return null; // 只处理文本
+        const body = String(ev.content?.body ?? '').trim();
+        if (!body)
+            return null;
+        return {
+            platform: this.kind,
+            chatType: 'group', // Matrix 都是 room;私聊=只两人的 room
+            chatId: roomId,
+            sender: { id: ev.sender },
+            chain: [{ type: 'text', text: body }],
+            messageId: ev.event_id,
+            raw: ev,
+        };
+    }
+    async sendToRoom(roomId, message) {
+        const txnId = `sps${Date.now()}${this.txn++}`;
+        await this.req('PUT', `/_matrix/client/v3/rooms/${encodeURIComponent(roomId)}/send/m.room.message/${txnId}`, { msgtype: 'm.text', body: chainToText(message) });
+    }
+    passAllow(roomId) {
+        return this.allow == null || this.allow.has(roomId);
+    }
+    get(path) {
+        return this.req('GET', path);
+    }
+    async req(method, path, body) {
+        const res = await fetch(`${this.base}${path}`, {
+            method,
+            headers: { authorization: `Bearer ${this.cfg.accessToken}`, 'content-type': 'application/json' },
+            ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
+        });
+        if (!res.ok)
+            throw new Error(`matrix ${method} ${path.split('?')[0]} → HTTP ${res.status}`);
+        return res.json().catch(() => ({}));
+    }
+    log(msg) {
+        process.stderr.write(`[im/matrix] ${msg}\n`);
+    }
+}
+//# sourceMappingURL=matrixAdapter.js.map

package/dist/im/adapters/matrixAdapter.js.map

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

package/dist/im/adapters/slackAdapter.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @module        im/adapters/slackAdapter
+ * @description   Slack 适配器,移植自 LangBot `sources/slack.py`(Socket Mode,WebSocket 入站,免公网)。
+ *                入站:apps.connections.open 拿 wss → 连 WS → events_api 信封(message)→ ack(envelope_id)→ IMEvent;
+ *                出站:chat.postMessage。用原生 WebSocket/fetch,不引 @slack/* SDK。
+ * @layer         im
+ * @boundedContext im-gateway
+ */
+import type { IMAdapter, IMMessageHandler } from '../IMAdapter.js';
+import type { IMEvent, MessageChain, SendTarget } from '../types.js';
+export interface SlackConfig {
+    /** App-Level Token(xapp-…,Socket Mode 连接用)。 */
+    appToken: string;
+    /** Bot Token(xoxb-…,发消息用)。 */
+    botToken: string;
+    /** 允许的 channel 白名单(空=全放)。 */
+    allowedChannels?: string[];
+}
+export declare class SlackAdapter implements IMAdapter {
+    private readonly cfg;
+    readonly kind = "slack";
+    private readonly allow;
+    private handler;
+    private ws;
+    private stopped;
+    private selfUserId;
+    constructor(cfg: SlackConfig);
+    onMessage(handler: IMMessageHandler): void;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private connectOnce;
+    private onFrame;
+    private toEvent;
+    send(target: SendTarget, message: MessageChain): Promise<void>;
+    reply(event: IMEvent, message: MessageChain): Promise<void>;
+    supportsStream(): boolean;
+    private passAllow;
+    private api;
+    private log;
+}
+//# sourceMappingURL=slackAdapter.d.ts.map

package/dist/im/adapters/slackAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slackAdapter.d.ts","sourceRoot":"","sources":["../../../src/im/adapters/slackAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGrE,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,qBAAa,YAAa,YAAW,SAAS;IAQhC,OAAO,CAAC,QAAQ,CAAC,GAAG;IAPhC,QAAQ,CAAC,IAAI,WAAW;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAM;gBAEK,GAAG,EAAE,WAAW;IAK7C,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAIpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YASb,WAAW;IAYzB,OAAO,CAAC,OAAO;IAyBf,OAAO,CAAC,OAAO;IAiBT,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9D,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjE,cAAc,IAAI,OAAO;IAIzB,OAAO,CAAC,SAAS;YAIH,GAAG;IASjB,OAAO,CAAC,GAAG;CAGZ"}

package/dist/im/adapters/slackAdapter.js

@@ -0,0 +1,129 @@
+import { chainToText } from '../types.js';
+export class SlackAdapter {
+    cfg;
+    kind = 'slack';
+    allow;
+    handler = null;
+    ws = null;
+    stopped = false;
+    selfUserId = '';
+    constructor(cfg) {
+        this.cfg = cfg;
+        if (!cfg.appToken || !cfg.botToken)
+            throw new Error('slack 适配器需要 appToken(xapp-) + botToken(xoxb-)');
+        this.allow = cfg.allowedChannels?.length ? new Set(cfg.allowedChannels) : null;
+    }
+    onMessage(handler) {
+        this.handler = handler;
+    }
+    async start() {
+        this.stopped = false;
+        // bot 自己的 user id(过滤自己发的消息,避免回环)。
+        const auth = (await this.api('auth.test', this.cfg.botToken).catch(() => ({})));
+        this.selfUserId = auth.user_id ?? '';
+        while (!this.stopped) {
+            try {
+                await this.connectOnce();
+            }
+            catch (e) {
+                if (this.stopped)
+                    break;
+                this.log(`连接错误:${e instanceof Error ? e.message : String(e)}`);
+            }
+            if (!this.stopped)
+                await new Promise((r) => setTimeout(r, 3000));
+        }
+    }
+    async stop() {
+        this.stopped = true;
+        try {
+            this.ws?.close();
+        }
+        catch {
+            /* noop */
+        }
+    }
+    async connectOnce() {
+        const r = (await this.api('apps.connections.open', this.cfg.appToken));
+        if (!r.ok || !r.url)
+            throw new Error(`apps.connections.open 失败:${r.error ?? 'no url'}`);
+        await new Promise((resolve, reject) => {
+            const ws = new WebSocket(r.url);
+            this.ws = ws;
+            ws.addEventListener('message', (ev) => this.onFrame(ws, String(ev.data)));
+            ws.addEventListener('close', () => resolve());
+            ws.addEventListener('error', () => reject(new Error('WebSocket error')));
+        });
+    }
+    onFrame(ws, raw) {
+        let f;
+        try {
+            f = JSON.parse(raw);
+        }
+        catch {
+            return;
+        }
+        // 每个信封都要 ack(回 envelope_id),否则 Slack 重投。
+        if (f.envelope_id) {
+            try {
+                ws.send(JSON.stringify({ envelope_id: f.envelope_id }));
+            }
+            catch {
+                /* noop */
+            }
+        }
+        if (f.type === 'hello' || f.type === 'disconnect')
+            return;
+        if (f.type === 'events_api') {
+            const evt = this.toEvent(f.payload?.event);
+            if (evt && this.passAllow(evt.chatId) && this.handler) {
+                this.log(`recv from ${evt.chatId}: ${chainToText(evt.chain).slice(0, 60)}`);
+                Promise.resolve(this.handler(evt)).catch((e) => this.log(`handler error: ${e instanceof Error ? e.message : String(e)}`));
+            }
+        }
+    }
+    toEvent(e) {
+        if (!e || e.type !== 'message')
+            return null;
+        if (e.subtype || e.bot_id)
+            return null; // 忽略机器人/系统消息
+        if (e.user === this.selfUserId)
+            return null; // 跳过自己
+        const text = String(e.text ?? '').trim();
+        if (!text || !e.channel)
+            return null;
+        return {
+            platform: this.kind,
+            chatType: e.channel_type === 'im' ? 'private' : 'group',
+            chatId: e.channel,
+            sender: { id: e.user },
+            chain: [{ type: 'text', text }],
+            messageId: e.ts,
+            raw: e,
+        };
+    }
+    async send(target, message) {
+        await this.api('chat.postMessage', this.cfg.botToken, { channel: target.chatId, text: chainToText(message) });
+    }
+    async reply(event, message) {
+        await this.api('chat.postMessage', this.cfg.botToken, { channel: event.chatId, text: chainToText(message) });
+    }
+    supportsStream() {
+        return false; // 简化:攒完整段一次发(Slack 可 chat.update 编辑,后续再加)
+    }
+    passAllow(chatId) {
+        return this.allow == null || this.allow.has(chatId);
+    }
+    async api(method, token, body) {
+        const res = await fetch(`https://slack.com/api/${method}`, {
+            method: 'POST',
+            headers: { authorization: `Bearer ${token}`, 'content-type': 'application/json; charset=utf-8' },
+            ...(body ? { body: JSON.stringify(body) } : {}),
+        });
+        return res.json().catch(() => ({}));
+    }
+    log(msg) {
+        process.stderr.write(`[im/slack] ${msg}\n`);
+    }
+}
+//# sourceMappingURL=slackAdapter.js.map

package/dist/im/adapters/slackAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slackAdapter.js","sourceRoot":"","sources":["../../../src/im/adapters/slackAdapter.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAW1C,MAAM,OAAO,YAAY;IAQM;IAPpB,IAAI,GAAG,OAAO,CAAC;IACP,KAAK,CAAqB;IACnC,OAAO,GAA4B,IAAI,CAAC;IACxC,EAAE,GAAqB,IAAI,CAAC;IAC5B,OAAO,GAAG,KAAK,CAAC;IAChB,UAAU,GAAG,EAAE,CAAC;IAExB,YAA6B,GAAgB;QAAhB,QAAG,GAAH,GAAG,CAAa;QAC3C,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACrG,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACjF,CAAC;IAED,SAAS,CAAC,OAAyB;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,kCAAkC;QAClC,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAyB,CAAC;QACxG,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACrB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;YAC3B,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,IAAI,IAAI,CAAC,OAAO;oBAAE,MAAM;gBACxB,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACjE,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACP,UAAU;QACZ,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,WAAW;QACvB,MAAM,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,uBAAuB,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAmD,CAAC;QACzH,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC,KAAK,IAAI,QAAQ,EAAE,CAAC,CAAC;QACxF,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,MAAM,EAAE,GAAG,IAAI,SAAS,CAAC,CAAC,CAAC,GAAI,CAAC,CAAC;YACjC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;YACb,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAE,EAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC5F,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YAC9C,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;QAC3E,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,OAAO,CAAC,EAAa,EAAE,GAAW;QACxC,IAAI,CAAqE,CAAC;QAC1E,IAAI,CAAC;YACH,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QACD,yCAAyC;QACzC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;YAClB,IAAI,CAAC;gBACH,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;YAC1D,CAAC;YAAC,MAAM,CAAC;gBACP,UAAU;YACZ,CAAC;QACH,CAAC;QACD,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,YAAY;YAAE,OAAO;QAC1D,IAAI,CAAC,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC3C,IAAI,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACtD,IAAI,CAAC,GAAG,CAAC,aAAa,GAAG,CAAC,MAAM,KAAK,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;gBAC5E,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC5H,CAAC;QACH,CAAC;IACH,CAAC;IAEO,OAAO,CAAC,CAAM;QACpB,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QAC5C,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,CAAC,aAAa;QACrD,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,UAAU;YAAE,OAAO,IAAI,CAAC,CAAC,OAAO;QACpD,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACzC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QACrC,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,QAAQ,EAAE,CAAC,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO;YACvD,MAAM,EAAE,CAAC,CAAC,OAAO;YACjB,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE;YACtB,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;YAC/B,SAAS,EAAE,CAAC,CAAC,EAAE;YACf,GAAG,EAAE,CAAC;SACP,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAkB,EAAE,OAAqB;QAClD,MAAM,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAChH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAc,EAAE,OAAqB;QAC/C,MAAM,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC/G,CAAC;IAED,cAAc;QACZ,OAAO,KAAK,CAAC,CAAC,0CAA0C;IAC1D,CAAC;IAEO,SAAS,CAAC,MAAc;QAC9B,OAAO,IAAI,CAAC,KAAK,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtD,CAAC;IAEO,KAAK,CAAC,GAAG,CAAC,MAAc,EAAE,KAAa,EAAE,IAA8B;QAC7E,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,yBAAyB,MAAM,EAAE,EAAE;YACzD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE,cAAc,EAAE,iCAAiC,EAAE;YAChG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChD,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACtC,CAAC;IAEO,GAAG,CAAC,GAAW;QACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC9C,CAAC;CACF"}

package/dist/im/adapters/telegramAdapter.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @module        im/adapters/telegramAdapter
+ * @description   Telegram 适配器,移植自 LangBot `sources/telegram.py`(long-poll 入站,零公网回调)。
+ *                入站:getUpdates 长轮询 → 转 IMEvent → onMessage;出站:sendMessage;流式:editMessageText
+ *                累积编辑同一条消息。用原生 fetch(Node18+),不引第三方 SDK。
+ * @layer         im
+ * @boundedContext im-gateway
+ */
+import type { IMAdapter, IMMessageHandler } from '../IMAdapter.js';
+import type { IMEvent, MessageChain, SendTarget } from '../types.js';
+export interface TelegramConfig {
+    /** Bot token(@BotFather 给的)。 */
+    token: string;
+    /** 允许的 chatId 白名单(空=全放,生产建议设)。安全:只有名单内会话能触发命令。 */
+    allowedChatIds?: (string | number)[];
+    /** 长轮询超时秒(默认 30)。 */
+    pollTimeoutSec?: number;
+}
+export declare class TelegramAdapter implements IMAdapter {
+    private readonly config;
+    readonly kind = "telegram";
+    private readonly api;
+    private readonly allow;
+    private readonly pollTimeout;
+    private handler;
+    private offset;
+    private stopped;
+    constructor(config: TelegramConfig);
+    onMessage(handler: IMMessageHandler): void;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    send(target: SendTarget, message: MessageChain): Promise<void>;
+    reply(event: IMEvent, message: MessageChain): Promise<void>;
+    supportsStream(): boolean;
+    /** 流式回复:先发一条,再随增量 editMessageText;节流避免触发 Telegram 编辑频率限制。
+     *  期间用 sendChatAction('typing') 显示"正在回复…"状态(约 5s 有效,循环刷新)。 */
+    replyChunk(event: IMEvent, chunks: AsyncIterable<string>): Promise<void>;
+    private passAllow;
+    private toEvent;
+    private call;
+    private log;
+}
+//# sourceMappingURL=telegramAdapter.d.ts.map

package/dist/im/adapters/telegramAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegramAdapter.d.ts","sourceRoot":"","sources":["../../../src/im/adapters/telegramAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAY,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG/E,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,cAAc,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IACrC,qBAAqB;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,eAAgB,YAAW,SAAS;IASnC,OAAO,CAAC,QAAQ,CAAC,MAAM;IARnC,QAAQ,CAAC,IAAI,cAAc;IAC3B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,OAAO,CAAS;gBAEK,MAAM,EAAE,cAAc;IAOnD,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAIpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAoCtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9D,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjE,cAAc,IAAI,OAAO;IAIzB;kEAC8D;IACxD,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAkC9E,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,OAAO;YAgBD,IAAI;IAWlB,OAAO,CAAC,GAAG;CAGZ"}