integrate-sdk 0.9.10-dev.0 → 0.9.13-dev.0

package/dist/ai/anthropic.js

@@ -1,4 +1,20 @@
+import { createRequire } from "node:module";
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __toESM = (mod, isNodeMode, target) => {
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: () => mod[key],
+        enumerable: true
+      });
+  return to;
+};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
@@ -8,6 +24,7 @@ var __export = (target, all) => {
       set: (newValue) => all[name] = () => newValue
     });
 };
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // ../../node_modules/zod/v3/external.js
 var exports_external = {};
@@ -4692,7 +4709,11 @@ export { callTool };
 // ../code-mode/executor.ts
 var sandboxFactoryOverride = null;
 var _sandboxAvailableCache = null;
+var _sandboxImportError = null;
 var _sandboxForcedUnavailableForTests = false;
+function getSandboxImportError() {
+  return _sandboxImportError;
+}
 async function isSandboxAvailable() {
   if (_sandboxAvailableCache !== null)
     return _sandboxAvailableCache;
@@ -4702,15 +4723,17 @@ async function isSandboxAvailable() {
   }
   if (sandboxFactoryOverride) {
     _sandboxAvailableCache = true;
+    _sandboxImportError = null;
     return true;
   }
   try {
-    const dynamicImport = new Function("specifier", "return import(specifier)");
-    await dynamicImport("@" + "vercel/sandbox");
+    await import("@vercel/sandbox");
     _sandboxAvailableCache = true;
+    _sandboxImportError = null;
     return true;
-  } catch {
+  } catch (err) {
     _sandboxAvailableCache = false;
+    _sandboxImportError = err;
     return false;
   }
 }
@@ -4718,12 +4741,12 @@ async function loadSandboxFactory() {
   if (sandboxFactoryOverride)
     return sandboxFactoryOverride;
   try {
-    const dynamicImport = new Function("specifier", "return import(specifier)");
-    const pkg = "@" + "vercel/sandbox";
-    const mod = await dynamicImport(pkg);
+    const mod = await import("@vercel/sandbox");
     return mod.Sandbox ?? mod.default?.Sandbox ?? mod;
   } catch (err) {
-    throw new Error("Code Mode requires the optional peer dependency `@vercel/sandbox`. " + "Install it with `npm install @vercel/sandbox` (or `bun add @vercel/sandbox`).");
+    _sandboxImportError = err;
+    const detail = err instanceof Error ? `: ${err.message}` : "";
+    throw new Error("Code Mode failed to load `@vercel/sandbox`" + detail + ". Ensure the package is installed and reachable at runtime. On Next.js/Vercel, confirm it is listed in `dependencies` (not only `devDependencies`) and that the route using Code Mode runs in the Node.js runtime (not Edge).");
   }
 }
 var RESULT_SENTINEL = "__INTEGRATE_RESULT__";
@@ -4907,16 +4930,20 @@ async function diagnoseCodeMode(client) {
   }
   return { available: true };
 }
-var CODE_MODE_UNAVAILABLE_MESSAGES = {
-  "sandbox-missing": "[integrate-sdk] Code Mode unavailable (reason: sandbox-missing) — falling back to tool mode. " + "Install `@vercel/sandbox` (e.g. `bun add @vercel/sandbox`) to enable Code Mode.",
-  "no-public-url": "[integrate-sdk] Code Mode unavailable (reason: no-public-url) — falling back to tool mode. " + "Set `codeMode.publicUrl` on your server config or the `INTEGRATE_URL` env var."
-};
+function buildFallbackMessage(reason) {
+  if (reason === "no-public-url") {
+    return "[integrate-sdk] Code Mode unavailable (reason: no-public-url) — falling back to tool mode. " + "Set `codeMode.publicUrl` on your server config or the `INTEGRATE_URL` env var.";
+  }
+  const importError = getSandboxImportError();
+  const detail = importError instanceof Error ? ` Underlying import error: ${importError.message}` : importError ? ` Underlying import error: ${String(importError)}` : "";
+  return "[integrate-sdk] Code Mode unavailable (reason: sandbox-missing) — falling back to tool mode. " + "Ensure `@vercel/sandbox` is in `dependencies` and the route runs in the Node.js runtime (not Edge)." + detail;
+}
 var warnedCodeModeReasons = new Set;
 function warnCodeModeFallback(reason) {
   if (warnedCodeModeReasons.has(reason))
     return;
   warnedCodeModeReasons.add(reason);
-  console.warn(CODE_MODE_UNAVAILABLE_MESSAGES[reason]);
+  console.warn(buildFallbackMessage(reason));
 }
 function buildCodeModeTool(client, options) {
   const { tools, providerTokens, context, integrationIds } = options;

package/dist/ai/google.js

@@ -1,4 +1,20 @@
+import { createRequire } from "node:module";
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __toESM = (mod, isNodeMode, target) => {
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: () => mod[key],
+        enumerable: true
+      });
+  return to;
+};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
@@ -8,6 +24,7 @@ var __export = (target, all) => {
       set: (newValue) => all[name] = () => newValue
     });
 };
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // ../../node_modules/zod/v3/external.js
 var exports_external = {};
@@ -4692,7 +4709,11 @@ export { callTool };
 // ../code-mode/executor.ts
 var sandboxFactoryOverride = null;
 var _sandboxAvailableCache = null;
+var _sandboxImportError = null;
 var _sandboxForcedUnavailableForTests = false;
+function getSandboxImportError() {
+  return _sandboxImportError;
+}
 async function isSandboxAvailable() {
   if (_sandboxAvailableCache !== null)
     return _sandboxAvailableCache;
@@ -4702,15 +4723,17 @@ async function isSandboxAvailable() {
   }
   if (sandboxFactoryOverride) {
     _sandboxAvailableCache = true;
+    _sandboxImportError = null;
     return true;
   }
   try {
-    const dynamicImport = new Function("specifier", "return import(specifier)");
-    await dynamicImport("@" + "vercel/sandbox");
+    await import("@vercel/sandbox");
     _sandboxAvailableCache = true;
+    _sandboxImportError = null;
     return true;
-  } catch {
+  } catch (err) {
     _sandboxAvailableCache = false;
+    _sandboxImportError = err;
     return false;
   }
 }
@@ -4718,12 +4741,12 @@ async function loadSandboxFactory() {
   if (sandboxFactoryOverride)
     return sandboxFactoryOverride;
   try {
-    const dynamicImport = new Function("specifier", "return import(specifier)");
-    const pkg = "@" + "vercel/sandbox";
-    const mod = await dynamicImport(pkg);
+    const mod = await import("@vercel/sandbox");
     return mod.Sandbox ?? mod.default?.Sandbox ?? mod;
   } catch (err) {
-    throw new Error("Code Mode requires the optional peer dependency `@vercel/sandbox`. " + "Install it with `npm install @vercel/sandbox` (or `bun add @vercel/sandbox`).");
+    _sandboxImportError = err;
+    const detail = err instanceof Error ? `: ${err.message}` : "";
+    throw new Error("Code Mode failed to load `@vercel/sandbox`" + detail + ". Ensure the package is installed and reachable at runtime. On Next.js/Vercel, confirm it is listed in `dependencies` (not only `devDependencies`) and that the route using Code Mode runs in the Node.js runtime (not Edge).");
   }
 }
 var RESULT_SENTINEL = "__INTEGRATE_RESULT__";
@@ -4907,16 +4930,20 @@ async function diagnoseCodeMode(client) {
   }
   return { available: true };
 }
-var CODE_MODE_UNAVAILABLE_MESSAGES = {
-  "sandbox-missing": "[integrate-sdk] Code Mode unavailable (reason: sandbox-missing) — falling back to tool mode. " + "Install `@vercel/sandbox` (e.g. `bun add @vercel/sandbox`) to enable Code Mode.",
-  "no-public-url": "[integrate-sdk] Code Mode unavailable (reason: no-public-url) — falling back to tool mode. " + "Set `codeMode.publicUrl` on your server config or the `INTEGRATE_URL` env var."
-};
+function buildFallbackMessage(reason) {
+  if (reason === "no-public-url") {
+    return "[integrate-sdk] Code Mode unavailable (reason: no-public-url) — falling back to tool mode. " + "Set `codeMode.publicUrl` on your server config or the `INTEGRATE_URL` env var.";
+  }
+  const importError = getSandboxImportError();
+  const detail = importError instanceof Error ? ` Underlying import error: ${importError.message}` : importError ? ` Underlying import error: ${String(importError)}` : "";
+  return "[integrate-sdk] Code Mode unavailable (reason: sandbox-missing) — falling back to tool mode. " + "Ensure `@vercel/sandbox` is in `dependencies` and the route runs in the Node.js runtime (not Edge)." + detail;
+}
 var warnedCodeModeReasons = new Set;
 function warnCodeModeFallback(reason) {
   if (warnedCodeModeReasons.has(reason))
     return;
   warnedCodeModeReasons.add(reason);
-  console.warn(CODE_MODE_UNAVAILABLE_MESSAGES[reason]);
+  console.warn(buildFallbackMessage(reason));
 }
 function buildCodeModeTool(client, options) {
   const { tools, providerTokens, context, integrationIds } = options;

package/dist/ai/index.js

@@ -1,4 +1,20 @@
+import { createRequire } from "node:module";
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __toESM = (mod, isNodeMode, target) => {
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: () => mod[key],
+        enumerable: true
+      });
+  return to;
+};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
@@ -8,6 +24,7 @@ var __export = (target, all) => {
       set: (newValue) => all[name] = () => newValue
     });
 };
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // ../../node_modules/zod/v3/external.js
 var exports_external = {};
@@ -4692,7 +4709,11 @@ export { callTool };
 // ../code-mode/executor.ts
 var sandboxFactoryOverride = null;
 var _sandboxAvailableCache = null;
+var _sandboxImportError = null;
 var _sandboxForcedUnavailableForTests = false;
+function getSandboxImportError() {
+  return _sandboxImportError;
+}
 async function isSandboxAvailable() {
   if (_sandboxAvailableCache !== null)
     return _sandboxAvailableCache;
@@ -4702,15 +4723,17 @@ async function isSandboxAvailable() {
   }
   if (sandboxFactoryOverride) {
     _sandboxAvailableCache = true;
+    _sandboxImportError = null;
     return true;
   }
   try {
-    const dynamicImport = new Function("specifier", "return import(specifier)");
-    await dynamicImport("@" + "vercel/sandbox");
+    await import("@vercel/sandbox");
     _sandboxAvailableCache = true;
+    _sandboxImportError = null;
     return true;
-  } catch {
+  } catch (err) {
     _sandboxAvailableCache = false;
+    _sandboxImportError = err;
     return false;
   }
 }
@@ -4718,12 +4741,12 @@ async function loadSandboxFactory() {
   if (sandboxFactoryOverride)
     return sandboxFactoryOverride;
   try {
-    const dynamicImport = new Function("specifier", "return import(specifier)");
-    const pkg = "@" + "vercel/sandbox";
-    const mod = await dynamicImport(pkg);
+    const mod = await import("@vercel/sandbox");
     return mod.Sandbox ?? mod.default?.Sandbox ?? mod;
   } catch (err) {
-    throw new Error("Code Mode requires the optional peer dependency `@vercel/sandbox`. " + "Install it with `npm install @vercel/sandbox` (or `bun add @vercel/sandbox`).");
+    _sandboxImportError = err;
+    const detail = err instanceof Error ? `: ${err.message}` : "";
+    throw new Error("Code Mode failed to load `@vercel/sandbox`" + detail + ". Ensure the package is installed and reachable at runtime. On Next.js/Vercel, confirm it is listed in `dependencies` (not only `devDependencies`) and that the route using Code Mode runs in the Node.js runtime (not Edge).");
   }
 }
 var RESULT_SENTINEL = "__INTEGRATE_RESULT__";
@@ -4907,16 +4930,20 @@ async function diagnoseCodeMode(client) {
   }
   return { available: true };
 }
-var CODE_MODE_UNAVAILABLE_MESSAGES = {
-  "sandbox-missing": "[integrate-sdk] Code Mode unavailable (reason: sandbox-missing) — falling back to tool mode. " + "Install `@vercel/sandbox` (e.g. `bun add @vercel/sandbox`) to enable Code Mode.",
-  "no-public-url": "[integrate-sdk] Code Mode unavailable (reason: no-public-url) — falling back to tool mode. " + "Set `codeMode.publicUrl` on your server config or the `INTEGRATE_URL` env var."
-};
+function buildFallbackMessage(reason) {
+  if (reason === "no-public-url") {
+    return "[integrate-sdk] Code Mode unavailable (reason: no-public-url) — falling back to tool mode. " + "Set `codeMode.publicUrl` on your server config or the `INTEGRATE_URL` env var.";
+  }
+  const importError = getSandboxImportError();
+  const detail = importError instanceof Error ? ` Underlying import error: ${importError.message}` : importError ? ` Underlying import error: ${String(importError)}` : "";
+  return "[integrate-sdk] Code Mode unavailable (reason: sandbox-missing) — falling back to tool mode. " + "Ensure `@vercel/sandbox` is in `dependencies` and the route runs in the Node.js runtime (not Edge)." + detail;
+}
 var warnedCodeModeReasons = new Set;
 function warnCodeModeFallback(reason) {
   if (warnedCodeModeReasons.has(reason))
     return;
   warnedCodeModeReasons.add(reason);
-  console.warn(CODE_MODE_UNAVAILABLE_MESSAGES[reason]);
+  console.warn(buildFallbackMessage(reason));
 }
 function buildCodeModeTool(client, options) {
   const { tools, providerTokens, context, integrationIds } = options;

package/dist/ai/openai.js

@@ -1,4 +1,20 @@
+import { createRequire } from "node:module";
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __toESM = (mod, isNodeMode, target) => {
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: () => mod[key],
+        enumerable: true
+      });
+  return to;
+};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
@@ -8,6 +24,7 @@ var __export = (target, all) => {
       set: (newValue) => all[name] = () => newValue
     });
 };
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // ../../node_modules/zod/v3/external.js
 var exports_external = {};
@@ -4692,7 +4709,11 @@ export { callTool };
 // ../code-mode/executor.ts
 var sandboxFactoryOverride = null;
 var _sandboxAvailableCache = null;
+var _sandboxImportError = null;
 var _sandboxForcedUnavailableForTests = false;
+function getSandboxImportError() {
+  return _sandboxImportError;
+}
 async function isSandboxAvailable() {
   if (_sandboxAvailableCache !== null)
     return _sandboxAvailableCache;
@@ -4702,15 +4723,17 @@ async function isSandboxAvailable() {
   }
   if (sandboxFactoryOverride) {
     _sandboxAvailableCache = true;
+    _sandboxImportError = null;
     return true;
   }
   try {
-    const dynamicImport = new Function("specifier", "return import(specifier)");
-    await dynamicImport("@" + "vercel/sandbox");
+    await import("@vercel/sandbox");
     _sandboxAvailableCache = true;
+    _sandboxImportError = null;
     return true;
-  } catch {
+  } catch (err) {
     _sandboxAvailableCache = false;
+    _sandboxImportError = err;
     return false;
   }
 }
@@ -4718,12 +4741,12 @@ async function loadSandboxFactory() {
   if (sandboxFactoryOverride)
     return sandboxFactoryOverride;
   try {
-    const dynamicImport = new Function("specifier", "return import(specifier)");
-    const pkg = "@" + "vercel/sandbox";
-    const mod = await dynamicImport(pkg);
+    const mod = await import("@vercel/sandbox");
     return mod.Sandbox ?? mod.default?.Sandbox ?? mod;
   } catch (err) {
-    throw new Error("Code Mode requires the optional peer dependency `@vercel/sandbox`. " + "Install it with `npm install @vercel/sandbox` (or `bun add @vercel/sandbox`).");
+    _sandboxImportError = err;
+    const detail = err instanceof Error ? `: ${err.message}` : "";
+    throw new Error("Code Mode failed to load `@vercel/sandbox`" + detail + ". Ensure the package is installed and reachable at runtime. On Next.js/Vercel, confirm it is listed in `dependencies` (not only `devDependencies`) and that the route using Code Mode runs in the Node.js runtime (not Edge).");
   }
 }
 var RESULT_SENTINEL = "__INTEGRATE_RESULT__";
@@ -4907,16 +4930,20 @@ async function diagnoseCodeMode(client) {
   }
   return { available: true };
 }
-var CODE_MODE_UNAVAILABLE_MESSAGES = {
-  "sandbox-missing": "[integrate-sdk] Code Mode unavailable (reason: sandbox-missing) — falling back to tool mode. " + "Install `@vercel/sandbox` (e.g. `bun add @vercel/sandbox`) to enable Code Mode.",
-  "no-public-url": "[integrate-sdk] Code Mode unavailable (reason: no-public-url) — falling back to tool mode. " + "Set `codeMode.publicUrl` on your server config or the `INTEGRATE_URL` env var."
-};
+function buildFallbackMessage(reason) {
+  if (reason === "no-public-url") {
+    return "[integrate-sdk] Code Mode unavailable (reason: no-public-url) — falling back to tool mode. " + "Set `codeMode.publicUrl` on your server config or the `INTEGRATE_URL` env var.";
+  }
+  const importError = getSandboxImportError();
+  const detail = importError instanceof Error ? ` Underlying import error: ${importError.message}` : importError ? ` Underlying import error: ${String(importError)}` : "";
+  return "[integrate-sdk] Code Mode unavailable (reason: sandbox-missing) — falling back to tool mode. " + "Ensure `@vercel/sandbox` is in `dependencies` and the route runs in the Node.js runtime (not Edge)." + detail;
+}
 var warnedCodeModeReasons = new Set;
 function warnCodeModeFallback(reason) {
   if (warnedCodeModeReasons.has(reason))
     return;
   warnedCodeModeReasons.add(reason);
-  console.warn(CODE_MODE_UNAVAILABLE_MESSAGES[reason]);
+  console.warn(buildFallbackMessage(reason));
 }
 function buildCodeModeTool(client, options) {
   const { tools, providerTokens, context, integrationIds } = options;

package/dist/ai/trigger-tools.js

@@ -1,4 +1,20 @@
+import { createRequire } from "node:module";
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __toESM = (mod, isNodeMode, target) => {
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: () => mod[key],
+        enumerable: true
+      });
+  return to;
+};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
@@ -8,6 +24,7 @@ var __export = (target, all) => {
       set: (newValue) => all[name] = () => newValue
     });
 };
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // ../../node_modules/zod/v3/external.js
 var exports_external = {};

package/dist/ai/utils.js

@@ -1,4 +1,20 @@
+import { createRequire } from "node:module";
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __toESM = (mod, isNodeMode, target) => {
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: () => mod[key],
+        enumerable: true
+      });
+  return to;
+};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
@@ -8,6 +24,7 @@ var __export = (target, all) => {
       set: (newValue) => all[name] = () => newValue
     });
 };
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // ../../node_modules/zod/v3/external.js
 var exports_external = {};

package/dist/ai/vercel-ai.js

@@ -1,4 +1,20 @@
+import { createRequire } from "node:module";
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __toESM = (mod, isNodeMode, target) => {
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: () => mod[key],
+        enumerable: true
+      });
+  return to;
+};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
@@ -8,6 +24,7 @@ var __export = (target, all) => {
       set: (newValue) => all[name] = () => newValue
     });
 };
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // ../../node_modules/zod/v3/external.js
 var exports_external = {};
@@ -4692,7 +4709,11 @@ export { callTool };
 // ../code-mode/executor.ts
 var sandboxFactoryOverride = null;
 var _sandboxAvailableCache = null;
+var _sandboxImportError = null;
 var _sandboxForcedUnavailableForTests = false;
+function getSandboxImportError() {
+  return _sandboxImportError;
+}
 async function isSandboxAvailable() {
   if (_sandboxAvailableCache !== null)
     return _sandboxAvailableCache;
@@ -4702,15 +4723,17 @@ async function isSandboxAvailable() {
   }
   if (sandboxFactoryOverride) {
     _sandboxAvailableCache = true;
+    _sandboxImportError = null;
     return true;
   }
   try {
-    const dynamicImport = new Function("specifier", "return import(specifier)");
-    await dynamicImport("@" + "vercel/sandbox");
+    await import("@vercel/sandbox");
     _sandboxAvailableCache = true;
+    _sandboxImportError = null;
     return true;
-  } catch {
+  } catch (err) {
     _sandboxAvailableCache = false;
+    _sandboxImportError = err;
     return false;
   }
 }
@@ -4718,12 +4741,12 @@ async function loadSandboxFactory() {
   if (sandboxFactoryOverride)
     return sandboxFactoryOverride;
   try {
-    const dynamicImport = new Function("specifier", "return import(specifier)");
-    const pkg = "@" + "vercel/sandbox";
-    const mod = await dynamicImport(pkg);
+    const mod = await import("@vercel/sandbox");
     return mod.Sandbox ?? mod.default?.Sandbox ?? mod;
   } catch (err) {
-    throw new Error("Code Mode requires the optional peer dependency `@vercel/sandbox`. " + "Install it with `npm install @vercel/sandbox` (or `bun add @vercel/sandbox`).");
+    _sandboxImportError = err;
+    const detail = err instanceof Error ? `: ${err.message}` : "";
+    throw new Error("Code Mode failed to load `@vercel/sandbox`" + detail + ". Ensure the package is installed and reachable at runtime. On Next.js/Vercel, confirm it is listed in `dependencies` (not only `devDependencies`) and that the route using Code Mode runs in the Node.js runtime (not Edge).");
   }
 }
 var RESULT_SENTINEL = "__INTEGRATE_RESULT__";
@@ -4907,16 +4930,20 @@ async function diagnoseCodeMode(client) {
   }
   return { available: true };
 }
-var CODE_MODE_UNAVAILABLE_MESSAGES = {
-  "sandbox-missing": "[integrate-sdk] Code Mode unavailable (reason: sandbox-missing) — falling back to tool mode. " + "Install `@vercel/sandbox` (e.g. `bun add @vercel/sandbox`) to enable Code Mode.",
-  "no-public-url": "[integrate-sdk] Code Mode unavailable (reason: no-public-url) — falling back to tool mode. " + "Set `codeMode.publicUrl` on your server config or the `INTEGRATE_URL` env var."
-};
+function buildFallbackMessage(reason) {
+  if (reason === "no-public-url") {
+    return "[integrate-sdk] Code Mode unavailable (reason: no-public-url) — falling back to tool mode. " + "Set `codeMode.publicUrl` on your server config or the `INTEGRATE_URL` env var.";
+  }
+  const importError = getSandboxImportError();
+  const detail = importError instanceof Error ? ` Underlying import error: ${importError.message}` : importError ? ` Underlying import error: ${String(importError)}` : "";
+  return "[integrate-sdk] Code Mode unavailable (reason: sandbox-missing) — falling back to tool mode. " + "Ensure `@vercel/sandbox` is in `dependencies` and the route runs in the Node.js runtime (not Edge)." + detail;
+}
 var warnedCodeModeReasons = new Set;
 function warnCodeModeFallback(reason) {
   if (warnedCodeModeReasons.has(reason))
     return;
   warnedCodeModeReasons.add(reason);
-  console.warn(CODE_MODE_UNAVAILABLE_MESSAGES[reason]);
+  console.warn(buildFallbackMessage(reason));
 }
 function buildCodeModeTool(client, options) {
   const { tools, providerTokens, context, integrationIds } = options;

package/dist/code-mode/executor.d.ts

@@ -45,6 +45,14 @@ interface SandboxFactory {
 export declare function __setSandboxFactoryForTests(factory: SandboxFactory | null): void;
 /** @internal — used by unit tests to simulate missing @vercel/sandbox. */
 export declare function __setSandboxUnavailableForTests(force: boolean): void;
+/**
+ * Returns the most recent error observed while attempting to import
+ * `@vercel/sandbox`. Useful for surfacing the root cause when the availability
+ * check returns `false` — the warning in `tool-builder.ts` pipes this through
+ * to the user so they don't have to guess whether it's a missing package, a
+ * bundler issue, or a runtime restriction.
+ */
+export declare function getSandboxImportError(): unknown;
 export declare function isSandboxAvailable(): Promise<boolean>;
 export interface ExecuteSandboxCodeOptions {
     /** Source code the LLM produced. Treated as an async function body. */

package/dist/code-mode/executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/code-mode/executor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/code-mode/executor.ts"],"names":[],"mappings":"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"}