@zhin.js/adapter-dingtalk 6.0.13 → 6.0.14

package/CHANGELOG.md

@@ -1,5 +1,44 @@
 # @zhin.js/adapter-dingtalk
 
+## 6.0.14
+
+### Patch Changes
+
+- 974772e: Replace the user-facing `Prompt` vocabulary with the `UserInteraction` authoring surface for input, confirmation, and selection. Commands and handlers now expose `interaction`; IM Runtime exposes `createInteraction`; schema-driven endpoint collection is named `SchemaInteraction`. The old prompt-named interaction types and properties are removed rather than aliased. User interactions render through one canonical Markdown and keyboard/list presentation module shared by commands and Agent `ask_user` turns.
+
+  Extract the transport-neutral interaction contract into `@zhin.js/interaction`. A discriminated `ask()` API supports text, number, confirmation, single-select, multi-select, and typed lists with structured `title`, `description`, and `tip` content. Typed `sequence()` interactions return one result object keyed by step id, render progress, and retry invalid replies without leaking invalid values to callers.
+
+  Preserve AI Markdown and card command actions through outbound publishing. QQ delivers Markdown with native command buttons; KOOK, Discord, Telegram, DingTalk, and Lark/Feishu now declare and encode their native Markdown dialects while retaining each adapter's interaction policy. Correct QQ callback button action encoding and button style mapping.
+
+- 5969c5b: Add SideEventGateway so adapters forward notice/request/system into HandlerIndex. HandlerContext now exposes only generation-safe capabilities and prompt ports; live Endpoint escape hatches are removed.
+- Updated dependencies [5969c5b]
+- Updated dependencies [d336a3f]
+- Updated dependencies [0c82a7e]
+- Updated dependencies [b9217e4]
+- Updated dependencies [5969c5b]
+- Updated dependencies [5969c5b]
+- Updated dependencies [974772e]
+- Updated dependencies [5969c5b]
+- Updated dependencies [5969c5b]
+- Updated dependencies [2f786bd]
+- Updated dependencies [63d89f9]
+- Updated dependencies [71c7cdd]
+- Updated dependencies [3cca0ea]
+- Updated dependencies [1312ca0]
+- Updated dependencies [985fa22]
+- Updated dependencies [04b861d]
+- Updated dependencies [a23d544]
+- Updated dependencies [8cddabf]
+- Updated dependencies [dbe5081]
+  - @zhin.js/im-contract@1.0.4
+  - @zhin.js/core@1.5.12
+  - @zhin.js/adapter@1.1.11
+  - @zhin.js/agent@1.1.14
+  - @zhin.js/host-http@1.0.11
+  - @zhin.js/command@1.0.15
+  - zhin.js@6.0.12
+  - @zhin.js/permission@1.0.3
+
 ## 6.0.13
 
 ### Patch Changes

package/README.md

@@ -7,6 +7,7 @@ Zhin.js 钉钉适配器（Plugin Runtime），通过 Runtime Host HTTP Webhook
 - Webhook 事件接收（`httpHostToken` POST + HMAC-SHA256 签名验证）
 - Access Token 自动刷新
 - Session Webhook 优先回复 / `/robot/send` 主动发送
+- canonical `markdown` 段编码为钉钉原生 `msgtype: markdown`
 - 约定式 `defineAdapter` / `definePlugin`（无需 `usePlugin`）
 
 ## 安装

package/adapters/dingtalk.js

@@ -3,7 +3,7 @@
  * Convention entry: discover `adapters/dingtalk.ts` → defineAdapter.
  */
 import { defineAdapter } from 'zhin.js/adapter';
-import { messageGatewayToken } from '@zhin.js/core/runtime';
+import { messageGatewayToken, sideEventGatewayToken } from '@zhin.js/core/runtime';
 import { httpHostToken } from '@zhin.js/host-http';
 import { DingTalkEndpoint } from "../lib/endpoint.js";
 import { resolveDingTalkConfig, } from "../lib/protocol.js";
@@ -11,10 +11,12 @@ import { dingtalkRuntimeStateToken } from "../lib/dingtalk-runtime-state.js";
 export { DingTalkEndpoint } from "../lib/endpoint.js";
 export default defineAdapter({
     capabilities: ['inbound', 'outbound'],
-    // 钉钉机器人媒体消息仅消费远程 URL；无按钮交互面，交互段降级纯文本。
+    // 钉钉机器人媒体消息仅消费远程 URL；Markdown 走原生 msgtype；
+    // 无按钮交互面，交互段降级纯文本。
     segments: {
         outboundMedia: ['url'],
         interactive: 'text',
+        markdown: 'native',
     },
     create(context) {
         const config = resolveDingTalkConfig(context.config);
@@ -26,6 +28,7 @@ export default defineAdapter({
         return new DingTalkEndpoint({
             id: context.id,
             gateway: context.use(messageGatewayToken),
+            sideEvents: context.use(sideEventGatewayToken),
             http: context.use(httpHostToken),
             config,
         });

package/adapters/dingtalk.ts

@@ -2,7 +2,7 @@
  * Convention entry: discover `adapters/dingtalk.ts` → defineAdapter.
  */
 import { defineAdapter } from 'zhin.js/adapter';
-import { messageGatewayToken } from '@zhin.js/core/runtime';
+import { messageGatewayToken, sideEventGatewayToken } from '@zhin.js/core/runtime';
 import { httpHostToken } from '@zhin.js/host-http';
 import { DingTalkEndpoint } from '../src/endpoint.js';
 import {
@@ -16,10 +16,12 @@ export type { DingTalkEndpointOptions, DingTalkFetch } from '../src/endpoint.js'
 
 export default defineAdapter<DingTalkAdapterConfig>({
   capabilities: ['inbound', 'outbound'],
-  // 钉钉机器人媒体消息仅消费远程 URL；无按钮交互面，交互段降级纯文本。
+  // 钉钉机器人媒体消息仅消费远程 URL；Markdown 走原生 msgtype；
+  // 无按钮交互面，交互段降级纯文本。
   segments: {
     outboundMedia: ['url'],
     interactive: 'text',
+    markdown: 'native',
   },
   create(context) {
     const config = resolveDingTalkConfig(context.config);
@@ -31,6 +33,7 @@ export default defineAdapter<DingTalkAdapterConfig>({
     return new DingTalkEndpoint({
       id: context.id,
       gateway: context.use(messageGatewayToken),
+      sideEvents: context.use(sideEventGatewayToken),
       http: context.use(httpHostToken),
       config,
     });

package/lib/endpoint.d.ts

@@ -2,7 +2,7 @@
  * DingTalkEndpoint — lifecycle, outbound, admit, OpenAPI helpers for agent tools.
  */
 import type { EndpointInstance, EndpointSendRequest } from 'zhin.js/adapter';
-import type { MessageGateway } from '@zhin.js/core/runtime';
+import type { MessageGateway, SideEventGateway } from '@zhin.js/core/runtime';
 import type { HttpHost } from '@zhin.js/host-http';
 import type { CapabilityId } from 'zhin.js';
 import { type DingTalkEvent, type DingTalkMessage, type ResolvedDingTalkConfig } from './protocol.js';
@@ -19,6 +19,7 @@ export type DingTalkFetch = (url: string, init?: {
 export interface DingTalkEndpointOptions {
     readonly id: CapabilityId;
     readonly gateway: MessageGateway;
+    readonly sideEvents?: SideEventGateway;
     readonly http: HttpHost;
     readonly config: ResolvedDingTalkConfig;
     readonly fetch?: DingTalkFetch;

package/lib/protocol.js

@@ -156,6 +156,7 @@ export function formatOutboundBody(payload) {
     const textParts = [];
     const atUserIds = [];
     let media = null;
+    let markdownTitle;
     for (const item of items) {
         if (typeof item === 'string') {
             textParts.push(item);
@@ -203,15 +204,8 @@ export function formatOutboundBody(payload) {
                 }));
                 break;
             case 'markdown':
-                if (!media) {
-                    media = {
-                        msgtype: 'markdown',
-                        markdown: {
-                            title: String(data.title || '消息'),
-                            text: String(data.content ?? data.text ?? ''),
-                        },
-                    };
-                }
+                markdownTitle ??= String(data.title || '消息');
+                textParts.push(String(data.content ?? data.text ?? ''));
                 break;
             case 'link':
                 if (!media) {
@@ -232,6 +226,13 @@ export function formatOutboundBody(payload) {
     }
     if (media)
         return media;
+    if (markdownTitle !== undefined) {
+        return {
+            msgtype: 'markdown',
+            markdown: { title: markdownTitle, text: textParts.join('') },
+            ...(atUserIds.length > 0 ? { at: { atUserIds, isAtAll: false } } : {}),
+        };
+    }
     const result = {
         msgtype: 'text',
         text: { content: textParts.join('') },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-dingtalk",
-  "version": "6.0.13",
+  "version": "6.0.14",
   "description": "Zhin.js DingTalk (钉钉) adapter for Plugin Runtime (HTTP webhook)",
   "type": "module",
   "main": "./lib/index.js",
@@ -33,21 +33,21 @@
     "directory": "plugins/adapters/dingtalk"
   },
   "dependencies": {
-    "@zhin.js/adapter": "1.1.10",
-    "@zhin.js/core": "1.5.11",
-    "@zhin.js/host-http": "1.0.10",
-    "@zhin.js/im-contract": "1.0.3",
+    "@zhin.js/adapter": "1.1.11",
+    "@zhin.js/core": "1.5.12",
+    "@zhin.js/host-http": "1.0.11",
+    "@zhin.js/im-contract": "1.0.4",
     "@zhin.js/logger": "1.0.76"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/adapter": "1.1.10",
-    "@zhin.js/agent": "1.1.13",
-    "@zhin.js/command": "1.0.14",
-    "@zhin.js/core": "1.5.11",
-    "@zhin.js/host-http": "1.0.10",
-    "@zhin.js/permission": "1.0.2",
-    "zhin.js": "6.0.11"
+    "@zhin.js/adapter": "1.1.11",
+    "@zhin.js/agent": "1.1.14",
+    "@zhin.js/command": "1.0.15",
+    "@zhin.js/core": "1.5.12",
+    "@zhin.js/host-http": "1.0.11",
+    "@zhin.js/permission": "1.0.3",
+    "zhin.js": "6.0.12"
   },
   "peerDependenciesMeta": {
     "@zhin.js/agent": {
@@ -68,8 +68,8 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "@zhin.js/agent": "1.1.13",
-    "zhin.js": "6.0.11"
+    "@zhin.js/agent": "1.1.14",
+    "zhin.js": "6.0.12"
   },
   "files": [
     "adapters",

package/src/endpoint.ts

@@ -2,7 +2,7 @@
  * DingTalkEndpoint — lifecycle, outbound, admit, OpenAPI helpers for agent tools.
  */
 import type { EndpointInstance, EndpointSendRequest } from 'zhin.js/adapter';
-import type { MessageGateway } from '@zhin.js/core/runtime';
+import type { MessageGateway, SideEventGateway } from '@zhin.js/core/runtime';
 import type { HttpHost, HttpRouteRegistration } from '@zhin.js/host-http';
 import { formatCompact, getAdapterLogger } from '@zhin.js/logger';
 import type { CapabilityId } from 'zhin.js';
@@ -42,6 +42,7 @@ export type DingTalkFetch = (
 export interface DingTalkEndpointOptions {
   readonly id: CapabilityId;
   readonly gateway: MessageGateway;
+  readonly sideEvents?: SideEventGateway;
   readonly http: HttpHost;
   readonly config: ResolvedDingTalkConfig;
   readonly fetch?: DingTalkFetch;

package/src/protocol.ts

@@ -268,6 +268,7 @@ export function formatOutboundBody(payload: unknown): DingTalkSendBody {
   const textParts: string[] = [];
   const atUserIds: string[] = [];
   let media: DingTalkSendBody | null = null;
+  let markdownTitle: string | undefined;
 
   for (const item of items) {
     if (typeof item === 'string') {
@@ -315,15 +316,8 @@ export function formatOutboundBody(payload: unknown): DingTalkSendBody {
         }));
         break;
       case 'markdown':
-        if (!media) {
-          media = {
-            msgtype: 'markdown',
-            markdown: {
-              title: String(data.title || '消息'),
-              text: String(data.content ?? data.text ?? ''),
-            },
-          };
-        }
+        markdownTitle ??= String(data.title || '消息');
+        textParts.push(String(data.content ?? data.text ?? ''));
         break;
       case 'link':
         if (!media) {
@@ -344,6 +338,13 @@ export function formatOutboundBody(payload: unknown): DingTalkSendBody {
   }
 
   if (media) return media;
+  if (markdownTitle !== undefined) {
+    return {
+      msgtype: 'markdown',
+      markdown: { title: markdownTitle, text: textParts.join('') },
+      ...(atUserIds.length > 0 ? { at: { atUserIds, isAtAll: false } } : {}),
+    };
+  }
 
   const result: DingTalkSendBody = {
     msgtype: 'text',