integrate-sdk 0.9.8-dev.0 → 0.9.9-dev.0

package/dist/adapters/auto-routes.js

@@ -8784,12 +8784,22 @@ function resolveCodeModeClientConfig(client) {
   const oauthConfig = client.__oauthConfig;
   return oauthConfig?.codeMode ?? {};
 }
-async function canUseCodeMode(client) {
-  if (!await isSandboxAvailable())
-    return false;
+async function diagnoseCodeMode(client) {
+  if (!await isSandboxAvailable()) {
+    return { available: false, reason: "sandbox-missing" };
+  }
   const serverConfig = resolveCodeModeClientConfig(client);
   const publicUrl = serverConfig.publicUrl ?? getEnv("INTEGRATE_PUBLIC_URL");
-  return !!publicUrl;
+  if (!publicUrl) {
+    return { available: false, reason: "no-public-url" };
+  }
+  return { available: true };
+}
+function warnCodeModeFallback(reason) {
+  if (warnedCodeModeReasons.has(reason))
+    return;
+  warnedCodeModeReasons.add(reason);
+  console.warn(CODE_MODE_UNAVAILABLE_MESSAGES[reason]);
 }
 function buildCodeModeTool(client, options) {
   const { tools, providerTokens, context, integrationIds } = options;
@@ -8845,7 +8855,7 @@ ${generated.source}
     execute
   };
 }
-var CODE_MODE_TOOL_NAME = "execute_code", DEFAULT_INSTRUCTIONS;
+var CODE_MODE_TOOL_NAME = "execute_code", DEFAULT_INSTRUCTIONS, CODE_MODE_UNAVAILABLE_MESSAGES, warnedCodeModeReasons;
 var init_tool_builder = __esm(() => {
   init_type_generator();
   init_executor();
@@ -8870,6 +8880,11 @@ var init_tool_builder = __esm(() => {
     "API surface:"
   ].join(`
 `);
+  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_PUBLIC_URL` env var."
+  };
+  warnedCodeModeReasons = new Set;
 });
 
 // ../ai/vercel-ai.ts
@@ -8896,7 +8911,18 @@ async function getVercelAITools(client, options) {
   await ensureClientConnected(client);
   const mcpTools = await client.getEnabledToolsAsync();
   const vercelTools = {};
-  const effectiveMode = options?.mode !== undefined ? options.mode : await canUseCodeMode(client) ? "code" : "tools";
+  let effectiveMode;
+  if (options?.mode !== undefined) {
+    effectiveMode = options.mode;
+  } else {
+    const diagnosis = await diagnoseCodeMode(client);
+    if (diagnosis.available) {
+      effectiveMode = "code";
+    } else {
+      warnCodeModeFallback(diagnosis.reason);
+      effectiveMode = "tools";
+    }
+  }
   if (effectiveMode === "code") {
     const codeTool = buildCodeModeTool(client, {
       tools: mcpTools,
@@ -10355,7 +10381,18 @@ async function getOpenAITools(client, options) {
   const finalOptions = providerTokens ? { ...options, providerTokens } : options;
   await ensureClientConnected(client);
   const mcpTools = await client.getEnabledToolsAsync();
-  const effectiveMode = options?.mode !== undefined ? options.mode : await canUseCodeMode(client) ? "code" : "tools";
+  let effectiveMode;
+  if (options?.mode !== undefined) {
+    effectiveMode = options.mode;
+  } else {
+    const diagnosis = await diagnoseCodeMode(client);
+    if (diagnosis.available) {
+      effectiveMode = "code";
+    } else {
+      warnCodeModeFallback(diagnosis.reason);
+      effectiveMode = "tools";
+    }
+  }
   const openaiTools = effectiveMode === "code" ? (() => {
     const codeTool = buildCodeModeTool(client, {
       tools: mcpTools,
@@ -10535,7 +10572,18 @@ async function getAnthropicTools(client, options) {
   const finalOptions = providerTokens ? { ...options, providerTokens } : options;
   await ensureClientConnected(client);
   const mcpTools = await client.getEnabledToolsAsync();
-  const effectiveMode = options?.mode !== undefined ? options.mode : await canUseCodeMode(client) ? "code" : "tools";
+  let effectiveMode;
+  if (options?.mode !== undefined) {
+    effectiveMode = options.mode;
+  } else {
+    const diagnosis = await diagnoseCodeMode(client);
+    if (diagnosis.available) {
+      effectiveMode = "code";
+    } else {
+      warnCodeModeFallback(diagnosis.reason);
+      effectiveMode = "tools";
+    }
+  }
   const anthropicTools = effectiveMode === "code" ? (() => {
     const codeTool = buildCodeModeTool(client, {
       tools: mcpTools,
@@ -10724,7 +10772,18 @@ async function getGoogleTools(client, options) {
   const finalOptions = providerTokens ? { ...options, providerTokens } : options;
   await ensureClientConnected(client);
   const mcpTools = await client.getEnabledToolsAsync();
-  const effectiveMode = options?.mode !== undefined ? options.mode : await canUseCodeMode(client) ? "code" : "tools";
+  let effectiveMode;
+  if (options?.mode !== undefined) {
+    effectiveMode = options.mode;
+  } else {
+    const diagnosis = await diagnoseCodeMode(client);
+    if (diagnosis.available) {
+      effectiveMode = "code";
+    } else {
+      warnCodeModeFallback(diagnosis.reason);
+      effectiveMode = "tools";
+    }
+  }
   let googleTools;
   if (effectiveMode === "code") {
     const TypeEnum = await getGoogleType();

package/dist/adapters/index.js

@@ -8784,12 +8784,22 @@ function resolveCodeModeClientConfig(client) {
   const oauthConfig = client.__oauthConfig;
   return oauthConfig?.codeMode ?? {};
 }
-async function canUseCodeMode(client) {
-  if (!await isSandboxAvailable())
-    return false;
+async function diagnoseCodeMode(client) {
+  if (!await isSandboxAvailable()) {
+    return { available: false, reason: "sandbox-missing" };
+  }
   const serverConfig = resolveCodeModeClientConfig(client);
   const publicUrl = serverConfig.publicUrl ?? getEnv("INTEGRATE_PUBLIC_URL");
-  return !!publicUrl;
+  if (!publicUrl) {
+    return { available: false, reason: "no-public-url" };
+  }
+  return { available: true };
+}
+function warnCodeModeFallback(reason) {
+  if (warnedCodeModeReasons.has(reason))
+    return;
+  warnedCodeModeReasons.add(reason);
+  console.warn(CODE_MODE_UNAVAILABLE_MESSAGES[reason]);
 }
 function buildCodeModeTool(client, options) {
   const { tools, providerTokens, context, integrationIds } = options;
@@ -8845,7 +8855,7 @@ ${generated.source}
     execute
   };
 }
-var CODE_MODE_TOOL_NAME = "execute_code", DEFAULT_INSTRUCTIONS;
+var CODE_MODE_TOOL_NAME = "execute_code", DEFAULT_INSTRUCTIONS, CODE_MODE_UNAVAILABLE_MESSAGES, warnedCodeModeReasons;
 var init_tool_builder = __esm(() => {
   init_type_generator();
   init_executor();
@@ -8870,6 +8880,11 @@ var init_tool_builder = __esm(() => {
     "API surface:"
   ].join(`
 `);
+  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_PUBLIC_URL` env var."
+  };
+  warnedCodeModeReasons = new Set;
 });
 
 // ../ai/vercel-ai.ts
@@ -8896,7 +8911,18 @@ async function getVercelAITools(client, options) {
   await ensureClientConnected(client);
   const mcpTools = await client.getEnabledToolsAsync();
   const vercelTools = {};
-  const effectiveMode = options?.mode !== undefined ? options.mode : await canUseCodeMode(client) ? "code" : "tools";
+  let effectiveMode;
+  if (options?.mode !== undefined) {
+    effectiveMode = options.mode;
+  } else {
+    const diagnosis = await diagnoseCodeMode(client);
+    if (diagnosis.available) {
+      effectiveMode = "code";
+    } else {
+      warnCodeModeFallback(diagnosis.reason);
+      effectiveMode = "tools";
+    }
+  }
   if (effectiveMode === "code") {
     const codeTool = buildCodeModeTool(client, {
       tools: mcpTools,
@@ -10355,7 +10381,18 @@ async function getOpenAITools(client, options) {
   const finalOptions = providerTokens ? { ...options, providerTokens } : options;
   await ensureClientConnected(client);
   const mcpTools = await client.getEnabledToolsAsync();
-  const effectiveMode = options?.mode !== undefined ? options.mode : await canUseCodeMode(client) ? "code" : "tools";
+  let effectiveMode;
+  if (options?.mode !== undefined) {
+    effectiveMode = options.mode;
+  } else {
+    const diagnosis = await diagnoseCodeMode(client);
+    if (diagnosis.available) {
+      effectiveMode = "code";
+    } else {
+      warnCodeModeFallback(diagnosis.reason);
+      effectiveMode = "tools";
+    }
+  }
   const openaiTools = effectiveMode === "code" ? (() => {
     const codeTool = buildCodeModeTool(client, {
       tools: mcpTools,
@@ -10535,7 +10572,18 @@ async function getAnthropicTools(client, options) {
   const finalOptions = providerTokens ? { ...options, providerTokens } : options;
   await ensureClientConnected(client);
   const mcpTools = await client.getEnabledToolsAsync();
-  const effectiveMode = options?.mode !== undefined ? options.mode : await canUseCodeMode(client) ? "code" : "tools";
+  let effectiveMode;
+  if (options?.mode !== undefined) {
+    effectiveMode = options.mode;
+  } else {
+    const diagnosis = await diagnoseCodeMode(client);
+    if (diagnosis.available) {
+      effectiveMode = "code";
+    } else {
+      warnCodeModeFallback(diagnosis.reason);
+      effectiveMode = "tools";
+    }
+  }
   const anthropicTools = effectiveMode === "code" ? (() => {
     const codeTool = buildCodeModeTool(client, {
       tools: mcpTools,
@@ -10724,7 +10772,18 @@ async function getGoogleTools(client, options) {
   const finalOptions = providerTokens ? { ...options, providerTokens } : options;
   await ensureClientConnected(client);
   const mcpTools = await client.getEnabledToolsAsync();
-  const effectiveMode = options?.mode !== undefined ? options.mode : await canUseCodeMode(client) ? "code" : "tools";
+  let effectiveMode;
+  if (options?.mode !== undefined) {
+    effectiveMode = options.mode;
+  } else {
+    const diagnosis = await diagnoseCodeMode(client);
+    if (diagnosis.available) {
+      effectiveMode = "code";
+    } else {
+      warnCodeModeFallback(diagnosis.reason);
+      effectiveMode = "tools";
+    }
+  }
   let googleTools;
   if (effectiveMode === "code") {
     const TypeEnum = await getGoogleType();

package/dist/adapters/nextjs.js

@@ -8784,12 +8784,22 @@ function resolveCodeModeClientConfig(client) {
   const oauthConfig = client.__oauthConfig;
   return oauthConfig?.codeMode ?? {};
 }
-async function canUseCodeMode(client) {
-  if (!await isSandboxAvailable())
-    return false;
+async function diagnoseCodeMode(client) {
+  if (!await isSandboxAvailable()) {
+    return { available: false, reason: "sandbox-missing" };
+  }
   const serverConfig = resolveCodeModeClientConfig(client);
   const publicUrl = serverConfig.publicUrl ?? getEnv("INTEGRATE_PUBLIC_URL");
-  return !!publicUrl;
+  if (!publicUrl) {
+    return { available: false, reason: "no-public-url" };
+  }
+  return { available: true };
+}
+function warnCodeModeFallback(reason) {
+  if (warnedCodeModeReasons.has(reason))
+    return;
+  warnedCodeModeReasons.add(reason);
+  console.warn(CODE_MODE_UNAVAILABLE_MESSAGES[reason]);
 }
 function buildCodeModeTool(client, options) {
   const { tools, providerTokens, context, integrationIds } = options;
@@ -8845,7 +8855,7 @@ ${generated.source}
     execute
   };
 }
-var CODE_MODE_TOOL_NAME = "execute_code", DEFAULT_INSTRUCTIONS;
+var CODE_MODE_TOOL_NAME = "execute_code", DEFAULT_INSTRUCTIONS, CODE_MODE_UNAVAILABLE_MESSAGES, warnedCodeModeReasons;
 var init_tool_builder = __esm(() => {
   init_type_generator();
   init_executor();
@@ -8870,6 +8880,11 @@ var init_tool_builder = __esm(() => {
     "API surface:"
   ].join(`
 `);
+  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_PUBLIC_URL` env var."
+  };
+  warnedCodeModeReasons = new Set;
 });
 
 // ../ai/vercel-ai.ts
@@ -8896,7 +8911,18 @@ async function getVercelAITools(client, options) {
   await ensureClientConnected(client);
   const mcpTools = await client.getEnabledToolsAsync();
   const vercelTools = {};
-  const effectiveMode = options?.mode !== undefined ? options.mode : await canUseCodeMode(client) ? "code" : "tools";
+  let effectiveMode;
+  if (options?.mode !== undefined) {
+    effectiveMode = options.mode;
+  } else {
+    const diagnosis = await diagnoseCodeMode(client);
+    if (diagnosis.available) {
+      effectiveMode = "code";
+    } else {
+      warnCodeModeFallback(diagnosis.reason);
+      effectiveMode = "tools";
+    }
+  }
   if (effectiveMode === "code") {
     const codeTool = buildCodeModeTool(client, {
       tools: mcpTools,
@@ -10355,7 +10381,18 @@ async function getOpenAITools(client, options) {
   const finalOptions = providerTokens ? { ...options, providerTokens } : options;
   await ensureClientConnected(client);
   const mcpTools = await client.getEnabledToolsAsync();
-  const effectiveMode = options?.mode !== undefined ? options.mode : await canUseCodeMode(client) ? "code" : "tools";
+  let effectiveMode;
+  if (options?.mode !== undefined) {
+    effectiveMode = options.mode;
+  } else {
+    const diagnosis = await diagnoseCodeMode(client);
+    if (diagnosis.available) {
+      effectiveMode = "code";
+    } else {
+      warnCodeModeFallback(diagnosis.reason);
+      effectiveMode = "tools";
+    }
+  }
   const openaiTools = effectiveMode === "code" ? (() => {
     const codeTool = buildCodeModeTool(client, {
       tools: mcpTools,
@@ -10535,7 +10572,18 @@ async function getAnthropicTools(client, options) {
   const finalOptions = providerTokens ? { ...options, providerTokens } : options;
   await ensureClientConnected(client);
   const mcpTools = await client.getEnabledToolsAsync();
-  const effectiveMode = options?.mode !== undefined ? options.mode : await canUseCodeMode(client) ? "code" : "tools";
+  let effectiveMode;
+  if (options?.mode !== undefined) {
+    effectiveMode = options.mode;
+  } else {
+    const diagnosis = await diagnoseCodeMode(client);
+    if (diagnosis.available) {
+      effectiveMode = "code";
+    } else {
+      warnCodeModeFallback(diagnosis.reason);
+      effectiveMode = "tools";
+    }
+  }
   const anthropicTools = effectiveMode === "code" ? (() => {
     const codeTool = buildCodeModeTool(client, {
       tools: mcpTools,
@@ -10724,7 +10772,18 @@ async function getGoogleTools(client, options) {
   const finalOptions = providerTokens ? { ...options, providerTokens } : options;
   await ensureClientConnected(client);
   const mcpTools = await client.getEnabledToolsAsync();
-  const effectiveMode = options?.mode !== undefined ? options.mode : await canUseCodeMode(client) ? "code" : "tools";
+  let effectiveMode;
+  if (options?.mode !== undefined) {
+    effectiveMode = options.mode;
+  } else {
+    const diagnosis = await diagnoseCodeMode(client);
+    if (diagnosis.available) {
+      effectiveMode = "code";
+    } else {
+      warnCodeModeFallback(diagnosis.reason);
+      effectiveMode = "tools";
+    }
+  }
   let googleTools;
   if (effectiveMode === "code") {
     const TypeEnum = await getGoogleType();

package/dist/adapters/node.js

@@ -8784,12 +8784,22 @@ function resolveCodeModeClientConfig(client) {
   const oauthConfig = client.__oauthConfig;
   return oauthConfig?.codeMode ?? {};
 }
-async function canUseCodeMode(client) {
-  if (!await isSandboxAvailable())
-    return false;
+async function diagnoseCodeMode(client) {
+  if (!await isSandboxAvailable()) {
+    return { available: false, reason: "sandbox-missing" };
+  }
   const serverConfig = resolveCodeModeClientConfig(client);
   const publicUrl = serverConfig.publicUrl ?? getEnv("INTEGRATE_PUBLIC_URL");
-  return !!publicUrl;
+  if (!publicUrl) {
+    return { available: false, reason: "no-public-url" };
+  }
+  return { available: true };
+}
+function warnCodeModeFallback(reason) {
+  if (warnedCodeModeReasons.has(reason))
+    return;
+  warnedCodeModeReasons.add(reason);
+  console.warn(CODE_MODE_UNAVAILABLE_MESSAGES[reason]);
 }
 function buildCodeModeTool(client, options) {
   const { tools, providerTokens, context, integrationIds } = options;
@@ -8845,7 +8855,7 @@ ${generated.source}
     execute
   };
 }
-var CODE_MODE_TOOL_NAME = "execute_code", DEFAULT_INSTRUCTIONS;
+var CODE_MODE_TOOL_NAME = "execute_code", DEFAULT_INSTRUCTIONS, CODE_MODE_UNAVAILABLE_MESSAGES, warnedCodeModeReasons;
 var init_tool_builder = __esm(() => {
   init_type_generator();
   init_executor();
@@ -8870,6 +8880,11 @@ var init_tool_builder = __esm(() => {
     "API surface:"
   ].join(`
 `);
+  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_PUBLIC_URL` env var."
+  };
+  warnedCodeModeReasons = new Set;
 });
 
 // ../ai/vercel-ai.ts
@@ -8896,7 +8911,18 @@ async function getVercelAITools(client, options) {
   await ensureClientConnected(client);
   const mcpTools = await client.getEnabledToolsAsync();
   const vercelTools = {};
-  const effectiveMode = options?.mode !== undefined ? options.mode : await canUseCodeMode(client) ? "code" : "tools";
+  let effectiveMode;
+  if (options?.mode !== undefined) {
+    effectiveMode = options.mode;
+  } else {
+    const diagnosis = await diagnoseCodeMode(client);
+    if (diagnosis.available) {
+      effectiveMode = "code";
+    } else {
+      warnCodeModeFallback(diagnosis.reason);
+      effectiveMode = "tools";
+    }
+  }
   if (effectiveMode === "code") {
     const codeTool = buildCodeModeTool(client, {
       tools: mcpTools,
@@ -10355,7 +10381,18 @@ async function getOpenAITools(client, options) {
   const finalOptions = providerTokens ? { ...options, providerTokens } : options;
   await ensureClientConnected(client);
   const mcpTools = await client.getEnabledToolsAsync();
-  const effectiveMode = options?.mode !== undefined ? options.mode : await canUseCodeMode(client) ? "code" : "tools";
+  let effectiveMode;
+  if (options?.mode !== undefined) {
+    effectiveMode = options.mode;
+  } else {
+    const diagnosis = await diagnoseCodeMode(client);
+    if (diagnosis.available) {
+      effectiveMode = "code";
+    } else {
+      warnCodeModeFallback(diagnosis.reason);
+      effectiveMode = "tools";
+    }
+  }
   const openaiTools = effectiveMode === "code" ? (() => {
     const codeTool = buildCodeModeTool(client, {
       tools: mcpTools,
@@ -10535,7 +10572,18 @@ async function getAnthropicTools(client, options) {
   const finalOptions = providerTokens ? { ...options, providerTokens } : options;
   await ensureClientConnected(client);
   const mcpTools = await client.getEnabledToolsAsync();
-  const effectiveMode = options?.mode !== undefined ? options.mode : await canUseCodeMode(client) ? "code" : "tools";
+  let effectiveMode;
+  if (options?.mode !== undefined) {
+    effectiveMode = options.mode;
+  } else {
+    const diagnosis = await diagnoseCodeMode(client);
+    if (diagnosis.available) {
+      effectiveMode = "code";
+    } else {
+      warnCodeModeFallback(diagnosis.reason);
+      effectiveMode = "tools";
+    }
+  }
   const anthropicTools = effectiveMode === "code" ? (() => {
     const codeTool = buildCodeModeTool(client, {
       tools: mcpTools,
@@ -10724,7 +10772,18 @@ async function getGoogleTools(client, options) {
   const finalOptions = providerTokens ? { ...options, providerTokens } : options;
   await ensureClientConnected(client);
   const mcpTools = await client.getEnabledToolsAsync();
-  const effectiveMode = options?.mode !== undefined ? options.mode : await canUseCodeMode(client) ? "code" : "tools";
+  let effectiveMode;
+  if (options?.mode !== undefined) {
+    effectiveMode = options.mode;
+  } else {
+    const diagnosis = await diagnoseCodeMode(client);
+    if (diagnosis.available) {
+      effectiveMode = "code";
+    } else {
+      warnCodeModeFallback(diagnosis.reason);
+      effectiveMode = "tools";
+    }
+  }
   let googleTools;
   if (effectiveMode === "code") {
     const TypeEnum = await getGoogleType();

package/dist/adapters/svelte-kit.js

@@ -8784,12 +8784,22 @@ function resolveCodeModeClientConfig(client) {
   const oauthConfig = client.__oauthConfig;
   return oauthConfig?.codeMode ?? {};
 }
-async function canUseCodeMode(client) {
-  if (!await isSandboxAvailable())
-    return false;
+async function diagnoseCodeMode(client) {
+  if (!await isSandboxAvailable()) {
+    return { available: false, reason: "sandbox-missing" };
+  }
   const serverConfig = resolveCodeModeClientConfig(client);
   const publicUrl = serverConfig.publicUrl ?? getEnv("INTEGRATE_PUBLIC_URL");
-  return !!publicUrl;
+  if (!publicUrl) {
+    return { available: false, reason: "no-public-url" };
+  }
+  return { available: true };
+}
+function warnCodeModeFallback(reason) {
+  if (warnedCodeModeReasons.has(reason))
+    return;
+  warnedCodeModeReasons.add(reason);
+  console.warn(CODE_MODE_UNAVAILABLE_MESSAGES[reason]);
 }
 function buildCodeModeTool(client, options) {
   const { tools, providerTokens, context, integrationIds } = options;
@@ -8845,7 +8855,7 @@ ${generated.source}
     execute
   };
 }
-var CODE_MODE_TOOL_NAME = "execute_code", DEFAULT_INSTRUCTIONS;
+var CODE_MODE_TOOL_NAME = "execute_code", DEFAULT_INSTRUCTIONS, CODE_MODE_UNAVAILABLE_MESSAGES, warnedCodeModeReasons;
 var init_tool_builder = __esm(() => {
   init_type_generator();
   init_executor();
@@ -8870,6 +8880,11 @@ var init_tool_builder = __esm(() => {
     "API surface:"
   ].join(`
 `);
+  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_PUBLIC_URL` env var."
+  };
+  warnedCodeModeReasons = new Set;
 });
 
 // ../ai/vercel-ai.ts
@@ -8896,7 +8911,18 @@ async function getVercelAITools(client, options) {
   await ensureClientConnected(client);
   const mcpTools = await client.getEnabledToolsAsync();
   const vercelTools = {};
-  const effectiveMode = options?.mode !== undefined ? options.mode : await canUseCodeMode(client) ? "code" : "tools";
+  let effectiveMode;
+  if (options?.mode !== undefined) {
+    effectiveMode = options.mode;
+  } else {
+    const diagnosis = await diagnoseCodeMode(client);
+    if (diagnosis.available) {
+      effectiveMode = "code";
+    } else {
+      warnCodeModeFallback(diagnosis.reason);
+      effectiveMode = "tools";
+    }
+  }
   if (effectiveMode === "code") {
     const codeTool = buildCodeModeTool(client, {
       tools: mcpTools,
@@ -10355,7 +10381,18 @@ async function getOpenAITools(client, options) {
   const finalOptions = providerTokens ? { ...options, providerTokens } : options;
   await ensureClientConnected(client);
   const mcpTools = await client.getEnabledToolsAsync();
-  const effectiveMode = options?.mode !== undefined ? options.mode : await canUseCodeMode(client) ? "code" : "tools";
+  let effectiveMode;
+  if (options?.mode !== undefined) {
+    effectiveMode = options.mode;
+  } else {
+    const diagnosis = await diagnoseCodeMode(client);
+    if (diagnosis.available) {
+      effectiveMode = "code";
+    } else {
+      warnCodeModeFallback(diagnosis.reason);
+      effectiveMode = "tools";
+    }
+  }
   const openaiTools = effectiveMode === "code" ? (() => {
     const codeTool = buildCodeModeTool(client, {
       tools: mcpTools,
@@ -10535,7 +10572,18 @@ async function getAnthropicTools(client, options) {
   const finalOptions = providerTokens ? { ...options, providerTokens } : options;
   await ensureClientConnected(client);
   const mcpTools = await client.getEnabledToolsAsync();
-  const effectiveMode = options?.mode !== undefined ? options.mode : await canUseCodeMode(client) ? "code" : "tools";
+  let effectiveMode;
+  if (options?.mode !== undefined) {
+    effectiveMode = options.mode;
+  } else {
+    const diagnosis = await diagnoseCodeMode(client);
+    if (diagnosis.available) {
+      effectiveMode = "code";
+    } else {
+      warnCodeModeFallback(diagnosis.reason);
+      effectiveMode = "tools";
+    }
+  }
   const anthropicTools = effectiveMode === "code" ? (() => {
     const codeTool = buildCodeModeTool(client, {
       tools: mcpTools,
@@ -10724,7 +10772,18 @@ async function getGoogleTools(client, options) {
   const finalOptions = providerTokens ? { ...options, providerTokens } : options;
   await ensureClientConnected(client);
   const mcpTools = await client.getEnabledToolsAsync();
-  const effectiveMode = options?.mode !== undefined ? options.mode : await canUseCodeMode(client) ? "code" : "tools";
+  let effectiveMode;
+  if (options?.mode !== undefined) {
+    effectiveMode = options.mode;
+  } else {
+    const diagnosis = await diagnoseCodeMode(client);
+    if (diagnosis.available) {
+      effectiveMode = "code";
+    } else {
+      warnCodeModeFallback(diagnosis.reason);
+      effectiveMode = "tools";
+    }
+  }
   let googleTools;
   if (effectiveMode === "code") {
     const TypeEnum = await getGoogleType();