@zhin.js/adapter-wecom 1.1.20 → 1.1.21

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # @zhin.js/adapter-wecom
 
+## 1.1.21
+
+### Patch Changes
+
+- af8f803: Use the current Endpoint's platform profile for Agent account identity, with per-field configured fallbacks and scoped, identity-approved profile tools. Keep SOUL first-person and independent of account names. Profile ports preserve the source Client, cancellation, truthful update outcomes and private image authority.
+
+  Adapter Feature API 2.1 and Tool Feature API 1.1 describe the additive profile requirements; new Core, official adapters and generated plugins declare the corresponding floors. Existing compatible API-2.0/API-1.0 plugins remain accepted by the newer providers. npm releases remain patch.
+
+  Private IM assets now bind to the full canonical conversation and principal. Existing IM asset records that contain only the earlier lossy hash remain on disk until their original expiry, but cannot be safely rebound; recapture them. No automatic file deletion, platform profile mutation or workspace SOUL rewrite occurs during upgrade.
+
+- Updated dependencies [b88e988]
+- Updated dependencies [f78eb84]
+- Updated dependencies [c15cef9]
+- Updated dependencies [b0c02a2]
+- Updated dependencies [af8f803]
+- Updated dependencies [26fda97]
+- Updated dependencies [976886c]
+- Updated dependencies [032dc96]
+  - @zhin.js/adapter@1.1.27
+  - @zhin.js/client@1.1.23
+  - @zhin.js/im-contract@1.1.10
+  - @zhin.js/core@1.1.55
+  - @zhin.js/tool@1.1.14
+  - @zhin.js/page@1.1.13
+  - @zhin.js/host-http@1.1.13
+  - @zhin.js/agent-feature@1.1.12
+  - @zhin.js/feature-kit@1.1.11
+  - @zhin.js/skill@1.1.12
+
 ## 1.1.20
 
 ### Patch Changes

package/agents/wecom/skills/wecom/SKILL.md

@@ -26,8 +26,6 @@ tools:
 
 # 企业微信技能
 
-企业微信（WeCom）是腾讯面向企业的 IM 平台，具备组织架构（部门树）、应用消息推送等能力。
-
 ## 核心原则
 
 ### 组织架构是核心
@@ -44,25 +42,9 @@ wecom_get_user(user_id) → 获取用户详情
 `wecom_send_text` 通过应用消息接口发送文本消息，需要知道接收者的 `userid`。
 群消息通过 webhook 回调自动处理，不需要主动调用发送工具。
 
-## 工具分类
-
-### 组织架构
-
-| 工具 | 用途 | 说明 |
-|------|------|------|
-| `wecom_list_departments` | 部门列表 | 默认从根部门 ID=1 开始 |
-| `wecom_get_dept_users` | 部门用户列表 | 返回简单用户信息 |
-| `wecom_get_user` | 用户详情 | 需要通讯录权限 |
-
-### 消息
-
-| 工具 | 用途 | 说明 |
-|------|------|------|
-| `wecom_send_text` | 发送文本消息 | 发给指定用户，通过应用消息接口 |
-
 ## 易错点
 
 1. **部门查询从根部门 ID=1 开始**。不知道部门 ID 时先 `list_departments` 获取整棵部门树。
 2. **消息发送需要 userid**，不是用户名或昵称。仅有昵称时先通过 `get_dept_users` 查找。
-3. **企业微信不支持机器人撤回消息**，一旦发出无法撤回。
-4. **Access Token 有效期 7200 秒**，适配器会自动刷新。
+3. **用户详情查询需要通讯录权限**。
+4. **企业微信不支持机器人撤回消息**，一旦发出无法撤回。

package/lib/client.d.ts

@@ -59,7 +59,7 @@ export declare class WecomClient extends EventEmitter {
     recallMessage(messageId: string, { signal }?: EndpointOperationOptions): Promise<void>;
     /** Test / internal: admit a parsed message when open (non-webhook path). */
     admit(msg: WecomMessage): void;
-    getApplicationInfo(): Promise<WecomApiResponse>;
+    getApplicationInfo(request?: EndpointOperationOptions): Promise<WecomApiResponse>;
     getUserInfo(userId: string): Promise<WecomApiResponse | null>;
     getDepartmentUsers(deptId: number): Promise<unknown[]>;
     getDepartmentList(deptId?: number): Promise<unknown[]>;

package/lib/client.js

@@ -223,8 +223,8 @@ export class WecomClient extends EventEmitter {
             }));
         });
     }
-    async getApplicationInfo() {
-        const response = await this.#request('/cgi-bin/agent/get', { params: { agentid: this.config.agentId } });
+    async getApplicationInfo(request = {}) {
+        const response = await this.#request('/cgi-bin/agent/get', { params: { agentid: this.config.agentId }, signal: request.signal });
         if (response.errcode !== 0)
             throw new Error('WeCom application identity verification failed');
         return response;

package/lib/endpoint.js

@@ -1,5 +1,6 @@
 import { createEndpointSpecification, endpointSpec } from 'zhin.js/adapter';
 import { WecomClient } from './client.js';
+import { createWecomSelfProfile } from './self-profile.js';
 /** Actual protocol Client; framework lifecycle and admission stay in their symbol namespace. */
 export class WecomEndpoint extends WecomClient {
     [endpointSpec] = this.#createSpecification();
@@ -11,6 +12,7 @@ export class WecomEndpoint extends WecomClient {
             send: (request) => this.sendPayload(request),
             name: this.configName(),
             control: this.endpointControl,
+            profile: createWecomSelfProfile(this),
         };
         Object.defineProperty(hooks, 'transportState', { get: () => this.transportState });
         return createEndpointSpecification(this, hooks);

package/lib/protocol.d.ts

@@ -1,8 +1,9 @@
+import type { EndpointProfileConfiguration } from 'zhin.js/adapter';
 import { type Locale } from 'zhin.js/i18n';
 import type { IncomingMessage } from 'node:http';
 import type { ConversationRef } from '@zhin.js/im-contract';
 /** One endpoint config after AdapterIndex expands `plugins.<instanceKey>.endpoints`. */
-export interface WecomEndpointConfig {
+export interface WecomEndpointConfig extends EndpointProfileConfiguration {
     readonly id: string;
     readonly corpId: string;
     readonly agentId: string;

package/lib/self-profile.d.ts

@@ -0,0 +1,4 @@
+import { type EndpointProfile } from 'zhin.js/adapter';
+import type { WecomClient } from './client.js';
+/** Enterprise application profile; no member/user profile is impersonated. */
+export declare function createWecomSelfProfile(client: Pick<WecomClient, 'getApplicationInfo'>): EndpointProfile;

package/lib/self-profile.js

@@ -0,0 +1,13 @@
+import { createEndpointOperation } from 'zhin.js/adapter';
+/** Enterprise application profile; no member/user profile is impersonated. */
+export function createWecomSelfProfile(client) {
+    return Object.freeze({
+        writableFields: Object.freeze([]),
+        async read({ signal }) {
+            const self = await createEndpointOperation({ signal }).prepare(() => client.getApplicationInfo({ signal }));
+            return { ...(typeof self.name === 'string' ? { nickname: self.name } : {}),
+                ...(typeof self.description === 'string' ? { bio: self.description } : {}),
+                ...(typeof self.square_logo_url === 'string' ? { avatar: self.square_logo_url } : {}) };
+        },
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-wecom",
-  "version": "1.1.20",
+  "version": "1.1.21",
   "description": "Zhin.js WeCom (企业微信) adapter for Plugin Runtime (HTTP webhook)",
   "type": "module",
   "main": "./lib/index.js",
@@ -33,27 +33,27 @@
     "directory": "plugins/adapters/wecom"
   },
   "dependencies": {
-    "@zhin.js/adapter": "1.1.26",
-    "@zhin.js/agent-feature": "1.1.11",
+    "@zhin.js/adapter": "1.1.27",
+    "@zhin.js/agent-feature": "1.1.12",
+    "@zhin.js/client": "1.1.23",
     "@zhin.js/console-contract": "1.1.3",
-    "@zhin.js/client": "1.1.22",
-    "@zhin.js/core": "1.1.54",
-    "@zhin.js/im-contract": "1.1.9",
+    "@zhin.js/core": "1.1.55",
+    "@zhin.js/feature-kit": "1.1.11",
+    "@zhin.js/host-http": "1.1.13",
+    "@zhin.js/im-contract": "1.1.10",
     "@zhin.js/logger": "1.1.2",
-    "@zhin.js/page": "1.1.12",
-    "@zhin.js/skill": "1.1.11",
-    "@zhin.js/tool": "1.1.13",
-    "@zhin.js/host-http": "1.1.12",
-    "@zhin.js/feature-kit": "1.1.10"
+    "@zhin.js/page": "1.1.13",
+    "@zhin.js/skill": "1.1.12",
+    "@zhin.js/tool": "1.1.14"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/adapter": "^1.1.26",
-    "@zhin.js/command": "^1.1.12",
-    "@zhin.js/core": "^1.1.54",
-    "@zhin.js/permission": "^1.1.10",
-    "zhin.js": "^1.1.19",
-    "@zhin.js/host-http": "^1.1.12"
+    "@zhin.js/adapter": "^1.1.27",
+    "@zhin.js/command": "^1.1.13",
+    "@zhin.js/core": "^1.1.55",
+    "@zhin.js/host-http": "^1.1.13",
+    "@zhin.js/permission": "^1.1.11",
+    "zhin.js": "^1.1.20"
   },
   "peerDependenciesMeta": {
     "@zhin.js/command": {
@@ -71,7 +71,7 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "zhin.js": "1.1.19"
+    "zhin.js": "1.1.20"
   },
   "files": [
     "adapters",
@@ -103,7 +103,7 @@
     "features": [
       {
         "package": "@zhin.js/adapter",
-        "api": "^2.0.0"
+        "api": "^2.1.0"
       },
       {
         "package": "@zhin.js/command",
@@ -111,7 +111,7 @@
       },
       {
         "package": "@zhin.js/tool",
-        "api": "^1.0.0"
+        "api": "^1.1.0"
       },
       {
         "package": "@zhin.js/skill",

package/schema.json

@@ -113,6 +113,27 @@
                 "description": "WeCom application AgentId (not the application secret)"
               }
             }
+          },
+          "nickname": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "账号昵称兜底",
+            "x-i18n": {
+              "en": {
+                "description": "Fallback account nickname"
+              }
+            }
+          },
+          "profile": {
+            "$ref": "#/$defs/selfProfileFallback",
+            "description": "账号资料兜底",
+            "x-i18n": {
+              "en": {
+                "description": "Fallback account profile"
+              }
+            }
           }
         },
         "required": [
@@ -139,9 +160,93 @@
           "description": "Command prefix. The default empty string allows unprefixed commands; '/' requires a leading slash. Each endpoints[i] can override it."
         }
       }
+    },
+    "nickname": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "description": "账号昵称兜底",
+      "x-i18n": {
+        "en": {
+          "description": "Fallback account nickname"
+        }
+      }
+    },
+    "profile": {
+      "$ref": "#/$defs/selfProfileFallback",
+      "description": "账号资料兜底",
+      "x-i18n": {
+        "en": {
+          "description": "Fallback account profile"
+        }
+      }
     }
   },
   "required": [
     "endpoints"
-  ]
+  ],
+  "$defs": {
+    "selfProfileFallback": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "gender": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "enum": [
+            "male",
+            "female",
+            "other",
+            "unknown",
+            null
+          ]
+        },
+        "age": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": 0
+        },
+        "birthday": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "pattern": "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$"
+        },
+        "signature": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "avatar": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "pattern": "^(https?://[^\\s/?#]+(?:[/?#].*)?|)$"
+        },
+        "interests": {
+          "type": [
+            "array",
+            "null"
+          ],
+          "items": {
+            "type": "string"
+          }
+        },
+        "bio": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      }
+    }
+  }
 }

package/src/client.ts

@@ -282,8 +282,8 @@ export class WecomClient extends EventEmitter {
     });
   }
 
-  async getApplicationInfo(): Promise<WecomApiResponse> {
-    const response = await this.#request('/cgi-bin/agent/get', { params: { agentid: this.config.agentId } });
+  async getApplicationInfo(request: EndpointOperationOptions = {}): Promise<WecomApiResponse> {
+    const response = await this.#request('/cgi-bin/agent/get', { params: { agentid: this.config.agentId }, signal: request.signal });
     if (response.errcode !== 0) throw new Error('WeCom application identity verification failed');
     return response;
   }

package/src/endpoint.ts

@@ -1,5 +1,6 @@
 import { createEndpointSpecification, endpointSpec, type Endpoint } from 'zhin.js/adapter';
 import { WecomClient, type WecomEndpointOptions } from './client.js';
+import { createWecomSelfProfile } from './self-profile.js';
 export type { WecomEndpointOptions } from './client.js';
 export type { WecomFetch } from './client.js';
 
@@ -14,6 +15,7 @@ export class WecomEndpoint extends WecomClient implements Endpoint {
       send: (request: import('zhin.js/adapter').EndpointSendRequest) => this.sendPayload(request),
       name: this.configName(),
       control: this.endpointControl,
+      profile: createWecomSelfProfile(this),
     };
     Object.defineProperty(hooks, 'transportState', { get: () => this.transportState });
     return createEndpointSpecification(this, hooks);

package/src/protocol.ts

@@ -1,3 +1,4 @@
+import type { EndpointProfileConfiguration } from 'zhin.js/adapter';
 import { createMessages, type Locale } from 'zhin.js/i18n';
 /**
  * WeCom (企业微信) protocol helpers — no legacy Adapter/Endpoint / segment-mapper.
@@ -9,7 +10,7 @@ import type { IncomingMessage } from 'node:http';
 import type { ConversationRef } from '@zhin.js/im-contract';
 
 /** One endpoint config after AdapterIndex expands `plugins.<instanceKey>.endpoints`. */
-export interface WecomEndpointConfig {
+export interface WecomEndpointConfig extends EndpointProfileConfiguration {
   readonly id: string;
   readonly corpId: string;
   readonly agentId: string;

package/src/self-profile.ts

@@ -0,0 +1,15 @@
+import { createEndpointOperation, type EndpointProfile } from 'zhin.js/adapter';
+import type { WecomClient } from './client.js';
+
+/** Enterprise application profile; no member/user profile is impersonated. */
+export function createWecomSelfProfile(client: Pick<WecomClient, 'getApplicationInfo'>): EndpointProfile {
+  return Object.freeze<EndpointProfile>({
+    writableFields: Object.freeze([]),
+    async read({ signal }) {
+      const self = await createEndpointOperation({ signal }).prepare(() => client.getApplicationInfo({ signal }));
+      return { ...(typeof self.name === 'string' ? { nickname: self.name } : {}),
+        ...(typeof self.description === 'string' ? { bio: self.description } : {}),
+        ...(typeof self.square_logo_url === 'string' ? { avatar: self.square_logo_url } : {}) };
+    },
+  });
+}