@zhin.js/adapter-weixin-ilink 5.0.12 → 6.0.0

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # @zhin.js/adapter-weixin-ilink
 
+## 6.0.0
+
+### Patch Changes
+
+- f2c532f: Expose exact per-Endpoint message operations through one validated Adapter capability model, route Core control calls through declared active capabilities, and connect existing recall, edit, reaction, and typing implementations across platform adapters.
+- Updated dependencies [f2c532f]
+  - @zhin.js/adapter@1.2.0
+  - @zhin.js/core@1.5.13
+  - zhin.js@6.0.13
+
+## 5.0.13
+
+### Patch Changes
+
+- 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.
+- 3b3ec03: Emit canonical reply and media segments instead of eager quote text and media placeholders.
+- Updated dependencies [5969c5b]
+- Updated dependencies [5969c5b]
+- Updated dependencies [5969c5b]
+- Updated dependencies [974772e]
+- Updated dependencies [5969c5b]
+- Updated dependencies [2f786bd]
+- Updated dependencies [1312ca0]
+  - @zhin.js/im-contract@1.0.4
+  - @zhin.js/core@1.5.12
+  - @zhin.js/adapter@1.1.11
+  - @zhin.js/command@1.0.15
+  - zhin.js@6.0.12
+
 ## 5.0.12
 
 ### Patch Changes

package/adapters/weixin-ilink.js

@@ -3,13 +3,14 @@
  * Convention entry: discover `adapters/weixin-ilink.ts` → defineAdapter.
  */
 import { defineAdapter } from 'zhin.js/adapter';
-import { messageGatewayToken } from '@zhin.js/core/runtime';
+import { messageGatewayToken, sideEventGatewayToken } from '@zhin.js/core/runtime';
 import { WeixinIlinkEndpoint } from "../lib/endpoint.js";
 import { resolveWeixinIlinkConfig, } from "../lib/protocol.js";
 import { weixinIlinkRuntimeStateToken } from "../lib/weixin-ilink-runtime-state.js";
 export { WeixinIlinkEndpoint } from "../lib/endpoint.js";
 export default defineAdapter({
     capabilities: ['inbound', 'outbound'],
+    operations: ['typing'],
     // 所有媒体（url 下载 / base64 落盘 / 本地 path）统一物化后走 CDN 上传（sendWeixinMediaFile），
     // 无直发面；微信无卡片交互面，交互段降级纯文本。
     segments: {
@@ -27,6 +28,7 @@ export default defineAdapter({
         return new WeixinIlinkEndpoint({
             id: context.id,
             gateway: context.use(messageGatewayToken),
+            sideEvents: context.use(sideEventGatewayToken),
             config,
         });
     },

package/adapters/weixin-ilink.ts

@@ -2,7 +2,7 @@
  * Convention entry: discover `adapters/weixin-ilink.ts` → defineAdapter.
  */
 import { defineAdapter } from 'zhin.js/adapter';
-import { messageGatewayToken } from '@zhin.js/core/runtime';
+import { messageGatewayToken, sideEventGatewayToken } from '@zhin.js/core/runtime';
 import { WeixinIlinkEndpoint } from '../src/endpoint.js';
 import {
   resolveWeixinIlinkConfig,
@@ -21,6 +21,7 @@ export type {
 
 export default defineAdapter<WeixinIlinkAdapterConfig>({
   capabilities: ['inbound', 'outbound'],
+  operations: ['typing'],
   // 所有媒体（url 下载 / base64 落盘 / 本地 path）统一物化后走 CDN 上传（sendWeixinMediaFile），
   // 无直发面；微信无卡片交互面，交互段降级纯文本。
   segments: {
@@ -38,6 +39,7 @@ export default defineAdapter<WeixinIlinkAdapterConfig>({
     return new WeixinIlinkEndpoint({
       id: context.id,
       gateway: context.use(messageGatewayToken),
+      sideEvents: context.use(sideEventGatewayToken),
       config,
     });
   },

package/lib/endpoint.d.ts

@@ -1,5 +1,5 @@
-import type { EndpointInstance, EndpointManagement, EndpointSendRequest } from 'zhin.js/adapter';
-import type { MessageGateway } from '@zhin.js/core/runtime';
+import type { EndpointControl, EndpointInstance, EndpointManagement, EndpointSendRequest } from 'zhin.js/adapter';
+import type { MessageGateway, SideEventGateway } from '@zhin.js/core/runtime';
 import type { CapabilityId } from 'zhin.js';
 import { getUpdates, notifyStart, notifyStop } from './ilink-api.js';
 import { type WeixinIlinkCredentials } from './credentials.js';
@@ -12,6 +12,7 @@ export type WeixinIlinkGetUpdates = typeof getUpdates;
 export interface WeixinIlinkEndpointOptions {
     readonly id: CapabilityId;
     readonly gateway: MessageGateway;
+    readonly sideEvents?: SideEventGateway;
     readonly config: ResolvedWeixinIlinkConfig;
     readonly resolveCredentials?: (config: ResolvedWeixinIlinkConfig, signal?: AbortSignal) => Promise<WeixinIlinkCredentials>;
     /** Test / internal: override network side effects. */
@@ -23,6 +24,7 @@ export interface WeixinIlinkEndpointOptions {
 export declare class WeixinIlinkEndpoint implements EndpointInstance {
     #private;
     readonly management: EndpointManagement;
+    readonly control: EndpointControl;
     constructor(options: WeixinIlinkEndpointOptions);
     get hasCredentials(): boolean;
     /** Live endpoint 名（context token 按 account 名分桶，management 推导对端用）。 */

package/lib/endpoint.js

@@ -18,7 +18,7 @@ import { sendWeixinMediaFile } from './weixin-send-media.js';
 import { materializeOutboundMedia } from './outbound-media.js';
 import { MessageItemType } from './ilink-types.js';
 import { getExtensionFromMime, sniffMimeFromBuffer } from './mime.js';
-import { formatInboundContent, formatOutboundSegments, inboundMessageId, segmentLocalPath, sleep, weixinIlinkInboundConversation, } from './protocol.js';
+import { formatInboundContent, weixinInboundSegments, weixinReplyTo, formatOutboundSegments, inboundMessageId, segmentLocalPath, sleep, weixinIlinkInboundConversation, } from './protocol.js';
 const MAX_CONSECUTIVE_FAILURES = 3;
 const BACKOFF_DELAY_MS = 30_000;
 const RETRY_DELAY_MS = 2_000;
@@ -43,6 +43,9 @@ export class WeixinIlinkEndpoint {
     #open = false;
     #started = false;
     management = createWeixinIlinkEndpointManagement(this);
+    control = Object.freeze({
+        typing: (conversation, active) => this.sendTypingToUser(conversation.id, active === false ? 2 : 1),
+    });
     constructor(options) {
         this.#logger = getAdapterLogger('weixin-ilink', options.config.id);
         this.#options = options;
@@ -218,10 +221,13 @@ export class WeixinIlinkEndpoint {
             setContextToken(this.#options.config.id, userId, msg.context_token);
         }
         const conversation = weixinIlinkInboundConversation(String(this.#options.id), userId);
+        const replyTo = weixinReplyTo(msg);
         void this.#options.gateway.receive({
             conversation,
             message: { conversation, id: inboundMessageId(msg) },
             content: formatInboundContent(msg),
+            segments: weixinInboundSegments(msg),
+            ...(replyTo ? { replyTo } : {}),
             sender: { id: userId },
             endpointId: this.#options.config.id,
             metadata: Object.freeze({

package/lib/protocol.d.ts

@@ -2,7 +2,7 @@
  * Weixin iLink protocol helpers (no legacy Adapter/Endpoint / segment-mapper).
  * Canonicalization is owned by gateway/core before endpoint.send.
  */
-import type { ConversationRef } from '@zhin.js/im-contract';
+import type { ConversationRef, Segment } from '@zhin.js/im-contract';
 import type { WeixinMessage } from './ilink-types.js';
 /** Plugin Runtime owner config (`plugins.<instanceKey>` / schema.json). */
 export interface WeixinIlinkAdapterConfig {
@@ -43,6 +43,10 @@ export type WeixinMessageWithMedia = WeixinMessage & {
 export declare function resolveWeixinIlinkConfig(config?: WeixinIlinkAdapterConfig): ResolvedWeixinIlinkConfig;
 /** Build inbound text for MessageGateway.receive (gateway owns reply routing). */
 export declare function formatInboundContent(msg: WeixinMessageWithMedia): string;
+export declare function weixinInboundSegments(msg: WeixinMessageWithMedia): readonly Segment[];
+export declare function weixinReplyTo(msg: WeixinMessageWithMedia): Readonly<{
+    id: string;
+}> | undefined;
 export declare function inboundMessageId(msg: WeixinMessage): string;
 /**
  * 入站归一化 → ConversationRef：个人微信无群/频道概念，全部会话都是

package/lib/protocol.js

@@ -4,7 +4,7 @@
  */
 import { pickCredential } from 'zhin.js/adapter';
 import { isMediaRef } from '@zhin.js/core';
-import { bodyFromItemList, isMediaItem } from './weixin-inbound.js';
+import { bodyFromItemList } from './weixin-inbound.js';
 import { DEFAULT_API_BASE_URL, DEFAULT_CDN_BASE_URL } from './ilink-meta.js';
 const DEFAULT_LONG_POLL_TIMEOUT_MS = 35_000;
 export function resolveWeixinIlinkConfig(config = {}) {
@@ -30,27 +30,35 @@ export function resolveWeixinIlinkConfig(config = {}) {
 }
 /** Build inbound text for MessageGateway.receive (gateway owns reply routing). */
 export function formatInboundContent(msg) {
-    const parts = [];
-    const text = bodyFromItemList(msg.item_list);
+    return bodyFromItemList(msg.item_list).trim();
+}
+export function weixinInboundSegments(msg) {
+    const segments = [];
+    const text = formatInboundContent(msg);
     if (text)
-        parts.push(text);
+        segments.push({ type: 'text', data: { text } });
     const media = msg._media;
     if (media?.decryptedPicPath) {
-        parts.push(`[image: ${media.decryptedPicPath}]`);
+        segments.push({ type: 'image', data: { media: { kind: 'path', value: media.decryptedPicPath } } });
     }
     else if (media?.decryptedVideoPath) {
-        parts.push(`[video: ${media.decryptedVideoPath}]`);
+        segments.push({ type: 'video', data: { media: { kind: 'path', value: media.decryptedVideoPath } } });
     }
     else if (media?.decryptedFilePath) {
-        parts.push(`[file: ${media.decryptedFilePath}]`);
+        segments.push({ type: 'file', data: { media: { kind: 'path', value: media.decryptedFilePath } } });
     }
     else if (media?.decryptedVoicePath) {
-        parts.push(`[record: ${media.decryptedVoicePath}]`);
+        segments.push({ type: 'audio', data: { media: { kind: 'path', value: media.decryptedVoicePath } } });
     }
-    else if (!text && msg.item_list?.some((item) => isMediaItem(item))) {
-        parts.push('[媒体消息]');
+    return Object.freeze(segments);
+}
+export function weixinReplyTo(msg) {
+    for (const item of msg.item_list ?? []) {
+        const id = item.ref_msg?.message_item?.msg_id;
+        if (id && String(id).trim())
+            return Object.freeze({ id: String(id).trim() });
     }
-    return parts.join('\n').trim() || '';
+    return undefined;
 }
 export function inboundMessageId(msg) {
     return String(msg.message_id ?? msg.client_id ?? msg.seq ?? Date.now());

package/lib/weixin-inbound.js

@@ -168,25 +168,7 @@ export function bodyFromItemList(itemList) {
         return "";
     for (const item of itemList) {
         if (item.type === MessageItemType.TEXT && item.text_item?.text != null) {
-            const text = String(item.text_item.text);
-            const ref = item.ref_msg;
-            if (!ref)
-                return text;
-            // Quoted media is passed as MediaPath; only include the current text as body.
-            if (ref.message_item && isMediaItem(ref.message_item))
-                return text;
-            // Build quoted context from both title and message_item content.
-            const parts = [];
-            if (ref.title)
-                parts.push(ref.title);
-            if (ref.message_item) {
-                const refBody = bodyFromItemList([ref.message_item]);
-                if (refBody)
-                    parts.push(refBody);
-            }
-            if (!parts.length)
-                return text;
-            return `[引用: ${parts.join(" | ")}]\n${text}`;
+            return String(item.text_item.text);
         }
         // 语音转文字：如果语音消息有 text 字段，直接使用文字内容
         if (item.type === MessageItemType.VOICE && item.voice_item?.text) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-weixin-ilink",
-  "version": "5.0.12",
+  "version": "6.0.0",
   "type": "module",
   "description": "Zhin.js Weixin iLink (ClawBot) adapter for Plugin Runtime (long-poll)",
   "main": "./lib/index.js",
@@ -48,16 +48,16 @@
     }
   },
   "dependencies": {
-    "@zhin.js/adapter": "1.1.10",
-    "@zhin.js/core": "1.5.11",
-    "@zhin.js/im-contract": "1.0.3",
+    "@zhin.js/adapter": "1.2.0",
+    "@zhin.js/core": "1.5.13",
+    "@zhin.js/im-contract": "1.0.4",
     "@zhin.js/logger": "1.0.76"
   },
   "peerDependencies": {
-    "@zhin.js/adapter": "1.1.10",
-    "@zhin.js/command": "1.0.14",
-    "@zhin.js/core": "1.5.11",
-    "zhin.js": "6.0.11"
+    "@zhin.js/adapter": "1.2.0",
+    "@zhin.js/command": "1.0.15",
+    "@zhin.js/core": "1.5.13",
+    "zhin.js": "6.0.13"
   },
   "peerDependenciesMeta": {
     "@zhin.js/command": {
@@ -71,7 +71,7 @@
     "@types/node": "^26.1.2",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
-    "zhin.js": "6.0.11"
+    "zhin.js": "6.0.13"
   },
   "ilink_appid": "bot",
   "engines": {

package/src/endpoint.ts

@@ -6,11 +6,12 @@ import fs from 'node:fs';
 import path from 'node:path';
 import type {
   EndpointFriend,
+  EndpointControl,
   EndpointInstance,
   EndpointManagement,
   EndpointSendRequest,
 } from 'zhin.js/adapter';
-import type { MessageGateway } from '@zhin.js/core/runtime';
+import type { MessageGateway, SideEventGateway } from '@zhin.js/core/runtime';
 import { formatCompact, getAdapterLogger } from '@zhin.js/logger';
 import type { CapabilityId } from 'zhin.js';
 import { getUpdates, notifyStart, notifyStop, sendTyping } from './ilink-api.js';
@@ -45,6 +46,8 @@ import { getExtensionFromMime, sniffMimeFromBuffer } from './mime.js';
 import type { WeixinInboundMediaOpts } from './weixin-inbound.js';
 import {
   formatInboundContent,
+  weixinInboundSegments,
+  weixinReplyTo,
   formatOutboundSegments,
   inboundMessageId,
   segmentLocalPath,
@@ -71,6 +74,7 @@ export type WeixinIlinkGetUpdates = typeof getUpdates;
 export interface WeixinIlinkEndpointOptions {
   readonly id: CapabilityId;
   readonly gateway: MessageGateway;
+  readonly sideEvents?: SideEventGateway;
   readonly config: ResolvedWeixinIlinkConfig;
   readonly resolveCredentials?: (
     config: ResolvedWeixinIlinkConfig,
@@ -104,6 +108,12 @@ export class WeixinIlinkEndpoint implements EndpointInstance {
   #open = false;
   #started = false;
   readonly management: EndpointManagement = createWeixinIlinkEndpointManagement(this);
+  readonly control: EndpointControl = Object.freeze<EndpointControl>({
+    typing: (conversation, active) => this.sendTypingToUser(
+      conversation.id,
+      active === false ? 2 : 1,
+    ),
+  });
 
   constructor(options: WeixinIlinkEndpointOptions) {
     this.#logger = getAdapterLogger('weixin-ilink', options.config.id);
@@ -297,10 +307,13 @@ export class WeixinIlinkEndpoint implements EndpointInstance {
       setContextToken(this.#options.config.id, userId, msg.context_token);
     }
     const conversation = weixinIlinkInboundConversation(String(this.#options.id), userId);
+    const replyTo = weixinReplyTo(msg);
     void this.#options.gateway.receive({
       conversation,
       message: { conversation, id: inboundMessageId(msg) },
       content: formatInboundContent(msg),
+      segments: weixinInboundSegments(msg),
+      ...(replyTo ? { replyTo } : {}),
       sender: { id: userId },
       endpointId: this.#options.config.id,
       metadata: Object.freeze({

package/src/protocol.ts

@@ -5,8 +5,8 @@
 
 import { pickCredential } from 'zhin.js/adapter';
 import { isMediaRef } from '@zhin.js/core';
-import type { ConversationRef } from '@zhin.js/im-contract';
-import { bodyFromItemList, isMediaItem } from './weixin-inbound.js';
+import type { ConversationRef, Segment } from '@zhin.js/im-contract';
+import { bodyFromItemList } from './weixin-inbound.js';
 import { DEFAULT_API_BASE_URL, DEFAULT_CDN_BASE_URL } from './ilink-meta.js';
 import type { WeixinMessage } from './ilink-types.js';
 
@@ -84,24 +84,32 @@ export function resolveWeixinIlinkConfig(
 
 /** Build inbound text for MessageGateway.receive (gateway owns reply routing). */
 export function formatInboundContent(msg: WeixinMessageWithMedia): string {
-  const parts: string[] = [];
-  const text = bodyFromItemList(msg.item_list);
-  if (text) parts.push(text);
+  return bodyFromItemList(msg.item_list).trim();
+}
 
+export function weixinInboundSegments(msg: WeixinMessageWithMedia): readonly Segment[] {
+  const segments: Segment[] = [];
+  const text = formatInboundContent(msg);
+  if (text) segments.push({ type: 'text', data: { text } });
   const media = msg._media;
   if (media?.decryptedPicPath) {
-    parts.push(`[image: ${media.decryptedPicPath}]`);
+    segments.push({ type: 'image', data: { media: { kind: 'path', value: media.decryptedPicPath } } });
   } else if (media?.decryptedVideoPath) {
-    parts.push(`[video: ${media.decryptedVideoPath}]`);
+    segments.push({ type: 'video', data: { media: { kind: 'path', value: media.decryptedVideoPath } } });
   } else if (media?.decryptedFilePath) {
-    parts.push(`[file: ${media.decryptedFilePath}]`);
+    segments.push({ type: 'file', data: { media: { kind: 'path', value: media.decryptedFilePath } } });
   } else if (media?.decryptedVoicePath) {
-    parts.push(`[record: ${media.decryptedVoicePath}]`);
-  } else if (!text && msg.item_list?.some((item) => isMediaItem(item))) {
-    parts.push('[媒体消息]');
+    segments.push({ type: 'audio', data: { media: { kind: 'path', value: media.decryptedVoicePath } } });
   }
+  return Object.freeze(segments);
+}
 
-  return parts.join('\n').trim() || '';
+export function weixinReplyTo(msg: WeixinMessageWithMedia): Readonly<{ id: string }> | undefined {
+  for (const item of msg.item_list ?? []) {
+    const id = item.ref_msg?.message_item?.msg_id;
+    if (id && String(id).trim()) return Object.freeze({ id: String(id).trim() });
+  }
+  return undefined;
 }
 
 export function inboundMessageId(msg: WeixinMessage): string {

package/src/weixin-inbound.ts

@@ -211,20 +211,7 @@ export function bodyFromItemList(itemList?: MessageItem[]): string {
   if (!itemList?.length) return "";
   for (const item of itemList) {
     if (item.type === MessageItemType.TEXT && item.text_item?.text != null) {
-      const text = String(item.text_item.text);
-      const ref = item.ref_msg;
-      if (!ref) return text;
-      // Quoted media is passed as MediaPath; only include the current text as body.
-      if (ref.message_item && isMediaItem(ref.message_item)) return text;
-      // Build quoted context from both title and message_item content.
-      const parts: string[] = [];
-      if (ref.title) parts.push(ref.title);
-      if (ref.message_item) {
-        const refBody = bodyFromItemList([ref.message_item]);
-        if (refBody) parts.push(refBody);
-      }
-      if (!parts.length) return text;
-      return `[引用: ${parts.join(" | ")}]\n${text}`;
+      return String(item.text_item.text);
     }
     // 语音转文字：如果语音消息有 text 字段，直接使用文字内容
     if (item.type === MessageItemType.VOICE && item.voice_item?.text) {