@opentiny/next-sdk 0.2.8 → 0.2.10

package/dist/page-tools/bridge.d.ts

@@ -64,6 +64,29 @@ type RegisterToolConfig<InputArgs extends ZodRawShape, OutputArgs extends ZodRaw
 export type PageAwareServer = Omit<WebMcpServer, 'registerTool'> & {
     registerTool<InputArgs extends ZodRawShape, OutputArgs extends ZodRawShape>(name: string, config: RegisterToolConfig<InputArgs, OutputArgs>, handlerOrRoute: ((...args: any[]) => any) | RouteConfig): RegisteredTool;
 };
+/**
+ * 注册一个通用的页面跳转工具（navigate_to_page），供大模型在需要时主动跳转到指定路由。
+ *
+ * 要求：
+ * - 业务侧在应用入口通过 setNavigator 注册导航函数（如 router.push 或 navigateByUrl）
+ * - 前端页面在目标路由下调用 registerPageTool，确保 page-ready 能正确广播
+ *
+ * 工具行为：
+ * - 输入 path（如 "/orders"、"/price-protection"），调用 setNavigator 注册的函数执行跳转
+ * - 等待目标页面完成挂载并广播 page-ready（或在超时时间到达时兜底返回）
+ * - 返回简单的文本说明，提示跳转结果
+ */
+export type NavigateToolOptions = {
+    /** 工具名称，默认 'navigate_to_page' */
+    name?: string;
+    /** 工具标题，默认 '页面跳转' */
+    title?: string;
+    /** 工具描述 */
+    description?: string;
+    /** 等待 page-ready 的超时时间（ms），默认 1500 */
+    timeoutMs?: number;
+};
+export declare function registerNavigateTool(server: WebMcpServer, options?: NavigateToolOptions): RegisteredTool;
 /**
  * 包装 WebMcpServer，使 registerTool 第三个参数支持 RouteConfig。
  *

package/dist/remoter/createRemoter.d.ts

@@ -49,8 +49,9 @@ declare class FloatingBlock {
     private renderItem;
     /**
      * 合并菜单项配置。
-     * - 有 sessionId：使用默认菜单 + 用户配置（可定制每一项的 show/text/icon 等）
-     * - 无 sessionId：不渲染任何下拉菜单，仅保留点击浮标打开对话框的能力
+     * - 用户明确传入 menuItems：直接使用用户配置，不受 sessionId 限制；未传 icon 时自动补充默认图标
+     * - 有 sessionId 且未传 menuItems：使用默认菜单
+     * - 无 sessionId 且未传 menuItems：不渲染任何下拉菜单，仅保留点击浮标打开对话框的能力
      */
     private mergeMenuItems;
     private init;