@opentiny/next-sdk 0.2.6 → 0.2.7

package/dist/index.umd.dev.js

@@ -3087,7 +3087,7 @@
     if (hasRequiredUtils$2) return utils$2;
     hasRequiredUtils$2 = 1;
     const isUUID = RegExp.prototype.test.bind(/^[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$/iu);
-    const isIPv4 = RegExp.prototype.test.bind(/^(?:(?:25[0-5]|2[0-4]\d|1\d{2}|[1-9]\d|\d)\.){3}(?:25[0-5]|2[0-4]\d|1\d{2}|[1-9]\d|\d)$/u);
+    const isIPv42 = RegExp.prototype.test.bind(/^(?:(?:25[0-5]|2[0-4]\d|1\d{2}|[1-9]\d|\d)\.){3}(?:25[0-5]|2[0-4]\d|1\d{2}|[1-9]\d|\d)$/u);
     function stringArrayToHexStripped(input) {
       let acc = "";
       let code2 = 0;
@@ -3310,7 +3310,7 @@
       }
       if (component.host !== void 0) {
         let host = unescape(component.host);
-        if (!isIPv4(host)) {
+        if (!isIPv42(host)) {
           const ipV6res = normalizeIPv6(host);
           if (ipV6res.isIPV6 === true) {
             host = `[${ipV6res.escapedHost}]`;
@@ -3331,7 +3331,7 @@
       recomposeAuthority,
       normalizeComponentEncoding,
       removeDotSegments,
-      isIPv4,
+      isIPv4: isIPv42,
       isUUID,
       normalizeIPv6,
       stringArrayToHexStripped
@@ -3552,7 +3552,7 @@
   function requireFastUri() {
     if (hasRequiredFastUri) return fastUri.exports;
     hasRequiredFastUri = 1;
-    const { normalizeIPv6, removeDotSegments, recomposeAuthority, normalizeComponentEncoding, isIPv4, nonSimpleDomain } = requireUtils$2();
+    const { normalizeIPv6, removeDotSegments, recomposeAuthority, normalizeComponentEncoding, isIPv4: isIPv42, nonSimpleDomain } = requireUtils$2();
     const { SCHEMES, getSchemeHandler } = requireSchemes();
     function normalize(uri2, options) {
       if (typeof uri2 === "string") {
@@ -3733,7 +3733,7 @@
           parsed.port = matches[5];
         }
         if (parsed.host) {
-          const ipv4result = isIPv4(parsed.host);
+          const ipv4result = isIPv42(parsed.host);
           if (ipv4result === false) {
             const ipv6result = normalizeIPv6(parsed.host);
             parsed.host = ipv6result.host.toLowerCase();
@@ -26986,10 +26986,11 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
   const DEFAULT_QR_CODE_URL = "https://ai.opentiny.design/next-remoter";
   const DEFAULT_LOGO_URL = "https://ai.opentiny.design/next-remoter/svgs/logo-next-no-bg-left.svg";
   const getDefaultMenuItems = (options) => {
-    return [
+    const hasSession = !!options.sessionId;
+    const baseItems = [
       {
         action: "qr-code",
-        show: true,
+        show: hasSession,
         text: "扫码登录",
         desc: "使用手机遥控页面",
         icon: qrCode
@@ -27003,7 +27004,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       },
       {
         action: "remote-url",
-        show: true,
+        show: hasSession,
         text: `遥控器链接`,
         desc: `${options.remoteUrl}`,
         active: true,
@@ -27013,14 +27014,15 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       },
       {
         action: "remote-control",
-        show: true,
+        show: hasSession,
         text: `识别码`,
-        desc: `${options.sessionId.slice(-6)}`,
+        desc: hasSession ? `${options.sessionId.slice(-6)}` : "",
         know: true,
         showCopyIcon: true,
         icon: scan
       }
     ];
+    return baseItems;
   };
   class FloatingBlock {
     constructor(options) {
@@ -27052,9 +27054,6 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
           trigger: "hover"
         });
       };
-      if (!options.sessionId) {
-        throw new Error("sessionId is required");
-      }
       this.options = {
         ...options,
         qrCodeUrl: options.qrCodeUrl || DEFAULT_QR_CODE_URL,
@@ -27073,11 +27072,14 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       return this.options.qrCodeUrl?.includes("?") ? "&sessionId=" : "?sessionId=";
     }
     /**
-     * 合并菜单项配置
-     * @param userMenuItems 用户自定义菜单项配置
-     * @returns 合并后的菜单项配置
+     * 合并菜单项配置。
+     * - 有 sessionId：使用默认菜单 + 用户配置（可定制每一项的 show/text/icon 等）
+     * - 无 sessionId：不渲染任何下拉菜单，仅保留点击浮标打开对话框的能力
      */
     mergeMenuItems(userMenuItems) {
+      if (!this.options.sessionId) {
+        return [];
+      }
       if (!userMenuItems) {
         return getDefaultMenuItems(this.options);
       }
@@ -27087,7 +27089,6 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
           return {
             ...defaultItem,
             ...userItem,
-            // 确保show属性存在，默认为true
             show: userItem.show !== void 0 ? userItem.show : defaultItem.show
           };
         }
@@ -27231,9 +27232,11 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       this.closeDropdown();
     }
     copyRemoteControl() {
+      if (!this.options.sessionId) return;
       this.copyToClipboard(this.options.sessionId.slice(-6));
     }
     copyRemoteURL() {
+      if (!this.options.sessionId) return;
       this.copyToClipboard(this.options.remoteUrl + this.sessionPrefix + this.options.sessionId);
     }
     // 实现复制到剪贴板功能
@@ -27281,8 +27284,9 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
         }, 300);
       }, 1500);
     }
-    // 创建二维码弹窗
+    // 创建二维码弹窗（无 sessionId 时不展示）
     async showQRCode() {
+      if (!this.options.sessionId) return;
       const qrCode2 = new QrCode((this.options.qrCodeUrl || "") + this.sessionPrefix + this.options.sessionId, {});
       const base642 = await qrCode2.toDataURL();
       const modal = this.createModal(
@@ -28053,25 +28057,30 @@ Error message: ${getErrorMessage$2(cause)}`,
   }
   function createToolNameMapping({
     tools = [],
-    providerToolNames
+    providerToolNames,
+    resolveProviderToolName
   }) {
+    var _a22;
     const customToolNameToProviderToolName = {};
     const providerToolNameToCustomToolName = {};
     for (const tool2 of tools) {
-      if (tool2.type === "provider" && tool2.id in providerToolNames) {
-        const providerToolName = providerToolNames[tool2.id];
+      if (tool2.type === "provider") {
+        const providerToolName = (_a22 = resolveProviderToolName == null ? void 0 : resolveProviderToolName(tool2)) != null ? _a22 : tool2.id in providerToolNames ? providerToolNames[tool2.id] : void 0;
+        if (providerToolName == null) {
+          continue;
+        }
         customToolNameToProviderToolName[tool2.name] = providerToolName;
         providerToolNameToCustomToolName[providerToolName] = tool2.name;
       }
     }
     return {
       toProviderToolName: (customToolName) => {
-        var _a22;
-        return (_a22 = customToolNameToProviderToolName[customToolName]) != null ? _a22 : customToolName;
+        var _a32;
+        return (_a32 = customToolNameToProviderToolName[customToolName]) != null ? _a32 : customToolName;
       },
       toCustomToolName: (providerToolName) => {
-        var _a22;
-        return (_a22 = providerToolNameToCustomToolName[providerToolName]) != null ? _a22 : providerToolName;
+        var _a32;
+        return (_a32 = providerToolNameToCustomToolName[providerToolName]) != null ? _a32 : providerToolName;
       }
     };
   }
@@ -28264,8 +28273,103 @@ Error message: ${getErrorMessage$2(cause)}`,
     }
     return result;
   }
+  function validateDownloadUrl(url2) {
+    let parsed;
+    try {
+      parsed = new URL(url2);
+    } catch (e) {
+      throw new DownloadError({
+        url: url2,
+        message: `Invalid URL: ${url2}`
+      });
+    }
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+      throw new DownloadError({
+        url: url2,
+        message: `URL scheme must be http or https, got ${parsed.protocol}`
+      });
+    }
+    const hostname2 = parsed.hostname;
+    if (!hostname2) {
+      throw new DownloadError({
+        url: url2,
+        message: `URL must have a hostname`
+      });
+    }
+    if (hostname2 === "localhost" || hostname2.endsWith(".local") || hostname2.endsWith(".localhost")) {
+      throw new DownloadError({
+        url: url2,
+        message: `URL with hostname ${hostname2} is not allowed`
+      });
+    }
+    if (hostname2.startsWith("[") && hostname2.endsWith("]")) {
+      const ipv62 = hostname2.slice(1, -1);
+      if (isPrivateIPv6(ipv62)) {
+        throw new DownloadError({
+          url: url2,
+          message: `URL with IPv6 address ${hostname2} is not allowed`
+        });
+      }
+      return;
+    }
+    if (isIPv4(hostname2)) {
+      if (isPrivateIPv4(hostname2)) {
+        throw new DownloadError({
+          url: url2,
+          message: `URL with IP address ${hostname2} is not allowed`
+        });
+      }
+      return;
+    }
+  }
+  function isIPv4(hostname2) {
+    const parts = hostname2.split(".");
+    if (parts.length !== 4) return false;
+    return parts.every((part) => {
+      const num = Number(part);
+      return Number.isInteger(num) && num >= 0 && num <= 255 && String(num) === part;
+    });
+  }
+  function isPrivateIPv4(ip) {
+    const parts = ip.split(".").map(Number);
+    const [a, b] = parts;
+    if (a === 0) return true;
+    if (a === 10) return true;
+    if (a === 127) return true;
+    if (a === 169 && b === 254) return true;
+    if (a === 172 && b >= 16 && b <= 31) return true;
+    if (a === 192 && b === 168) return true;
+    return false;
+  }
+  function isPrivateIPv6(ip) {
+    const normalized = ip.toLowerCase();
+    if (normalized === "::1") return true;
+    if (normalized === "::") return true;
+    if (normalized.startsWith("::ffff:")) {
+      const mappedPart = normalized.slice(7);
+      if (isIPv4(mappedPart)) {
+        return isPrivateIPv4(mappedPart);
+      }
+      const hexParts = mappedPart.split(":");
+      if (hexParts.length === 2) {
+        const high = parseInt(hexParts[0], 16);
+        const low = parseInt(hexParts[1], 16);
+        if (!isNaN(high) && !isNaN(low)) {
+          const a = high >> 8 & 255;
+          const b = high & 255;
+          const c = low >> 8 & 255;
+          const d = low & 255;
+          return isPrivateIPv4(`${a}.${b}.${c}.${d}`);
+        }
+      }
+    }
+    if (normalized.startsWith("fc") || normalized.startsWith("fd")) return true;
+    if (normalized.startsWith("fe80")) return true;
+    return false;
+  }
   async function downloadBlob(url2, options) {
     var _a22, _b22;
+    validateDownloadUrl(url2);
     try {
       const response = await fetch(url2, {
         signal: options == null ? void 0 : options.abortSignal
@@ -28431,7 +28535,7 @@ Error message: ${getErrorMessage$2(cause)}`,
     );
     return Object.fromEntries(normalizedHeaders.entries());
   }
-  var VERSION$7 = "4.0.15";
+  var VERSION$7 = "4.0.19";
   var getOriginalFetch = () => globalThis.fetch;
   var getFromApi = async ({
     url: url2,
@@ -28574,8 +28678,8 @@ Error message: ${getErrorMessage$2(cause)}`,
       "x-m4a": "m4a"
     }[subtype]) != null ? _a22 : subtype;
   }
-  var suspectProtoRx$1 = /"__proto__"\s*:/;
-  var suspectConstructorRx$1 = /"constructor"\s*:/;
+  var suspectProtoRx$1 = /"(?:_|\\u005[Ff])(?:_|\\u005[Ff])(?:p|\\u0070)(?:r|\\u0072)(?:o|\\u006[Ff])(?:t|\\u0074)(?:o|\\u006[Ff])(?:_|\\u005[Ff])(?:_|\\u005[Ff])"\s*:/;
+  var suspectConstructorRx$1 = /"(?:c|\\u0063)(?:o|\\u006[Ff])(?:n|\\u006[Ee])(?:s|\\u0073)(?:t|\\u0074)(?:r|\\u0072)(?:u|\\u0075)(?:c|\\u0063)(?:t|\\u0074)(?:o|\\u006[Ff])(?:r|\\u0072)"\s*:/;
   function _parse$1(text2) {
     const obj = JSON.parse(text2);
     if (obj === null || typeof obj !== "object") {
@@ -28595,7 +28699,7 @@ Error message: ${getErrorMessage$2(cause)}`,
         if (Object.prototype.hasOwnProperty.call(node, "__proto__")) {
           throw new SyntaxError("Object contains forbidden prototype property");
         }
-        if (Object.prototype.hasOwnProperty.call(node, "constructor") && Object.prototype.hasOwnProperty.call(node.constructor, "prototype")) {
+        if (Object.prototype.hasOwnProperty.call(node, "constructor") && node.constructor !== null && typeof node.constructor === "object" && Object.prototype.hasOwnProperty.call(node.constructor, "prototype")) {
           throw new SyntaxError("Object contains forbidden prototype property");
         }
         for (const key in node) {
@@ -30082,6 +30186,33 @@ Error message: ${getErrorMessage$2(cause)}`,
   function dynamicTool(tool2) {
     return { ...tool2, type: "dynamic" };
   }
+  function createProviderToolFactory({
+    id: id2,
+    inputSchema
+  }) {
+    return ({
+      execute,
+      outputSchema: outputSchema2,
+      needsApproval,
+      toModelOutput,
+      onInputStart,
+      onInputDelta,
+      onInputAvailable,
+      ...args
+    }) => tool({
+      type: "provider",
+      id: id2,
+      args,
+      inputSchema,
+      outputSchema: outputSchema2,
+      execute,
+      needsApproval,
+      toModelOutput,
+      onInputStart,
+      onInputDelta,
+      onInputAvailable
+    });
+  }
   function createProviderToolFactoryWithOutputSchema({
     id: id2,
     inputSchema,
@@ -31552,7 +31683,7 @@ Run 'npx vercel link' to link your project, then 'vc env pull' to fetch the toke
     var _a92;
     return (_a92 = indexBrowserExports.getContext().headers) == null ? void 0 : _a92["x-vercel-id"];
   }
-  var VERSION$6 = "3.0.58";
+  var VERSION$6 = "3.0.66";
   var AI_GATEWAY_PROTOCOL_VERSION = "0.0.1";
   function createGatewayProvider(options = {}) {
     var _a92, _b9;
@@ -33079,6 +33210,8 @@ Run 'npx vercel link' to link your project, then 'vc env pull' to fetch the toke
   }
   async function notify(options) {
     for (const callback of asArray(options.callbacks)) {
+      if (callback == null)
+        continue;
       try {
         await callback(options.event);
       } catch (_ignored) {
@@ -33385,7 +33518,7 @@ Run 'npx vercel link' to link your project, then 'vc env pull' to fetch the toke
     }
     return void 0;
   }
-  var VERSION$4 = "6.0.104";
+  var VERSION$4 = "6.0.116";
   var download = async ({
     url: url2,
     maxBytes,
@@ -33393,6 +33526,7 @@ Run 'npx vercel link' to link your project, then 'vc env pull' to fetch the toke
   }) => {
     var _a21;
     const urlText = url2.toString();
+    validateDownloadUrl(urlText);
     try {
       const response = await fetch(urlText, {
         headers: withUserAgentSuffix$1(
@@ -34498,6 +34632,44 @@ Learn more: \x1B[34m${moreInfoURL}\x1B[0m
       }))
     );
   }
+  function getGlobalTelemetryIntegrations() {
+    var _a21;
+    return (_a21 = globalThis.AI_SDK_TELEMETRY_INTEGRATIONS) != null ? _a21 : [];
+  }
+  function getGlobalTelemetryIntegration() {
+    const globalIntegrations = getGlobalTelemetryIntegrations();
+    return (integrations) => {
+      const localIntegrations = asArray(integrations);
+      const allIntegrations = [...globalIntegrations, ...localIntegrations];
+      function createTelemetryComposite(getListenerFromIntegration) {
+        const listeners = allIntegrations.map(getListenerFromIntegration).filter(Boolean);
+        return async (event) => {
+          for (const listener of listeners) {
+            try {
+              await listener(event);
+            } catch (_ignored) {
+            }
+          }
+        };
+      }
+      return {
+        onStart: createTelemetryComposite((integration) => integration.onStart),
+        onStepStart: createTelemetryComposite(
+          (integration) => integration.onStepStart
+        ),
+        onToolCallStart: createTelemetryComposite(
+          (integration) => integration.onToolCallStart
+        ),
+        onToolCallFinish: createTelemetryComposite(
+          (integration) => integration.onToolCallFinish
+        ),
+        onStepFinish: createTelemetryComposite(
+          (integration) => integration.onStepFinish
+        ),
+        onFinish: createTelemetryComposite((integration) => integration.onFinish)
+      };
+    };
+  }
   function asLanguageModelUsage(usage) {
     return {
       inputTokens: usage.inputTokens.total,
@@ -36048,6 +36220,7 @@ Learn more: \x1B[34m${moreInfoURL}\x1B[0m
     ...settings
   }) {
     const model = resolveLanguageModel(modelArg);
+    const createGlobalTelemetry = getGlobalTelemetryIntegration();
     const stopConditions = asArray(stopWhen);
     const totalTimeoutMs = getTotalTimeoutMs(timeout);
     const stepTimeoutMs = getStepTimeoutMs(timeout);
@@ -36078,6 +36251,7 @@ Learn more: \x1B[34m${moreInfoURL}\x1B[0m
       prompt,
       messages
     });
+    const globalTelemetry = createGlobalTelemetry(telemetry == null ? void 0 : telemetry.integrations);
     await notify({
       event: {
         model: modelInfo,
@@ -36107,7 +36281,10 @@ Learn more: \x1B[34m${moreInfoURL}\x1B[0m
         metadata: telemetry == null ? void 0 : telemetry.metadata,
         experimental_context
       },
-      callbacks: onStart
+      callbacks: [
+        onStart,
+        globalTelemetry.onStart
+      ]
     });
     const tracer = getTracer(telemetry);
     try {
@@ -36152,8 +36329,14 @@ Learn more: \x1B[34m${moreInfoURL}\x1B[0m
               experimental_context,
               stepNumber: 0,
               model: modelInfo,
-              onToolCallStart,
-              onToolCallFinish
+              onToolCallStart: [
+                onToolCallStart,
+                globalTelemetry.onToolCallStart
+              ],
+              onToolCallFinish: [
+                onToolCallFinish,
+                globalTelemetry.onToolCallFinish
+              ]
             });
             const toolContent = [];
             for (const output2 of toolOutputs) {
@@ -36162,7 +36345,7 @@ Learn more: \x1B[34m${moreInfoURL}\x1B[0m
                 input: output2.input,
                 tool: tools == null ? void 0 : tools[output2.toolName],
                 output: output2.type === "tool-result" ? output2.output : output2.error,
-                errorMode: output2.type === "tool-error" ? "json" : "none"
+                errorMode: output2.type === "tool-error" ? "text" : "none"
               });
               toolContent.push({
                 type: "tool-result",
@@ -36279,7 +36462,10 @@ Learn more: \x1B[34m${moreInfoURL}\x1B[0m
                   metadata: telemetry == null ? void 0 : telemetry.metadata,
                   experimental_context
                 },
-                callbacks: onStepStart
+                callbacks: [
+                  onStepStart,
+                  globalTelemetry.onStepStart
+                ]
               });
               currentModelResponse = await retry(
                 () => {
@@ -36457,8 +36643,14 @@ Learn more: \x1B[34m${moreInfoURL}\x1B[0m
                     experimental_context,
                     stepNumber: steps.length,
                     model: stepModelInfo,
-                    onToolCallStart,
-                    onToolCallFinish
+                    onToolCallStart: [
+                      onToolCallStart,
+                      globalTelemetry.onToolCallStart
+                    ],
+                    onToolCallFinish: [
+                      onToolCallFinish,
+                      globalTelemetry.onToolCallFinish
+                    ]
                   })
                 );
               }
@@ -36525,7 +36717,10 @@ Learn more: \x1B[34m${moreInfoURL}\x1B[0m
                 model: stepModelInfo.modelId
               });
               steps.push(currentStepResult);
-              await notify({ event: currentStepResult, callbacks: onStepFinish });
+              await notify({
+                event: currentStepResult,
+                callbacks: [onStepFinish, globalTelemetry.onStepFinish]
+              });
             } finally {
               if (stepTimeoutId != null) {
                 clearTimeout(stepTimeoutId);
@@ -36606,7 +36801,10 @@ Learn more: \x1B[34m${moreInfoURL}\x1B[0m
               steps,
               totalUsage
             },
-            callbacks: onFinish
+            callbacks: [
+              onFinish,
+              globalTelemetry.onFinish
+            ]
           });
           let resolvedOutput;
           if (lastStep.finishReason === "stop") {
@@ -37225,7 +37423,8 @@ Learn more: \x1B[34m${moreInfoURL}\x1B[0m
                 state.message.parts.push({
                   type: "file",
                   mediaType: chunk.mediaType,
-                  url: chunk.url
+                  url: chunk.url,
+                  ...chunk.providerMetadata != null ? { providerMetadata: chunk.providerMetadata } : {}
                 });
                 write();
                 break;
@@ -37882,7 +38081,8 @@ Learn more: \x1B[34m${moreInfoURL}\x1B[0m
               file: new DefaultGeneratedFileWithType({
                 data: chunk.data,
                 mediaType: chunk.mediaType
-              })
+              }),
+              ...chunk.providerMetadata != null ? { providerMetadata: chunk.providerMetadata } : {}
             });
             break;
           }
@@ -38270,6 +38470,8 @@ Learn more: \x1B[34m${moreInfoURL}\x1B[0m
       this.outputSpecification = output;
       this.includeRawChunks = includeRawChunks;
       this.tools = tools;
+      const createGlobalTelemetry = getGlobalTelemetryIntegration();
+      const globalTelemetry = createGlobalTelemetry(telemetry == null ? void 0 : telemetry.integrations);
       let stepFinish;
       let recordedContent = [];
       const recordedResponseMessages = [];
@@ -38371,7 +38573,11 @@ Learn more: \x1B[34m${moreInfoURL}\x1B[0m
             delete activeReasoningContent[part.id];
           }
           if (part.type === "file") {
-            recordedContent.push({ type: "file", file: part.file });
+            recordedContent.push({
+              type: "file",
+              file: part.file,
+              ...part.providerMetadata != null ? { providerMetadata: part.providerMetadata } : {}
+            });
           }
           if (part.type === "source") {
             recordedContent.push(part);
@@ -38417,7 +38623,10 @@ Learn more: \x1B[34m${moreInfoURL}\x1B[0m
               },
               providerMetadata: part.providerMetadata
             });
-            await notify({ event: currentStepResult, callbacks: onStepFinish });
+            await notify({
+              event: currentStepResult,
+              callbacks: [onStepFinish, globalTelemetry.onStepFinish]
+            });
             logWarnings({
               warnings: recordedWarnings,
               provider: modelInfo.provider,
@@ -38481,7 +38690,10 @@ Learn more: \x1B[34m${moreInfoURL}\x1B[0m
                 providerMetadata: finalStep.providerMetadata,
                 steps: recordedSteps
               },
-              callbacks: onFinish
+              callbacks: [
+                onFinish,
+                globalTelemetry.onFinish
+              ]
             });
             rootSpan.setAttributes(
               await selectTelemetryAttributes({
@@ -38638,7 +38850,10 @@ Learn more: \x1B[34m${moreInfoURL}\x1B[0m
               ...callbackTelemetryProps,
               experimental_context
             },
-            callbacks: onStart
+            callbacks: [
+              onStart,
+              globalTelemetry.onStart
+            ]
           });
           const initialMessages = initialPrompt.messages;
           const initialResponseMessages = [];
@@ -38688,8 +38903,14 @@ Learn more: \x1B[34m${moreInfoURL}\x1B[0m
                     experimental_context,
                     stepNumber: recordedSteps.length,
                     model: modelInfo,
-                    onToolCallStart,
-                    onToolCallFinish,
+                    onToolCallStart: [
+                      onToolCallStart,
+                      globalTelemetry.onToolCallStart
+                    ],
+                    onToolCallFinish: [
+                      onToolCallFinish,
+                      globalTelemetry.onToolCallFinish
+                    ],
                     onPreliminaryToolResult: (result2) => {
                       toolExecutionStepStreamController == null ? void 0 : toolExecutionStepStreamController.enqueue(result2);
                     }
@@ -38726,7 +38947,7 @@ Learn more: \x1B[34m${moreInfoURL}\x1B[0m
                       input: output2.input,
                       tool: tools == null ? void 0 : tools[output2.toolName],
                       output: output2.type === "tool-result" ? output2.output : output2.error,
-                      errorMode: output2.type === "tool-error" ? "json" : "none"
+                      errorMode: output2.type === "tool-error" ? "text" : "none"
                     })
                   });
                 }
@@ -38840,7 +39061,10 @@ Learn more: \x1B[34m${moreInfoURL}\x1B[0m
                   ...callbackTelemetryProps,
                   experimental_context
                 },
-                callbacks: onStepStart
+                callbacks: [
+                  onStepStart,
+                  globalTelemetry.onStepStart
+                ]
               });
               const {
                 result: { stream: stream2, response, request },
@@ -38916,8 +39140,14 @@ Learn more: \x1B[34m${moreInfoURL}\x1B[0m
                 generateId: generateId2,
                 stepNumber: recordedSteps.length,
                 model: stepModelInfo,
-                onToolCallStart,
-                onToolCallFinish
+                onToolCallStart: [
+                  onToolCallStart,
+                  globalTelemetry.onToolCallStart
+                ],
+                onToolCallFinish: [
+                  onToolCallFinish,
+                  globalTelemetry.onToolCallFinish
+                ]
               });
               const stepRequest = ((_i = include == null ? void 0 : include.requestBody) != null ? _i : true) ? request != null ? request : {} : { ...request, body: void 0 };
               const stepToolCalls = [];
@@ -39499,7 +39729,8 @@ Learn more: \x1B[34m${moreInfoURL}\x1B[0m
                 controller.enqueue({
                   type: "file",
                   mediaType: part.file.mediaType,
-                  url: `data:${part.file.mediaType};base64,${part.file.base64}`
+                  url: `data:${part.file.mediaType};base64,${part.file.base64}`,
+                  ...part.providerMetadata != null ? { providerMetadata: part.providerMetadata } : {}
                 });
                 break;
               }
@@ -41821,7 +42052,7 @@ Learn more: \x1B[34m${moreInfoURL}\x1B[0m
   function getOpenAILanguageModelCapabilities(modelId) {
     const supportsFlexProcessing = modelId.startsWith("o3") || modelId.startsWith("o4-mini") || modelId.startsWith("gpt-5") && !modelId.startsWith("gpt-5-chat");
     const supportsPriorityProcessing = modelId.startsWith("gpt-4") || modelId.startsWith("gpt-5-mini") || modelId.startsWith("gpt-5") && !modelId.startsWith("gpt-5-nano") && !modelId.startsWith("gpt-5-chat") || modelId.startsWith("o3") || modelId.startsWith("o4-mini");
-    const isReasoningModel = modelId.startsWith("o1") || modelId.startsWith("o3") || modelId.startsWith("o4-mini") || modelId.startsWith("codex-mini") || modelId.startsWith("computer-use-preview") || modelId.startsWith("gpt-5") && !modelId.startsWith("gpt-5-chat");
+    const isReasoningModel = modelId.startsWith("o1") || modelId.startsWith("o3") || modelId.startsWith("o4-mini") || modelId.startsWith("gpt-5") && !modelId.startsWith("gpt-5-chat");
     const supportsNonReasoningParameters = modelId.startsWith("gpt-5.1") || modelId.startsWith("gpt-5.2");
     const systemMessageMode = isReasoningModel ? "developer" : "system";
     return {
@@ -43728,6 +43959,30 @@ ${user}:`]
   var codeInterpreter = (args = {}) => {
     return codeInterpreterToolFactory(args);
   };
+  var customArgsSchema = lazySchema(
+    () => zodSchema(
+      object$2({
+        name: string(),
+        description: string().optional(),
+        format: union([
+          object$2({
+            type: literal("grammar"),
+            syntax: _enum(["regex", "lark"]),
+            definition: string()
+          }),
+          object$2({
+            type: literal("text")
+          })
+        ]).optional()
+      })
+    )
+  );
+  var customInputSchema = lazySchema(() => zodSchema(string()));
+  var customToolFactory = createProviderToolFactory({
+    id: "openai.custom",
+    inputSchema: customInputSchema
+  });
+  var customTool = (args) => customToolFactory(args);
   var comparisonFilterSchema = object$2({
     key: string(),
     type: _enum(["eq", "ne", "gt", "gte", "lt", "lte", "in", "nin"]),
@@ -44080,6 +44335,16 @@ ${user}:`]
      *
      */
     applyPatch,
+    /**
+     * Custom tools let callers constrain model output to a grammar (regex or
+     * Lark syntax). The model returns a `custom_tool_call` output item whose
+     * `input` field is a string matching the specified grammar.
+     *
+     * @param name - The name of the custom tool.
+     * @param description - An optional description of the tool.
+     * @param format - The output format constraint (grammar type, syntax, and definition).
+     */
+    customTool,
     /**
      * The Code Interpreter tool allows models to write and run Python code in a
      * sandboxed environment to solve complex problems in domains like data analysis,
@@ -44120,7 +44385,7 @@ ${user}:`]
      * Local shell is a tool that allows agents to run shell commands locally
      * on a machine you or the user provides.
      *
-     * Supported models: `gpt-5-codex` and `codex-mini-latest`
+     * Supported models: `gpt-5-codex`
      */
     localShell,
     /**
@@ -44218,9 +44483,10 @@ ${user}:`]
     hasConversation = false,
     hasLocalShellTool = false,
     hasShellTool = false,
-    hasApplyPatchTool = false
+    hasApplyPatchTool = false,
+    customProviderToolNames
   }) {
-    var _a10, _b9, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l;
+    var _a10, _b9, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m;
     const input = [];
     const warnings = [];
     const processedApprovalIds = /* @__PURE__ */ new Set();
@@ -44389,6 +44655,16 @@ ${user}:`]
                   });
                   break;
                 }
+                if (customProviderToolNames == null ? void 0 : customProviderToolNames.has(resolvedToolName)) {
+                  input.push({
+                    type: "custom_tool_call",
+                    call_id: part.toolCallId,
+                    name: resolvedToolName,
+                    input: typeof part.input === "string" ? part.input : JSON.stringify(part.input),
+                    id: id2
+                  });
+                  break;
+                }
                 input.push({
                   type: "function_call",
                   call_id: part.toolCallId,
@@ -44593,6 +44869,61 @@ ${user}:`]
               });
               continue;
             }
+            if (customProviderToolNames == null ? void 0 : customProviderToolNames.has(resolvedToolName)) {
+              let outputValue;
+              switch (output.type) {
+                case "text":
+                case "error-text":
+                  outputValue = output.value;
+                  break;
+                case "execution-denied":
+                  outputValue = (_l = output.reason) != null ? _l : "Tool execution denied.";
+                  break;
+                case "json":
+                case "error-json":
+                  outputValue = JSON.stringify(output.value);
+                  break;
+                case "content":
+                  outputValue = output.value.map((item) => {
+                    var _a22;
+                    switch (item.type) {
+                      case "text":
+                        return { type: "input_text", text: item.text };
+                      case "image-data":
+                        return {
+                          type: "input_image",
+                          image_url: `data:${item.mediaType};base64,${item.data}`
+                        };
+                      case "image-url":
+                        return {
+                          type: "input_image",
+                          image_url: item.url
+                        };
+                      case "file-data":
+                        return {
+                          type: "input_file",
+                          filename: (_a22 = item.filename) != null ? _a22 : "data",
+                          file_data: `data:${item.mediaType};base64,${item.data}`
+                        };
+                      default:
+                        warnings.push({
+                          type: "other",
+                          message: `unsupported custom tool content part type: ${item.type}`
+                        });
+                        return void 0;
+                    }
+                  }).filter(isNonNullable);
+                  break;
+                default:
+                  outputValue = "";
+              }
+              input.push({
+                type: "custom_tool_call_output",
+                call_id: part.toolCallId,
+                output: outputValue
+              });
+              continue;
+            }
             let contentValue;
             switch (output.type) {
               case "text":
@@ -44600,7 +44931,7 @@ ${user}:`]
                 contentValue = output.value;
                 break;
               case "execution-denied":
-                contentValue = (_l = output.reason) != null ? _l : "Tool execution denied.";
+                contentValue = (_m = output.reason) != null ? _m : "Tool execution denied.";
                 break;
               case "json":
               case "error-json":
@@ -44809,6 +45140,13 @@ ${user}:`]
                 })
               ])
             }),
+            object$2({
+              type: literal("custom_tool_call"),
+              id: string(),
+              call_id: string(),
+              name: string(),
+              input: string()
+            }),
             object$2({
               type: literal("shell_call"),
               id: string(),
@@ -44861,6 +45199,14 @@ ${user}:`]
               arguments: string(),
               status: literal("completed")
             }),
+            object$2({
+              type: literal("custom_tool_call"),
+              id: string(),
+              call_id: string(),
+              name: string(),
+              input: string(),
+              status: literal("completed")
+            }),
             object$2({
               type: literal("code_interpreter_call"),
               id: string(),
@@ -45044,6 +45390,12 @@ ${user}:`]
           output_index: number$1(),
           delta: string()
         }),
+        object$2({
+          type: literal("response.custom_tool_call_input.delta"),
+          item_id: string(),
+          output_index: number$1(),
+          delta: string()
+        }),
         object$2({
           type: literal("response.image_generation_call.partial_image"),
           item_id: string(),
@@ -45291,6 +45643,13 @@ ${user}:`]
               arguments: string(),
               id: string()
             }),
+            object$2({
+              type: literal("custom_tool_call"),
+              call_id: string(),
+              name: string(),
+              input: string(),
+              id: string()
+            }),
             object$2({
               type: literal("computer_call"),
               id: string(),
@@ -45574,14 +45933,18 @@ ${user}:`]
   );
   async function prepareResponsesTools({
     tools,
-    toolChoice
+    toolChoice,
+    toolNameMapping,
+    customProviderToolNames
   }) {
+    var _a10;
     tools = (tools == null ? void 0 : tools.length) ? tools : void 0;
     const toolWarnings = [];
     if (tools == null) {
       return { tools: void 0, toolChoice: void 0, toolWarnings };
     }
     const openaiTools2 = [];
+    const resolvedCustomProviderToolNames = customProviderToolNames != null ? customProviderToolNames : /* @__PURE__ */ new Set();
     for (const tool2 of tools) {
       switch (tool2.type) {
         case "function":
@@ -45723,6 +46086,20 @@ ${user}:`]
               });
               break;
             }
+            case "openai.custom": {
+              const args = await validateTypes$1({
+                value: tool2.args,
+                schema: customArgsSchema
+              });
+              openaiTools2.push({
+                type: "custom",
+                name: args.name,
+                description: args.description,
+                format: args.format
+              });
+              resolvedCustomProviderToolNames.add(args.name);
+              break;
+            }
           }
           break;
         }
@@ -45743,12 +46120,14 @@ ${user}:`]
       case "none":
       case "required":
         return { tools: openaiTools2, toolChoice: type2, toolWarnings };
-      case "tool":
+      case "tool": {
+        const resolvedToolName = (_a10 = toolNameMapping == null ? void 0 : toolNameMapping.toProviderToolName(toolChoice.toolName)) != null ? _a10 : toolChoice.toolName;
         return {
           tools: openaiTools2,
-          toolChoice: toolChoice.toolName === "code_interpreter" || toolChoice.toolName === "file_search" || toolChoice.toolName === "image_generation" || toolChoice.toolName === "web_search_preview" || toolChoice.toolName === "web_search" || toolChoice.toolName === "mcp" || toolChoice.toolName === "apply_patch" ? { type: toolChoice.toolName } : { type: "function", name: toolChoice.toolName },
+          toolChoice: resolvedToolName === "code_interpreter" || resolvedToolName === "file_search" || resolvedToolName === "image_generation" || resolvedToolName === "web_search_preview" || resolvedToolName === "web_search" || resolvedToolName === "mcp" || resolvedToolName === "apply_patch" ? { type: resolvedToolName } : resolvedCustomProviderToolNames.has(resolvedToolName) ? { type: "custom", name: resolvedToolName } : { type: "function", name: resolvedToolName },
           toolWarnings
         };
+      }
       default: {
         const _exhaustiveCheck = type2;
         throw new UnsupportedFunctionalityError$1({
@@ -45897,7 +46276,19 @@ ${user}:`]
           "openai.web_search_preview": "web_search_preview",
           "openai.mcp": "mcp",
           "openai.apply_patch": "apply_patch"
-        }
+        },
+        resolveProviderToolName: (tool2) => tool2.id === "openai.custom" ? tool2.args.name : void 0
+      });
+      const customProviderToolNames = /* @__PURE__ */ new Set();
+      const {
+        tools: openaiTools2,
+        toolChoice: openaiToolChoice,
+        toolWarnings
+      } = await prepareResponsesTools({
+        tools,
+        toolChoice,
+        toolNameMapping,
+        customProviderToolNames
       });
       const { input, warnings: inputWarnings } = await convertToOpenAIResponsesInput({
         prompt,
@@ -45909,7 +46300,8 @@ ${user}:`]
         hasConversation: (openaiOptions == null ? void 0 : openaiOptions.conversation) != null,
         hasLocalShellTool: hasOpenAITool("openai.local_shell"),
         hasShellTool: hasOpenAITool("openai.shell"),
-        hasApplyPatchTool: hasOpenAITool("openai.apply_patch")
+        hasApplyPatchTool: hasOpenAITool("openai.apply_patch"),
+        customProviderToolNames: customProviderToolNames.size > 0 ? customProviderToolNames : void 0
       });
       warnings.push(...inputWarnings);
       const strictJsonSchema = (_d = openaiOptions == null ? void 0 : openaiOptions.strictJsonSchema) != null ? _d : true;
@@ -46042,14 +46434,6 @@ ${user}:`]
         });
         delete baseArgs.service_tier;
       }
-      const {
-        tools: openaiTools2,
-        toolChoice: openaiToolChoice,
-        toolWarnings
-      } = await prepareResponsesTools({
-        tools,
-        toolChoice
-      });
       const shellToolEnvType = (_i = (_h = (_g = tools == null ? void 0 : tools.find(
         (tool2) => tool2.type === "provider" && tool2.id === "openai.shell"
       )) == null ? void 0 : _g.args) == null ? void 0 : _h.environment) == null ? void 0 : _i.type;
@@ -46299,6 +46683,22 @@ ${user}:`]
             });
             break;
           }
+          case "custom_tool_call": {
+            hasFunctionCall = true;
+            const toolName = toolNameMapping.toCustomToolName(part.name);
+            content.push({
+              type: "tool-call",
+              toolCallId: part.call_id,
+              toolName,
+              input: JSON.stringify(part.input),
+              providerMetadata: {
+                [providerOptionsName]: {
+                  itemId: part.id
+                }
+              }
+            });
+            break;
+          }
           case "web_search_call": {
             content.push({
               type: "tool-call",
@@ -46557,6 +46957,19 @@ ${user}:`]
                     id: value.item.call_id,
                     toolName: value.item.name
                   });
+                } else if (value.item.type === "custom_tool_call") {
+                  const toolName = toolNameMapping.toCustomToolName(
+                    value.item.name
+                  );
+                  ongoingToolCalls[value.output_index] = {
+                    toolName,
+                    toolCallId: value.item.call_id
+                  };
+                  controller.enqueue({
+                    type: "tool-input-start",
+                    id: value.item.call_id,
+                    toolName
+                  });
                 } else if (value.item.type === "web_search_call") {
                   ongoingToolCalls[value.output_index] = {
                     toolName: toolNameMapping.toCustomToolName(
@@ -46741,6 +47154,27 @@ ${user}:`]
                       }
                     }
                   });
+                } else if (value.item.type === "custom_tool_call") {
+                  ongoingToolCalls[value.output_index] = void 0;
+                  hasFunctionCall = true;
+                  const toolName = toolNameMapping.toCustomToolName(
+                    value.item.name
+                  );
+                  controller.enqueue({
+                    type: "tool-input-end",
+                    id: value.item.call_id
+                  });
+                  controller.enqueue({
+                    type: "tool-call",
+                    toolCallId: value.item.call_id,
+                    toolName,
+                    input: JSON.stringify(value.item.input),
+                    providerMetadata: {
+                      [providerOptionsName]: {
+                        itemId: value.item.id
+                      }
+                    }
+                  });
                 } else if (value.item.type === "web_search_call") {
                   ongoingToolCalls[value.output_index] = void 0;
                   controller.enqueue({
@@ -46990,6 +47424,15 @@ ${user}:`]
                     delta: value.delta
                   });
                 }
+              } else if (isResponseCustomToolCallInputDeltaChunk(value)) {
+                const toolCall = ongoingToolCalls[value.output_index];
+                if (toolCall != null) {
+                  controller.enqueue({
+                    type: "tool-input-delta",
+                    id: toolCall.toolCallId,
+                    delta: value.delta
+                  });
+                }
               } else if (isResponseApplyPatchCallOperationDiffDeltaChunk(value)) {
                 const toolCall = ongoingToolCalls[value.output_index];
                 if (toolCall == null ? void 0 : toolCall.applyPatch) {
@@ -47250,6 +47693,9 @@ ${user}:`]
   function isResponseFunctionCallArgumentsDeltaChunk(chunk) {
     return chunk.type === "response.function_call_arguments.delta";
   }
+  function isResponseCustomToolCallInputDeltaChunk(chunk) {
+    return chunk.type === "response.custom_tool_call_input.delta";
+  }
   function isResponseImageGenerationCallPartialImageChunk(chunk) {
     return chunk.type === "response.image_generation_call.partial_image";
   }
@@ -47631,7 +48077,7 @@ ${user}:`]
       };
     }
   };
-  var VERSION$2 = "3.0.36";
+  var VERSION$2 = "3.0.41";
   function createOpenAI(options = {}) {
     var _a10, _b9;
     const baseURL = (_a10 = withoutTrailingSlash$1(
@@ -49451,9 +49897,13 @@ Error message: ${getErrorMessage(cause)}`,
     if (toolEntries.length === 0) {
       return "";
     }
-    let prompt = "\n\n# 工具调用\n\n";
-    prompt += "你可以根据需要调用以下工具：\n\n";
-    prompt += "<tools>\n";
+    let prompt = `
+# 工具调用
+
+你可以根据需要调用以下工具：
+
+<tools>
+  `;
     toolEntries.forEach(([toolName, tool2]) => {
       const toolInfo = tool2;
       const description2 = toolInfo.description || "无描述";
@@ -49466,23 +49916,36 @@ Error message: ${getErrorMessage(cause)}`,
       prompt += `${JSON.stringify(toolJson, null, 2)}
 `;
     });
-    prompt += "</tools>\n\n";
-    prompt += "## 工具调用格式\n\n";
-    prompt += "要调用工具，请使用以下 XML 格式：\n";
-    prompt += "Thought: [你的思考过程]\n";
-    prompt += '<tool_call>{"name": "toolName", "arguments": {"arg1": "value1"}}</tool_call>\n\n';
-    prompt += "工具执行后，你将收到 <tool_response> 格式的结果。你可以继续思考或调用其他工具。\n\n";
-    prompt += "## 使用示例\n\n";
-    prompt += '如果用户要求"获取今天的日期"，你可以这样调用工具：\n';
-    prompt += "Thought: 用户想要获取今天的日期，我需要调用日期相关的工具。\n";
-    prompt += '<tool_call>{"name": "get-today", "arguments": {}}</tool_call>\n\n';
-    prompt += "然后等待工具返回结果（Observation），再根据结果给出最终答案。\n\n";
-    prompt += "## 任务完成\n\n";
-    prompt += "当任务完成或无法继续时，直接给出最终答案即可。\n\n";
-    prompt += "**重要提示**：\n";
-    prompt += "- 必须严格按照 XML 格式调用工具\n";
-    prompt += "- arguments 必须是有效的 JSON 格式\n";
-    prompt += "- 如果不需要调用工具，直接给出最终答案即可\n";
+    prompt += `
+</tools>
+
+## 工具调用格式
+
+要调用工具，请使用以下 XML 格式：
+Thought: [你的思考过程]
+<tool_call>
+  {"name": "toolName", "arguments": {"arg1": "value1"}}
+</tool_call>
+
+工具执行后，你将收到 <tool_response> 格式的结果。你可以继续思考或调用其他工具。
+
+## 使用示例
+
+如果用户要求"获取今天的日期"，你可以这样调用工具：
+Thought: 用户想要获取今天的日期，我需要调用日期相关的工具。
+<tool_call>{"name": "get-today", "arguments": {}}</tool_call>
+
+然后等待工具返回结果（Observation），再根据结果给出最终答案。
+
+## 任务完成
+
+当任务完成或无法继续时，直接给出最终答案即可。
+
+**重要提示**：
+- 必须严格按照 XML 格式调用工具
+- arguments 必须是有效的 JSON 格式
+- 如果不需要调用工具，直接给出最终答案即可
+`;
     return prompt;
   }
   function parseReActAction(text2, availableTools) {
@@ -50089,6 +50552,171 @@ ${observationText}
       return this._chat(streamText, options);
     }
   }
+  const MSG_TOOL_CALL = "next-sdk:tool-call";
+  const MSG_TOOL_RESPONSE = "next-sdk:tool-response";
+  const MSG_PAGE_READY = "next-sdk:page-ready";
+  const MSG_PAGE_LEAVE = "next-sdk:page-leave";
+  const MSG_REMOTER_READY = "next-sdk:remoter-ready";
+  const MSG_ROUTE_STATE_INITIAL = "next-sdk:route-state-initial";
+  const activePages = /* @__PURE__ */ new Map();
+  const broadcastTargets = /* @__PURE__ */ new Set();
+  function initBroadcastTargets() {
+    if (typeof window !== "undefined") {
+      broadcastTargets.add({ win: window, origin: window.location.origin || "*" });
+    }
+  }
+  initBroadcastTargets();
+  function broadcastRouteChange(type2, route) {
+    const msg = { type: type2, route };
+    broadcastTargets.forEach(({ win, origin }) => {
+      try {
+        win.postMessage(msg, origin);
+      } catch {
+      }
+    });
+  }
+  function setupIframeRemoterBridge() {
+    if (typeof window === "undefined") return;
+    window.addEventListener("message", (event) => {
+      if (event.data?.type !== MSG_REMOTER_READY || !event.source) return;
+      if (event.origin !== window.location.origin) return;
+      const target = event.source;
+      broadcastTargets.add({ win: target, origin: event.origin || "*" });
+      const payload = {
+        type: MSG_ROUTE_STATE_INITIAL,
+        toolRouteMap: Array.from(toolRouteMap.entries()),
+        activeRoutes: Array.from(activePages.keys())
+      };
+      try {
+        target.postMessage(payload, event.origin || "*");
+      } catch {
+      }
+    });
+  }
+  setupIframeRemoterBridge();
+  const toolRouteMap = /* @__PURE__ */ new Map();
+  function getToolRouteMap() {
+    return new Map(toolRouteMap);
+  }
+  function getActiveRoutes() {
+    return new Set(activePages.keys());
+  }
+  let _navigator = null;
+  function setNavigator(fn) {
+    _navigator = fn;
+  }
+  function buildPageHandler(name16, route, timeout = 3e4) {
+    return (input) => {
+      const callId = randomUUID();
+      return new Promise((resolve2, reject) => {
+        let timer;
+        let readyHandler;
+        const cleanup = () => {
+          clearTimeout(timer);
+          window.removeEventListener("message", responseHandler);
+          if (readyHandler) {
+            window.removeEventListener("message", readyHandler);
+          }
+        };
+        timer = setTimeout(() => {
+          cleanup();
+          reject(new Error(`工具 [${name16}] 调用超时 (${timeout}ms)，请检查目标页面是否正确调用了 registerPageTool`));
+        }, timeout);
+        const responseHandler = (event) => {
+          if (event.source === window && event.data?.type === MSG_TOOL_RESPONSE && event.data.callId === callId) {
+            cleanup();
+            event.data.error ? reject(new Error(event.data.error)) : resolve2(event.data.result);
+          }
+        };
+        window.addEventListener("message", responseHandler);
+        const sendCall = () => {
+          window.postMessage({ type: MSG_TOOL_CALL, callId, toolName: name16, route, input }, window.location.origin || "*");
+        };
+        let callSent = false;
+        const sendCallOnce = () => {
+          if (callSent) return;
+          callSent = true;
+          sendCall();
+        };
+        const run = async () => {
+          try {
+            if (activePages.get(route)) {
+              sendCallOnce();
+              return;
+            }
+            readyHandler = (event) => {
+              if (event.source === window && event.data?.type === MSG_PAGE_READY && event.data.route === route) {
+                window.removeEventListener("message", readyHandler);
+                sendCallOnce();
+              }
+            };
+            window.addEventListener("message", readyHandler);
+            if (_navigator) {
+              await _navigator(route);
+            }
+            if (activePages.get(route)) {
+              window.removeEventListener("message", readyHandler);
+              sendCallOnce();
+            }
+          } catch (err) {
+            cleanup();
+            reject(err instanceof Error ? err : new Error(String(err)));
+          }
+        };
+        void run();
+      });
+    };
+  }
+  function withPageTools(server) {
+    return new Proxy(server, {
+      get(target, prop, receiver) {
+        if (prop === "registerTool") {
+          return (name16, config2, handlerOrRoute) => {
+            const rawRegister = target.registerTool.bind(target);
+            if (typeof handlerOrRoute === "function") {
+              return rawRegister(name16, config2, handlerOrRoute);
+            }
+            const { route, timeout } = handlerOrRoute;
+            toolRouteMap.set(name16, route);
+            return rawRegister(name16, config2, buildPageHandler(name16, route, timeout));
+          };
+        }
+        return Reflect.get(target, prop, receiver);
+      }
+    });
+  }
+  function registerPageTool(options) {
+    const { route: routeOption, handlers } = options;
+    const normalizeRoute = (value) => value.replace(/\/+$/, "") || "/";
+    const route = normalizeRoute(routeOption ?? window.location.pathname);
+    const handleMessage = async (event) => {
+      if (event.source !== window || event.data?.type !== MSG_TOOL_CALL || normalizeRoute(String(event.data?.route ?? "")) !== route || !(event.data.toolName in handlers)) {
+        return;
+      }
+      const { callId, toolName, input } = event.data;
+      try {
+        const result = await handlers[toolName](input);
+        window.postMessage({ type: MSG_TOOL_RESPONSE, callId, result }, window.location.origin || "*");
+      } catch (err) {
+        window.postMessage(
+          {
+            type: MSG_TOOL_RESPONSE,
+            callId,
+            error: err instanceof Error ? err.message : String(err)
+          },
+          window.location.origin || "*"
+        );
+      }
+    };
+    activePages.set(route, true);
+    window.addEventListener("message", handleMessage);
+    broadcastRouteChange(MSG_PAGE_READY, route);
+    return () => {
+      activePages.delete(route);
+      window.removeEventListener("message", handleMessage);
+      broadcastRouteChange(MSG_PAGE_LEAVE, route);
+    };
+  }
   const MAIN_SKILL_PATH_REG = /^\.\/[^/]+\/SKILL\.md$/;
   const FRONT_MATTER_BLOCK_REG = /^---\s*\n([\s\S]+?)\s*\n---/;
   function parseSkillFrontMatter(content) {
@@ -50101,14 +50729,27 @@ ${observationText}
     const description2 = descMatch?.[1]?.trim();
     return name16 && description2 ? { name: name16, description: description2 } : null;
   }
+  function normalizeSkillModuleKeys(modules) {
+    const result = {};
+    for (const [key, content] of Object.entries(modules)) {
+      const normalizedKey = key.replace(/\\/g, "/");
+      const skillsIndex = normalizedKey.lastIndexOf("skills/");
+      const relativePath = skillsIndex >= 0 ? normalizedKey.slice(skillsIndex + 7) : normalizedKey;
+      const standardPath = relativePath.startsWith("./") ? relativePath : `./${relativePath}`;
+      result[standardPath] = content;
+    }
+    return result;
+  }
   function getMainSkillPaths(modules) {
-    return Object.keys(modules).filter((path) => MAIN_SKILL_PATH_REG.test(path));
+    const normalized = normalizeSkillModuleKeys(modules);
+    return Object.keys(normalized).filter((path) => MAIN_SKILL_PATH_REG.test(path));
   }
   function getSkillOverviews(modules) {
-    const mainPaths = getMainSkillPaths(modules);
+    const normalized = normalizeSkillModuleKeys(modules);
+    const mainPaths = Object.keys(normalized).filter((path) => MAIN_SKILL_PATH_REG.test(path));
     const list = [];
     for (const path of mainPaths) {
-      const content = modules[path];
+      const content = normalized[path];
       if (!content) continue;
       const parsed = parseSkillFrontMatter(content);
       if (!parsed) continue;
@@ -50130,34 +50771,38 @@ ${lines.join("\n")}
 当需要用到某技能时，请使用 get_skill_content 工具获取该技能的完整文档内容。`;
   }
   function getSkillMdPaths(modules) {
-    return Object.keys(modules);
+    const normalized = normalizeSkillModuleKeys(modules);
+    return Object.keys(normalized);
   }
   function getSkillMdContent(modules, path) {
-    return modules[path];
+    const normalized = normalizeSkillModuleKeys(modules);
+    return normalized[path];
   }
   function getMainSkillPathByName(modules, name16) {
     return getMainSkillPaths(modules).find((p) => p.startsWith(`./${name16}/SKILL.md`));
   }
+  const SKILL_INPUT_SCHEMA = objectType({
+    skillName: stringType().optional().describe("技能名称，与目录名一致，如 calculator"),
+    path: stringType().optional().describe("文档相对路径，如 ./calculator/SKILL.md 或 ./product-guide/reference/xxx.json")
+  });
   function createSkillTools(modules) {
+    const normalizedModules = normalizeSkillModuleKeys(modules);
     const getSkillContent = tool({
       description: "根据技能名称或文档路径获取该技能的完整文档内容。传入 skillName（如 calculator）或 path（如 ./calculator/SKILL.md）。支持 .md、.json、.xml 等各类文本格式文件。",
-      inputSchema: objectType({
-        skillName: stringType().optional().describe("技能名称，与目录名一致，如 calculator"),
-        path: stringType().optional().describe("文档相对路径，如 ./calculator/SKILL.md 或 ./product-guide/reference/xxx.json")
-      }),
+      inputSchema: SKILL_INPUT_SCHEMA,
       execute: (args) => {
         const { skillName, path: pathArg } = args;
         let content;
         if (pathArg) {
-          content = getSkillMdContent(modules, pathArg);
+          content = getSkillMdContent(normalizedModules, pathArg);
         } else if (skillName) {
-          const mainPath = getMainSkillPathByName(modules, skillName);
-          content = mainPath ? getSkillMdContent(modules, mainPath) : void 0;
+          const mainPath = getMainSkillPathByName(normalizedModules, skillName);
+          content = mainPath ? getSkillMdContent(normalizedModules, mainPath) : void 0;
         }
         if (content === void 0) {
           return { error: "未找到对应技能文档", skillName: skillName ?? pathArg };
         }
-        return { content, path: pathArg ?? getMainSkillPathByName(modules, skillName) };
+        return { content, path: pathArg ?? getMainSkillPathByName(normalizedModules, skillName) };
       }
     });
     return {
@@ -50171,6 +50816,9 @@ ${lines.join("\n")}
   exports2.ExtensionClientTransport = ExtensionClientTransport;
   exports2.ExtensionPageServerTransport = ExtensionPageServerTransport;
   exports2.InMemoryTransport = InMemoryTransport;
+  exports2.MSG_PAGE_LEAVE = MSG_PAGE_LEAVE;
+  exports2.MSG_REMOTER_READY = MSG_REMOTER_READY;
+  exports2.MSG_ROUTE_STATE_INITIAL = MSG_ROUTE_STATE_INITIAL;
   exports2.QrCode = QrCode;
   exports2.ResourceTemplate = ResourceTemplate;
   exports2.UriTemplate = UriTemplate;
@@ -50186,12 +50834,14 @@ ${lines.join("\n")}
   exports2.createStreamableHTTPClientTransport = createStreamableHTTPClientTransport;
   exports2.formatSkillsForSystemPrompt = formatSkillsForSystemPrompt;
   exports2.getAISDKTools = getAISDKTools;
+  exports2.getActiveRoutes = getActiveRoutes;
   exports2.getDisplayName = getDisplayName;
   exports2.getMainSkillPathByName = getMainSkillPathByName;
   exports2.getMainSkillPaths = getMainSkillPaths;
   exports2.getSkillMdContent = getSkillMdContent;
   exports2.getSkillMdPaths = getSkillMdPaths;
   exports2.getSkillOverviews = getSkillOverviews;
+  exports2.getToolRouteMap = getToolRouteMap;
   exports2.isMcpClient = isMcpClient;
   exports2.isMcpServer = isMcpServer;
   exports2.isMessageChannelClientTransport = isMessageChannelClientTransport;
@@ -50199,6 +50849,9 @@ ${lines.join("\n")}
   exports2.isSSEClientTransport = isSSEClientTransport;
   exports2.isStreamableHTTPClientTransport = isStreamableHTTPClientTransport;
   exports2.parseSkillFrontMatter = parseSkillFrontMatter;
+  exports2.registerPageTool = registerPageTool;
+  exports2.setNavigator = setNavigator;
+  exports2.withPageTools = withPageTools;
   exports2.z = z;
   Object.defineProperty(exports2, Symbol.toStringTag, { value: "Module" });
 }));