@soimy/dingtalk 2.7.0 → 3.0.0

package/src/message-utils.ts

@@ -0,0 +1,156 @@
+import type { DingTalkInboundMessage, MessageContent, SendMessageOptions } from "./types";
+
+/**
+ * Auto-detect markdown usage and derive message title.
+ * Title extraction follows DingTalk markdown card title constraints.
+ */
+export function detectMarkdownAndExtractTitle(
+  text: string,
+  options: SendMessageOptions,
+  defaultTitle: string,
+): { useMarkdown: boolean; title: string } {
+  const hasMarkdown = /^[#*>-]|[*_`#[\]]/.test(text) || text.includes("\n");
+  const useMarkdown = options.useMarkdown !== false && (options.useMarkdown || hasMarkdown);
+
+  const title =
+    options.title ||
+    (useMarkdown
+      ? text
+          .split("\n")[0]
+          .replace(/^[#*\s\->]+/, "")
+          .slice(0, 20) || defaultTitle
+      : defaultTitle);
+
+  return { useMarkdown, title };
+}
+
+export function extractMessageContent(data: DingTalkInboundMessage): MessageContent {
+  const msgtype = data.msgtype || "text";
+
+  // Normalize quote/reply metadata into a readable text prefix so the agent can understand message context.
+  const formatQuotedContent = (): string => {
+    const textField = data.text as any;
+
+    if (textField?.isReplyMsg && textField?.repliedMsg) {
+      const repliedMsg = textField.repliedMsg;
+      const content = repliedMsg?.content;
+
+      if (content?.text) {
+        const quoteText = content.text.trim();
+        if (quoteText) {
+          return `[引用消息: "${quoteText}"]\n\n`;
+        }
+      }
+
+      if (content?.richText && Array.isArray(content.richText)) {
+        const textParts: string[] = [];
+        for (const part of content.richText) {
+          if (part.msgType === "text" && part.content) {
+            textParts.push(part.content);
+          } else if (part.msgType === "emoji" || part.type === "emoji") {
+            textParts.push(part.content || "[表情]");
+          } else if (part.msgType === "picture" || part.type === "picture") {
+            textParts.push("[图片]");
+          } else if (part.msgType === "at" || part.type === "at") {
+            textParts.push(`@${part.content || part.atName || "某人"}`);
+          } else if (part.text) {
+            textParts.push(part.text);
+          }
+        }
+        const quoteText = textParts.join("").trim();
+        if (quoteText) {
+          return `[引用消息: "${quoteText}"]\n\n`;
+        }
+      }
+    }
+
+    // Some clients only send originalMsgId for rich media reply messages.
+    if (textField?.isReplyMsg && !textField?.repliedMsg && data.originalMsgId) {
+      return `[这是一条引用消息，原消息ID: ${data.originalMsgId}]\n\n`;
+    }
+
+    if (data.quoteMessage) {
+      const quoteText = data.quoteMessage.text?.content?.trim() || "";
+      if (quoteText) {
+        return `[引用消息: "${quoteText}"]\n\n`;
+      }
+    }
+
+    if (data.content?.quoteContent) {
+      return `[引用消息: "${data.content.quoteContent}"]\n\n`;
+    }
+
+    return "";
+  };
+
+  const quotedPrefix = formatQuotedContent();
+
+  // Unified extraction by DingTalk msgtype for downstream routing/agent processing.
+  if (msgtype === "text") {
+    return { text: quotedPrefix + (data.text?.content?.trim() || ""), messageType: "text" };
+  }
+
+  if (msgtype === "richText") {
+    const richTextParts = data.content?.richText || [];
+    let text = "";
+    let pictureDownloadCode: string | undefined;
+    // Keep first image downloadCode while preserving readable text and @mention parts.
+    for (const part of richTextParts) {
+      if (part.text && (part.type === "text" || part.type === undefined)) {
+        text += part.text;
+      }
+      if (part.type === "at" && part.atName) {
+        text += `@${part.atName} `;
+      }
+      if (part.type === "picture" && part.downloadCode && !pictureDownloadCode) {
+        pictureDownloadCode = part.downloadCode;
+      }
+    }
+    return {
+      text:
+        quotedPrefix + (text.trim() || (pictureDownloadCode ? "<media:image>" : "[富文本消息]")),
+      mediaPath: pictureDownloadCode,
+      mediaType: pictureDownloadCode ? "image" : undefined,
+      messageType: "richText",
+    };
+  }
+
+  if (msgtype === "picture") {
+    return {
+      text: "<media:image>",
+      mediaPath: data.content?.downloadCode,
+      mediaType: "image",
+      messageType: "picture",
+    };
+  }
+
+  if (msgtype === "audio") {
+    return {
+      text: data.content?.recognition || "<media:voice>",
+      mediaPath: data.content?.downloadCode,
+      mediaType: "audio",
+      messageType: "audio",
+    };
+  }
+
+  if (msgtype === "video") {
+    return {
+      text: "<media:video>",
+      mediaPath: data.content?.downloadCode,
+      mediaType: "video",
+      messageType: "video",
+    };
+  }
+
+  if (msgtype === "file") {
+    return {
+      text: `<media:file> (${data.content?.fileName || "文件"})`,
+      mediaPath: data.content?.downloadCode,
+      mediaType: "file",
+      messageType: "file",
+    };
+  }
+
+  // Fallback: preserve unknown msgtype as readable marker.
+  return { text: data.text?.content?.trim() || `[${msgtype}消息]`, messageType: msgtype };
+}

package/src/onboarding.ts

@@ -1,9 +1,9 @@
-import type { OpenClawConfig, ChannelOnboardingAdapter, WizardPrompter } from 'openclaw/plugin-sdk';
-import { DEFAULT_ACCOUNT_ID, normalizeAccountId, formatDocsLink } from 'openclaw/plugin-sdk';
-import type { DingTalkConfig, DingTalkChannelConfig } from './types.js';
-import { listDingTalkAccountIds, resolveDingTalkAccount } from './types.js';
+import type { OpenClawConfig, ChannelOnboardingAdapter, WizardPrompter } from "openclaw/plugin-sdk";
+import { DEFAULT_ACCOUNT_ID, normalizeAccountId, formatDocsLink } from "openclaw/plugin-sdk";
+import type { DingTalkConfig, DingTalkChannelConfig } from "./types.js";
+import { listDingTalkAccountIds, resolveDingTalkAccount } from "./types.js";
 
-const channel = 'dingtalk' as const;
+const channel = "dingtalk" as const;
 
 function isConfigured(account: DingTalkConfig): boolean {
   return Boolean(account.clientId && account.clientSecret);
@@ -23,7 +23,9 @@ function applyAccountNameToChannelSection(params: {
   name?: string;
 }): OpenClawConfig {
   const { cfg, channelKey, name } = params;
-  if (!name) return cfg;
+  if (!name) {
+    return cfg;
+  }
   const base = cfg.channels?.[channelKey] as DingTalkChannelConfig | undefined;
   return {
     ...cfg,
@@ -64,15 +66,15 @@ async function promptDingTalkAccountId(options: {
 async function noteDingTalkHelp(prompter: WizardPrompter): Promise<void> {
   await prompter.note(
     [
-      'You need DingTalk application credentials.',
-      '1. Visit https://open-dev.dingtalk.com/',
-      '2. Create an enterprise internal application',
+      "You need DingTalk application credentials.",
+      "1. Visit https://open-dev.dingtalk.com/",
+      "2. Create an enterprise internal application",
       "3. Enable 'Robot' capability",
       "4. Configure message receiving mode as 'Stream mode'",
-      '5. Copy Client ID (AppKey) and Client Secret (AppSecret)',
-      `Docs: ${formatDocsLink('/channels/dingtalk', 'channels/dingtalk')}`,
-    ].join('\n'),
-    'DingTalk setup'
+      "5. Copy Client ID (AppKey) and Client Secret (AppSecret)",
+      `Docs: ${formatDocsLink("/channels/dingtalk", "channels/dingtalk")}`,
+    ].join("\n"),
+    "DingTalk setup",
   );
 }
 
@@ -86,7 +88,7 @@ function applyAccountConfig(params: {
 
   const namedConfig = applyAccountNameToChannelSection({
     cfg,
-    channelKey: 'dingtalk',
+    channelKey: "dingtalk",
     accountId,
     name: input.name,
   });
@@ -103,7 +105,7 @@ function applyAccountConfig(params: {
     ...(input.allowFrom && input.allowFrom.length > 0 ? { allowFrom: input.allowFrom } : {}),
     ...(input.messageType ? { messageType: input.messageType } : {}),
     ...(input.cardTemplateId ? { cardTemplateId: input.cardTemplateId } : {}),
-    ...(input.cardTemplateKey ? { cardTemplateKey: input.cardTemplateKey } : {})
+    ...(input.cardTemplateKey ? { cardTemplateKey: input.cardTemplateKey } : {}),
   };
 
   if (useDefault) {
@@ -121,7 +123,8 @@ function applyAccountConfig(params: {
   }
 
   const accounts = (base as { accounts?: Record<string, unknown> }).accounts ?? {};
-  const existingAccount = (base as { accounts?: Record<string, Record<string, unknown>> }).accounts?.[accountId] ?? {};
+  const existingAccount =
+    (base as { accounts?: Record<string, Record<string, unknown>> }).accounts?.[accountId] ?? {};
 
   return {
     ...namedConfig,
@@ -155,8 +158,8 @@ export const dingtalkOnboardingAdapter: ChannelOnboardingAdapter = {
     return Promise.resolve({
       channel,
       configured,
-      statusLines: [`DingTalk: ${configured ? 'configured' : 'needs setup'}`],
-      selectionHint: configured ? 'configured' : '钉钉企业机器人',
+      statusLines: [`DingTalk: ${configured ? "configured" : "needs setup"}`],
+      selectionHint: configured ? "configured" : "钉钉企业机器人",
       quickstartScore: configured ? 1 : 4,
     });
   },
@@ -168,7 +171,7 @@ export const dingtalkOnboardingAdapter: ChannelOnboardingAdapter = {
       accountId = await promptDingTalkAccountId({
         cfg,
         prompter,
-        label: 'DingTalk',
+        label: "DingTalk",
         currentId: accountId,
         listAccountIds: listDingTalkAccountIds,
         defaultAccountId: DEFAULT_ACCOUNT_ID,
@@ -179,21 +182,21 @@ export const dingtalkOnboardingAdapter: ChannelOnboardingAdapter = {
     await noteDingTalkHelp(prompter);
 
     const clientId = await prompter.text({
-      message: 'Client ID (AppKey)',
-      placeholder: 'dingxxxxxxxx',
+      message: "Client ID (AppKey)",
+      placeholder: "dingxxxxxxxx",
       initialValue: resolved.clientId ?? undefined,
-      validate: (value) => (String(value ?? '').trim() ? undefined : 'Required'),
+      validate: (value) => (String(value ?? "").trim() ? undefined : "Required"),
     });
 
     const clientSecret = await prompter.text({
-      message: 'Client Secret (AppSecret)',
-      placeholder: 'xxx-xxx-xxx-xxx',
+      message: "Client Secret (AppSecret)",
+      placeholder: "xxx-xxx-xxx-xxx",
       initialValue: resolved.clientSecret ?? undefined,
-      validate: (value) => (String(value ?? '').trim() ? undefined : 'Required'),
+      validate: (value) => (String(value ?? "").trim() ? undefined : "Required"),
     });
 
     const wantsFullConfig = await prompter.confirm({
-      message: 'Configure robot code, corp ID, and agent ID? (recommended for full features)',
+      message: "Configure robot code, corp ID, and agent ID? (recommended for full features)",
       initialValue: false,
     });
 
@@ -205,100 +208,100 @@ export const dingtalkOnboardingAdapter: ChannelOnboardingAdapter = {
       robotCode =
         String(
           await prompter.text({
-            message: 'Robot Code',
-            placeholder: 'dingxxxxxxxx',
+            message: "Robot Code",
+            placeholder: "dingxxxxxxxx",
             initialValue: resolved.robotCode ?? undefined,
-          })
+          }),
         ).trim() || undefined;
 
       corpId =
         String(
           await prompter.text({
-            message: 'Corp ID',
-            placeholder: 'dingxxxxxxxx',
+            message: "Corp ID",
+            placeholder: "dingxxxxxxxx",
             initialValue: resolved.corpId ?? undefined,
-          })
+          }),
         ).trim() || undefined;
 
       agentId =
         String(
           await prompter.text({
-            message: 'Agent ID',
-            placeholder: '123456789',
+            message: "Agent ID",
+            placeholder: "123456789",
             initialValue: resolved.agentId ? String(resolved.agentId) : undefined,
-          })
+          }),
         ).trim() || undefined;
     }
 
     const wantsCardMode = await prompter.confirm({
-      message: 'Enable AI interactive card mode? (for streaming AI responses)',
-      initialValue: resolved.messageType === 'card',
+      message: "Enable AI interactive card mode? (for streaming AI responses)",
+      initialValue: resolved.messageType === "card",
     });
 
     let cardTemplateId: string | undefined;
     let cardTemplateKey: string | undefined;
-    let messageType: 'markdown' | 'card' = 'markdown';
+    let messageType: "markdown" | "card" = "markdown";
 
     if (wantsCardMode) {
       await prompter.note(
         [
-          'Create an AI card template in DingTalk Developer Console:',
-          'https://open-dev.dingtalk.com/fe/card',
+          "Create an AI card template in DingTalk Developer Console:",
+          "https://open-dev.dingtalk.com/fe/card",
           "1. Go to 'My Templates' > 'Create Template'",
           "2. Select 'AI Card' scenario",
-          '3. Design your card and publish',
-          '4. Copy the Template ID (e.g., xxx.schema)',
-        ].join('\n'),
-        'Card Template Setup'
+          "3. Design your card and publish",
+          "4. Copy the Template ID (e.g., xxx.schema)",
+        ].join("\n"),
+        "Card Template Setup",
       );
 
       cardTemplateId =
         String(
           await prompter.text({
-            message: 'Card Template ID',
-            placeholder: 'xxxxx-xxxxx-xxxxx.schema',
+            message: "Card Template ID",
+            placeholder: "xxxxx-xxxxx-xxxxx.schema",
             initialValue: resolved.cardTemplateId ?? undefined,
-          })
+          }),
         ).trim() || undefined;
 
       cardTemplateKey =
         String(
           await prompter.text({
-            message: 'Card Template Key (content field name)',
-            placeholder: 'msgContent',
-            initialValue: resolved.cardTemplateKey ?? 'msgContent',
-          })
-        ).trim() || 'msgContent';
+            message: "Card Template Key (content field name)",
+            placeholder: "msgContent",
+            initialValue: resolved.cardTemplateKey ?? "msgContent",
+          }),
+        ).trim() || "msgContent";
 
-      messageType = 'card';
+      messageType = "card";
     }
 
     const dmPolicyValue = await prompter.select({
-      message: 'Direct message policy',
+      message: "Direct message policy",
       options: [
-        { label: 'Open - anyone can DM', value: 'open' },
-        { label: 'Allowlist - only allowed users', value: 'allowlist' },
+        { label: "Open - anyone can DM", value: "open" },
+        { label: "Allowlist - only allowed users", value: "allowlist" },
       ],
-      initialValue: resolved.dmPolicy ?? 'open',
+      initialValue: resolved.dmPolicy ?? "open",
     });
 
     let allowFrom: string[] | undefined;
-    if (dmPolicyValue === 'allowlist') {
+    if (dmPolicyValue === "allowlist") {
       const entry = await prompter.text({
-        message: 'Allowed user IDs (comma-separated)',
-        placeholder: 'user1, user2',
+        message: "Allowed user IDs (comma-separated)",
+        placeholder: "user1, user2",
       });
-      const parsed = parseList(String(entry ?? ''));
+      const parsed = parseList(String(entry ?? ""));
       allowFrom = parsed.length > 0 ? parsed : undefined;
     }
 
     const groupPolicyValue = await prompter.select({
-      message: 'Group message policy',
+      message: "Group message policy",
       options: [
-        { label: 'Open - any group can use bot', value: 'open' },
-        { label: 'Allowlist - only allowed groups', value: 'allowlist' },
+        { label: "Open - any group can use bot", value: "open" },
+        { label: "Allowlist - only allowed groups", value: "allowlist" },
       ],
-      initialValue: resolved.groupPolicy ?? 'open',
+      initialValue: resolved.groupPolicy ?? "open",
     });
 
     const next = applyAccountConfig({
@@ -310,8 +313,8 @@ export const dingtalkOnboardingAdapter: ChannelOnboardingAdapter = {
         robotCode,
         corpId,
         agentId,
-        dmPolicy: dmPolicyValue as 'open' | 'allowlist',
-        groupPolicy: groupPolicyValue as 'open' | 'allowlist',
+        dmPolicy: dmPolicyValue as "open" | "allowlist",
+        groupPolicy: groupPolicyValue as "open" | "allowlist",
         allowFrom,
         messageType,
         cardTemplateId,

package/src/peer-id-registry.ts

@@ -14,7 +14,9 @@ const peerIdMap = new Map<string, string>();
  * Register an original peer ID, keyed by its lowercased form.
  */
 export function registerPeerId(originalId: string): void {
-  if (!originalId) return;
+  if (!originalId) {
+    return;
+  }
   peerIdMap.set(originalId.toLowerCase(), originalId);
 }
 
@@ -23,7 +25,9 @@ export function registerPeerId(originalId: string): void {
  * Returns the original if found, otherwise returns the input as-is.
  */
 export function resolveOriginalPeerId(id: string): string {
-  if (!id) return id;
+  if (!id) {
+    return id;
+  }
   return peerIdMap.get(id.toLowerCase()) || id;
 }
 

package/src/runtime.ts

@@ -1,4 +1,4 @@
-import type { PluginRuntime } from 'openclaw/plugin-sdk';
+import type { PluginRuntime } from "openclaw/plugin-sdk";
 
 let runtime: PluginRuntime | null = null;
 
@@ -8,7 +8,7 @@ export function setDingTalkRuntime(next: PluginRuntime): void {
 
 export function getDingTalkRuntime(): PluginRuntime {
   if (!runtime) {
-    throw new Error('DingTalk runtime not initialized');
+    throw new Error("DingTalk runtime not initialized");
   }
   return runtime;
 }