agim-cli 1.0.1

package/dist/plugins/messengers/dingtalk/dingtalk-client.js

@@ -0,0 +1,236 @@
+// DingTalk Bot client — wraps the official `dingtalk-stream` SDK for
+// inbound messages (WebSocket Stream mode) and uses DingTalk's REST
+// OpenAPI for outbound messages.
+//
+// Architecture matches the Feishu client:
+//   * Inbound goes through TOPIC_ROBOT callback registered with DWClient
+//   * Outbound uses access-token-authed POST to api.dingtalk.com
+//   * The SDK manages WebSocket reconnect (1s-60s exponential), heartbeat,
+//     and access-token refresh — we just call getAccessToken() before
+//     each OpenAPI send and the SDK caches/refreshes as needed.
+//
+// Why not sessionWebhook (the temporary 30s URL each inbound message
+// carries)?  Because im-hub's primary use case is multi-minute agent
+// runs and the sessionWebhook is always stale by the time the agent
+// finishes. OpenAPI works for any send regardless of elapsed time.
+import { DWClient, TOPIC_ROBOT } from 'dingtalk-stream';
+import { logger as rootLogger } from '../../../core/logger.js';
+const log = rootLogger.child({ component: 'dingtalk-client' });
+const API_BASE = 'https://api.dingtalk.com';
+const URL_1V1 = `${API_BASE}/v1.0/robot/oToMessages/batchSend`;
+const URL_GROUP = `${API_BASE}/v1.0/robot/groupMessages/send`;
+const URL_MEDIA_DL = `${API_BASE}/v1.0/robot/messageFiles/download`;
+/** Hard cap on a single inbound media download. DingTalk caps voice at
+ *  ~2 MB and images at ~10 MB on the consumer client; 20 MB gives us
+ *  headroom for files without letting a runaway upload fill the disk. */
+const MAX_MEDIA_BYTES = 20 * 1024 * 1024;
+function parseThreadId(threadId) {
+    if (threadId.startsWith('user:')) {
+        return { kind: 'user', id: threadId.slice('user:'.length) };
+    }
+    if (threadId.startsWith('group:')) {
+        return { kind: 'group', id: threadId.slice('group:'.length) };
+    }
+    return null;
+}
+export class DingTalkClient {
+    dw;
+    config;
+    messageHandler;
+    /** Cached robotCode from the most recent inbound (== clientId for
+     *  stream-mode internal apps, but we read it from messages so we're
+     *  tolerant of multi-bot setups in one app). */
+    lastSeenRobotCode;
+    constructor(config) {
+        this.config = config;
+        this.lastSeenRobotCode = config.clientId; // sensible default
+        this.dw = new DWClient({
+            clientId: config.clientId,
+            clientSecret: config.clientSecret,
+            // DWClient defaults: autoReconnect=true, debug=false, keepAlive=false.
+            // Reconnect strategy is 1s → 60s exponential, heartbeat 8s — already
+            // matches our needs.
+        });
+    }
+    onMessage(handler) {
+        this.messageHandler = handler;
+    }
+    async start() {
+        this.dw.registerCallbackListener(TOPIC_ROBOT, async (res) => {
+            let msg;
+            try {
+                msg = JSON.parse(res.data);
+            }
+            catch (err) {
+                log.warn({ err: err instanceof Error ? err.message : String(err), data: res.data?.slice?.(0, 200) }, 'failed to parse TOPIC_ROBOT data');
+                return;
+            }
+            if (msg.robotCode)
+                this.lastSeenRobotCode = msg.robotCode;
+            if (this.messageHandler) {
+                try {
+                    await this.messageHandler(msg);
+                }
+                catch (err) {
+                    log.error({ err: err instanceof Error ? err.message : String(err) }, 'message handler threw');
+                }
+            }
+            // ack so the gateway doesn't redeliver. We're swallowing the
+            // response payload here intentionally — DingTalk gives 60s before
+            // it retries; our agent flow may exceed that and that's fine,
+            // the user gets the eventual reply via OpenAPI.
+            this.dw.socketCallBackResponse(res.headers.messageId, { status: 'SUCCESS' });
+        });
+        await this.dw.connect();
+        log.info({ event: 'dingtalk.client.connected' }, 'WebSocket connected');
+    }
+    async stop() {
+        try {
+            this.dw.disconnect();
+        }
+        catch (err) {
+            log.warn({ err: err instanceof Error ? err.message : String(err) }, 'error during dingtalk disconnect (ignored)');
+        }
+    }
+    /** Send a plain-text message to a thread we previously received from
+     *  (encoded as `user:<staffId>` for 1:1, `group:<convId>` for groups).
+     *  Uses OpenAPI under the bot's access token. */
+    async sendMessage(threadId, text) {
+        await this.sendTemplated(threadId, 'sampleText', { content: text });
+    }
+    /** Send a markdown-formatted message. DingTalk's `sampleMarkdown` only
+     *  takes `title` + `text`; we derive title from the first line so the
+     *  user sees something meaningful in the notification preview. */
+    async sendMarkdown(threadId, text, title) {
+        const firstLine = text.split('\n', 1)[0]?.replace(/^[#*\-\s>]+/, '').slice(0, 32) || 'Message';
+        await this.sendTemplated(threadId, 'sampleMarkdown', {
+            title: title ?? firstLine,
+            text,
+        });
+    }
+    /** Download an inbound image / voice / file message's binary payload.
+     *
+     *  DingTalk hands the bot a short-lived `downloadCode` in each media
+     *  inbound; we trade it (plus our robotCode) for a presigned downloadUrl
+     *  on alibaba CDN, then GET that URL and return the bytes.
+     *
+     *  Returns null on any error (caller surfaces a "[download failed:...]"
+     *  marker instead of silently dropping the user's message). MAX cap is
+     *  enforced; oversize payloads throw before allocating the buffer.
+     *
+     *  Reference: POST /v1.0/robot/messageFiles/download
+     *             { downloadCode, robotCode }
+     *             header: x-acs-dingtalk-access-token
+     *             response: { downloadUrl }   (sometimes nested under .data)
+     */
+    async downloadMessageFile(downloadCode) {
+        if (!downloadCode)
+            return null;
+        let accessToken;
+        try {
+            accessToken = await this.dw.getAccessToken();
+        }
+        catch (err) {
+            log.warn({ err: err instanceof Error ? err.message : String(err) }, 'dingtalk: getAccessToken failed before media download');
+            return null;
+        }
+        if (!accessToken)
+            return null;
+        // Step 1: exchange downloadCode for a CDN URL.
+        let downloadUrl = null;
+        try {
+            const res = await fetch(URL_MEDIA_DL, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'x-acs-dingtalk-access-token': String(accessToken),
+                },
+                body: JSON.stringify({ downloadCode, robotCode: this.lastSeenRobotCode }),
+            });
+            if (!res.ok) {
+                const txt = await res.text().catch(() => '');
+                log.warn({
+                    status: res.status,
+                    body: txt.slice(0, 200),
+                    event: 'dingtalk.media.exchange_failed',
+                }, 'messageFiles/download API rejected the downloadCode exchange');
+                return null;
+            }
+            const payload = await res.json().catch(() => null);
+            downloadUrl = payload?.downloadUrl ?? payload?.data?.downloadUrl ?? null;
+            if (!downloadUrl) {
+                log.warn({ event: 'dingtalk.media.no_url_in_response', payload }, 'exchange succeeded but response had no downloadUrl');
+                return null;
+            }
+        }
+        catch (err) {
+            log.warn({ err: err instanceof Error ? err.message : String(err) }, 'dingtalk: downloadCode exchange threw');
+            return null;
+        }
+        // Step 2: GET the CDN URL. DingTalk's CDN may be on different alibaba
+        // hosts depending on the file type / region; no host restriction here.
+        try {
+            const res = await fetch(downloadUrl);
+            if (!res.ok) {
+                log.warn({ status: res.status, event: 'dingtalk.media.cdn_get_failed' }, 'CDN refused the download');
+                return null;
+            }
+            const contentLength = parseInt(res.headers.get('content-length') ?? '0', 10);
+            if (Number.isFinite(contentLength) && contentLength > MAX_MEDIA_BYTES) {
+                log.warn({ contentLength, max: MAX_MEDIA_BYTES, event: 'dingtalk.media.too_large' }, 'media exceeds size cap; refusing to download');
+                return null;
+            }
+            const arr = await res.arrayBuffer();
+            if (arr.byteLength > MAX_MEDIA_BYTES) {
+                log.warn({ bytes: arr.byteLength, max: MAX_MEDIA_BYTES, event: 'dingtalk.media.too_large' }, 'media bytes exceed size cap after download');
+                return null;
+            }
+            const contentType = res.headers.get('content-type') ?? 'application/octet-stream';
+            return { buffer: Buffer.from(arr), contentType };
+        }
+        catch (err) {
+            log.warn({ err: err instanceof Error ? err.message : String(err) }, 'dingtalk: CDN GET threw');
+            return null;
+        }
+    }
+    /** Shared POST path. msgKey + msgParam (stringified inner object) is
+     *  DingTalk's "templated message" convention — covers text, markdown,
+     *  cards via the same endpoint. */
+    async sendTemplated(threadId, msgKey, inner) {
+        const target = parseThreadId(threadId);
+        if (!target) {
+            throw new Error(`dingtalk: unrecognised threadId "${threadId}" (expected user:<id> or group:<id>)`);
+        }
+        const accessToken = await this.dw.getAccessToken();
+        if (!accessToken) {
+            throw new Error('dingtalk: getAccessToken() returned empty token');
+        }
+        const body = target.kind === 'user'
+            ? {
+                robotCode: this.lastSeenRobotCode,
+                userIds: [target.id],
+                msgKey,
+                msgParam: JSON.stringify(inner),
+            }
+            : {
+                robotCode: this.lastSeenRobotCode,
+                openConversationId: target.id,
+                msgKey,
+                msgParam: JSON.stringify(inner),
+            };
+        const url = target.kind === 'user' ? URL_1V1 : URL_GROUP;
+        const res = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'x-acs-dingtalk-access-token': String(accessToken),
+            },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const txt = await res.text().catch(() => '');
+            throw new Error(`dingtalk: ${target.kind} send failed: ${res.status} ${res.statusText} ${txt.slice(0, 200)}`);
+        }
+    }
+}
+//# sourceMappingURL=dingtalk-client.js.map

package/dist/plugins/messengers/dingtalk/dingtalk-client.js.map

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

package/dist/plugins/messengers/dingtalk/index.d.ts

@@ -0,0 +1,3 @@
+export { dingtalkAdapter, DingTalkAdapter } from './dingtalk-adapter.js';
+export type { DingTalkConfig, DingTalkInboundMessage } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/messengers/dingtalk/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/messengers/dingtalk/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACxE,YAAY,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA"}

package/dist/plugins/messengers/dingtalk/index.js

@@ -0,0 +1,3 @@
+// DingTalk (钉钉) Stream-mode messenger adapter.
+export { dingtalkAdapter, DingTalkAdapter } from './dingtalk-adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/plugins/messengers/dingtalk/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/plugins/messengers/dingtalk/index.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/plugins/messengers/dingtalk/link-coords.d.ts

@@ -0,0 +1,23 @@
+/** What coord system the URL's host implies. Drives which conversion
+ *  `normalizeIncomingCoords` applies on the extracted lat/lng. */
+export type MapUrlSource = 'dingtalk-link-amap' | 'dingtalk-link-tencent' | 'dingtalk-link-baidu' | 'dingtalk-link-unknown';
+/** Best-effort lat/lng extraction from common map URLs.
+ *
+ * Returns null if the URL doesn't look like a map share. On hit, also
+ * returns the `source` so the caller can route through
+ * `normalizeIncomingCoords()` for the right coord-system conversion:
+ *   - Amap / Gaode      → GCJ-02
+ *   - Tencent (map.qq)  → GCJ-02
+ *   - Baidu Maps        → BD-09
+ *   - Anything else     → pass-through (we don't guess for unknown hosts)
+ *
+ * Parses these URL shapes:
+ *   - Amap:    `uri.amap.com/marker?position=lng,lat`
+ *   - Tencent: `apis.map.qq.com/uri/v1/marker?marker=coord:lat,lng`
+ *   - Generic: `?location=lat,lng`, `?latlng=lat,lng`, `?lat=…&lng=…` */
+export declare function tryExtractLatLng(url: string): {
+    lat: number;
+    lng: number;
+    source: MapUrlSource;
+} | null;
+//# sourceMappingURL=link-coords.d.ts.map

package/dist/plugins/messengers/dingtalk/link-coords.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-coords.d.ts","sourceRoot":"","sources":["../../../../src/plugins/messengers/dingtalk/link-coords.ts"],"names":[],"mappings":"AASA;kEACkE;AAClE,MAAM,MAAM,YAAY,GACpB,oBAAoB,GACpB,uBAAuB,GACvB,qBAAqB,GACrB,uBAAuB,CAAA;AAmB3B;;;;;;;;;;;;;yEAayE;AACzE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GAAG,IAAI,CA+CvG"}

package/dist/plugins/messengers/dingtalk/link-coords.js

@@ -0,0 +1,89 @@
+// Map-URL coordinate extraction for DingTalk `link` msgtype payloads.
+//
+// Kept in a separate file (rather than inline in dingtalk-adapter.ts)
+// because the adapter pulls in heavy modules — `media-store.ts`,
+// `dingtalk-stream`, the transcribe / location-context machinery — that
+// each can have side effects at import time (env-var capture, file
+// handles, etc.). Tests for the URL classifier should not pay that cost
+// or risk pulling in process-wide state.
+function classifyHost(host) {
+    const h = host.toLowerCase();
+    if (h.endsWith('.amap.com') || h === 'amap.com' || h.endsWith('.gaode.com') || h === 'gaode.com') {
+        return 'dingtalk-link-amap';
+    }
+    if (h.endsWith('.qq.com') || h === 'qq.com') {
+        // Tencent's map endpoints: map.qq.com, apis.map.qq.com, lbs.qq.com.
+        // Other *.qq.com URLs (chat / mail) shouldn't legitimately carry
+        // map coords; if they do, GCJ-02 is the safe assumption.
+        return 'dingtalk-link-tencent';
+    }
+    if (h.endsWith('.baidu.com') || h === 'baidu.com') {
+        return 'dingtalk-link-baidu';
+    }
+    return 'dingtalk-link-unknown';
+}
+/** Best-effort lat/lng extraction from common map URLs.
+ *
+ * Returns null if the URL doesn't look like a map share. On hit, also
+ * returns the `source` so the caller can route through
+ * `normalizeIncomingCoords()` for the right coord-system conversion:
+ *   - Amap / Gaode      → GCJ-02
+ *   - Tencent (map.qq)  → GCJ-02
+ *   - Baidu Maps        → BD-09
+ *   - Anything else     → pass-through (we don't guess for unknown hosts)
+ *
+ * Parses these URL shapes:
+ *   - Amap:    `uri.amap.com/marker?position=lng,lat`
+ *   - Tencent: `apis.map.qq.com/uri/v1/marker?marker=coord:lat,lng`
+ *   - Generic: `?location=lat,lng`, `?latlng=lat,lng`, `?lat=…&lng=…` */
+export function tryExtractLatLng(url) {
+    if (!url || typeof url !== 'string')
+        return null;
+    try {
+        const u = new URL(url);
+        const source = classifyHost(u.hostname);
+        const params = u.searchParams;
+        // Amap: ?position=lng,lat
+        const position = params.get('position');
+        if (position) {
+            const [lngStr, latStr] = position.split(',');
+            const lng = parseFloat(lngStr);
+            const lat = parseFloat(latStr);
+            if (Number.isFinite(lat) && Number.isFinite(lng))
+                return { lat, lng, source };
+        }
+        // Tencent: ?marker=coord:lat,lng;title:...
+        const marker = params.get('marker');
+        if (marker?.startsWith('coord:')) {
+            const coord = marker.slice('coord:'.length).split(';')[0];
+            const [latStr, lngStr] = coord.split(',');
+            const lat = parseFloat(latStr);
+            const lng = parseFloat(lngStr);
+            if (Number.isFinite(lat) && Number.isFinite(lng))
+                return { lat, lng, source };
+        }
+        // Generic ?location=lat,lng OR ?latlng=lat,lng
+        const loc = params.get('location') ?? params.get('latlng');
+        if (loc) {
+            const [latStr, lngStr] = loc.split(',');
+            const lat = parseFloat(latStr);
+            const lng = parseFloat(lngStr);
+            if (Number.isFinite(lat) && Number.isFinite(lng))
+                return { lat, lng, source };
+        }
+        // Separate ?lat=...&lng=... (or &lon=...)
+        const latParam = params.get('lat') ?? params.get('latitude');
+        const lngParam = params.get('lng') ?? params.get('lon') ?? params.get('longitude');
+        if (latParam && lngParam) {
+            const lat = parseFloat(latParam);
+            const lng = parseFloat(lngParam);
+            if (Number.isFinite(lat) && Number.isFinite(lng))
+                return { lat, lng, source };
+        }
+    }
+    catch {
+        /* URL didn't parse — not a map share we can read. */
+    }
+    return null;
+}
+//# sourceMappingURL=link-coords.js.map

package/dist/plugins/messengers/dingtalk/link-coords.js.map

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

package/dist/plugins/messengers/dingtalk/media-store.d.ts

@@ -0,0 +1,16 @@
+/** Pick a sensible extension for a buffer based on (in order):
+ *    1. content-type header from the CDN response
+ *    2. the original filename (for msgtype='file') if it has one
+ *    3. fallback 'bin' so the file is always inspectable on disk
+ *
+ *  Same map shape as telegram's pickExtension but DingTalk also delivers
+ *  voice as audio/amr — distinct from anything telegram sees. */
+export declare function pickDingTalkExtension(contentType: string | undefined, originalFilename: string | undefined): string;
+/** Write `buffer` to `<MEDIA_ROOT>/dingtalk/<subPath>/<filename>` and
+ *  return the absolute path. Refuses path-traversal in filename / subPath
+ *  (segments containing `/`, `\`, or `..` are rejected before mkdir).
+ *
+ *  Caller is responsible for the size cap — `dingtalk-client.ts`
+ *  already enforces MAX_MEDIA_BYTES before handing us the buffer. */
+export declare function saveDingTalkMedia(buffer: Buffer, subPath: string, filename: string): Promise<string>;
+//# sourceMappingURL=media-store.d.ts.map

package/dist/plugins/messengers/dingtalk/media-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-store.d.ts","sourceRoot":"","sources":["../../../../src/plugins/messengers/dingtalk/media-store.ts"],"names":[],"mappings":"AAgBA;;;;;;iEAMiE;AACjE,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,gBAAgB,EAAE,MAAM,GAAG,SAAS,GACnC,MAAM,CA2BR;AAED;;;;;qEAKqE;AACrE,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAiBjB"}

package/dist/plugins/messengers/dingtalk/media-store.js

@@ -0,0 +1,77 @@
+// DingTalk inbound media → local disk.
+//
+// We piggyback on telegram's MEDIA_ROOT so both adapters land their
+// attachments in the same ~/.im-hub/media/<platform>/<thread>/ tree.
+// That keeps `cleanupOldMedia` (running on the telegram side) covering
+// everything, and matches how claude-code's Read tool already expects
+// to find adjuncts referenced by `[图片附件：…]` markers.
+//
+// Why a separate file from `dingtalk-client.ts`? The client's job is the
+// network round-trip; the on-disk format and path-injection guards live
+// here so they can be unit-tested without spinning up a DWClient.
+import { mkdir, writeFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { MEDIA_ROOT } from '../telegram/media-download.js';
+/** Pick a sensible extension for a buffer based on (in order):
+ *    1. content-type header from the CDN response
+ *    2. the original filename (for msgtype='file') if it has one
+ *    3. fallback 'bin' so the file is always inspectable on disk
+ *
+ *  Same map shape as telegram's pickExtension but DingTalk also delivers
+ *  voice as audio/amr — distinct from anything telegram sees. */
+export function pickDingTalkExtension(contentType, originalFilename) {
+    if (originalFilename) {
+        const m = /\.([a-z0-9]+)$/i.exec(originalFilename);
+        if (m)
+            return m[1].toLowerCase();
+    }
+    if (contentType) {
+        const map = {
+            'image/jpeg': 'jpg',
+            'image/jpg': 'jpg',
+            'image/png': 'png',
+            'image/gif': 'gif',
+            'image/webp': 'webp',
+            'image/heic': 'heic',
+            'audio/amr': 'amr',
+            'audio/x-amr': 'amr',
+            'audio/mpeg': 'mp3',
+            'audio/mp4': 'm4a',
+            'audio/ogg': 'ogg',
+            'audio/wav': 'wav',
+            'application/pdf': 'pdf',
+        };
+        const ct = contentType.toLowerCase().split(';')[0].trim();
+        if (map[ct])
+            return map[ct];
+        const m = /\/([a-z0-9]+)$/i.exec(ct);
+        if (m)
+            return m[1].toLowerCase();
+    }
+    return 'bin';
+}
+/** Write `buffer` to `<MEDIA_ROOT>/dingtalk/<subPath>/<filename>` and
+ *  return the absolute path. Refuses path-traversal in filename / subPath
+ *  (segments containing `/`, `\`, or `..` are rejected before mkdir).
+ *
+ *  Caller is responsible for the size cap — `dingtalk-client.ts`
+ *  already enforces MAX_MEDIA_BYTES before handing us the buffer. */
+export async function saveDingTalkMedia(buffer, subPath, filename) {
+    for (const piece of [subPath, filename]) {
+        if (piece.includes('..') || piece.includes('\\')) {
+            throw new Error(`unsafe path piece: ${piece}`);
+        }
+    }
+    if (filename.includes('/')) {
+        throw new Error(`unsafe filename: ${filename}`);
+    }
+    const dir = resolve(MEDIA_ROOT, 'dingtalk', subPath);
+    const path = resolve(dir, filename);
+    if (!path.startsWith(`${MEDIA_ROOT}/`)) {
+        throw new Error(`destination escapes MEDIA_ROOT: ${path}`);
+    }
+    await mkdir(dir, { recursive: true });
+    await writeFile(path, buffer);
+    return path;
+}
+//# sourceMappingURL=media-store.js.map

package/dist/plugins/messengers/dingtalk/media-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-store.js","sourceRoot":"","sources":["../../../../src/plugins/messengers/dingtalk/media-store.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,EAAE;AACF,oEAAoE;AACpE,qEAAqE;AACrE,uEAAuE;AACvE,sEAAsE;AACtE,qDAAqD;AACrD,EAAE;AACF,yEAAyE;AACzE,wEAAwE;AACxE,kEAAkE;AAElE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAA;AAE1D;;;;;;iEAMiE;AACjE,MAAM,UAAU,qBAAqB,CACnC,WAA+B,EAC/B,gBAAoC;IAEpC,IAAI,gBAAgB,EAAE,CAAC;QACrB,MAAM,CAAC,GAAG,iBAAiB,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;QAClD,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;IAClC,CAAC;IACD,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,GAAG,GAA2B;YAClC,YAAY,EAAE,KAAK;YACnB,WAAW,EAAE,KAAK;YAClB,WAAW,EAAE,KAAK;YAClB,WAAW,EAAE,KAAK;YAClB,YAAY,EAAE,MAAM;YACpB,YAAY,EAAE,MAAM;YACpB,WAAW,EAAE,KAAK;YAClB,aAAa,EAAE,KAAK;YACpB,YAAY,EAAE,KAAK;YACnB,WAAW,EAAE,KAAK;YAClB,WAAW,EAAE,KAAK;YAClB,WAAW,EAAE,KAAK;YAClB,iBAAiB,EAAE,KAAK;SACzB,CAAA;QACD,MAAM,EAAE,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QACzD,IAAI,GAAG,CAAC,EAAE,CAAC;YAAE,OAAO,GAAG,CAAC,EAAE,CAAC,CAAA;QAC3B,MAAM,CAAC,GAAG,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACpC,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;IAClC,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;;qEAKqE;AACrE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAc,EACd,OAAe,EACf,QAAgB;IAEhB,KAAK,MAAM,KAAK,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;QACxC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACjD,MAAM,IAAI,KAAK,CAAC,sBAAsB,KAAK,EAAE,CAAC,CAAA;QAChD,CAAC;IACH,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,oBAAoB,QAAQ,EAAE,CAAC,CAAA;IACjD,CAAC;IACD,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,CAAC,CAAA;IACpD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;IACnC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,UAAU,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,mCAAmC,IAAI,EAAE,CAAC,CAAA;IAC5D,CAAC;IACD,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACrC,MAAM,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAC7B,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/plugins/messengers/dingtalk/types.d.ts

@@ -0,0 +1,82 @@
+export interface DingTalkConfig {
+    /** AppKey from the DingTalk developer console (also serves as robotCode). */
+    clientId: string;
+    /** AppSecret — used by the SDK to obtain access tokens automatically. */
+    clientSecret: string;
+    /** Optional channel id (forwarded to MessageContext); we don't drive
+     *  routing on it but a few downstream consumers tag logs by it. */
+    channelId?: string;
+}
+/** Inbound message payload from the Stream SDK's TOPIC_ROBOT callback.
+ *  Empirically observed msgtype values (community docs say `image`/`voice`
+ *  but DingTalk actually wire-formats them as `picture`/`audio`):
+ *    'text' | 'picture' | 'audio' | 'file' | 'link' | 'markdown' | 'action_card'
+ *  The official Node SDK only types `text`; we keep msgtype as a loose
+ *  string and snapshot known shapes for the rest. Unknown shapes fall
+ *  through to a debug-logging path that dumps the full payload — that's
+ *  how we discovered the `picture`/`audio` naming + the `content` block
+ *  shape (community docs document those fields under `msg.picture` etc.,
+ *  but real deliveries put them inside a single `content` object). */
+export interface DingTalkInboundMessage {
+    /** Unique message id for dedup. */
+    msgId: string;
+    /** One of the empirically-confirmed msgtype values, or something else. */
+    msgtype: string;
+    /** Present on msgtype='text'. */
+    text?: {
+        content: string;
+    };
+    /** Present on msgtype='link'. picUrl is the thumbnail; messageUrl is
+     *  the deep link / URL the user actually shared. Title/text are
+     *  display preview. */
+    link?: {
+        title?: string;
+        text?: string;
+        picUrl?: string;
+        messageUrl?: string;
+    };
+    /** Catch-all `content` block — used by every non-text/non-link msgtype.
+     *  Different msgtype values use different subsets of the fields below:
+     *    picture: { pictureDownloadCode (full), downloadCode (thumb) }
+     *    audio:   { downloadCode, recognition (DingTalk's server-side ASR!) }
+     *    file:    { downloadCode, fileName }     (best-effort from docs)
+     *    markdown / action_card: { text, title } (best-effort) */
+    content?: {
+        pictureDownloadCode?: string;
+        downloadCode?: string;
+        /** DingTalk's built-in voice-to-text for `audio` messages. Prefer
+         *  this over running whisper.cpp locally — it's typically more
+         *  accurate for Mandarin and zero-cost on our side. */
+        recognition?: string;
+        title?: string;
+        text?: string;
+        fileName?: string;
+        duration?: string | number;
+    };
+    /** Conversation id in OpenAPI's `openConversationId` shape — usable
+     *  directly when calling /v1.0/robot/groupMessages/send. */
+    conversationId: string;
+    /** '1' = single chat (1:1), '2' = group chat. */
+    conversationType: '1' | '2' | string;
+    /** Internal staff id of the message sender (use in 1:1 send userIds). */
+    senderStaffId: string;
+    senderNick?: string;
+    senderCorpId?: string;
+    /** Bot's own ids (chatbotUserId = robot's user id inside the corp). */
+    chatbotUserId?: string;
+    chatbotCorpId?: string;
+    /** The bot's robotCode — same value as the configured AppKey/clientId
+     *  for stream-mode internal apps, but we read it from the message so
+     *  we don't have to hard-code the relationship. */
+    robotCode: string;
+    /** Temporary webhook URL the bot can POST to without an access token,
+     *  valid until `sessionWebhookExpiredTime` (ms epoch). 30s in practice. */
+    sessionWebhook?: string;
+    sessionWebhookExpiredTime?: number;
+    createAt?: number;
+    isAdmin?: boolean;
+    /** Catch-all for unknown fields — we never index this in code, but
+     *  preserving it lets the debug-log path dump the full payload. */
+    [extra: string]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/plugins/messengers/dingtalk/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/plugins/messengers/dingtalk/types.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAA;IAChB,yEAAyE;IACzE,YAAY,EAAE,MAAM,CAAA;IACpB;uEACmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;;sEASsE;AACtE,MAAM,WAAW,sBAAsB;IACrC,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAA;IACf,iCAAiC;IACjC,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;IAC1B;;2BAEuB;IACvB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9E;;;;;kEAK8D;IAC9D,OAAO,CAAC,EAAE;QACR,mBAAmB,CAAC,EAAE,MAAM,CAAA;QAC5B,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB;;+DAEuD;QACvD,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAC3B,CAAA;IACD;gEAC4D;IAC5D,cAAc,EAAE,MAAM,CAAA;IACtB,iDAAiD;IACjD,gBAAgB,EAAE,GAAG,GAAG,GAAG,GAAG,MAAM,CAAA;IACpC,yEAAyE;IACzE,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;uDAEmD;IACnD,SAAS,EAAE,MAAM,CAAA;IACjB;+EAC2E;IAC3E,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,yBAAyB,CAAC,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;uEACmE;IACnE,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;CACzB"}

package/dist/plugins/messengers/dingtalk/types.js

@@ -0,0 +1,14 @@
+// DingTalk (钉钉) Bot — Stream-mode messenger types
+//
+// Reference:
+//   * SDK: https://github.com/open-dingtalk/dingtalk-stream-sdk-nodejs
+//   * Stream mode protocol: https://open.dingtalk.com/document/direction/stream-mode-protocol-access-description
+//   * 1:1 send: POST /v1.0/robot/oToMessages/batchSend
+//   * Group send: POST /v1.0/robot/groupMessages/send
+//
+// Note: the SDK's RobotTextMessage type covers only `msgtype: 'text'`, but
+// inbound payloads carry conversationType / robotCode / sessionWebhook
+// that we need for routing — restate the full shape here so the adapter
+// can switch on conversationType without fighting the SDK union.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/plugins/messengers/dingtalk/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/plugins/messengers/dingtalk/types.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,EAAE;AACF,aAAa;AACb,uEAAuE;AACvE,iHAAiH;AACjH,uDAAuD;AACvD,sDAAsD;AACtD,EAAE;AACF,2EAA2E;AAC3E,uEAAuE;AACvE,wEAAwE;AACxE,iEAAiE"}

package/dist/plugins/messengers/discord/discord-adapter.d.ts

@@ -0,0 +1,21 @@
+import type { MessengerAdapter, MessageContext } from '../../../core/types.js';
+export declare class DiscordAdapter implements MessengerAdapter {
+    readonly name = "discord";
+    private client;
+    private config;
+    private messageHandler?;
+    private typingIntervals;
+    /** L7: companion AbortController per typing thread. Lets the periodic
+     *  refresh callback bail BEFORE invoking sendTyping when stop() has
+     *  fired, instead of racing against client.destroy(). */
+    private typingAbortControllers;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    onMessage(handler: (ctx: MessageContext) => Promise<void>): void;
+    sendMessage(threadId: string, text: string): Promise<void>;
+    sendTyping(threadId: string, isTyping: boolean): Promise<void>;
+    private fetchSendableChannel;
+    private handleDiscordMessage;
+}
+export declare const discordAdapter: DiscordAdapter;
+//# sourceMappingURL=discord-adapter.d.ts.map

package/dist/plugins/messengers/discord/discord-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discord-adapter.d.ts","sourceRoot":"","sources":["../../../../src/plugins/messengers/discord/discord-adapter.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAW,MAAM,wBAAwB,CAAA;AAWvF,qBAAa,cAAe,YAAW,gBAAgB;IACrD,QAAQ,CAAC,IAAI,aAAY;IACzB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,cAAc,CAAC,CAAwC;IAC/D,OAAO,CAAC,eAAe,CAAoD;IAC3E;;6DAEyD;IACzD,OAAO,CAAC,sBAAsB,CAAqC;IAE7D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA0DtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB3B,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAI1D,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB1D,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;YA4DtD,oBAAoB;YAcpB,oBAAoB;CAyDnC;AAGD,eAAO,MAAM,cAAc,gBAAuB,CAAA"}