integrate-sdk 0.8.36 → 0.8.39

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"}