@krischoichoi/channel-dingtalk 0.6.0

package/lib/outbound.d.ts

@@ -0,0 +1,69 @@
+/***
+ * Outbound sending: channel message -> dingtalk payload -> upstream.
+ *
+ * Two explicit send paths:
+ *   - REPLY: the target carries an inbound `sessionWebhook` (or the upstream is
+ *     the legacy gateway, which has no proactive path). sessionWebhook belongs
+ *     ONLY to the current inbound reply — never a durable outbox route.
+ *   - PROACTIVE: a target with no reply context / an arbitrary conversation id
+ *     is sent through the official proactive OpenAPI port (`sendProactiveText`,
+ *     and proactive media via `uploadMedia` + `sendMedia`) — never via a stale
+ *     sessionWebhook.
+ *
+ * Capability flags (`outboxCapabilities`) fail CLOSED: they only read
+ * `true` when the matching official path is actually wired. Streaming replies go
+ * through `DingTalkCardReply`; this sender is the buffered fallback path
+ * (`adapter.send`) used when no card was created.
+ */
+import type { ChannelLogger, ChannelTarget, OutboundMessage, SendResult } from '@krischoichoi/channel-core';
+import type { DingTalkUpstream } from './upstream.js';
+import type { DingTalkOpenApiPort, OutboxCapabilities } from './openapi-port.js';
+export interface OutboundSenderOptions {
+    /**
+     * Reply-path upstream (sessionWebhook for official mode, legacy /message/send
+     * for gateway mode). Used for replies and for the no-proactive fallback.
+     */
+    reply: DingTalkUpstream;
+    logger: ChannelLogger;
+    /**
+     * Proactive OpenAPI port (official proactive path). Absent in gateway mode ->
+     * proactive capabilities are false (fail closed).
+     */
+    proactive?: DingTalkOpenApiPort;
+    /**
+     * Resolved proactive capability flags. Provided by the adapter;
+     * defaults to all-false (fail closed) when not supplied.
+     */
+    capabilities?: OutboxCapabilities;
+    interactiveTemplateId?: string;
+    interactiveTextParam?: string;
+    interactiveActionsParam?: string;
+}
+export declare class OutboundSender {
+    private readonly reply;
+    private readonly logger;
+    private readonly proactive?;
+    private readonly capabilities;
+    private readonly interactiveTemplateId?;
+    private readonly interactiveTextParam;
+    private readonly interactiveActionsParam;
+    private readonly interactiveCards;
+    constructor(options: OutboundSenderOptions);
+    /** Proactive capability flags the harness outbox reads. */
+    get outboxCapabilities(): OutboxCapabilities;
+    /**
+     * Send one channel message. REPLIES (sessionWebhook present) go through the
+     * reply upstream; PROACTIVE targets use the official proactive API; gateway
+     * mode (no proactive port) falls back to the reply upstream /message/send.
+     * Media-carrying proactive messages go through upload + sendMedia.
+     */
+    send(target: ChannelTarget, message: OutboundMessage): Promise<SendResult>;
+    edit(target: ChannelTarget, messageId: string, message: OutboundMessage): Promise<SendResult>;
+    /**
+     * Inspect an outbound message for a single sendable binary (file/image/image-like)
+     * part already carrying trusted bytes (`localData`). Returns undefined for pure
+     * text messages.
+     */
+    private proactiveMediaPart;
+}
+//# sourceMappingURL=outbound.d.ts.map

package/lib/outbound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound.d.ts","sourceRoot":"","sources":["../src/outbound.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EAEb,eAAe,EACf,UAAU,EACX,MAAM,4BAA4B,CAAC;AAGpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,mBAAmB,CAAC;AAQ3B,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,KAAK,EAAE,gBAAgB,CAAC;IACxB,MAAM,EAAE,aAAa,CAAC;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC;;;OAGG;IACH,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAsB;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAS;IAChD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAS;IACjD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqE;gBAE1F,OAAO,EAAE,qBAAqB;IAU1C,2DAA2D;IAC3D,IAAI,kBAAkB,IAAI,kBAAkB,CAE3C;IAED;;;;;OAKG;IACG,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IAuF1E,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IAiBnG;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;CAiB3B"}

package/lib/outbound.js

@@ -0,0 +1,148 @@
+import { ChannelSendError } from '@krischoichoi/channel-core';
+import { toTextPayload } from './mapper.js';
+export class OutboundSender {
+    reply;
+    logger;
+    proactive;
+    capabilities;
+    interactiveTemplateId;
+    interactiveTextParam;
+    interactiveActionsParam;
+    interactiveCards = new Map();
+    constructor(options) {
+        this.reply = options.reply;
+        this.logger = options.logger;
+        this.proactive = options.proactive;
+        this.capabilities = options.capabilities ?? { proactiveText: false, proactiveMedia: false };
+        this.interactiveTemplateId = options.interactiveTemplateId?.trim() || undefined;
+        this.interactiveTextParam = options.interactiveTextParam ?? 'text';
+        this.interactiveActionsParam = options.interactiveActionsParam ?? 'actions';
+    }
+    /** Proactive capability flags the harness outbox reads. */
+    get outboxCapabilities() {
+        return { ...this.capabilities };
+    }
+    /**
+     * Send one channel message. REPLIES (sessionWebhook present) go through the
+     * reply upstream; PROACTIVE targets use the official proactive API; gateway
+     * mode (no proactive port) falls back to the reply upstream /message/send.
+     * Media-carrying proactive messages go through upload + sendMedia.
+     */
+    async send(target, message) {
+        const probe = (target.raw ?? {});
+        const isReply = typeof probe.sessionWebhook === 'string' && probe.sessionWebhook !== '';
+        try {
+            if (message.actions?.length) {
+                if (!this.proactive || !this.interactiveTemplateId || !this.capabilities.proactiveText) {
+                    throw new ChannelSendError('dingtalk interactive card template is not configured');
+                }
+                const text = toTextPayload(target, message).content;
+                const result = await this.proactive.sendInteractiveCard({
+                    target,
+                    templateId: this.interactiveTemplateId,
+                    text,
+                    actions: message.actions,
+                    textParam: this.interactiveTextParam,
+                    actionsParam: this.interactiveActionsParam,
+                });
+                this.interactiveCards.set(result.outTrackId, { text, actions: message.actions });
+                // `outTrackId` is the stable identifier accepted by the official PUT
+                // update API; keep it as the contract messageId for later edits.
+                return { delivered: true, messageId: result.outTrackId, raw: result.raw };
+            }
+            if (isReply || !this.proactive) {
+                // REPLY path (sessionWebhook) — or gateway fallback (no proactive port).
+                const payload = toTextPayload(target, message);
+                const response = await this.reply.sendText(target, payload.content);
+                return { delivered: true, raw: response };
+            }
+            // PROACTIVE path: official proactive API.
+            const robotCode = (probe.robotCode ?? '').trim() || undefined;
+            const conversationType = target.conversationType;
+            const media = this.proactiveMediaPart(message);
+            if (media) {
+                if (!this.capabilities.proactiveMedia) {
+                    throw new ChannelSendError('dingtalk proactive media is not enabled; message carries binary content with no reply context');
+                }
+                const agentId = robotCode;
+                if (!agentId) {
+                    throw new ChannelSendError('dingtalk proactive send requires a robotCode in target.raw');
+                }
+                const uploaded = await this.proactive.uploadMedia({
+                    robotCode: agentId,
+                    fileName: media.fileName,
+                    mimeType: media.mimeType,
+                    data: media.localData,
+                    mediaType: media.msgtype,
+                    target,
+                });
+                const result = await this.proactive.sendMedia({
+                    conversationId: String(target.conversationId),
+                    robotCode: agentId,
+                    mediaId: uploaded.mediaId,
+                    msgtype: media.msgtype,
+                    name: media.fileName,
+                    conversationType,
+                });
+                return { delivered: true, raw: result.raw };
+            }
+            if (!this.capabilities.proactiveText) {
+                throw new ChannelSendError('dingtalk proactive text is not enabled');
+            }
+            if (!robotCode) {
+                throw new ChannelSendError('dingtalk proactive send requires a robotCode in target.raw');
+            }
+            const text = toTextPayload(target, message).content;
+            const result = await this.proactive.sendProactiveText({
+                conversationId: String(target.conversationId),
+                robotCode,
+                text,
+                conversationType,
+            });
+            return { delivered: true, raw: result.raw };
+        }
+        catch (error) {
+            this.logger.error(`[channel-dingtalk] send failed to '${target.conversationId}'`, error instanceof Error ? error.message : error);
+            throw new ChannelSendError(`dingtalk send failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async edit(target, messageId, message) {
+        if (!this.proactive)
+            throw new ChannelSendError('dingtalk interactive card update is unavailable');
+        const known = this.interactiveCards.get(messageId);
+        if (!known)
+            throw new ChannelSendError('dingtalk cannot edit an unknown interactive card');
+        const text = message.text ?? known.text;
+        const actions = message.actions ?? [];
+        const raw = await this.proactive.updateInteractiveCard({
+            outTrackId: messageId,
+            text,
+            actions,
+            textParam: this.interactiveTextParam,
+            actionsParam: this.interactiveActionsParam,
+        });
+        this.interactiveCards.set(messageId, { text, actions });
+        return { delivered: true, messageId, raw };
+    }
+    /**
+     * Inspect an outbound message for a single sendable binary (file/image/image-like)
+     * part already carrying trusted bytes (`localData`). Returns undefined for pure
+     * text messages.
+     */
+    proactiveMediaPart(message) {
+        if (!message.parts || message.parts.length !== 1)
+            return undefined;
+        const part = message.parts[0];
+        if (!part || (part.type !== 'file' && part.type !== 'image'))
+            return undefined;
+        if (!part.localData)
+            return undefined;
+        return {
+            msgtype: part.type === 'image' ? 'image' : 'file',
+            localData: part.localData,
+            mimeType: part.mimeType,
+            fileName: part.name ?? (part.type === 'file' ? 'file' : 'image'),
+        };
+    }
+}
+//# sourceMappingURL=outbound.js.map

package/lib/outbound.js.map

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

package/lib/stream-upstream.d.ts

@@ -0,0 +1,77 @@
+import type { ChannelTarget } from '@krischoichoi/channel-core';
+import type { CardCreateResult, DingTalkUpstream } from './upstream.js';
+/** Downstream headers of a stream message (subset of the SDK shape). */
+export interface DingTalkStreamHeaders {
+    /** Subscription topic (e.g. TOPIC_ROBOT for robot messages). */
+    topic?: string;
+    /** Event id; dedup fallback when the payload omits a msgId. */
+    eventId?: string;
+    /** Server-side message id of the downstream frame. */
+    messageId?: string;
+}
+/** The downstream message shape the stream client delivers to listeners. */
+export interface DingTalkStreamMessage {
+    headers?: DingTalkStreamHeaders;
+    /** JSON-encoded payload (the SDK delivers `data` as a string). */
+    data?: string;
+}
+/**
+ * Minimal structural client surface consumed by the driver. The real SDK
+ * `DWClient` satisfies it (connect / disconnect / registerCallbackListener);
+ * tests inject a fake without a WebSocket.
+ */
+export interface DingTalkStreamClient {
+    /** Open the stream WebSocket and register subscriptions with the server. */
+    connect(): Promise<void>;
+    /** Close the stream WebSocket (sync in the real SDK). */
+    disconnect(): void;
+    /** Subscribe to one downstream topic (robot messages by default). */
+    registerCallbackListener(topic: string, callback: (message: DingTalkStreamMessage) => void | Promise<void>): unknown;
+    /**
+     * Acknowledge one downstream frame so the stream server does not retry it
+     * (~60s retry window). The real SDK's `DWClient` implements this as
+     * `socketCallBackResponse(messageId, result)`.
+     */
+    socketCallBackResponse(messageId: string, response: unknown): void;
+}
+export interface DingTalkStreamUpstreamOptions {
+    /** The stream-mode client (real DWClient or injected fake). */
+    client: DingTalkStreamClient;
+    /** Outbound delegate selected by the adapter (official API or legacy gateway). */
+    outbound: DingTalkUpstream;
+    /** Invoked after the stream connection is established (connection state). */
+    onConnected?: () => void;
+}
+/**
+ * Map one SDK downstream message into the gateway raw shape consumed by the
+ * inbound mapper (`{ type, msgId, eventId, senderId, conversationId, content,
+ * ... }`). Returns `undefined` when the payload is absent or not JSON.
+ */
+export declare function toGatewayRaw(message: DingTalkStreamMessage): Record<string, unknown> | undefined;
+/**
+ * Acknowledge one robot callback frame. ACK means "the message was reliably
+ * received and submitted to the inbound pipeline" — not "the LLM finished
+ * answering". A frame without a server `messageId` cannot be acked.
+ */
+export declare function ackRobotMessage(client: DingTalkStreamClient, message: DingTalkStreamMessage): void;
+export declare function toCardInteractionRaw(message: DingTalkStreamMessage): Record<string, unknown> | undefined;
+/** Stream-mode implementation of `DingTalkUpstream` (inbound via SDK). */
+export declare class DingTalkStreamUpstream implements DingTalkUpstream {
+    private readonly options;
+    /** The listener is registered once per client; reconnect reuses it. */
+    private listenerRegistered;
+    private onMessage?;
+    constructor(options: DingTalkStreamUpstreamOptions);
+    /**
+     * Connect the stream client, route inbound robot messages into the gateway
+     * raw shape, and keep the stream open until `signal` aborts.
+     */
+    receive(signal: AbortSignal, onMessage: (raw: unknown) => void): Promise<void>;
+    private registerListenerOnce;
+    sendText(target: ChannelTarget, text: string): Promise<unknown>;
+    createCard(target: ChannelTarget, text: string): Promise<CardCreateResult>;
+    updateCard(cardId: string, text: string): Promise<unknown>;
+    finishCard(cardId: string, text?: string): Promise<unknown>;
+    failCard(cardId: string, reason?: string): Promise<unknown>;
+}
+//# sourceMappingURL=stream-upstream.d.ts.map

package/lib/stream-upstream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-upstream.d.ts","sourceRoot":"","sources":["../src/stream-upstream.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGxE,wEAAwE;AACxE,MAAM,WAAW,qBAAqB;IACpC,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,4EAA4E;AAC5E,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,4EAA4E;IAC5E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,yDAAyD;IACzD,UAAU,IAAI,IAAI,CAAC;IACnB,qEAAqE;IACrE,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;IACrH;;;;OAIG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;CACpE;AAED,MAAM,WAAW,6BAA6B;IAC5C,+DAA+D;IAC/D,MAAM,EAAE,oBAAoB,CAAC;IAC7B,kFAAkF;IAClF,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AAqFD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAgFhG;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,qBAAqB,GAC7B,IAAI,CAIN;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CA4BxG;AAED,0EAA0E;AAC1E,qBAAa,sBAAuB,YAAW,gBAAgB;IAKjD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,uEAAuE;IACvE,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,SAAS,CAAC,CAAyB;gBAEd,OAAO,EAAE,6BAA6B;IAEnE;;;OAGG;IACG,OAAO,CACX,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAChC,OAAO,CAAC,IAAI,CAAC;IA0BhB,OAAO,CAAC,oBAAoB;IAsB5B,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/D,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI1E,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1D,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI3D,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAG5D"}

package/lib/stream-upstream.js

@@ -0,0 +1,303 @@
+/**
+ * DingTalk stream-mode upstream driver (official `dingtalk-stream` SDK).
+ *
+ * This driver replaces only the INBOUND leg of the legacy self-hosted gateway
+ * integration: robot messages arrive over the DingTalk Stream Mode WebSocket
+ * (CALLBACK downstream messages on `TOPIC_ROBOT`, payload JSON-encoded in
+ * `message.data`) and are mapped into the SAME raw shape the gateway
+ * long-poll driver produces (`{ type, msgId, senderId, conversationId,
+ * content, ... }`), so the existing mapper + dedup pipeline is untouched.
+ *
+ * OUTBOUND is deliberately delegated: message send / AI Card create/update are
+ * HTTP calls, not part of the stream SDK. `DingTalkStreamUpstream` forwards
+ * every outbound method to an injected `DingTalkUpstream`; SDK mode injects
+ * the official `sessionWebhook` / OpenAPI driver, while gateway mode uses its
+ * legacy HTTP driver.
+ *
+ * Credentials never appear in this module and are never logged. Live
+ * verification against a real DingTalk app (AppKey/AppSecret) is a manual
+ * step — the offline tests inject a fake stream client.
+ *
+ * Ack note: the stream server may retry a callback after ~60s without a
+ * response. The SDK's `DWClient` exposes `socketCallBackResponse(messageId,
+ * result)` for exactly this purpose; this driver ACKs each successfully
+ * parsed + submitted robot message (message "reliably received", NOT "LLM
+ * turn finished") so the platform does not redeliver it. Malformed payloads
+ * are deliberately NOT acked, so the platform can retry / surface the error.
+ */
+import { TOPIC_CARD, TOPIC_ROBOT } from 'dingtalk-stream';
+import { z } from 'zod';
+// Validate the untrusted JSON frame before any field access. The schema only
+// covers fields consumed by this adapter; `.passthrough()` preserves the
+// platform's additional media fields for the existing mapper logic.
+const dingtalkStreamRobotMessageSchema = z.object({
+    msgId: z.string().optional(),
+    senderStaffId: z.string().optional(),
+    senderId: z.string().optional(),
+    conversationId: z.string().optional(),
+    conversationType: z.string().optional(),
+    sessionWebhook: z.string().optional(),
+    robotCode: z.string().optional(),
+    isInAtList: z.boolean().optional(),
+    msgtype: z.string().optional(),
+    text: z.object({ content: z.string().optional() }).optional(),
+    content: z.unknown().optional(),
+    richText: z.object({ richTextList: z.array(z.unknown()).optional() }).optional(),
+    picture: z.object({ url: z.string().optional(), picMediaId: z.string().optional(), downloadCode: z.string().optional() }).optional(),
+    audio: z.object({ duration: z.number().optional(), url: z.string().optional(), downloadCode: z.string().optional() }).optional(),
+    video: z.object({ duration: z.number().optional(), url: z.string().optional(), downloadCode: z.string().optional() }).optional(),
+    file: z.object({ fileName: z.string().optional(), url: z.string().optional(), downloadCode: z.string().optional() }).optional(),
+    link: z.object({ title: z.string().optional(), text: z.string().optional(), picUrl: z.string().optional() }).optional(),
+}).passthrough();
+/** Resolve the media content container (mirrors the official connector's
+ * `resolveContent`): `data.content` as an object, or a parsed JSON string. */
+function resolveContent(data) {
+    const raw = data.content;
+    if (raw == null)
+        return undefined;
+    if (typeof raw === 'object')
+        return raw;
+    if (typeof raw === 'string') {
+        try {
+            const parsed = JSON.parse(raw);
+            if (parsed && typeof parsed === 'object')
+                return parsed;
+        }
+        catch {
+            // fall through
+        }
+    }
+    return undefined;
+}
+function richTextList(data, content) {
+    const current = content?.richText;
+    const legacy = data.richText?.richTextList;
+    const list = Array.isArray(current) ? current : Array.isArray(legacy) ? legacy : [];
+    return list.filter((item) => !!item && typeof item === 'object');
+}
+/**
+ * Map one SDK downstream message into the gateway raw shape consumed by the
+ * inbound mapper (`{ type, msgId, eventId, senderId, conversationId, content,
+ * ... }`). Returns `undefined` when the payload is absent or not JSON.
+ */
+export function toGatewayRaw(message) {
+    if (typeof message.data !== 'string')
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(message.data);
+    }
+    catch {
+        return undefined;
+    }
+    const result = dingtalkStreamRobotMessageSchema.safeParse(parsed);
+    if (!result.success)
+        return undefined;
+    const data = result.data;
+    const raw = {
+        type: data.msgtype,
+        msgId: data.msgId,
+        eventId: message.headers?.eventId,
+        senderId: data.senderStaffId ?? data.senderId,
+        conversationId: data.conversationId,
+        conversationType: data.conversationType,
+        sessionWebhook: data.sessionWebhook,
+        robotCode: data.robotCode,
+        // Preserve the official activation fact under the channel-neutral name
+        // consumed by the mapper. Do not infer it from message text.
+        ...(typeof data.isInAtList === 'boolean' ? { mentionedBot: data.isInAtList } : {}),
+    };
+    // Media fields follow the documented robot-message schema (oracle:
+    // @dingtalk-real-ai/dingtalk-connector@0.8.24). Media messages carry their
+    // content in `data.content` (object or JSON string) whose actionable field
+    // is `downloadCode`; picture may also carry `pictureUrl` / `picMediaId`.
+    // The `data.<type>?.url` shapes are kept for gateway-mode compatibility.
+    // The mapper turns these into image/audio/video/file parts.
+    const content = resolveContent(data);
+    switch (data.msgtype) {
+        case 'text':
+            raw.content = data.text?.content;
+            break;
+        case 'picture': {
+            raw.picUrl = content?.pictureUrl ?? data.picture?.url;
+            raw.picMediaId = content?.picMediaId ?? data.picture?.picMediaId;
+            raw.picDownloadCode = content?.downloadCode ?? data.picture?.downloadCode;
+            break;
+        }
+        case 'richText': {
+            const items = richTextList(data, content);
+            raw.content = items
+                .filter((item) => item.type !== 'skill' && !item.skillData)
+                .map((item) => typeof item.text === 'string' ? item.text : '')
+                .join('');
+            raw.richTextImages = items.flatMap((item) => {
+                const pictureUrl = typeof item.pictureUrl === 'string' ? item.pictureUrl : undefined;
+                const downloadCode = typeof item.downloadCode === 'string' && (item.type === 'picture' || !item.type)
+                    ? item.downloadCode
+                    : undefined;
+                return pictureUrl || downloadCode ? [{ pictureUrl, downloadCode }] : [];
+            });
+            break;
+        }
+        case 'audio':
+            raw.mediaUrl = content?.url ?? data.audio?.url;
+            raw.downloadCode = content?.downloadCode ?? data.audio?.downloadCode;
+            raw.durationMs = content?.duration ?? data.audio?.duration;
+            break;
+        case 'video':
+            raw.mediaUrl = content?.url ?? data.video?.url;
+            raw.downloadCode = content?.downloadCode ?? data.video?.downloadCode;
+            raw.durationMs = content?.duration ?? data.video?.duration;
+            break;
+        case 'file':
+            raw.mediaUrl = content?.url ?? data.file?.url;
+            raw.downloadCode = content?.downloadCode ?? data.file?.downloadCode;
+            raw.title = content?.fileName ?? data.file?.fileName;
+            break;
+        case 'link':
+            raw.title = data.link?.title;
+            raw.content = data.link?.text;
+            break;
+        default:
+            // Keep the SDK msgtype; the mapper reports unknown types as unsupported.
+            break;
+    }
+    return raw;
+}
+/**
+ * Acknowledge one robot callback frame. ACK means "the message was reliably
+ * received and submitted to the inbound pipeline" — not "the LLM finished
+ * answering". A frame without a server `messageId` cannot be acked.
+ */
+export function ackRobotMessage(client, message) {
+    const messageId = message.headers?.messageId;
+    if (!messageId)
+        return;
+    client.socketCallBackResponse(messageId, { success: true });
+}
+export function toCardInteractionRaw(message) {
+    if (typeof message.data !== 'string')
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(message.data);
+    }
+    catch {
+        return undefined;
+    }
+    const schema = z.object({
+        outTrackId: z.string().min(1),
+        userId: z.string().min(1),
+        openConversationId: z.string().min(1).optional(),
+        cardActionData: z.object({
+            cardPrivateData: z.object({ params: z.record(z.string(), z.unknown()).optional() }).optional(),
+        }).default({}),
+    }).passthrough();
+    const result = schema.safeParse(parsed);
+    if (!result.success)
+        return undefined;
+    const params = result.data.cardActionData.cardPrivateData?.params ?? {};
+    const action = typeof params.action === 'string' ? params.action : typeof params.actionId === 'string' ? params.actionId : undefined;
+    if (!action)
+        return undefined;
+    return {
+        type: 'interaction',
+        msgId: message.headers?.messageId ?? result.data.outTrackId,
+        eventId: message.headers?.eventId,
+        senderId: result.data.userId,
+        conversationId: result.data.openConversationId ?? result.data.userId,
+        conversationType: result.data.openConversationId ? '2' : '1',
+        interactionId: result.data.outTrackId,
+        action,
+        value: params,
+    };
+}
+/** Stream-mode implementation of `DingTalkUpstream` (inbound via SDK). */
+export class DingTalkStreamUpstream {
+    options;
+    /** The listener is registered once per client; reconnect reuses it. */
+    listenerRegistered = false;
+    onMessage;
+    constructor(options) {
+        this.options = options;
+    }
+    /**
+     * Connect the stream client, route inbound robot messages into the gateway
+     * raw shape, and keep the stream open until `signal` aborts.
+     */
+    async receive(signal, onMessage) {
+        this.onMessage = onMessage;
+        this.registerListenerOnce();
+        try {
+            await this.options.client.connect();
+        }
+        catch (error) {
+            // Abort-driven teardown exits gracefully; other failures propagate to
+            // the adapter, which owns reconnect/backoff.
+            if (signal.aborted)
+                return;
+            throw error;
+        }
+        if (signal.aborted) {
+            this.options.client.disconnect();
+            return;
+        }
+        // dingtalk-stream v2 resolves connect() after a failed connection attempt
+        // and schedules its own retry. Do not report a healthy channel until its
+        // actual socket is open.
+        if (this.options.client.connected === false) {
+            throw new Error('dingtalk stream connection was not established');
+        }
+        this.options.onConnected?.();
+        await waitForAbort(signal);
+        this.options.client.disconnect();
+    }
+    registerListenerOnce() {
+        if (this.listenerRegistered)
+            return;
+        this.options.client.registerCallbackListener(TOPIC_ROBOT, (message) => {
+            if (!this.onMessage)
+                return;
+            const raw = toGatewayRaw(message);
+            if (raw === undefined)
+                return; // malformed payload: do not ack (platform retries / error observation)
+            this.onMessage(raw);
+            // ACK after submitting to the inbound pipeline ("reliably received"),
+            // never after the LLM turn completes.
+            ackRobotMessage(this.options.client, message);
+        });
+        this.options.client.registerCallbackListener(TOPIC_CARD, (message) => {
+            const raw = toCardInteractionRaw(message);
+            if (raw === undefined)
+                return;
+            this.onMessage?.(raw);
+            if (message.headers?.messageId) {
+                this.options.client.socketCallBackResponse(message.headers.messageId, { success: true });
+            }
+        });
+        this.listenerRegistered = true;
+    }
+    sendText(target, text) {
+        return this.options.outbound.sendText(target, text);
+    }
+    createCard(target, text) {
+        return this.options.outbound.createCard(target, text);
+    }
+    updateCard(cardId, text) {
+        return this.options.outbound.updateCard(cardId, text);
+    }
+    finishCard(cardId, text) {
+        return this.options.outbound.finishCard(cardId, text);
+    }
+    failCard(cardId, reason) {
+        return this.options.outbound.failCard(cardId, reason);
+    }
+}
+function waitForAbort(signal) {
+    if (signal.aborted)
+        return Promise.resolve();
+    return new Promise((resolve) => {
+        signal.addEventListener('abort', () => resolve(), { once: true });
+    });
+}
+//# sourceMappingURL=stream-upstream.js.map

package/lib/stream-upstream.js.map

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