@mcp-z/mcp-gmail 1.0.0

package/dist/esm/setup/config.js

@@ -0,0 +1,175 @@
+import { parseDcrConfig, parseConfig as parseOAuthConfig } from '@mcp-z/oauth-google';
+import { parseConfig as parseTransportConfig } from '@mcp-z/server';
+import * as fs from 'fs';
+import moduleRoot from 'module-root-sync';
+import { homedir } from 'os';
+import * as path from 'path';
+import * as url from 'url';
+import { parseArgs } from 'util';
+import { GOOGLE_SCOPE } from '../constants.js';
+const pkg = JSON.parse(fs.readFileSync(path.join(moduleRoot(url.fileURLToPath(import.meta.url)), 'package.json'), 'utf-8'));
+const HELP_TEXT = `
+Usage: mcp-gmail [options]
+
+MCP server for Gmail email management with OAuth authentication.
+
+Options:
+  --version              Show version number
+  --help                 Show this help message
+  --auth=<mode>          Authentication mode (default: loopback-oauth)
+                         Modes: loopback-oauth, service-account, dcr
+  --headless             Disable browser auto-open, return auth URL instead
+  --redirect-uri=<uri>   OAuth redirect URI (default: ephemeral loopback)
+  --dcr-mode=<mode>      DCR mode (self-hosted or external, default: self-hosted)
+  --dcr-verify-url=<url> External verification endpoint (required for external mode)
+  --dcr-store-uri=<uri>  DCR client storage URI (required for self-hosted mode)
+  --port=<port>          Enable HTTP transport on specified port
+  --stdio                Enable stdio transport (default if no port)
+  --log-level=<level>    Logging level (default: info)
+  --storage-dir=<path>   Directory for CSV file storage (default: .mcp-z/files)
+  --base-url=<url>       Base URL for HTTP file serving (optional)
+
+Environment Variables:
+  GOOGLE_CLIENT_ID       OAuth client ID (REQUIRED)
+  GOOGLE_CLIENT_SECRET   OAuth client secret (optional)
+  AUTH_MODE              Default authentication mode (optional)
+  HEADLESS               Disable browser auto-open (optional)
+  DCR_MODE               DCR mode (optional, same format as --dcr-mode)
+  DCR_VERIFY_URL         External verification URL (optional, same as --dcr-verify-url)
+  DCR_STORE_URI          DCR storage URI (optional, same as --dcr-store-uri)
+  PORT                   Default HTTP port (optional)
+  LOG_LEVEL              Default logging level (optional)
+  STORAGE_DIR            Default storage directory (optional)
+  BASE_URL               Default base URL for file serving (optional)
+
+OAuth Scopes:
+  openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://mail.google.com/
+
+Examples:
+  mcp-gmail                           # Use default settings
+  mcp-gmail --auth=service-account    # Use service account auth
+  mcp-gmail --port=3000               # HTTP transport on port 3000
+  mcp-gmail --storage-dir=./emails    # Custom storage directory
+  GOOGLE_CLIENT_ID=xxx mcp-gmail      # Set client ID via env var
+`.trim();
+/**
+ * Handle --version and --help flags before config parsing.
+ * These should work without requiring any configuration.
+ */ export function handleVersionHelp(args) {
+    const { values } = parseArgs({
+        args,
+        options: {
+            version: {
+                type: 'boolean'
+            },
+            help: {
+                type: 'boolean'
+            }
+        },
+        strict: false
+    });
+    if (values.version) return {
+        handled: true,
+        output: pkg.version
+    };
+    if (values.help) return {
+        handled: true,
+        output: HELP_TEXT
+    };
+    return {
+        handled: false
+    };
+}
+/**
+ * Parse Gmail server configuration from CLI arguments and environment.
+ *
+ * CLI Arguments (all optional):
+ * - --auth=<mode>          Authentication mode (default: loopback-oauth)
+ *                          Modes: loopback-oauth, service-account, dcr
+ * - --headless             Disable browser auto-open, return auth URL instead
+ * - --redirect-uri=<uri>   OAuth redirect URI (default: ephemeral loopback)
+ * - --dcr-mode=<mode>      DCR mode (self-hosted or external, default: self-hosted)
+ * - --dcr-verify-url=<url> External verification endpoint (required for external mode)
+ * - --dcr-store-uri=<uri>  DCR client storage URI (required for self-hosted mode)
+ * - --port=<port>          Enable HTTP transport on specified port
+ * - --stdio                Enable stdio transport (default if no port)
+ * - --log-level=<level>    Logging level (default: info)
+ * - --storage-dir=<path>   Directory for CSV file storage (default: .mcp-z/files)
+ * - --base-url=<url>       Base URL for HTTP file serving (optional)
+ *
+ * Environment Variables:
+ * - GOOGLE_CLIENT_ID       OAuth client ID (REQUIRED)
+ * - GOOGLE_CLIENT_SECRET   OAuth client secret (optional)
+ * - AUTH_MODE              Default authentication mode (optional)
+ * - HEADLESS               Disable browser auto-open (optional)
+ * - DCR_MODE               DCR mode (optional, same format as --dcr-mode)
+ * - DCR_VERIFY_URL         External verification URL (optional, same as --dcr-verify-url)
+ * - DCR_STORE_URI          DCR storage URI (optional, same as --dcr-store-uri)
+ * - PORT                   Default HTTP port (optional)
+ * - LOG_LEVEL              Default logging level (optional)
+ * - STORAGE_DIR            Default storage directory (optional)
+ * - BASE_URL               Default base URL for file serving (optional)
+ *
+ * OAuth Scopes (from constants.ts):
+ * openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://mail.google.com/
+ */ export function parseConfig(args, env) {
+    var _ref, _ref1, _ref2;
+    const transportConfig = parseTransportConfig(args, env);
+    const oauthConfig = parseOAuthConfig(args, env);
+    // Parse DCR configuration if DCR mode is enabled
+    const dcrConfig = oauthConfig.auth === 'dcr' ? parseDcrConfig(args, env, GOOGLE_SCOPE) : undefined;
+    // Parse application-level config (LOG_LEVEL, STORAGE_DIR, BASE_URL)
+    const { values } = parseArgs({
+        args,
+        options: {
+            'log-level': {
+                type: 'string'
+            },
+            'storage-dir': {
+                type: 'string'
+            },
+            'base-url': {
+                type: 'string'
+            }
+        },
+        strict: false,
+        allowPositionals: true
+    });
+    const name = pkg.name.replace(/^@[^/]+\//, '');
+    // Parse repository URL from package.json, stripping git+ prefix and .git suffix
+    const rawRepoUrl = typeof pkg.repository === 'object' ? pkg.repository.url : pkg.repository;
+    const repositoryUrl = (_ref = rawRepoUrl === null || rawRepoUrl === void 0 ? void 0 : rawRepoUrl.replace(/^git\+/, '').replace(/\.git$/, '')) !== null && _ref !== void 0 ? _ref : `https://github.com/mcp-z/${name}`;
+    const rootDir = process.cwd() === '/' ? homedir() : process.cwd();
+    const baseDir = path.join(rootDir, '.mcp-z');
+    const cliLogLevel = typeof values['log-level'] === 'string' ? values['log-level'] : undefined;
+    const envLogLevel = env.LOG_LEVEL;
+    const logLevel = (_ref1 = cliLogLevel !== null && cliLogLevel !== void 0 ? cliLogLevel : envLogLevel) !== null && _ref1 !== void 0 ? _ref1 : 'info';
+    // Parse storage configuration
+    const cliStorageDir = typeof values['storage-dir'] === 'string' ? values['storage-dir'] : undefined;
+    const envStorageDir = env.STORAGE_DIR;
+    let storageDir = (_ref2 = cliStorageDir !== null && cliStorageDir !== void 0 ? cliStorageDir : envStorageDir) !== null && _ref2 !== void 0 ? _ref2 : path.join(baseDir, name, 'files');
+    if (storageDir.startsWith('~')) storageDir = storageDir.replace(/^~/, homedir());
+    const cliBaseUrl = typeof values['base-url'] === 'string' ? values['base-url'] : undefined;
+    const envBaseUrl = env.BASE_URL;
+    const baseUrl = cliBaseUrl !== null && cliBaseUrl !== void 0 ? cliBaseUrl : envBaseUrl;
+    // Combine configs
+    const result = {
+        ...oauthConfig,
+        transport: transportConfig.transport,
+        logLevel,
+        baseDir,
+        name,
+        version: pkg.version,
+        repositoryUrl,
+        storageDir: path.resolve(storageDir)
+    };
+    if (baseUrl) result.baseUrl = baseUrl;
+    if (dcrConfig !== undefined) result.dcrConfig = dcrConfig;
+    return result;
+}
+/**
+ * Build production configuration from process globals.
+ * Entry point for production server.
+ */ export function createConfig() {
+    return parseConfig(process.argv, process.env);
+}

package/dist/esm/setup/config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-gmail/src/setup/config.ts"],"sourcesContent":["import { parseDcrConfig, parseConfig as parseOAuthConfig } from '@mcp-z/oauth-google';\nimport { parseConfig as parseTransportConfig } from '@mcp-z/server';\nimport * as fs from 'fs';\nimport moduleRoot from 'module-root-sync';\nimport { homedir } from 'os';\nimport * as path from 'path';\nimport * as url from 'url';\nimport { parseArgs } from 'util';\nimport { GOOGLE_SCOPE } from '../constants.ts';\nimport type { ServerConfig } from '../types.js';\n\nconst pkg = JSON.parse(fs.readFileSync(path.join(moduleRoot(url.fileURLToPath(import.meta.url)), 'package.json'), 'utf-8'));\n\nconst HELP_TEXT = `\nUsage: mcp-gmail [options]\n\nMCP server for Gmail email management with OAuth authentication.\n\nOptions:\n  --version              Show version number\n  --help                 Show this help message\n  --auth=<mode>          Authentication mode (default: loopback-oauth)\n                         Modes: loopback-oauth, service-account, dcr\n  --headless             Disable browser auto-open, return auth URL instead\n  --redirect-uri=<uri>   OAuth redirect URI (default: ephemeral loopback)\n  --dcr-mode=<mode>      DCR mode (self-hosted or external, default: self-hosted)\n  --dcr-verify-url=<url> External verification endpoint (required for external mode)\n  --dcr-store-uri=<uri>  DCR client storage URI (required for self-hosted mode)\n  --port=<port>          Enable HTTP transport on specified port\n  --stdio                Enable stdio transport (default if no port)\n  --log-level=<level>    Logging level (default: info)\n  --storage-dir=<path>   Directory for CSV file storage (default: .mcp-z/files)\n  --base-url=<url>       Base URL for HTTP file serving (optional)\n\nEnvironment Variables:\n  GOOGLE_CLIENT_ID       OAuth client ID (REQUIRED)\n  GOOGLE_CLIENT_SECRET   OAuth client secret (optional)\n  AUTH_MODE              Default authentication mode (optional)\n  HEADLESS               Disable browser auto-open (optional)\n  DCR_MODE               DCR mode (optional, same format as --dcr-mode)\n  DCR_VERIFY_URL         External verification URL (optional, same as --dcr-verify-url)\n  DCR_STORE_URI          DCR storage URI (optional, same as --dcr-store-uri)\n  PORT                   Default HTTP port (optional)\n  LOG_LEVEL              Default logging level (optional)\n  STORAGE_DIR            Default storage directory (optional)\n  BASE_URL               Default base URL for file serving (optional)\n\nOAuth Scopes:\n  openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://mail.google.com/\n\nExamples:\n  mcp-gmail                           # Use default settings\n  mcp-gmail --auth=service-account    # Use service account auth\n  mcp-gmail --port=3000               # HTTP transport on port 3000\n  mcp-gmail --storage-dir=./emails    # Custom storage directory\n  GOOGLE_CLIENT_ID=xxx mcp-gmail      # Set client ID via env var\n`.trim();\n\n/**\n * Handle --version and --help flags before config parsing.\n * These should work without requiring any configuration.\n */\nexport function handleVersionHelp(args: string[]): { handled: boolean; output?: string } {\n  const { values } = parseArgs({\n    args,\n    options: {\n      version: { type: 'boolean' },\n      help: { type: 'boolean' },\n    },\n    strict: false,\n  });\n\n  if (values.version) return { handled: true, output: pkg.version };\n  if (values.help) return { handled: true, output: HELP_TEXT };\n  return { handled: false };\n}\n\n/**\n * Parse Gmail server configuration from CLI arguments and environment.\n *\n * CLI Arguments (all optional):\n * - --auth=<mode>          Authentication mode (default: loopback-oauth)\n *                          Modes: loopback-oauth, service-account, dcr\n * - --headless             Disable browser auto-open, return auth URL instead\n * - --redirect-uri=<uri>   OAuth redirect URI (default: ephemeral loopback)\n * - --dcr-mode=<mode>      DCR mode (self-hosted or external, default: self-hosted)\n * - --dcr-verify-url=<url> External verification endpoint (required for external mode)\n * - --dcr-store-uri=<uri>  DCR client storage URI (required for self-hosted mode)\n * - --port=<port>          Enable HTTP transport on specified port\n * - --stdio                Enable stdio transport (default if no port)\n * - --log-level=<level>    Logging level (default: info)\n * - --storage-dir=<path>   Directory for CSV file storage (default: .mcp-z/files)\n * - --base-url=<url>       Base URL for HTTP file serving (optional)\n *\n * Environment Variables:\n * - GOOGLE_CLIENT_ID       OAuth client ID (REQUIRED)\n * - GOOGLE_CLIENT_SECRET   OAuth client secret (optional)\n * - AUTH_MODE              Default authentication mode (optional)\n * - HEADLESS               Disable browser auto-open (optional)\n * - DCR_MODE               DCR mode (optional, same format as --dcr-mode)\n * - DCR_VERIFY_URL         External verification URL (optional, same as --dcr-verify-url)\n * - DCR_STORE_URI          DCR storage URI (optional, same as --dcr-store-uri)\n * - PORT                   Default HTTP port (optional)\n * - LOG_LEVEL              Default logging level (optional)\n * - STORAGE_DIR            Default storage directory (optional)\n * - BASE_URL               Default base URL for file serving (optional)\n *\n * OAuth Scopes (from constants.ts):\n * openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://mail.google.com/\n */\nexport function parseConfig(args: string[], env: Record<string, string | undefined>): ServerConfig {\n  const transportConfig = parseTransportConfig(args, env);\n  const oauthConfig = parseOAuthConfig(args, env);\n\n  // Parse DCR configuration if DCR mode is enabled\n  const dcrConfig = oauthConfig.auth === 'dcr' ? parseDcrConfig(args, env, GOOGLE_SCOPE) : undefined;\n\n  // Parse application-level config (LOG_LEVEL, STORAGE_DIR, BASE_URL)\n  const { values } = parseArgs({\n    args,\n    options: {\n      'log-level': { type: 'string' },\n      'storage-dir': { type: 'string' },\n      'base-url': { type: 'string' },\n    },\n    strict: false, // Allow other arguments\n    allowPositionals: true,\n  });\n\n  const name = pkg.name.replace(/^@[^/]+\\//, '');\n  // Parse repository URL from package.json, stripping git+ prefix and .git suffix\n  const rawRepoUrl = typeof pkg.repository === 'object' ? pkg.repository.url : pkg.repository;\n  const repositoryUrl = rawRepoUrl?.replace(/^git\\+/, '').replace(/\\.git$/, '') ?? `https://github.com/mcp-z/${name}`;\n  const rootDir = process.cwd() === '/' ? homedir() : process.cwd();\n  const baseDir = path.join(rootDir, '.mcp-z');\n  const cliLogLevel = typeof values['log-level'] === 'string' ? values['log-level'] : undefined;\n  const envLogLevel = env.LOG_LEVEL;\n  const logLevel = cliLogLevel ?? envLogLevel ?? 'info';\n\n  // Parse storage configuration\n  const cliStorageDir = typeof values['storage-dir'] === 'string' ? values['storage-dir'] : undefined;\n  const envStorageDir = env.STORAGE_DIR;\n  let storageDir = cliStorageDir ?? envStorageDir ?? path.join(baseDir, name, 'files');\n  if (storageDir.startsWith('~')) storageDir = storageDir.replace(/^~/, homedir());\n\n  const cliBaseUrl = typeof values['base-url'] === 'string' ? values['base-url'] : undefined;\n  const envBaseUrl = env.BASE_URL;\n  const baseUrl = cliBaseUrl ?? envBaseUrl;\n\n  // Combine configs\n  const result: ServerConfig = {\n    ...oauthConfig, // Includes clientId, auth, headless, redirectUri, serviceAccountKeyFile\n    transport: transportConfig.transport,\n    logLevel,\n    baseDir,\n    name,\n    version: pkg.version,\n    repositoryUrl,\n    storageDir: path.resolve(storageDir),\n  };\n  if (baseUrl) result.baseUrl = baseUrl;\n  if (dcrConfig !== undefined) result.dcrConfig = dcrConfig;\n  return result;\n}\n\n/**\n * Build production configuration from process globals.\n * Entry point for production server.\n */\nexport function createConfig(): ServerConfig {\n  return parseConfig(process.argv, process.env);\n}\n"],"names":["parseDcrConfig","parseConfig","parseOAuthConfig","parseTransportConfig","fs","moduleRoot","homedir","path","url","parseArgs","GOOGLE_SCOPE","pkg","JSON","parse","readFileSync","join","fileURLToPath","HELP_TEXT","trim","handleVersionHelp","args","values","options","version","type","help","strict","handled","output","env","cliLogLevel","cliStorageDir","transportConfig","oauthConfig","dcrConfig","auth","undefined","allowPositionals","name","replace","rawRepoUrl","repository","repositoryUrl","rootDir","process","cwd","baseDir","envLogLevel","LOG_LEVEL","logLevel","envStorageDir","STORAGE_DIR","storageDir","startsWith","cliBaseUrl","envBaseUrl","BASE_URL","baseUrl","result","transport","resolve","createConfig","argv"],"mappings":"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"}

package/dist/esm/setup/http.d.ts

@@ -0,0 +1,8 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { RuntimeOverrides, ServerConfig } from '../types.js';
+export declare function createHTTPServer(config: ServerConfig, overrides?: RuntimeOverrides): Promise<{
+    httpServer: import("node:http").Server<typeof import("node:http").IncomingMessage, typeof import("node:http").ServerResponse>;
+    mcpServer: McpServer;
+    logger: import("@mcp-z/server").Logger;
+    close: () => Promise<void>;
+}>;

package/dist/esm/setup/http.js

@@ -0,0 +1,61 @@
+import { composeMiddleware, connectHttp, createFileServingRouter, registerPrompts, registerResources, registerTools } from '@mcp-z/server';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import cors from 'cors';
+import express from 'express';
+import { createDefaultRuntime } from './runtime.js';
+export async function createHTTPServer(config, overrides) {
+    const runtime = await createDefaultRuntime(config, overrides);
+    const modules = runtime.createDomainModules();
+    const layers = runtime.middlewareFactories.map((factory)=>factory(runtime.deps));
+    const composed = composeMiddleware(modules, layers);
+    const logger = runtime.deps.logger;
+    const port = config.transport.port;
+    if (!port) throw new Error('Port is required for HTTP transport');
+    const tools = [
+        ...composed.tools,
+        ...runtime.deps.oauthAdapters.accountTools
+    ];
+    const prompts = [
+        ...composed.prompts,
+        ...runtime.deps.oauthAdapters.accountPrompts
+    ];
+    const mcpServer = new McpServer({
+        name: config.name,
+        version: config.version
+    });
+    registerTools(mcpServer, tools);
+    registerResources(mcpServer, composed.resources);
+    registerPrompts(mcpServer, prompts);
+    const app = express();
+    app.use(cors());
+    app.use(express.json({
+        limit: '10mb'
+    }));
+    const fileRouter = createFileServingRouter({
+        storageDir: config.storageDir
+    }, {
+        contentType: 'text/csv',
+        contentDisposition: 'attachment'
+    });
+    app.use('/files', fileRouter);
+    if (runtime.deps.oauthAdapters.dcrRouter) {
+        app.use('/', runtime.deps.oauthAdapters.dcrRouter);
+        logger.info('Mounted DCR router with OAuth endpoints');
+    }
+    logger.info(`Starting ${config.name} MCP server (http)`);
+    const { close, httpServer } = await connectHttp(mcpServer, {
+        logger,
+        app,
+        port
+    });
+    logger.info('http transport ready');
+    return {
+        httpServer,
+        mcpServer,
+        logger,
+        close: async ()=>{
+            await close();
+            await runtime.close();
+        }
+    };
+}

package/dist/esm/setup/http.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-gmail/src/setup/http.ts"],"sourcesContent":["import { composeMiddleware, connectHttp, createFileServingRouter, registerPrompts, registerResources, registerTools } from '@mcp-z/server';\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport cors from 'cors';\nimport express from 'express';\nimport type { RuntimeOverrides, ServerConfig } from '../types.js';\nimport { createDefaultRuntime } from './runtime.js';\n\nexport async function createHTTPServer(config: ServerConfig, overrides?: RuntimeOverrides) {\n  const runtime = await createDefaultRuntime(config, overrides);\n  const modules = runtime.createDomainModules();\n  const layers = runtime.middlewareFactories.map((factory) => factory(runtime.deps));\n  const composed = composeMiddleware(modules, layers);\n  const logger = runtime.deps.logger;\n  const port = config.transport.port;\n  if (!port) throw new Error('Port is required for HTTP transport');\n\n  const tools = [...composed.tools, ...runtime.deps.oauthAdapters.accountTools];\n  const prompts = [...composed.prompts, ...runtime.deps.oauthAdapters.accountPrompts];\n\n  const mcpServer = new McpServer({ name: config.name, version: config.version });\n  registerTools(mcpServer, tools);\n  registerResources(mcpServer, composed.resources);\n  registerPrompts(mcpServer, prompts);\n\n  const app = express();\n  app.use(cors());\n  app.use(express.json({ limit: '10mb' }));\n\n  const fileRouter = createFileServingRouter({ storageDir: config.storageDir }, { contentType: 'text/csv', contentDisposition: 'attachment' });\n  app.use('/files', fileRouter);\n\n  if (runtime.deps.oauthAdapters.dcrRouter) {\n    app.use('/', runtime.deps.oauthAdapters.dcrRouter);\n    logger.info('Mounted DCR router with OAuth endpoints');\n  }\n\n  logger.info(`Starting ${config.name} MCP server (http)`);\n  const { close, httpServer } = await connectHttp(mcpServer, { logger, app, port });\n  logger.info('http transport ready');\n\n  return {\n    httpServer,\n    mcpServer,\n    logger,\n    close: async () => {\n      await close();\n      await runtime.close();\n    },\n  };\n}\n"],"names":["composeMiddleware","connectHttp","createFileServingRouter","registerPrompts","registerResources","registerTools","McpServer","cors","express","createDefaultRuntime","createHTTPServer","config","overrides","runtime","modules","createDomainModules","layers","middlewareFactories","map","factory","deps","composed","logger","port","transport","Error","tools","oauthAdapters","accountTools","prompts","accountPrompts","mcpServer","name","version","resources","app","use","json","limit","fileRouter","storageDir","contentType","contentDisposition","dcrRouter","info","close","httpServer"],"mappings":"AAAA,SAASA,iBAAiB,EAAEC,WAAW,EAAEC,uBAAuB,EAAEC,eAAe,EAAEC,iBAAiB,EAAEC,aAAa,QAAQ,gBAAgB;AAC3I,SAASC,SAAS,QAAQ,0CAA0C;AACpE,OAAOC,UAAU,OAAO;AACxB,OAAOC,aAAa,UAAU;AAE9B,SAASC,oBAAoB,QAAQ,eAAe;AAEpD,OAAO,eAAeC,iBAAiBC,MAAoB,EAAEC,SAA4B;IACvF,MAAMC,UAAU,MAAMJ,qBAAqBE,QAAQC;IACnD,MAAME,UAAUD,QAAQE,mBAAmB;IAC3C,MAAMC,SAASH,QAAQI,mBAAmB,CAACC,GAAG,CAAC,CAACC,UAAYA,QAAQN,QAAQO,IAAI;IAChF,MAAMC,WAAWrB,kBAAkBc,SAASE;IAC5C,MAAMM,SAAST,QAAQO,IAAI,CAACE,MAAM;IAClC,MAAMC,OAAOZ,OAAOa,SAAS,CAACD,IAAI;IAClC,IAAI,CAACA,MAAM,MAAM,IAAIE,MAAM;IAE3B,MAAMC,QAAQ;WAAIL,SAASK,KAAK;WAAKb,QAAQO,IAAI,CAACO,aAAa,CAACC,YAAY;KAAC;IAC7E,MAAMC,UAAU;WAAIR,SAASQ,OAAO;WAAKhB,QAAQO,IAAI,CAACO,aAAa,CAACG,cAAc;KAAC;IAEnF,MAAMC,YAAY,IAAIzB,UAAU;QAAE0B,MAAMrB,OAAOqB,IAAI;QAAEC,SAAStB,OAAOsB,OAAO;IAAC;IAC7E5B,cAAc0B,WAAWL;IACzBtB,kBAAkB2B,WAAWV,SAASa,SAAS;IAC/C/B,gBAAgB4B,WAAWF;IAE3B,MAAMM,MAAM3B;IACZ2B,IAAIC,GAAG,CAAC7B;IACR4B,IAAIC,GAAG,CAAC5B,QAAQ6B,IAAI,CAAC;QAAEC,OAAO;IAAO;IAErC,MAAMC,aAAarC,wBAAwB;QAAEsC,YAAY7B,OAAO6B,UAAU;IAAC,GAAG;QAAEC,aAAa;QAAYC,oBAAoB;IAAa;IAC1IP,IAAIC,GAAG,CAAC,UAAUG;IAElB,IAAI1B,QAAQO,IAAI,CAACO,aAAa,CAACgB,SAAS,EAAE;QACxCR,IAAIC,GAAG,CAAC,KAAKvB,QAAQO,IAAI,CAACO,aAAa,CAACgB,SAAS;QACjDrB,OAAOsB,IAAI,CAAC;IACd;IAEAtB,OAAOsB,IAAI,CAAC,CAAC,SAAS,EAAEjC,OAAOqB,IAAI,CAAC,kBAAkB,CAAC;IACvD,MAAM,EAAEa,KAAK,EAAEC,UAAU,EAAE,GAAG,MAAM7C,YAAY8B,WAAW;QAAET;QAAQa;QAAKZ;IAAK;IAC/ED,OAAOsB,IAAI,CAAC;IAEZ,OAAO;QACLE;QACAf;QACAT;QACAuB,OAAO;YACL,MAAMA;YACN,MAAMhC,QAAQgC,KAAK;QACrB;IACF;AACF"}

package/dist/esm/setup/index.d.ts

@@ -0,0 +1,5 @@
+export { createConfig, parseConfig } from './config.js';
+export { createHTTPServer } from './http.js';
+export { createOAuthAdapters } from './oauth-google.js';
+export * from './runtime.js';
+export { createStdioServer } from './stdio.js';

package/dist/esm/setup/index.js

@@ -0,0 +1,5 @@
+export { createConfig, parseConfig } from './config.js';
+export { createHTTPServer } from './http.js';
+export { createOAuthAdapters } from './oauth-google.js';
+export * from './runtime.js';
+export { createStdioServer } from './stdio.js';

package/dist/esm/setup/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-gmail/src/setup/index.ts"],"sourcesContent":["export { createConfig, parseConfig } from './config.js';\nexport { createHTTPServer } from './http.js';\nexport { createOAuthAdapters } from './oauth-google.js';\nexport * from './runtime.js';\nexport { createStdioServer } from './stdio.js';\n"],"names":["createConfig","parseConfig","createHTTPServer","createOAuthAdapters","createStdioServer"],"mappings":"AAAA,SAASA,YAAY,EAAEC,WAAW,QAAQ,cAAc;AACxD,SAASC,gBAAgB,QAAQ,YAAY;AAC7C,SAASC,mBAAmB,QAAQ,oBAAoB;AACxD,cAAc,eAAe;AAC7B,SAASC,iBAAiB,QAAQ,aAAa"}

package/dist/esm/setup/oauth-google.d.ts

@@ -0,0 +1,54 @@
+import { type AuthEmailProvider } from '@mcp-z/oauth';
+import type { CachedToken } from '@mcp-z/oauth-google';
+import { DcrOAuthProvider, LoopbackOAuthProvider, ServiceAccountProvider } from '@mcp-z/oauth-google';
+import type { Logger, PromptModule, ToolModule } from '@mcp-z/server';
+import type { Router } from 'express';
+import type { Keyv } from 'keyv';
+import type { ServerConfig } from '../types.js';
+/**
+ * Gmail OAuth runtime dependencies.
+ */
+export interface OAuthRuntimeDeps {
+    logger: Logger;
+    tokenStore: Keyv<CachedToken>;
+    dcrStore?: Keyv<unknown>;
+}
+/**
+ * Auth middleware helpers used to wrap MCP modules.
+ */
+export interface AuthMiddleware {
+    withToolAuth<T extends {
+        name: string;
+        config: unknown;
+        handler: unknown;
+    }>(module: T): T;
+    withResourceAuth<T extends {
+        name: string;
+        template?: unknown;
+        config?: unknown;
+        handler: unknown;
+    }>(module: T): T;
+    withPromptAuth<T extends {
+        name: string;
+        config: unknown;
+        handler: unknown;
+    }>(module: T): T;
+}
+/**
+ * Result returned by createOAuthAdapters.
+ */
+export interface OAuthAdapters {
+    primary: LoopbackOAuthProvider | ServiceAccountProvider | DcrOAuthProvider;
+    middleware: AuthMiddleware;
+    authAdapter: AuthEmailProvider;
+    accountTools: ToolModule[];
+    accountPrompts: PromptModule[];
+    dcrRouter?: Router;
+}
+/**
+ * Create Gmail OAuth adapters and helpers.
+ *
+ * @param config Gmail server configuration.
+ * @param deps Runtime dependencies (logger, token store, optional DCR store).
+ */
+export declare function createOAuthAdapters(config: ServerConfig, deps: OAuthRuntimeDeps, baseUrl?: string): Promise<OAuthAdapters>;

package/dist/esm/setup/oauth-google.js

@@ -0,0 +1,142 @@
+import { AccountServer } from '@mcp-z/oauth';
+import { createDcrRouter, DcrOAuthProvider, LoopbackOAuthProvider, ServiceAccountProvider } from '@mcp-z/oauth-google';
+import { GOOGLE_SCOPE } from '../constants.js';
+/**
+ * Create Gmail OAuth adapters and helpers.
+ *
+ * @param config Gmail server configuration.
+ * @param deps Runtime dependencies (logger, token store, optional DCR store).
+ */ export async function createOAuthAdapters(config, deps, baseUrl) {
+    const { logger, tokenStore, dcrStore } = deps;
+    const oauthStaticConfig = {
+        service: config.name,
+        clientId: config.clientId,
+        clientSecret: config.clientSecret,
+        scope: GOOGLE_SCOPE,
+        auth: config.auth,
+        headless: config.headless,
+        redirectUri: config.transport.type === 'stdio' ? undefined : config.redirectUri,
+        ...config.serviceAccountKeyFile && {
+            serviceAccountKeyFile: config.serviceAccountKeyFile
+        },
+        ...baseUrl && {
+            baseUrl
+        }
+    };
+    let primary;
+    if (oauthStaticConfig.auth === 'dcr') {
+        logger.debug('Creating DCR provider', {
+            service: oauthStaticConfig.service
+        });
+        if (!dcrStore) {
+            throw new Error('DCR mode requires dcrStore to be configured');
+        }
+        if (!oauthStaticConfig.baseUrl) {
+            throw new Error('DCR mode requires baseUrl to be configured');
+        }
+        primary = new DcrOAuthProvider({
+            clientId: oauthStaticConfig.clientId,
+            ...oauthStaticConfig.clientSecret && {
+                clientSecret: oauthStaticConfig.clientSecret
+            },
+            scope: oauthStaticConfig.scope,
+            verifyEndpoint: `${oauthStaticConfig.baseUrl}/oauth/verify`,
+            logger
+        });
+        const dcrRouter = createDcrRouter({
+            store: dcrStore,
+            issuerUrl: oauthStaticConfig.baseUrl,
+            baseUrl: oauthStaticConfig.baseUrl,
+            scopesSupported: oauthStaticConfig.scope.split(' '),
+            clientConfig: {
+                clientId: oauthStaticConfig.clientId,
+                ...oauthStaticConfig.clientSecret && {
+                    clientSecret: oauthStaticConfig.clientSecret
+                }
+            }
+        });
+        const middleware = primary.authMiddleware();
+        const authAdapter = {
+            getUserEmail: ()=>{
+                throw new Error('DCR mode does not support getUserEmail - tokens are provided via bearer auth');
+            }
+        };
+        return {
+            primary,
+            middleware: middleware,
+            authAdapter,
+            accountTools: [],
+            accountPrompts: [],
+            dcrRouter
+        };
+    }
+    if (oauthStaticConfig.auth === 'service-account') {
+        if (!oauthStaticConfig.serviceAccountKeyFile) {
+            throw new Error('Service account key file is required when auth mode is "service-account". Set GOOGLE_SERVICE_ACCOUNT_KEY_FILE environment variable or use --service-account-key-file flag.');
+        }
+        logger.debug('Creating service account provider', {
+            service: oauthStaticConfig.service
+        });
+        primary = new ServiceAccountProvider({
+            keyFilePath: oauthStaticConfig.serviceAccountKeyFile,
+            scopes: oauthStaticConfig.scope.split(' '),
+            logger
+        });
+    } else {
+        logger.debug('Creating loopback OAuth provider', {
+            service: oauthStaticConfig.service
+        });
+        primary = new LoopbackOAuthProvider({
+            service: oauthStaticConfig.service,
+            clientId: oauthStaticConfig.clientId,
+            clientSecret: oauthStaticConfig.clientSecret,
+            scope: oauthStaticConfig.scope,
+            headless: oauthStaticConfig.headless,
+            logger,
+            tokenStore,
+            ...oauthStaticConfig.redirectUri !== undefined && {
+                redirectUri: oauthStaticConfig.redirectUri
+            }
+        });
+    }
+    const authAdapter = {
+        getUserEmail: (accountId)=>primary.getUserEmail(accountId),
+        ...'authenticateNewAccount' in primary && primary.authenticateNewAccount ? {
+            authenticateNewAccount: ()=>{
+                var _primary_authenticateNewAccount;
+                return (_primary_authenticateNewAccount = primary.authenticateNewAccount) === null || _primary_authenticateNewAccount === void 0 ? void 0 : _primary_authenticateNewAccount.call(primary);
+            }
+        } : {}
+    };
+    let middleware;
+    let accountTools;
+    let accountPrompts;
+    if (oauthStaticConfig.auth === 'service-account') {
+        middleware = primary.authMiddleware();
+        accountTools = [];
+        accountPrompts = [];
+        logger.debug('Service account mode - no account tools', {
+            service: oauthStaticConfig.service
+        });
+    } else {
+        middleware = primary.authMiddleware();
+        const result = AccountServer.createLoopback({
+            service: oauthStaticConfig.service,
+            store: tokenStore,
+            logger,
+            auth: authAdapter
+        });
+        accountTools = result.tools;
+        accountPrompts = result.prompts;
+        logger.debug('Loopback OAuth (multi-account mode)', {
+            service: oauthStaticConfig.service
+        });
+    }
+    return {
+        primary,
+        middleware: middleware,
+        authAdapter,
+        accountTools,
+        accountPrompts
+    };
+}

package/dist/esm/setup/oauth-google.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-gmail/src/setup/oauth-google.ts"],"sourcesContent":["import { AccountServer, type AuthEmailProvider } from '@mcp-z/oauth';\nimport type { CachedToken } from '@mcp-z/oauth-google';\nimport { createDcrRouter, DcrOAuthProvider, LoopbackOAuthProvider, ServiceAccountProvider } from '@mcp-z/oauth-google';\nimport type { Logger, PromptModule, ToolModule } from '@mcp-z/server';\nimport type { Router } from 'express';\nimport type { Keyv } from 'keyv';\nimport { GOOGLE_SCOPE } from '../constants.ts';\nimport type { ServerConfig } from '../types.js';\n\n/**\n * Gmail OAuth runtime dependencies.\n */\nexport interface OAuthRuntimeDeps {\n  logger: Logger;\n  tokenStore: Keyv<CachedToken>;\n  dcrStore?: Keyv<unknown>;\n}\n\n/**\n * Auth middleware helpers used to wrap MCP modules.\n */\nexport interface AuthMiddleware {\n  withToolAuth<T extends { name: string; config: unknown; handler: unknown }>(module: T): T;\n  withResourceAuth<T extends { name: string; template?: unknown; config?: unknown; handler: unknown }>(module: T): T;\n  withPromptAuth<T extends { name: string; config: unknown; handler: unknown }>(module: T): T;\n}\n\n/**\n * Result returned by createOAuthAdapters.\n */\nexport interface OAuthAdapters {\n  primary: LoopbackOAuthProvider | ServiceAccountProvider | DcrOAuthProvider;\n  middleware: AuthMiddleware;\n  authAdapter: AuthEmailProvider;\n  accountTools: ToolModule[];\n  accountPrompts: PromptModule[];\n  dcrRouter?: Router;\n}\n\n/**\n * Create Gmail OAuth adapters and helpers.\n *\n * @param config Gmail server configuration.\n * @param deps Runtime dependencies (logger, token store, optional DCR store).\n */\nexport async function createOAuthAdapters(config: ServerConfig, deps: OAuthRuntimeDeps, baseUrl?: string): Promise<OAuthAdapters> {\n  const { logger, tokenStore, dcrStore } = deps;\n  const oauthStaticConfig = {\n    service: config.name,\n    clientId: config.clientId,\n    clientSecret: config.clientSecret,\n    scope: GOOGLE_SCOPE,\n    auth: config.auth,\n    headless: config.headless,\n    redirectUri: config.transport.type === 'stdio' ? undefined : config.redirectUri,\n    ...(config.serviceAccountKeyFile && { serviceAccountKeyFile: config.serviceAccountKeyFile }),\n    ...(baseUrl && { baseUrl }),\n  };\n\n  let primary: LoopbackOAuthProvider | ServiceAccountProvider | DcrOAuthProvider;\n\n  if (oauthStaticConfig.auth === 'dcr') {\n    logger.debug('Creating DCR provider', { service: oauthStaticConfig.service });\n\n    if (!dcrStore) {\n      throw new Error('DCR mode requires dcrStore to be configured');\n    }\n    if (!oauthStaticConfig.baseUrl) {\n      throw new Error('DCR mode requires baseUrl to be configured');\n    }\n\n    primary = new DcrOAuthProvider({\n      clientId: oauthStaticConfig.clientId,\n      ...(oauthStaticConfig.clientSecret && { clientSecret: oauthStaticConfig.clientSecret }),\n      scope: oauthStaticConfig.scope,\n      verifyEndpoint: `${oauthStaticConfig.baseUrl}/oauth/verify`,\n      logger,\n    });\n\n    const dcrRouter = createDcrRouter({\n      store: dcrStore,\n      issuerUrl: oauthStaticConfig.baseUrl,\n      baseUrl: oauthStaticConfig.baseUrl,\n      scopesSupported: oauthStaticConfig.scope.split(' '),\n      clientConfig: {\n        clientId: oauthStaticConfig.clientId,\n        ...(oauthStaticConfig.clientSecret && { clientSecret: oauthStaticConfig.clientSecret }),\n      },\n    });\n\n    const middleware = primary.authMiddleware();\n    const authAdapter: AuthEmailProvider = {\n      getUserEmail: () => {\n        throw new Error('DCR mode does not support getUserEmail - tokens are provided via bearer auth');\n      },\n    };\n\n    return {\n      primary,\n      middleware: middleware as unknown as AuthMiddleware,\n      authAdapter,\n      accountTools: [],\n      accountPrompts: [],\n      dcrRouter,\n    };\n  }\n\n  if (oauthStaticConfig.auth === 'service-account') {\n    if (!oauthStaticConfig.serviceAccountKeyFile) {\n      throw new Error('Service account key file is required when auth mode is \"service-account\". Set GOOGLE_SERVICE_ACCOUNT_KEY_FILE environment variable or use --service-account-key-file flag.');\n    }\n\n    logger.debug('Creating service account provider', { service: oauthStaticConfig.service });\n    primary = new ServiceAccountProvider({\n      keyFilePath: oauthStaticConfig.serviceAccountKeyFile,\n      scopes: oauthStaticConfig.scope.split(' '),\n      logger,\n    });\n  } else {\n    logger.debug('Creating loopback OAuth provider', { service: oauthStaticConfig.service });\n    primary = new LoopbackOAuthProvider({\n      service: oauthStaticConfig.service,\n      clientId: oauthStaticConfig.clientId,\n      clientSecret: oauthStaticConfig.clientSecret,\n      scope: oauthStaticConfig.scope,\n      headless: oauthStaticConfig.headless,\n      logger,\n      tokenStore,\n      ...(oauthStaticConfig.redirectUri !== undefined && { redirectUri: oauthStaticConfig.redirectUri }),\n    });\n  }\n\n  const authAdapter: AuthEmailProvider = {\n    getUserEmail: (accountId) => primary.getUserEmail(accountId),\n    ...('authenticateNewAccount' in primary && primary.authenticateNewAccount\n      ? {\n          authenticateNewAccount: () => primary.authenticateNewAccount?.(),\n        }\n      : {}),\n  };\n\n  let middleware: ReturnType<LoopbackOAuthProvider['authMiddleware']>;\n  let accountTools: ToolModule[];\n  let accountPrompts: PromptModule[];\n\n  if (oauthStaticConfig.auth === 'service-account') {\n    middleware = primary.authMiddleware();\n    accountTools = [];\n    accountPrompts = [];\n    logger.debug('Service account mode - no account tools', { service: oauthStaticConfig.service });\n  } else {\n    middleware = primary.authMiddleware();\n\n    const result = AccountServer.createLoopback({\n      service: oauthStaticConfig.service,\n      store: tokenStore,\n      logger,\n      auth: authAdapter,\n    });\n    accountTools = result.tools as ToolModule[];\n    accountPrompts = result.prompts as PromptModule[];\n    logger.debug('Loopback OAuth (multi-account mode)', { service: oauthStaticConfig.service });\n  }\n\n  return {\n    primary,\n    middleware: middleware as unknown as AuthMiddleware,\n    authAdapter,\n    accountTools,\n    accountPrompts,\n  };\n}\n"],"names":["AccountServer","createDcrRouter","DcrOAuthProvider","LoopbackOAuthProvider","ServiceAccountProvider","GOOGLE_SCOPE","createOAuthAdapters","config","deps","baseUrl","logger","tokenStore","dcrStore","oauthStaticConfig","service","name","clientId","clientSecret","scope","auth","headless","redirectUri","transport","type","undefined","serviceAccountKeyFile","primary","debug","Error","verifyEndpoint","dcrRouter","store","issuerUrl","scopesSupported","split","clientConfig","middleware","authMiddleware","authAdapter","getUserEmail","accountTools","accountPrompts","keyFilePath","scopes","accountId","authenticateNewAccount","result","createLoopback","tools","prompts"],"mappings":"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"}

package/dist/esm/setup/runtime.d.ts

@@ -0,0 +1,12 @@
+import type { CachedToken } from '@mcp-z/oauth-google';
+import type { Logger, MiddlewareLayer } from '@mcp-z/server';
+import type { CommonRuntime, RuntimeOverrides, ServerConfig, StorageContext } from '../types.js';
+import { type OAuthAdapters } from './oauth-google.js';
+export declare function createLogger(config: ServerConfig): Logger;
+export declare function createTokenStore(baseDir: string): Promise<import("keyv").Keyv<CachedToken>>;
+export declare function createDcrStore(baseDir: string, required: boolean): Promise<import("keyv").Keyv<unknown>>;
+export declare function createAuthLayer(authMiddleware: OAuthAdapters['middleware']): MiddlewareLayer;
+export declare function createLoggingLayer(logger: Logger): MiddlewareLayer;
+export declare function createStorageLayer(storageContext: StorageContext): MiddlewareLayer;
+export declare function assertStorageConfig(config: ServerConfig): void;
+export declare function createDefaultRuntime(config: ServerConfig, overrides?: RuntimeOverrides): Promise<CommonRuntime>;

package/dist/esm/setup/runtime.js

@@ -0,0 +1,115 @@
+import { sanitizeForLoggingFormatter } from '@mcp-z/oauth';
+import { createLoggingMiddleware } from '@mcp-z/server';
+import * as fs from 'fs';
+import * as path from 'path';
+import pino from 'pino';
+import createStore from '../lib/create-store.js';
+import * as mcp from '../mcp/index.js';
+import { createOAuthAdapters } from './oauth-google.js';
+export function createLogger(config) {
+    var _config_logLevel;
+    const hasStdio = config.transport.type === 'stdio';
+    const logsPath = path.join(config.baseDir, 'logs', `${config.name}.log`);
+    if (hasStdio) fs.mkdirSync(path.dirname(logsPath), {
+        recursive: true
+    });
+    return pino({
+        level: (_config_logLevel = config.logLevel) !== null && _config_logLevel !== void 0 ? _config_logLevel : 'info',
+        formatters: sanitizeForLoggingFormatter()
+    }, hasStdio ? pino.destination({
+        dest: logsPath,
+        sync: false
+    }) : pino.destination(1));
+}
+export async function createTokenStore(baseDir) {
+    const storeUri = process.env.STORE_URI || `file://${path.join(baseDir, 'tokens.json')}`;
+    return createStore(storeUri);
+}
+export async function createDcrStore(baseDir, required) {
+    if (!required) return undefined;
+    const dcrStoreUri = process.env.DCR_STORE_URI || `file://${path.join(baseDir, 'dcr.json')}`;
+    return createStore(dcrStoreUri);
+}
+export function createAuthLayer(authMiddleware) {
+    return {
+        withTool: authMiddleware.withToolAuth,
+        withResource: authMiddleware.withResourceAuth,
+        withPrompt: authMiddleware.withPromptAuth
+    };
+}
+export function createLoggingLayer(logger) {
+    const logging = createLoggingMiddleware({
+        logger
+    });
+    return {
+        withTool: logging.withToolLogging,
+        withResource: logging.withResourceLogging,
+        withPrompt: logging.withPromptLogging
+    };
+}
+export function createStorageLayer(storageContext) {
+    const wrapAtPosition = (module, extraPosition)=>{
+        const originalHandler = module.handler;
+        const wrappedHandler = async (...allArgs)=>{
+            const extra = allArgs[extraPosition];
+            extra.storageContext = storageContext;
+            return await originalHandler(...allArgs);
+        };
+        return {
+            ...module,
+            handler: wrappedHandler
+        };
+    };
+    return {
+        withTool: (module)=>wrapAtPosition(module, 1)
+    };
+}
+export function assertStorageConfig(config) {
+    if (!config.storageDir) {
+        throw new Error('gmail-messages-export-csv: Server configuration missing storageDir.');
+    }
+    if (config.transport.type === 'http' && !config.baseUrl && !config.transport.port) {
+        throw new Error('gmail-messages-export-csv: HTTP transport requires either baseUrl in server config or port in transport config. This is a server configuration error - please provide --base-url or --port.');
+    }
+}
+export async function createDefaultRuntime(config, overrides) {
+    var _config_baseUrl, _ref, _ref1;
+    if (config.auth === 'dcr' && config.transport.type !== 'http') throw new Error('DCR mode requires an HTTP transport');
+    assertStorageConfig(config);
+    const logger = createLogger(config);
+    const tokenStore = await createTokenStore(config.baseDir);
+    const baseUrl = (_config_baseUrl = config.baseUrl) !== null && _config_baseUrl !== void 0 ? _config_baseUrl : config.transport.type === 'http' && config.transport.port ? `http://localhost:${config.transport.port}` : undefined;
+    const dcrStore = await createDcrStore(config.baseDir, config.auth === 'dcr');
+    const oauthAdapters = await createOAuthAdapters(config, {
+        logger,
+        tokenStore,
+        dcrStore
+    }, baseUrl);
+    const deps = {
+        config,
+        logger,
+        tokenStore,
+        oauthAdapters,
+        baseUrl
+    };
+    const createDomainModules = (_ref = overrides === null || overrides === void 0 ? void 0 : overrides.createDomainModules) !== null && _ref !== void 0 ? _ref : ()=>({
+            tools: Object.values(mcp.toolFactories).map((factory)=>factory()),
+            resources: Object.values(mcp.resourceFactories).map((factory)=>factory()),
+            prompts: Object.values(mcp.promptFactories).map((factory)=>factory())
+        });
+    const middlewareFactories = (_ref1 = overrides === null || overrides === void 0 ? void 0 : overrides.middlewareFactories) !== null && _ref1 !== void 0 ? _ref1 : [
+        ()=>createAuthLayer(oauthAdapters.middleware),
+        ()=>createLoggingLayer(logger),
+        ()=>createStorageLayer({
+                storageDir: config.storageDir,
+                baseUrl: config.baseUrl,
+                transport: config.transport
+            })
+    ];
+    return {
+        deps,
+        middlewareFactories,
+        createDomainModules,
+        close: async ()=>{}
+    };
+}