@zhin.js/game-kit 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 凉菜
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,93 @@
+# @zhin.js/game-kit
+
+Zhin.js Plugin Runtime 游戏工具包。它提供交互键盘、游戏会话、战绩、Runtime 游戏大厅、
+DatabaseHost 适配和文本 fallback，不依赖 `zhin.js` facade。
+
+## 安装
+
+```bash
+pnpm add @zhin.js/game-kit @zhin.js/command @zhin.js/middleware
+```
+
+## Runtime 插件
+
+游戏包通过 `plugin.ts` 在 generation 生命周期登记大厅元数据，并由约定目录暴露交互：
+
+```ts
+import { definePlugin } from '@zhin.js/plugin-runtime';
+import { registerRuntimeGame } from '@zhin.js/game-kit';
+
+export default definePlugin({
+  name: 'my-game',
+  setup(context) {
+    const services = createMyGameServices();
+    context.resources.provide(myGameServicesToken, services);
+    const dispose = registerRuntimeGame({
+      id: 'my-game',
+      title: 'My Game',
+      icon: 'GAME',
+      description: 'A turn-based game',
+      commandPrefix: '/my-game',
+      quickStart: 'start',
+    });
+    context.lifecycle.add(dispose);
+  },
+});
+```
+
+- `commands/<name>/[action:string=].ts` 定义命令。
+- `middlewares/` 处理按钮 payload、裸文本答案和旧命令别名。
+- `registerRuntimeGame()` / `getRuntimeGames()` 是大厅 SSOT，dispose 时对称移除。
+- `DEFAULT_GAME_STALE_CRON` 与 `scheduleHostToken` 用于清理超时会话。
+- 每个游戏包定义自己的 typed service token；`plugin.ts` 提供资源，command/middleware
+  通过 Capability Context 的 `use(token)` 消费。禁止以模块变量保存当前 SessionService。
+
+## 交互消息
+
+```ts
+import { buildChoiceKeyboard, buildGridKeyboard } from '@zhin.js/game-kit';
+
+const menu = buildChoiceKeyboard({
+  gamePrefix: 'adv',
+  sessionId: 's123',
+  narrative: 'Choose a path',
+  choices: [
+    { id: 'enter', label: 'Enter' },
+    { id: 'leave', label: 'Leave', style: 'danger' },
+  ],
+  interactionProfile: 'gameplay',
+});
+
+const board = buildGridKeyboard({
+  gamePrefix: 'ttt',
+  sessionId: 's123',
+  rows: 3,
+  cols: 3,
+  cells: Array.from({ length: 9 }, () => ({ state: 0, label: '.', disabled: false })),
+  statusLine: 'Your turn',
+});
+```
+
+`plainTextFromSendContent()` 会在无编辑能力或 text-only 路径移除按钮并保留正文；平台差异
+仍由 Adapter 出站链处理。`messageFromCommandInput()` 把 Runtime `Message` 转成游戏引擎使用
+的稳定 message-like 结构。
+
+## 数据
+
+- `createInMemoryGameDb()`：测试与无数据库配置时的完整内存实现。
+- `createHostGameDb()`：把 generation-owned `DatabaseHost` 转成 SessionService 所需接口。
+- `initGameRecordHost()` / `recordGameOutcome()`：统一战绩表与结果写入。
+- `channelKey()` / `generateSessionId()`：稳定会话身份。
+
+游戏包应优先使用 `databaseHostToken`，缺失时为每个插件实例创建独立内存库。数据库、
+SessionService、cron 闭包都属于同一个 owner generation；热更卸载旧代不会覆盖新代状态。
+
+## 验证
+
+```bash
+pnpm --filter @zhin.js/game-kit build
+pnpm vitest run plugins/games/*/tests
+```
+
+交互 profile 见 [ADR 0022](../../docs/adr/0022-interactive-button-modes.md)，Plugin Runtime
+迁移边界见 [ADR 0050](../../docs/adr/0050-plugin-runtime-migration-boundary.md)。

package/lib/board-sender.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 游戏棋盘消息辅助工具
+ * 提供会话键生成和消息 ID 更新回调封装
+ *
+ * 注意：实际的发送/编辑逻辑由 Adapter.editMessage 统一处理
+ * - 支持编辑的平台：调用平台 API 编辑
+ * - 不支持编辑的平台：自动 fallback 到发送新消息
+ */
+import type { Message } from '@zhin.js/core';
+/**
+ * 构建频道唯一键（用于会话查找）
+ */
+export declare function channelKey(message: Message<any>): string;
+//# sourceMappingURL=board-sender.d.ts.map

package/lib/board-sender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-sender.d.ts","sourceRoot":"","sources":["../src/board-sender.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAExD"}

package/lib/board-sender.js

@@ -0,0 +1,7 @@
+/**
+ * 构建频道唯一键（用于会话查找）
+ */
+export function channelKey(message) {
+    return `${message.$adapter}-${message.$endpoint}-${message.$channel.type}:${message.$channel.id}`;
+}
+//# sourceMappingURL=board-sender.js.map

package/lib/board-sender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-sender.js","sourceRoot":"","sources":["../src/board-sender.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,OAAqB;IAC9C,OAAO,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,IAAI,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;AACpG,CAAC"}

package/lib/choice-keyboard.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 选项式交互键盘（文字冒险、问答、剧情分支等）
+ */
+import { type SendContent } from '@zhin.js/core';
+import { type InteractionProfile } from './interaction-profiles.js';
+export interface ChoiceOption {
+    /** 选项 ID，写入 payload */
+    id: string;
+    label: string;
+    disabled?: boolean;
+    style?: 'primary' | 'danger' | 'secondary';
+    /** 终局菜单（如「再来一局」）保持可点 */
+    keepEnabledWhenTerminal?: boolean;
+}
+export interface ChoiceKeyboardOptions {
+    gamePrefix: string;
+    sessionId: string;
+    /** 剧情/题干正文 */
+    narrative: string;
+    choices: ChoiceOption[];
+    terminal?: boolean;
+    /** 文本 fallback 提示 */
+    fallbackHint?: string;
+    /** 每行最多几个按钮（默认全部一行） */
+    buttonsPerRow?: number;
+    /** 交互 profile：menu→command，gameplay→callback，terminal→command */
+    interactionProfile?: InteractionProfile;
+    /** terminal profile 私聊 auto-enter 用 */
+    channelType?: string;
+}
+export declare function buildChoiceFallbackMap(gamePrefix: string, sessionId: string, choices: ChoiceOption[]): Record<string, string>;
+/**
+ * 构建选项键盘消息：正文 + 一行或多行按钮
+ */
+export declare function buildChoiceKeyboard(options: ChoiceKeyboardOptions): SendContent;
+/**
+ * 解析选项 payload：`{prefix}:{sessionId}:{choiceId}`
+ */
+export declare function parseChoicePayload(payload: string, expectedPrefix?: string): {
+    prefix: string;
+    sessionId: string;
+    choiceId: string;
+} | null;
+//# sourceMappingURL=choice-keyboard.d.ts.map

package/lib/choice-keyboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"choice-keyboard.d.ts","sourceRoot":"","sources":["../src/choice-keyboard.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAW,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAA2B,KAAK,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE7F,MAAM,WAAW,YAAY;IAC3B,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC3C,wBAAwB;IACxB,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qBAAqB;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uBAAuB;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,YAAY,EAAE,GACtB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUxB;AAWD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,qBAAqB,GAAG,WAAW,CAyC/E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,MAAM,GACtB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAMhE"}

package/lib/choice-keyboard.js

@@ -0,0 +1,67 @@
+/**
+ * 选项式交互键盘（文字冒险、问答、剧情分支等）
+ */
+import { segment } from '@zhin.js/core';
+import { applyInteractionProfile } from './interaction-profiles.js';
+export function buildChoiceFallbackMap(gamePrefix, sessionId, choices) {
+    const map = {};
+    let n = 1;
+    for (const choice of choices) {
+        if (!choice.disabled) {
+            map[String(n)] = `${gamePrefix}:${sessionId}:${choice.id}`;
+            n++;
+        }
+    }
+    return map;
+}
+function chunkChoices(items, size) {
+    if (size <= 0 || items.length <= size)
+        return [items];
+    const rows = [];
+    for (let i = 0; i < items.length; i += size) {
+        rows.push(items.slice(i, i + size));
+    }
+    return rows;
+}
+/**
+ * 构建选项键盘消息：正文 + 一行或多行按钮
+ */
+export function buildChoiceKeyboard(options) {
+    const { gamePrefix, sessionId, narrative, choices, terminal, fallbackHint, buttonsPerRow, interactionProfile, channelType, } = options;
+    const enabled = choices.filter((c) => !c.disabled);
+    const buttonRows = chunkChoices(enabled, buttonsPerRow ?? enabled.length).map((row) => row.map((choice) => {
+        const base = segment.button({
+            id: choice.id,
+            label: choice.label,
+            payload: `${gamePrefix}:${sessionId}:${choice.id}`,
+            disabled: choice.disabled || (terminal && !choice.keepEnabledWhenTerminal),
+            style: choice.style ?? 'secondary',
+        });
+        const data = base.data;
+        if (!interactionProfile)
+            return base;
+        return segment.button(applyInteractionProfile(data, { profile: interactionProfile, channelType }));
+    }));
+    const fallback = buildChoiceFallbackMap(gamePrefix, sessionId, choices);
+    return [
+        segment.text(narrative),
+        segment.keyboard(buttonRows, {
+            fallback: fallbackHint && Object.keys(fallback).length > 0
+                ? { hint: fallbackHint, map: fallback }
+                : undefined,
+        }).toElement(),
+    ];
+}
+/**
+ * 解析选项 payload：`{prefix}:{sessionId}:{choiceId}`
+ */
+export function parseChoicePayload(payload, expectedPrefix) {
+    const m = /^([a-z0-9_]+):([^:]+):([a-z0-9_-]+)$/i.exec(payload);
+    if (!m)
+        return null;
+    const prefix = m[1];
+    if (expectedPrefix && prefix !== expectedPrefix)
+        return null;
+    return { prefix, sessionId: m[2], choiceId: m[3] };
+}
+//# sourceMappingURL=choice-keyboard.js.map

package/lib/choice-keyboard.js.map

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

package/lib/command-alias.d.ts

@@ -0,0 +1,21 @@
+import { type MiddlewareContext } from '@zhin.js/middleware';
+import type { Message } from '@zhin.js/core/runtime';
+/**
+ * 游戏 legacy 命令别名路由。
+ *
+ * 插件运行时迁移后，约定式命令以 `<instanceKey> <localName>` 限定名注册（ADR 0043），
+ * 旧的短命令（如 `/21点 开始`、`/猜数 开始`）在 runtime 中不存在。
+ * 各游戏插件用本 helper 在 `middlewares/` 下注册一个入站中间件，
+ * 把命中别名的首词消息转发到与限定名命令完全相同的处理逻辑。
+ */
+export interface GameCommandAliasRoute {
+    /** 首词命中即接管（不含前导 `/`），如 `['21点', 'bj']`。 */
+    readonly aliases: readonly string[];
+    /**
+     * 与 `commands/<cmd>/[action:string=].ts` 的 execute 逻辑保持一致：
+     * action 为别名后剩余文本（无参数时为 ''）；返回回复文本，null/undefined 表示放行。
+     */
+    run(action: string, input: unknown, context: MiddlewareContext<Message>): Promise<string | null | undefined>;
+}
+export declare function defineGameCommandAliasMiddleware(route: GameCommandAliasRoute): Readonly<import("@zhin.js/middleware").MiddlewareDefinition<Message, unknown>>;
+//# sourceMappingURL=command-alias.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command-alias.d.ts","sourceRoot":"","sources":["../src/command-alias.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC;;;OAGG;IACH,GAAG,CACD,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAClC,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;CACvC;AAED,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,qBAAqB,kFAmB5E"}

package/lib/command-alias.js

@@ -0,0 +1,22 @@
+import { defineMiddleware } from '@zhin.js/middleware';
+export function defineGameCommandAliasMiddleware(route) {
+    return defineMiddleware({
+        target: 'inbound',
+        async handle(context, next) {
+            const raw = context.input.content?.trim() ?? '';
+            const text = raw.startsWith('/') ? raw.slice(1) : raw;
+            const [head, ...rest] = text.split(/\s+/).filter(Boolean);
+            if (!head || !route.aliases.includes(head)) {
+                await next();
+                return;
+            }
+            const reply = await route.run(rest.join(' '), context.input, context);
+            if (reply) {
+                await context.input.$reply(reply);
+                return;
+            }
+            await next();
+        },
+    });
+}
+//# sourceMappingURL=command-alias.js.map

package/lib/command-alias.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-alias.js","sourceRoot":"","sources":["../src/command-alias.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAA0B,MAAM,qBAAqB,CAAC;AAyB/E,MAAM,UAAU,gCAAgC,CAAC,KAA4B;IAC3E,OAAO,gBAAgB,CAAU;QAC/B,MAAM,EAAE,SAAS;QACjB,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI;YACxB,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YAChD,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YACtD,MAAM,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC1D,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3C,MAAM,IAAI,EAAE,CAAC;gBACb,OAAO;YACT,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACtE,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAClC,OAAO;YACT,CAAC;YACD,MAAM,IAAI,EAAE,CAAC;QACf,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/lib/command-help.d.ts

@@ -0,0 +1,19 @@
+import type { Message, MessageCommand, Plugin } from '@zhin.js/core';
+import type { RegisteredGame } from './game-hub-feature.js';
+export interface CommandHelpSource {
+    pattern: string;
+    helpInfo: {
+        desc: string[];
+        usage?: string[];
+        examples?: string[];
+    };
+}
+export declare function commandToHelpSource(cmd: Pick<MessageCommand, 'pattern' | 'helpInfo'>): CommandHelpSource;
+/** 按 MessageCommand.permit 与当前消息上下文过滤（与 handle 一致） */
+export declare function filterHelpCommands(commands: readonly MessageCommand[], message: Message<any>, plugin: Plugin): Promise<CommandHelpSource[]>;
+/** 从 command 服务收集应在 /帮助 中展示的命令（去重、排除已在游戏大厅列出的项） */
+export declare function collectSupplementaryCommandHelp(commands: readonly CommandHelpSource[], games: readonly RegisteredGame[]): CommandHelpSource[];
+export declare function formatSupplementaryCommandsHelp(commands: readonly CommandHelpSource[], games: readonly RegisteredGame[]): string;
+/** 大厅入口行：从已注册命令的 .desc() 生成 */
+export declare function formatHubOpenCommandLines(commands: readonly CommandHelpSource[] | undefined): string[];
+//# sourceMappingURL=command-help.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../src/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,UAAU,CAAC,GAAG,iBAAiB,CAExG;AAED,sDAAsD;AACtD,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,SAAS,cAAc,EAAE,EACnC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAQ9B;AA+CD,mDAAmD;AACnD,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,SAAS,iBAAiB,EAAE,EACtC,KAAK,EAAE,SAAS,cAAc,EAAE,GAC/B,iBAAiB,EAAE,CAWrB;AAED,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,SAAS,iBAAiB,EAAE,EACtC,KAAK,EAAE,SAAS,cAAc,EAAE,GAC/B,MAAM,CAKR;AAED,+BAA+B;AAC/B,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,GAAG,SAAS,GACjD,MAAM,EAAE,CAUV"}

package/lib/command-help.js

@@ -0,0 +1,91 @@
+export function commandToHelpSource(cmd) {
+    return { pattern: cmd.pattern, helpInfo: cmd.helpInfo };
+}
+/** 按 MessageCommand.permit 与当前消息上下文过滤（与 handle 一致） */
+export async function filterHelpCommands(commands, message, plugin) {
+    const out = [];
+    for (const cmd of commands) {
+        if (await cmd.checkPermits(message, plugin)) {
+            out.push(commandToHelpSource(cmd));
+        }
+    }
+    return out;
+}
+function commandLeadingToken(pattern) {
+    return pattern.split(/\s/)[0] ?? '';
+}
+function normalizeToken(token) {
+    return token.replace(/^\//, '').toLowerCase();
+}
+/** 不在「其他命令」中重复展示的 pattern（大厅入口 / 帮助自身） */
+const HELP_EXCLUDE_EXACT = new Set([
+    '/帮助',
+    '/help',
+    '帮助',
+    '/游戏 帮助',
+    '/游戏',
+    '/game',
+    '游戏',
+    'game',
+]);
+function isHubListedGameCommand(pattern, games) {
+    const lead = normalizeToken(commandLeadingToken(pattern));
+    return games.some((g) => normalizeToken(g.commandPrefix) === lead);
+}
+function comparePatterns(a, b) {
+    const leadDiff = commandLeadingToken(b).length - commandLeadingToken(a).length;
+    if (leadDiff !== 0)
+        return leadDiff;
+    return b.length - a.length;
+}
+function formatPatternDisplay(pattern) {
+    return `\`${pattern}\``;
+}
+function formatCommandHelpLine(cmd) {
+    const [label = '', detail = ''] = cmd.helpInfo.desc;
+    const display = formatPatternDisplay(cmd.pattern);
+    const summary = detail || label || cmd.pattern;
+    if (label && label !== commandLeadingToken(cmd.pattern) && !cmd.pattern.startsWith(label)) {
+        return `• ${display}（${label}）— ${summary}`;
+    }
+    return `• ${display} — ${summary}`;
+}
+/** 从 command 服务收集应在 /帮助 中展示的命令（去重、排除已在游戏大厅列出的项） */
+export function collectSupplementaryCommandHelp(commands, games) {
+    const seen = new Set();
+    const out = [];
+    for (const cmd of [...commands].sort((a, b) => comparePatterns(a.pattern, b.pattern))) {
+        if (HELP_EXCLUDE_EXACT.has(cmd.pattern))
+            continue;
+        if (isHubListedGameCommand(cmd.pattern, games))
+            continue;
+        if (seen.has(cmd.pattern))
+            continue;
+        seen.add(cmd.pattern);
+        out.push(cmd);
+    }
+    return out;
+}
+export function formatSupplementaryCommandsHelp(commands, games) {
+    const items = collectSupplementaryCommandHelp(commands, games);
+    if (!items.length)
+        return '';
+    const lines = items.map(formatCommandHelpLine);
+    return ['**其他命令**', '', ...lines].join('\n');
+}
+/** 大厅入口行：从已注册命令的 .desc() 生成 */
+export function formatHubOpenCommandLines(commands) {
+    if (!commands?.length)
+        return [];
+    const lines = [];
+    for (const pattern of ['/游戏', '/game']) {
+        const cmd = commands.find((c) => c.pattern === pattern);
+        if (!cmd)
+            continue;
+        const desc = cmd.helpInfo.desc[0] ?? cmd.helpInfo.desc[1] ?? '';
+        if (desc)
+            lines.push(`${pattern} — ${desc}`);
+    }
+    return lines;
+}
+//# sourceMappingURL=command-help.js.map

package/lib/command-help.js.map

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

package/lib/command-message.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Map Plugin Runtime CommandContext.input → classic Message-like shape used by game SessionService.
+ *
+ * Runtime Message: { adapter, target, sender?, metadata? }
+ * Classic Message: { $adapter, $endpoint, $channel, $sender }
+ */
+export interface GameMessageLike {
+    $adapter: string;
+    $endpoint: string;
+    $channel: {
+        type: string;
+        id: string;
+    };
+    $sender: {
+        id: string;
+        name: string;
+    };
+}
+/** Smoke message when CommandContext has no usable input (unit tests / CLI). */
+export declare function smokeGameMessage(): GameMessageLike;
+/**
+ * Convert CommandContext.input to a Message-like object for game-flow / *-command.
+ */
+export declare function messageFromCommandInput(input: unknown): GameMessageLike;
+//# sourceMappingURL=command-message.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command-message.d.ts","sourceRoot":"","sources":["../src/command-message.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,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;IACvC,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACvC;AA8BD,gFAAgF;AAChF,wBAAgB,gBAAgB,IAAI,eAAe,CAOlD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAoBvE"}

package/lib/command-message.js

@@ -0,0 +1,58 @@
+/**
+ * Map Plugin Runtime CommandContext.input → classic Message-like shape used by game SessionService.
+ *
+ * Runtime Message: { adapter, target, sender?, metadata? }
+ * Classic Message: { $adapter, $endpoint, $channel, $sender }
+ */
+function isClassicMessage(input) {
+    if (!input || typeof input !== 'object')
+        return false;
+    const m = input;
+    return (typeof m.$adapter === 'string' &&
+        m.$channel != null &&
+        typeof m.$channel === 'object' &&
+        m.$sender != null &&
+        typeof m.$sender === 'object');
+}
+function isRuntimeMessage(input) {
+    if (!input || typeof input !== 'object')
+        return false;
+    const m = input;
+    return ('adapter' in m ||
+        'target' in m ||
+        'sender' in m ||
+        (m.metadata != null && typeof m.metadata === 'object'));
+}
+/** Smoke message when CommandContext has no usable input (unit tests / CLI). */
+export function smokeGameMessage() {
+    return {
+        $adapter: 'runtime',
+        $endpoint: 'default',
+        $channel: { type: 'private', id: 'smoke' },
+        $sender: { id: 'smoke', name: 'smoke' },
+    };
+}
+/**
+ * Convert CommandContext.input to a Message-like object for game-flow / *-command.
+ */
+export function messageFromCommandInput(input) {
+    if (isClassicMessage(input))
+        return input;
+    if (isRuntimeMessage(input)) {
+        const meta = input.metadata ?? {};
+        const adapter = String(input.adapter ?? 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 senderId = String(input.sender ?? meta.senderId ?? 'smoke');
+        const senderName = String(meta.senderName ?? meta.name ?? senderId);
+        return {
+            $adapter: adapter,
+            $endpoint: endpoint,
+            $channel: { type: channelType, id: channelId },
+            $sender: { id: senderId, name: senderName },
+        };
+    }
+    return smokeGameMessage();
+}
+//# sourceMappingURL=command-message.js.map

package/lib/command-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-message.js","sourceRoot":"","sources":["../src/command-message.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,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"}

package/lib/game-action-alias.d.ts

@@ -0,0 +1,8 @@
+export declare function normalizeTttAction(raw: string): string;
+export declare function normalizeAdvAction(raw: string): string;
+export declare function normalizeRpsAction(raw: string): string;
+export declare function normalizeGuessAction(raw: string): string;
+export declare function normalizeDiceAction(raw: string): string;
+export declare function normalizeChainAction(raw: string): string;
+export declare function normalizeRiddleAction(raw: string): string;
+//# sourceMappingURL=game-action-alias.d.ts.map

package/lib/game-action-alias.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-action-alias.d.ts","sourceRoot":"","sources":["../src/game-action-alias.ts"],"names":[],"mappings":"AAsEA,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEvD;AAkCD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEzD"}