@opentiny/next-sdk 0.2.6 → 0.2.8

package/dist/index.es.dev.js

@@ -3083,7 +3083,7 @@ function requireUtils$2() {
   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;
@@ -3306,7 +3306,7 @@ function requireUtils$2() {
     }
     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}]`;
@@ -3327,7 +3327,7 @@ function requireUtils$2() {
     recomposeAuthority,
     normalizeComponentEncoding,
     removeDotSegments,
-    isIPv4,
+    isIPv4: isIPv42,
     isUUID,
     normalizeIPv6,
     stringArrayToHexStripped
@@ -3548,7 +3548,7 @@ var hasRequiredFastUri;
 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") {
@@ -3729,7 +3729,7 @@ function requireFastUri() {
         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();
@@ -26982,10 +26982,11 @@ const DEFAULT_REMOTE_URL = "https://chat.opentiny.design";
 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
@@ -26999,7 +27000,7 @@ const getDefaultMenuItems = (options) => {
     },
     {
       action: "remote-url",
-      show: true,
+      show: hasSession,
       text: `遥控器链接`,
       desc: `${options.remoteUrl}`,
       active: true,
@@ -27009,14 +27010,15 @@ const getDefaultMenuItems = (options) => {
     },
     {
       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) {
@@ -27048,9 +27050,6 @@ class FloatingBlock {
         trigger: "hover"
       });
     };
-    if (!options.sessionId) {
-      throw new Error("sessionId is required");
-    }
     this.options = {
       ...options,
       qrCodeUrl: options.qrCodeUrl || DEFAULT_QR_CODE_URL,
@@ -27069,11 +27068,14 @@ class FloatingBlock {
     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);
     }
@@ -27083,7 +27085,6 @@ class FloatingBlock {
         return {
           ...defaultItem,
           ...userItem,
-          // 确保show属性存在，默认为true
           show: userItem.show !== void 0 ? userItem.show : defaultItem.show
         };
       }
@@ -27227,9 +27228,11 @@ class FloatingBlock {
     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);
   }
   // 实现复制到剪贴板功能
@@ -27277,8 +27280,9 @@ class FloatingBlock {
       }, 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(
@@ -27754,6 +27758,19 @@ class FloatingBlock {
       this.dropdownMenu.parentNode.removeChild(this.dropdownMenu);
     }
   }
+  // 隐藏组件
+  hide() {
+    if (this.floatingBlock) {
+      this.floatingBlock.style.display = "none";
+    }
+    this.closeDropdown();
+  }
+  // 显示组件
+  show() {
+    if (this.floatingBlock) {
+      this.floatingBlock.style.display = "flex";
+    }
+  }
 }
 const createRemoter = (options = {}) => {
   return new FloatingBlock(options);
@@ -28049,25 +28066,30 @@ function combineHeaders$1(...headers) {
 }
 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;
     }
   };
 }
@@ -28260,8 +28282,103 @@ async function readResponseWithSizeLimit({
   }
   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
@@ -28427,7 +28544,7 @@ function withUserAgentSuffix$1(headers, ...userAgentSuffixParts) {
   );
   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,
@@ -28570,8 +28687,8 @@ function mediaTypeToExtension(mediaType) {
     "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") {
@@ -28591,7 +28708,7 @@ function filter$1(obj) {
       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) {
@@ -30078,6 +30195,33 @@ function tool(tool2) {
 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,
@@ -31548,7 +31692,7 @@ async function getVercelRequestId() {
   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;
@@ -32686,6 +32830,8 @@ function asArray(value) {
 }
 async function notify(options) {
   for (const callback of asArray(options.callbacks)) {
+    if (callback == null)
+      continue;
     try {
       await callback(options.event);
     } catch (_ignored) {
@@ -32992,7 +33138,7 @@ function detectMediaType({
   }
   return void 0;
 }
-var VERSION$4 = "6.0.104";
+var VERSION$4 = "6.0.116";
 var download = async ({
   url: url2,
   maxBytes,
@@ -33000,6 +33146,7 @@ var download = async ({
 }) => {
   var _a21;
   const urlText = url2.toString();
+  validateDownloadUrl(urlText);
   try {
     const response = await fetch(urlText, {
       headers: withUserAgentSuffix$1(
@@ -34105,6 +34252,44 @@ function stringifyForTelemetry(prompt) {
     }))
   );
 }
+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,
@@ -35655,6 +35840,7 @@ async function generateText({
   ...settings
 }) {
   const model = resolveLanguageModel(modelArg);
+  const createGlobalTelemetry = getGlobalTelemetryIntegration();
   const stopConditions = asArray(stopWhen);
   const totalTimeoutMs = getTotalTimeoutMs(timeout);
   const stepTimeoutMs = getStepTimeoutMs(timeout);
@@ -35685,6 +35871,7 @@ async function generateText({
     prompt,
     messages
   });
+  const globalTelemetry = createGlobalTelemetry(telemetry == null ? void 0 : telemetry.integrations);
   await notify({
     event: {
       model: modelInfo,
@@ -35714,7 +35901,10 @@ async function generateText({
       metadata: telemetry == null ? void 0 : telemetry.metadata,
       experimental_context
     },
-    callbacks: onStart
+    callbacks: [
+      onStart,
+      globalTelemetry.onStart
+    ]
   });
   const tracer = getTracer(telemetry);
   try {
@@ -35759,8 +35949,14 @@ async function generateText({
             experimental_context,
             stepNumber: 0,
             model: modelInfo,
-            onToolCallStart,
-            onToolCallFinish
+            onToolCallStart: [
+              onToolCallStart,
+              globalTelemetry.onToolCallStart
+            ],
+            onToolCallFinish: [
+              onToolCallFinish,
+              globalTelemetry.onToolCallFinish
+            ]
           });
           const toolContent = [];
           for (const output2 of toolOutputs) {
@@ -35769,7 +35965,7 @@ async function generateText({
               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",
@@ -35886,7 +36082,10 @@ async function generateText({
                 metadata: telemetry == null ? void 0 : telemetry.metadata,
                 experimental_context
               },
-              callbacks: onStepStart
+              callbacks: [
+                onStepStart,
+                globalTelemetry.onStepStart
+              ]
             });
             currentModelResponse = await retry(
               () => {
@@ -36064,8 +36263,14 @@ async function generateText({
                   experimental_context,
                   stepNumber: steps.length,
                   model: stepModelInfo,
-                  onToolCallStart,
-                  onToolCallFinish
+                  onToolCallStart: [
+                    onToolCallStart,
+                    globalTelemetry.onToolCallStart
+                  ],
+                  onToolCallFinish: [
+                    onToolCallFinish,
+                    globalTelemetry.onToolCallFinish
+                  ]
                 })
               );
             }
@@ -36132,7 +36337,10 @@ async function generateText({
               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);
@@ -36213,7 +36421,10 @@ async function generateText({
             steps,
             totalUsage
           },
-          callbacks: onFinish
+          callbacks: [
+            onFinish,
+            globalTelemetry.onFinish
+          ]
         });
         let resolvedOutput;
         if (lastStep.finishReason === "stop") {
@@ -36832,7 +37043,8 @@ function processUIMessageStream({
               state.message.parts.push({
                 type: "file",
                 mediaType: chunk.mediaType,
-                url: chunk.url
+                url: chunk.url,
+                ...chunk.providerMetadata != null ? { providerMetadata: chunk.providerMetadata } : {}
               });
               write();
               break;
@@ -37489,7 +37701,8 @@ function runToolsTransformation({
             file: new DefaultGeneratedFileWithType({
               data: chunk.data,
               mediaType: chunk.mediaType
-            })
+            }),
+            ...chunk.providerMetadata != null ? { providerMetadata: chunk.providerMetadata } : {}
           });
           break;
         }
@@ -37877,6 +38090,8 @@ var DefaultStreamTextResult = class {
     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 = [];
@@ -37978,7 +38193,11 @@ var DefaultStreamTextResult = class {
           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);
@@ -38024,7 +38243,10 @@ var DefaultStreamTextResult = class {
             },
             providerMetadata: part.providerMetadata
           });
-          await notify({ event: currentStepResult, callbacks: onStepFinish });
+          await notify({
+            event: currentStepResult,
+            callbacks: [onStepFinish, globalTelemetry.onStepFinish]
+          });
           logWarnings({
             warnings: recordedWarnings,
             provider: modelInfo.provider,
@@ -38088,7 +38310,10 @@ var DefaultStreamTextResult = class {
               providerMetadata: finalStep.providerMetadata,
               steps: recordedSteps
             },
-            callbacks: onFinish
+            callbacks: [
+              onFinish,
+              globalTelemetry.onFinish
+            ]
           });
           rootSpan.setAttributes(
             await selectTelemetryAttributes({
@@ -38245,7 +38470,10 @@ var DefaultStreamTextResult = class {
             ...callbackTelemetryProps,
             experimental_context
           },
-          callbacks: onStart
+          callbacks: [
+            onStart,
+            globalTelemetry.onStart
+          ]
         });
         const initialMessages = initialPrompt.messages;
         const initialResponseMessages = [];
@@ -38295,8 +38523,14 @@ var DefaultStreamTextResult = class {
                   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);
                   }
@@ -38333,7 +38567,7 @@ var DefaultStreamTextResult = class {
                     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"
                   })
                 });
               }
@@ -38447,7 +38681,10 @@ var DefaultStreamTextResult = class {
                 ...callbackTelemetryProps,
                 experimental_context
               },
-              callbacks: onStepStart
+              callbacks: [
+                onStepStart,
+                globalTelemetry.onStepStart
+              ]
             });
             const {
               result: { stream: stream2, response, request },
@@ -38523,8 +38760,14 @@ var DefaultStreamTextResult = class {
               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 = [];
@@ -39106,7 +39349,8 @@ var DefaultStreamTextResult = class {
               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;
             }
@@ -41428,7 +41672,7 @@ var openaiFailedResponseHandler = createJsonErrorResponseHandler$1({
 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 {
@@ -43335,6 +43579,30 @@ var codeInterpreterToolFactory = createProviderToolFactoryWithOutputSchema({
 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"]),
@@ -43687,6 +43955,16 @@ var openaiTools = {
    *
    */
   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,
@@ -43727,7 +44005,7 @@ var openaiTools = {
    * 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,
   /**
@@ -43825,9 +44103,10 @@ async function convertToOpenAIResponsesInput({
   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();
@@ -43996,6 +44275,16 @@ async function convertToOpenAIResponsesInput({
                 });
                 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,
@@ -44200,6 +44489,61 @@ async function convertToOpenAIResponsesInput({
             });
             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":
@@ -44207,7 +44551,7 @@ async function convertToOpenAIResponsesInput({
               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":
@@ -44416,6 +44760,13 @@ var openaiResponsesChunkSchema = lazySchema(
               })
             ])
           }),
+          object$2({
+            type: literal("custom_tool_call"),
+            id: string(),
+            call_id: string(),
+            name: string(),
+            input: string()
+          }),
           object$2({
             type: literal("shell_call"),
             id: string(),
@@ -44468,6 +44819,14 @@ var openaiResponsesChunkSchema = lazySchema(
             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(),
@@ -44651,6 +45010,12 @@ var openaiResponsesChunkSchema = lazySchema(
         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(),
@@ -44898,6 +45263,13 @@ var openaiResponsesResponseSchema = lazySchema(
             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(),
@@ -45181,14 +45553,18 @@ var openaiLanguageModelResponsesOptionsSchema = lazySchema(
 );
 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":
@@ -45330,6 +45706,20 @@ async function prepareResponsesTools({
             });
             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;
       }
@@ -45350,12 +45740,14 @@ async function prepareResponsesTools({
     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({
@@ -45504,7 +45896,19 @@ var OpenAIResponsesLanguageModel = class {
         "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,
@@ -45516,7 +45920,8 @@ var OpenAIResponsesLanguageModel = class {
       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;
@@ -45649,14 +46054,6 @@ var OpenAIResponsesLanguageModel = class {
       });
       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;
@@ -45906,6 +46303,22 @@ var OpenAIResponsesLanguageModel = class {
           });
           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",
@@ -46164,6 +46577,19 @@ var OpenAIResponsesLanguageModel = class {
                   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(
@@ -46348,6 +46774,27 @@ var OpenAIResponsesLanguageModel = class {
                     }
                   }
                 });
+              } 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({
@@ -46597,6 +47044,15 @@ var OpenAIResponsesLanguageModel = class {
                   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) {
@@ -46857,6 +47313,9 @@ function isResponseCreatedChunk(chunk) {
 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";
 }
@@ -47238,7 +47697,7 @@ var OpenAITranscriptionModel = class {
     };
   }
 };
-var VERSION$2 = "3.0.36";
+var VERSION$2 = "3.0.41";
 function createOpenAI(options = {}) {
   var _a10, _b9;
   const baseURL = (_a10 = withoutTrailingSlash$1(
@@ -49058,9 +49517,13 @@ function generateReActToolsPrompt(tools) {
   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 || "无描述";
@@ -49073,23 +49536,36 @@ function generateReActToolsPrompt(tools) {
     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) {
@@ -49309,15 +49785,24 @@ class AgentModelProvider {
     }
     this.onUpdatedTools?.();
   }
-  /** 创建临时允许调用的tools集合 */
-  _tempMergeTools(extraTool = {}) {
-    const toolsResult = Object.values(this.mcpTools).reduce((acc, curr) => ({ ...acc, ...curr }), {});
+  /** 创建临时允许调用的 tools 集合，合并 mcpTools 与 extraTool */
+  _tempMergeTools(extraTool = {}, deleteIgnored = true) {
+    const toolsResult = Object.values(this.mcpTools).reduce(
+      (acc, curr) => ({ ...acc, ...curr }),
+      {}
+    );
     Object.assign(toolsResult, extraTool);
-    this.ignoreToolnames.forEach((name16) => {
-      delete toolsResult[name16];
-    });
+    if (deleteIgnored) {
+      this.ignoreToolnames.forEach((name16) => {
+        delete toolsResult[name16];
+      });
+    }
     return toolsResult;
   }
+  /** 获取当前激活的 tools 名称列表（过滤 ignoreToolnames） */
+  _getActiveToolNames(tools) {
+    return Object.keys(tools).filter((name16) => !this.ignoreToolnames.includes(name16));
+  }
   /** 生成 ReAct 模式的系统提示词（包含工具描述） */
   _generateReActSystemPrompt(tools, modelName, baseSystemPrompt) {
     const toolsPrompt = generateReActToolsPrompt(tools);
@@ -49661,12 +50146,14 @@ ${observationText}
       throw new Error("LLM is not initialized");
     }
     await this.initClientsAndTools();
+    const allTools = this._tempMergeTools(options.tools, false);
     const chatOptions = {
       // @ts-ignore  ProviderV2 是所有llm的父类， 在每一个具体的llm 类都有一个选择model的函数用法
       model: this.llm(model),
       stopWhen: stepCountIs(maxSteps),
       ...options,
-      tools: this._tempMergeTools(options.tools)
+      tools: allTools,
+      activeTools: this._getActiveToolNames(allTools)
     };
     let lastUserMessage = null;
     if (options.message && !options.messages) {
@@ -49696,6 +50183,454 @@ ${observationText}
     return this._chat(streamText, options);
   }
 }
+let overlayElement = null;
+let labelElement = null;
+let styleElement = null;
+let activeCount = 0;
+const BODY_GLOW_CLASS = "next-sdk-tool-body-glow";
+function ensureDomReady() {
+  return typeof window !== "undefined" && typeof document !== "undefined";
+}
+function ensureStyleElement() {
+  if (!ensureDomReady()) return;
+  if (styleElement) return;
+  const style = document.createElement("style");
+  style.textContent = `
+  .${BODY_GLOW_CLASS} {
+    position: relative;
+  }
+
+  .next-sdk-tool-overlay {
+    position: fixed;
+    inset: 0;
+    z-index: 999999;
+    pointer-events: none;
+    display: flex;
+    align-items: flex-end;
+    justify-content: flex-start;
+    padding: 0 0 18px 18px;
+    background: transparent;
+    animation: next-sdk-overlay-fade-in 260ms ease-out;
+  }
+
+  .next-sdk-tool-overlay--exit {
+    animation: next-sdk-overlay-fade-out 220ms ease-in forwards;
+  }
+
+  .next-sdk-tool-overlay__glow-ring {
+    display: none;
+  }
+
+  .next-sdk-tool-overlay__panel {
+    position: relative;
+    min-width: min(320px, 78vw);
+    max-width: min(420px, 82vw);
+    padding: 10px 14px;
+    border-radius: 999px;
+    background:
+      linear-gradient(135deg, rgba(15, 23, 42, 0.9), rgba(17, 24, 39, 0.9)),
+      radial-gradient(circle at top left, rgba(96, 165, 250, 0.25), transparent 55%),
+      radial-gradient(circle at bottom right, rgba(45, 212, 191, 0.22), transparent 60%);
+    box-shadow:
+      0 12px 28px rgba(15, 23, 42, 0.78),
+      0 0 0 1px rgba(148, 163, 184, 0.26);
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    pointer-events: none;
+    transform-origin: center;
+    animation: next-sdk-panel-pop-in 260ms cubic-bezier(0.18, 0.89, 0.32, 1.28);
+    color: #e5e7eb;
+    font-family: system-ui, -apple-system, BlinkMacSystemFont, "SF Pro Text", sans-serif;
+  }
+
+  .next-sdk-tool-overlay__indicator {
+    width: 26px;
+    height: 26px;
+    border-radius: 999px;
+    background: radial-gradient(circle at 30% 10%, #f9fafb, #93c5fd);
+    box-shadow:
+      0 0 0 1px rgba(191, 219, 254, 0.6),
+      0 8px 18px rgba(37, 99, 235, 0.8),
+      0 0 28px rgba(56, 189, 248, 0.9);
+    position: relative;
+    flex-shrink: 0;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    overflow: hidden;
+  }
+
+  .next-sdk-tool-overlay__indicator-orbit {
+    position: absolute;
+    inset: 2px;
+    border-radius: inherit;
+    border: 1px solid rgba(248, 250, 252, 0.6);
+    box-sizing: border-box;
+    opacity: 0.9;
+  }
+
+  .next-sdk-tool-overlay__indicator-orbit::before {
+    content: '';
+    position: absolute;
+    width: 6px;
+    height: 6px;
+    border-radius: 999px;
+    background: #f9fafb;
+    box-shadow:
+      0 0 12px rgba(248, 250, 252, 0.9),
+      0 0 24px rgba(250, 249, 246, 0.9);
+    top: 0;
+    left: 50%;
+    transform: translate(-50%, -50%);
+    transform-origin: 50% 18px;
+    animation: next-sdk-indicator-orbit 1.4s linear infinite;
+  }
+
+  .next-sdk-tool-overlay__indicator-core {
+    width: 14px;
+    height: 14px;
+    border-radius: inherit;
+    background: radial-gradient(circle at 30% 20%, #f9fafb, #bfdbfe);
+    box-shadow:
+      0 0 12px rgba(248, 250, 252, 0.9),
+      0 0 32px rgba(191, 219, 254, 0.8);
+    opacity: 0.96;
+  }
+
+  .next-sdk-tool-overlay__content {
+    display: flex;
+    flex-direction: column;
+    gap: 1px;
+    min-width: 0;
+  }
+
+  .next-sdk-tool-overlay__title {
+    font-size: 11px;
+    letter-spacing: 0.08em;
+    text-transform: uppercase;
+    color: rgba(156, 163, 175, 0.96);
+    display: flex;
+    align-items: center;
+    gap: 6px;
+  }
+
+  .next-sdk-tool-overlay__title-dot {
+    width: 6px;
+    height: 6px;
+    border-radius: 999px;
+    background: #22c55e;
+    box-shadow:
+      0 0 8px rgba(34, 197, 94, 0.9),
+      0 0 14px rgba(22, 163, 74, 0.9);
+  }
+
+  .next-sdk-tool-overlay__label {
+    font-size: 12px;
+    font-weight: 500;
+    color: #e5e7eb;
+    white-space: nowrap;
+    text-overflow: ellipsis;
+    overflow: hidden;
+  }
+
+  @keyframes next-sdk-overlay-fade-in {
+    from { opacity: 0; }
+    to { opacity: 1; }
+  }
+
+  @keyframes next-sdk-overlay-fade-out {
+    from { opacity: 1; }
+    to { opacity: 0; }
+  }
+
+  @keyframes next-sdk-indicator-orbit {
+    from {
+      transform: translate(-50%, -50%) rotate(0deg) translateY(0);
+    }
+    to {
+      transform: translate(-50%, -50%) rotate(360deg) translateY(0);
+    }
+  }
+
+  @keyframes next-sdk-panel-pop-in {
+    0% {
+      opacity: 0;
+      transform: scale(0.92) translateY(10px);
+    }
+    100% {
+      opacity: 1;
+      transform: scale(1) translateY(0);
+    }
+  }
+  `;
+  document.head.appendChild(style);
+  styleElement = style;
+}
+function ensureOverlayElement() {
+  if (!ensureDomReady()) return;
+  if (overlayElement) return;
+  ensureStyleElement();
+  const overlay = document.createElement("div");
+  overlay.className = "next-sdk-tool-overlay";
+  const glowRing = document.createElement("div");
+  glowRing.className = "next-sdk-tool-overlay__glow-ring";
+  const panel = document.createElement("div");
+  panel.className = "next-sdk-tool-overlay__panel";
+  const indicator = document.createElement("div");
+  indicator.className = "next-sdk-tool-overlay__indicator";
+  const indicatorOrbit = document.createElement("div");
+  indicatorOrbit.className = "next-sdk-tool-overlay__indicator-orbit";
+  const indicatorCore = document.createElement("div");
+  indicatorCore.className = "next-sdk-tool-overlay__indicator-core";
+  const content = document.createElement("div");
+  content.className = "next-sdk-tool-overlay__content";
+  const titleRow = document.createElement("div");
+  titleRow.className = "next-sdk-tool-overlay__title";
+  titleRow.textContent = "AI 正在调用页面工具";
+  const titleDot = document.createElement("span");
+  titleDot.className = "next-sdk-tool-overlay__title-dot";
+  const label = document.createElement("div");
+  label.className = "next-sdk-tool-overlay__label";
+  titleRow.prepend(titleDot);
+  content.appendChild(titleRow);
+  content.appendChild(label);
+  indicator.appendChild(indicatorOrbit);
+  indicator.appendChild(indicatorCore);
+  panel.appendChild(indicator);
+  panel.appendChild(content);
+  overlay.appendChild(glowRing);
+  overlay.appendChild(panel);
+  document.body.appendChild(overlay);
+  overlayElement = overlay;
+  labelElement = label;
+}
+function updateOverlay(config2) {
+  if (!ensureDomReady()) return;
+  ensureOverlayElement();
+  if (!overlayElement || !labelElement) return;
+  overlayElement.classList.remove("next-sdk-tool-overlay--exit");
+  labelElement.textContent = config2.label;
+}
+function removeOverlayWithAnimation() {
+  if (!overlayElement) return;
+  overlayElement.classList.add("next-sdk-tool-overlay--exit");
+  const localOverlay = overlayElement;
+  let handled = false;
+  let timerId;
+  const handle = () => {
+    if (handled) return;
+    handled = true;
+    if (timerId !== void 0) {
+      clearTimeout(timerId);
+      timerId = void 0;
+    }
+    if (localOverlay.parentNode) {
+      localOverlay.parentNode.removeChild(localOverlay);
+    }
+    if (overlayElement === localOverlay) {
+      overlayElement = null;
+      labelElement = null;
+    }
+    localOverlay.removeEventListener("animationend", handle);
+  };
+  localOverlay.addEventListener("animationend", handle);
+  timerId = setTimeout(handle, 500);
+}
+function showToolInvokeEffect(config2) {
+  if (!ensureDomReady()) return;
+  activeCount += 1;
+  updateOverlay(config2);
+}
+function hideToolInvokeEffect() {
+  if (!ensureDomReady() || activeCount <= 0) return;
+  activeCount -= 1;
+  if (activeCount === 0) {
+    removeOverlayWithAnimation();
+  }
+}
+function resolveRuntimeEffectConfig(toolName, toolTitle, value) {
+  if (!value) return void 0;
+  const baseLabel = toolTitle || toolName;
+  if (typeof value === "boolean") {
+    return value ? { label: baseLabel } : void 0;
+  }
+  return {
+    label: value.label || baseLabel
+  };
+}
+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, effectConfig) {
+  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);
+        }
+        if (effectConfig) {
+          hideToolInvokeEffect();
+        }
+      };
+      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 (effectConfig) {
+            showToolInvokeEffect(effectConfig);
+          }
+          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, invokeEffect } = handlerOrRoute;
+          toolRouteMap.set(name16, route);
+          const effectConfig = resolveRuntimeEffectConfig(name16, config2?.title, invokeEffect);
+          return rawRegister(name16, config2, buildPageHandler(name16, route, timeout, effectConfig));
+        };
+      }
+      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) {
@@ -49708,14 +50643,27 @@ function parseSkillFrontMatter(content) {
   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;
@@ -49737,34 +50685,100 @@ ${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);
+  const exactMatch = normalized[path];
+  if (exactMatch) return exactMatch;
+  const suffix = path.replace(/^\.?\//, "/");
+  const matchingKey = Object.keys(normalized).find((key) => key.endsWith(suffix));
+  return matchingKey ? normalized[matchingKey] : void 0;
 }
 function getMainSkillPathByName(modules, name16) {
-  return getMainSkillPaths(modules).find((p) => p.startsWith(`./${name16}/SKILL.md`));
+  const normalizedModules = normalizeSkillModuleKeys(modules);
+  const paths = getMainSkillPaths(normalizedModules);
+  const dirMatch = paths.find((p) => p.startsWith(`./${name16}/SKILL.md`));
+  if (dirMatch) return dirMatch;
+  for (const p of paths) {
+    const content = normalizedModules[p];
+    if (content) {
+      const parsed = parseSkillFrontMatter(content);
+      if (parsed && parsed.name === name16) {
+        return p;
+      }
+    }
+  }
+  return void 0;
 }
+const SKILL_INPUT_SCHEMA = objectType({
+  skillName: stringType().optional().describe(
+    '进入某个技能的主入口名称。优先匹配技能的目录名（如 ecommerce），或者技能的中文名称（如"客户价保单创建及审核"）。'
+  ),
+  path: stringType().optional().describe("你想查阅的文档的路径。如 ./calculator/SKILL.md 或从其他文档里看到的相对路径 ./reference/inventory.md。"),
+  currentPath: stringType().optional().describe(
+    "你当前正在阅读的文档路径（如果有）。比如你刚刚读取了 ./ecommerce/SKILL.md，请把这个路径原样传回来，这样系统才能根据你的相对路径准确找到下一份文件。"
+  )
+});
 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")
-    }),
+    description: "根据技能名称或文档路径获取该技能的完整文档内容。如果你想根据相对路径查阅文件，请务必同时提供你当前所在的文件路径 currentPath。",
+    inputSchema: SKILL_INPUT_SCHEMA,
     execute: (args) => {
-      const { skillName, path: pathArg } = args;
+      const { skillName, path: pathArg, currentPath: currentPathArg } = args;
       let content;
+      let resolvedPath = "";
       if (pathArg) {
-        content = getSkillMdContent(modules, pathArg);
+        let basePathContext = ".";
+        if (currentPathArg) {
+          const lastSlashIndex = currentPathArg.lastIndexOf("/");
+          if (lastSlashIndex >= 0) {
+            basePathContext = currentPathArg.slice(0, lastSlashIndex);
+          }
+        }
+        const dummyBase = `http://localhost/${basePathContext}/`;
+        const url2 = new URL(pathArg, dummyBase);
+        resolvedPath = "." + url2.pathname;
+        content = getSkillMdContent(normalizedModules, resolvedPath);
+        if (content === void 0 && (pathArg.startsWith("./") || pathArg.startsWith("../")) && currentPathArg) {
+          const baseParts = currentPathArg.split("/");
+          if (baseParts.length >= 2) {
+            const skillRoot = baseParts[1];
+            const fallbackDummyBase = `http://localhost/${skillRoot}/`;
+            const fallbackUrl = new URL(pathArg, fallbackDummyBase);
+            const fallbackPath = "." + fallbackUrl.pathname;
+            content = getSkillMdContent(normalizedModules, fallbackPath);
+            if (content) {
+              resolvedPath = fallbackPath;
+            }
+          }
+        }
+        if (content && !normalizedModules[resolvedPath]) {
+          const suffix = resolvedPath.replace(/^\.?\//, "/");
+          const matchingKey = Object.keys(normalizedModules).find((key) => key.endsWith(suffix));
+          if (matchingKey) {
+            resolvedPath = matchingKey;
+          }
+        }
       } else if (skillName) {
-        const mainPath = getMainSkillPathByName(modules, skillName);
-        content = mainPath ? getSkillMdContent(modules, mainPath) : void 0;
+        const mainPath = getMainSkillPathByName(normalizedModules, skillName);
+        if (mainPath) {
+          resolvedPath = mainPath;
+          content = getSkillMdContent(normalizedModules, mainPath);
+        }
       }
       if (content === void 0) {
-        return { error: "未找到对应技能文档", skillName: skillName ?? pathArg };
+        return {
+          error: "未找到对应技能文档",
+          skillName,
+          path: pathArg,
+          providedCurrentPath: currentPathArg,
+          attemptedPath: resolvedPath
+        };
       }
-      return { content, path: pathArg ?? getMainSkillPathByName(modules, skillName) };
+      return { content, path: resolvedPath };
     }
   });
   return {
@@ -49779,6 +50793,9 @@ export {
   ExtensionClientTransport,
   ExtensionPageServerTransport,
   InMemoryTransport,
+  MSG_PAGE_LEAVE,
+  MSG_REMOTER_READY,
+  MSG_ROUTE_STATE_INITIAL,
   QrCode,
   ResourceTemplate,
   UriTemplate,
@@ -49794,12 +50811,14 @@ export {
   createStreamableHTTPClientTransport,
   formatSkillsForSystemPrompt,
   getAISDKTools,
+  getActiveRoutes,
   getDisplayName,
   getMainSkillPathByName,
   getMainSkillPaths,
   getSkillMdContent,
   getSkillMdPaths,
   getSkillOverviews,
+  getToolRouteMap,
   isMcpClient,
   isMcpServer,
   isMessageChannelClientTransport,
@@ -49807,5 +50826,8 @@ export {
   isSSEClientTransport,
   isStreamableHTTPClientTransport,
   parseSkillFrontMatter,
+  registerPageTool,
+  setNavigator,
+  withPageTools,
   z
 };