@zhin.js/adapter-icqq 1.1.2 → 1.1.4

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # @zhin.js/adapter-icqq
 
+## 1.1.4
+
+### Patch Changes
+
+- 43eda99: Unify Notice and Request payloads with their public types and runtime exports. Use camelCase fields, preserve native data under metadata, and bind canonical endpoint identity and request actions to the held generation. Remove legacy data aliases and from factories.
+
+  Keep login and lifecycle signals as independent SystemEvent payloads on system.receive, without chat conversation fields or user interaction. Update built-in adapter projections and authoring guidance.
+
+- Updated dependencies [43eda99]
+- Updated dependencies [0de4836]
+  - @zhin.js/core@1.1.39
+  - @zhin.js/permission@1.1.3
+  - @zhin.js/adapter@1.1.15
+
+## 1.1.3
+
+### Patch Changes
+
+- 5b5d270: Complete the canonical share segment contract and preserve native ICQQ share delivery through Core and AI outbound pipelines.
+- Updated dependencies [5b5d270]
+- Updated dependencies [36c2eb9]
+  - @zhin.js/im-contract@1.1.2
+  - @zhin.js/core@1.1.38
+  - @zhin.js/adapter@1.1.15
+  - @zhin.js/agent-feature@1.1.2
+  - @zhin.js/feature-kit@1.1.2
+  - @zhin.js/permission@1.1.2
+  - @zhin.js/skill@1.1.2
+  - @zhin.js/tool@1.1.2
+
 ## 1.1.2
 
 ### Patch Changes

package/lib/endpoint.js

@@ -2,7 +2,7 @@ import { Client, parseGroupMessageId, } from '@icqqjs/icqq';
 import { inspect } from 'node:util';
 import { AsyncLocalStorage } from 'node:async_hooks';
 import { Endpoint, } from 'zhin.js/adapter';
-import { receiveOneBotLikeSideEvent, SystemEvent, toCanonicalSegments } from '@zhin.js/core';
+import { receiveOneBotLikeSideEvent, buildSystem, toCanonicalSegments } from '@zhin.js/core';
 import { formatCompact, getAdapterLogger, truncatePreview } from '@zhin.js/logger';
 import { runIcqqLoginAssistStep } from './icqq-login-assist.js';
 import { IcqqContentResolver } from './content-resolver.js';
@@ -578,16 +578,13 @@ export class IcqqEndpoint extends Endpoint {
         });
     }
     #dispatchIcqqSystemSideEvent(type, payload) {
-        const { scene_type, sub_type } = parseIcqqSystemScene(type);
-        void this.emit('system.receive', SystemEvent.from(payload ?? {}, {
-            $id: `system:${this.endpointName}:${type}:${Date.now()}`,
-            $adapter: 'icqq',
-            $endpoint: this.endpointName,
-            $type: 'system',
-            $scene_id: this.endpointName,
-            $scene_type: scene_type,
-            $sub_type: sub_type,
-            $timestamp: Date.now(),
+        void this.emit('system.receive', buildSystem(payload ?? {}, {
+            id: `system:${this.endpointName}:${type}:${Date.now()}`,
+            clientAdapter: 'icqq',
+            endpointId: this.endpointName,
+            type: 'system',
+            name: `system.${type}`,
+            timestamp: Date.now(),
         })).catch((err) => {
             this.#logger.warn(formatCompact({
                 op: 'icqq_system_side_event_failed',
@@ -984,20 +981,5 @@ function serializeIcqqEvent(event) {
     }
     return Object.keys(out).length > 0 ? out : null;
 }
-function parseIcqqSystemScene(type) {
-    if (type.startsWith('login.')) {
-        return { scene_type: 'login', sub_type: type.slice('login.'.length) || 'unknown' };
-    }
-    if (type.startsWith('offline.')) {
-        return { scene_type: 'offline', sub_type: type.slice('offline.'.length) || 'unknown' };
-    }
-    if (type === 'online') {
-        return { scene_type: 'online', sub_type: 'online' };
-    }
-    if (type === 'offline') {
-        return { scene_type: 'offline', sub_type: 'offline' };
-    }
-    return { scene_type: 'system', sub_type: type };
-}
 const INBOUND_HOLD_LIMIT = 32;
 const ICQQ_SERIALIZE_SKIP = ['group', 'member', 'friend', 'discuss', 'client'];

package/lib/icqq-inbound.js

@@ -360,6 +360,46 @@ export function icqqElementsToSegments(elements) {
                 });
                 break;
             }
+            case "share": {
+                const url = typeof el.url === "string" ? el.url.trim() : "";
+                const title = typeof el.title === "string" ? el.title.trim() : "";
+                if (!url || !title)
+                    break;
+                const description = typeof el.summary === "string" && el.summary
+                    ? el.summary
+                    : undefined;
+                const image = typeof el.image === "string" && el.image ? el.image : undefined;
+                const audio = typeof el.audio === "string" && el.audio ? el.audio : undefined;
+                const content = typeof el.content === "string" && el.content ? el.content : undefined;
+                const rawConfig = el.config && typeof el.config === "object" && !Array.isArray(el.config)
+                    ? el.config
+                    : undefined;
+                const appid = Number(rawConfig?.appid);
+                const config = Number.isSafeInteger(appid) && appid > 0
+                    ? {
+                        appid,
+                        ...(typeof rawConfig?.appname === "string" && rawConfig.appname
+                            ? { package: rawConfig.appname }
+                            : {}),
+                        ...(typeof rawConfig?.appsign === "string" && rawConfig.appsign
+                            ? { sign: rawConfig.appsign }
+                            : {}),
+                    }
+                    : undefined;
+                out.push({
+                    type: "share",
+                    data: {
+                        url,
+                        title,
+                        ...(description ? { description } : {}),
+                        ...(image ? { image } : {}),
+                        ...(audio ? { audio } : {}),
+                        ...(content ? { content } : {}),
+                        ...(config ? { config } : {}),
+                    },
+                });
+                break;
+            }
             default:
                 if (el.text != null && el.text !== "") {
                     out.push({ type: "text", data: { text: String(el.text) } });

package/lib/protocol.js

@@ -405,7 +405,7 @@ function formatShare(data) {
             ...(appsign ? { appsign } : {}),
         }
         : undefined;
-    const summary = optionalString(data.artist);
+    const summary = optionalString(data.description) ?? optionalString(data.artist);
     const content = optionalString(data.content);
     const image = optionalString(data.image);
     const audio = optionalString(data.audio);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-icqq",
-  "version": "1.1.2",
+  "version": "1.1.4",
   "description": "Zhin.js ICQQ adapter — direct connection to @icqqjs/icqq",
   "type": "module",
   "main": "./lib/index.js",
@@ -34,24 +34,24 @@
     "directory": "plugins/adapters/icqq"
   },
   "dependencies": {
-    "@zhin.js/adapter": "1.1.14",
-    "@zhin.js/agent-feature": "1.1.1",
-    "@zhin.js/core": "1.1.37",
-    "@zhin.js/feature-kit": "1.1.1",
-    "@zhin.js/im-contract": "1.1.1",
+    "@zhin.js/adapter": "1.1.15",
+    "@zhin.js/agent-feature": "1.1.2",
+    "@zhin.js/core": "1.1.39",
+    "@zhin.js/feature-kit": "1.1.2",
+    "@zhin.js/im-contract": "1.1.2",
     "@zhin.js/logger": "1.1.1",
-    "@zhin.js/permission": "1.1.1",
-    "@zhin.js/skill": "1.1.1",
-    "@zhin.js/tool": "1.1.1"
+    "@zhin.js/permission": "1.1.3",
+    "@zhin.js/skill": "1.1.2",
+    "@zhin.js/tool": "1.1.2"
   },
   "peerDependencies": {
     "@icqqjs/icqq": "^1.12.2",
     "zod": "^4.0.0",
-    "@zhin.js/adapter": "^1.1.14",
-    "@zhin.js/command": "^1.1.1",
-    "@zhin.js/core": "^1.1.37",
-    "@zhin.js/prompt-section": "^1.1.1",
-    "zhin.js": "^1.1.2"
+    "@zhin.js/adapter": "^1.1.15",
+    "@zhin.js/command": "^1.1.3",
+    "@zhin.js/core": "^1.1.39",
+    "@zhin.js/prompt-section": "^1.1.2",
+    "zhin.js": "^1.1.4"
   },
   "peerDependenciesMeta": {
     "@icqqjs/icqq": {
@@ -76,8 +76,8 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "@zhin.js/prompt-section": "1.1.1",
-    "zhin.js": "1.1.2"
+    "@zhin.js/prompt-section": "1.1.2",
+    "zhin.js": "1.1.4"
   },
   "files": [
     "adapters",

package/src/endpoint.ts

@@ -18,7 +18,7 @@ import {
   type EndpointSendRequest,
 } from 'zhin.js/adapter';
 import type { EndpointContentPort } from '@zhin.js/adapter';
-import { receiveOneBotLikeSideEvent, SystemEvent, toCanonicalSegments, type LoginAssist } from '@zhin.js/core';
+import { receiveOneBotLikeSideEvent, buildSystem, toCanonicalSegments, type LoginAssist } from '@zhin.js/core';
 import type { MessageRef } from '@zhin.js/im-contract';
 import { formatCompact, getAdapterLogger, truncatePreview } from '@zhin.js/logger';
 import type { CapabilityId } from 'zhin.js';
@@ -659,16 +659,13 @@ export class IcqqEndpoint extends Endpoint<Client> {
   }
 
   #dispatchIcqqSystemSideEvent(type: string, payload: Record<string, unknown> | null): void {
-    const { scene_type, sub_type } = parseIcqqSystemScene(type);
-    void this.emit('system.receive', SystemEvent.from(payload ?? {}, {
-      $id: `system:${this.endpointName}:${type}:${Date.now()}`,
-      $adapter: 'icqq' as never,
-      $endpoint: this.endpointName,
-      $type: 'system',
-      $scene_id: this.endpointName,
-      $scene_type: scene_type,
-      $sub_type: sub_type,
-      $timestamp: Date.now(),
+    void this.emit('system.receive', buildSystem(payload ?? {}, {
+      id: `system:${this.endpointName}:${type}:${Date.now()}`,
+      clientAdapter: 'icqq',
+      endpointId: this.endpointName,
+      type: 'system',
+      name: `system.${type}`,
+      timestamp: Date.now(),
     })).catch((err) => {
       this.#logger.warn(formatCompact({
         op: 'icqq_system_side_event_failed',
@@ -1063,22 +1060,6 @@ function serializeIcqqEvent(event: unknown): Record<string, unknown> | null {
   return Object.keys(out).length > 0 ? out : null;
 }
 
-function parseIcqqSystemScene(type: string): { scene_type: string; sub_type: string } {
-  if (type.startsWith('login.')) {
-    return { scene_type: 'login', sub_type: type.slice('login.'.length) || 'unknown' };
-  }
-  if (type.startsWith('offline.')) {
-    return { scene_type: 'offline', sub_type: type.slice('offline.'.length) || 'unknown' };
-  }
-  if (type === 'online') {
-    return { scene_type: 'online', sub_type: 'online' };
-  }
-  if (type === 'offline') {
-    return { scene_type: 'offline', sub_type: 'offline' };
-  }
-  return { scene_type: 'system', sub_type: type };
-}
-
 const INBOUND_HOLD_LIMIT = 32;
 
 const ICQQ_SERIALIZE_SKIP = ['group', 'member', 'friend', 'discuss', 'client'] as const;

package/src/icqq-inbound.ts

@@ -500,6 +500,45 @@ export function icqqElementsToSegments(
         });
         break;
       }
+      case "share": {
+        const url = typeof el.url === "string" ? el.url.trim() : "";
+        const title = typeof el.title === "string" ? el.title.trim() : "";
+        if (!url || !title) break;
+        const description = typeof el.summary === "string" && el.summary
+          ? el.summary
+          : undefined;
+        const image = typeof el.image === "string" && el.image ? el.image : undefined;
+        const audio = typeof el.audio === "string" && el.audio ? el.audio : undefined;
+        const content = typeof el.content === "string" && el.content ? el.content : undefined;
+        const rawConfig = el.config && typeof el.config === "object" && !Array.isArray(el.config)
+          ? el.config as Record<string, unknown>
+          : undefined;
+        const appid = Number(rawConfig?.appid);
+        const config = Number.isSafeInteger(appid) && appid > 0
+          ? {
+              appid,
+              ...(typeof rawConfig?.appname === "string" && rawConfig.appname
+                ? { package: rawConfig.appname }
+                : {}),
+              ...(typeof rawConfig?.appsign === "string" && rawConfig.appsign
+                ? { sign: rawConfig.appsign }
+                : {}),
+            }
+          : undefined;
+        out.push({
+          type: "share",
+          data: {
+            url,
+            title,
+            ...(description ? { description } : {}),
+            ...(image ? { image } : {}),
+            ...(audio ? { audio } : {}),
+            ...(content ? { content } : {}),
+            ...(config ? { config } : {}),
+          },
+        });
+        break;
+      }
       default:
         if (el.text != null && el.text !== "") {
           out.push({ type: "text", data: { text: String(el.text) } });

package/src/protocol.ts

@@ -533,7 +533,7 @@ function formatShare(data: Record<string, unknown> | undefined): ShareElem {
         ...(appsign ? { appsign } : {}),
       }
     : undefined;
-  const summary = optionalString(data.artist);
+  const summary = optionalString(data.description) ?? optionalString(data.artist);
   const content = optionalString(data.content);
   const image = optionalString(data.image);
   const audio = optionalString(data.audio);