dsh-connect 0.7.2 → 0.9.0

package/lib/channels/dingtalk/adapter.js

@@ -0,0 +1,123 @@
+import { DingtalkStreamClient } from "./stream.js";
+import { buildMarkdownReplyBody, buildTextReplyBody, isAtMentioned, normalizeBotMessage, } from "./message.js";
+import { dingtalkMessages } from "./i18n.js";
+const CHOICE_TIMEOUT_MS = 60_000;
+/**
+ * Bidirectional DingTalk adapter (stream mode). Deliberately text-forward:
+ * no card editing, no button callbacks — just normalized text both ways.
+ */
+export class DingtalkStreamAdapter {
+    id = "dingtalk";
+    client;
+    t;
+    requireMention;
+    handler;
+    pendingMenus = new Map();
+    constructor(config, logger) {
+        this.requireMention = config.requireMention ?? true;
+        this.t = dingtalkMessages(config.language ?? "zh");
+        this.client = new DingtalkStreamClient({
+            clientId: config.clientId,
+            clientSecret: config.clientSecret,
+            url: config.url,
+            logger,
+        });
+    }
+    async start() {
+        this.client.onInbound((raw) => {
+            void this.dispatch(raw).catch(() => undefined);
+        });
+        await this.client.connect();
+    }
+    async stop() {
+        this.client.close();
+    }
+    onInbound(handler) {
+        this.handler = handler;
+    }
+    /** Gate + normalize + menu-answer routing, then hand to the core. */
+    async dispatch(raw) {
+        if (this.requireMention && raw.conversationType === "2" && !isAtMentioned(raw))
+            return;
+        const msg = normalizeBotMessage(raw);
+        if (msg === undefined)
+            return;
+        if (this.tryResolveMenu(msg.chatKey, msg.text))
+            return;
+        await this.handler?.(msg);
+    }
+    /**
+     * A pending text menu is answered when the user replies with a number.
+     * Returns true when the message was consumed as a menu answer.
+     */
+    tryResolveMenu(conversationId, text) {
+        if (this.pendingMenus.size === 0)
+            return false;
+        const index = Number(text.trim());
+        if (!Number.isFinite(index))
+            return false;
+        for (const [messageId, pending] of this.pendingMenus) {
+            if (pending.conversationId !== conversationId)
+                continue;
+            const option = pending.options[index - 1];
+            if (option === undefined)
+                return false;
+            clearTimeout(pending.timer);
+            this.pendingMenus.delete(messageId);
+            pending.resolve(option.id);
+            return true;
+        }
+        return false;
+    }
+    async sendText(target, text) {
+        if (target.replyRef === undefined)
+            return; // proactive push → webhook service
+        await this.client.sendReply(target.replyRef, buildTextReplyBody(target.replyRef, text));
+    }
+    async sendCard(target, card) {
+        if (target.replyRef === undefined)
+            return;
+        await this.client.sendReply(target.replyRef, buildMarkdownReplyBody(target.replyRef, this.t.cardTitle, card.markdown));
+    }
+    async streamText(target, chunks) {
+        let full = "";
+        for await (const chunk of chunks)
+            full += chunk;
+        if (full.trim() === "" || target.replyRef === undefined)
+            return;
+        await this.client.sendReply(target.replyRef, buildTextReplyBody(target.replyRef, full));
+    }
+    async promptChoice(target, prompt, _updateMessageId) {
+        const lines = [prompt.title, ""];
+        prompt.options.forEach((option, i) => lines.push(`${i + 1}. ${option.label}`));
+        if (prompt.footer !== undefined)
+            lines.push("", prompt.footer);
+        const text = lines.join("\n");
+        if (target.replyRef !== undefined) {
+            await this.client.sendReply(target.replyRef, buildTextReplyBody(target.replyRef, text));
+        }
+        const messageId = `${target.chatKey}:${Date.now()}`;
+        const result = await new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                this.pendingMenus.delete(messageId);
+                resolve({ choice: undefined, messageId });
+            }, CHOICE_TIMEOUT_MS);
+            this.pendingMenus.set(messageId, {
+                conversationId: target.chatKey,
+                options: [...prompt.options],
+                timer,
+                resolve: (choice) => {
+                    this.pendingMenus.delete(messageId);
+                    clearTimeout(timer);
+                    resolve({ choice, messageId });
+                },
+            });
+        });
+        return result;
+    }
+    async closeMenu(_messageId, _summary) {
+        // Text menus have no card to replace; a completion notice is unnecessary
+        // because the menu prompt is just a numbered list in the thread.
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/lib/channels/dingtalk/adapter.js.map

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

package/lib/channels/dingtalk/i18n.d.ts

@@ -0,0 +1,14 @@
+/**
+ * DingTalk-adapter user-facing strings (zh/en).
+ * @module dsh-connect/channels/dingtalk/i18n
+ */
+import type { Language } from "../../i18n.js";
+export interface DingtalkMessages {
+    webhookMissing: string;
+    webhookInvalid: string;
+    sendFailed(error: string): string;
+    /** Title used by markdown replies (stream mode). */
+    cardTitle: string;
+}
+export declare function dingtalkMessages(lang: Language): DingtalkMessages;
+//# sourceMappingURL=i18n.d.ts.map

package/lib/channels/dingtalk/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../../src/channels/dingtalk/i18n.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;CACnB;AAgBD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,gBAAgB,CAEjE"}

package/lib/channels/dingtalk/i18n.js

@@ -0,0 +1,16 @@
+const zh = {
+    webhookMissing: "connect-dingtalk: 未配置 webhookUrl（钉钉群自定义机器人的 Webhook 地址），无法推送。",
+    webhookInvalid: "connect-dingtalk: webhookUrl 必须是 https:// 开头的钉钉机器人地址。",
+    sendFailed: (error) => `connect-dingtalk: 推送失败 — ${error}`,
+    cardTitle: "DSH 任务摘要",
+};
+const en = {
+    webhookMissing: "connect-dingtalk: webhookUrl is not configured (the DingTalk group custom robot's webhook URL) — nothing to push to.",
+    webhookInvalid: "connect-dingtalk: webhookUrl must be an https:// DingTalk robot URL.",
+    sendFailed: (error) => `connect-dingtalk: push failed — ${error}`,
+    cardTitle: "DSH Summary",
+};
+export function dingtalkMessages(lang) {
+    return lang === "en" ? en : zh;
+}
+//# sourceMappingURL=i18n.js.map

package/lib/channels/dingtalk/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../../../src/channels/dingtalk/i18n.ts"],"names":[],"mappings":"AAcA,MAAM,EAAE,GAAqB;IAC3B,cAAc,EAAE,+DAA+D;IAC/E,cAAc,EAAE,uDAAuD;IACvE,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,4BAA4B,KAAK,EAAE;IAC1D,SAAS,EAAE,UAAU;CACtB,CAAC;AAEF,MAAM,EAAE,GAAqB;IAC3B,cAAc,EAAE,sHAAsH;IACtI,cAAc,EAAE,sEAAsE;IACtF,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,mCAAmC,KAAK,EAAE;IACjE,SAAS,EAAE,aAAa;CACzB,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,IAAc;IAC7C,OAAO,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACjC,CAAC"}

package/lib/channels/dingtalk/index.d.ts

@@ -0,0 +1,127 @@
+/**
+ * DingTalk channel for DeepSeek Harness — two modes:
+ *
+ * 1. Webhook push (one-way): the DingTalk group custom robot (群自定义机器人)
+ *    webhook can send text / markdown / @mention messages into a group. This
+ *    exposes a push service (`ctx.dingtalk`) for task progress, results and
+ *    alerts.
+ * 2. Stream mode (bidirectional, zero dependencies): with `stream.clientId`
+ *    / `stream.clientSecret` set, a STOMP-over-WebSocket adapter is
+ *    registered into `dsh-connect`, so group @-mentions / DMs trigger the
+ *    agent and replies stream back. Menus are numbered text lists (the user
+ *    answers with a number); proactive pushes still use the webhook service.
+ *
+ * @module dsh-connect/dingtalk
+ */
+import { Service, type Context } from "@deepseek-ai/cordis";
+import z from "@deepseek-ai/schemastery";
+import { type DingtalkAt } from "./webhook.js";
+import { type DingtalkStreamAdapterConfig } from "./adapter.js";
+export { DingtalkWebhook, signDingtalk, verifyDingtalkSignature } from "./webhook.js";
+export type { DingtalkAt, DingtalkBody, DingtalkResponse, DingtalkWebhookConfig } from "./webhook.js";
+export { dingtalkMessages } from "./i18n.js";
+export type { DingtalkMessages } from "./i18n.js";
+export { DingtalkStreamAdapter } from "./adapter.js";
+export type { DingtalkStreamAdapterConfig } from "./adapter.js";
+export { DingtalkStreamClient, DEFAULT_STREAM_URL } from "./stream.js";
+export { encodeFrame, decodeFrames, escapeHeader, unescapeHeader } from "./stomp.js";
+export type { StompFrame } from "./stomp.js";
+export { buildConnectBody, buildMarkdownReplyBody, buildTextReplyBody, isAtMentioned, normalizeBotMessage, INBOUND_DESTINATION, REPLY_DESTINATION, } from "./message.js";
+export type { DingtalkBotMessage } from "./message.js";
+/** Plugin config; secrets may come from config or the DINGTALK_* environment. */
+export declare const Config: z<Schemastery.ObjectS<{
+    webhookUrl: z<string, string>;
+    secret: z<string, string>;
+    language: z<"zh" | "en", "zh" | "en">;
+    /** Optional default @-mentions for every push (mobiles / user ids / all). */
+    defaultAt: z<Schemastery.ObjectS<{
+        mobiles: z<string[], string[]>;
+        userIds: z<string[], string[]>;
+        all: z<boolean, boolean>;
+    }>, Schemastery.ObjectT<{
+        mobiles: z<string[], string[]>;
+        userIds: z<string[], string[]>;
+        all: z<boolean, boolean>;
+    }>>;
+    /** Stream mode (bidirectional): the DingTalk app's Client ID / Client Secret. */
+    stream: z<Schemastery.ObjectS<{
+        clientId: z<string, string>;
+        clientSecret: z<string, string>;
+        url: z<string, string>;
+        requireMention: z<boolean, boolean>;
+    }>, Schemastery.ObjectT<{
+        clientId: z<string, string>;
+        clientSecret: z<string, string>;
+        url: z<string, string>;
+        requireMention: z<boolean, boolean>;
+    }>>;
+}>, Schemastery.ObjectT<{
+    webhookUrl: z<string, string>;
+    secret: z<string, string>;
+    language: z<"zh" | "en", "zh" | "en">;
+    /** Optional default @-mentions for every push (mobiles / user ids / all). */
+    defaultAt: z<Schemastery.ObjectS<{
+        mobiles: z<string[], string[]>;
+        userIds: z<string[], string[]>;
+        all: z<boolean, boolean>;
+    }>, Schemastery.ObjectT<{
+        mobiles: z<string[], string[]>;
+        userIds: z<string[], string[]>;
+        all: z<boolean, boolean>;
+    }>>;
+    /** Stream mode (bidirectional): the DingTalk app's Client ID / Client Secret. */
+    stream: z<Schemastery.ObjectS<{
+        clientId: z<string, string>;
+        clientSecret: z<string, string>;
+        url: z<string, string>;
+        requireMention: z<boolean, boolean>;
+    }>, Schemastery.ObjectT<{
+        clientId: z<string, string>;
+        clientSecret: z<string, string>;
+        url: z<string, string>;
+        requireMention: z<boolean, boolean>;
+    }>>;
+}>>;
+export interface DingtalkConfig {
+    webhookUrl?: string;
+    secret?: string;
+    language?: "zh" | "en";
+    defaultAt?: Partial<DingtalkAt>;
+    /** Stream mode (bidirectional) credentials; secrets also via DINGTALK_STREAM_CLIENT_ID / _SECRET. */
+    stream?: Partial<DingtalkStreamAdapterConfig>;
+}
+/**
+ * The push service exposed on the Cordis context. Other plugins can inject
+ * `dingtalk` and call `sendMarkdown` / `sendText` to deliver into the group.
+ */
+export declare class DingtalkService extends Service {
+    private readonly webhook;
+    private readonly t;
+    readonly defaultAt?: Partial<DingtalkAt>;
+    constructor(ctx: Context, config: DingtalkConfig, logger?: {
+        warn?: (...args: unknown[]) => void;
+    });
+    /** Push a markdown card into the DingTalk group. */
+    sendMarkdown(title: string, text: string, at?: DingtalkAt): Promise<void>;
+    /** Push plain text into the DingTalk group. */
+    sendText(content: string, at?: DingtalkAt): Promise<void>;
+}
+interface ConnectLike {
+    registerAdapter(adapter: unknown): void;
+}
+/**
+ * Register and start the DingTalk channel. `connect` may be undefined: when the
+ * stream credentials are absent, or when `connect` is not provided, DingTalk
+ * degrades to one-way webhook push (`ctx.dingtalk`). The webhook service is
+ * always constructed. `connect` is the already-constructed `ConnectService`
+ * instance (passed from the merged entry, not resolved via `ctx.get`).
+ */
+export declare function register(connect: ConnectLike | undefined, config: (DingtalkConfig | null) | undefined, ctx: Context): void;
+/**
+ * Compatibility shell for the old split-plugin registration path (when `connect`
+ * is an already-active, separate plugin). The merged entry calls `register`
+ * directly instead, because `ctx.get("connect")` returns undefined inside this
+ * plugin's own `apply`.
+ */
+export declare function apply(ctx: Context, config?: DingtalkConfig | null): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/channels/dingtalk/index.d.ts.map

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

package/lib/channels/dingtalk/index.js

@@ -0,0 +1,144 @@
+/**
+ * DingTalk channel for DeepSeek Harness — two modes:
+ *
+ * 1. Webhook push (one-way): the DingTalk group custom robot (群自定义机器人)
+ *    webhook can send text / markdown / @mention messages into a group. This
+ *    exposes a push service (`ctx.dingtalk`) for task progress, results and
+ *    alerts.
+ * 2. Stream mode (bidirectional, zero dependencies): with `stream.clientId`
+ *    / `stream.clientSecret` set, a STOMP-over-WebSocket adapter is
+ *    registered into `dsh-connect`, so group @-mentions / DMs trigger the
+ *    agent and replies stream back. Menus are numbered text lists (the user
+ *    answers with a number); proactive pushes still use the webhook service.
+ *
+ * @module dsh-connect/dingtalk
+ */
+import { Service } from "@deepseek-ai/cordis";
+import z from "@deepseek-ai/schemastery";
+import { DingtalkWebhook } from "./webhook.js";
+import { dingtalkMessages } from "./i18n.js";
+import { DingtalkStreamAdapter } from "./adapter.js";
+export { DingtalkWebhook, signDingtalk, verifyDingtalkSignature } from "./webhook.js";
+export { dingtalkMessages } from "./i18n.js";
+export { DingtalkStreamAdapter } from "./adapter.js";
+export { DingtalkStreamClient, DEFAULT_STREAM_URL } from "./stream.js";
+export { encodeFrame, decodeFrames, escapeHeader, unescapeHeader } from "./stomp.js";
+export { buildConnectBody, buildMarkdownReplyBody, buildTextReplyBody, isAtMentioned, normalizeBotMessage, INBOUND_DESTINATION, REPLY_DESTINATION, } from "./message.js";
+/** Plugin config; secrets may come from config or the DINGTALK_* environment. */
+export const Config = z.object({
+    webhookUrl: z.string().role("secret"),
+    secret: z.string().role("secret"),
+    language: z.union([z.const("zh"), z.const("en")]),
+    /** Optional default @-mentions for every push (mobiles / user ids / all). */
+    defaultAt: z.object({
+        mobiles: z.array(z.string()),
+        userIds: z.array(z.string()),
+        all: z.boolean(),
+    }),
+    /** Stream mode (bidirectional): the DingTalk app's Client ID / Client Secret. */
+    stream: z.object({
+        clientId: z.string().role("secret"),
+        clientSecret: z.string().role("secret"),
+        url: z.string(),
+        requireMention: z.boolean(),
+    }),
+});
+/**
+ * The push service exposed on the Cordis context. Other plugins can inject
+ * `dingtalk` and call `sendMarkdown` / `sendText` to deliver into the group.
+ */
+export class DingtalkService extends Service {
+    webhook;
+    t;
+    defaultAt;
+    constructor(ctx, config, logger) {
+        super(ctx, "dingtalk");
+        const webhookUrl = config.webhookUrl ?? process.env.DINGTALK_WEBHOOK_URL;
+        if (!webhookUrl) {
+            throw new Error(dingtalkMessages(config.language ?? "zh").webhookMissing);
+        }
+        this.t = dingtalkMessages(config.language ?? "zh");
+        this.defaultAt = config.defaultAt;
+        try {
+            this.webhook = new DingtalkWebhook({
+                webhookUrl,
+                ...(config.secret ?? process.env.DINGTALK_WEBHOOK_SECRET ? { secret: config.secret ?? process.env.DINGTALK_WEBHOOK_SECRET } : {}),
+            });
+        }
+        catch (error) {
+            logger?.warn?.(this.t.webhookInvalid);
+            throw error;
+        }
+    }
+    /** Push a markdown card into the DingTalk group. */
+    async sendMarkdown(title, text, at) {
+        const merged = at === undefined ? this.defaultAt : { ...this.defaultAt, ...at };
+        try {
+            await this.webhook.sendMarkdown(title, text, merged);
+        }
+        catch (error) {
+            this.ctx.logger?.warn?.(this.t.sendFailed(error instanceof Error ? error.message : String(error)));
+        }
+    }
+    /** Push plain text into the DingTalk group. */
+    async sendText(content, at) {
+        const merged = at === undefined ? this.defaultAt : { ...this.defaultAt, ...at };
+        try {
+            await this.webhook.sendText(content, merged);
+        }
+        catch (error) {
+            this.ctx.logger?.warn?.(this.t.sendFailed(error instanceof Error ? error.message : String(error)));
+        }
+    }
+}
+/**
+ * Register and start the DingTalk channel. `connect` may be undefined: when the
+ * stream credentials are absent, or when `connect` is not provided, DingTalk
+ * degrades to one-way webhook push (`ctx.dingtalk`). The webhook service is
+ * always constructed. `connect` is the already-constructed `ConnectService`
+ * instance (passed from the merged entry, not resolved via `ctx.get`).
+ */
+export function register(connect, config = {}, ctx) {
+    // The DSH loader passes `null` for entries without an explicit config.
+    config = config ?? {};
+    // Stream mode (bidirectional): register a ChannelAdapter into dsh-connect.
+    const stream = config.stream ?? {};
+    const clientId = stream.clientId ?? process.env.DINGTALK_STREAM_CLIENT_ID;
+    const clientSecret = stream.clientSecret ?? process.env.DINGTALK_STREAM_CLIENT_SECRET;
+    if (clientId !== undefined && clientSecret !== undefined) {
+        if (connect === undefined) {
+            ctx.logger?.warn?.("connect-dingtalk: stream mode requires the dsh-connect service; skipping adapter");
+        }
+        else {
+            try {
+                const adapter = new DingtalkStreamAdapter({ ...stream, clientId, clientSecret, language: config.language }, ctx.logger);
+                connect.registerAdapter(adapter);
+                void adapter.start().catch((error) => {
+                    ctx.logger?.warn?.(`connect-dingtalk: stream adapter start failed: ${String(error)}`);
+                });
+            }
+            catch (error) {
+                ctx.logger?.warn?.(`connect-dingtalk: stream adapter init failed: ${String(error)}`);
+            }
+        }
+    }
+    // Webhook push service (one-way). `Service` construction registers
+    // `ctx.dingtalk` automatically; it throws when no webhookUrl is configured.
+    try {
+        void new DingtalkService(ctx, config, ctx.logger);
+    }
+    catch (error) {
+        ctx.logger?.warn?.(`connect-dingtalk: init failed: ${String(error)}`);
+    }
+}
+/**
+ * Compatibility shell for the old split-plugin registration path (when `connect`
+ * is an already-active, separate plugin). The merged entry calls `register`
+ * directly instead, because `ctx.get("connect")` returns undefined inside this
+ * plugin's own `apply`.
+ */
+export function apply(ctx, config = {}) {
+    const connect = ctx.get("connect");
+    register(connect, config, ctx);
+}
+//# sourceMappingURL=index.js.map

package/lib/channels/dingtalk/index.js.map

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

package/lib/channels/dingtalk/message.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Pure message normalization for the DingTalk stream mode: raw gateway
+ * payloads → dsh-connect `InboundMessage`, and STOMP reply bodies for the
+ * reply destination. Kept free of sockets so every branch is unit-testable.
+ * @module dsh-connect/channels/dingtalk/message
+ */
+import type { InboundMessage } from "../../types.js";
+/** Raw inbound message payload pushed by the stream gateway. */
+export interface DingtalkBotMessage {
+    senderStaffId?: string;
+    senderNick?: string;
+    /** Stable conversation id ("cid…"). */
+    conversationId?: string;
+    /** "1" = single chat, "2" = group chat. */
+    conversationType?: string;
+    msgId?: string;
+    msgType?: string;
+    text?: {
+        content?: string;
+    };
+    /** True when the message @-mentioned the bot (group chats). */
+    isInAtList?: boolean;
+    /** Mentioned users when `isInAtList` is true. */
+    atUsers?: Array<{
+        dingtalkId?: string;
+        staffId?: string;
+    }>;
+}
+/** STOMP destination the gateway pushes inbound bot messages on. */
+export declare const INBOUND_DESTINATION = "/v1.0/im/bot/messages/get";
+/** STOMP destination replies are SENT to. */
+export declare const REPLY_DESTINATION = "/v1.0/im/bot/messages/reply";
+/** STOMP subscription id used for the inbound topic. */
+export declare const INBOUND_SUBSCRIPTION = "inbound";
+/** True when the message @-mentioned the bot (used for group requireMention). */
+export declare function isAtMentioned(msg: DingtalkBotMessage): boolean;
+/**
+ * Normalize a gateway payload into an `InboundMessage`. Returns `undefined`
+ * for payloads that cannot be routed (missing conversation/sender) or that
+ * carry no usable text body.
+ */
+export declare function normalizeBotMessage(raw: DingtalkBotMessage, channel?: string): InboundMessage | undefined;
+/** JSON body for a plain-text reply to a message. */
+export declare function buildTextReplyBody(msgId: string, content: string): string;
+/** JSON body for a markdown reply to a message. */
+export declare function buildMarkdownReplyBody(msgId: string, title: string, text: string): string;
+/** JSON body for the STOMP CONNECT frame. */
+export declare function buildConnectBody(clientId: string, clientSecret: string): string;
+//# sourceMappingURL=message.d.ts.map

package/lib/channels/dingtalk/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../src/channels/dingtalk/message.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,gEAAgE;AAChE,MAAM,WAAW,kBAAkB;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5B,+DAA+D;IAC/D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iDAAiD;IACjD,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5D;AAED,oEAAoE;AACpE,eAAO,MAAM,mBAAmB,8BAA8B,CAAC;AAC/D,6CAA6C;AAC7C,eAAO,MAAM,iBAAiB,gCAAgC,CAAC;AAC/D,wDAAwD;AACxD,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAE9C,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,kBAAkB,EAAE,OAAO,SAAa,GAAG,cAAc,GAAG,SAAS,CAkB7G;AAED,qDAAqD;AACrD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,mDAAmD;AACnD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzF;AAED,6CAA6C;AAC7C,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAE/E"}

package/lib/channels/dingtalk/message.js

@@ -0,0 +1,50 @@
+/** STOMP destination the gateway pushes inbound bot messages on. */
+export const INBOUND_DESTINATION = "/v1.0/im/bot/messages/get";
+/** STOMP destination replies are SENT to. */
+export const REPLY_DESTINATION = "/v1.0/im/bot/messages/reply";
+/** STOMP subscription id used for the inbound topic. */
+export const INBOUND_SUBSCRIPTION = "inbound";
+/** True when the message @-mentioned the bot (used for group requireMention). */
+export function isAtMentioned(msg) {
+    return msg.isInAtList === true;
+}
+/**
+ * Normalize a gateway payload into an `InboundMessage`. Returns `undefined`
+ * for payloads that cannot be routed (missing conversation/sender) or that
+ * carry no usable text body.
+ */
+export function normalizeBotMessage(raw, channel = "dingtalk") {
+    if (typeof raw.conversationId !== "string" || raw.conversationId === "")
+        return undefined;
+    if (typeof raw.senderStaffId !== "string" || raw.senderStaffId === "")
+        return undefined;
+    const text = raw.msgType === "text" ? (raw.text?.content ?? "") : "";
+    // Nothing for the agent to act on: a non-text payload (image, file, sticker,
+    // recall notice) normalizes to an empty body, and stream mode carries no
+    // attachment download. Running a turn on it would burn a model call and post
+    // a reply to a message the user never sent. Same guard the Telegram adapter
+    // applies when it has no media either.
+    if (text.trim() === "")
+        return undefined;
+    return {
+        channel,
+        chatKey: raw.conversationId,
+        chatType: raw.conversationType === "2" ? "group" : "p2p",
+        senderKey: raw.senderStaffId,
+        text,
+        ...(typeof raw.msgId === "string" && raw.msgId !== "" ? { replyRef: raw.msgId } : {}),
+    };
+}
+/** JSON body for a plain-text reply to a message. */
+export function buildTextReplyBody(msgId, content) {
+    return JSON.stringify({ msgKey: "sampleText", msgParam: { content }, msgId });
+}
+/** JSON body for a markdown reply to a message. */
+export function buildMarkdownReplyBody(msgId, title, text) {
+    return JSON.stringify({ msgKey: "sampleMarkdown", msgParam: { title, text }, msgId });
+}
+/** JSON body for the STOMP CONNECT frame. */
+export function buildConnectBody(clientId, clientSecret) {
+    return JSON.stringify({ clientId, clientSecret, protocolVersion: "1.0" });
+}
+//# sourceMappingURL=message.js.map

package/lib/channels/dingtalk/message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../../../src/channels/dingtalk/message.ts"],"names":[],"mappings":"AAyBA,oEAAoE;AACpE,MAAM,CAAC,MAAM,mBAAmB,GAAG,2BAA2B,CAAC;AAC/D,6CAA6C;AAC7C,MAAM,CAAC,MAAM,iBAAiB,GAAG,6BAA6B,CAAC;AAC/D,wDAAwD;AACxD,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAC;AAE9C,iFAAiF;AACjF,MAAM,UAAU,aAAa,CAAC,GAAuB;IACnD,OAAO,GAAG,CAAC,UAAU,KAAK,IAAI,CAAC;AACjC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAuB,EAAE,OAAO,GAAG,UAAU;IAC/E,IAAI,OAAO,GAAG,CAAC,cAAc,KAAK,QAAQ,IAAI,GAAG,CAAC,cAAc,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IAC1F,IAAI,OAAO,GAAG,CAAC,aAAa,KAAK,QAAQ,IAAI,GAAG,CAAC,aAAa,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACxF,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACrE,6EAA6E;IAC7E,yEAAyE;IACzE,6EAA6E;IAC7E,4EAA4E;IAC5E,uCAAuC;IACvC,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACzC,OAAO;QACL,OAAO;QACP,OAAO,EAAE,GAAG,CAAC,cAAc;QAC3B,QAAQ,EAAE,GAAG,CAAC,gBAAgB,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;QACxD,SAAS,EAAE,GAAG,CAAC,aAAa;QAC5B,IAAI;QACJ,GAAG,CAAC,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,IAAI,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtF,CAAC;AACJ,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,kBAAkB,CAAC,KAAa,EAAE,OAAe;IAC/D,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;AAChF,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,sBAAsB,CAAC,KAAa,EAAE,KAAa,EAAE,IAAY;IAC/E,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;AACxF,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,YAAoB;IACrE,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5E,CAAC"}

package/lib/channels/dingtalk/stomp.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Minimal STOMP 1.x frame codec used by the DingTalk stream-mode gateway.
+ * Pure string logic (no sockets) so it can be unit-tested without a network:
+ * DingTalk's stream gateway speaks STOMP over WebSocket with JSON bodies —
+ * CONNECT / CONNECTED / SUBSCRIBE / MESSAGE / SEND / ERROR frames and bare
+ * newline heartbeats.
+ * @module dsh-connect/channels/dingtalk/stomp
+ */
+/** One decoded STOMP frame. */
+export interface StompFrame {
+    command: string;
+    headers: Record<string, string>;
+    body: string;
+}
+/**
+ * Escape a header value per STOMP rules: backslash, newline, carriage
+ * return and colon become \\, \n, \r, \c.
+ */
+export declare function escapeHeader(value: string): string;
+/** Reverse of {@link escapeHeader}. */
+export declare function unescapeHeader(value: string): string;
+/** Serialize one frame (command, header block, blank line, body, NUL). */
+export declare function encodeFrame(command: string, headers: Record<string, string>, body?: string): string;
+/** Result of feeding a chunk into the incremental decoder. */
+export interface StompDecodeResult {
+    frames: StompFrame[];
+    /** Unconsumed tail (partial frame) to carry into the next feed. */
+    rest: string;
+}
+/**
+ * Incrementally decode STOMP frames from a string buffer. Frames are
+ * NUL-terminated; heartbeats (bare newlines) and other whitespace-only
+ * segments are skipped. Returns the decoded frames plus the leftover tail.
+ */
+export declare function decodeFrames(buffer: string): StompDecodeResult;
+//# sourceMappingURL=stomp.d.ts.map

package/lib/channels/dingtalk/stomp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stomp.d.ts","sourceRoot":"","sources":["../../../src/channels/dingtalk/stomp.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,+BAA+B;AAC/B,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAYlD;AAED,uCAAuC;AACvC,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAepD;AAED,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,SAAK,GAAG,MAAM,CAO/F;AAED,8DAA8D;AAC9D,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAkC9D"}