integrate-sdk 0.9.17-dev.0 → 0.9.19-dev.0

package/dist/ai/index.js

@@ -4584,6 +4584,8 @@ function generateCodeModeTypes(tools) {
   const methodMap = {};
   const integrationCounts = {};
   const sections = [];
+  const compactLines = [];
+  const perIntegration = {};
   const integrationIds = Object.keys(byIntegration).sort();
   sections.push("/**");
   sections.push(" * Integrate SDK — available APIs inside `execute_code`.");
@@ -4596,18 +4598,35 @@ function generateCodeModeTypes(tools) {
     const integrationTools = byIntegration[integrationId].slice().sort((a, b) => a.name.localeCompare(b.name));
     integrationCounts[integrationId] = integrationTools.length;
     const interfaceName = pascalCase(integrationId) + "Client";
+    const fullSections = [];
+    fullSections.push(`export interface ${interfaceName} {`);
     sections.push(`export interface ${interfaceName} {`);
+    const compactMethods = [];
     for (const tool of integrationTools) {
       const methodName = toolNameToMethod(tool.name);
       methodMap[`${integrationId}.${methodName}`] = tool.name;
-      sections.push(formatDescription(tool.description, "  "));
+      const fullDesc = formatDescription(tool.description, "  ");
+      fullSections.push(fullDesc);
+      sections.push(fullDesc);
       const argType = argsType(tool.inputSchema);
       const argIsOptional = !methodHasRequiredArgs(tool.inputSchema);
       const paramName = argIsOptional ? "args?" : "args";
-      sections.push(`  ${safeIdent(methodName)}(${paramName}: ${argType}): Promise<ToolResult>;`);
+      const fullLine = `  ${safeIdent(methodName)}(${paramName}: ${argType}): Promise<ToolResult>;`;
+      fullSections.push(fullLine);
+      sections.push(fullLine);
+      const compactArgs = compactArgsSignature(tool.inputSchema);
+      const compactParam = argIsOptional ? `args?: ${compactArgs}` : `args: ${compactArgs}`;
+      compactMethods.push(`  ${safeIdent(methodName)}(${compactParam}): Promise<ToolResult>`);
     }
     sections.push("}");
     sections.push("");
+    fullSections.push("}");
+    perIntegration[integrationId] = fullSections.join(`
+`);
+    compactLines.push(`client.${integrationId}:`);
+    for (const m of compactMethods) {
+      compactLines.push(m);
+    }
   }
   sections.push("export interface ToolResult {");
   sections.push("  content: Array<{ type: 'text' | 'image' | 'resource'; text?: string; data?: string; mimeType?: string; [key: string]: unknown }>;");
@@ -4625,11 +4644,22 @@ function generateCodeModeTypes(tools) {
   sections.push("export declare const client: Client;");
   return {
     source: sections.filter((line, idx, arr) => !(line === "" && arr[idx - 1] === "")).join(`
+`),
+    compact: compactLines.join(`
 `),
     methodMap,
-    integrationCounts
+    integrationCounts,
+    perIntegration
   };
 }
+function compactArgsSignature(schema) {
+  if (!schema || !schema.properties || Object.keys(schema.properties).length === 0) {
+    return "{}";
+  }
+  const required = new Set(Array.isArray(schema.required) ? schema.required : []);
+  const params = Object.keys(schema.properties).map((key) => `${safeIdent(key)}${required.has(key) ? "" : "?"}`);
+  return `{ ${params.join(", ")} }`;
+}
 function pascalCase(id) {
   return id.split(/[^A-Za-z0-9]/).filter(Boolean).map((p) => p.charAt(0).toUpperCase() + p.slice(1)).join("") || "Unknown";
 }
@@ -4903,25 +4933,16 @@ function getEnv(key) {
 
 // ../code-mode/tool-builder.ts
 var CODE_MODE_TOOL_NAME = "execute_code";
+var TYPES_TOOL_NAME = "get_integration_types";
 var DEFAULT_INSTRUCTIONS = [
-  "You are given a single tool: `execute_code`. Instead of calling individual MCP tools,",
-  "you write a short async TypeScript/JavaScript snippet that uses the typed `client`",
-  "object below, and the snippet runs in an isolated sandbox which dispatches the actual",
-  "tool calls. Chain multiple operations together in one snippet whenever possible —",
-  "that is the whole point of this tool.",
+  "Write an async JS/TS snippet that runs in an isolated sandbox using `client.<integration>.<method>(args)`.",
+  "Chain multiple operations in one snippet. Use `await`, `return <value>` for JSON output, `console.log()` for debug.",
+  "Each method returns `ToolResult { content: [{ type, text? }], isError? }` — parse `result.content[0].text` as JSON.",
+  "Only `client`, `callTool`, `fetch`, `console`, `JSON` are available (no npm imports).",
   "",
-  "Rules:",
-  "- The snippet is the body of an `async` function. Use `await` freely.",
-  "- Use `return <value>` at the end to hand a structured result back to the caller;",
-  "  the caller receives it as JSON.",
-  "- Use `console.log(...)` for intermediate observations you want to read later.",
-  "- Throw / let errors propagate; the runtime will surface them with a non-zero exit.",
-  "- Each method call returns an object of shape `ToolResult` (see types below).",
-  "  The payload usually lives in `result.content[0].text` as JSON — parse it if needed.",
-  "- You cannot import npm packages. Only the pre-imported `client` and standard",
-  "  globals (`fetch`, `console`, `JSON`, ...) are available.",
+  "Call `get_integration_types` with an integration name to get full parameter types before writing code.",
   "",
-  "API surface:"
+  "Available methods:"
 ].join(`
 `);
 function resolveCodeModeClientConfig(client) {
@@ -4963,10 +4984,7 @@ function buildCodeModeTool(client, options) {
   const serverCodeModeConfig = resolveCodeModeClientConfig(client);
   const sandboxOverrides = options.sandbox ?? {};
   const description = `${DEFAULT_INSTRUCTIONS}
-
-\`\`\`typescript
-${generated.source}
-\`\`\``;
+${generated.compact}`;
   const execute = async ({ code }) => {
     const publicUrl = resolveCodeModePublicUrl({
       publicUrl: sandboxOverrides.publicUrl ?? serverCodeModeConfig.publicUrl
@@ -4983,11 +5001,33 @@ ${generated.source}
       };
     }
     const mcpUrl = publicUrl.replace(/\/$/, "") + "/api/integrate/mcp";
+    let resolvedTokens = providerTokens;
+    if (!resolvedTokens || Object.keys(resolvedTokens).length === 0) {
+      const oauthManager = client.oauthManager;
+      if (oauthManager) {
+        resolvedTokens = {};
+        const clientIntegrations = client.integrations || [];
+        for (const integration of clientIntegrations) {
+          if (integration.oauth) {
+            const provider = integration.oauth.provider;
+            try {
+              const tokenData = await oauthManager.getProviderToken(provider, undefined, context);
+              if (tokenData?.accessToken) {
+                resolvedTokens[provider] = tokenData.accessToken;
+              }
+            } catch {}
+          }
+        }
+        if (Object.keys(resolvedTokens).length === 0) {
+          resolvedTokens = undefined;
+        }
+      }
+    }
     return executeSandboxCode({
       code,
       mcpUrl,
       apiKey,
-      providerTokens,
+      providerTokens: resolvedTokens,
       context,
       integrationsHeader: integrationIds && integrationIds.length > 0 ? integrationIds.join(",") : undefined,
       runtime: sandboxOverrides.runtime ?? serverCodeModeConfig.runtime,
@@ -4996,7 +5036,8 @@ ${generated.source}
       networkPolicy: sandboxOverrides.networkPolicy ?? serverCodeModeConfig.networkPolicy
     });
   };
-  return {
+  const availableIntegrations = Object.keys(generated.perIntegration);
+  const codeTool = {
     name: CODE_MODE_TOOL_NAME,
     description,
     parameters: {
@@ -5012,6 +5053,29 @@ ${generated.source}
     },
     execute
   };
+  const typesTool = {
+    name: TYPES_TOOL_NAME,
+    description: "Get full TypeScript type definitions (method signatures, parameter types, JSDoc) for a specific integration. " + `Available integrations: ${availableIntegrations.join(", ")}.`,
+    parameters: {
+      type: "object",
+      properties: {
+        integration: {
+          type: "string",
+          description: `Integration name to get types for (${availableIntegrations.join(", ")}).`
+        }
+      },
+      required: ["integration"],
+      additionalProperties: false
+    },
+    execute: ({ integration }) => {
+      const types2 = generated.perIntegration[integration];
+      if (!types2) {
+        return { error: `Unknown integration "${integration}".`, available: availableIntegrations };
+      }
+      return { types: types2 };
+    }
+  };
+  return { codeTool, typesTool };
 }
 
 // anthropic.ts
@@ -5049,8 +5113,11 @@ async function handleAnthropicToolCalls(client, messageContent, options) {
     try {
       let result;
       if (toolUse.name === CODE_MODE_TOOL_NAME) {
-        const codeTool = await getCodeModeTool();
+        const { codeTool } = await getCodeModeTool();
         result = await codeTool.execute(toolUse.input);
+      } else if (toolUse.name === TYPES_TOOL_NAME) {
+        const { typesTool } = await getCodeModeTool();
+        result = typesTool.execute(toolUse.input);
       } else if (triggerTools && triggerTools[toolUse.name]) {
         result = await triggerTools[toolUse.name].execute(toolUse.input);
       } else {
@@ -5097,7 +5164,7 @@ async function getAnthropicTools(client, options) {
     }
   }
   const anthropicTools = effectiveMode === "code" ? (() => {
-    const codeTool = buildCodeModeTool(client, {
+    const { codeTool, typesTool } = buildCodeModeTool(client, {
       tools: mcpTools,
       providerTokens,
       context: options?.context,
@@ -5111,6 +5178,14 @@ async function getAnthropicTools(client, options) {
         properties: codeTool.parameters.properties,
         required: [...codeTool.parameters.required]
       }
+    }, {
+      name: TYPES_TOOL_NAME,
+      description: typesTool.description,
+      input_schema: {
+        type: "object",
+        properties: typesTool.parameters.properties,
+        required: [...typesTool.parameters.required]
+      }
     }];
   })() : mcpTools.map((mcpTool) => convertMCPToolToAnthropic(mcpTool, client, finalOptions));
   const triggerConfig = client.__triggerConfig;
@@ -5258,8 +5333,11 @@ async function executeGoogleFunctionCalls(client, functionCalls, options) {
     const args = call.args || {};
     let result;
     if (call.name === CODE_MODE_TOOL_NAME) {
-      const codeTool = await getCodeModeTool();
+      const { codeTool } = await getCodeModeTool();
       result = await codeTool.execute(args);
+    } else if (call.name === TYPES_TOOL_NAME) {
+      const { typesTool } = await getCodeModeTool();
+      result = typesTool.execute(args);
     } else if (triggerTools && triggerTools[call.name]) {
       result = await triggerTools[call.name].execute(args);
     } else {
@@ -5294,7 +5372,7 @@ async function getGoogleTools(client, options) {
   let googleTools;
   if (effectiveMode === "code") {
     const TypeEnum = await getGoogleType();
-    const codeTool = buildCodeModeTool(client, {
+    const { codeTool, typesTool } = buildCodeModeTool(client, {
       tools: mcpTools,
       providerTokens,
       context: options?.context,
@@ -5313,6 +5391,19 @@ async function getGoogleTools(client, options) {
         },
         required: ["code"]
       }
+    }, {
+      name: TYPES_TOOL_NAME,
+      description: typesTool.description,
+      parameters: {
+        type: TypeEnum.OBJECT,
+        properties: {
+          integration: {
+            type: TypeEnum.STRING,
+            description: typesTool.parameters.properties.integration.description
+          }
+        },
+        required: ["integration"]
+      }
     }];
   } else {
     googleTools = await Promise.all(mcpTools.map((mcpTool) => convertMCPToolToGoogle(mcpTool, client, finalOptions)));
@@ -5429,7 +5520,7 @@ async function getVercelAITools(client, options) {
     }
   }
   if (effectiveMode === "code") {
-    const codeTool = buildCodeModeTool(client, {
+    const { codeTool, typesTool } = buildCodeModeTool(client, {
       tools: mcpTools,
       providerTokens,
       context: options?.context,
@@ -5442,6 +5533,13 @@ async function getVercelAITools(client, options) {
       }),
       execute: async (args) => codeTool.execute(args)
     };
+    vercelTools[TYPES_TOOL_NAME] = {
+      description: typesTool.description,
+      inputSchema: exports_external.object({
+        integration: exports_external.string().describe(typesTool.parameters.properties.integration.description)
+      }),
+      execute: async (args) => typesTool.execute(args)
+    };
   } else {
     for (const mcpTool of mcpTools) {
       vercelTools[mcpTool.name] = convertMCPToolToVercelAI(mcpTool, client, finalOptions);
@@ -5490,7 +5588,7 @@ async function getOpenAITools(client, options) {
     }
   }
   const openaiTools = effectiveMode === "code" ? (() => {
-    const codeTool = buildCodeModeTool(client, {
+    const { codeTool, typesTool } = buildCodeModeTool(client, {
       tools: mcpTools,
       providerTokens,
       context: options?.context,
@@ -5502,6 +5600,12 @@ async function getOpenAITools(client, options) {
       description: codeTool.description,
       parameters: codeTool.parameters,
       strict: options?.strict ?? null
+    }, {
+      type: "function",
+      name: TYPES_TOOL_NAME,
+      description: typesTool.description,
+      parameters: typesTool.parameters,
+      strict: options?.strict ?? null
     }];
   })() : mcpTools.map((mcpTool) => convertMCPToolToOpenAI(mcpTool, client, finalOptions));
   const triggerConfig = client.__triggerConfig;
@@ -5552,8 +5656,11 @@ async function handleOpenAIToolCalls(client, toolCalls, options) {
         const args = JSON.parse(toolCall.arguments);
         let result;
         if (toolCall.name === CODE_MODE_TOOL_NAME) {
-          const codeTool = await getCodeModeTool();
+          const { codeTool } = await getCodeModeTool();
           result = await codeTool.execute(args);
+        } else if (toolCall.name === TYPES_TOOL_NAME) {
+          const { typesTool } = await getCodeModeTool();
+          result = typesTool.execute(args);
         } else if (triggerTools && triggerTools[toolCall.name]) {
           result = await triggerTools[toolCall.name].execute(args);
         } else {

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;AASjH,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,CA2EvB;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;AAUjH,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,CAiFvB;AA6GD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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

@@ -4584,6 +4584,8 @@ function generateCodeModeTypes(tools) {
   const methodMap = {};
   const integrationCounts = {};
   const sections = [];
+  const compactLines = [];
+  const perIntegration = {};
   const integrationIds = Object.keys(byIntegration).sort();
   sections.push("/**");
   sections.push(" * Integrate SDK — available APIs inside `execute_code`.");
@@ -4596,18 +4598,35 @@ function generateCodeModeTypes(tools) {
     const integrationTools = byIntegration[integrationId].slice().sort((a, b) => a.name.localeCompare(b.name));
     integrationCounts[integrationId] = integrationTools.length;
     const interfaceName = pascalCase(integrationId) + "Client";
+    const fullSections = [];
+    fullSections.push(`export interface ${interfaceName} {`);
     sections.push(`export interface ${interfaceName} {`);
+    const compactMethods = [];
     for (const tool of integrationTools) {
       const methodName = toolNameToMethod(tool.name);
       methodMap[`${integrationId}.${methodName}`] = tool.name;
-      sections.push(formatDescription(tool.description, "  "));
+      const fullDesc = formatDescription(tool.description, "  ");
+      fullSections.push(fullDesc);
+      sections.push(fullDesc);
       const argType = argsType(tool.inputSchema);
       const argIsOptional = !methodHasRequiredArgs(tool.inputSchema);
       const paramName = argIsOptional ? "args?" : "args";
-      sections.push(`  ${safeIdent(methodName)}(${paramName}: ${argType}): Promise<ToolResult>;`);
+      const fullLine = `  ${safeIdent(methodName)}(${paramName}: ${argType}): Promise<ToolResult>;`;
+      fullSections.push(fullLine);
+      sections.push(fullLine);
+      const compactArgs = compactArgsSignature(tool.inputSchema);
+      const compactParam = argIsOptional ? `args?: ${compactArgs}` : `args: ${compactArgs}`;
+      compactMethods.push(`  ${safeIdent(methodName)}(${compactParam}): Promise<ToolResult>`);
     }
     sections.push("}");
     sections.push("");
+    fullSections.push("}");
+    perIntegration[integrationId] = fullSections.join(`
+`);
+    compactLines.push(`client.${integrationId}:`);
+    for (const m of compactMethods) {
+      compactLines.push(m);
+    }
   }
   sections.push("export interface ToolResult {");
   sections.push("  content: Array<{ type: 'text' | 'image' | 'resource'; text?: string; data?: string; mimeType?: string; [key: string]: unknown }>;");
@@ -4625,11 +4644,22 @@ function generateCodeModeTypes(tools) {
   sections.push("export declare const client: Client;");
   return {
     source: sections.filter((line, idx, arr) => !(line === "" && arr[idx - 1] === "")).join(`
+`),
+    compact: compactLines.join(`
 `),
     methodMap,
-    integrationCounts
+    integrationCounts,
+    perIntegration
   };
 }
+function compactArgsSignature(schema) {
+  if (!schema || !schema.properties || Object.keys(schema.properties).length === 0) {
+    return "{}";
+  }
+  const required = new Set(Array.isArray(schema.required) ? schema.required : []);
+  const params = Object.keys(schema.properties).map((key) => `${safeIdent(key)}${required.has(key) ? "" : "?"}`);
+  return `{ ${params.join(", ")} }`;
+}
 function pascalCase(id) {
   return id.split(/[^A-Za-z0-9]/).filter(Boolean).map((p) => p.charAt(0).toUpperCase() + p.slice(1)).join("") || "Unknown";
 }
@@ -4903,25 +4933,16 @@ function getEnv(key) {
 
 // ../code-mode/tool-builder.ts
 var CODE_MODE_TOOL_NAME = "execute_code";
+var TYPES_TOOL_NAME = "get_integration_types";
 var DEFAULT_INSTRUCTIONS = [
-  "You are given a single tool: `execute_code`. Instead of calling individual MCP tools,",
-  "you write a short async TypeScript/JavaScript snippet that uses the typed `client`",
-  "object below, and the snippet runs in an isolated sandbox which dispatches the actual",
-  "tool calls. Chain multiple operations together in one snippet whenever possible —",
-  "that is the whole point of this tool.",
+  "Write an async JS/TS snippet that runs in an isolated sandbox using `client.<integration>.<method>(args)`.",
+  "Chain multiple operations in one snippet. Use `await`, `return <value>` for JSON output, `console.log()` for debug.",
+  "Each method returns `ToolResult { content: [{ type, text? }], isError? }` — parse `result.content[0].text` as JSON.",
+  "Only `client`, `callTool`, `fetch`, `console`, `JSON` are available (no npm imports).",
   "",
-  "Rules:",
-  "- The snippet is the body of an `async` function. Use `await` freely.",
-  "- Use `return <value>` at the end to hand a structured result back to the caller;",
-  "  the caller receives it as JSON.",
-  "- Use `console.log(...)` for intermediate observations you want to read later.",
-  "- Throw / let errors propagate; the runtime will surface them with a non-zero exit.",
-  "- Each method call returns an object of shape `ToolResult` (see types below).",
-  "  The payload usually lives in `result.content[0].text` as JSON — parse it if needed.",
-  "- You cannot import npm packages. Only the pre-imported `client` and standard",
-  "  globals (`fetch`, `console`, `JSON`, ...) are available.",
+  "Call `get_integration_types` with an integration name to get full parameter types before writing code.",
   "",
-  "API surface:"
+  "Available methods:"
 ].join(`
 `);
 function resolveCodeModeClientConfig(client) {
@@ -4963,10 +4984,7 @@ function buildCodeModeTool(client, options) {
   const serverCodeModeConfig = resolveCodeModeClientConfig(client);
   const sandboxOverrides = options.sandbox ?? {};
   const description = `${DEFAULT_INSTRUCTIONS}
-
-\`\`\`typescript
-${generated.source}
-\`\`\``;
+${generated.compact}`;
   const execute = async ({ code }) => {
     const publicUrl = resolveCodeModePublicUrl({
       publicUrl: sandboxOverrides.publicUrl ?? serverCodeModeConfig.publicUrl
@@ -4983,11 +5001,33 @@ ${generated.source}
       };
     }
     const mcpUrl = publicUrl.replace(/\/$/, "") + "/api/integrate/mcp";
+    let resolvedTokens = providerTokens;
+    if (!resolvedTokens || Object.keys(resolvedTokens).length === 0) {
+      const oauthManager = client.oauthManager;
+      if (oauthManager) {
+        resolvedTokens = {};
+        const clientIntegrations = client.integrations || [];
+        for (const integration of clientIntegrations) {
+          if (integration.oauth) {
+            const provider = integration.oauth.provider;
+            try {
+              const tokenData = await oauthManager.getProviderToken(provider, undefined, context);
+              if (tokenData?.accessToken) {
+                resolvedTokens[provider] = tokenData.accessToken;
+              }
+            } catch {}
+          }
+        }
+        if (Object.keys(resolvedTokens).length === 0) {
+          resolvedTokens = undefined;
+        }
+      }
+    }
     return executeSandboxCode({
       code,
       mcpUrl,
       apiKey,
-      providerTokens,
+      providerTokens: resolvedTokens,
       context,
       integrationsHeader: integrationIds && integrationIds.length > 0 ? integrationIds.join(",") : undefined,
       runtime: sandboxOverrides.runtime ?? serverCodeModeConfig.runtime,
@@ -4996,7 +5036,8 @@ ${generated.source}
       networkPolicy: sandboxOverrides.networkPolicy ?? serverCodeModeConfig.networkPolicy
     });
   };
-  return {
+  const availableIntegrations = Object.keys(generated.perIntegration);
+  const codeTool = {
     name: CODE_MODE_TOOL_NAME,
     description,
     parameters: {
@@ -5012,6 +5053,29 @@ ${generated.source}
     },
     execute
   };
+  const typesTool = {
+    name: TYPES_TOOL_NAME,
+    description: "Get full TypeScript type definitions (method signatures, parameter types, JSDoc) for a specific integration. " + `Available integrations: ${availableIntegrations.join(", ")}.`,
+    parameters: {
+      type: "object",
+      properties: {
+        integration: {
+          type: "string",
+          description: `Integration name to get types for (${availableIntegrations.join(", ")}).`
+        }
+      },
+      required: ["integration"],
+      additionalProperties: false
+    },
+    execute: ({ integration }) => {
+      const types2 = generated.perIntegration[integration];
+      if (!types2) {
+        return { error: `Unknown integration "${integration}".`, available: availableIntegrations };
+      }
+      return { types: types2 };
+    }
+  };
+  return { codeTool, typesTool };
 }
 
 // openai.ts
@@ -5049,7 +5113,7 @@ async function getOpenAITools(client, options) {
     }
   }
   const openaiTools = effectiveMode === "code" ? (() => {
-    const codeTool = buildCodeModeTool(client, {
+    const { codeTool, typesTool } = buildCodeModeTool(client, {
       tools: mcpTools,
       providerTokens,
       context: options?.context,
@@ -5061,6 +5125,12 @@ async function getOpenAITools(client, options) {
       description: codeTool.description,
       parameters: codeTool.parameters,
       strict: options?.strict ?? null
+    }, {
+      type: "function",
+      name: TYPES_TOOL_NAME,
+      description: typesTool.description,
+      parameters: typesTool.parameters,
+      strict: options?.strict ?? null
     }];
   })() : mcpTools.map((mcpTool) => convertMCPToolToOpenAI(mcpTool, client, finalOptions));
   const triggerConfig = client.__triggerConfig;
@@ -5111,8 +5181,11 @@ async function handleOpenAIToolCalls(client, toolCalls, options) {
         const args = JSON.parse(toolCall.arguments);
         let result;
         if (toolCall.name === CODE_MODE_TOOL_NAME) {
-          const codeTool = await getCodeModeTool();
+          const { codeTool } = await getCodeModeTool();
           result = await codeTool.execute(args);
+        } else if (toolCall.name === TYPES_TOOL_NAME) {
+          const { typesTool } = await getCodeModeTool();
+          result = typesTool.execute(args);
         } else if (triggerTools && triggerTools[toolCall.name]) {
           result = await triggerTools[toolCall.name].execute(args);
         } else {

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

@@ -1 +1 @@
-{"version":3,"file":"vercel-ai.d.ts","sourceRoot":"","sources":["../../../src/ai/vercel-ai.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AASpB;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5B,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC1D,kDAAkD;IAClD,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACzB;AA+BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,oBAAoB,gCAkE/B"}
+{"version":3,"file":"vercel-ai.d.ts","sourceRoot":"","sources":["../../../src/ai/vercel-ai.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AAUpB;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5B,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC1D,kDAAkD;IAClD,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACzB;AA+BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,oBAAoB,gCAyE/B"}