@zhin.js/game-kit 3.0.0 → 3.0.2

package/README.md

@@ -35,7 +35,7 @@ export default defineGamePlugin({
 });
 ```
 
-- `commands/<name>/[action:string=].ts` 定义命令。
+- `commands/<name>/[[action]].ts` 定义命令（可选参数；在 `defineCommand({ params })` 中声明 `action` 的类型与默认值）。
 - `middlewares/` 处理按钮 payload、裸文本答案和旧命令别名。
 - `registerRuntimeGame()` / `getRuntimeGames()` 是大厅 SSOT，dispose 时对称移除。
 - `DEFAULT_GAME_STALE_CRON` 与 `scheduleHostToken` 用于清理超时会话。

package/lib/command-alias.d.ts

@@ -13,7 +13,7 @@ export interface GameCommandAliasRoute {
     /** 首词命中即接管（不含前导 `/`），如 `['21点', 'bj']`。 */
     readonly aliases: readonly string[];
     /**
-     * 与 `commands/<cmd>/[action:string=].ts` 的 execute 逻辑保持一致：
+     * 与 `commands/<cmd>/[[action]].ts` 的 execute 逻辑保持一致：
      * action 为别名后剩余文本（无参数时为 ''）；返回回复文本，null/undefined 表示放行。
      */
     run(action: string, input: unknown, context: MiddlewareContext<Message>): Promise<AliasReply | null | undefined>;

package/lib/command-message.d.ts

@@ -1,7 +1,7 @@
 /**
  * Map Plugin Runtime CommandContext.input → classic Message-like shape used by game SessionService.
  *
- * Runtime Message: { adapter, target, sender?, metadata? }
+ * Runtime Message: { conversation, sender?, metadata? }
  * Classic Message: { $adapter, $endpoint, $channel, $sender }
  */
 import type { SendContent } from '@zhin.js/core';

package/lib/command-message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-message.d.ts","sourceRoot":"","sources":["../src/command-message.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,wFAAwF;AACxF,MAAM,MAAM,SAAS,GAAG,WAAW,CAAC;AAEpC,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAKvC,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACxC;AA8BD,gFAAgF;AAChF,wBAAgB,gBAAgB,IAAI,eAAe,CAOlD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAoBvE"}
+{"version":3,"file":"command-message.d.ts","sourceRoot":"","sources":["../src/command-message.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,wFAAwF;AACxF,MAAM,MAAM,SAAS,GAAG,WAAW,CAAC;AAEpC,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAKvC,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACxC;AAgCD,gFAAgF;AAChF,wBAAgB,gBAAgB,IAAI,eAAe,CAOlD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CA2BvE"}

package/lib/command-message.js

@@ -12,8 +12,7 @@ function isRuntimeMessage(input) {
     if (!input || typeof input !== 'object')
         return false;
     const m = input;
-    return ('adapter' in m ||
-        'target' in m ||
+    return ('conversation' in m ||
         'sender' in m ||
         (m.metadata != null && typeof m.metadata === 'object'));
 }
@@ -34,10 +33,17 @@ export function messageFromCommandInput(input) {
         return input;
     if (isRuntimeMessage(input)) {
         const meta = input.metadata ?? {};
-        const adapter = String(input.adapter ?? meta.adapter ?? 'runtime');
+        const conversation = input.conversation;
+        const endpointCapabilityId = typeof conversation?.endpoint?.id === 'string'
+            ? conversation.endpoint.id
+            : undefined;
+        const adapterName = endpointCapabilityId
+            ? (endpointCapabilityId.split('\0').pop() ?? endpointCapabilityId).split('~')[0]
+            : undefined;
+        const adapter = String(adapterName ?? meta.adapter ?? 'runtime');
         const endpoint = String(meta.endpoint ?? meta.endpointId ?? 'default');
-        const channelType = String(meta.type ?? meta.channelType ?? 'private');
-        const channelId = String(input.target ?? meta.channelId ?? 'smoke');
+        const channelType = String(meta.type ?? meta.channelType ?? conversation?.kind ?? 'private');
+        const channelId = String(meta.channelId ?? conversation?.id ?? 'smoke');
         const senderId = String(input.sender ?? meta.senderId ?? 'smoke');
         const senderName = String(meta.senderName ?? meta.name ?? senderId);
         return {

package/lib/command-message.js.map

@@ -1 +1 @@
-{"version":3,"file":"command-message.js","sourceRoot":"","sources":["../src/command-message.ts"],"names":[],"mappings":"AAsBA,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,OAAO,CACL,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ;QAC9B,CAAC,CAAC,QAAQ,IAAI,IAAI;QAClB,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ;QAC9B,CAAC,CAAC,OAAO,IAAI,IAAI;QACjB,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAC9B,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IAMtC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,OAAO,CACL,SAAS,IAAI,CAAC;QACd,QAAQ,IAAI,CAAC;QACb,QAAQ,IAAI,CAAC;QACb,CAAC,CAAC,CAAC,QAAQ,IAAI,IAAI,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CACvD,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,SAAS;QACpB,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE;QAC1C,OAAO,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE;KACxC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,IAAI,gBAAgB,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAE1C,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,IAAI,SAAS,CAAC,CAAC;QACnE,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,UAAU,IAAI,SAAS,CAAC,CAAC;QACvE,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,IAAI,SAAS,CAAC,CAAC;QACvE,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,SAAS,IAAI,OAAO,CAAC,CAAC;QACpE,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,CAAC;QAClE,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC,CAAC;QACpE,OAAO;YACL,QAAQ,EAAE,OAAO;YACjB,SAAS,EAAE,QAAQ;YACnB,QAAQ,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,SAAS,EAAE;YAC9C,OAAO,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE;SAC5C,CAAC;IACJ,CAAC;IAED,OAAO,gBAAgB,EAAE,CAAC;AAC5B,CAAC"}
+{"version":3,"file":"command-message.js","sourceRoot":"","sources":["../src/command-message.ts"],"names":[],"mappings":"AAsBA,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,OAAO,CACL,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ;QAC9B,CAAC,CAAC,QAAQ,IAAI,IAAI;QAClB,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ;QAC9B,CAAC,CAAC,OAAO,IAAI,IAAI;QACjB,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAC9B,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IAStC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,OAAO,CACL,cAAc,IAAI,CAAC;QACnB,QAAQ,IAAI,CAAC;QACb,CAAC,CAAC,CAAC,QAAQ,IAAI,IAAI,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CACvD,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,SAAS;QACpB,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE;QAC1C,OAAO,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE;KACxC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,IAAI,gBAAgB,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAE1C,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;QAClC,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;QACxC,MAAM,oBAAoB,GAAG,OAAO,YAAY,EAAE,QAAQ,EAAE,EAAE,KAAK,QAAQ;YACzE,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE;YAC1B,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,WAAW,GAAG,oBAAoB;YACtC,CAAC,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,IAAI,oBAAoB,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAChF,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,IAAI,IAAI,CAAC,OAAO,IAAI,SAAS,CAAC,CAAC;QACjE,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,UAAU,IAAI,SAAS,CAAC,CAAC;QACvE,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,IAAI,YAAY,EAAE,IAAI,IAAI,SAAS,CAAC,CAAC;QAC7F,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,YAAY,EAAE,EAAE,IAAI,OAAO,CAAC,CAAC;QACxE,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,CAAC;QAClE,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC,CAAC;QACpE,OAAO;YACL,QAAQ,EAAE,OAAO;YACjB,SAAS,EAAE,QAAQ;YACnB,QAAQ,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,SAAS,EAAE;YAC9C,OAAO,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE;SAC5C,CAAC;IACJ,CAAC;IAED,OAAO,gBAAgB,EAAE,CAAC;AAC5B,CAAC"}

package/lib/define-game-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define-game-plugin.d.ts","sourceRoot":"","sources":["../src/define-game-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,KAAK,EACX,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AAOxB,OAAO,EAIL,KAAK,qBAAqB,EAC3B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,iBAAiB,CAChC,IAAI,SAAS,kBAAkB,GAAG,kBAAkB;IAEpD,UAAU,CACR,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAClD,OAAO,CAAC,MAAM,CAAC,CAAC;IACnB,mBAAmB,CAAC,IAAI,MAAM,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,uBAAuB,CACtC,SAAS,EACT,IAAI,SAAS,kBAAkB,GAAG,kBAAkB,EACpD,OAAO,GAAG,OAAO;IAEjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IACzC,2FAA2F;IAC3F,QAAQ,CAAC,gBAAgB,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC9D,QAAQ,CAAC,cAAc,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,SAAS,CAAC;IACjE,QAAQ,CAAC,OAAO,EAAE,CAChB,QAAQ,EAAE,SAAS,KAChB,iBAAiB,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACxD,QAAQ,CAAC,KAAK,CAAC,EAAE;QACf,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC;QACxD,QAAQ,CAAC,SAAS,CAAC,EAAE,CACnB,OAAO,EAAE,IAAI,EACb,OAAO,EAAE,kBAAkB,CAAC,OAAO,CAAC,KACjC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC3B,GAAG,KAAK,CAAC;IACV,QAAQ,CAAC,KAAK,CAAC,EAAE,CACf,OAAO,EAAE,kBAAkB,CAAC,OAAO,CAAC,EACpC,QAAQ,EAAE,SAAS,KAChB,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;CACzD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EACT,IAAI,SAAS,kBAAkB,GAAG,kBAAkB,EACpD,OAAO,GAAG,OAAO,EAEjB,OAAO,EAAE,uBAAuB,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,yEA+E3D"}
+{"version":3,"file":"define-game-plugin.d.ts","sourceRoot":"","sources":["../src/define-game-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,KAAK,EACX,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AAOxB,OAAO,EAIL,KAAK,qBAAqB,EAC3B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,iBAAiB,CAChC,IAAI,SAAS,kBAAkB,GAAG,kBAAkB;IAEpD,UAAU,CACR,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAClD,OAAO,CAAC,MAAM,CAAC,CAAC;IACnB,mBAAmB,CAAC,IAAI,MAAM,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,uBAAuB,CACtC,SAAS,EACT,IAAI,SAAS,kBAAkB,GAAG,kBAAkB,EACpD,OAAO,GAAG,OAAO;IAEjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IACzC,2FAA2F;IAC3F,QAAQ,CAAC,gBAAgB,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC9D,QAAQ,CAAC,cAAc,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,SAAS,CAAC;IACjE,QAAQ,CAAC,OAAO,EAAE,CAChB,QAAQ,EAAE,SAAS,KAChB,iBAAiB,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACxD,QAAQ,CAAC,KAAK,CAAC,EAAE;QACf,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC;QACxD,QAAQ,CAAC,SAAS,CAAC,EAAE,CACnB,OAAO,EAAE,IAAI,EACb,OAAO,EAAE,kBAAkB,CAAC,OAAO,CAAC,KACjC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC3B,GAAG,KAAK,CAAC;IACV,QAAQ,CAAC,KAAK,CAAC,EAAE,CACf,OAAO,EAAE,kBAAkB,CAAC,OAAO,CAAC,EACpC,QAAQ,EAAE,SAAS,KAChB,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;CACzD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EACT,IAAI,SAAS,kBAAkB,GAAG,kBAAkB,EACpD,OAAO,GAAG,OAAO,EAEjB,OAAO,EAAE,uBAAuB,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,yEAiF3D"}

package/lib/define-game-plugin.js

@@ -67,8 +67,10 @@ export function defineGamePlugin(options) {
                             await outbound.send({
                                 adapter: row.adapter,
                                 endpointId: row.endpoint,
-                                channelType: row.channel_type,
-                                channelId: row.channel_id,
+                                conversation: {
+                                    kind: row.channel_type,
+                                    id: row.channel_id,
+                                },
                                 content: typeof stale.message === 'function'
                                     ? stale.message(row)
                                     : stale.message

package/lib/define-game-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"define-game-plugin.js","sourceRoot":"","sources":["../src/define-game-plugin.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"define-game-plugin.js","sourceRoot":"","sources":["../src/define-game-plugin.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/game-kit",
-  "version": "3.0.0",
+  "version": "3.0.2",
   "description": "Zhin.js 游戏插件通用工具包",
   "type": "module",
   "main": "./lib/index.js",
@@ -13,8 +13,8 @@
     }
   },
   "peerDependencies": {
-    "zhin.js": "^6.0.0",
-    "@zhin.js/html-renderer": "3.0.0"
+    "zhin.js": "^6.0.2",
+    "@zhin.js/html-renderer": "3.0.2"
   },
   "peerDependenciesMeta": {
     "@zhin.js/html-renderer": {
@@ -22,14 +22,14 @@
     }
   },
   "dependencies": {
-    "@zhin.js/core": "1.5.0",
-    "@zhin.js/middleware": "1.0.4",
-    "@zhin.js/plugin-runtime": "1.1.1",
+    "@zhin.js/core": "1.5.2",
+    "@zhin.js/middleware": "1.0.6",
+    "@zhin.js/plugin-runtime": "1.1.3",
     "@zhin.js/satori": "1.0.17"
   },
   "devDependencies": {
     "typescript": "^6.0.3",
-    "zhin.js": "6.0.0"
+    "zhin.js": "6.0.2"
   },
   "files": [
     "lib",

package/src/command-alias.ts

@@ -15,7 +15,7 @@ export interface GameCommandAliasRoute {
   /** 首词命中即接管（不含前导 `/`），如 `['21点', 'bj']`。 */
   readonly aliases: readonly string[];
   /**
-   * 与 `commands/<cmd>/[action:string=].ts` 的 execute 逻辑保持一致：
+   * 与 `commands/<cmd>/[[action]].ts` 的 execute 逻辑保持一致：
    * action 为别名后剩余文本（无参数时为 ''）；返回回复文本，null/undefined 表示放行。
    */
   run(

package/src/command-message.ts

@@ -1,7 +1,7 @@
 /**
  * Map Plugin Runtime CommandContext.input → classic Message-like shape used by game SessionService.
  *
- * Runtime Message: { adapter, target, sender?, metadata? }
+ * Runtime Message: { conversation, sender?, metadata? }
  * Classic Message: { $adapter, $endpoint, $channel, $sender }
  */
 import type { SendContent } from '@zhin.js/core';
@@ -33,16 +33,18 @@ function isClassicMessage(input: unknown): input is GameMessageLike {
 }
 
 function isRuntimeMessage(input: unknown): input is {
-  adapter?: string;
-  target?: string;
+  conversation?: {
+    endpoint?: { id?: string; adapter?: string };
+    kind?: string;
+    id?: string;
+  };
   sender?: string;
   metadata?: Readonly<Record<string, unknown>>;
 } {
   if (!input || typeof input !== 'object') return false;
   const m = input as Record<string, unknown>;
   return (
-    'adapter' in m ||
-    'target' in m ||
+    'conversation' in m ||
     'sender' in m ||
     (m.metadata != null && typeof m.metadata === 'object')
   );
@@ -66,10 +68,17 @@ export function messageFromCommandInput(input: unknown): GameMessageLike {
 
   if (isRuntimeMessage(input)) {
     const meta = input.metadata ?? {};
-    const adapter = String(input.adapter ?? meta.adapter ?? 'runtime');
+    const conversation = input.conversation;
+    const endpointCapabilityId = typeof conversation?.endpoint?.id === 'string'
+      ? conversation.endpoint.id
+      : undefined;
+    const adapterName = endpointCapabilityId
+      ? (endpointCapabilityId.split('\0').pop() ?? endpointCapabilityId).split('~')[0]
+      : undefined;
+    const adapter = String(adapterName ?? meta.adapter ?? 'runtime');
     const endpoint = String(meta.endpoint ?? meta.endpointId ?? 'default');
-    const channelType = String(meta.type ?? meta.channelType ?? 'private');
-    const channelId = String(input.target ?? meta.channelId ?? 'smoke');
+    const channelType = String(meta.type ?? meta.channelType ?? conversation?.kind ?? 'private');
+    const channelId = String(meta.channelId ?? conversation?.id ?? 'smoke');
     const senderId = String(input.sender ?? meta.senderId ?? 'smoke');
     const senderName = String(meta.senderName ?? meta.name ?? senderId);
     return {

package/src/define-game-plugin.ts

@@ -143,8 +143,10 @@ export function defineGamePlugin<
                 await outbound.send({
                   adapter: row.adapter,
                   endpointId: row.endpoint,
-                  channelType: row.channel_type,
-                  channelId: row.channel_id,
+                  conversation: {
+                    kind: row.channel_type as 'private' | 'group' | 'channel',
+                    id: row.channel_id,
+                  },
                   content: typeof stale.message === 'function'
                     ? stale.message(row)
                     : stale.message