integrate-sdk 0.3.7 → 0.3.8

package/src/plugins/github-client.ts

@@ -1,345 +0,0 @@
-/**
- * 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>;
-}
-

package/src/plugins/github.ts

@@ -1,122 +0,0 @@
-/**
- * GitHub Plugin
- * Enables GitHub tools with OAuth configuration
- */
-
-import type { MCPPlugin, OAuthConfig } from "./types.js";
-
-/**
- * GitHub plugin configuration
- * 
- * SERVER-SIDE: Include clientId and clientSecret when using createMCPServer()
- * CLIENT-SIDE: Omit clientId and clientSecret when using createMCPClient()
- */
-export interface GitHubPluginConfig {
-  /** GitHub OAuth client ID (required on server, omit on client) */
-  clientId?: string;
-  /** GitHub OAuth client secret (required on server, omit on client) */
-  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
- */
-const GITHUB_TOOLS = [
-  "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",
-] as const;
-
-/**
- * GitHub Plugin
- * 
- * Enables GitHub integration with OAuth authentication
- * 
- * @example Server-side (with secrets):
- * ```typescript
- * import { createMCPServer, githubPlugin } from 'integrate-sdk/server';
- * 
- * export const { client } = createMCPServer({
- *   plugins: [
- *     githubPlugin({
- *       clientId: process.env.GITHUB_CLIENT_ID!,
- *       clientSecret: process.env.GITHUB_CLIENT_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 function githubPlugin(config: GitHubPluginConfig): MCPPlugin {
-  const oauth: OAuthConfig = {
-    provider: "github",
-    clientId: config.clientId,
-    clientSecret: config.clientSecret,
-    scopes: config.scopes || ["repo", "user"],
-    redirectUri: config.redirectUri,
-    config: {
-      apiBaseUrl: config.apiBaseUrl || "https://api.github.com",
-      ...config,
-    },
-  };
-
-  return {
-    id: "github",
-    tools: [...GITHUB_TOOLS],
-    oauth,
-    
-    async onInit(_client) {
-      console.log("GitHub plugin initialized");
-    },
-    
-    async onAfterConnect(_client) {
-      console.log("GitHub plugin connected");
-    },
-  };
-}
-
-/**
- * Export tool names for type inference
- */
-export type GitHubTools = typeof GITHUB_TOOLS[number];
-
-/**
- * Export GitHub client types
- */
-export type { GitHubPluginClient } from "./github-client.js";
-

package/src/plugins/gmail-client.ts

@@ -1,114 +0,0 @@
-/**
- * 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>;
-}
-

package/src/plugins/gmail.ts

@@ -1,108 +0,0 @@
-/**
- * Gmail Plugin
- * Enables Gmail tools with OAuth configuration
- */
-
-import type { MCPPlugin, OAuthConfig } from "./types.js";
-
-/**
- * Gmail plugin configuration
- * 
- * SERVER-SIDE: Include clientId and clientSecret when using createMCPServer()
- * CLIENT-SIDE: Omit clientId and clientSecret when using createMCPClient()
- */
-export interface GmailPluginConfig {
-  /** Google OAuth client ID (required on server, omit on client) */
-  clientId?: string;
-  /** Google OAuth client secret (required on server, omit on client) */
-  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
- */
-const GMAIL_TOOLS = [
-  "gmail_send_message",
-  "gmail_list_messages",
-  "gmail_get_message",
-  "gmail_search_messages",
-] as const;
-
-/**
- * Gmail Plugin
- * 
- * Enables Gmail integration with OAuth authentication
- * 
- * @example Server-side (with secrets):
- * ```typescript
- * import { createMCPServer, gmailPlugin } from 'integrate-sdk/server';
- * 
- * export const { client } = createMCPServer({
- *   plugins: [
- *     gmailPlugin({
- *       clientId: process.env.GMAIL_CLIENT_ID!,
- *       clientSecret: process.env.GMAIL_CLIENT_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 function gmailPlugin(config: GmailPluginConfig): MCPPlugin {
-  const oauth: OAuthConfig = {
-    provider: "google",
-    clientId: config.clientId,
-    clientSecret: config.clientSecret,
-    scopes: config.scopes || [
-      "https://www.googleapis.com/auth/gmail.send",
-      "https://www.googleapis.com/auth/gmail.readonly",
-      "https://www.googleapis.com/auth/gmail.modify",
-      "https://www.googleapis.com/auth/gmail.labels",
-    ],
-    redirectUri: config.redirectUri,
-    config,
-  };
-
-  return {
-    id: "gmail",
-    tools: [...GMAIL_TOOLS],
-    oauth,
-    
-    async onInit(_client) {
-      console.log("Gmail plugin initialized");
-    },
-    
-    async onAfterConnect(_client) {
-      console.log("Gmail plugin connected");
-    },
-  };
-}
-
-/**
- * Export tool names for type inference
- */
-export type GmailTools = typeof GMAIL_TOOLS[number];
-
-/**
- * Export Gmail client types
- */
-export type { GmailPluginClient } from "./gmail-client.js";
-

package/src/plugins/server-client.ts

@@ -1,20 +0,0 @@
-/**
- * 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>;
-}
-