@zhin.js/game-kit 1.0.1

package/lib/help-card.js

@@ -0,0 +1,129 @@
+import { Card, CardCanvas, CardHeader, DEFAULT_CARD_THEME, h, KvRow, Section, TopicItem, } from '@zhin.js/satori';
+import { slashCommandPrefix } from './game-commands.js';
+import { collectSupplementaryCommandHelp, formatHubOpenCommandLines, } from './command-help.js';
+export const HELP_CARD_CANVAS = DEFAULT_CARD_THEME.canvas;
+export const HELP_CARD_WIDTH = 560;
+function cardShell(inner) {
+    return h(CardCanvas, {
+        width: HELP_CARD_WIDTH,
+        backgroundColor: HELP_CARD_CANVAS,
+        children: h(Card, { children: inner }),
+    });
+}
+function gameTopicSummary(game) {
+    const quick = game.quickStart ?? '开始';
+    const cmd = `${slashCommandPrefix(game.commandPrefix.replace(/^\//, ''))} ${quick}`;
+    const alias = game.aliases?.length ? ` · ${game.aliases.join(' / ')}` : '';
+    return `${cmd}${alias} — ${game.description}`;
+}
+function commandTopicSummary(cmd) {
+    const [label = '', detail = ''] = cmd.helpInfo.desc;
+    return detail || label || cmd.pattern;
+}
+export function buildBotHelpHtml(input) {
+    const { games, commands, channelType } = input;
+    const hubLines = formatHubOpenCommandLines(commands);
+    const other = commands?.length
+        ? collectSupplementaryCommandHelp(commands, games)
+        : [];
+    const parts = [];
+    parts.push(h(CardHeader, {
+        title: '游戏大厅',
+        subtitle: games.length
+            ? `已注册 ${games.length} 款游戏 · 发送 /游戏 打开按钮大厅`
+            : '暂无已注册游戏',
+        badge: '🎮',
+    }));
+    if (hubLines.length) {
+        parts.push(h(Section, {
+            title: '入口',
+            children: hubLines.map((line) => {
+                const sep = line.indexOf(' — ');
+                const pattern = sep >= 0 ? line.slice(0, sep) : line;
+                const desc = sep >= 0 ? line.slice(sep + 3) : '';
+                return h(KvRow, { label: pattern, value: desc, labelWidth: 72 });
+            }),
+        }));
+    }
+    if (games.length) {
+        parts.push(h(Section, {
+            title: '游戏列表',
+            children: games.map((g, i) => h(TopicItem, {
+                index: i + 1,
+                title: `${g.icon} ${g.title}`,
+                summary: gameTopicSummary(g),
+            })),
+        }));
+    }
+    else {
+        parts.push(h(Section, {
+            title: '提示',
+            children: h(TopicItem, {
+                index: 1,
+                title: '安装任意游戏插件',
+                summary: 'registerGame 后会自动挂载大厅命令',
+            }),
+        }));
+    }
+    if (other.length) {
+        parts.push(h(Section, {
+            title: '其他命令',
+            children: other.map((cmd, i) => h(TopicItem, {
+                index: i + 1,
+                title: cmd.pattern,
+                summary: commandTopicSummary(cmd),
+            })),
+        }));
+    }
+    if (channelType === 'group') {
+        parts.push(h(Section, {
+            title: 'QQ 群用法',
+            children: [
+                h(TopicItem, {
+                    index: 1,
+                    title: '公域群需 @ 机器人',
+                    summary: '发送命令或直接点击消息按钮',
+                }),
+                h(TopicItem, {
+                    index: 2,
+                    title: '/游戏 打开大厅',
+                    summary: '同群成员均可点击按钮参与',
+                }),
+            ],
+        }));
+    }
+    return cardShell(parts.join(''));
+}
+export function buildHubHelpHtml(games, commands) {
+    const hubLines = formatHubOpenCommandLines(commands);
+    const parts = [
+        h(CardHeader, {
+            title: '游戏大厅帮助',
+            subtitle: games.length ? `${games.length} 款游戏可选` : '暂无游戏',
+            badge: '🎮',
+        }),
+    ];
+    if (hubLines.length) {
+        parts.push(h(Section, {
+            title: '入口',
+            children: hubLines.map((line) => {
+                const sep = line.indexOf(' — ');
+                const pattern = sep >= 0 ? line.slice(0, sep) : line;
+                const desc = sep >= 0 ? line.slice(sep + 3) : '';
+                return h(KvRow, { label: pattern, value: desc, labelWidth: 72 });
+            }),
+        }));
+    }
+    if (games.length) {
+        parts.push(h(Section, {
+            title: '游戏',
+            children: games.map((g, i) => h(TopicItem, {
+                index: i + 1,
+                title: `${g.icon} ${g.title}`,
+                summary: gameTopicSummary(g),
+            })),
+        }));
+    }
+    return cardShell(parts.join(''));
+}
+//# sourceMappingURL=help-card.js.map

package/lib/help-card.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @zhin.js/game-kit - 通用游戏工具包
+ *
+ * 提供网格棋盘、会话管理、消息发送等通用抽象
+ */
+export * from './grid-keyboard.js';
+export * from './choice-keyboard.js';
+export * from './board-sender.js';
+export * from './game-session.js';
+export * from './game-hub-feature.js';
+export * from './game-hub-menu.js';
+export * from './game-hub-menu-context.js';
+export * from './game-hub-flow.js';
+export * from './game-hub-mount.js';
+export * from './game-middleware.js';
+export * from './game-action-alias.js';
+export * from './game-commands.js';
+export * from './game-interactive.js';
+export * from './interaction-profiles.js';
+export * from './game-records.js';
+export * from './game-onboarding.js';
+export * from './command-help.js';
+export * from './command-message.js';
+export * from './memory-db.js';
+export * from './send-content-text.js';
+export * from './runtime-hub.js';
+export * from './command-alias.js';
+export * from './random.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC"}

package/lib/index.js

@@ -0,0 +1,29 @@
+/**
+ * @zhin.js/game-kit - 通用游戏工具包
+ *
+ * 提供网格棋盘、会话管理、消息发送等通用抽象
+ */
+export * from './grid-keyboard.js';
+export * from './choice-keyboard.js';
+export * from './board-sender.js';
+export * from './game-session.js';
+export * from './game-hub-feature.js';
+export * from './game-hub-menu.js';
+export * from './game-hub-menu-context.js';
+export * from './game-hub-flow.js';
+export * from './game-hub-mount.js';
+export * from './game-middleware.js';
+export * from './game-action-alias.js';
+export * from './game-commands.js';
+export * from './game-interactive.js';
+export * from './interaction-profiles.js';
+export * from './game-records.js';
+export * from './game-onboarding.js';
+export * from './command-help.js';
+export * from './command-message.js';
+export * from './memory-db.js';
+export * from './send-content-text.js';
+export * from './runtime-hub.js';
+export * from './command-alias.js';
+export * from './random.js';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC"}

package/lib/interaction-profiles.d.ts

@@ -0,0 +1,16 @@
+import type { ButtonData } from '@zhin.js/core';
+/** 交互模式预设：见 ADR 0022 / docs/essentials/interactive-segments.md */
+export type InteractionProfile = 'menu' | 'gameplay' | 'terminal';
+export interface ApplyInteractionProfileOptions {
+    profile: InteractionProfile;
+    /** 用于 terminal profile：私聊可 auto-enter */
+    channelType?: string;
+}
+/**
+ * 按 profile 注入 button.mode（显式 mode 优先）。
+ * - menu / terminal → command
+ * - gameplay → callback
+ */
+export declare function applyInteractionProfile(btn: ButtonData, options: ApplyInteractionProfileOptions): ButtonData;
+export declare function applyInteractionProfileToButtons(buttons: ButtonData[], options: ApplyInteractionProfileOptions): ButtonData[];
+//# sourceMappingURL=interaction-profiles.d.ts.map

package/lib/interaction-profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-profiles.d.ts","sourceRoot":"","sources":["../src/interaction-profiles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAwB,UAAU,EAAyB,MAAM,eAAe,CAAC;AAE7F,kEAAkE;AAClE,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;AAElE,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,kBAAkB,CAAC;IAC5B,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAoBD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,UAAU,EACf,OAAO,EAAE,8BAA8B,GACtC,UAAU,CAWZ;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,UAAU,EAAE,EACrB,OAAO,EAAE,8BAA8B,GACtC,UAAU,EAAE,CAEd"}

package/lib/interaction-profiles.js

@@ -0,0 +1,35 @@
+function defaultModeForProfile(profile, channelType) {
+    if (profile === 'gameplay')
+        return 'callback';
+    // 群/频道大厅为共享 UI，须 callback，否则仅 opener 有文本 fallback 上下文
+    if (profile === 'menu' && channelType && channelType !== 'private')
+        return 'callback';
+    return 'command';
+}
+function defaultCommandForProfile(profile, channelType) {
+    if (profile !== 'terminal')
+        return undefined;
+    return { enter: channelType === 'private' };
+}
+/**
+ * 按 profile 注入 button.mode（显式 mode 优先）。
+ * - menu / terminal → command
+ * - gameplay → callback
+ */
+export function applyInteractionProfile(btn, options) {
+    if (btn.mode != null)
+        return btn;
+    const mode = defaultModeForProfile(options.profile, options.channelType);
+    const commandDefaults = defaultCommandForProfile(options.profile, options.channelType);
+    return {
+        ...btn,
+        mode,
+        command: commandDefaults
+            ? { ...commandDefaults, ...btn.command }
+            : btn.command,
+    };
+}
+export function applyInteractionProfileToButtons(buttons, options) {
+    return buttons.map((btn) => applyInteractionProfile(btn, options));
+}
+//# sourceMappingURL=interaction-profiles.js.map

package/lib/interaction-profiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-profiles.js","sourceRoot":"","sources":["../src/interaction-profiles.ts"],"names":[],"mappings":"AAWA,SAAS,qBAAqB,CAC5B,OAA2B,EAC3B,WAAoB;IAEpB,IAAI,OAAO,KAAK,UAAU;QAAE,OAAO,UAAU,CAAC;IAC9C,sDAAsD;IACtD,IAAI,OAAO,KAAK,MAAM,IAAI,WAAW,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,UAAU,CAAC;IACtF,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,wBAAwB,CAC/B,OAA2B,EAC3B,WAAoB;IAEpB,IAAI,OAAO,KAAK,UAAU;QAAE,OAAO,SAAS,CAAC;IAC7C,OAAO,EAAE,KAAK,EAAE,WAAW,KAAK,SAAS,EAAE,CAAC;AAC9C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACrC,GAAe,EACf,OAAuC;IAEvC,IAAI,GAAG,CAAC,IAAI,IAAI,IAAI;QAAE,OAAO,GAAG,CAAC;IACjC,MAAM,IAAI,GAAG,qBAAqB,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACzE,MAAM,eAAe,GAAG,wBAAwB,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACvF,OAAO;QACL,GAAG,GAAG;QACN,IAAI;QACJ,OAAO,EAAE,eAAe;YACtB,CAAC,CAAC,EAAE,GAAG,eAAe,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE;YACxC,CAAC,CAAC,GAAG,CAAC,OAAO;KAChB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,OAAqB,EACrB,OAAuC;IAEvC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,uBAAuB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;AACrE,CAAC"}

package/lib/memory-db.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Minimal in-memory models for game SessionService (findAll/findOne/create/updateWhere/deleteWhere).
+ * Slice-2 fallback while Plugin Runtime has no DatabaseFeature Resource path.
+ */
+type Row = Record<string, unknown>;
+export interface InMemoryGameModel {
+    findAll: (q?: Record<string, unknown>) => Promise<Row[]>;
+    findOne: (q?: Record<string, unknown>) => Promise<Row | null>;
+    create: (row: Row) => Promise<Row>;
+    updateWhere: (where: Record<string, unknown>, patch: Row) => Promise<number>;
+    deleteWhere: (where: Record<string, unknown>) => Promise<number>;
+}
+export interface InMemoryGameDb {
+    models: {
+        get: (name: string) => InMemoryGameModel | undefined;
+    };
+}
+/** Create an in-memory db with the given model table names. */
+export declare function createInMemoryGameDb(tableNames: readonly string[]): InMemoryGameDb;
+/** Minimal DatabaseHost model surface (structural typing; no plugin-runtime dep). */
+export interface HostGameModelSource {
+    select(): {
+        where(query: Record<string, unknown>): Promise<Record<string, unknown>[]>;
+    };
+    insert(row: Record<string, unknown>): Promise<unknown>;
+    delete(): {
+        where(query: Record<string, unknown>): Promise<unknown>;
+    };
+    update(patch: Record<string, unknown>): {
+        where(query: Record<string, unknown>): Promise<unknown>;
+    };
+}
+export interface HostGameDbSource {
+    models: {
+        get(name: string): HostGameModelSource | undefined;
+    };
+}
+/** Adapt DatabaseHost models to SessionService RelatedModel-style API. */
+export declare function createHostGameDb(host: HostGameDbSource, tableNames: readonly string[]): InMemoryGameDb;
+export {};
+//# sourceMappingURL=memory-db.d.ts.map

package/lib/memory-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-db.d.ts","sourceRoot":"","sources":["../src/memory-db.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnC,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACzD,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;IAC9D,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7E,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAClE;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE;QAAE,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,iBAAiB,GAAG,SAAS,CAAA;KAAE,CAAC;CAClE;AAsCD,+DAA+D;AAC/D,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,cAAc,CAUlF;AAED,qFAAqF;AACrF,MAAM,WAAW,mBAAmB;IAClC,MAAM,IAAI;QACR,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;KAC3E,CAAC;IACF,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD,MAAM,IAAI;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC;IACtE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QACtC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KACzD,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE;QAAE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAAA;KAAE,CAAC;CAChE;AA+BD,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,gBAAgB,EACtB,UAAU,EAAE,SAAS,MAAM,EAAE,GAC5B,cAAc,CAUhB"}

package/lib/memory-db.js

@@ -0,0 +1,92 @@
+/**
+ * Minimal in-memory models for game SessionService (findAll/findOne/create/updateWhere/deleteWhere).
+ * Slice-2 fallback while Plugin Runtime has no DatabaseFeature Resource path.
+ */
+function createMemoryModel() {
+    const rows = [];
+    const match = (row, q) => Object.entries(q).every(([k, v]) => row[k] === v);
+    return {
+        findAll: async (q = {}) => rows.filter((row) => match(row, q)),
+        findOne: async (q = {}) => rows.find((row) => match(row, q)) ?? null,
+        create: async (row) => {
+            rows.push({ ...row });
+            return row;
+        },
+        updateWhere: async (where, patch) => {
+            let n = 0;
+            for (const row of rows) {
+                if (match(row, where)) {
+                    Object.assign(row, patch);
+                    n += 1;
+                }
+            }
+            return n;
+        },
+        deleteWhere: async (where) => {
+            let n = 0;
+            for (let i = rows.length - 1; i >= 0; i -= 1) {
+                if (match(rows[i], where)) {
+                    rows.splice(i, 1);
+                    n += 1;
+                }
+            }
+            return n;
+        },
+    };
+}
+/** Create an in-memory db with the given model table names. */
+export function createInMemoryGameDb(tableNames) {
+    const models = new Map();
+    for (const name of tableNames) {
+        models.set(name, createMemoryModel());
+    }
+    return {
+        models: {
+            get: (name) => models.get(name),
+        },
+    };
+}
+function wrapHostModel(model) {
+    return {
+        findAll: async (q = {}) => {
+            const rows = await model.select().where(q);
+            return rows;
+        },
+        findOne: async (q = {}) => {
+            const rows = await model.select().where(q);
+            return rows[0] ?? null;
+        },
+        create: async (row) => {
+            await model.insert(row);
+            return row;
+        },
+        updateWhere: async (where, patch) => {
+            const matching = await model.select().where(where);
+            if (matching.length === 0)
+                return 0;
+            await model.update(patch).where(where);
+            return matching.length;
+        },
+        deleteWhere: async (where) => {
+            const matching = await model.select().where(where);
+            if (matching.length === 0)
+                return 0;
+            await model.delete().where(where);
+            return matching.length;
+        },
+    };
+}
+/** Adapt DatabaseHost models to SessionService RelatedModel-style API. */
+export function createHostGameDb(host, tableNames) {
+    return {
+        models: {
+            get: (name) => {
+                if (!tableNames.includes(name))
+                    return undefined;
+                const raw = host.models.get(name);
+                return raw ? wrapHostModel(raw) : undefined;
+            },
+        },
+    };
+}
+//# sourceMappingURL=memory-db.js.map

package/lib/memory-db.js.map

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

package/lib/random.d.ts

@@ -0,0 +1,6 @@
+export declare function secureRandomInt(maxExclusive: number): number;
+export declare function secureRandomIntInclusive(min: number, max: number): number;
+export declare function secureRandomItem<T>(items: readonly T[]): T;
+export declare function secureShuffleInPlace<T>(items: T[]): T[];
+export declare function generateCompactId(prefix: string): string;
+//# sourceMappingURL=random.d.ts.map

package/lib/random.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../src/random.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAK5D;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAKzE;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,CAG1D;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAMvD;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/lib/random.js

@@ -0,0 +1,29 @@
+import { randomInt, randomUUID } from 'node:crypto';
+export function secureRandomInt(maxExclusive) {
+    if (!Number.isSafeInteger(maxExclusive) || maxExclusive <= 0) {
+        throw new RangeError('maxExclusive must be a positive safe integer');
+    }
+    return randomInt(maxExclusive);
+}
+export function secureRandomIntInclusive(min, max) {
+    if (!Number.isSafeInteger(min) || !Number.isSafeInteger(max) || max < min) {
+        throw new RangeError('invalid inclusive random range');
+    }
+    return min + randomInt(max - min + 1);
+}
+export function secureRandomItem(items) {
+    if (items.length === 0)
+        throw new RangeError('cannot choose from an empty array');
+    return items[secureRandomInt(items.length)];
+}
+export function secureShuffleInPlace(items) {
+    for (let i = items.length - 1; i > 0; i--) {
+        const j = secureRandomInt(i + 1);
+        [items[i], items[j]] = [items[j], items[i]];
+    }
+    return items;
+}
+export function generateCompactId(prefix) {
+    return `${prefix}${Date.now().toString(36)}${randomUUID().replaceAll('-', '').slice(0, 8)}`;
+}
+//# sourceMappingURL=random.js.map

package/lib/random.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.js","sourceRoot":"","sources":["../src/random.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,UAAU,eAAe,CAAC,YAAoB;IAClD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,UAAU,CAAC,8CAA8C,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,SAAS,CAAC,YAAY,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,GAAW,EAAE,GAAW;IAC/D,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,GAAG,EAAE,CAAC;QAC1E,MAAM,IAAI,UAAU,CAAC,gCAAgC,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,GAAG,GAAG,SAAS,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAI,KAAmB;IACrD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,mCAAmC,CAAC,CAAC;IAClF,OAAO,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,CAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAI,KAAU;IAChD,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACjC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AAC9F,CAAC"}

package/lib/runtime-hub.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Plugin Runtime game hub — module-level registry (no legacy Feature / getPlugin).
+ * Games call `registerRuntimeGame` from `setup()`; hub plugin lists them.
+ */
+export interface RuntimeGameMenuAction {
+    readonly id: string;
+    readonly label: string;
+}
+export interface RuntimeRegisteredGame {
+    readonly id: string;
+    readonly title: string;
+    readonly icon: string;
+    readonly description: string;
+    readonly commandPrefix: string;
+    readonly quickStart?: string;
+    readonly aliases?: readonly string[];
+    readonly menus?: readonly RuntimeGameMenuAction[];
+}
+export declare function registerRuntimeGame(game: RuntimeRegisteredGame): () => void;
+export declare function getRuntimeGames(): readonly RuntimeRegisteredGame[];
+export declare function getRuntimeGame(id: string): RuntimeRegisteredGame | undefined;
+export declare function resetRuntimeGamesForTests(): void;
+export declare function formatRuntimeGamesHelp(): string;
+/** Default idle timeout for stale-session cron (30 minutes). */
+export declare const DEFAULT_GAME_STALE_IDLE_MS: number;
+/** Solar cron: every 10 minutes. */
+export declare const DEFAULT_GAME_STALE_CRON = "0 */10 * * * *";
+//# sourceMappingURL=runtime-hub.d.ts.map

package/lib/runtime-hub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-hub.d.ts","sourceRoot":"","sources":["../src/runtime-hub.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACnD;AAID,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,IAAI,CAY3E;AAED,wBAAgB,eAAe,IAAI,SAAS,qBAAqB,EAAE,CAKlE;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAW5E;AAED,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CAmB/C;AAED,gEAAgE;AAChE,eAAO,MAAM,0BAA0B,QAAiB,CAAC;AAEzD,oCAAoC;AACpC,eAAO,MAAM,uBAAuB,mBAAmB,CAAC"}

package/lib/runtime-hub.js

@@ -0,0 +1,66 @@
+const games = new Map();
+export function registerRuntimeGame(game) {
+    const registered = Object.freeze({ ...game });
+    const registrations = games.get(game.id) ?? [];
+    registrations.push(registered);
+    games.set(game.id, registrations);
+    return () => {
+        const current = games.get(game.id);
+        if (!current)
+            return;
+        const index = current.lastIndexOf(registered);
+        if (index >= 0)
+            current.splice(index, 1);
+        if (current.length === 0)
+            games.delete(game.id);
+    };
+}
+export function getRuntimeGames() {
+    const active = [...games.values()]
+        .map((registrations) => registrations[registrations.length - 1])
+        .filter((game) => Boolean(game));
+    return Object.freeze(active.sort((a, b) => a.id.localeCompare(b.id)));
+}
+export function getRuntimeGame(id) {
+    const directRegistrations = games.get(id);
+    const direct = directRegistrations?.[directRegistrations.length - 1];
+    if (direct)
+        return direct;
+    // 别名解析（如 bj、ttt、21点）
+    for (const registrations of games.values()) {
+        const game = registrations[registrations.length - 1];
+        if (!game)
+            continue;
+        if (game.aliases?.includes(id))
+            return game;
+    }
+    return undefined;
+}
+export function resetRuntimeGamesForTests() {
+    games.clear();
+}
+export function formatRuntimeGamesHelp() {
+    const list = getRuntimeGames();
+    if (list.length === 0) {
+        return [
+            '🎮 游戏大厅',
+            '',
+            '暂无已加载的游戏插件。',
+            '安装并启用 `@zhin.js/plugin-guess-number` 等游戏包后重试。',
+        ].join('\n');
+    }
+    const lines = ['🎮 游戏大厅', '', '已加载：'];
+    for (const g of list) {
+        const start = g.quickStart ? ` ${g.quickStart}` : '';
+        lines.push(`${g.icon} **${g.title}** — \`${g.commandPrefix}${start}\``);
+        lines.push(`   ${g.description}`);
+    }
+    lines.push('');
+    lines.push('发送对应命令开始；进行中可按各游戏说明直接回复。');
+    return lines.join('\n');
+}
+/** Default idle timeout for stale-session cron (30 minutes). */
+export const DEFAULT_GAME_STALE_IDLE_MS = 30 * 60 * 1000;
+/** Solar cron: every 10 minutes. */
+export const DEFAULT_GAME_STALE_CRON = '0 */10 * * * *';
+//# sourceMappingURL=runtime-hub.js.map

package/lib/runtime-hub.js.map

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

package/lib/send-content-text.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Extract plain text from SendContent (skip buttons / keyboard) for text-only game paths.
+ */
+export declare function plainTextFromSendContent(content: unknown): string;
+//# sourceMappingURL=send-content-text.d.ts.map

package/lib/send-content-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-content-text.d.ts","sourceRoot":"","sources":["../src/send-content-text.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAgBjE"}

package/lib/send-content-text.js

@@ -0,0 +1,24 @@
+/**
+ * Extract plain text from SendContent (skip buttons / keyboard) for text-only game paths.
+ */
+export function plainTextFromSendContent(content) {
+    if (content == null)
+        return '';
+    if (typeof content === 'string')
+        return content;
+    if (Array.isArray(content)) {
+        return content
+            .map(plainTextFromSendContent)
+            .filter((s) => s.length > 0)
+            .join('\n');
+    }
+    if (typeof content === 'object' && content !== null && 'type' in content) {
+        const seg = content;
+        if (seg.type === 'text')
+            return String(seg.data?.text ?? '');
+        // buttons / keyboard / other segments omitted in text-only mode
+        return '';
+    }
+    return '';
+}
+//# sourceMappingURL=send-content-text.js.map

package/lib/send-content-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-content-text.js","sourceRoot":"","sources":["../src/send-content-text.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,wBAAwB,CAAC,OAAgB;IACvD,IAAI,OAAO,IAAI,IAAI;QAAE,OAAO,EAAE,CAAC;IAC/B,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,OAAO,OAAO;aACX,GAAG,CAAC,wBAAwB,CAAC;aAC7B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;aAC3B,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;IACD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,MAAM,IAAI,OAAO,EAAE,CAAC;QACzE,MAAM,GAAG,GAAG,OAAwE,CAAC;QACrF,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QAC7D,gEAAgE;QAChE,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}