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

package/dist/ai/vercel-ai.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
@@ -4996,7 +5014,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 +5031,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 };
 }
 
 // vercel-ai.ts
@@ -5051,7 +5093,7 @@ async function getVercelAITools(client, options) {
     }
   }
   if (effectiveMode === "code") {
-    const codeTool = buildCodeModeTool(client, {
+    const { codeTool, typesTool } = buildCodeModeTool(client, {
       tools: mcpTools,
       providerTokens,
       context: options?.context,
@@ -5064,6 +5106,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);

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

@@ -8,5 +8,5 @@
 export { generateCodeModeTypes, type GeneratedTypes, } from "./type-generator.js";
 export { executeSandboxCode, __setSandboxFactoryForTests, type ExecuteSandboxCodeOptions, type ExecuteSandboxCodeResult, } from "./executor.js";
 export { RUNTIME_STUB_SOURCE } from "./runtime-stub.js";
-export { buildCodeModeTool, canUseCodeMode, CODE_MODE_TOOL_NAME, type CodeModeToolOptions, type CodeModeToolDefinition, } from "./tool-builder.js";
+export { buildCodeModeTool, canUseCodeMode, CODE_MODE_TOOL_NAME, TYPES_TOOL_NAME, type CodeModeToolOptions, type CodeModeToolDefinition, type TypesToolDefinition, type CodeModeTools, } from "./tool-builder.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/code-mode/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,qBAAqB,EACrB,KAAK,cAAc,GACpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,kBAAkB,EAClB,2BAA2B,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,GAC9B,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,GAC5B,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/code-mode/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,qBAAqB,EACrB,KAAK,cAAc,GACpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,kBAAkB,EAClB,2BAA2B,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,GAC9B,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,aAAa,GACnB,MAAM,mBAAmB,CAAC"}

package/dist/code-mode/index.js

@@ -182,6 +182,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`.");
@@ -194,18 +196,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 }>;");
@@ -223,11 +242,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";
 }
@@ -512,25 +542,16 @@ function getEnv(key) {
 
 // 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) {
@@ -578,10 +599,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
@@ -611,7 +629,8 @@ ${generated.source}
       networkPolicy: sandboxOverrides.networkPolicy ?? serverCodeModeConfig.networkPolicy
     });
   };
-  return {
+  const availableIntegrations = Object.keys(generated.perIntegration);
+  const codeTool = {
     name: CODE_MODE_TOOL_NAME,
     description,
     parameters: {
@@ -627,6 +646,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 types = generated.perIntegration[integration];
+      if (!types) {
+        return { error: `Unknown integration "${integration}".`, available: availableIntegrations };
+      }
+      return { types };
+    }
+  };
+  return { codeTool, typesTool };
 }
 export {
   generateCodeModeTypes,
@@ -634,6 +676,7 @@ export {
   canUseCodeMode,
   buildCodeModeTool,
   __setSandboxFactoryForTests,
+  TYPES_TOOL_NAME,
   RUNTIME_STUB_SOURCE,
   CODE_MODE_TOOL_NAME
 };

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

@@ -12,6 +12,7 @@ import type { MCPContext } from "../config/types.js";
 import type { MCPTool } from "../protocol/messages.js";
 import { type ExecuteSandboxCodeResult } from "./executor.js";
 export declare const CODE_MODE_TOOL_NAME = "execute_code";
+export declare const TYPES_TOOL_NAME = "get_integration_types";
 export interface CodeModeToolOptions {
     /** Enabled MCP tools (already fetched by the caller). */
     tools: MCPTool[];
@@ -61,6 +62,33 @@ export interface CodeModeToolDefinition {
         code: string;
     }) => Promise<ExecuteSandboxCodeResult>;
 }
+export interface TypesToolDefinition {
+    name: string;
+    description: string;
+    parameters: {
+        type: "object";
+        properties: {
+            integration: {
+                type: "string";
+                description: string;
+            };
+        };
+        required: ["integration"];
+        additionalProperties: false;
+    };
+    execute: (input: {
+        integration: string;
+    }) => {
+        types: string;
+    } | {
+        error: string;
+        available: string[];
+    };
+}
+export interface CodeModeTools {
+    codeTool: CodeModeToolDefinition;
+    typesTool: TypesToolDefinition;
+}
 export declare function resolveCodeModeClientConfig(client: MCPClient<any>): {
     publicUrl?: string;
     runtime?: "node24" | "node22";
@@ -100,9 +128,9 @@ export declare function __resetCodeModeFallbackWarnings(): void;
  */
 export declare function warnCodeModeFallback(reason: CodeModeUnavailableReason): void;
 /**
- * Build the `execute_code` tool definition. The returned `execute` function
- * is what the AI provider SDK ultimately invokes when the model picks the
- * tool.
+ * Build the `execute_code` and `get_integration_types` tool definitions.
+ * The compact method listing goes in execute_code's description; full
+ * TypeScript types are served on demand via get_integration_types.
  */
-export declare function buildCodeModeTool(client: MCPClient<any>, options: CodeModeToolOptions): CodeModeToolDefinition;
+export declare function buildCodeModeTool(client: MCPClient<any>, options: CodeModeToolOptions): CodeModeTools;
 //# sourceMappingURL=tool-builder.d.ts.map

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

@@ -182,6 +182,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`.");
@@ -194,18 +196,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 }>;");
@@ -223,11 +242,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";
 }
@@ -512,25 +542,16 @@ function getEnv(key) {
 
 // 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) {
@@ -578,10 +599,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
@@ -611,7 +629,8 @@ ${generated.source}
       networkPolicy: sandboxOverrides.networkPolicy ?? serverCodeModeConfig.networkPolicy
     });
   };
-  return {
+  const availableIntegrations = Object.keys(generated.perIntegration);
+  const codeTool = {
     name: CODE_MODE_TOOL_NAME,
     description,
     parameters: {
@@ -627,6 +646,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 types = generated.perIntegration[integration];
+      if (!types) {
+        return { error: `Unknown integration "${integration}".`, available: availableIntegrations };
+      }
+      return { types };
+    }
+  };
+  return { codeTool, typesTool };
 }
 export {
   warnCodeModeFallback,
@@ -636,5 +678,6 @@ export {
   canUseCodeMode,
   buildCodeModeTool,
   __resetCodeModeFallbackWarnings,
+  TYPES_TOOL_NAME,
   CODE_MODE_TOOL_NAME
 };

package/dist/code-mode/type-generator.d.ts

@@ -10,10 +10,14 @@ import type { MCPTool } from "../protocol/messages.js";
 export interface GeneratedTypes {
     /** The full TypeScript source to embed in the LLM prompt. */
     source: string;
+    /** Compact method listing (no JSDoc, param names only) for the tool description. */
+    compact: string;
     /** Map from dotted method path (e.g. `github.createIssue`) to MCP tool name. */
     methodMap: Record<string, string>;
     /** Per-integration tool counts, useful for logging. */
     integrationCounts: Record<string, number>;
+    /** Per-integration full type source for on-demand lookup. */
+    perIntegration: Record<string, string>;
 }
 /**
  * Build the TypeScript API surface from a set of enabled MCP tools.

package/dist/code-mode/type-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"type-generator.d.ts","sourceRoot":"","sources":["../../../src/code-mode/type-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAmB,MAAM,yBAAyB,CAAC;AAGxE,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,uDAAuD;IACvD,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAgHD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,cAAc,CA6DtE"}
+{"version":3,"file":"type-generator.d.ts","sourceRoot":"","sources":["../../../src/code-mode/type-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAmB,MAAM,yBAAyB,CAAC;AAGxE,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,uDAAuD;IACvD,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,6DAA6D;IAC7D,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAgHD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,cAAc,CA8FtE"}