integrate-sdk 0.7.52 → 0.7.53

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

@@ -0,0 +1,127 @@
+/**
+ * Vercel AI SDK Integration
+ *
+ * Helper functions to convert MCP tools to Vercel AI SDK v5 format
+ */
+import { z } from "zod";
+import type { MCPClient } from "../client.js";
+import type { MCPTool } from "../protocol/messages.js";
+/**
+ * Tool definition compatible with Vercel AI SDK v5
+ * This matches the CoreTool interface from 'ai' package v5
+ */
+export interface VercelAITool {
+    description?: string;
+    inputSchema: z.ZodType<any>;
+    execute: (args: any, options?: any) => Promise<any>;
+}
+/**
+ * Options for converting MCP tools to Vercel AI SDK format
+ */
+export interface VercelAIToolsOptions {
+    /**
+     * Provider tokens for server-side usage
+     * Maps provider names (e.g., 'github', 'gmail') to their access tokens
+     *
+     * @example
+     * ```typescript
+     * const tools = getVercelAITools(serverClient, {
+     *   providerTokens: {
+     *     github: 'ghp_...',
+     *     gmail: 'ya29...'
+     *   }
+     * });
+     * ```
+     */
+    providerTokens?: Record<string, string>;
+}
+/**
+ * Convert a single MCP tool to Vercel AI SDK format
+ *
+ * @param mcpTool - The MCP tool definition
+ * @param client - The MCP client instance (used for executing the tool)
+ * @param options - Optional configuration including provider tokens
+ * @returns Vercel AI SDK compatible tool definition
+ */
+export declare function convertMCPToolToVercelAI(mcpTool: MCPTool, client: MCPClient<any>, options?: VercelAIToolsOptions): VercelAITool;
+/**
+ * Convert all enabled MCP tools to Vercel AI SDK v5 format
+ *
+ * @param client - The MCP client instance (must be connected)
+ * @param options - Optional configuration including provider tokens for server-side usage
+ * @returns Object mapping tool names to Vercel AI SDK v5 tool definitions (compatible with CoreTool from 'ai' package v5)
+ *
+ * @example
+ * ```typescript
+ * // Client-side usage
+ * import { createMCPClient, githubPlugin } from 'integrate-sdk';
+ * import { convertMCPToolsToVercelAI } from 'integrate-sdk/vercel-ai';
+ * import { generateText } from 'ai';
+ *
+ * const mcpClient = createMCPClient({
+ *   plugins: [githubPlugin({ clientId: '...', clientSecret: '...' })],
+ * });
+ *
+ * await mcpClient.connect();
+ *
+ * const tools = convertMCPToolsToVercelAI(mcpClient);
+ *
+ * const result = await generateText({
+ *   model: openai('gpt-5'),
+ *   prompt: 'Create a GitHub issue in my repo',
+ *   tools,
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Server-side usage with token passing
+ * import { createMCPServer, githubPlugin } from 'integrate-sdk/server';
+ * import { convertMCPToolsToVercelAI } from 'integrate-sdk/vercel-ai';
+ *
+ * const { client: serverClient } = createMCPServer({
+ *   plugins: [githubPlugin({ clientId: '...', clientSecret: '...' })],
+ * });
+ *
+ * // In your API route handler
+ * export async function POST(req: Request) {
+ *   const providerTokens = JSON.parse(req.headers.get('x-integrate-tokens') || '{}');
+ *
+ *   const tools = convertMCPToolsToVercelAI(serverClient, { providerTokens });
+ *
+ *   const result = await generateText({
+ *     model: openai('gpt-4'),
+ *     prompt: 'Create a GitHub issue',
+ *     tools,
+ *   });
+ *
+ *   return Response.json(result);
+ * }
+ * ```
+ */
+export declare function convertMCPToolsToVercelAI(client: MCPClient<any>, options?: VercelAIToolsOptions): Record<string, any>;
+/**
+ * Get tools in a format compatible with Vercel AI SDK v5's tools parameter
+ *
+ * This returns the tools in the exact format expected by ai.generateText() and ai.streamText()
+ * Automatically connects the client if not already connected.
+ *
+ * @param client - The MCP client instance
+ * @param options - Optional configuration including provider tokens for server-side usage
+ * @returns Tools object ready to pass to generateText({ tools: ... }) or streamText({ tools: ... })
+ *
+ * @example
+ * ```typescript
+ * // Client-side usage
+ * const tools = await getVercelAITools(mcpClient);
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Server-side usage with tokens from client
+ * const providerTokens = JSON.parse(req.headers.get('x-integrate-tokens') || '{}');
+ * const tools = await getVercelAITools(serverClient, { providerTokens });
+ * ```
+ */
+export declare function getVercelAITools(client: MCPClient<any>, options?: VercelAIToolsOptions): Promise<Record<string, any>>;
+//# sourceMappingURL=vercel-ai.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vercel-ai.d.ts","sourceRoot":"","sources":["../../../src/integrations/vercel-ai.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,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAEvD;;;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,oBAAoB;IACnC;;;;;;;;;;;;;OAaG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAmKD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,YAAY,CAsCd;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CASrB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,oBAAoB,gCAQ/B"}

package/dist/src/plugins/generic.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Generic OAuth Plugin
+ * Configure OAuth and enable tools for any integration supported by the server
+ */
+import type { MCPPlugin } from "./types.js";
+/**
+ * Generic OAuth plugin configuration
+ */
+export interface GenericOAuthPluginConfig {
+    /** Plugin unique identifier (must match the integration ID on the server) */
+    id: string;
+    /** OAuth provider name */
+    provider: string;
+    /** OAuth client ID (defaults to {PROVIDER}_CLIENT_ID env var) */
+    clientId?: string;
+    /** OAuth client secret (defaults to {PROVIDER}_CLIENT_SECRET env var) */
+    clientSecret?: string;
+    /** OAuth scopes */
+    scopes: string[];
+    /** Tool names to enable from the server (must exist on the server) */
+    tools: string[];
+    /** OAuth redirect URI */
+    redirectUri?: string;
+    /** Additional provider-specific configuration */
+    config?: Record<string, unknown>;
+    /** Optional initialization callback */
+    onInit?: (client: any) => Promise<void> | void;
+    /** Optional after connect callback */
+    onAfterConnect?: (client: any) => Promise<void> | void;
+    /** Optional disconnect callback */
+    onDisconnect?: (client: any) => Promise<void> | void;
+}
+/**
+ * Generic OAuth Plugin
+ *
+ * Configure OAuth and enable tools for any integration supported by the Integrate MCP server.
+ * Note: This does NOT create new tools - it only configures access to existing server-side tools.
+ * All tools must be implemented on the server and exposed via the MCP protocol.
+ *
+ * By default, reads {PROVIDER}_CLIENT_ID and {PROVIDER}_CLIENT_SECRET from environment variables
+ * (e.g., SLACK_CLIENT_ID, SLACK_CLIENT_SECRET). You can override these by providing explicit values.
+ *
+ * @example Minimal (uses env vars):
+ * ```typescript
+ * // Automatically uses SLACK_CLIENT_ID and SLACK_CLIENT_SECRET from env
+ * const slackPlugin = genericOAuthPlugin({
+ *   id: 'slack',
+ *   provider: 'slack',
+ *   scopes: ['chat:write', 'channels:read'],
+ *   tools: [
+ *     'slack_send_message',      // Must exist on server
+ *     'slack_list_channels',     // Must exist on server
+ *   ],
+ * });
+ *
+ * const client = createMCPClient({
+ *   plugins: [slackPlugin],
+ * });
+ *
+ * await client.connect();
+ * // Call server tools using _callToolByName
+ * await client._callToolByName('slack_send_message', { channel: '#general', text: 'Hello' });
+ * ```
+ *
+ * @example With explicit override:
+ * ```typescript
+ * const slackPlugin = genericOAuthPlugin({
+ *   id: 'slack',
+ *   provider: 'slack',
+ *   clientId: process.env.CUSTOM_SLACK_ID!,
+ *   clientSecret: process.env.CUSTOM_SLACK_SECRET!,
+ *   scopes: ['chat:write', 'channels:read'],
+ *   tools: ['slack_send_message', 'slack_list_channels'],
+ * });
+ * ```
+ */
+export declare function genericOAuthPlugin(config: GenericOAuthPluginConfig): MCPPlugin;
+/**
+ * Create a simple plugin without OAuth
+ * Enable server-provided tools that don't require authentication
+ * Note: Tools must exist on the server - this does not create new tools
+ *
+ * @example
+ * ```typescript
+ * // Enable server-provided math tools (if they exist on the server)
+ * const mathPlugin = createSimplePlugin({
+ *   id: 'math',
+ *   tools: ['math_add', 'math_subtract', 'math_multiply', 'math_divide'],
+ * });
+ * ```
+ */
+export declare function createSimplePlugin(config: {
+    id: string;
+    tools: string[];
+    onInit?: (client: any) => Promise<void> | void;
+    onAfterConnect?: (client: any) => Promise<void> | void;
+    onDisconnect?: (client: any) => Promise<void> | void;
+}): MCPPlugin;
+//# sourceMappingURL=generic.d.ts.map

package/dist/src/plugins/generic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic.d.ts","sourceRoot":"","sources":["../../../src/plugins/generic.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,YAAY,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,6EAA6E;IAC7E,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,sEAAsE;IACtE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,uCAAuC;IACvC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC/C,sCAAsC;IACtC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACvD,mCAAmC;IACnC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACtD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,wBAAwB,GAC/B,SAAS,CAqBX;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC/C,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACvD,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACtD,GAAG,SAAS,CAQZ"}

package/dist/src/plugins/github-client.d.ts

@@ -0,0 +1,320 @@
+/**
+ * GitHub Plugin Client Types
+ * Fully typed interface for GitHub plugin methods
+ */
+import type { MCPToolCallResponse } from "../protocol/messages.js";
+/**
+ * GitHub Issue
+ */
+export interface GitHubIssue {
+    number: number;
+    title: string;
+    body?: string;
+    state: "open" | "closed";
+    html_url: string;
+    user?: {
+        login: string;
+        avatar_url: string;
+    };
+    created_at: string;
+    updated_at: string;
+    closed_at?: string;
+    labels?: Array<{
+        name: string;
+        color: string;
+    }>;
+}
+/**
+ * GitHub Pull Request
+ */
+export interface GitHubPullRequest {
+    number: number;
+    title: string;
+    body?: string;
+    state: "open" | "closed" | "merged";
+    html_url: string;
+    user?: {
+        login: string;
+        avatar_url: string;
+    };
+    created_at: string;
+    updated_at: string;
+    merged_at?: string;
+    head: {
+        ref: string;
+        sha: string;
+    };
+    base: {
+        ref: string;
+        sha: string;
+    };
+}
+/**
+ * GitHub Repository
+ */
+export interface GitHubRepository {
+    id: number;
+    name: string;
+    full_name: string;
+    description?: string;
+    html_url: string;
+    private: boolean;
+    owner: {
+        login: string;
+        avatar_url: string;
+    };
+    created_at: string;
+    updated_at: string;
+    pushed_at: string;
+    stargazers_count: number;
+    watchers_count: number;
+    forks_count: number;
+    language?: string;
+    default_branch: string;
+}
+/**
+ * GitHub Branch
+ */
+export interface GitHubBranch {
+    name: string;
+    commit: {
+        sha: string;
+        url: string;
+    };
+    protected: boolean;
+}
+/**
+ * GitHub User
+ */
+export interface GitHubUser {
+    login: string;
+    id: number;
+    avatar_url: string;
+    html_url: string;
+    name?: string;
+    email?: string;
+    bio?: string;
+    public_repos: number;
+    followers: number;
+    following: number;
+    created_at: string;
+}
+/**
+ * GitHub Commit
+ */
+export interface GitHubCommit {
+    sha: string;
+    commit: {
+        message: string;
+        author: {
+            name: string;
+            email: string;
+            date: string;
+        };
+        committer: {
+            name: string;
+            email: string;
+            date: string;
+        };
+    };
+    html_url: string;
+    author?: {
+        login: string;
+        avatar_url: string;
+    };
+    committer?: {
+        login: string;
+        avatar_url: string;
+    };
+}
+/**
+ * GitHub Plugin Client Interface
+ * Provides type-safe methods for all GitHub operations
+ */
+export interface GitHubPluginClient {
+    /**
+     * Create a new issue in a repository
+     */
+    createIssue(params: {
+        owner: string;
+        repo: string;
+        title: string;
+        body?: string;
+        labels?: string[];
+        assignees?: string[];
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * List issues in a repository
+     */
+    listIssues(params: {
+        owner: string;
+        repo: string;
+        state?: "open" | "closed" | "all";
+        labels?: string[];
+        sort?: "created" | "updated" | "comments";
+        direction?: "asc" | "desc";
+        per_page?: number;
+        page?: number;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Get a specific issue
+     */
+    getIssue(params: {
+        owner: string;
+        repo: string;
+        issue_number: number;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Update an existing issue
+     */
+    updateIssue(params: {
+        owner: string;
+        repo: string;
+        issue_number: number;
+        title?: string;
+        body?: string;
+        state?: "open" | "closed";
+        labels?: string[];
+        assignees?: string[];
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Close an issue
+     */
+    closeIssue(params: {
+        owner: string;
+        repo: string;
+        issue_number: number;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Create a pull request
+     */
+    createPullRequest(params: {
+        owner: string;
+        repo: string;
+        title: string;
+        head: string;
+        base: string;
+        body?: string;
+        draft?: boolean;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * List pull requests in a repository
+     */
+    listPullRequests(params: {
+        owner: string;
+        repo: string;
+        state?: "open" | "closed" | "all";
+        sort?: "created" | "updated" | "popularity" | "long-running";
+        direction?: "asc" | "desc";
+        per_page?: number;
+        page?: number;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Get a specific pull request
+     */
+    getPullRequest(params: {
+        owner: string;
+        repo: string;
+        pull_number: number;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Merge a pull request
+     */
+    mergePullRequest(params: {
+        owner: string;
+        repo: string;
+        pull_number: number;
+        commit_title?: string;
+        commit_message?: string;
+        merge_method?: "merge" | "squash" | "rebase";
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * List repositories (for a user or organization)
+     */
+    listRepos(params: {
+        owner: string;
+        type?: "all" | "owner" | "member";
+        sort?: "created" | "updated" | "pushed" | "full_name";
+        direction?: "asc" | "desc";
+        per_page?: number;
+        page?: number;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * List repositories for the authenticated user
+     */
+    listOwnRepos(params?: {
+        visibility?: "all" | "public" | "private";
+        affiliation?: string;
+        type?: "all" | "owner" | "public" | "private" | "member";
+        sort?: "created" | "updated" | "pushed" | "full_name";
+        direction?: "asc" | "desc";
+        per_page?: number;
+        page?: number;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Get a specific repository
+     */
+    getRepo(params: {
+        owner: string;
+        repo: string;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Create a new repository
+     */
+    createRepo(params: {
+        name: string;
+        description?: string;
+        private?: boolean;
+        auto_init?: boolean;
+        gitignore_template?: string;
+        license_template?: string;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * List branches in a repository
+     */
+    listBranches(params: {
+        owner: string;
+        repo: string;
+        protected?: boolean;
+        per_page?: number;
+        page?: number;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Create a new branch
+     */
+    createBranch(params: {
+        owner: string;
+        repo: string;
+        branch: string;
+        from_branch?: string;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Get information about a user
+     */
+    getUser(params: {
+        username: string;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * List commits in a repository
+     */
+    listCommits(params: {
+        owner: string;
+        repo: string;
+        sha?: string;
+        path?: string;
+        author?: string;
+        since?: string;
+        until?: string;
+        per_page?: number;
+        page?: number;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Get a specific commit
+     */
+    getCommit(params: {
+        owner: string;
+        repo: string;
+        ref: string;
+    }): Promise<MCPToolCallResponse>;
+}
+//# sourceMappingURL=github-client.d.ts.map

package/dist/src/plugins/github-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-client.d.ts","sourceRoot":"","sources":["../../../src/plugins/github-client.ts"],"names":[],"mappings":"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"}

package/dist/src/plugins/github.d.ts

@@ -0,0 +1,89 @@
+/**
+ * GitHub Plugin
+ * Enables GitHub tools with OAuth configuration
+ */
+import type { MCPPlugin } from "./types.js";
+/**
+ * GitHub plugin configuration
+ *
+ * SERVER-SIDE: Automatically reads GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET from environment.
+ * You can override by providing explicit clientId and clientSecret values.
+ * CLIENT-SIDE: Omit clientId and clientSecret when using createMCPClient()
+ */
+export interface GitHubPluginConfig {
+    /** GitHub OAuth client ID (defaults to GITHUB_CLIENT_ID env var) */
+    clientId?: string;
+    /** GitHub OAuth client secret (defaults to GITHUB_CLIENT_SECRET env var) */
+    clientSecret?: string;
+    /** Additional OAuth scopes (default: ['repo', 'user']) */
+    scopes?: string[];
+    /** OAuth redirect URI */
+    redirectUri?: string;
+    /** GitHub API base URL (default: https://api.github.com) */
+    apiBaseUrl?: string;
+}
+/**
+ * Default GitHub tools that this plugin enables
+ * These should match the tool names exposed by your MCP server
+ */
+declare const GITHUB_TOOLS: readonly ["github_create_issue", "github_list_issues", "github_get_issue", "github_update_issue", "github_close_issue", "github_create_pull_request", "github_list_pull_requests", "github_get_pull_request", "github_merge_pull_request", "github_list_repos", "github_list_own_repos", "github_get_repo", "github_create_repo", "github_list_branches", "github_create_branch", "github_get_user", "github_list_commits", "github_get_commit"];
+/**
+ * GitHub Plugin
+ *
+ * Enables GitHub integration with OAuth authentication.
+ *
+ * By default, reads GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET from environment variables.
+ * You can override these by providing explicit values in the config.
+ *
+ * @example Server-side (minimal - uses env vars):
+ * ```typescript
+ * import { createMCPServer, githubPlugin } from 'integrate-sdk/server';
+ *
+ * // Automatically uses GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET from env
+ * export const { client } = createMCPServer({
+ *   plugins: [
+ *     githubPlugin({
+ *       scopes: ['repo', 'user', 'read:org'],
+ *     }),
+ *   ],
+ * });
+ * ```
+ *
+ * @example Server-side (with explicit override):
+ * ```typescript
+ * import { createMCPServer, githubPlugin } from 'integrate-sdk/server';
+ *
+ * export const { client } = createMCPServer({
+ *   plugins: [
+ *     githubPlugin({
+ *       clientId: process.env.CUSTOM_GITHUB_ID!,
+ *       clientSecret: process.env.CUSTOM_GITHUB_SECRET!,
+ *       scopes: ['repo', 'user', 'read:org'],
+ *     }),
+ *   ],
+ * });
+ * ```
+ *
+ * @example Client-side (without secrets):
+ * ```typescript
+ * import { createMCPClient, githubPlugin } from 'integrate-sdk';
+ *
+ * const client = createMCPClient({
+ *   plugins: [
+ *     githubPlugin({
+ *       scopes: ['repo', 'user', 'read:org'],
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+export declare function githubPlugin(config?: GitHubPluginConfig): MCPPlugin;
+/**
+ * Export tool names for type inference
+ */
+export type GitHubTools = typeof GITHUB_TOOLS[number];
+/**
+ * Export GitHub client types
+ */
+export type { GitHubPluginClient } from "./github-client.js";
+//# sourceMappingURL=github.d.ts.map

package/dist/src/plugins/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../../src/plugins/github.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,YAAY,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,QAAA,MAAM,YAAY,kbAmBR,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,wBAAgB,YAAY,CAAC,MAAM,GAAE,kBAAuB,GAAG,SAAS,CA0BvE;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;AAEtD;;GAEG;AACH,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/src/plugins/gmail-client.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Gmail Plugin Client Types
+ * Fully typed interface for Gmail plugin methods
+ */
+import type { MCPToolCallResponse } from "../protocol/messages.js";
+/**
+ * Gmail Email Message
+ */
+export interface GmailMessage {
+    id: string;
+    threadId: string;
+    labelIds?: string[];
+    snippet?: string;
+    payload?: {
+        headers?: Array<{
+            name: string;
+            value: string;
+        }>;
+        body?: {
+            data?: string;
+            size?: number;
+        };
+        parts?: Array<{
+            mimeType?: string;
+            body?: {
+                data?: string;
+                size?: number;
+            };
+        }>;
+    };
+    sizeEstimate?: number;
+    historyId?: string;
+    internalDate?: string;
+}
+/**
+ * Gmail Label
+ */
+export interface GmailLabel {
+    id: string;
+    name: string;
+    type?: "system" | "user";
+    messageListVisibility?: "show" | "hide";
+    labelListVisibility?: "labelShow" | "labelShowIfUnread" | "labelHide";
+    color?: {
+        textColor?: string;
+        backgroundColor?: string;
+    };
+}
+/**
+ * Gmail Draft
+ */
+export interface GmailDraft {
+    id: string;
+    message: GmailMessage;
+}
+/**
+ * Gmail Plugin Client Interface
+ * Provides type-safe methods for all Gmail operations
+ */
+export interface GmailPluginClient {
+    /**
+     * Send a message
+     */
+    sendMessage(params: {
+        to: string | string[];
+        subject: string;
+        body: string;
+        cc?: string | string[];
+        bcc?: string | string[];
+        from?: string;
+        replyTo?: string;
+        html?: boolean;
+        attachments?: Array<{
+            filename: string;
+            content: string;
+            encoding?: string;
+        }>;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * List messages in the mailbox
+     */
+    listMessages(params?: {
+        maxResults?: number;
+        pageToken?: string;
+        q?: string;
+        labelIds?: string[];
+        includeSpamTrash?: boolean;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Get a specific message by ID
+     */
+    getMessage(params: {
+        id: string;
+        format?: "minimal" | "full" | "raw" | "metadata";
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Search messages with query
+     */
+    searchMessages(params: {
+        query: string;
+        maxResults?: number;
+        pageToken?: string;
+        includeSpamTrash?: boolean;
+    }): Promise<MCPToolCallResponse>;
+}
+//# sourceMappingURL=gmail-client.d.ts.map

package/dist/src/plugins/gmail-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gmail-client.d.ts","sourceRoot":"","sources":["../../../src/plugins/gmail-client.ts"],"names":[],"mappings":"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"}

package/dist/src/plugins/gmail.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Gmail Plugin
+ * Enables Gmail tools with OAuth configuration
+ */
+import type { MCPPlugin } from "./types.js";
+/**
+ * Gmail plugin configuration
+ *
+ * SERVER-SIDE: Automatically reads GMAIL_CLIENT_ID and GMAIL_CLIENT_SECRET from environment.
+ * You can override by providing explicit clientId and clientSecret values.
+ * CLIENT-SIDE: Omit clientId and clientSecret when using createMCPClient()
+ */
+export interface GmailPluginConfig {
+    /** Google OAuth client ID (defaults to GMAIL_CLIENT_ID env var) */
+    clientId?: string;
+    /** Google OAuth client secret (defaults to GMAIL_CLIENT_SECRET env var) */
+    clientSecret?: string;
+    /** Additional OAuth scopes (default: Gmail API scopes) */
+    scopes?: string[];
+    /** OAuth redirect URI */
+    redirectUri?: string;
+}
+/**
+ * Default Gmail tools that this plugin enables
+ * These should match the tool names exposed by your MCP server
+ */
+declare const GMAIL_TOOLS: readonly ["gmail_send_message", "gmail_list_messages", "gmail_get_message", "gmail_search_messages"];
+/**
+ * Gmail Plugin
+ *
+ * Enables Gmail integration with OAuth authentication.
+ *
+ * By default, reads GMAIL_CLIENT_ID and GMAIL_CLIENT_SECRET from environment variables.
+ * You can override these by providing explicit values in the config.
+ *
+ * @example Server-side (minimal - uses env vars):
+ * ```typescript
+ * import { createMCPServer, gmailPlugin } from 'integrate-sdk/server';
+ *
+ * // Automatically uses GMAIL_CLIENT_ID and GMAIL_CLIENT_SECRET from env
+ * export const { client } = createMCPServer({
+ *   plugins: [
+ *     gmailPlugin({
+ *       scopes: ['gmail.send', 'gmail.readonly'],
+ *     }),
+ *   ],
+ * });
+ * ```
+ *
+ * @example Server-side (with explicit override):
+ * ```typescript
+ * import { createMCPServer, gmailPlugin } from 'integrate-sdk/server';
+ *
+ * export const { client } = createMCPServer({
+ *   plugins: [
+ *     gmailPlugin({
+ *       clientId: process.env.CUSTOM_GMAIL_ID!,
+ *       clientSecret: process.env.CUSTOM_GMAIL_SECRET!,
+ *       scopes: ['gmail.send', 'gmail.readonly'],
+ *     }),
+ *   ],
+ * });
+ * ```
+ *
+ * @example Client-side (without secrets):
+ * ```typescript
+ * import { createMCPClient, gmailPlugin } from 'integrate-sdk';
+ *
+ * const client = createMCPClient({
+ *   plugins: [
+ *     gmailPlugin({
+ *       scopes: ['gmail.send', 'gmail.readonly'],
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+export declare function gmailPlugin(config?: GmailPluginConfig): MCPPlugin;
+/**
+ * Export tool names for type inference
+ */
+export type GmailTools = typeof GMAIL_TOOLS[number];
+/**
+ * Export Gmail client types
+ */
+export type { GmailPluginClient } from "./gmail-client.js";
+//# sourceMappingURL=gmail.d.ts.map

package/dist/src/plugins/gmail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gmail.d.ts","sourceRoot":"","sources":["../../../src/plugins/gmail.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,YAAY,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,QAAA,MAAM,WAAW,sGAKP,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,wBAAgB,WAAW,CAAC,MAAM,GAAE,iBAAsB,GAAG,SAAS,CA4BrE;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;AAEpD;;GAEG;AACH,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/src/plugins/server-client.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Server Plugin Client Types
+ * Fully typed interface for server-level tools that don't belong to a specific plugin
+ */
+import type { MCPToolCallResponse } from "../protocol/messages.js";
+/**
+ * Server Plugin Client Interface
+ * Provides type-safe methods for server-level operations
+ */
+export interface ServerPluginClient {
+    /**
+     * List all tools available for a specific integration
+     */
+    listToolsByIntegration(params: {
+        integration: string;
+    }): Promise<MCPToolCallResponse>;
+}
+//# sourceMappingURL=server-client.d.ts.map

package/dist/src/plugins/server-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-client.d.ts","sourceRoot":"","sources":["../../../src/plugins/server-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,sBAAsB,CAAC,MAAM,EAAE;QAC7B,WAAW,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAClC"}

package/dist/src/plugins/types.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Plugin System Types
+ * Inspired by BetterAuth's provider pattern
+ */
+import type { MCPClient } from "../client.js";
+/**
+ * OAuth Configuration for a plugin
+ *
+ * CLIENT-SIDE: You no longer need to provide clientId/clientSecret in the browser.
+ * These should be kept server-side in your OAuth API routes for security.
+ *
+ * SERVER-SIDE: OAuth credentials are provided via API route configuration
+ * using createNextOAuthHandler() or createTanStackOAuthHandler().
+ */
+export interface OAuthConfig {
+    /** OAuth provider identifier (e.g., 'github', 'google') */
+    provider: string;
+    /**
+     * OAuth client ID (optional - only needed for legacy direct MCP server calls)
+     * @deprecated Keep client ID server-side in OAuth API route configuration
+     */
+    clientId?: string | undefined;
+    /**
+     * OAuth client secret (optional - only needed for legacy direct MCP server calls)
+     * @deprecated Keep client secret server-side in OAuth API route configuration
+     */
+    clientSecret?: string | undefined;
+    /** Required OAuth scopes */
+    scopes: string[];
+    /** Redirect URI for OAuth flow */
+    redirectUri?: string;
+    /** Provider-specific configuration */
+    config?: unknown;
+}
+/**
+ * MCP Plugin Interface
+ *
+ * Plugins enable specific tools and configure OAuth providers
+ */
+export interface MCPPlugin {
+    /** Unique plugin identifier */
+    id: string;
+    /** List of tool names this plugin enables */
+    tools: string[];
+    /** OAuth configuration for this plugin */
+    oauth?: OAuthConfig;
+    /** Called when the plugin is initialized with the client */
+    onInit?: (client: MCPClient<any>) => Promise<void> | void;
+    /** Called before the client connects to the server */
+    onBeforeConnect?: (client: MCPClient<any>) => Promise<void> | void;
+    /** Called after the client successfully connects */
+    onAfterConnect?: (client: MCPClient<any>) => Promise<void> | void;
+    /** Called when the client disconnects */
+    onDisconnect?: (client: MCPClient<any>) => Promise<void> | void;
+}
+/**
+ * Helper type to extract plugin IDs from an array of plugins
+ */
+export type ExtractPluginIds<T extends readonly MCPPlugin[]> = T[number]["id"];
+/**
+ * Helper type to extract tools from an array of plugins
+ */
+export type ExtractPluginTools<T extends readonly MCPPlugin[]> = T[number]["tools"][number];
+/**
+ * Type guard to check if a plugin has OAuth configuration
+ */
+export declare function hasOAuthConfig(plugin: MCPPlugin): plugin is MCPPlugin & {
+    oauth: OAuthConfig;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/plugins/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/plugins/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE9B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAElC,4BAA4B;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,sCAAsC;IACtC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IAEX,6CAA6C;IAC7C,KAAK,EAAE,MAAM,EAAE,CAAC;IAEhB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,WAAW,CAAC;IAEpB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAE1D,sDAAsD;IACtD,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAEnE,oDAAoD;IACpD,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAElE,yCAAyC;IACzC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACjE;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,SAAS,SAAS,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;AAE/E;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,SAAS,SAAS,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5F;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,SAAS,GAChB,MAAM,IAAI,SAAS,GAAG;IAAE,KAAK,EAAE,WAAW,CAAA;CAAE,CAE9C"}

package/index.ts

@@ -34,6 +34,7 @@ export * from './src/index.js';
 import { createMCPClient } from './src/client.js';
 import { githubIntegration } from './src/integrations/github.js';
 import { gmailIntegration } from './src/integrations/gmail.js';
+import { notionIntegration } from './src/integrations/notion.js';
 
 /**
  * Default MCP Client with all integrations pre-configured
@@ -63,6 +64,7 @@ export const client = createMCPClient({
   integrations: [
     githubIntegration(),
     gmailIntegration(),
+    notionIntegration(),
   ],
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "integrate-sdk",
-  "version": "0.7.52",
+  "version": "0.7.53",
   "description": "Type-safe 3rd party integration SDK for the Integrate MCP server",
   "type": "module",
   "main": "./dist/index.js",