@zhin.js/adapter-weixin-ilink 3.0.1 → 3.0.3

package/lib/protocol.js

@@ -0,0 +1,109 @@
+/**
+ * Weixin iLink protocol helpers (no legacy Adapter/Endpoint / segment-mapper).
+ * Canonicalization is owned by gateway/core before endpoint.send.
+ */
+import { pickCredential } from '@zhin.js/adapter';
+import { bodyFromItemList, isMediaItem } 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 = {}) {
+    const entry = config.endpoints?.find((item) => item.context === 'weixin-ilink');
+    const name = (typeof config.name === 'string' && config.name)
+        || (typeof entry?.name === 'string' && entry.name)
+        || process.env.WEIXIN_ILINK_BOT_NAME
+        || 'weixin-ilink-bot';
+    const botToken = pickCredential(typeof config.botToken === 'string' ? config.botToken.trim() : config.botToken, typeof entry?.botToken === 'string' ? entry.botToken.trim() : entry?.botToken, process.env.WEIXIN_ILINK_TOKEN?.trim());
+    // No throw here: missing botToken is resolved later by resolveCredentials()
+    // (sidecar credentials file / QR login) during endpoint.start().
+    return {
+        context: 'weixin-ilink',
+        name,
+        botAgent: config.botAgent ?? entry?.botAgent,
+        baseUrl: config.baseUrl ?? entry?.baseUrl ?? DEFAULT_API_BASE_URL,
+        cdnBaseUrl: config.cdnBaseUrl ?? entry?.cdnBaseUrl ?? DEFAULT_CDN_BASE_URL,
+        longPollTimeoutMs: config.longPollTimeoutMs
+            ?? entry?.longPollTimeoutMs
+            ?? DEFAULT_LONG_POLL_TIMEOUT_MS,
+        botToken,
+    };
+}
+/** Build inbound text for MessageGateway.receive (gateway owns reply routing). */
+export function formatInboundContent(msg) {
+    const parts = [];
+    const text = bodyFromItemList(msg.item_list);
+    if (text)
+        parts.push(text);
+    const media = msg._media;
+    if (media?.decryptedPicPath) {
+        parts.push(`[image: ${media.decryptedPicPath}]`);
+    }
+    else if (media?.decryptedVideoPath) {
+        parts.push(`[video: ${media.decryptedVideoPath}]`);
+    }
+    else if (media?.decryptedFilePath) {
+        parts.push(`[file: ${media.decryptedFilePath}]`);
+    }
+    else if (media?.decryptedVoicePath) {
+        parts.push(`[record: ${media.decryptedVoicePath}]`);
+    }
+    else if (!text && msg.item_list?.some((item) => isMediaItem(item))) {
+        parts.push('[媒体消息]');
+    }
+    return parts.join('\n').trim() || '';
+}
+export function inboundMessageId(msg) {
+    return String(msg.message_id ?? msg.client_id ?? msg.seq ?? Date.now());
+}
+/**
+ * Wire-encode an already-rendered outbound payload into Weixin wire segments.
+ * Segment canonicalization is intentionally not done here.
+ */
+export function formatOutboundSegments(payload) {
+    if (typeof payload === 'string') {
+        return [{ type: 'text', data: { text: payload } }];
+    }
+    const items = Array.isArray(payload)
+        ? payload
+        : payload && typeof payload === 'object' && 'type' in payload
+            ? [payload]
+            : [];
+    if (items.length === 0) {
+        const text = payload == null
+            ? ''
+            : typeof payload === 'object'
+                ? JSON.stringify(payload)
+                : String(payload);
+        return [{ type: 'text', data: { text } }];
+    }
+    const segs = [];
+    for (const item of items) {
+        if (typeof item === 'string') {
+            segs.push({ type: 'text', data: { text: item } });
+            continue;
+        }
+        segs.push({ type: item.type, data: item.data ?? {} });
+    }
+    return segs.length ? segs : [{ type: 'text', data: { text: '' } }];
+}
+export function segmentLocalPath(seg) {
+    const data = seg.data ?? {};
+    const candidates = [data.file, data.path, data.url].filter((value) => typeof value === 'string' && Boolean(value));
+    const ref = candidates[0];
+    if (!ref || ref.startsWith('base64://') || /^data:/.test(ref) || /^https?:\/\//i.test(ref)) {
+        return undefined;
+    }
+    return ref.replace(/^file:\/\//, '');
+}
+export function sleep(ms, signal) {
+    return new Promise((resolve) => {
+        if (signal?.aborted) {
+            resolve();
+            return;
+        }
+        const timer = setTimeout(resolve, ms);
+        signal?.addEventListener('abort', () => {
+            clearTimeout(timer);
+            resolve();
+        }, { once: true });
+    });
+}

package/lib/silk-transcode.d.ts

@@ -6,4 +6,3 @@
  * Callers should fall back to passing the raw SILK file when null is returned.
  */
 export declare function silkToWav(silkBuf: Buffer): Promise<Buffer | null>;
-//# sourceMappingURL=silk-transcode.d.ts.map

package/lib/silk-transcode.js

@@ -61,4 +61,3 @@ export async function silkToWav(silkBuf) {
         return null;
     }
 }
-//# sourceMappingURL=silk-transcode.js.map

package/lib/types.d.ts

@@ -1,16 +1,2 @@
-export interface WeixinIlinkEndpointConfig {
-    context: "weixin-ilink";
-    name: string;
-    /** 观测用 bot_agent，默认 Zhin.js/<version> */
-    botAgent?: string;
-    /** iLink API 根地址，默认 https://ilinkai.weixin.qq.com */
-    baseUrl?: string;
-    /** CDN 根地址 */
-    cdnBaseUrl?: string;
-    /** 长轮询超时（ms），默认 35000 */
-    longPollTimeoutMs?: number;
-    /** 直接配置 token（优先于侧车凭证文件） */
-    botToken?: string;
-}
-export type { WeixinMessage, MessageItem } from "./ilink-types.js";
-//# sourceMappingURL=types.d.ts.map
+export type { WeixinIlinkEndpointConfig, WeixinIlinkAdapterConfig, ResolvedWeixinIlinkConfig, } from './protocol.js';
+export type { WeixinMessage, MessageItem } from './ilink-types.js';

package/lib/types.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=types.js.map

package/lib/upload.d.ts

@@ -1,4 +1,4 @@
-import type { WeixinApiOptions } from "./ilink-api.js";
+import { type WeixinApiOptions } from './ilink-api.js';
 export type UploadedFileInfo = {
     filekey: string;
     /** 由 upload_param 上传后 CDN 返回的下载加密参数; fill into ImageItem.media.encrypt_query_param */
@@ -40,4 +40,3 @@ export declare function uploadFileAttachmentToWeixin(params: {
     opts: WeixinApiOptions;
     cdnBaseUrl: string;
 }): Promise<UploadedFileInfo>;
-//# sourceMappingURL=upload.d.ts.map

package/lib/upload.js

@@ -1,7 +1,7 @@
 import crypto from "node:crypto";
 import fs from "node:fs/promises";
 import path from "node:path";
-import { getUploadUrl } from "./ilink-api.js";
+import { getUploadUrl } from './ilink-api.js';
 import { aesEcbPaddedSize } from "./aes-ecb.js";
 import { uploadBufferToCdn } from "./cdn-upload.js";
 import { logger } from "./ilink-logger.js";
@@ -103,4 +103,3 @@ export async function uploadFileAttachmentToWeixin(params) {
         label: "uploadFileAttachmentToWeixin",
     });
 }
-//# sourceMappingURL=upload.js.map

package/lib/weixin-inbound.d.ts

@@ -1,4 +1,4 @@
-import type { WeixinMessage, MessageItem } from "./ilink-types.js";
+import { type WeixinMessage, type MessageItem } from './ilink-types.js';
 /**
  * Restore persisted context tokens for an account into the in-memory map.
  * Called once during gateway startAccount to survive restarts.
@@ -68,4 +68,3 @@ export type WeixinInboundMediaOpts = {
 export declare function weixinMessageToMsgContext(msg: WeixinMessage, accountId: string, opts?: WeixinInboundMediaOpts): WeixinMsgContext;
 /** Extract the context_token from an inbound WeixinMsgContext. */
 export declare function getContextTokenFromMsgContext(ctx: WeixinMsgContext): string | undefined;
-//# sourceMappingURL=weixin-inbound.d.ts.map

package/lib/weixin-inbound.js

@@ -2,7 +2,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { logger } from "./ilink-logger.js";
 import { generateId } from "./ilink-random.js";
-import { MessageItemType } from "./ilink-types.js";
+import { MessageItemType } from './ilink-types.js';
 import { resolveStateDir } from "./credentials.js";
 // ---------------------------------------------------------------------------
 // Context token store (in-process cache + disk persistence)
@@ -198,4 +198,3 @@ export function weixinMessageToMsgContext(msg, accountId, opts) {
 export function getContextTokenFromMsgContext(ctx) {
     return ctx.context_token;
 }
-//# sourceMappingURL=weixin-inbound.js.map

package/lib/weixin-send-media.d.ts

@@ -19,4 +19,3 @@ export declare function sendWeixinMediaFile(params: {
 }): Promise<{
     messageId: string;
 }>;
-//# sourceMappingURL=weixin-send-media.d.ts.map

package/lib/weixin-send-media.js

@@ -51,4 +51,3 @@ export async function sendWeixinMediaFile(params) {
     logger.info(`[weixin] sendWeixinMediaFile: file upload done filekey=${uploaded.filekey} size=${uploaded.fileSize}`);
     return sendFileMessageWeixin({ to, text, fileName, uploaded, opts });
 }
-//# sourceMappingURL=weixin-send-media.js.map

package/lib/weixin-send.d.ts

@@ -1,4 +1,4 @@
-import type { WeixinApiOptions } from "./ilink-api.js";
+import { type WeixinApiOptions } from './ilink-api.js';
 import type { UploadedFileInfo } from "./upload.js";
 /**
  * Send a plain text message downstream.
@@ -62,4 +62,3 @@ export declare function sendFileMessageWeixin(params: {
 }): Promise<{
     messageId: string;
 }>;
-//# sourceMappingURL=weixin-send.d.ts.map

package/lib/weixin-send.js

@@ -1,7 +1,7 @@
-import { sendMessage as sendMessageApi } from "./ilink-api.js";
+import { sendMessage as sendMessageApi } from './ilink-api.js';
 import { logger } from "./ilink-logger.js";
 import { generateId } from "./ilink-random.js";
-import { MessageItemType, MessageState, MessageType } from "./ilink-types.js";
+import { MessageItemType, MessageState, MessageType } from './ilink-types.js';
 function generateClientId() {
     return generateId("weixin-ilink");
 }
@@ -178,4 +178,3 @@ export async function sendFileMessageWeixin(params) {
     };
     return sendMediaItems({ to, text, mediaItem: fileItem, opts, label: "sendFileMessageWeixin" });
 }
-//# sourceMappingURL=weixin-send.js.map

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@zhin.js/adapter-weixin-ilink",
-  "version": "3.0.1",
+  "version": "3.0.3",
   "type": "module",
-  "description": "Zhin.js adapter for WeChat personal account via Tencent iLink Endpoint API (ClawBot)",
+  "description": "Zhin.js Weixin iLink (ClawBot) adapter for Plugin Runtime (long-poll)",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
   "keywords": [
@@ -27,11 +27,11 @@
     "directory": "plugins/adapters/weixin-ilink"
   },
   "files": [
+    "adapters",
+    "plugin.ts",
+    "schema.json",
     "src",
     "lib",
-    "client",
-    "dist",
-    "skills",
     "README.md",
     "CHANGELOG.md"
   ],
@@ -46,53 +46,49 @@
       "import": "./lib/index.js"
     }
   },
-  "dependencies": {},
-  "devDependencies": {
-    "@radix-ui/themes": "^3.2.1",
-    "@types/react": "^19.2.17",
-    "@types/react-dom": "^19.2.3",
-    "lucide-react": "^1.22.0",
-    "radix-ui": "^1.6.2",
-    "typescript": "^6.0.3",
-    "@zhin.js/agent": "1.0.2",
-    "@zhin.js/cli": "1.0.92",
-    "@zhin.js/client": "2.0.4",
-    "@zhin.js/contract": "1.0.2",
-    "@zhin.js/core": "1.3.3",
-    "@zhin.js/host-api": "2.0.4",
-    "zhin.js": "4.1.1",
-    "@zhin.js/host-router": "2.0.2"
+  "dependencies": {
+    "@zhin.js/adapter": "1.0.1",
+    "@zhin.js/core": "1.3.5",
+    "@zhin.js/logger": "1.0.75",
+    "@zhin.js/plugin-runtime": "1.0.1"
   },
   "peerDependencies": {
-    "@zhin.js/client": "2.0.4",
-    "@zhin.js/agent": "1.0.2",
-    "@zhin.js/core": "1.3.3",
-    "@zhin.js/contract": "1.0.2",
-    "@zhin.js/host-api": "2.0.4",
-    "zhin.js": "4.1.1",
-    "@zhin.js/host-router": "2.0.2"
+    "@zhin.js/adapter": "1.0.1",
+    "@zhin.js/core": "1.3.5",
+    "@zhin.js/plugin-runtime": "1.0.1",
+    "zhin.js": "4.1.3"
   },
   "peerDependenciesMeta": {
-    "@zhin.js/agent": {
-      "optional": true
-    },
-    "@zhin.js/client": {
-      "optional": true
-    },
-    "@zhin.js/host-api": {
-      "optional": true
-    },
-    "@zhin.js/host-router": {
+    "zhin.js": {
       "optional": true
     }
   },
+  "devDependencies": {
+    "@types/node": "^26.1.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.10"
+  },
   "ilink_appid": "bot",
   "engines": {
     "node": "^20.19.0 || >=22.12.0"
   },
+  "zhin": {
+    "protocol": 1,
+    "type": "plugin",
+    "entry": "./plugin.ts",
+    "engine": "^1.0.0",
+    "runtime": "trusted",
+    "features": [
+      {
+        "package": "@zhin.js/adapter",
+        "api": "^1.0.0"
+      }
+    ],
+    "plugins": []
+  },
   "scripts": {
-    "build": "zhin build",
-    "build:node": "tsc",
-    "clean": "rimraf lib dist"
+    "build": "tsc",
+    "clean": "rimraf lib",
+    "test": "NODE_OPTIONS=--experimental-strip-types vitest run --root ../../.. plugins/adapters/weixin-ilink/tests"
   }
 }

package/plugin.ts

@@ -0,0 +1,8 @@
+import { definePlugin } from '@zhin.js/plugin-runtime';
+
+export default definePlugin({
+  name: 'weixin-ilink',
+  metadata: {
+    displayName: 'Weixin iLink Adapter',
+  },
+});

package/schema.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "name": {
+      "type": "string",
+      "default": "weixin-ilink-bot"
+    },
+    "botAgent": {
+      "type": "string"
+    },
+    "baseUrl": {
+      "type": "string",
+      "default": "https://ilinkai.weixin.qq.com"
+    },
+    "cdnBaseUrl": {
+      "type": "string",
+      "default": "https://novac2c.cdn.weixin.qq.com/c2c"
+    },
+    "longPollTimeoutMs": {
+      "type": "number",
+      "default": 35000
+    },
+    "botToken": {
+      "type": "string",
+      "description": "iLink bot token (prefer env WEIXIN_ILINK_TOKEN or sidecar credential file)"
+    }
+  }
+}