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

package/dist/code-mode/executor.js

@@ -1,3 +1,22 @@
+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 __require = /* @__PURE__ */ createRequire(import.meta.url);
+
 // runtime-stub.ts
 var RUNTIME_STUB_SOURCE = `// runtime.mjs — generated by integrate-sdk code mode
 const MCP_URL = process.env.INTEGRATE_MCP_URL;
@@ -73,15 +92,21 @@ export { callTool };
 // executor.ts
 var sandboxFactoryOverride = null;
 var _sandboxAvailableCache = null;
+var _sandboxImportError = null;
 var _sandboxForcedUnavailableForTests = false;
 function __setSandboxFactoryForTests(factory) {
   sandboxFactoryOverride = factory;
   _sandboxForcedUnavailableForTests = false;
   _sandboxAvailableCache = null;
+  _sandboxImportError = null;
 }
 function __setSandboxUnavailableForTests(force) {
   _sandboxForcedUnavailableForTests = force;
   _sandboxAvailableCache = null;
+  _sandboxImportError = force ? new Error("Sandbox forced unavailable by test seam.") : null;
+}
+function getSandboxImportError() {
+  return _sandboxImportError;
 }
 async function isSandboxAvailable() {
   if (_sandboxAvailableCache !== null)
@@ -92,15 +117,22 @@ async function isSandboxAvailable() {
   }
   if (sandboxFactoryOverride) {
     _sandboxAvailableCache = true;
+    _sandboxImportError = null;
     return true;
   }
+  if (typeof window !== "undefined") {
+    _sandboxAvailableCache = false;
+    _sandboxImportError = new Error("Sandbox is not available in browser environments.");
+    return false;
+  }
   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;
   }
 }
@@ -108,12 +140,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__";
@@ -236,6 +268,7 @@ async function executeSandboxCode(options) {
 }
 export {
   isSandboxAvailable,
+  getSandboxImportError,
   executeSandboxCode,
   __setSandboxUnavailableForTests,
   __setSandboxFactoryForTests

package/dist/code-mode/index.js

@@ -1,3 +1,22 @@
+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 __require = /* @__PURE__ */ createRequire(import.meta.url);
+
 // ../utils/naming.ts
 function snakeToCamel(str) {
   return str.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());
@@ -288,15 +307,21 @@ export { callTool };
 // executor.ts
 var sandboxFactoryOverride = null;
 var _sandboxAvailableCache = null;
+var _sandboxImportError = null;
 var _sandboxForcedUnavailableForTests = false;
 function __setSandboxFactoryForTests(factory) {
   sandboxFactoryOverride = factory;
   _sandboxForcedUnavailableForTests = false;
   _sandboxAvailableCache = null;
+  _sandboxImportError = null;
 }
 function __setSandboxUnavailableForTests(force) {
   _sandboxForcedUnavailableForTests = force;
   _sandboxAvailableCache = null;
+  _sandboxImportError = force ? new Error("Sandbox forced unavailable by test seam.") : null;
+}
+function getSandboxImportError() {
+  return _sandboxImportError;
 }
 async function isSandboxAvailable() {
   if (_sandboxAvailableCache !== null)
@@ -307,15 +332,22 @@ async function isSandboxAvailable() {
   }
   if (sandboxFactoryOverride) {
     _sandboxAvailableCache = true;
+    _sandboxImportError = null;
     return true;
   }
+  if (typeof window !== "undefined") {
+    _sandboxAvailableCache = false;
+    _sandboxImportError = new Error("Sandbox is not available in browser environments.");
+    return false;
+  }
   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;
   }
 }
@@ -323,12 +355,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__";
@@ -515,10 +547,14 @@ async function diagnoseCodeMode(client) {
 async function canUseCodeMode(client) {
   return (await diagnoseCodeMode(client)).available;
 }
-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 __resetCodeModeFallbackWarnings() {
   warnedCodeModeReasons.clear();
@@ -527,7 +563,7 @@ 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/runtime-stub.js

@@ -1,3 +1,22 @@
+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 __require = /* @__PURE__ */ createRequire(import.meta.url);
+
 // runtime-stub.ts
 var RUNTIME_STUB_SOURCE = `// runtime.mjs — generated by integrate-sdk code mode
 const MCP_URL = process.env.INTEGRATE_MCP_URL;

package/dist/code-mode/tool-builder.d.ts.map

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

package/dist/code-mode/tool-builder.js

@@ -1,3 +1,22 @@
+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 __require = /* @__PURE__ */ createRequire(import.meta.url);
+
 // ../utils/naming.ts
 function snakeToCamel(str) {
   return str.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());
@@ -288,15 +307,21 @@ export { callTool };
 // executor.ts
 var sandboxFactoryOverride = null;
 var _sandboxAvailableCache = null;
+var _sandboxImportError = null;
 var _sandboxForcedUnavailableForTests = false;
 function __setSandboxFactoryForTests(factory) {
   sandboxFactoryOverride = factory;
   _sandboxForcedUnavailableForTests = false;
   _sandboxAvailableCache = null;
+  _sandboxImportError = null;
 }
 function __setSandboxUnavailableForTests(force) {
   _sandboxForcedUnavailableForTests = force;
   _sandboxAvailableCache = null;
+  _sandboxImportError = force ? new Error("Sandbox forced unavailable by test seam.") : null;
+}
+function getSandboxImportError() {
+  return _sandboxImportError;
 }
 async function isSandboxAvailable() {
   if (_sandboxAvailableCache !== null)
@@ -307,15 +332,22 @@ async function isSandboxAvailable() {
   }
   if (sandboxFactoryOverride) {
     _sandboxAvailableCache = true;
+    _sandboxImportError = null;
     return true;
   }
+  if (typeof window !== "undefined") {
+    _sandboxAvailableCache = false;
+    _sandboxImportError = new Error("Sandbox is not available in browser environments.");
+    return false;
+  }
   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;
   }
 }
@@ -323,12 +355,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__";
@@ -515,10 +547,14 @@ async function diagnoseCodeMode(client) {
 async function canUseCodeMode(client) {
   return (await diagnoseCodeMode(client)).available;
 }
-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 __resetCodeModeFallbackWarnings() {
   warnedCodeModeReasons.clear();
@@ -527,7 +563,7 @@ 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/type-generator.js

@@ -1,3 +1,22 @@
+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 __require = /* @__PURE__ */ createRequire(import.meta.url);
+
 // ../utils/naming.ts
 function snakeToCamel(str) {
   return str.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());