@zhin.js/adapter-milky 1.1.20 → 1.1.21

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # @zhin.js/adapter-milky
 
+## 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/page@1.1.13
+  - @zhin.js/host-http@1.1.13
+  - @zhin.js/feature-kit@1.1.11
+  - @zhin.js/skill@1.1.12
+
 ## 1.1.20
 
 ### Patch Changes

package/lib/protocol.d.ts

@@ -1,3 +1,4 @@
+import type { EndpointProfileConfiguration } from 'zhin.js/adapter';
 /**
  * Milky protocol helpers (no legacy Adapter/Endpoint / segment-mapper).
  * Canonicalization is owned by gateway/core before endpoint.send.
@@ -6,7 +7,7 @@
 import { type ConversationRef } from '@zhin.js/im-contract';
 import type { Segment } from '@zhin.js/core/runtime';
 /** One endpoint config after AdapterIndex expands `plugins.<instanceKey>.endpoints`. */
-export interface MilkyEndpointConfig {
+export interface MilkyEndpointConfig extends EndpointProfileConfiguration {
     readonly connection?: 'ws' | 'sse' | 'webhook' | 'wss';
     readonly id: string;
     readonly baseUrl: string;

package/lib/self-profile.d.ts

@@ -0,0 +1,8 @@
+import type { EndpointProfile, PendingRpcRequest } from 'zhin.js/adapter';
+interface MilkySelfProfileOptions {
+    readonly call: (request: PendingRpcRequest) => Promise<unknown>;
+    readonly reportAccount: (id: string) => void;
+}
+/** Milky login facts are fetched through the same account-bound, error-checked native caller. */
+export declare function createMilkySelfProfile({ call, reportAccount }: MilkySelfProfileOptions): EndpointProfile;
+export {};

package/lib/self-profile.js

@@ -0,0 +1,13 @@
+/** Milky login facts are fetched through the same account-bound, error-checked native caller. */
+export function createMilkySelfProfile({ call, reportAccount }) {
+    return Object.freeze({
+        writableFields: Object.freeze([]),
+        async read({ signal }) {
+            const self = await call({ action: 'get_login_info', signal });
+            if (!self?.uin || typeof self.nickname !== 'string')
+                throw new Error('Milky returned an incomplete self profile');
+            reportAccount(String(self.uin));
+            return { nickname: self.nickname };
+        },
+    });
+}

package/lib/sse-endpoint.js

@@ -1,3 +1,4 @@
+import { createMilkySelfProfile } from './self-profile.js';
 /**
  * Milky SSE client endpoint — GET text/event-stream on /event.
  */
@@ -33,6 +34,8 @@ export class MilkySseEndpoint extends MilkyClient {
             close: () => { this.#open = false; }, stop: () => this.#stop(),
             send: request => this.#send(request),
             management: this.#management, control: this.#control,
+            profile: createMilkySelfProfile({ call: request => call(request).then(response => readMilkyResponse(response, request.action)),
+                reportAccount: id => this[endpointSpec].reportSelfUserId(id) }),
             get transportState() { return readTransportState(); },
         });
         forwardMilkyClientEvents(this, (name, payload) => {

package/lib/webhook-endpoint.js

@@ -1,3 +1,4 @@
+import { createMilkySelfProfile } from './self-profile.js';
 import { acceptHttpIngress } from 'imhelper';
 import { createEndpointSpecification, endpointSpec, createRecallEndpointControl, } from 'zhin.js/adapter';
 import { formatCompact, getAdapterLogger } from '@zhin.js/logger';
@@ -30,6 +31,8 @@ export class MilkyWebhookEndpoint extends MilkyClient {
             close: () => { this.#open = false; }, stop: () => this.#stop(),
             send: request => this.#send(request),
             management: this.#management, control: this.#control,
+            profile: createMilkySelfProfile({ call: request => call(request).then(response => readMilkyResponse(response, request.action)),
+                reportAccount: id => this[endpointSpec].reportSelfUserId(id) }),
         });
         forwardMilkyClientEvents(this, (name, payload) => {
             void this[endpointSpec].events.run(() => {

package/lib/ws-endpoint.js

@@ -1,3 +1,4 @@
+import { createMilkySelfProfile } from './self-profile.js';
 /**
  * Milky WS client endpoint — outbound connect to Milky protocol server.
  */
@@ -35,6 +36,8 @@ export class MilkyWsEndpoint extends MilkyClient {
             close: () => { this.#close(); }, stop: () => this.#stop(),
             send: request => this.#send(request),
             management: this.#management, control: this.#control,
+            profile: createMilkySelfProfile({ call: request => call(request).then(response => readMilkyResponse(response, request.action)),
+                reportAccount: id => this[endpointSpec].reportSelfUserId(id) }),
             get transportState() { return readTransportState(); },
         });
         forwardMilkyClientEvents(this, (name, payload) => {

package/lib/wss-endpoint.js

@@ -1,3 +1,4 @@
+import { createMilkySelfProfile } from './self-profile.js';
 /**
  * Milky reverse WSS endpoint — httpHostToken WS upgrade inbound + baseUrl HTTP API outbound.
  */
@@ -42,6 +43,8 @@ export class MilkyWssEndpoint extends MilkyClient {
             close: () => { this.#open = false; }, stop: () => this.#stop(),
             send: request => this.#send(request),
             management: this.#management, control: this.#control,
+            profile: createMilkySelfProfile({ call: request => call(request).then(response => readMilkyResponse(response, request.action)),
+                reportAccount: id => this[endpointSpec].reportSelfUserId(id) }),
             get transportState() { return readTransportState(); },
         });
         forwardMilkyClientEvents(this, (name, payload) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-milky",
-  "version": "1.1.20",
+  "version": "1.1.21",
   "description": "Zhin.js Milky adapter for Plugin Runtime (WebSocket client)",
   "type": "module",
   "main": "./lib/index.js",
@@ -43,16 +43,16 @@
     "@imhelper/milky-v1": "1.0.7",
     "imhelper": "1.0.7",
     "ws": "^8.21.1",
-    "@zhin.js/adapter": "1.1.26",
-    "@zhin.js/client": "1.1.22",
+    "@zhin.js/adapter": "1.1.27",
+    "@zhin.js/client": "1.1.23",
     "@zhin.js/console-contract": "1.1.3",
-    "@zhin.js/core": "1.1.54",
-    "@zhin.js/feature-kit": "1.1.10",
-    "@zhin.js/host-http": "1.1.12",
-    "@zhin.js/im-contract": "1.1.9",
+    "@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/page": "1.1.13",
+    "@zhin.js/skill": "1.1.12",
+    "@zhin.js/core": "1.1.55"
   },
   "devDependencies": {
     "@types/node": "^26.1.2",
@@ -60,17 +60,17 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "@zhin.js/agent": "1.1.45",
-    "@zhin.js/host-http": "1.1.12",
-    "zhin.js": "1.1.19"
+    "@zhin.js/agent": "1.1.46",
+    "@zhin.js/host-http": "1.1.13",
+    "zhin.js": "1.1.20"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/adapter": "^1.1.26",
-    "@zhin.js/agent": "^1.1.45",
-    "@zhin.js/command": "^1.1.12",
-    "@zhin.js/core": "^1.1.54",
-    "zhin.js": "^1.1.19"
+    "@zhin.js/adapter": "^1.1.27",
+    "@zhin.js/agent": "^1.1.46",
+    "@zhin.js/command": "^1.1.13",
+    "@zhin.js/core": "^1.1.55",
+    "zhin.js": "^1.1.20"
   },
   "peerDependenciesMeta": {
     "@zhin.js/agent": {
@@ -107,7 +107,7 @@
     "features": [
       {
         "package": "@zhin.js/adapter",
-        "api": "^2.0.0"
+        "api": "^2.1.0"
       },
       {
         "package": "@zhin.js/command",

package/schema.json

@@ -119,6 +119,27 @@
           "id": {
             "type": "string",
             "description": "Milky bot name"
+          },
+          "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": [
@@ -141,9 +162,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/protocol.ts

@@ -1,3 +1,4 @@
+import type { EndpointProfileConfiguration } from 'zhin.js/adapter';
 /**
  * Milky protocol helpers (no legacy Adapter/Endpoint / segment-mapper).
  * Canonicalization is owned by gateway/core before endpoint.send.
@@ -11,7 +12,7 @@ import { formatCompact, getLogger } from '@zhin.js/logger';
 const logger = getLogger('milky');
 
 /** One endpoint config after AdapterIndex expands `plugins.<instanceKey>.endpoints`. */
-export interface MilkyEndpointConfig {
+export interface MilkyEndpointConfig extends EndpointProfileConfiguration {
   readonly connection?: 'ws' | 'sse' | 'webhook' | 'wss';
   readonly id: string;
   readonly baseUrl: string;

package/src/self-profile.ts

@@ -0,0 +1,19 @@
+import type { EndpointProfile, PendingRpcRequest } from 'zhin.js/adapter';
+
+interface MilkySelfProfileOptions {
+  readonly call: (request: PendingRpcRequest) => Promise<unknown>;
+  readonly reportAccount: (id: string) => void;
+}
+
+/** Milky login facts are fetched through the same account-bound, error-checked native caller. */
+export function createMilkySelfProfile({ call, reportAccount }: MilkySelfProfileOptions): EndpointProfile {
+  return Object.freeze<EndpointProfile>({
+    writableFields: Object.freeze([]),
+    async read({ signal }) {
+      const self = await call({ action: 'get_login_info', signal }) as { uin?: number; nickname?: string } | undefined;
+      if (!self?.uin || typeof self.nickname !== 'string') throw new Error('Milky returned an incomplete self profile');
+      reportAccount(String(self.uin));
+      return { nickname: self.nickname };
+    },
+  });
+}

package/src/sse-endpoint.ts

@@ -1,3 +1,4 @@
+import { createMilkySelfProfile } from './self-profile.js';
 /**
  * Milky SSE client endpoint — GET text/event-stream on /event.
  */
@@ -80,6 +81,8 @@ export class MilkySseEndpoint extends MilkyClient implements Endpoint {
       close: () => { this.#open = false; }, stop: () => this.#stop(),
       send: request => this.#send(request),
       management: this.#management, control: this.#control,
+      profile: createMilkySelfProfile({ call: request => call(request).then(response => readMilkyResponse(response, request.action)),
+        reportAccount: id => this[endpointSpec].reportSelfUserId(id) }),
       get transportState() { return readTransportState(); },
     });
     forwardMilkyClientEvents(this, (name, payload) => {

package/src/webhook-endpoint.ts

@@ -1,3 +1,4 @@
+import { createMilkySelfProfile } from './self-profile.js';
 /**
  * Milky webhook endpoint — httpHostToken POST inbound + baseUrl HTTP API outbound.
  */
@@ -70,6 +71,8 @@ export class MilkyWebhookEndpoint extends MilkyClient implements Endpoint {
       close: () => { this.#open = false; }, stop: () => this.#stop(),
       send: request => this.#send(request),
       management: this.#management, control: this.#control,
+      profile: createMilkySelfProfile({ call: request => call(request).then(response => readMilkyResponse(response, request.action)),
+        reportAccount: id => this[endpointSpec].reportSelfUserId(id) }),
     });
     forwardMilkyClientEvents(this, (name, payload) => {
       void this[endpointSpec].events.run(() => {

package/src/ws-endpoint.ts

@@ -1,3 +1,4 @@
+import { createMilkySelfProfile } from './self-profile.js';
 /**
  * Milky WS client endpoint — outbound connect to Milky protocol server.
  */
@@ -84,6 +85,8 @@ export class MilkyWsEndpoint extends MilkyClient implements Endpoint {
       close: () => { this.#close(); }, stop: () => this.#stop(),
       send: request => this.#send(request),
       management: this.#management, control: this.#control,
+      profile: createMilkySelfProfile({ call: request => call(request).then(response => readMilkyResponse(response, request.action)),
+        reportAccount: id => this[endpointSpec].reportSelfUserId(id) }),
       get transportState() { return readTransportState(); },
     });
     forwardMilkyClientEvents(this, (name, payload) => {

package/src/wss-endpoint.ts

@@ -1,3 +1,4 @@
+import { createMilkySelfProfile } from './self-profile.js';
 /**
  * Milky reverse WSS endpoint — httpHostToken WS upgrade inbound + baseUrl HTTP API outbound.
  */
@@ -82,6 +83,8 @@ export class MilkyWssEndpoint extends MilkyClient implements Endpoint {
       close: () => { this.#open = false; }, stop: () => this.#stop(),
       send: request => this.#send(request),
       management: this.#management, control: this.#control,
+      profile: createMilkySelfProfile({ call: request => call(request).then(response => readMilkyResponse(response, request.action)),
+        reportAccount: id => this[endpointSpec].reportSelfUserId(id) }),
       get transportState() { return readTransportState(); },
     });
     forwardMilkyClientEvents(this, (name, payload) => {