@zhin.js/core 1.1.33 → 1.1.35

package/lib/plugin.js

@@ -6,15 +6,18 @@
  * - 生命周期事件类型安全（Plugin.Lifecycle）
  * - 中间件系统、适配器管理、useContext 等
  */
-import { AsyncLocalStorage } from "node:async_hooks";
 import * as fs from "node:fs";
 import * as path from "node:path";
-import { fileURLToPath, pathToFileURL } from "node:url";
+import { pathToFileURL } from "node:url";
 import { formatCompact } from "@zhin.js/logger";
 import { compose, remove, resolveEntry } from "./utils.js";
+import { ensureInteractiveMiddleware, registerInteractiveHandler as registerInteractiveHandlerCore, } from "./built/interactive-segments/handlers.js";
 import { Adapter } from "./adapter.js";
-import { Feature } from "@zhin.js/kernel";
-import { PluginBase, resolvePluginResolveDir as _resolvePluginResolveDir, pluginCreateRequire as _pluginCreateRequire, getFileHash, watchFile, registerExtension, unregisterExtensions, installExtensionProxy, } from "@zhin.js/kernel";
+import { Feature, PluginBase, resolvePluginResolveDir as _resolvePluginResolveDir, pluginCreateRequire as _pluginCreateRequire, getFileHash, watchFile, registerExtension, unregisterExtensions, installExtensionProxy } from '@zhin.js/kernel';
+import { storage } from "./plugin-context.js";
+export { getPlugin, markPluginRuntimeActive, isPluginRuntimeActive, resetPluginRuntimeFlag } from "./plugin-context.js";
+export { storage, getCurrentFile } from "./plugin-context.js";
+export { setHostRootPlugin, getHostRootPlugin } from "./host-plugin-registry.js";
 const contextsKey = Symbol("contexts");
 function resolvePluginResolveDir(parent) {
     return _resolvePluginResolveDir(parent);
@@ -23,68 +26,13 @@ const loadedModules = new Map();
 function pluginCreateRequire() {
     return _pluginCreateRequire();
 }
-// ============================================================================
-// AsyncLocalStorage 上下文
-// ============================================================================
-export const storage = new AsyncLocalStorage();
 /**
- * 获取当前文件路径（调用者）
- */
-function getCurrentFile(metaUrl = import.meta.url) {
-    if (typeof metaUrl !== "string" || metaUrl.length === 0) {
-        return path.join(process.cwd(), "__zhin_edge_bootstrap__.mjs");
-    }
-    const previousPrepareStackTrace = Error.prepareStackTrace;
-    Error.prepareStackTrace = function (_, stack) {
-        return stack;
-    };
-    const stack = new Error().stack;
-    Error.prepareStackTrace = previousPrepareStackTrace;
-    const stackFiles = Array.from(new Set(stack.map((site) => site.getFileName())));
-    const idx = stackFiles.findIndex((f) => f === fileURLToPath(metaUrl) || f === metaUrl);
-    const result = stackFiles[idx + 1];
-    if (!result) {
-        return path.join(process.cwd(), "__zhin_edge_bootstrap__.mjs");
-    }
-    try {
-        return fileURLToPath(result);
-    }
-    catch {
-        return result;
-    }
-}
-/**
- * usePlugin - 获取或创建当前插件实例
- * 类似 React Hooks 的设计，根据调用文件自动创建插件树
- * 同一上下文中同一文件多次调用返回同一实例
+ * @deprecated **已删除**。请使用 `definePlugin` + 约定目录（`zhin runtime start`）。
+ * @throws 总是抛出——仅保留签名供编译期过渡。
  */
 export function usePlugin() {
-    const callerFile = getCurrentFile();
-    // 如果当前 store 已是同一文件创建的插件，直接返回
-    const current = storage.getStore();
-    if (current && current.filePath.replace(/\?t=\d+$/, '') === callerFile.replace(/\?t=\d+$/, '')) {
-        return current;
-    }
-    const parentPlugin = current;
-    const newPlugin = new Plugin(callerFile, parentPlugin);
-    try {
-        storage.enterWith(newPlugin);
-    }
-    catch {
-        // Cloudflare Workers 等环境未实现 enterWith；调用方须用 storage.run()
-    }
-    return newPlugin;
-}
-/**
- * getPlugin - 获取当前 AsyncLocalStorage 中的插件实例
- * 用于 extensions 等场景，不创建新插件
- */
-export function getPlugin() {
-    const plugin = storage.getStore();
-    if (!plugin) {
-        throw new Error('getPlugin() must be called within a plugin context');
-    }
-    return plugin;
+    throw new Error('usePlugin() has been removed. Use `definePlugin` + convention directories instead. '
+        + 'See docs/contributing/public-api-surface.md');
 }
 /**
  * Plugin 类 - IM 特化插件，继承 PluginBase
@@ -106,33 +54,14 @@ export class Plugin extends PluginBase {
     get root() {
         return super.root;
     }
-    // 插件功能
-    #messageMiddleware = async (message, next) => {
-        const commandService = this.inject('command');
-        if (!commandService)
-            return await next();
-        const result = await commandService.handle(message, this);
-        if (result === undefined || result === null)
-            return await next();
-        const adapter = this.inject(message.$adapter);
-        if (!adapter || !(adapter instanceof Adapter))
-            return await next();
-        await message.$reply(result);
+    // 默认中间件：将入站消息交给 compose 链末端的 MessageDispatcher（命令/AI 路由在 dispatcher 内完成）
+    #messageMiddleware = async (_message, next) => {
+        await next();
     };
     #middlewares = [this.#messageMiddleware];
-    // Feature 贡献追踪
-    #featureContributions = new Map();
-    // 统一的清理函数集合
-    #disposables = new Set();
     get middleware() {
         return compose(this.#middlewares);
     }
-    recordFeatureContribution(featureName, itemName) {
-        if (!this.#featureContributions.has(featureName)) {
-            this.#featureContributions.set(featureName, new Set());
-        }
-        this.#featureContributions.get(featureName).add(itemName);
-    }
     /**
      * 构造函数
      */
@@ -152,11 +81,17 @@ export class Plugin extends PluginBase {
      */
     addMiddleware(middleware, name) {
         this.#middlewares.push(middleware);
-        const dispose = () => {
-            remove(this.#middlewares, middleware);
-            this.#disposables.delete(dispose);
-        };
-        this.#disposables.add(dispose);
+        const dispose = () => remove(this.#middlewares, middleware);
+        this.onDispose(dispose);
+        return dispose;
+    }
+    /**
+     * 注册交互式 action 回调处理器（自动安装根中间件，优先于 Dispatcher）
+     */
+    registerInteractiveHandler(prefix, handler) {
+        ensureInteractiveMiddleware((mw) => this.root.addMiddleware(mw));
+        const dispose = registerInteractiveHandlerCore(prefix, handler);
+        this.onDispose(dispose);
         return dispose;
     }
     /**
@@ -165,15 +100,20 @@ export class Plugin extends PluginBase {
     get name() {
         if (this.#cachedName)
             return this.#cachedName;
-        this.#cachedName = path
+        let name = path
             .relative(process.cwd(), this.filePath)
             .replace(/\?t=\d+$/, "")
             .replace(/\\/g, "/")
             .replace(/\/index\.(js|ts)x?$/, "")
-            .replace(/\/(lib|src|dist)$/, "")
-            .replace(/.*\/node_modules\//, "")
-            .replace(/.*\//, "")
-            .replace(/\.(js|ts)x?$/, "");
+            .replace(/\/(lib|src|dist)$/, "");
+        const nodeModulesIndex = name.indexOf("node_modules/");
+        if (nodeModulesIndex !== -1)
+            name = name.slice(nodeModulesIndex + "node_modules/".length);
+        const slash = name.lastIndexOf("/");
+        if (slash !== -1)
+            name = name.slice(slash + 1);
+        name = name.replace(/\.(js|ts)x?$/, "");
+        this.#cachedName = name;
         return this.#cachedName;
     }
     /**
@@ -248,10 +188,9 @@ export class Plugin extends PluginBase {
                 sideEffect.finished = false;
             };
             this.on('context.dispose', disposeFn);
-            // 确保 dispose 时清理监听器（只注册一次）
             const cleanupOnDispose = () => {
                 this.off('context.dispose', disposeFn);
-                dispose(this.inject(args[0]));
+                dispose(this.inject(contexts[0]));
             };
             this.once('dispose', cleanupOnDispose);
         };
@@ -268,7 +207,8 @@ export class Plugin extends PluginBase {
         contextReadyCallback();
     }
     inject(name) {
-        const context = this.root.contexts.get(name);
+        const resolved = name === 'cron' ? 'schedule' : name;
+        const context = this.root.contexts.get(resolved);
         return context?.value;
     }
     injectAdapter(name) {
@@ -293,44 +233,41 @@ export class Plugin extends PluginBase {
     // ============================================================================
     /**
      * 启动插件
+     * 覆盖 PluginBase.start() 以支持 Context 挂载失败回滚
      */
     async start(t) {
         if (this.started)
             return;
-        // 挂载所有 Context，支持部分失败回滚
+        // 先挂载所有 Context（带回滚），再标记 started
+        await this.mountAllContexts();
+        this.started = true;
+        await this.broadcast("mounted");
+        for (const child of this.children) {
+            await child.start(t);
+        }
+        if (t) {
+            this.logger.debug(formatCompact({ name: this.name, reload_ms: Date.now() - t }));
+        }
+    }
+    /**
+     * 覆盖 mountAllContexts：支持部分失败回滚
+     */
+    async mountAllContexts() {
         const mountedContexts = [];
         for (const [name, context] of this.$contexts) {
             try {
-                if (typeof context.mounted === "function") {
-                    const result = await context.mounted(this);
-                    // 仅在没有预设 value 时才用 mounted 返回值赋值
-                    if (!context.value) {
-                        context.value = result;
-                    }
-                }
-                // 注册扩展方法到共享 registry
-                if (context.extensions) {
-                    installExtensionProxy(Plugin.prototype);
-                    for (const [extName, fn] of Object.entries(context.extensions)) {
-                        if (typeof fn === 'function') {
-                            registerExtension(extName, fn);
-                        }
-                    }
-                }
+                await this.mountContext(context);
                 mountedContexts.push({ name, context });
             }
             catch (e) {
-                // 回滚已挂载的 Context（逆序 dispose）
                 this.logger.warn(`Context "${name}" mount failed: ${e}, rolling back ${mountedContexts.length} mounted contexts`);
                 for (let i = mountedContexts.length - 1; i >= 0; i--) {
                     const { name: mName, context: mCtx } = mountedContexts[i];
                     try {
-                        if (mCtx.extensions) {
+                        if (mCtx.extensions)
                             unregisterExtensions(Object.keys(mCtx.extensions));
-                        }
-                        if (typeof mCtx.dispose === 'function') {
+                        if (typeof mCtx.dispose === 'function')
                             await mCtx.dispose(mCtx.value);
-                        }
                     }
                     catch (disposeErr) {
                         this.logger.warn(`Rollback dispose for "${mName}" failed: ${disposeErr}`);
@@ -339,22 +276,9 @@ export class Plugin extends PluginBase {
                 throw e;
             }
         }
-        // 所有 Context 成功挂载后，才标记为已启动
-        this.started = true;
         for (const { name } of mountedContexts) {
             this.dispatch('context.mounted', name);
         }
-        await this.broadcast("mounted");
-        // 先启动子插件，再打印当前插件启动日志
-        for (const child of this.children) {
-            await child.start(t);
-        }
-        if (t) {
-            this.logger.debug(formatCompact({
-                name: this.name,
-                reload_ms: Date.now() - t,
-            }));
-        }
     }
     /**
      * 获取插件提供的功能
@@ -363,11 +287,11 @@ export class Plugin extends PluginBase {
     get features() {
         const commandService = this.inject('command');
         const componentService = this.inject('component');
-        const cronService = this.inject('cron');
+        const scheduleService = this.inject('schedule');
         return {
             commands: commandService ? commandService.items.map(c => c.pattern) : [],
             components: componentService ? componentService.getAllNames() : [],
-            crons: cronService ? cronService.items.map(c => c.cronExpression) : [],
+            schedules: scheduleService ? scheduleService.items.map(s => s.id) : [],
             middlewares: this.#middlewares.map((m, i) => m.name || `middleware_${i}`),
         };
     }
@@ -382,8 +306,8 @@ export class Plugin extends PluginBase {
             result.push({ name: 'command', count: f.commands.length });
         if (f.components.length > 0)
             result.push({ name: 'component', count: f.components.length });
-        if (f.crons.length > 0)
-            result.push({ name: 'cron', count: f.crons.length });
+        if (f.schedules.length > 0)
+            result.push({ name: 'schedule', count: f.schedules.length });
         // #middlewares includes the default command middleware, only count user-added ones
         const userMiddlewareCount = this.#middlewares.length - 1; // subtract default #messageMiddleware
         if (userMiddlewareCount > 0)
@@ -401,63 +325,16 @@ export class Plugin extends PluginBase {
     }
     /**
      * 停止插件
+     * 委托 PluginBase.stop() 处理通用清理，仅补充 IM 特化逻辑
      */
     async stop() {
         if (!this.started)
             return;
         this.logger.debug(`Stopping plugin "${this.name}"`);
-        this.started = false;
-        // 停止子插件
-        for (const child of this.children) {
-            await child.stop();
-        }
-        this.children = [];
-        // 停止服务
-        for (const [name, context] of this.$contexts) {
-            remove(Plugin[contextsKey], name);
-            // 从共享 registry 注销扩展方法（引用计数，不影响其他提供者）
-            if (context.extensions) {
-                unregisterExtensions(Object.keys(context.extensions));
-            }
-            if (typeof context.dispose === "function") {
-                await context.dispose(context.value);
-            }
-        }
-        // 清理 contexts Map
-        this.$contexts.clear();
-        // 清空缓存的名称
-        this.#cachedName = undefined;
-        // 触发 dispose 事件
-        this.emit("dispose");
-        // 执行所有清理函数
-        for (const dispose of this.#disposables) {
-            try {
-                await dispose();
-            }
-            catch (e) {
-                this.logger.warn(`Dispose callback failed: ${e}`);
-            }
-        }
-        this.#disposables.clear();
-        // 清空 middlewares 数组（保留默认的消息中间件）
+        // 通用清理（子插件、contexts、disposables、loadedModules 等）
+        await super.stop();
+        // IM 特化：重置中间件（保留默认消息中间件）
         this.#middlewares.length = 1;
-        // 清理 feature 贡献记录
-        this.#featureContributions.clear();
-        if (this.parent) {
-            remove(this.parent?.children, this);
-        }
-        // 从全局 loadedModules Map 中移除，防止内存泄漏
-        if (this.filePath) {
-            try {
-                const realPath = fs.realpathSync(this.filePath);
-                loadedModules.delete(realPath);
-            }
-            catch {
-                // 文件可能已不存在，忽略错误
-            }
-        }
-        this.removeAllListeners();
-        this.logger.debug(`Plugin "${this.name}" stopped`);
     }
     // ============================================================================
     // 生命周期钩子
@@ -465,12 +342,7 @@ export class Plugin extends PluginBase {
     onMounted(callback) {
         this.on("mounted", callback);
     }
-    onDispose(callback) {
-        this.#disposables.add(callback);
-        return () => {
-            this.#disposables.delete(callback);
-        };
-    }
+    // onDispose 继承自 PluginBase
     // ============================================================================
     // 事件广播
     // ============================================================================
@@ -584,30 +456,42 @@ export class Plugin extends PluginBase {
      */
     async reload(plugin = this) {
         const p = plugin;
-        this.logger.info(formatCompact({ name: p.name, reload: true }));
-        const now = Date.now();
-        if (!p.parent) {
-            // 根插件重载 = 退出进程（由 CLI 重启）
-            return process.exit(51);
-        }
-        const entry = p.filePath;
-        const parent = p.parent;
-        await p.stop();
-        let fresh;
+        // A burst of file events for one logical save (or an overlapping edit
+        // while a reload is still in flight) must not start a second concurrent
+        // stop()+import() cycle for the same plugin.
+        if (p._reloading)
+            return;
+        p._reloading = true;
         try {
-            fresh = await parent.import(entry, now);
+            this.logger.info(formatCompact({ name: p.name, reload: true }));
+            const now = Date.now();
+            if (!p.parent) {
+                // 根插件重载 = 退出进程（由 CLI 重启）
+                process.exit(51);
+                return;
+            }
+            const entry = p.filePath;
+            const parent = p.parent;
+            await p.stop();
+            let fresh;
+            try {
+                fresh = await parent.import(entry, now);
+            }
+            catch (err) {
+                this.logger.error(formatCompact({
+                    name: p.name,
+                    reload: false,
+                    error: err instanceof Error ? err.message : String(err),
+                    hint: 'full_restart',
+                }));
+                throw err;
+            }
+            await fresh.broadcast('mounted');
+            this.logger.debug(formatCompact({ name: fresh.name, reload_ms: Date.now() - now }));
         }
-        catch (err) {
-            this.logger.error(formatCompact({
-                name: p.name,
-                reload: false,
-                error: err instanceof Error ? err.message : String(err),
-                hint: 'full_restart',
-            }));
-            throw err;
+        finally {
+            p._reloading = false;
         }
-        await fresh.broadcast('mounted');
-        this.logger.debug(formatCompact({ name: fresh.name, reload_ms: Date.now() - now }));
     }
     /**
      * 监听文件变化（Plugin 类型窄化版本）
@@ -615,14 +499,22 @@ export class Plugin extends PluginBase {
     watch(callback, recursive = false) {
         if (!this.filePath || this.filePath.includes("node_modules"))
             return;
-        const unwatch = watchFile(this.filePath, () => {
-            const newHash = getFileHash(this.filePath);
-            if (newHash === this.fileHash)
-                return;
-            this.logger.debug(`Plugin "${this.name}" file changed, reloading...`);
-            callback(this);
-            this.fileHash = newHash;
-        });
+        const unwatch = watchFile(this.filePath, (() => {
+            let debounceTimer = null;
+            return () => {
+                if (debounceTimer)
+                    clearTimeout(debounceTimer);
+                debounceTimer = setTimeout(() => {
+                    debounceTimer = null;
+                    const newHash = getFileHash(this.filePath);
+                    if (newHash === this.fileHash)
+                        return;
+                    this.logger.debug(`Plugin "${this.name}" file changed, reloading...`);
+                    callback(this);
+                    this.fileHash = newHash;
+                }, 300);
+            };
+        })());
         this.on("dispose", unwatch);
         if (recursive) {
             for (const child of this.children) {
@@ -676,6 +568,10 @@ export class Plugin extends PluginBase {
         plugin.fileHash = getFileHash(entryFile);
         // 先记录，防止循环依赖时重复加载
         loadedModules.set(realPath, plugin);
+        // 注意：?t= cache-busting 会导致 Node ESM 模块缓存累积旧条目。
+        // 这是 Node.js ESM 的已知限制——没有公开 API 可以逐出 ESM 模块缓存。
+        // 在生产环境中插件只加载一次，不会触发此问题；
+        // 开发环境中热重载会累积，但仅影响开发进程，重启即释放。
         await storage.run(plugin, async () => {
             await import(`${pathToFileURL(entryFile).href}?t=${Date.now()}`);
         });
@@ -685,4 +581,3 @@ export class Plugin extends PluginBase {
 export function defineContext(options) {
     return options;
 }
-//# sourceMappingURL=plugin.js.map

package/lib/request.d.ts

@@ -1,85 +1,41 @@
-import { Adapters } from './adapter.js';
-import type { MessageSender, MaybePromise } from './types.js';
+import type { MaybePromise } from './types.js';
+import type { Adapters } from './adapter.js';
+import type { RequestKind } from './side-event/types.js';
+import type { SideEventBase } from './side-event/base.js';
+export type { RequestKind, ComposedRequestName } from './side-event/types.js';
 /**
- * 请求类型枚举
- *
- * 常见 IM 请求事件分类：
- * - friend_add:  好友添加请求
- * - group_add:   主动申请入群
- * - group_invite: 邀请入群请求
- *
- * 适配器可自行扩展更多子类型
- */
-export type RequestType = 'friend_add' | 'group_add' | 'group_invite' | (string & {});
-/**
- * 请求频道信息
- */
-export interface RequestChannel {
-    id: string;
-    type: 'group' | 'private' | 'channel';
-}
-/**
- * 请求基础结构
- *
- * 与 MessageBase / NoticeBase 同构设计。
- * 核心区别：Request 提供 `$approve()` 和 `$reject()` 方法，用于快速处理请求。
+ * 请求基础结构 — 继承 SideEventBase，附加审批方法。
  *
  * @example
  * ```typescript
- * // 适配器中格式化请求
  * const request = Request.from(rawEvent, {
  *   $id: rawEvent.flag,
  *   $adapter: 'icqq',
- *   $bot: botName,
- *   $type: 'group_invite',
- *   $channel: { id: groupId, type: 'group' },
- *   $sender: { id: userId, name: '邀请者' },
+ *   $endpoint: endpointKey,
+ *   $type: 'request',
+ *   $scene_id: groupId,
+ *   $scene_type: 'group',
+ *   $sub_type: 'invite',
+ *   $actor: { id: userId, name: '邀请者' },
  *   $comment: '请求加群消息',
  *   $timestamp: Date.now(),
  *   $approve: async (remark?) => { await api.approve(flag, remark); },
  *   $reject: async (reason?) => { await api.reject(flag, reason); },
  * });
+ * // formatSideEventName(request) === 'request.group.invite'
  * this.adapter.emit('request.receive', request);
  * ```
  */
-export interface RequestBase {
-    /** 请求唯一 ID / flag（平台提供的请求标识，用于后续处理） */
-    $id: string;
-    /** 适配器名称 */
+export interface RequestBase extends SideEventBase {
     $adapter: keyof Adapters;
-    /** Bot 名称 */
-    $bot: string;
-    /** 请求类型 */
-    $type: RequestType;
-    /** 请求子类型 */
-    $subType?: string;
-    /** 请求发生的频道/群/会话 */
-    $channel: RequestChannel;
-    /** 请求发送者 */
-    $sender: MessageSender;
-    /** 请求附言/验证消息 */
+    $type: RequestKind;
+    /** 主参与者（必填） */
+    $actor: NonNullable<SideEventBase['$actor']>;
     $comment?: string;
-    /** 请求时间戳 */
-    $timestamp: number;
-    /**
-     * 同意请求
-     * @param remark 备注信息（如好友备注）
-     */
     $approve(remark?: string): MaybePromise<void>;
-    /**
-     * 拒绝请求
-     * @param reason 拒绝原因
-     */
     $reject(reason?: string): MaybePromise<void>;
 }
-/**
- * 完整请求类型，支持平台原始数据扩展
- */
 export type Request<T extends object = {}> = RequestBase & T;
 export declare namespace Request {
-    /**
-     * 工具方法：合并自定义字段与基础请求结构
-     */
     function from<T extends object>(input: T, format: RequestBase): Request<T>;
 }
-//# sourceMappingURL=request.d.ts.map

package/lib/request.js

@@ -1,11 +1,7 @@
 export var Request;
 (function (Request) {
-    /**
-     * 工具方法：合并自定义字段与基础请求结构
-     */
     function from(input, format) {
         return Object.assign(input, format);
     }
     Request.from = from;
 })(Request || (Request = {}));
-//# sourceMappingURL=request.js.map

package/lib/{prompt.d.ts → schema-interaction.d.ts}

@@ -5,10 +5,10 @@ import { Schema } from '@zhin.js/schema';
 /**
  * Prompt类：用于实现机器人与用户的交互式提问与输入收集。
  * 支持文本、数字、确认、列表、选项、Schema等多种输入类型，自动处理超时、默认值、格式化等。
- * 典型用法：await new Prompt(plugin, event).text('请输入内容')
+ * 典型用法：await new SchemaInteraction(plugin, event).text('请输入内容')
  * @template P 适配器类型
  */
-export declare class Prompt<P extends RegisteredAdapter> {
+export declare class SchemaInteraction<P extends RegisteredAdapter> {
     private plugin;
     private event;
     /**
@@ -25,7 +25,7 @@ export declare class Prompt<P extends RegisteredAdapter> {
      * 通用提问方法，支持自定义格式化、超时、默认值等
      * @param config 提问配置
      */
-    private prompt;
+    private collect;
     /**
      * 注册一次性消息中间件，等待用户输入或超时
      * @param callback 输入回调
@@ -52,7 +52,7 @@ export declare class Prompt<P extends RegisteredAdapter> {
     /**
      * 列表输入，支持多值分隔
      */
-    list<T extends Prompt.SingleType = 'text'>(tips: string, config?: Prompt.ListConfig<T>, timeoutText?: string): Promise<Prompt.Result<T>[]>;
+    list<T extends SchemaInteraction.SingleType = 'text'>(tips: string, config?: SchemaInteraction.ListConfig<T>, timeoutText?: string): Promise<SchemaInteraction.Result<T>[]>;
     /**
      * 返回常量值（用于Schema）
      */
@@ -60,7 +60,7 @@ export declare class Prompt<P extends RegisteredAdapter> {
     /**
      * 选项选择，支持单选/多选
      */
-    pick<T extends Prompt.SingleType, M extends boolean = false>(tips: string, config: Prompt.PickConfig<T, M>, timeoutText?: string): Promise<Prompt.PickResult<T, M>>;
+    pick<T extends SchemaInteraction.SingleType, M extends boolean = false>(tips: string, config: SchemaInteraction.PickConfig<T, M>, timeoutText?: string): Promise<SchemaInteraction.PickResult<T, M>>;
     /**
      * 基于Schema的选项选择
      */
@@ -79,7 +79,7 @@ export declare class Prompt<P extends RegisteredAdapter> {
 /**
  * Prompt命名空间：类型辅助定义
  */
-export declare namespace Prompt {
+export declare namespace SchemaInteraction {
     interface SingleMap {
         text: string;
         number: number;
@@ -115,4 +115,3 @@ export declare namespace Prompt {
     };
     export {};
 }
-//# sourceMappingURL=prompt.d.ts.map