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

package/dist/ai/google.js

@@ -4251,7 +4251,7 @@ function calculateHasMore(offset, returnedCount, total) {
 function createTriggerTools(config, context) {
   const { callbacks } = config;
   return {
-    create_trigger: {
+    trigger_create: {
       description: "Schedule a tool to run at a specific time or on a recurring schedule. Use this when the user wants to do something later.",
       inputSchema: exports_external.object({
         name: exports_external.string().optional().describe("Human-readable trigger name"),
@@ -4285,7 +4285,7 @@ function createTriggerTools(config, context) {
         return callbacks.create(trigger, context);
       }
     },
-    list_triggers: {
+    trigger_list: {
       description: "List all scheduled triggers with optional filtering by status or tool name",
       inputSchema: exports_external.object({
         status: exports_external.enum(["active", "paused", "completed", "failed"]).optional().describe("Filter by trigger status"),
@@ -4309,7 +4309,7 @@ function createTriggerTools(config, context) {
         };
       }
     },
-    get_trigger: {
+    trigger_get: {
       description: "Get details of a specific trigger by its ID",
       inputSchema: exports_external.object({
         triggerId: exports_external.string().describe("The trigger ID to retrieve")
@@ -4322,7 +4322,7 @@ function createTriggerTools(config, context) {
         return trigger;
       }
     },
-    update_trigger: {
+    trigger_update: {
       description: "Update a trigger's properties like name, description, arguments, or schedule",
       inputSchema: exports_external.object({
         triggerId: exports_external.string().describe("The trigger ID to update"),
@@ -4349,7 +4349,7 @@ function createTriggerTools(config, context) {
         return callbacks.update(triggerId, updatesWithTimestamp, context);
       }
     },
-    delete_trigger: {
+    trigger_delete: {
       description: "Delete a trigger permanently. This cannot be undone.",
       inputSchema: exports_external.object({
         triggerId: exports_external.string().describe("The trigger ID to delete")
@@ -4359,7 +4359,7 @@ function createTriggerTools(config, context) {
         return { success: true, message: `Trigger ${args.triggerId} deleted` };
       }
     },
-    pause_trigger: {
+    trigger_pause: {
       description: "Pause a trigger to temporarily stop it from executing. Can be resumed later.",
       inputSchema: exports_external.object({
         triggerId: exports_external.string().describe("The trigger ID to pause")
@@ -4379,7 +4379,7 @@ function createTriggerTools(config, context) {
         }, context);
       }
     },
-    resume_trigger: {
+    trigger_resume: {
       description: "Resume a paused trigger to start executing it again on schedule",
       inputSchema: exports_external.object({
         triggerId: exports_external.string().describe("The trigger ID to resume")
@@ -4621,6 +4621,7 @@ function pascalCase(id) {
 var RUNTIME_STUB_SOURCE = `// runtime.mjs — generated by integrate-sdk code mode
 const MCP_URL = process.env.INTEGRATE_MCP_URL;
 const SESSION_TOKEN = process.env.INTEGRATE_SESSION_TOKEN;
+const API_KEY = process.env.INTEGRATE_API_KEY || '';
 const PROVIDER_TOKENS = process.env.INTEGRATE_PROVIDER_TOKENS || '';
 const INTEGRATIONS_HEADER = process.env.INTEGRATE_INTEGRATIONS || '';
 const CONTEXT_JSON = process.env.INTEGRATE_CONTEXT || '';
@@ -4639,6 +4640,7 @@ async function callTool(toolName, args) {
     'x-integrate-code-mode': '1',
   };
   if (SESSION_TOKEN) headers['Authorization'] = 'Bearer ' + SESSION_TOKEN;
+  if (API_KEY) headers['x-integrate-api-key'] = API_KEY;
   if (PROVIDER_TOKENS) headers['x-integrate-tokens'] = PROVIDER_TOKENS;
   if (INTEGRATIONS_HEADER) headers['x-integrations'] = INTEGRATIONS_HEADER;
   if (CONTEXT_JSON) headers['x-integrate-context'] = CONTEXT_JSON;
@@ -4689,6 +4691,29 @@ export { callTool };
 
 // ../code-mode/executor.ts
 var sandboxFactoryOverride = null;
+var _sandboxAvailableCache = null;
+var _sandboxForcedUnavailableForTests = false;
+async function isSandboxAvailable() {
+  if (_sandboxAvailableCache !== null)
+    return _sandboxAvailableCache;
+  if (_sandboxForcedUnavailableForTests) {
+    _sandboxAvailableCache = false;
+    return false;
+  }
+  if (sandboxFactoryOverride) {
+    _sandboxAvailableCache = true;
+    return true;
+  }
+  try {
+    const dynamicImport = new Function("specifier", "return import(specifier)");
+    await dynamicImport("@" + "vercel/sandbox");
+    _sandboxAvailableCache = true;
+    return true;
+  } catch {
+    _sandboxAvailableCache = false;
+    return false;
+  }
+}
 async function loadSandboxFactory() {
   if (sandboxFactoryOverride)
     return sandboxFactoryOverride;
@@ -4775,6 +4800,8 @@ async function executeSandboxCode(options) {
     const env = {
       INTEGRATE_MCP_URL: options.mcpUrl
     };
+    if (options.apiKey)
+      env.INTEGRATE_API_KEY = options.apiKey;
     if (options.sessionToken)
       env.INTEGRATE_SESSION_TOKEN = options.sessionToken;
     if (options.providerTokens && Object.keys(options.providerTokens).length > 0) {
@@ -4866,6 +4893,13 @@ function resolveCodeModeClientConfig(client) {
   const oauthConfig = client.__oauthConfig;
   return oauthConfig?.codeMode ?? {};
 }
+async function canUseCodeMode(client) {
+  if (!await isSandboxAvailable())
+    return false;
+  const serverConfig = resolveCodeModeClientConfig(client);
+  const publicUrl = serverConfig.publicUrl ?? getEnv("INTEGRATE_PUBLIC_URL");
+  return !!publicUrl;
+}
 function buildCodeModeTool(client, options) {
   const { tools, providerTokens, context, integrationIds } = options;
   const generated = generateCodeModeTypes(tools);
@@ -4878,6 +4912,7 @@ ${generated.source}
 \`\`\``;
   const execute = async ({ code }) => {
     const publicUrl = sandboxOverrides.publicUrl ?? serverCodeModeConfig.publicUrl ?? getEnv("INTEGRATE_PUBLIC_URL");
+    const apiKey = client.__oauthConfig?.apiKey;
     if (!publicUrl) {
       return {
         success: false,
@@ -4892,6 +4927,7 @@ ${generated.source}
     return executeSandboxCode({
       code,
       mcpUrl,
+      apiKey,
       providerTokens,
       context,
       integrationsHeader: integrationIds && integrationIds.length > 0 ? integrationIds.join(",") : undefined,
@@ -5043,9 +5079,9 @@ async function getGoogleTools(client, options) {
   const finalOptions = providerTokens ? { ...options, providerTokens } : options;
   await ensureClientConnected(client);
   const mcpTools = await client.getEnabledToolsAsync();
-  const mode = options?.mode ?? "code";
+  const effectiveMode = options?.mode !== undefined ? options.mode : await canUseCodeMode(client) ? "code" : "tools";
   let googleTools;
-  if (mode === "code") {
+  if (effectiveMode === "code") {
     const TypeEnum = await getGoogleType();
     const codeTool = buildCodeModeTool(client, {
       tools: mcpTools,

package/dist/ai/index.js

@@ -4251,7 +4251,7 @@ function calculateHasMore(offset, returnedCount, total) {
 function createTriggerTools(config, context) {
   const { callbacks } = config;
   return {
-    create_trigger: {
+    trigger_create: {
       description: "Schedule a tool to run at a specific time or on a recurring schedule. Use this when the user wants to do something later.",
       inputSchema: exports_external.object({
         name: exports_external.string().optional().describe("Human-readable trigger name"),
@@ -4285,7 +4285,7 @@ function createTriggerTools(config, context) {
         return callbacks.create(trigger, context);
       }
     },
-    list_triggers: {
+    trigger_list: {
       description: "List all scheduled triggers with optional filtering by status or tool name",
       inputSchema: exports_external.object({
         status: exports_external.enum(["active", "paused", "completed", "failed"]).optional().describe("Filter by trigger status"),
@@ -4309,7 +4309,7 @@ function createTriggerTools(config, context) {
         };
       }
     },
-    get_trigger: {
+    trigger_get: {
       description: "Get details of a specific trigger by its ID",
       inputSchema: exports_external.object({
         triggerId: exports_external.string().describe("The trigger ID to retrieve")
@@ -4322,7 +4322,7 @@ function createTriggerTools(config, context) {
         return trigger;
       }
     },
-    update_trigger: {
+    trigger_update: {
       description: "Update a trigger's properties like name, description, arguments, or schedule",
       inputSchema: exports_external.object({
         triggerId: exports_external.string().describe("The trigger ID to update"),
@@ -4349,7 +4349,7 @@ function createTriggerTools(config, context) {
         return callbacks.update(triggerId, updatesWithTimestamp, context);
       }
     },
-    delete_trigger: {
+    trigger_delete: {
       description: "Delete a trigger permanently. This cannot be undone.",
       inputSchema: exports_external.object({
         triggerId: exports_external.string().describe("The trigger ID to delete")
@@ -4359,7 +4359,7 @@ function createTriggerTools(config, context) {
         return { success: true, message: `Trigger ${args.triggerId} deleted` };
       }
     },
-    pause_trigger: {
+    trigger_pause: {
       description: "Pause a trigger to temporarily stop it from executing. Can be resumed later.",
       inputSchema: exports_external.object({
         triggerId: exports_external.string().describe("The trigger ID to pause")
@@ -4379,7 +4379,7 @@ function createTriggerTools(config, context) {
         }, context);
       }
     },
-    resume_trigger: {
+    trigger_resume: {
       description: "Resume a paused trigger to start executing it again on schedule",
       inputSchema: exports_external.object({
         triggerId: exports_external.string().describe("The trigger ID to resume")
@@ -4621,6 +4621,7 @@ function pascalCase(id) {
 var RUNTIME_STUB_SOURCE = `// runtime.mjs — generated by integrate-sdk code mode
 const MCP_URL = process.env.INTEGRATE_MCP_URL;
 const SESSION_TOKEN = process.env.INTEGRATE_SESSION_TOKEN;
+const API_KEY = process.env.INTEGRATE_API_KEY || '';
 const PROVIDER_TOKENS = process.env.INTEGRATE_PROVIDER_TOKENS || '';
 const INTEGRATIONS_HEADER = process.env.INTEGRATE_INTEGRATIONS || '';
 const CONTEXT_JSON = process.env.INTEGRATE_CONTEXT || '';
@@ -4639,6 +4640,7 @@ async function callTool(toolName, args) {
     'x-integrate-code-mode': '1',
   };
   if (SESSION_TOKEN) headers['Authorization'] = 'Bearer ' + SESSION_TOKEN;
+  if (API_KEY) headers['x-integrate-api-key'] = API_KEY;
   if (PROVIDER_TOKENS) headers['x-integrate-tokens'] = PROVIDER_TOKENS;
   if (INTEGRATIONS_HEADER) headers['x-integrations'] = INTEGRATIONS_HEADER;
   if (CONTEXT_JSON) headers['x-integrate-context'] = CONTEXT_JSON;
@@ -4689,6 +4691,29 @@ export { callTool };
 
 // ../code-mode/executor.ts
 var sandboxFactoryOverride = null;
+var _sandboxAvailableCache = null;
+var _sandboxForcedUnavailableForTests = false;
+async function isSandboxAvailable() {
+  if (_sandboxAvailableCache !== null)
+    return _sandboxAvailableCache;
+  if (_sandboxForcedUnavailableForTests) {
+    _sandboxAvailableCache = false;
+    return false;
+  }
+  if (sandboxFactoryOverride) {
+    _sandboxAvailableCache = true;
+    return true;
+  }
+  try {
+    const dynamicImport = new Function("specifier", "return import(specifier)");
+    await dynamicImport("@" + "vercel/sandbox");
+    _sandboxAvailableCache = true;
+    return true;
+  } catch {
+    _sandboxAvailableCache = false;
+    return false;
+  }
+}
 async function loadSandboxFactory() {
   if (sandboxFactoryOverride)
     return sandboxFactoryOverride;
@@ -4775,6 +4800,8 @@ async function executeSandboxCode(options) {
     const env = {
       INTEGRATE_MCP_URL: options.mcpUrl
     };
+    if (options.apiKey)
+      env.INTEGRATE_API_KEY = options.apiKey;
     if (options.sessionToken)
       env.INTEGRATE_SESSION_TOKEN = options.sessionToken;
     if (options.providerTokens && Object.keys(options.providerTokens).length > 0) {
@@ -4866,6 +4893,13 @@ function resolveCodeModeClientConfig(client) {
   const oauthConfig = client.__oauthConfig;
   return oauthConfig?.codeMode ?? {};
 }
+async function canUseCodeMode(client) {
+  if (!await isSandboxAvailable())
+    return false;
+  const serverConfig = resolveCodeModeClientConfig(client);
+  const publicUrl = serverConfig.publicUrl ?? getEnv("INTEGRATE_PUBLIC_URL");
+  return !!publicUrl;
+}
 function buildCodeModeTool(client, options) {
   const { tools, providerTokens, context, integrationIds } = options;
   const generated = generateCodeModeTypes(tools);
@@ -4878,6 +4912,7 @@ ${generated.source}
 \`\`\``;
   const execute = async ({ code }) => {
     const publicUrl = sandboxOverrides.publicUrl ?? serverCodeModeConfig.publicUrl ?? getEnv("INTEGRATE_PUBLIC_URL");
+    const apiKey = client.__oauthConfig?.apiKey;
     if (!publicUrl) {
       return {
         success: false,
@@ -4892,6 +4927,7 @@ ${generated.source}
     return executeSandboxCode({
       code,
       mcpUrl,
+      apiKey,
       providerTokens,
       context,
       integrationsHeader: integrationIds && integrationIds.length > 0 ? integrationIds.join(",") : undefined,
@@ -4989,8 +5025,8 @@ async function getAnthropicTools(client, options) {
   const finalOptions = providerTokens ? { ...options, providerTokens } : options;
   await ensureClientConnected(client);
   const mcpTools = await client.getEnabledToolsAsync();
-  const mode = options?.mode ?? "code";
-  const anthropicTools = mode === "code" ? (() => {
+  const effectiveMode = options?.mode !== undefined ? options.mode : await canUseCodeMode(client) ? "code" : "tools";
+  const anthropicTools = effectiveMode === "code" ? (() => {
     const codeTool = buildCodeModeTool(client, {
       tools: mcpTools,
       providerTokens,
@@ -5173,9 +5209,9 @@ async function getGoogleTools(client, options) {
   const finalOptions = providerTokens ? { ...options, providerTokens } : options;
   await ensureClientConnected(client);
   const mcpTools = await client.getEnabledToolsAsync();
-  const mode = options?.mode ?? "code";
+  const effectiveMode = options?.mode !== undefined ? options.mode : await canUseCodeMode(client) ? "code" : "tools";
   let googleTools;
-  if (mode === "code") {
+  if (effectiveMode === "code") {
     const TypeEnum = await getGoogleType();
     const codeTool = buildCodeModeTool(client, {
       tools: mcpTools,
@@ -5299,8 +5335,8 @@ async function getVercelAITools(client, options) {
   await ensureClientConnected(client);
   const mcpTools = await client.getEnabledToolsAsync();
   const vercelTools = {};
-  const mode = options?.mode ?? "code";
-  if (mode === "code") {
+  const effectiveMode = options?.mode !== undefined ? options.mode : await canUseCodeMode(client) ? "code" : "tools";
+  if (effectiveMode === "code") {
     const codeTool = buildCodeModeTool(client, {
       tools: mcpTools,
       providerTokens,
@@ -5349,8 +5385,8 @@ async function getOpenAITools(client, options) {
   const finalOptions = providerTokens ? { ...options, providerTokens } : options;
   await ensureClientConnected(client);
   const mcpTools = await client.getEnabledToolsAsync();
-  const mode = options?.mode ?? "code";
-  const openaiTools = mode === "code" ? (() => {
+  const effectiveMode = options?.mode !== undefined ? options.mode : await canUseCodeMode(client) ? "code" : "tools";
+  const openaiTools = effectiveMode === "code" ? (() => {
     const codeTool = buildCodeModeTool(client, {
       tools: mcpTools,
       providerTokens,

package/dist/ai/openai.d.ts

@@ -34,12 +34,12 @@ export interface OpenAIToolsOptions extends AIToolsOptions {
     /**
      * How to expose MCP tools to the model.
      *
-     * - `'code'` (default): Returns a single `execute_code` tool backed by a
+     * - `'code'`: Returns a single `execute_code` tool backed by a
      *   Vercel Sandbox. The model writes TypeScript that calls the typed
      *   `client.<integration>.<method>()` API and chains operations in one round-trip.
      * - `'tools'`: Legacy behavior — one OpenAI function tool per MCP tool.
      *
-     * @default 'code'
+     * @default auto-detects `'code'` when sandbox + public URL are available, otherwise `'tools'`
      */
     mode?: 'code' | 'tools';
 }

package/dist/ai/openai.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/ai/openai.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAkE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE;QACV,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,GAAG,IAAI,CAAC;IACT,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kDAAkD;IAClD,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB;;;;;;;;;OASG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACzB;AAiCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,UAAU,EAAE,CAAC,CAgEvB;AA0GD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,QAAQ,EAAE;IAAE,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAA,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAC,CAAA;CAAE,EAChE,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,iBAAiB,CAAC,kBAAkB,EAAE,GAAG;IAAE,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAA,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAyB3H"}
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/ai/openai.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAkE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAQjH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE;QACV,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,GAAG,IAAI,CAAC;IACT,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kDAAkD;IAClD,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB;;;;;;;;;OASG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACzB;AAiCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,UAAU,EAAE,CAAC,CAmEvB;AA0GD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,QAAQ,EAAE;IAAE,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAA,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAC,CAAA;CAAE,EAChE,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,iBAAiB,CAAC,kBAAkB,EAAE,GAAG;IAAE,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAA,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAyB3H"}

package/dist/ai/openai.js

@@ -4251,7 +4251,7 @@ function calculateHasMore(offset, returnedCount, total) {
 function createTriggerTools(config, context) {
   const { callbacks } = config;
   return {
-    create_trigger: {
+    trigger_create: {
       description: "Schedule a tool to run at a specific time or on a recurring schedule. Use this when the user wants to do something later.",
       inputSchema: exports_external.object({
         name: exports_external.string().optional().describe("Human-readable trigger name"),
@@ -4285,7 +4285,7 @@ function createTriggerTools(config, context) {
         return callbacks.create(trigger, context);
       }
     },
-    list_triggers: {
+    trigger_list: {
       description: "List all scheduled triggers with optional filtering by status or tool name",
       inputSchema: exports_external.object({
         status: exports_external.enum(["active", "paused", "completed", "failed"]).optional().describe("Filter by trigger status"),
@@ -4309,7 +4309,7 @@ function createTriggerTools(config, context) {
         };
       }
     },
-    get_trigger: {
+    trigger_get: {
       description: "Get details of a specific trigger by its ID",
       inputSchema: exports_external.object({
         triggerId: exports_external.string().describe("The trigger ID to retrieve")
@@ -4322,7 +4322,7 @@ function createTriggerTools(config, context) {
         return trigger;
       }
     },
-    update_trigger: {
+    trigger_update: {
       description: "Update a trigger's properties like name, description, arguments, or schedule",
       inputSchema: exports_external.object({
         triggerId: exports_external.string().describe("The trigger ID to update"),
@@ -4349,7 +4349,7 @@ function createTriggerTools(config, context) {
         return callbacks.update(triggerId, updatesWithTimestamp, context);
       }
     },
-    delete_trigger: {
+    trigger_delete: {
       description: "Delete a trigger permanently. This cannot be undone.",
       inputSchema: exports_external.object({
         triggerId: exports_external.string().describe("The trigger ID to delete")
@@ -4359,7 +4359,7 @@ function createTriggerTools(config, context) {
         return { success: true, message: `Trigger ${args.triggerId} deleted` };
       }
     },
-    pause_trigger: {
+    trigger_pause: {
       description: "Pause a trigger to temporarily stop it from executing. Can be resumed later.",
       inputSchema: exports_external.object({
         triggerId: exports_external.string().describe("The trigger ID to pause")
@@ -4379,7 +4379,7 @@ function createTriggerTools(config, context) {
         }, context);
       }
     },
-    resume_trigger: {
+    trigger_resume: {
       description: "Resume a paused trigger to start executing it again on schedule",
       inputSchema: exports_external.object({
         triggerId: exports_external.string().describe("The trigger ID to resume")
@@ -4621,6 +4621,7 @@ function pascalCase(id) {
 var RUNTIME_STUB_SOURCE = `// runtime.mjs — generated by integrate-sdk code mode
 const MCP_URL = process.env.INTEGRATE_MCP_URL;
 const SESSION_TOKEN = process.env.INTEGRATE_SESSION_TOKEN;
+const API_KEY = process.env.INTEGRATE_API_KEY || '';
 const PROVIDER_TOKENS = process.env.INTEGRATE_PROVIDER_TOKENS || '';
 const INTEGRATIONS_HEADER = process.env.INTEGRATE_INTEGRATIONS || '';
 const CONTEXT_JSON = process.env.INTEGRATE_CONTEXT || '';
@@ -4639,6 +4640,7 @@ async function callTool(toolName, args) {
     'x-integrate-code-mode': '1',
   };
   if (SESSION_TOKEN) headers['Authorization'] = 'Bearer ' + SESSION_TOKEN;
+  if (API_KEY) headers['x-integrate-api-key'] = API_KEY;
   if (PROVIDER_TOKENS) headers['x-integrate-tokens'] = PROVIDER_TOKENS;
   if (INTEGRATIONS_HEADER) headers['x-integrations'] = INTEGRATIONS_HEADER;
   if (CONTEXT_JSON) headers['x-integrate-context'] = CONTEXT_JSON;
@@ -4689,6 +4691,29 @@ export { callTool };
 
 // ../code-mode/executor.ts
 var sandboxFactoryOverride = null;
+var _sandboxAvailableCache = null;
+var _sandboxForcedUnavailableForTests = false;
+async function isSandboxAvailable() {
+  if (_sandboxAvailableCache !== null)
+    return _sandboxAvailableCache;
+  if (_sandboxForcedUnavailableForTests) {
+    _sandboxAvailableCache = false;
+    return false;
+  }
+  if (sandboxFactoryOverride) {
+    _sandboxAvailableCache = true;
+    return true;
+  }
+  try {
+    const dynamicImport = new Function("specifier", "return import(specifier)");
+    await dynamicImport("@" + "vercel/sandbox");
+    _sandboxAvailableCache = true;
+    return true;
+  } catch {
+    _sandboxAvailableCache = false;
+    return false;
+  }
+}
 async function loadSandboxFactory() {
   if (sandboxFactoryOverride)
     return sandboxFactoryOverride;
@@ -4775,6 +4800,8 @@ async function executeSandboxCode(options) {
     const env = {
       INTEGRATE_MCP_URL: options.mcpUrl
     };
+    if (options.apiKey)
+      env.INTEGRATE_API_KEY = options.apiKey;
     if (options.sessionToken)
       env.INTEGRATE_SESSION_TOKEN = options.sessionToken;
     if (options.providerTokens && Object.keys(options.providerTokens).length > 0) {
@@ -4866,6 +4893,13 @@ function resolveCodeModeClientConfig(client) {
   const oauthConfig = client.__oauthConfig;
   return oauthConfig?.codeMode ?? {};
 }
+async function canUseCodeMode(client) {
+  if (!await isSandboxAvailable())
+    return false;
+  const serverConfig = resolveCodeModeClientConfig(client);
+  const publicUrl = serverConfig.publicUrl ?? getEnv("INTEGRATE_PUBLIC_URL");
+  return !!publicUrl;
+}
 function buildCodeModeTool(client, options) {
   const { tools, providerTokens, context, integrationIds } = options;
   const generated = generateCodeModeTypes(tools);
@@ -4878,6 +4912,7 @@ ${generated.source}
 \`\`\``;
   const execute = async ({ code }) => {
     const publicUrl = sandboxOverrides.publicUrl ?? serverCodeModeConfig.publicUrl ?? getEnv("INTEGRATE_PUBLIC_URL");
+    const apiKey = client.__oauthConfig?.apiKey;
     if (!publicUrl) {
       return {
         success: false,
@@ -4892,6 +4927,7 @@ ${generated.source}
     return executeSandboxCode({
       code,
       mcpUrl,
+      apiKey,
       providerTokens,
       context,
       integrationsHeader: integrationIds && integrationIds.length > 0 ? integrationIds.join(",") : undefined,
@@ -4941,8 +4977,8 @@ async function getOpenAITools(client, options) {
   const finalOptions = providerTokens ? { ...options, providerTokens } : options;
   await ensureClientConnected(client);
   const mcpTools = await client.getEnabledToolsAsync();
-  const mode = options?.mode ?? "code";
-  const openaiTools = mode === "code" ? (() => {
+  const effectiveMode = options?.mode !== undefined ? options.mode : await canUseCodeMode(client) ? "code" : "tools";
+  const openaiTools = effectiveMode === "code" ? (() => {
     const codeTool = buildCodeModeTool(client, {
       tools: mcpTools,
       providerTokens,

package/dist/ai/trigger-tools.d.ts

@@ -25,7 +25,7 @@ export interface TriggerToolsConfig {
  * @returns Object containing trigger management tools
  */
 export declare function createTriggerTools(config: TriggerToolsConfig, context?: MCPContext): {
-    create_trigger: {
+    trigger_create: {
         description: string;
         inputSchema: z.ZodObject<{
             name: z.ZodOptional<z.ZodString>;
@@ -78,7 +78,7 @@ export declare function createTriggerTools(config: TriggerToolsConfig, context?:
         }>;
         execute: (args: any) => Promise<import("../index.js").Trigger>;
     };
-    list_triggers: {
+    trigger_list: {
         description: string;
         inputSchema: z.ZodObject<{
             status: z.ZodOptional<z.ZodEnum<["active", "paused", "completed", "failed"]>>;
@@ -102,7 +102,7 @@ export declare function createTriggerTools(config: TriggerToolsConfig, context?:
             hasMore: boolean;
         }>;
     };
-    get_trigger: {
+    trigger_get: {
         description: string;
         inputSchema: z.ZodObject<{
             triggerId: z.ZodString;
@@ -113,7 +113,7 @@ export declare function createTriggerTools(config: TriggerToolsConfig, context?:
         }>;
         execute: (args: any) => Promise<import("../index.js").Trigger>;
     };
-    update_trigger: {
+    trigger_update: {
         description: string;
         inputSchema: z.ZodObject<{
             triggerId: z.ZodString;
@@ -166,7 +166,7 @@ export declare function createTriggerTools(config: TriggerToolsConfig, context?:
         }>;
         execute: (args: any) => Promise<import("../index.js").Trigger>;
     };
-    delete_trigger: {
+    trigger_delete: {
         description: string;
         inputSchema: z.ZodObject<{
             triggerId: z.ZodString;
@@ -180,7 +180,7 @@ export declare function createTriggerTools(config: TriggerToolsConfig, context?:
             message: string;
         }>;
     };
-    pause_trigger: {
+    trigger_pause: {
         description: string;
         inputSchema: z.ZodObject<{
             triggerId: z.ZodString;
@@ -191,7 +191,7 @@ export declare function createTriggerTools(config: TriggerToolsConfig, context?:
         }>;
         execute: (args: any) => Promise<import("../index.js").Trigger>;
     };
-    resume_trigger: {
+    trigger_resume: {
         description: string;
         inputSchema: z.ZodObject<{
             triggerId: z.ZodString;

package/dist/ai/trigger-tools.js

@@ -4043,7 +4043,7 @@ function calculateHasMore(offset, returnedCount, total) {
 function createTriggerTools(config, context) {
   const { callbacks } = config;
   return {
-    create_trigger: {
+    trigger_create: {
       description: "Schedule a tool to run at a specific time or on a recurring schedule. Use this when the user wants to do something later.",
       inputSchema: exports_external.object({
         name: exports_external.string().optional().describe("Human-readable trigger name"),
@@ -4077,7 +4077,7 @@ function createTriggerTools(config, context) {
         return callbacks.create(trigger, context);
       }
     },
-    list_triggers: {
+    trigger_list: {
       description: "List all scheduled triggers with optional filtering by status or tool name",
       inputSchema: exports_external.object({
         status: exports_external.enum(["active", "paused", "completed", "failed"]).optional().describe("Filter by trigger status"),
@@ -4101,7 +4101,7 @@ function createTriggerTools(config, context) {
         };
       }
     },
-    get_trigger: {
+    trigger_get: {
       description: "Get details of a specific trigger by its ID",
       inputSchema: exports_external.object({
         triggerId: exports_external.string().describe("The trigger ID to retrieve")
@@ -4114,7 +4114,7 @@ function createTriggerTools(config, context) {
         return trigger;
       }
     },
-    update_trigger: {
+    trigger_update: {
       description: "Update a trigger's properties like name, description, arguments, or schedule",
       inputSchema: exports_external.object({
         triggerId: exports_external.string().describe("The trigger ID to update"),
@@ -4141,7 +4141,7 @@ function createTriggerTools(config, context) {
         return callbacks.update(triggerId, updatesWithTimestamp, context);
       }
     },
-    delete_trigger: {
+    trigger_delete: {
       description: "Delete a trigger permanently. This cannot be undone.",
       inputSchema: exports_external.object({
         triggerId: exports_external.string().describe("The trigger ID to delete")
@@ -4151,7 +4151,7 @@ function createTriggerTools(config, context) {
         return { success: true, message: `Trigger ${args.triggerId} deleted` };
       }
     },
-    pause_trigger: {
+    trigger_pause: {
       description: "Pause a trigger to temporarily stop it from executing. Can be resumed later.",
       inputSchema: exports_external.object({
         triggerId: exports_external.string().describe("The trigger ID to pause")
@@ -4171,7 +4171,7 @@ function createTriggerTools(config, context) {
         }, context);
       }
     },
-    resume_trigger: {
+    trigger_resume: {
       description: "Resume a paused trigger to start executing it again on schedule",
       inputSchema: exports_external.object({
         triggerId: exports_external.string().describe("The trigger ID to resume")

package/dist/ai/vercel-ai.d.ts

@@ -25,14 +25,14 @@ export interface VercelAIToolsOptions extends AIToolsOptions {
     /**
      * How to expose MCP tools to the model.
      *
-     * - `'code'` (default): Returns a single `execute_code` tool. The model writes
+     * - `'code'`: Returns a single `execute_code` tool. The model writes
      *   a TypeScript snippet that calls the typed `client.<integration>.<method>()`
      *   API; the snippet runs in an isolated Vercel Sandbox and calls back into
      *   `/api/integrate/mcp`. Chains multiple operations in one round-trip.
      * - `'tools'`: Legacy behavior — returns one AI tool per MCP tool. Use this
      *   if you can't run `@vercel/sandbox` or need the model to see every tool.
      *
-     * @default 'code'
+     * @default auto-detects `'code'` when sandbox + public URL are available, otherwise `'tools'`
      */
     mode?: 'code' | 'tools';
 }