integrate-sdk 0.9.58 → 0.9.61

package/dist/adapters/index.js

@@ -4436,7 +4436,7 @@ class MCPClientBase {
     logger7.debug(`Discovered ${totalDiscovered} tools, ${enabledCount} enabled by integrations`);
   }
   async _callToolByName(name, args, options) {
-    return await this.callToolWithRetry(name, args, 0, options);
+    return await this.callTool(name, args, options);
   }
   async callTool(name, args, options) {
     return await this.callToolWithRetry(name, args, 0, options);

package/dist/adapters/solid-start.js

@@ -4436,7 +4436,7 @@ class MCPClientBase {
     logger7.debug(`Discovered ${totalDiscovered} tools, ${enabledCount} enabled by integrations`);
   }
   async _callToolByName(name, args, options) {
-    return await this.callToolWithRetry(name, args, 0, options);
+    return await this.callTool(name, args, options);
   }
   async callTool(name, args, options) {
     return await this.callToolWithRetry(name, args, 0, options);

package/dist/adapters/svelte-kit.js

@@ -4436,7 +4436,7 @@ class MCPClientBase {
     logger7.debug(`Discovered ${totalDiscovered} tools, ${enabledCount} enabled by integrations`);
   }
   async _callToolByName(name, args, options) {
-    return await this.callToolWithRetry(name, args, 0, options);
+    return await this.callTool(name, args, options);
   }
   async callTool(name, args, options) {
     return await this.callToolWithRetry(name, args, 0, options);

package/dist/ai/index.js

@@ -5534,6 +5534,69 @@ function convertJsonSchemaToGoogleSchema(jsonSchema, TypeEnum) {
   return result;
 }
 
+// ../database/token-store.ts
+var USABLE_ACCESS_TOKEN_BUFFER_MS = 30 * 1000;
+var MIN_MEANINGFUL_EXPIRY_MS = Date.UTC(2000, 0, 1);
+async function listConnectedProviders(configuredIntegrationIds, getProviderToken, context) {
+  if (!context.userId || configuredIntegrationIds.length === 0) {
+    return [];
+  }
+  const connected = [];
+  await Promise.all(configuredIntegrationIds.map(async (provider) => {
+    try {
+      const token = await getProviderToken(provider, undefined, context);
+      if (token?.accessToken || typeof token?.refreshToken === "string" && token.refreshToken.length > 0) {
+        connected.push(provider);
+      }
+    } catch {}
+  }));
+  return connected.sort();
+}
+
+// tool-cache.ts
+function buildToolDiscoveryCacheKey(userId, connectedIntegrationIds) {
+  const sorted = [...connectedIntegrationIds].sort().join(",");
+  return `${userId}:${sorted}`;
+}
+async function resolveToolDiscoveryCacheKey(client, context, options) {
+  const userId = context.userId;
+  if (!userId)
+    return;
+  const configuredIds = (client.integrations ?? []).map((i) => i.id);
+  let targetIds;
+  if (options?.integrationIds?.length) {
+    targetIds = options.integrationIds;
+  } else if (options?.connectedOnly) {
+    targetIds = await listConnectedProviders(configuredIds, (provider, email, ctx) => client.getProviderToken(provider, email, ctx), context);
+  } else {
+    targetIds = configuredIds;
+  }
+  return buildToolDiscoveryCacheKey(userId, targetIds);
+}
+function stubsFromTools(tools) {
+  return tools.map((t) => ({
+    name: t.name,
+    description: t.description,
+    inputSchema: t.inputSchema
+  }));
+}
+function applyToolDiscoveryCache(client, stubs) {
+  client.hydrateToolCache(stubs);
+}
+async function persistToolDiscoveryCache(client, cache, cacheKey, ttlMs) {
+  const tools = client.getAvailableTools();
+  if (tools.length === 0)
+    return;
+  await cache.set(cacheKey, stubsFromTools(tools), ttlMs);
+}
+async function warmToolDiscoveryFromCache(client, cache, cacheKey) {
+  const stubs = await cache.get(cacheKey);
+  if (!stubs || stubs.length === 0)
+    return false;
+  applyToolDiscoveryCache(client, stubs);
+  return true;
+}
+
 // vercel-ai.ts
 function convertMCPToolToVercelAI(mcpTool, client, options) {
   return {
@@ -5556,7 +5619,21 @@ async function getVercelAITools(client, options) {
   }
   const finalOptions = providerTokens ? { ...options, providerTokens } : options;
   await ensureClientConnected(client);
+  const cacheConfig = options?.cache;
+  let cacheKey;
+  if (cacheConfig?.cache && options?.context) {
+    cacheKey = await resolveToolDiscoveryCacheKey(client, options.context, {
+      integrationIds: options.integrationIds,
+      connectedOnly: options.connectedOnly
+    });
+    if (cacheKey) {
+      await warmToolDiscoveryFromCache(client, cacheConfig.cache, cacheKey);
+    }
+  }
   const mcpTools = await client.getEnabledToolsAsync(toEnabledToolsAsyncOptions(options));
+  if (cacheConfig?.cache && cacheKey) {
+    await persistToolDiscoveryCache(client, cacheConfig.cache, cacheKey, cacheConfig.ttlMs);
+  }
   const vercelTools = {};
   let effectiveMode;
   if (options?.mode !== undefined) {

package/dist/ai/tool-cache.d.ts

@@ -0,0 +1,50 @@
+import type { MCPClient } from "../client.js";
+import type { MCPTool } from "../protocol/messages.js";
+import type { MCPContext } from "../config/types.js";
+/** Serializable MCP tool metadata for cross-request / Redis caching. */
+export type ToolMetadataStub = Pick<MCPTool, "name" | "description" | "inputSchema">;
+export interface ToolDiscoveryCacheAdapter {
+    get(key: string): Promise<ToolMetadataStub[] | null>;
+    set(key: string, stubs: ToolMetadataStub[], ttlMs?: number): Promise<void>;
+    /** Invalidate all keys for a user (prefix match) or a single key when exact. */
+    invalidate(userIdOrKey: string): Promise<void>;
+}
+export interface ToolDiscoveryCacheOptions {
+    cache: ToolDiscoveryCacheAdapter;
+    /** @default 5 minutes */
+    ttlMs?: number;
+}
+/**
+ * Build a cache key from user id and connected integration ids.
+ * Include connected providers so reconnecting OAuth invalidates stale tool lists.
+ */
+export declare function buildToolDiscoveryCacheKey(userId: string, connectedIntegrationIds: readonly string[]): string;
+/**
+ * In-memory tool discovery cache (single process). Use Redis in production serverless.
+ */
+export declare function createMemoryToolDiscoveryCache(): ToolDiscoveryCacheAdapter;
+/**
+ * Hook for database adapter `onTokenChange` — invalidates cached tool metadata for the user.
+ */
+export declare function createToolDiscoveryCacheInvalidator(cache: ToolDiscoveryCacheAdapter): (event: {
+    userId: string;
+}) => void;
+export declare function resolveToolDiscoveryCacheKey(client: MCPClient<any>, context: MCPContext, options?: {
+    integrationIds?: string[];
+    connectedOnly?: boolean;
+}): Promise<string | undefined>;
+export declare function stubsFromTools(tools: readonly MCPTool[]): ToolMetadataStub[];
+/**
+ * Hydrate the client tool cache from persisted stubs (serverless cold start).
+ */
+export declare function applyToolDiscoveryCache(client: MCPClient<any>, stubs: readonly ToolMetadataStub[]): void;
+/**
+ * Persist current client tool metadata to a cache adapter.
+ */
+export declare function persistToolDiscoveryCache(client: MCPClient<any>, cache: ToolDiscoveryCacheAdapter, cacheKey: string, ttlMs?: number): Promise<void>;
+/**
+ * Load stubs from cache into the client before tool discovery.
+ * @returns true when cache was hydrated
+ */
+export declare function warmToolDiscoveryFromCache(client: MCPClient<any>, cache: ToolDiscoveryCacheAdapter, cacheKey: string): Promise<boolean>;
+//# sourceMappingURL=tool-cache.d.ts.map

package/dist/ai/tool-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-cache.d.ts","sourceRoot":"","sources":["../../../src/ai/tool-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGrD,wEAAwE;AACxE,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,aAAa,CAAC,CAAC;AAErF,MAAM,WAAW,yBAAyB;IACxC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,GAAG,IAAI,CAAC,CAAC;IACrD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,gFAAgF;IAChF,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,yBAAyB,CAAC;IACjC,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,EACd,uBAAuB,EAAE,SAAS,MAAM,EAAE,GACzC,MAAM,CAGR;AAED;;GAEG;AACH,wBAAgB,8BAA8B,IAAI,yBAAyB,CAwB1E;AAED;;GAEG;AACH,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,yBAAyB,GAC/B,CAAC,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,CAIrC;AAED,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,EAAE,UAAU,EACnB,OAAO,CAAC,EAAE;IACR,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,GACA,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAuB7B;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,GAAG,gBAAgB,EAAE,CAM5E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,KAAK,EAAE,SAAS,gBAAgB,EAAE,GACjC,IAAI,CAEN;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,KAAK,EAAE,yBAAyB,EAChC,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,KAAK,EAAE,yBAAyB,EAChC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC,CAKlB"}

package/dist/ai/utils.d.ts

@@ -57,6 +57,11 @@ export interface AIToolsOptions {
      * @default 8
      */
     fetchConcurrency?: number;
+    /**
+     * Optional cache for tool metadata (serverless cold-start optimization).
+     * Pair with {@link createToolDiscoveryCacheInvalidator} on `onTokenChange`.
+     */
+    cache?: import("./tool-cache.js").ToolDiscoveryCacheOptions;
 }
 /** Map AI helper options to client tool-discovery options */
 export declare function toEnabledToolsAsyncOptions(options?: Pick<AIToolsOptions, "integrationIds" | "connectedOnly" | "context" | "fetchConcurrency">): EnabledToolsAsyncOptions | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/ai/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,6DAA6D;AAC7D,wBAAgB,0BAA0B,CACxC,OAAO,CAAC,EAAE,IAAI,CACZ,cAAc,EACd,gBAAgB,GAAG,eAAe,GAAG,SAAS,GAAG,kBAAkB,CACpE,GACA,wBAAwB,GAAG,SAAS,CAYtC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG/F;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAqFvE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAoD7D;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,GAAG,CAAC,CAuCd;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAIjF;AAED;;;GAGG;AACH,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/ai/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,iBAAiB,EAAE,yBAAyB,CAAC;CAC7D;AAED,6DAA6D;AAC7D,wBAAgB,0BAA0B,CACxC,OAAO,CAAC,EAAE,IAAI,CACZ,cAAc,EACd,gBAAgB,GAAG,eAAe,GAAG,SAAS,GAAG,kBAAkB,CACpE,GACA,wBAAwB,GAAG,SAAS,CAYtC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG/F;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAqFvE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAoD7D;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,GAAG,CAAC,CAuCd;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAIjF;AAED;;;GAGG;AACH,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC"}

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,EAML,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"}
+{"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,EAML,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AAepB;;;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,gCA+F/B"}

package/dist/ai/vercel-ai.js

@@ -5129,6 +5129,69 @@ ${generated.compact}`;
   return { codeTool, typesTool };
 }
 
+// ../database/token-store.ts
+var USABLE_ACCESS_TOKEN_BUFFER_MS = 30 * 1000;
+var MIN_MEANINGFUL_EXPIRY_MS = Date.UTC(2000, 0, 1);
+async function listConnectedProviders(configuredIntegrationIds, getProviderToken, context) {
+  if (!context.userId || configuredIntegrationIds.length === 0) {
+    return [];
+  }
+  const connected = [];
+  await Promise.all(configuredIntegrationIds.map(async (provider) => {
+    try {
+      const token = await getProviderToken(provider, undefined, context);
+      if (token?.accessToken || typeof token?.refreshToken === "string" && token.refreshToken.length > 0) {
+        connected.push(provider);
+      }
+    } catch {}
+  }));
+  return connected.sort();
+}
+
+// tool-cache.ts
+function buildToolDiscoveryCacheKey(userId, connectedIntegrationIds) {
+  const sorted = [...connectedIntegrationIds].sort().join(",");
+  return `${userId}:${sorted}`;
+}
+async function resolveToolDiscoveryCacheKey(client, context, options) {
+  const userId = context.userId;
+  if (!userId)
+    return;
+  const configuredIds = (client.integrations ?? []).map((i) => i.id);
+  let targetIds;
+  if (options?.integrationIds?.length) {
+    targetIds = options.integrationIds;
+  } else if (options?.connectedOnly) {
+    targetIds = await listConnectedProviders(configuredIds, (provider, email, ctx) => client.getProviderToken(provider, email, ctx), context);
+  } else {
+    targetIds = configuredIds;
+  }
+  return buildToolDiscoveryCacheKey(userId, targetIds);
+}
+function stubsFromTools(tools) {
+  return tools.map((t) => ({
+    name: t.name,
+    description: t.description,
+    inputSchema: t.inputSchema
+  }));
+}
+function applyToolDiscoveryCache(client, stubs) {
+  client.hydrateToolCache(stubs);
+}
+async function persistToolDiscoveryCache(client, cache, cacheKey, ttlMs) {
+  const tools = client.getAvailableTools();
+  if (tools.length === 0)
+    return;
+  await cache.set(cacheKey, stubsFromTools(tools), ttlMs);
+}
+async function warmToolDiscoveryFromCache(client, cache, cacheKey) {
+  const stubs = await cache.get(cacheKey);
+  if (!stubs || stubs.length === 0)
+    return false;
+  applyToolDiscoveryCache(client, stubs);
+  return true;
+}
+
 // vercel-ai.ts
 function convertMCPToolToVercelAI(mcpTool, client, options) {
   return {
@@ -5151,7 +5214,21 @@ async function getVercelAITools(client, options) {
   }
   const finalOptions = providerTokens ? { ...options, providerTokens } : options;
   await ensureClientConnected(client);
+  const cacheConfig = options?.cache;
+  let cacheKey;
+  if (cacheConfig?.cache && options?.context) {
+    cacheKey = await resolveToolDiscoveryCacheKey(client, options.context, {
+      integrationIds: options.integrationIds,
+      connectedOnly: options.connectedOnly
+    });
+    if (cacheKey) {
+      await warmToolDiscoveryFromCache(client, cacheConfig.cache, cacheKey);
+    }
+  }
   const mcpTools = await client.getEnabledToolsAsync(toEnabledToolsAsyncOptions(options));
+  if (cacheConfig?.cache && cacheKey) {
+    await persistToolDiscoveryCache(client, cacheConfig.cache, cacheKey, cacheConfig.ttlMs);
+  }
   const vercelTools = {};
   let effectiveMode;
   if (options?.mode !== undefined) {

package/dist/index.js

@@ -3664,7 +3664,7 @@ class MCPClientBase {
     logger5.debug(`Discovered ${totalDiscovered} tools, ${enabledCount} enabled by integrations`);
   }
   async _callToolByName(name, args, options) {
-    return await this.callToolWithRetry(name, args, 0, options);
+    return await this.callTool(name, args, options);
   }
   async callTool(name, args, options) {
     return await this.callToolWithRetry(name, args, 0, options);
@@ -14160,6 +14160,68 @@ function createSimpleIntegration(config) {
     onDisconnect: config.onDisconnect
   };
 }
+// src/utils/parse-tool-result.ts
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function getBooleanProperty(value, key) {
+  const property = value[key];
+  return typeof property === "boolean" ? property : undefined;
+}
+function getStringProperty(value, key) {
+  const property = value[key];
+  if (typeof property !== "string") {
+    return;
+  }
+  const trimmed = property.trim();
+  return trimmed.length > 0 ? trimmed : undefined;
+}
+function getStructuredContent(result) {
+  const structuredContent = result.structuredContent;
+  return isRecord(structuredContent) ? structuredContent : undefined;
+}
+function getContentText(result) {
+  const content = result.content;
+  if (!Array.isArray(content)) {
+    return;
+  }
+  for (const item of content) {
+    if (!isRecord(item)) {
+      continue;
+    }
+    const text = getStringProperty(item, "text");
+    if (text) {
+      return text;
+    }
+  }
+  return;
+}
+function isMCPToolError(result) {
+  return parseMCPToolResult(result).ok === false;
+}
+function parseMCPToolResult(result) {
+  if (!isRecord(result)) {
+    return {
+      ok: true,
+      data: result,
+      raw: result
+    };
+  }
+  const structuredContent = getStructuredContent(result);
+  const failed = getBooleanProperty(result, "isError") === true || getBooleanProperty(result, "success") === false || getBooleanProperty(structuredContent ?? {}, "isError") === true || getBooleanProperty(structuredContent ?? {}, "success") === false;
+  if (!failed) {
+    return {
+      ok: true,
+      data: structuredContent ?? result,
+      raw: result
+    };
+  }
+  return {
+    ok: false,
+    error: getStringProperty(result, "error") ?? getStringProperty(structuredContent ?? {}, "error") ?? getContentText(result) ?? "Tool returned an error result",
+    raw: result
+  };
+}
 // index.ts
 var client = createMCPClient({
   integrations: [
@@ -14372,6 +14434,7 @@ export {
   paypalIntegration,
   parseState,
   parseServerError,
+  parseMCPToolResult,
   paperIntegration,
   pandadocIntegration,
   outlookIntegration,
@@ -14406,6 +14469,7 @@ export {
   kickIntegration,
   jiraIntegration,
   isTokenExpiredError,
+  isMCPToolError,
   isAuthorizationError,
   isAuthError,
   intercomIntegration,

package/dist/integrations.js

@@ -3664,7 +3664,7 @@ class MCPClientBase {
     logger5.debug(`Discovered ${totalDiscovered} tools, ${enabledCount} enabled by integrations`);
   }
   async _callToolByName(name, args, options) {
-    return await this.callToolWithRetry(name, args, 0, options);
+    return await this.callTool(name, args, options);
   }
   async callTool(name, args, options) {
     return await this.callToolWithRetry(name, args, 0, options);
@@ -14160,6 +14160,68 @@ function createSimpleIntegration(config) {
     onDisconnect: config.onDisconnect
   };
 }
+// src/utils/parse-tool-result.ts
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function getBooleanProperty(value, key) {
+  const property = value[key];
+  return typeof property === "boolean" ? property : undefined;
+}
+function getStringProperty(value, key) {
+  const property = value[key];
+  if (typeof property !== "string") {
+    return;
+  }
+  const trimmed = property.trim();
+  return trimmed.length > 0 ? trimmed : undefined;
+}
+function getStructuredContent(result) {
+  const structuredContent = result.structuredContent;
+  return isRecord(structuredContent) ? structuredContent : undefined;
+}
+function getContentText(result) {
+  const content = result.content;
+  if (!Array.isArray(content)) {
+    return;
+  }
+  for (const item of content) {
+    if (!isRecord(item)) {
+      continue;
+    }
+    const text = getStringProperty(item, "text");
+    if (text) {
+      return text;
+    }
+  }
+  return;
+}
+function isMCPToolError(result) {
+  return parseMCPToolResult(result).ok === false;
+}
+function parseMCPToolResult(result) {
+  if (!isRecord(result)) {
+    return {
+      ok: true,
+      data: result,
+      raw: result
+    };
+  }
+  const structuredContent = getStructuredContent(result);
+  const failed = getBooleanProperty(result, "isError") === true || getBooleanProperty(result, "success") === false || getBooleanProperty(structuredContent ?? {}, "isError") === true || getBooleanProperty(structuredContent ?? {}, "success") === false;
+  if (!failed) {
+    return {
+      ok: true,
+      data: structuredContent ?? result,
+      raw: result
+    };
+  }
+  return {
+    ok: false,
+    error: getStringProperty(result, "error") ?? getStringProperty(structuredContent ?? {}, "error") ?? getContentText(result) ?? "Tool returned an error result",
+    raw: result
+  };
+}
 export {
   zoomIntegration,
   zohoWriterIntegration,
@@ -14258,6 +14320,7 @@ export {
   paypalIntegration,
   parseState,
   parseServerError,
+  parseMCPToolResult,
   paperIntegration,
   pandadocIntegration,
   outlookIntegration,
@@ -14292,6 +14355,7 @@ export {
   kickIntegration,
   jiraIntegration,
   isTokenExpiredError,
+  isMCPToolError,
   isAuthorizationError,
   isAuthError,
   intercomIntegration,

package/dist/react.d.ts

@@ -3,6 +3,6 @@
  *
  * @packageDocumentation
  */
-export { useIntegrateTokens, useIntegrateAI } from "./src/react/hooks.js";
-export type { UseIntegrateTokensResult, UseIntegrateAIOptions } from "./src/react/hooks.js";
+export { useIntegrateTokens, useIntegrateAI, useIntegrateAuth, } from "./src/react/hooks.js";
+export type { UseIntegrateTokensResult, UseIntegrateAIOptions, UseIntegrateAuthResult, } from "./src/react/hooks.js";
 //# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../react.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC1E,YAAY,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../react.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC"}

package/dist/react.js

@@ -202,7 +202,93 @@ function useIntegrateAI(client, options = {}) {
     };
   }, [client, apiPattern, debug]);
 }
+function useIntegrateAuth(client, provider, options) {
+  const [isAuthorized, setIsAuthorized] = useState(false);
+  const [isLoading, setIsLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const refresh = async () => {
+    if (!client) {
+      setIsAuthorized(false);
+      setIsLoading(false);
+      return;
+    }
+    try {
+      const authorized = await client.isAuthorized(provider, options?.email);
+      setIsAuthorized(authorized);
+      setError(null);
+    } catch (err) {
+      setError(err instanceof Error ? err.message : String(err));
+    } finally {
+      setIsLoading(false);
+    }
+  };
+  useEffect(() => {
+    if (!client || !isReactHooksAvailable()) {
+      setIsLoading(false);
+      return;
+    }
+    refresh();
+    const onChange = () => {
+      refresh();
+    };
+    const onError = (event) => {
+      const payload = event;
+      if (payload.provider === provider) {
+        setError(payload.error ?? "Authorization failed");
+      }
+    };
+    client.on("auth:complete", onChange);
+    client.on("auth:disconnect", onChange);
+    client.on("auth:logout", onChange);
+    client.on("auth:error", onError);
+    return () => {
+      client.off("auth:complete", onChange);
+      client.off("auth:disconnect", onChange);
+      client.off("auth:logout", onChange);
+      client.off("auth:error", onError);
+    };
+  }, [client, provider, options?.email]);
+  const authorize = async () => {
+    if (!client)
+      return;
+    setError(null);
+    setIsLoading(true);
+    try {
+      await client.authorize(provider, options?.returnUrl ? { returnUrl: options.returnUrl } : undefined);
+      await refresh();
+    } catch (err) {
+      setError(err instanceof Error ? err.message : String(err));
+      setIsLoading(false);
+    }
+  };
+  const disconnect = async (email) => {
+    if (!client)
+      return;
+    setError(null);
+    setIsLoading(true);
+    try {
+      if (email) {
+        await client.disconnectAccount(provider, email);
+      } else {
+        await client.disconnectProvider(provider);
+      }
+      await refresh();
+    } catch (err) {
+      setError(err instanceof Error ? err.message : String(err));
+      setIsLoading(false);
+    }
+  };
+  return {
+    isAuthorized,
+    isLoading,
+    error,
+    authorize,
+    disconnect,
+    refresh
+  };
+}
 export {
   useIntegrateTokens,
+  useIntegrateAuth,
   useIntegrateAI
 };