@zhin.js/adapter-line 1.1.19 → 1.1.21

package/CHANGELOG.md

@@ -1,5 +1,41 @@
 # @zhin.js/adapter-line
 
+## 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
+
+- Updated dependencies [5e878ba]
+  - @zhin.js/page@1.1.12
+
 ## 1.1.19
 
 ### Patch Changes

package/lib/endpoint.js

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

package/lib/protocol.d.ts

@@ -1,11 +1,8 @@
-/**
- * LINE Messaging API protocol helpers — no legacy Adapter/Endpoint / segment-mapper.
- * Canonicalization is owned by gateway/core before endpoint.send.
- */
+import type { EndpointProfileConfiguration } from 'zhin.js/adapter';
 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 LineEndpointConfig {
+export interface LineEndpointConfig extends EndpointProfileConfiguration {
     readonly id: string;
     readonly channelSecret: string;
     readonly channelAccessToken: string;

package/lib/self-profile.d.ts

@@ -0,0 +1,9 @@
+import type { EndpointProfile } from 'zhin.js/adapter';
+import type { LineApiClient } from './api-client.js';
+interface LineSelfProfileOptions {
+    readonly client: Pick<LineApiClient, 'request'>;
+    readonly reportAccount: (id: string) => void;
+}
+/** Messaging API exposes bot info, but profile edits remain in LINE account administration. */
+export declare function createLineSelfProfile({ client, reportAccount }: LineSelfProfileOptions): EndpointProfile;
+export {};

package/lib/self-profile.js

@@ -0,0 +1,13 @@
+/** Messaging API exposes bot info, but profile edits remain in LINE account administration. */
+export function createLineSelfProfile({ client, reportAccount }) {
+    return Object.freeze({
+        writableFields: Object.freeze([]),
+        async read({ signal }) {
+            const self = await client.request('/v2/bot/info', { signal });
+            if (!self.userId || typeof self.displayName !== 'string')
+                throw new Error('LINE returned an incomplete bot profile');
+            reportAccount(self.userId);
+            return { nickname: self.displayName, ...(typeof self.pictureUrl === 'string' ? { avatar: self.pictureUrl } : {}) };
+        },
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-line",
-  "version": "1.1.19",
+  "version": "1.1.21",
   "description": "Zhin.js LINE Messaging API adapter for Plugin Runtime (HTTP webhook)",
   "type": "module",
   "main": "./lib/index.js",
@@ -31,26 +31,26 @@
     "directory": "plugins/adapters/line"
   },
   "dependencies": {
-    "@zhin.js/adapter": "1.1.26",
-    "@zhin.js/agent-feature": "1.1.11",
-    "@zhin.js/client": "1.1.22",
+    "@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/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/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.11",
-    "@zhin.js/skill": "1.1.11",
-    "@zhin.js/tool": "1.1.13"
+    "@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/host-http": "^1.1.12",
-    "zhin.js": "^1.1.19"
+    "@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": "^1.1.20"
   },
   "peerDependenciesMeta": {
     "@zhin.js/command": {
@@ -68,7 +68,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",
@@ -100,7 +100,7 @@
     "features": [
       {
         "package": "@zhin.js/adapter",
-        "api": "^2.0.0"
+        "api": "^2.1.0"
       },
       {
         "package": "@zhin.js/command",
@@ -108,7 +108,7 @@
       },
       {
         "package": "@zhin.js/tool",
-        "api": "^1.0.0"
+        "api": "^1.1.0"
       },
       {
         "package": "@zhin.js/skill",

package/schema.json

@@ -95,6 +95,27 @@
           "id": {
             "type": "string",
             "description": "LINE 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": [
@@ -118,9 +139,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/endpoint.ts

@@ -1,5 +1,6 @@
 import { createEndpointSpecification, endpointSpec, type Endpoint } from 'zhin.js/adapter';
 import { LineClient, type LineEndpointOptions } from './client.js';
+import { createLineSelfProfile } from './self-profile.js';
 export type { LineEndpointOptions } from './client.js';
 export type { LineFetch } from './client.js';
 
@@ -14,6 +15,7 @@ export class LineEndpoint extends LineClient implements Endpoint {
       send: (request: import('zhin.js/adapter').EndpointSendRequest) => this.sendPayload(request),
       name: this.configName(),
       management: this.endpointManagement,
+      profile: createLineSelfProfile({ client: this, reportAccount: id => this[endpointSpec].reportSelfUserId(id) }),
     };
     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';
 /**
  * LINE Messaging API 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('line');
 
 /** One endpoint config after AdapterIndex expands `plugins.<instanceKey>.endpoints`. */
-export interface LineEndpointConfig {
+export interface LineEndpointConfig extends EndpointProfileConfiguration {
   readonly id: string;
   readonly channelSecret: string;
   readonly channelAccessToken: string;

package/src/self-profile.ts

@@ -0,0 +1,20 @@
+import type { EndpointProfile } from 'zhin.js/adapter';
+import type { LineApiClient } from './api-client.js';
+
+interface LineSelfProfileOptions {
+  readonly client: Pick<LineApiClient, 'request'>;
+  readonly reportAccount: (id: string) => void;
+}
+
+/** Messaging API exposes bot info, but profile edits remain in LINE account administration. */
+export function createLineSelfProfile({ client, reportAccount }: LineSelfProfileOptions): EndpointProfile {
+  return Object.freeze<EndpointProfile>({
+    writableFields: Object.freeze([]),
+    async read({ signal }) {
+      const self = await client.request<{ userId: string; displayName: string; pictureUrl?: string }>('/v2/bot/info', { signal });
+      if (!self.userId || typeof self.displayName !== 'string') throw new Error('LINE returned an incomplete bot profile');
+      reportAccount(self.userId);
+      return { nickname: self.displayName, ...(typeof self.pictureUrl === 'string' ? { avatar: self.pictureUrl } : {}) };
+    },
+  });
+}