@mcp-z/mcp-gmail 1.0.3 → 1.0.5

package/dist/cjs/mcp/tools/messages-export-csv.js

@@ -247,14 +247,14 @@ var config = {
  * - NO RETRIES (fail fast on error)
  */ function handler(_0, _1) {
     return _async_to_generator(function(param, extra) {
-        var query, maxItems, filename, contentType, excludeThreadHistory, logger, storageContext, transport, storageDir, baseUrl, reservation, storedName, fullPath, gmail, csvHeaders, writeStream, headerLine, totalRows, nextPageToken, started, _exec_metadata, remainingItems, pageSize, exec, csvRows, rowsContent, durationMs, truncated, uri, result, error, _cleanupError, message;
+        var query, maxItems, filename, contentType, excludeThreadHistory, logger, storageContext, transport, resourceStoreUri, baseUrl, reservation, storedName, fullPath, gmail, csvHeaders, writeStream, headerLine, totalRows, nextPageToken, started, _exec_metadata, remainingItems, pageSize, exec, csvRows, rowsContent, durationMs, truncated, uri, result, error, _cleanupError, message;
         return _ts_generator(this, function(_state) {
             switch(_state.label){
                 case 0:
                     query = param.query, maxItems = param.maxItems, filename = param.filename, contentType = param.contentType, excludeThreadHistory = param.excludeThreadHistory;
                     logger = extra.logger;
                     storageContext = extra.storageContext;
-                    transport = storageContext.transport, storageDir = storageContext.storageDir, baseUrl = storageContext.baseUrl;
+                    transport = storageContext.transport, resourceStoreUri = storageContext.resourceStoreUri, baseUrl = storageContext.baseUrl;
                     logger.info('gmail.messages.export-csv called', {
                         query: query,
                         maxItems: maxItems,
@@ -264,7 +264,7 @@ var config = {
                     return [
                         4,
                         (0, _server.reserveFile)(filename, {
-                            storageDir: storageDir
+                            resourceStoreUri: resourceStoreUri
                         })
                     ];
                 case 1:
@@ -445,7 +445,7 @@ var config = {
                     });
                     // Generate URI based on transport type (stdio: file://, HTTP: http://)
                     uri = (0, _server.getFileUri)(storedName, transport, _object_spread_props(_object_spread({
-                        storageDir: storageDir
+                        resourceStoreUri: resourceStoreUri
                     }, baseUrl && {
                         baseUrl: baseUrl
                     }), {

package/dist/cjs/mcp/tools/messages-export-csv.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-gmail/src/mcp/tools/messages-export-csv.ts"],"sourcesContent":["import { EmailContentTypeSchema, ExcludeThreadHistorySchema } from '@mcp-z/email';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport { getFileUri, reserveFile, type ToolModule } from '@mcp-z/server';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\n\nimport { stringify } from 'csv-stringify/sync';\nimport { createWriteStream } from 'fs';\nimport { unlink } from 'fs/promises';\nimport { type gmail_v1, google } from 'googleapis';\nimport { z } from 'zod';\nimport { DEFAULT_PAGE_SIZE } from '../../constants.ts';\nimport { extractBodyFromPayload } from '../../email/parsing/html-processing.ts';\nimport { executeQuery as executeGmailQuery } from '../../email/querying/execute-query.ts';\nimport { GmailQuerySchema } from '../../schemas/gmail-query-schema.ts';\nimport type { StorageExtra } from '../../types.ts';\n\nconst DEFAULT_MAX_ITEMS = 10000;\nconst MAX_EXPORT_ITEMS = 50000;\n\n/**\n * CSV row format based on EmailDetail\n * All fields are strings (empty string instead of undefined)\n * Includes additional CSV-specific fields: provider and labels\n */\ninterface CsvRow {\n  id: string;\n  threadId: string;\n  from: string;\n  to: string;\n  cc: string;\n  bcc: string;\n  subject: string;\n  date: string;\n  snippet: string;\n  body: string;\n  provider: string;\n  labels: string;\n}\n\nconst inputSchema = z.object({\n  query: GmailQuerySchema.optional().describe('Structured query object for filtering messages. Use query-syntax prompt for reference.'),\n  maxItems: z.number().int().positive().max(MAX_EXPORT_ITEMS).default(DEFAULT_MAX_ITEMS).describe(`Maximum messages to export (default: ${DEFAULT_MAX_ITEMS}, max: ${MAX_EXPORT_ITEMS})`),\n  filename: z.string().trim().min(1).default('gmail-messages.csv').describe('Output filename (default: gmail-messages.csv)'),\n  contentType: EmailContentTypeSchema,\n  excludeThreadHistory: ExcludeThreadHistorySchema,\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  uri: z.string().describe('File URI (file:// or http://)'),\n  filename: z.string().describe('Stored filename'),\n  rowCount: z.number().describe('Number of messages exported'),\n  truncated: z.boolean().describe('Whether export was truncated at maxItems'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Export Gmail messages to CSV with streaming pagination. Returns file URI. Use query-syntax prompt for query reference.',\n  inputSchema: inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\n/**\n * Handler for gmail-messages-export-csv tool\n *\n * CRITICAL: Streaming implementation per user requirements\n * - Generate UUID upfront\n * - Write CSV header immediately\n * - Append rows as batches arrive\n * - Delete partial file on error\n * - NO RETRIES (fail fast on error)\n */\nasync function handler({ query, maxItems, filename, contentType, excludeThreadHistory }: Input, extra: EnrichedExtra & StorageExtra) {\n  const logger = extra.logger;\n  const { storageContext } = extra;\n  const { transport, storageDir, baseUrl } = storageContext;\n\n  logger.info('gmail.messages.export-csv called', {\n    query,\n    maxItems,\n    filename,\n    accountId: extra.authContext.accountId,\n  });\n\n  // Reserve file location for streaming write (creates directory, generates ID, formats filename)\n  const reservation = await reserveFile(filename, {\n    storageDir,\n  });\n  const { storedName, fullPath } = reservation;\n\n  logger.info('gmail.messages.export-csv starting streaming export', { path: fullPath, maxItems });\n\n  try {\n    const gmail = google.gmail({ version: 'v1', auth: extra.authContext.auth });\n\n    // Create CSV headers (all email fields)\n    const csvHeaders = ['id', 'threadId', 'from', 'to', 'cc', 'bcc', 'subject', 'date', 'snippet', 'body', 'provider', 'labels'];\n\n    // Create write stream and write headers immediately\n    const writeStream = createWriteStream(fullPath, { encoding: 'utf-8' });\n    const headerLine = stringify([csvHeaders], { header: false, quoted: true, quote: '\"', escape: '\"' });\n    writeStream.write(headerLine);\n\n    // Internal pagination loop - append to CSV with each batch\n    // NO RETRIES: If any error occurs, fail the whole operation and clean up\n    let totalRows = 0;\n    let nextPageToken: string | undefined;\n    const started = Date.now();\n\n    while (totalRows < maxItems) {\n      const remainingItems = maxItems - totalRows;\n      const pageSize = Math.min(remainingItems, DEFAULT_PAGE_SIZE);\n\n      const exec: {\n        items: CsvRow[];\n        metadata?: { nextPageToken?: string };\n      } = await executeGmailQuery(\n        query,\n        {\n          client: gmail,\n          logger,\n          pageSize,\n          ...(nextPageToken !== undefined && { pageToken: nextPageToken }),\n          includeBody: true, // Always include body for CSV export\n        },\n        (full: unknown): CsvRow => {\n          // Type-safe property access with guards\n          const fullData = full as {\n            id?: unknown;\n            threadId?: unknown;\n            snippet?: unknown;\n            labelIds?: unknown[];\n            payload?: { headers?: unknown[] };\n          };\n\n          const headersArray = Array.isArray(fullData?.payload?.headers) ? fullData.payload.headers : [];\n          const headers = Object.fromEntries(\n            headersArray.map((h: unknown) => {\n              const header = h as { name?: unknown; value?: unknown };\n              return [String(header.name ?? ''), String(header.value ?? '')];\n            })\n          );\n\n          const payload = fullData?.payload;\n          // Cast to Schema$MessagePart for extractBodyFromPayload\n          const body = payload ? extractBodyFromPayload(payload as gmail_v1.Schema$MessagePart, { contentType, excludeThreadHistory }) : '';\n\n          const labelIds = Array.isArray(fullData?.labelIds) ? fullData.labelIds.map((id) => String(id ?? '')) : [];\n\n          return {\n            id: String(fullData?.id ?? ''),\n            threadId: fullData?.threadId ? String(fullData.threadId) : '',\n            from: headers?.From || '',\n            to: headers?.To || '',\n            cc: headers?.Cc || '',\n            bcc: headers?.Bcc || '',\n            subject: headers?.Subject || '',\n            date: headers?.Date || '',\n            snippet: fullData?.snippet ? String(fullData.snippet) : '',\n            body,\n            provider: 'gmail',\n            labels: labelIds.join(';'),\n          };\n        }\n      );\n\n      // Type-safe CSV row mapping\n      const csvRows = exec.items.map((row) => {\n        return [row.id, row.threadId, row.from, row.to, row.cc, row.bcc, row.subject, row.date, row.snippet, row.body, row.provider, row.labels];\n      });\n\n      // Append rows to CSV file immediately\n      if (csvRows.length > 0) {\n        const rowsContent = stringify(csvRows, { header: false, quoted: true, quote: '\"', escape: '\"' });\n        writeStream.write(rowsContent);\n      }\n\n      totalRows += exec.items.length;\n      nextPageToken = exec.metadata?.nextPageToken;\n\n      logger.info('gmail.messages.export-csv batch written', {\n        batchSize: exec.items.length,\n        totalRows,\n        hasMore: Boolean(nextPageToken),\n      });\n\n      // Exit if no more results or reached maxItems\n      if (!nextPageToken || exec.items.length === 0) {\n        break;\n      }\n    }\n\n    // Close write stream\n    await new Promise<void>((resolve, reject) => {\n      writeStream.end(() => resolve());\n      writeStream.on('error', reject);\n    });\n\n    const durationMs = Date.now() - started;\n    const truncated = totalRows >= maxItems && Boolean(nextPageToken);\n\n    logger.info('gmail.messages.export-csv completed', {\n      rowCount: totalRows,\n      truncated,\n      durationMs,\n      filename: storedName,\n    });\n\n    // Generate URI based on transport type (stdio: file://, HTTP: http://)\n    const uri = getFileUri(storedName, transport, {\n      storageDir,\n      ...(baseUrl && { baseUrl }),\n      endpoint: '/files',\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      uri,\n      filename: storedName,\n      rowCount: totalRows,\n      truncated,\n    };\n\n    return {\n      content: [\n        {\n          type: 'text' as const,\n          text: JSON.stringify(result),\n        },\n      ],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    // CRITICAL: Clean up partial CSV file on error\n    try {\n      await unlink(fullPath);\n      logger.debug('Cleaned up partial CSV file after error', { path: fullPath });\n    } catch (_cleanupError) {\n      logger.debug('Could not clean up CSV file (may not exist)', { path: fullPath });\n    }\n\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('gmail.messages.export-csv error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error exporting messages to CSV: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'messages-export-csv',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","DEFAULT_MAX_ITEMS","MAX_EXPORT_ITEMS","inputSchema","z","object","query","GmailQuerySchema","optional","describe","maxItems","number","int","positive","max","default","filename","string","trim","min","contentType","EmailContentTypeSchema","excludeThreadHistory","ExcludeThreadHistorySchema","successBranchSchema","type","literal","uri","rowCount","truncated","boolean","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","storageContext","transport","storageDir","baseUrl","reservation","storedName","fullPath","gmail","csvHeaders","writeStream","headerLine","totalRows","nextPageToken","started","exec","remainingItems","pageSize","csvRows","rowsContent","durationMs","error","_cleanupError","message","info","accountId","authContext","reserveFile","path","google","version","auth","createWriteStream","encoding","stringify","header","quoted","quote","escape","write","Date","now","Math","DEFAULT_PAGE_SIZE","executeGmailQuery","client","undefined","pageToken","includeBody","full","fullData","headersArray","Array","isArray","payload","headers","Object","fromEntries","map","h","String","name","value","body","extractBodyFromPayload","labelIds","id","threadId","from","From","to","To","cc","Cc","bcc","Bcc","subject","Subject","date","snippet","provider","labels","join","items","row","length","metadata","batchSize","hasMore","Boolean","Promise","resolve","reject","end","on","getFileUri","endpoint","content","text","JSON","structuredContent","unlink","debug","Error","McpError","ErrorCode","InternalError","stack"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-gmail/src/mcp/tools/messages-export-csv.ts"],"sourcesContent":["import { EmailContentTypeSchema, ExcludeThreadHistorySchema } from '@mcp-z/email';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport { getFileUri, reserveFile, type ToolModule } from '@mcp-z/server';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\n\nimport { stringify } from 'csv-stringify/sync';\nimport { createWriteStream } from 'fs';\nimport { unlink } from 'fs/promises';\nimport { type gmail_v1, google } from 'googleapis';\nimport { z } from 'zod';\nimport { DEFAULT_PAGE_SIZE } from '../../constants.ts';\nimport { extractBodyFromPayload } from '../../email/parsing/html-processing.ts';\nimport { executeQuery as executeGmailQuery } from '../../email/querying/execute-query.ts';\nimport { GmailQuerySchema } from '../../schemas/gmail-query-schema.ts';\nimport type { StorageExtra } from '../../types.ts';\n\nconst DEFAULT_MAX_ITEMS = 10000;\nconst MAX_EXPORT_ITEMS = 50000;\n\n/**\n * CSV row format based on EmailDetail\n * All fields are strings (empty string instead of undefined)\n * Includes additional CSV-specific fields: provider and labels\n */\ninterface CsvRow {\n  id: string;\n  threadId: string;\n  from: string;\n  to: string;\n  cc: string;\n  bcc: string;\n  subject: string;\n  date: string;\n  snippet: string;\n  body: string;\n  provider: string;\n  labels: string;\n}\n\nconst inputSchema = z.object({\n  query: GmailQuerySchema.optional().describe('Structured query object for filtering messages. Use query-syntax prompt for reference.'),\n  maxItems: z.number().int().positive().max(MAX_EXPORT_ITEMS).default(DEFAULT_MAX_ITEMS).describe(`Maximum messages to export (default: ${DEFAULT_MAX_ITEMS}, max: ${MAX_EXPORT_ITEMS})`),\n  filename: z.string().trim().min(1).default('gmail-messages.csv').describe('Output filename (default: gmail-messages.csv)'),\n  contentType: EmailContentTypeSchema,\n  excludeThreadHistory: ExcludeThreadHistorySchema,\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  uri: z.string().describe('File URI (file:// or http://)'),\n  filename: z.string().describe('Stored filename'),\n  rowCount: z.number().describe('Number of messages exported'),\n  truncated: z.boolean().describe('Whether export was truncated at maxItems'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Export Gmail messages to CSV with streaming pagination. Returns file URI. Use query-syntax prompt for query reference.',\n  inputSchema: inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\n/**\n * Handler for gmail-messages-export-csv tool\n *\n * CRITICAL: Streaming implementation per user requirements\n * - Generate UUID upfront\n * - Write CSV header immediately\n * - Append rows as batches arrive\n * - Delete partial file on error\n * - NO RETRIES (fail fast on error)\n */\nasync function handler({ query, maxItems, filename, contentType, excludeThreadHistory }: Input, extra: EnrichedExtra & StorageExtra) {\n  const logger = extra.logger;\n  const { storageContext } = extra;\n  const { transport, resourceStoreUri, baseUrl } = storageContext;\n\n  logger.info('gmail.messages.export-csv called', {\n    query,\n    maxItems,\n    filename,\n    accountId: extra.authContext.accountId,\n  });\n\n  // Reserve file location for streaming write (creates directory, generates ID, formats filename)\n  const reservation = await reserveFile(filename, {\n    resourceStoreUri,\n  });\n  const { storedName, fullPath } = reservation;\n\n  logger.info('gmail.messages.export-csv starting streaming export', { path: fullPath, maxItems });\n\n  try {\n    const gmail = google.gmail({ version: 'v1', auth: extra.authContext.auth });\n\n    // Create CSV headers (all email fields)\n    const csvHeaders = ['id', 'threadId', 'from', 'to', 'cc', 'bcc', 'subject', 'date', 'snippet', 'body', 'provider', 'labels'];\n\n    // Create write stream and write headers immediately\n    const writeStream = createWriteStream(fullPath, { encoding: 'utf-8' });\n    const headerLine = stringify([csvHeaders], { header: false, quoted: true, quote: '\"', escape: '\"' });\n    writeStream.write(headerLine);\n\n    // Internal pagination loop - append to CSV with each batch\n    // NO RETRIES: If any error occurs, fail the whole operation and clean up\n    let totalRows = 0;\n    let nextPageToken: string | undefined;\n    const started = Date.now();\n\n    while (totalRows < maxItems) {\n      const remainingItems = maxItems - totalRows;\n      const pageSize = Math.min(remainingItems, DEFAULT_PAGE_SIZE);\n\n      const exec: {\n        items: CsvRow[];\n        metadata?: { nextPageToken?: string };\n      } = await executeGmailQuery(\n        query,\n        {\n          client: gmail,\n          logger,\n          pageSize,\n          ...(nextPageToken !== undefined && { pageToken: nextPageToken }),\n          includeBody: true, // Always include body for CSV export\n        },\n        (full: unknown): CsvRow => {\n          // Type-safe property access with guards\n          const fullData = full as {\n            id?: unknown;\n            threadId?: unknown;\n            snippet?: unknown;\n            labelIds?: unknown[];\n            payload?: { headers?: unknown[] };\n          };\n\n          const headersArray = Array.isArray(fullData?.payload?.headers) ? fullData.payload.headers : [];\n          const headers = Object.fromEntries(\n            headersArray.map((h: unknown) => {\n              const header = h as { name?: unknown; value?: unknown };\n              return [String(header.name ?? ''), String(header.value ?? '')];\n            })\n          );\n\n          const payload = fullData?.payload;\n          // Cast to Schema$MessagePart for extractBodyFromPayload\n          const body = payload ? extractBodyFromPayload(payload as gmail_v1.Schema$MessagePart, { contentType, excludeThreadHistory }) : '';\n\n          const labelIds = Array.isArray(fullData?.labelIds) ? fullData.labelIds.map((id) => String(id ?? '')) : [];\n\n          return {\n            id: String(fullData?.id ?? ''),\n            threadId: fullData?.threadId ? String(fullData.threadId) : '',\n            from: headers?.From || '',\n            to: headers?.To || '',\n            cc: headers?.Cc || '',\n            bcc: headers?.Bcc || '',\n            subject: headers?.Subject || '',\n            date: headers?.Date || '',\n            snippet: fullData?.snippet ? String(fullData.snippet) : '',\n            body,\n            provider: 'gmail',\n            labels: labelIds.join(';'),\n          };\n        }\n      );\n\n      // Type-safe CSV row mapping\n      const csvRows = exec.items.map((row) => {\n        return [row.id, row.threadId, row.from, row.to, row.cc, row.bcc, row.subject, row.date, row.snippet, row.body, row.provider, row.labels];\n      });\n\n      // Append rows to CSV file immediately\n      if (csvRows.length > 0) {\n        const rowsContent = stringify(csvRows, { header: false, quoted: true, quote: '\"', escape: '\"' });\n        writeStream.write(rowsContent);\n      }\n\n      totalRows += exec.items.length;\n      nextPageToken = exec.metadata?.nextPageToken;\n\n      logger.info('gmail.messages.export-csv batch written', {\n        batchSize: exec.items.length,\n        totalRows,\n        hasMore: Boolean(nextPageToken),\n      });\n\n      // Exit if no more results or reached maxItems\n      if (!nextPageToken || exec.items.length === 0) {\n        break;\n      }\n    }\n\n    // Close write stream\n    await new Promise<void>((resolve, reject) => {\n      writeStream.end(() => resolve());\n      writeStream.on('error', reject);\n    });\n\n    const durationMs = Date.now() - started;\n    const truncated = totalRows >= maxItems && Boolean(nextPageToken);\n\n    logger.info('gmail.messages.export-csv completed', {\n      rowCount: totalRows,\n      truncated,\n      durationMs,\n      filename: storedName,\n    });\n\n    // Generate URI based on transport type (stdio: file://, HTTP: http://)\n    const uri = getFileUri(storedName, transport, {\n      resourceStoreUri,\n      ...(baseUrl && { baseUrl }),\n      endpoint: '/files',\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      uri,\n      filename: storedName,\n      rowCount: totalRows,\n      truncated,\n    };\n\n    return {\n      content: [\n        {\n          type: 'text' as const,\n          text: JSON.stringify(result),\n        },\n      ],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    // CRITICAL: Clean up partial CSV file on error\n    try {\n      await unlink(fullPath);\n      logger.debug('Cleaned up partial CSV file after error', { path: fullPath });\n    } catch (_cleanupError) {\n      logger.debug('Could not clean up CSV file (may not exist)', { path: fullPath });\n    }\n\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('gmail.messages.export-csv error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error exporting messages to CSV: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'messages-export-csv',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","DEFAULT_MAX_ITEMS","MAX_EXPORT_ITEMS","inputSchema","z","object","query","GmailQuerySchema","optional","describe","maxItems","number","int","positive","max","default","filename","string","trim","min","contentType","EmailContentTypeSchema","excludeThreadHistory","ExcludeThreadHistorySchema","successBranchSchema","type","literal","uri","rowCount","truncated","boolean","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","storageContext","transport","resourceStoreUri","baseUrl","reservation","storedName","fullPath","gmail","csvHeaders","writeStream","headerLine","totalRows","nextPageToken","started","exec","remainingItems","pageSize","csvRows","rowsContent","durationMs","error","_cleanupError","message","info","accountId","authContext","reserveFile","path","google","version","auth","createWriteStream","encoding","stringify","header","quoted","quote","escape","write","Date","now","Math","DEFAULT_PAGE_SIZE","executeGmailQuery","client","undefined","pageToken","includeBody","full","fullData","headersArray","Array","isArray","payload","headers","Object","fromEntries","map","h","String","name","value","body","extractBodyFromPayload","labelIds","id","threadId","from","From","to","To","cc","Cc","bcc","Bcc","subject","Subject","date","snippet","provider","labels","join","items","row","length","metadata","batchSize","hasMore","Boolean","Promise","resolve","reject","end","on","getFileUri","endpoint","content","text","JSON","structuredContent","unlink","debug","Error","McpError","ErrorCode","InternalError","stack"],"mappings":"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"}

package/dist/cjs/setup/config.d.cts

@@ -21,7 +21,7 @@ export declare function handleVersionHelp(args: string[]): {
  * - --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)
+ * - --resource-store-uri=<uri>    Resource store URI for CSV file storage (default: file://~/.mcp-z/mcp-gmail/files)
  * - --base-url=<url>       Base URL for HTTP file serving (optional)
  *
  * Environment Variables:
@@ -32,9 +32,10 @@ export declare function handleVersionHelp(args: string[]): {
  * - 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)
+ * - TOKEN_STORE_URI        Token storage URI (optional)
  * - PORT                   Default HTTP port (optional)
  * - LOG_LEVEL              Default logging level (optional)
- * - STORAGE_DIR            Default storage directory (optional)
+ * - RESOURCE_STORE_URI            Resource store URI (optional, file://)
  * - BASE_URL               Default base URL for file serving (optional)
  *
  * OAuth Scopes (from constants.ts):

package/dist/cjs/setup/config.d.ts

@@ -21,7 +21,7 @@ export declare function handleVersionHelp(args: string[]): {
  * - --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)
+ * - --resource-store-uri=<uri>    Resource store URI for CSV file storage (default: file://~/.mcp-z/mcp-gmail/files)
  * - --base-url=<url>       Base URL for HTTP file serving (optional)
  *
  * Environment Variables:
@@ -32,9 +32,10 @@ export declare function handleVersionHelp(args: string[]): {
  * - 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)
+ * - TOKEN_STORE_URI        Token storage URI (optional)
  * - PORT                   Default HTTP port (optional)
  * - LOG_LEVEL              Default logging level (optional)
- * - STORAGE_DIR            Default storage directory (optional)
+ * - RESOURCE_STORE_URI            Resource store URI (optional, file://)
  * - BASE_URL               Default base URL for file serving (optional)
  *
  * OAuth Scopes (from constants.ts):

package/dist/cjs/setup/config.js

@@ -131,7 +131,7 @@ function _type_of(obj) {
     return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
 }
 var pkg = JSON.parse(_fs.readFileSync(_path.join((0, _modulerootsync.default)(_url.fileURLToPath(require("url").pathToFileURL(__filename).toString())), 'package.json'), 'utf-8'));
-var 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();
+var 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  --resource-store-uri=<uri>    Resource store URI for CSV file storage (default: file://~/.mcp-z/mcp-gmail/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  TOKEN_STORE_URI        Token storage URI (optional)\n  PORT                   Default HTTP port (optional)\n  LOG_LEVEL              Default logging level (optional)\n  RESOURCE_STORE_URI            Resource store URI (optional, file://)\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 --resource-store-uri=file:///tmp/emails    # Custom resource store URI\n  GOOGLE_CLIENT_ID=xxx mcp-gmail      # Set client ID via env var\n".trim();
 function handleVersionHelp(args) {
     var values = (0, _util.parseArgs)({
         args: args,
@@ -163,7 +163,7 @@ function parseConfig(args, env) {
     var oauthConfig = (0, _oauthgoogle.parseConfig)(args, env);
     // Parse DCR configuration if DCR mode is enabled
     var dcrConfig = oauthConfig.auth === 'dcr' ? (0, _oauthgoogle.parseDcrConfig)(args, env, _constantsts.GOOGLE_SCOPE) : undefined;
-    // Parse application-level config (LOG_LEVEL, STORAGE_DIR, BASE_URL)
+    // Parse application-level config (LOG_LEVEL, RESOURCE_STORE_URI, BASE_URL)
     var values = (0, _util.parseArgs)({
         args: args,
         options: {
@@ -173,7 +173,7 @@ function parseConfig(args, env) {
             'base-url': {
                 type: 'string'
             },
-            'storage-dir': {
+            'resource-store-uri': {
                 type: 'string'
             }
         },
@@ -200,10 +200,10 @@ function parseConfig(args, env) {
     var envLogLevel = env.LOG_LEVEL;
     var logLevel = (_ref1 = cliLogLevel !== null && cliLogLevel !== void 0 ? cliLogLevel : envLogLevel) !== null && _ref1 !== void 0 ? _ref1 : 'info';
     // Parse storage configuration
-    var cliStorageDir = typeof values['storage-dir'] === 'string' ? values['storage-dir'] : undefined;
-    var envStorageDir = env.STORAGE_DIR;
-    var 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(/^~/, (0, _os.homedir)());
+    var cliResourceStoreUri = typeof values['resource-store-uri'] === 'string' ? values['resource-store-uri'] : undefined;
+    var envResourceStoreUri = env.RESOURCE_STORE_URI;
+    var defaultResourceStorePath = _path.join(baseDir, name, 'files');
+    var resourceStoreUri = normalizeResourceStoreUri((_ref2 = cliResourceStoreUri !== null && cliResourceStoreUri !== void 0 ? cliResourceStoreUri : envResourceStoreUri) !== null && _ref2 !== void 0 ? _ref2 : defaultResourceStorePath);
     var cliBaseUrl = typeof values['base-url'] === 'string' ? values['base-url'] : undefined;
     var envBaseUrl = env.BASE_URL;
     var baseUrl = cliBaseUrl !== null && cliBaseUrl !== void 0 ? cliBaseUrl : envBaseUrl;
@@ -215,7 +215,7 @@ function parseConfig(args, env) {
         name: name,
         version: pkg.version,
         repositoryUrl: repositoryUrl,
-        storageDir: _path.resolve(storageDir)
+        resourceStoreUri: resourceStoreUri
     });
     if (baseUrl) result.baseUrl = baseUrl;
     if (dcrConfig !== undefined) result.dcrConfig = dcrConfig;
@@ -224,4 +224,15 @@ function parseConfig(args, env) {
 function createConfig() {
     return parseConfig(process.argv, process.env);
 }
+function normalizeResourceStoreUri(resourceStoreUri) {
+    var filePrefix = 'file://';
+    if (resourceStoreUri.startsWith(filePrefix)) {
+        var rawPath = resourceStoreUri.slice(filePrefix.length);
+        var expandedPath = rawPath.startsWith('~') ? rawPath.replace(/^~/, (0, _os.homedir)()) : rawPath;
+        return "".concat(filePrefix).concat(_path.resolve(expandedPath));
+    }
+    if (resourceStoreUri.includes('://')) return resourceStoreUri;
+    var expandedPath1 = resourceStoreUri.startsWith('~') ? resourceStoreUri.replace(/^~/, (0, _os.homedir)()) : resourceStoreUri;
+    return "".concat(filePrefix).concat(_path.resolve(expandedPath1));
+}
 /* CJS INTEROP */ if (exports.__esModule && exports.default) { try { Object.defineProperty(exports.default, '__esModule', { value: true }); for (var key in exports) { exports.default[key] = exports[key]; } } catch (_) {}; module.exports = exports.default; }

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-gmail/src/setup/config.ts"],"sourcesContent":["import { parseDcrConfig, parseConfig as parseOAuthConfig } from '@mcp-z/oauth-google';\nimport { findConfigPath, 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.ts';\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      'base-url': { type: 'string' },\n      'storage-dir': { 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  let rootDir = homedir();\n  try {\n    const configPath = findConfigPath({ config: '.mcp.json', cwd: process.cwd(), stopDir: homedir() });\n    rootDir = path.dirname(configPath);\n  } catch {\n    rootDir = homedir();\n  }\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":["createConfig","handleVersionHelp","parseConfig","pkg","JSON","parse","fs","readFileSync","path","join","moduleRoot","url","fileURLToPath","HELP_TEXT","trim","args","values","parseArgs","options","version","type","help","strict","handled","output","env","cliLogLevel","cliStorageDir","transportConfig","parseTransportConfig","oauthConfig","parseOAuthConfig","dcrConfig","auth","parseDcrConfig","GOOGLE_SCOPE","undefined","allowPositionals","name","replace","rawRepoUrl","repository","repositoryUrl","rootDir","homedir","configPath","findConfigPath","config","cwd","process","stopDir","dirname","baseDir","envLogLevel","LOG_LEVEL","logLevel","envStorageDir","STORAGE_DIR","storageDir","startsWith","cliBaseUrl","envBaseUrl","BASE_URL","baseUrl","result","transport","resolve","argv"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-gmail/src/setup/config.ts"],"sourcesContent":["import { parseDcrConfig, parseConfig as parseOAuthConfig } from '@mcp-z/oauth-google';\nimport { findConfigPath, 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.ts';\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  --resource-store-uri=<uri>    Resource store URI for CSV file storage (default: file://~/.mcp-z/mcp-gmail/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  TOKEN_STORE_URI        Token storage URI (optional)\n  PORT                   Default HTTP port (optional)\n  LOG_LEVEL              Default logging level (optional)\n  RESOURCE_STORE_URI            Resource store URI (optional, file://)\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 --resource-store-uri=file:///tmp/emails    # Custom resource store URI\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 * - --resource-store-uri=<uri>    Resource store URI for CSV file storage (default: file://~/.mcp-z/mcp-gmail/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 * - TOKEN_STORE_URI        Token storage URI (optional)\n * - PORT                   Default HTTP port (optional)\n * - LOG_LEVEL              Default logging level (optional)\n * - RESOURCE_STORE_URI            Resource store URI (optional, file://)\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, RESOURCE_STORE_URI, BASE_URL)\n  const { values } = parseArgs({\n    args,\n    options: {\n      'log-level': { type: 'string' },\n      'base-url': { type: 'string' },\n      'resource-store-uri': { 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  let rootDir = homedir();\n  try {\n    const configPath = findConfigPath({ config: '.mcp.json', cwd: process.cwd(), stopDir: homedir() });\n    rootDir = path.dirname(configPath);\n  } catch {\n    rootDir = homedir();\n  }\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 cliResourceStoreUri = typeof values['resource-store-uri'] === 'string' ? values['resource-store-uri'] : undefined;\n  const envResourceStoreUri = env.RESOURCE_STORE_URI;\n  const defaultResourceStorePath = path.join(baseDir, name, 'files');\n  const resourceStoreUri = normalizeResourceStoreUri(cliResourceStoreUri ?? envResourceStoreUri ?? defaultResourceStorePath);\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    resourceStoreUri,\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\nfunction normalizeResourceStoreUri(resourceStoreUri: string): string {\n  const filePrefix = 'file://';\n  if (resourceStoreUri.startsWith(filePrefix)) {\n    const rawPath = resourceStoreUri.slice(filePrefix.length);\n    const expandedPath = rawPath.startsWith('~') ? rawPath.replace(/^~/, homedir()) : rawPath;\n    return `${filePrefix}${path.resolve(expandedPath)}`;\n  }\n\n  if (resourceStoreUri.includes('://')) return resourceStoreUri;\n\n  const expandedPath = resourceStoreUri.startsWith('~') ? resourceStoreUri.replace(/^~/, homedir()) : resourceStoreUri;\n  return `${filePrefix}${path.resolve(expandedPath)}`;\n}\n"],"names":["createConfig","handleVersionHelp","parseConfig","pkg","JSON","parse","fs","readFileSync","path","join","moduleRoot","url","fileURLToPath","HELP_TEXT","trim","args","values","parseArgs","options","version","type","help","strict","handled","output","env","cliLogLevel","cliResourceStoreUri","transportConfig","parseTransportConfig","oauthConfig","parseOAuthConfig","dcrConfig","auth","parseDcrConfig","GOOGLE_SCOPE","undefined","allowPositionals","name","replace","rawRepoUrl","repository","repositoryUrl","rootDir","homedir","configPath","findConfigPath","config","cwd","process","stopDir","dirname","baseDir","envLogLevel","LOG_LEVEL","logLevel","envResourceStoreUri","RESOURCE_STORE_URI","defaultResourceStorePath","resourceStoreUri","normalizeResourceStoreUri","cliBaseUrl","envBaseUrl","BASE_URL","baseUrl","result","transport","argv","filePrefix","startsWith","rawPath","slice","length","expandedPath","resolve","includes"],"mappings":"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"}

package/dist/cjs/setup/http.js

@@ -210,7 +210,7 @@ function createHTTPServer(config, overrides) {
                         logger.info('Mounted loopback OAuth callback router');
                     }
                     fileRouter = (0, _server.createFileServingRouter)({
-                        storageDir: config.storageDir
+                        resourceStoreUri: config.resourceStoreUri
                     }, {
                         contentType: 'text/csv',
                         contentDisposition: 'attachment'

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/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.ts';\nimport { createDefaultRuntime } from './runtime.ts';\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  if (runtime.deps.oauthAdapters.loopbackRouter) {\n    app.use('/', runtime.deps.oauthAdapters.loopbackRouter);\n    logger.info('Mounted loopback OAuth callback router');\n  }\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":["createHTTPServer","config","overrides","runtime","modules","layers","composed","logger","port","tools","prompts","mcpServer","app","fileRouter","close","httpServer","createDefaultRuntime","createDomainModules","middlewareFactories","map","factory","deps","composeMiddleware","transport","Error","oauthAdapters","accountTools","accountPrompts","McpServer","name","version","registerTools","registerResources","resources","registerPrompts","express","use","cors","json","limit","loopbackRouter","info","createFileServingRouter","storageDir","contentType","contentDisposition","dcrRouter","connectHttp"],"mappings":";;;;+BAOsBA;;;eAAAA;;;sBAPqG;mBACjG;2DACT;8DACG;yBAEiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAE9B,SAAeA,iBAAiBC,MAAoB,EAAEC,SAA4B;;YACjFC,SACAC,SACAC,QACAC,UACAC,QACAC,MAGAC,OACAC,SAEAC,WAKAC,KASAC,YASwB,MAAtBC,OAAOC;;;;oBAlCC;;wBAAMC,IAAAA,+BAAoB,EAACf,QAAQC;;;oBAA7CC,UAAU;oBACVC,UAAUD,QAAQc,mBAAmB;oBACrCZ,SAASF,QAAQe,mBAAmB,CAACC,GAAG,CAAC,SAACC;+BAAYA,QAAQjB,QAAQkB,IAAI;;oBAC1Ef,WAAWgB,IAAAA,yBAAiB,EAAClB,SAASC;oBACtCE,SAASJ,QAAQkB,IAAI,CAACd,MAAM;oBAC5BC,OAAOP,OAAOsB,SAAS,CAACf,IAAI;oBAClC,IAAI,CAACA,MAAM,MAAM,IAAIgB,MAAM;oBAErBf,QAAQ,AAAC,qBAAGH,SAASG,KAAK,SAAE,qBAAGN,QAAQkB,IAAI,CAACI,aAAa,CAACC,YAAY;oBACtEhB,UAAU,AAAC,qBAAGJ,SAASI,OAAO,SAAE,qBAAGP,QAAQkB,IAAI,CAACI,aAAa,CAACE,cAAc;oBAE5EhB,YAAY,IAAIiB,cAAS,CAAC;wBAAEC,MAAM5B,OAAO4B,IAAI;wBAAEC,SAAS7B,OAAO6B,OAAO;oBAAC;oBAC7EC,IAAAA,qBAAa,EAACpB,WAAWF;oBACzBuB,IAAAA,yBAAiB,EAACrB,WAAWL,SAAS2B,SAAS;oBAC/CC,IAAAA,uBAAe,EAACvB,WAAWD;oBAErBE,MAAMuB,IAAAA,gBAAO;oBACnBvB,IAAIwB,GAAG,CAACC,IAAAA,aAAI;oBACZzB,IAAIwB,GAAG,CAACD,gBAAO,CAACG,IAAI,CAAC;wBAAEC,OAAO;oBAAO;oBAErC,IAAIpC,QAAQkB,IAAI,CAACI,aAAa,CAACe,cAAc,EAAE;wBAC7C5B,IAAIwB,GAAG,CAAC,KAAKjC,QAAQkB,IAAI,CAACI,aAAa,CAACe,cAAc;wBACtDjC,OAAOkC,IAAI,CAAC;oBACd;oBAEM5B,aAAa6B,IAAAA,+BAAuB,EAAC;wBAAEC,YAAY1C,OAAO0C,UAAU;oBAAC,GAAG;wBAAEC,aAAa;wBAAYC,oBAAoB;oBAAa;oBAC1IjC,IAAIwB,GAAG,CAAC,UAAUvB;oBAElB,IAAIV,QAAQkB,IAAI,CAACI,aAAa,CAACqB,SAAS,EAAE;wBACxClC,IAAIwB,GAAG,CAAC,KAAKjC,QAAQkB,IAAI,CAACI,aAAa,CAACqB,SAAS;wBACjDvC,OAAOkC,IAAI,CAAC;oBACd;oBAEAlC,OAAOkC,IAAI,CAAC,AAAC,YAAuB,OAAZxC,OAAO4B,IAAI,EAAC;oBACN;;wBAAMkB,IAAAA,mBAAW,EAACpC,WAAW;4BAAEJ,QAAAA;4BAAQK,KAAAA;4BAAKJ,MAAAA;wBAAK;;;oBAAjD,OAAA,eAAtBM,QAAsB,KAAtBA,OAAOC,aAAe,KAAfA;oBACfR,OAAOkC,IAAI,CAAC;oBAEZ;;wBAAO;4BACL1B,YAAAA;4BACAJ,WAAAA;4BACAJ,QAAAA;4BACAO,OAAO;;;;;gDACL;;oDAAMA;;;gDAAN;gDACA;;oDAAMX,QAAQW,KAAK;;;gDAAnB;;;;;;gCACF;;wBACF;;;;IACF"}
+{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/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.ts';\nimport { createDefaultRuntime } from './runtime.ts';\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  if (runtime.deps.oauthAdapters.loopbackRouter) {\n    app.use('/', runtime.deps.oauthAdapters.loopbackRouter);\n    logger.info('Mounted loopback OAuth callback router');\n  }\n\n  const fileRouter = createFileServingRouter({ resourceStoreUri: config.resourceStoreUri }, { 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":["createHTTPServer","config","overrides","runtime","modules","layers","composed","logger","port","tools","prompts","mcpServer","app","fileRouter","close","httpServer","createDefaultRuntime","createDomainModules","middlewareFactories","map","factory","deps","composeMiddleware","transport","Error","oauthAdapters","accountTools","accountPrompts","McpServer","name","version","registerTools","registerResources","resources","registerPrompts","express","use","cors","json","limit","loopbackRouter","info","createFileServingRouter","resourceStoreUri","contentType","contentDisposition","dcrRouter","connectHttp"],"mappings":";;;;+BAOsBA;;;eAAAA;;;sBAPqG;mBACjG;2DACT;8DACG;yBAEiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAE9B,SAAeA,iBAAiBC,MAAoB,EAAEC,SAA4B;;YACjFC,SACAC,SACAC,QACAC,UACAC,QACAC,MAGAC,OACAC,SAEAC,WAKAC,KASAC,YASwB,MAAtBC,OAAOC;;;;oBAlCC;;wBAAMC,IAAAA,+BAAoB,EAACf,QAAQC;;;oBAA7CC,UAAU;oBACVC,UAAUD,QAAQc,mBAAmB;oBACrCZ,SAASF,QAAQe,mBAAmB,CAACC,GAAG,CAAC,SAACC;+BAAYA,QAAQjB,QAAQkB,IAAI;;oBAC1Ef,WAAWgB,IAAAA,yBAAiB,EAAClB,SAASC;oBACtCE,SAASJ,QAAQkB,IAAI,CAACd,MAAM;oBAC5BC,OAAOP,OAAOsB,SAAS,CAACf,IAAI;oBAClC,IAAI,CAACA,MAAM,MAAM,IAAIgB,MAAM;oBAErBf,QAAQ,AAAC,qBAAGH,SAASG,KAAK,SAAE,qBAAGN,QAAQkB,IAAI,CAACI,aAAa,CAACC,YAAY;oBACtEhB,UAAU,AAAC,qBAAGJ,SAASI,OAAO,SAAE,qBAAGP,QAAQkB,IAAI,CAACI,aAAa,CAACE,cAAc;oBAE5EhB,YAAY,IAAIiB,cAAS,CAAC;wBAAEC,MAAM5B,OAAO4B,IAAI;wBAAEC,SAAS7B,OAAO6B,OAAO;oBAAC;oBAC7EC,IAAAA,qBAAa,EAACpB,WAAWF;oBACzBuB,IAAAA,yBAAiB,EAACrB,WAAWL,SAAS2B,SAAS;oBAC/CC,IAAAA,uBAAe,EAACvB,WAAWD;oBAErBE,MAAMuB,IAAAA,gBAAO;oBACnBvB,IAAIwB,GAAG,CAACC,IAAAA,aAAI;oBACZzB,IAAIwB,GAAG,CAACD,gBAAO,CAACG,IAAI,CAAC;wBAAEC,OAAO;oBAAO;oBAErC,IAAIpC,QAAQkB,IAAI,CAACI,aAAa,CAACe,cAAc,EAAE;wBAC7C5B,IAAIwB,GAAG,CAAC,KAAKjC,QAAQkB,IAAI,CAACI,aAAa,CAACe,cAAc;wBACtDjC,OAAOkC,IAAI,CAAC;oBACd;oBAEM5B,aAAa6B,IAAAA,+BAAuB,EAAC;wBAAEC,kBAAkB1C,OAAO0C,gBAAgB;oBAAC,GAAG;wBAAEC,aAAa;wBAAYC,oBAAoB;oBAAa;oBACtJjC,IAAIwB,GAAG,CAAC,UAAUvB;oBAElB,IAAIV,QAAQkB,IAAI,CAACI,aAAa,CAACqB,SAAS,EAAE;wBACxClC,IAAIwB,GAAG,CAAC,KAAKjC,QAAQkB,IAAI,CAACI,aAAa,CAACqB,SAAS;wBACjDvC,OAAOkC,IAAI,CAAC;oBACd;oBAEAlC,OAAOkC,IAAI,CAAC,AAAC,YAAuB,OAAZxC,OAAO4B,IAAI,EAAC;oBACN;;wBAAMkB,IAAAA,mBAAW,EAACpC,WAAW;4BAAEJ,QAAAA;4BAAQK,KAAAA;4BAAKJ,MAAAA;wBAAK;;;oBAAjD,OAAA,eAAtBM,QAAsB,KAAtBA,OAAOC,aAAe,KAAfA;oBACfR,OAAOkC,IAAI,CAAC;oBAEZ;;wBAAO;4BACL1B,YAAAA;4BACAJ,WAAAA;4BACAJ,QAAAA;4BACAO,OAAO;;;;;gDACL;;oDAAMA;;;gDAAN;gDACA;;oDAAMX,QAAQW,KAAK;;;gDAAnB;;;;;;gCACF;;wBACF;;;;IACF"}

package/dist/cjs/setup/runtime.js

@@ -310,12 +310,12 @@ function createLogger(config) {
 }
 function createTokenStore(baseDir) {
     return _async_to_generator(function() {
-        var storeUri;
+        var tokenStoreUri;
         return _ts_generator(this, function(_state) {
-            storeUri = process.env.STORE_URI || "file://".concat(_path.join(baseDir, 'tokens.json'));
+            tokenStoreUri = process.env.TOKEN_STORE_URI || "file://".concat(_path.join(baseDir, 'tokens.json'));
             return [
                 2,
-                (0, _createstorets.default)(storeUri)
+                (0, _createstorets.default)(tokenStoreUri)
             ];
         });
     })();
@@ -391,8 +391,8 @@ function createStorageLayer(storageContext) {
     };
 }
 function assertStorageConfig(config) {
-    if (!config.storageDir) {
-        throw new Error('gmail-messages-export-csv: Server configuration missing storageDir.');
+    if (!config.resourceStoreUri) {
+        throw new Error('gmail-messages-export-csv: Server configuration missing resourceStoreUri.');
     }
     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.');
@@ -459,7 +459,7 @@ function createDefaultRuntime(config, overrides) {
                         },
                         function() {
                             return createStorageLayer({
-                                storageDir: config.storageDir,
+                                resourceStoreUri: config.resourceStoreUri,
                                 baseUrl: config.baseUrl,
                                 transport: config.transport
                             });

package/dist/cjs/setup/runtime.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-gmail/src/setup/runtime.ts"],"sourcesContent":["import { sanitizeForLoggingFormatter } from '@mcp-z/oauth';\nimport type { CachedToken } from '@mcp-z/oauth-google';\nimport type { Logger, MiddlewareLayer } from '@mcp-z/server';\nimport { createLoggingMiddleware } from '@mcp-z/server';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport pino from 'pino';\nimport createStore from '../lib/create-store.ts';\nimport * as mcp from '../mcp/index.ts';\nimport type { CommonRuntime, RuntimeDeps, RuntimeOverrides, ServerConfig, StorageContext } from '../types.ts';\nimport { createOAuthAdapters, type OAuthAdapters } from './oauth-google.ts';\n\nexport function createLogger(config: ServerConfig): Logger {\n  const hasStdio = config.transport.type === 'stdio';\n  const logsPath = path.join(config.baseDir, 'logs', `${config.name}.log`);\n  if (hasStdio) fs.mkdirSync(path.dirname(logsPath), { recursive: true });\n  return pino({ level: config.logLevel ?? 'info', formatters: sanitizeForLoggingFormatter() }, hasStdio ? pino.destination({ dest: logsPath, sync: false }) : pino.destination(1));\n}\n\nexport async function createTokenStore(baseDir: string) {\n  const storeUri = process.env.STORE_URI || `file://${path.join(baseDir, 'tokens.json')}`;\n  return createStore<CachedToken>(storeUri);\n}\n\nexport async function createDcrStore(baseDir: string, required: boolean) {\n  if (!required) return undefined;\n  const dcrStoreUri = process.env.DCR_STORE_URI || `file://${path.join(baseDir, 'dcr.json')}`;\n  return createStore<unknown>(dcrStoreUri);\n}\n\nexport function createAuthLayer(authMiddleware: OAuthAdapters['middleware']): MiddlewareLayer {\n  return {\n    withTool: authMiddleware.withToolAuth,\n    withResource: authMiddleware.withResourceAuth,\n    withPrompt: authMiddleware.withPromptAuth,\n  };\n}\n\nexport function createLoggingLayer(logger: Logger): MiddlewareLayer {\n  const logging = createLoggingMiddleware({ logger });\n  return {\n    withTool: logging.withToolLogging,\n    withResource: logging.withResourceLogging,\n    withPrompt: logging.withPromptLogging,\n  };\n}\n\nexport function createStorageLayer(storageContext: StorageContext): MiddlewareLayer {\n  const wrapAtPosition = <T extends { name: string; handler: unknown; [key: string]: unknown }>(module: T, extraPosition: number): T => {\n    const originalHandler = module.handler as (...args: unknown[]) => Promise<unknown>;\n\n    const wrappedHandler = async (...allArgs: unknown[]) => {\n      const extra = allArgs[extraPosition];\n      (extra as { storageContext?: StorageContext }).storageContext = storageContext;\n      return await originalHandler(...allArgs);\n    };\n\n    return {\n      ...module,\n      handler: wrappedHandler,\n    } as T;\n  };\n\n  return {\n    withTool: <T extends { name: string; config: unknown; handler: unknown }>(module: T): T => wrapAtPosition(module, 1) as T,\n  };\n}\n\nexport function assertStorageConfig(config: ServerConfig) {\n  if (!config.storageDir) {\n    throw new Error('gmail-messages-export-csv: Server configuration missing storageDir.');\n  }\n  if (config.transport.type === 'http' && !config.baseUrl && !config.transport.port) {\n    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.');\n  }\n}\n\nexport async function createDefaultRuntime(config: ServerConfig, overrides?: RuntimeOverrides): Promise<CommonRuntime> {\n  if (config.auth === 'dcr' && config.transport.type !== 'http') throw new Error('DCR mode requires an HTTP transport');\n\n  assertStorageConfig(config);\n  const logger = createLogger(config);\n  const tokenStore = await createTokenStore(config.baseDir);\n  const baseUrl = config.baseUrl ?? (config.transport.type === 'http' && config.transport.port ? `http://localhost:${config.transport.port}` : undefined);\n  const dcrStore = await createDcrStore(config.baseDir, config.auth === 'dcr');\n  const oauthAdapters = await createOAuthAdapters(config, { logger, tokenStore, dcrStore }, baseUrl);\n  const deps: RuntimeDeps = { config, logger, tokenStore, oauthAdapters, baseUrl };\n  const createDomainModules =\n    overrides?.createDomainModules ??\n    (() => ({\n      tools: Object.values(mcp.toolFactories).map((factory) => factory()),\n      resources: Object.values(mcp.resourceFactories).map((factory) => factory()),\n      prompts: Object.values(mcp.promptFactories).map((factory) => factory()),\n    }));\n  const middlewareFactories = overrides?.middlewareFactories ?? [() => createAuthLayer(oauthAdapters.middleware), () => createLoggingLayer(logger), () => createStorageLayer({ storageDir: config.storageDir, baseUrl: config.baseUrl, transport: config.transport })];\n\n  return {\n    deps,\n    middlewareFactories,\n    createDomainModules,\n    close: async () => {},\n  };\n}\n"],"names":["assertStorageConfig","createAuthLayer","createDcrStore","createDefaultRuntime","createLogger","createLoggingLayer","createStorageLayer","createTokenStore","config","hasStdio","transport","type","logsPath","path","join","baseDir","name","fs","mkdirSync","dirname","recursive","pino","level","logLevel","formatters","sanitizeForLoggingFormatter","destination","dest","sync","storeUri","process","env","STORE_URI","createStore","required","dcrStoreUri","undefined","DCR_STORE_URI","authMiddleware","withTool","withToolAuth","withResource","withResourceAuth","withPrompt","withPromptAuth","logger","logging","createLoggingMiddleware","withToolLogging","withResourceLogging","withPromptLogging","storageContext","wrapAtPosition","module","extraPosition","originalHandler","handler","wrappedHandler","allArgs","extra","storageDir","Error","baseUrl","port","overrides","tokenStore","dcrStore","oauthAdapters","deps","createDomainModules","middlewareFactories","auth","createOAuthAdapters","tools","Object","values","mcp","toolFactories","map","factory","resources","resourceFactories","prompts","promptFactories","middleware","close"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-gmail/src/setup/runtime.ts"],"sourcesContent":["import { sanitizeForLoggingFormatter } from '@mcp-z/oauth';\nimport type { CachedToken } from '@mcp-z/oauth-google';\nimport type { Logger, MiddlewareLayer } from '@mcp-z/server';\nimport { createLoggingMiddleware } from '@mcp-z/server';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport pino from 'pino';\nimport createStore from '../lib/create-store.ts';\nimport * as mcp from '../mcp/index.ts';\nimport type { CommonRuntime, RuntimeDeps, RuntimeOverrides, ServerConfig, StorageContext } from '../types.ts';\nimport { createOAuthAdapters, type OAuthAdapters } from './oauth-google.ts';\n\nexport function createLogger(config: ServerConfig): Logger {\n  const hasStdio = config.transport.type === 'stdio';\n  const logsPath = path.join(config.baseDir, 'logs', `${config.name}.log`);\n  if (hasStdio) fs.mkdirSync(path.dirname(logsPath), { recursive: true });\n  return pino({ level: config.logLevel ?? 'info', formatters: sanitizeForLoggingFormatter() }, hasStdio ? pino.destination({ dest: logsPath, sync: false }) : pino.destination(1));\n}\n\nexport async function createTokenStore(baseDir: string) {\n  const tokenStoreUri = process.env.TOKEN_STORE_URI || `file://${path.join(baseDir, 'tokens.json')}`;\n  return createStore<CachedToken>(tokenStoreUri);\n}\n\nexport async function createDcrStore(baseDir: string, required: boolean) {\n  if (!required) return undefined;\n  const dcrStoreUri = process.env.DCR_STORE_URI || `file://${path.join(baseDir, 'dcr.json')}`;\n  return createStore<unknown>(dcrStoreUri);\n}\n\nexport function createAuthLayer(authMiddleware: OAuthAdapters['middleware']): MiddlewareLayer {\n  return {\n    withTool: authMiddleware.withToolAuth,\n    withResource: authMiddleware.withResourceAuth,\n    withPrompt: authMiddleware.withPromptAuth,\n  };\n}\n\nexport function createLoggingLayer(logger: Logger): MiddlewareLayer {\n  const logging = createLoggingMiddleware({ logger });\n  return {\n    withTool: logging.withToolLogging,\n    withResource: logging.withResourceLogging,\n    withPrompt: logging.withPromptLogging,\n  };\n}\n\nexport function createStorageLayer(storageContext: StorageContext): MiddlewareLayer {\n  const wrapAtPosition = <T extends { name: string; handler: unknown; [key: string]: unknown }>(module: T, extraPosition: number): T => {\n    const originalHandler = module.handler as (...args: unknown[]) => Promise<unknown>;\n\n    const wrappedHandler = async (...allArgs: unknown[]) => {\n      const extra = allArgs[extraPosition];\n      (extra as { storageContext?: StorageContext }).storageContext = storageContext;\n      return await originalHandler(...allArgs);\n    };\n\n    return {\n      ...module,\n      handler: wrappedHandler,\n    } as T;\n  };\n\n  return {\n    withTool: <T extends { name: string; config: unknown; handler: unknown }>(module: T): T => wrapAtPosition(module, 1) as T,\n  };\n}\n\nexport function assertStorageConfig(config: ServerConfig) {\n  if (!config.resourceStoreUri) {\n    throw new Error('gmail-messages-export-csv: Server configuration missing resourceStoreUri.');\n  }\n  if (config.transport.type === 'http' && !config.baseUrl && !config.transport.port) {\n    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.');\n  }\n}\n\nexport async function createDefaultRuntime(config: ServerConfig, overrides?: RuntimeOverrides): Promise<CommonRuntime> {\n  if (config.auth === 'dcr' && config.transport.type !== 'http') throw new Error('DCR mode requires an HTTP transport');\n\n  assertStorageConfig(config);\n  const logger = createLogger(config);\n  const tokenStore = await createTokenStore(config.baseDir);\n  const baseUrl = config.baseUrl ?? (config.transport.type === 'http' && config.transport.port ? `http://localhost:${config.transport.port}` : undefined);\n  const dcrStore = await createDcrStore(config.baseDir, config.auth === 'dcr');\n  const oauthAdapters = await createOAuthAdapters(config, { logger, tokenStore, dcrStore }, baseUrl);\n  const deps: RuntimeDeps = { config, logger, tokenStore, oauthAdapters, baseUrl };\n  const createDomainModules =\n    overrides?.createDomainModules ??\n    (() => ({\n      tools: Object.values(mcp.toolFactories).map((factory) => factory()),\n      resources: Object.values(mcp.resourceFactories).map((factory) => factory()),\n      prompts: Object.values(mcp.promptFactories).map((factory) => factory()),\n    }));\n  const middlewareFactories = overrides?.middlewareFactories ?? [() => createAuthLayer(oauthAdapters.middleware), () => createLoggingLayer(logger), () => createStorageLayer({ resourceStoreUri: config.resourceStoreUri, baseUrl: config.baseUrl, transport: config.transport })];\n\n  return {\n    deps,\n    middlewareFactories,\n    createDomainModules,\n    close: async () => {},\n  };\n}\n"],"names":["assertStorageConfig","createAuthLayer","createDcrStore","createDefaultRuntime","createLogger","createLoggingLayer","createStorageLayer","createTokenStore","config","hasStdio","transport","type","logsPath","path","join","baseDir","name","fs","mkdirSync","dirname","recursive","pino","level","logLevel","formatters","sanitizeForLoggingFormatter","destination","dest","sync","tokenStoreUri","process","env","TOKEN_STORE_URI","createStore","required","dcrStoreUri","undefined","DCR_STORE_URI","authMiddleware","withTool","withToolAuth","withResource","withResourceAuth","withPrompt","withPromptAuth","logger","logging","createLoggingMiddleware","withToolLogging","withResourceLogging","withPromptLogging","storageContext","wrapAtPosition","module","extraPosition","originalHandler","handler","wrappedHandler","allArgs","extra","resourceStoreUri","Error","baseUrl","port","overrides","tokenStore","dcrStore","oauthAdapters","deps","createDomainModules","middlewareFactories","auth","createOAuthAdapters","tools","Object","values","mcp","toolFactories","map","factory","resources","resourceFactories","prompts","promptFactories","middleware","close"],"mappings":";;;;;;;;;;;QAoEgBA;eAAAA;;QAtCAC;eAAAA;;QANMC;eAAAA;;QAqDAC;eAAAA;;QAjENC;eAAAA;;QA0BAC;eAAAA;;QASAC;eAAAA;;QA5BMC;eAAAA;;;qBAnBsB;sBAGJ;0DACpB;4DACE;2DACL;oEACO;+DACH;6BAEmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEjD,SAASH,aAAaI,MAAoB;QAI1BA;IAHrB,IAAMC,WAAWD,OAAOE,SAAS,CAACC,IAAI,KAAK;IAC3C,IAAMC,WAAWC,MAAKC,IAAI,CAACN,OAAOO,OAAO,EAAE,QAAQ,AAAC,GAAc,OAAZP,OAAOQ,IAAI,EAAC;IAClE,IAAIP,UAAUQ,IAAGC,SAAS,CAACL,MAAKM,OAAO,CAACP,WAAW;QAAEQ,WAAW;IAAK;IACrE,OAAOC,IAAAA,aAAI,EAAC;QAAEC,KAAK,GAAEd,mBAAAA,OAAOe,QAAQ,cAAff,8BAAAA,mBAAmB;QAAQgB,YAAYC,IAAAA,kCAA2B;IAAG,GAAGhB,WAAWY,aAAI,CAACK,WAAW,CAAC;QAAEC,MAAMf;QAAUgB,MAAM;IAAM,KAAKP,aAAI,CAACK,WAAW,CAAC;AAC/K;AAEO,SAAenB,iBAAiBQ,OAAe;;YAC9Cc;;YAAAA,gBAAgBC,QAAQC,GAAG,CAACC,eAAe,IAAI,AAAC,UAA2C,OAAlCnB,MAAKC,IAAI,CAACC,SAAS;YAClF;;gBAAOkB,IAAAA,sBAAW,EAAcJ;;;IAClC;;AAEO,SAAe3B,eAAea,OAAe,EAAEmB,QAAiB;;YAE/DC;;YADN,IAAI,CAACD,UAAU;;gBAAOE;;YAChBD,cAAcL,QAAQC,GAAG,CAACM,aAAa,IAAI,AAAC,UAAwC,OAA/BxB,MAAKC,IAAI,CAACC,SAAS;YAC9E;;gBAAOkB,IAAAA,sBAAW,EAAUE;;;IAC9B;;AAEO,SAASlC,gBAAgBqC,cAA2C;IACzE,OAAO;QACLC,UAAUD,eAAeE,YAAY;QACrCC,cAAcH,eAAeI,gBAAgB;QAC7CC,YAAYL,eAAeM,cAAc;IAC3C;AACF;AAEO,SAASvC,mBAAmBwC,MAAc;IAC/C,IAAMC,UAAUC,IAAAA,+BAAuB,EAAC;QAAEF,QAAAA;IAAO;IACjD,OAAO;QACLN,UAAUO,QAAQE,eAAe;QACjCP,cAAcK,QAAQG,mBAAmB;QACzCN,YAAYG,QAAQI,iBAAiB;IACvC;AACF;AAEO,SAAS5C,mBAAmB6C,cAA8B;IAC/D,IAAMC,iBAAiB,SAAuEC,QAAWC;QACvG,IAAMC,kBAAkBF,OAAOG,OAAO;QAEtC,IAAMC,iBAAiB;6CAAUC;gBAAAA;;;oBACzBC;;;;4BAAAA,QAAQD,OAAO,CAACJ,cAAc;4BACnCK,MAA8CR,cAAc,GAAGA;4BACzD;;gCAAMI,sBAAAA,KAAAA,GAAgB,qBAAGG;;;4BAAhC;;gCAAO;;;;YACT;;QAEA,OAAO,wCACFL;YACHG,SAASC;;IAEb;IAEA,OAAO;QACLlB,UAAU,SAAgEc;mBAAiBD,eAAeC,QAAQ;;IACpH;AACF;AAEO,SAASrD,oBAAoBQ,MAAoB;IACtD,IAAI,CAACA,OAAOoD,gBAAgB,EAAE;QAC5B,MAAM,IAAIC,MAAM;IAClB;IACA,IAAIrD,OAAOE,SAAS,CAACC,IAAI,KAAK,UAAU,CAACH,OAAOsD,OAAO,IAAI,CAACtD,OAAOE,SAAS,CAACqD,IAAI,EAAE;QACjF,MAAM,IAAIF,MAAM;IAClB;AACF;AAEO,SAAe1D,qBAAqBK,MAAoB,EAAEwD,SAA4B;;YAM3ExD,8BAFVqC,QACAoB,YACAH,SACAI,UACAC,eACAC,MACAC,qBAOAC;;;;oBAhBN,IAAI9D,OAAO+D,IAAI,KAAK,SAAS/D,OAAOE,SAAS,CAACC,IAAI,KAAK,QAAQ,MAAM,IAAIkD,MAAM;oBAE/E7D,oBAAoBQ;oBACdqC,SAASzC,aAAaI;oBACT;;wBAAMD,iBAAiBC,OAAOO,OAAO;;;oBAAlDkD,aAAa;oBACbH,WAAUtD,kBAAAA,OAAOsD,OAAO,cAAdtD,6BAAAA,kBAAmBA,OAAOE,SAAS,CAACC,IAAI,KAAK,UAAUH,OAAOE,SAAS,CAACqD,IAAI,GAAG,AAAC,oBAAyC,OAAtBvD,OAAOE,SAAS,CAACqD,IAAI,IAAK3B;oBAC5H;;wBAAMlC,eAAeM,OAAOO,OAAO,EAAEP,OAAO+D,IAAI,KAAK;;;oBAAhEL,WAAW;oBACK;;wBAAMM,IAAAA,kCAAmB,EAAChE,QAAQ;4BAAEqC,QAAAA;4BAAQoB,YAAAA;4BAAYC,UAAAA;wBAAS,GAAGJ;;;oBAApFK,gBAAgB;oBAChBC,OAAoB;wBAAE5D,QAAAA;wBAAQqC,QAAAA;wBAAQoB,YAAAA;wBAAYE,eAAAA;wBAAeL,SAAAA;oBAAQ;oBACzEO,8BACJL,sBAAAA,gCAAAA,UAAWK,mBAAmB,uCAC7B;+BAAO;4BACNI,OAAOC,OAAOC,MAAM,CAACC,SAAIC,aAAa,EAAEC,GAAG,CAAC,SAACC;uCAAYA;;4BACzDC,WAAWN,OAAOC,MAAM,CAACC,SAAIK,iBAAiB,EAAEH,GAAG,CAAC,SAACC;uCAAYA;;4BACjEG,SAASR,OAAOC,MAAM,CAACC,SAAIO,eAAe,EAAEL,GAAG,CAAC,SAACC;uCAAYA;;wBAC/D;;oBACIT,+BAAsBN,sBAAAA,gCAAAA,UAAWM,mBAAmB;wBAAK;mCAAMrE,gBAAgBkE,cAAciB,UAAU;;wBAAG;mCAAM/E,mBAAmBwC;;wBAAS;mCAAMvC,mBAAmB;gCAAEsD,kBAAkBpD,OAAOoD,gBAAgB;gCAAEE,SAAStD,OAAOsD,OAAO;gCAAEpD,WAAWF,OAAOE,SAAS;4BAAC;;;oBAE7Q;;wBAAO;4BACL0D,MAAAA;4BACAE,qBAAAA;4BACAD,qBAAAA;4BACAgB,OAAO;;;;;;;gCAAa;;wBACtB;;;;IACF"}

package/dist/cjs/types.d.cts

@@ -12,12 +12,12 @@ export interface ServerConfig extends BaseServerConfig, OAuthConfig {
     name: string;
     version: string;
     repositoryUrl: string;
-    storageDir: string;
+    resourceStoreUri: string;
     baseUrl?: string;
     dcrConfig?: DcrConfig;
 }
 export interface StorageContext {
-    storageDir: string;
+    resourceStoreUri: string;
     baseUrl?: string;
     transport: BaseServerConfig['transport'];
 }

package/dist/cjs/types.d.ts

@@ -12,12 +12,12 @@ export interface ServerConfig extends BaseServerConfig, OAuthConfig {
     name: string;
     version: string;
     repositoryUrl: string;
-    storageDir: string;
+    resourceStoreUri: string;
     baseUrl?: string;
     dcrConfig?: DcrConfig;
 }
 export interface StorageContext {
-    storageDir: string;
+    resourceStoreUri: string;
     baseUrl?: string;
     transport: BaseServerConfig['transport'];
 }

package/dist/esm/mcp/tools/messages-export-csv.js

@@ -51,7 +51,7 @@ const config = {
  */ async function handler({ query, maxItems, filename, contentType, excludeThreadHistory }, extra) {
     const logger = extra.logger;
     const { storageContext } = extra;
-    const { transport, storageDir, baseUrl } = storageContext;
+    const { transport, resourceStoreUri, baseUrl } = storageContext;
     logger.info('gmail.messages.export-csv called', {
         query,
         maxItems,
@@ -60,7 +60,7 @@ const config = {
     });
     // Reserve file location for streaming write (creates directory, generates ID, formats filename)
     const reservation = await reserveFile(filename, {
-        storageDir
+        resourceStoreUri
     });
     const { storedName, fullPath } = reservation;
     logger.info('gmail.messages.export-csv starting streaming export', {
@@ -207,7 +207,7 @@ const config = {
         });
         // Generate URI based on transport type (stdio: file://, HTTP: http://)
         const uri = getFileUri(storedName, transport, {
-            storageDir,
+            resourceStoreUri,
             ...baseUrl && {
                 baseUrl
             },

package/dist/esm/mcp/tools/messages-export-csv.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-gmail/src/mcp/tools/messages-export-csv.ts"],"sourcesContent":["import { EmailContentTypeSchema, ExcludeThreadHistorySchema } from '@mcp-z/email';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport { getFileUri, reserveFile, type ToolModule } from '@mcp-z/server';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\n\nimport { stringify } from 'csv-stringify/sync';\nimport { createWriteStream } from 'fs';\nimport { unlink } from 'fs/promises';\nimport { type gmail_v1, google } from 'googleapis';\nimport { z } from 'zod';\nimport { DEFAULT_PAGE_SIZE } from '../../constants.ts';\nimport { extractBodyFromPayload } from '../../email/parsing/html-processing.ts';\nimport { executeQuery as executeGmailQuery } from '../../email/querying/execute-query.ts';\nimport { GmailQuerySchema } from '../../schemas/gmail-query-schema.ts';\nimport type { StorageExtra } from '../../types.ts';\n\nconst DEFAULT_MAX_ITEMS = 10000;\nconst MAX_EXPORT_ITEMS = 50000;\n\n/**\n * CSV row format based on EmailDetail\n * All fields are strings (empty string instead of undefined)\n * Includes additional CSV-specific fields: provider and labels\n */\ninterface CsvRow {\n  id: string;\n  threadId: string;\n  from: string;\n  to: string;\n  cc: string;\n  bcc: string;\n  subject: string;\n  date: string;\n  snippet: string;\n  body: string;\n  provider: string;\n  labels: string;\n}\n\nconst inputSchema = z.object({\n  query: GmailQuerySchema.optional().describe('Structured query object for filtering messages. Use query-syntax prompt for reference.'),\n  maxItems: z.number().int().positive().max(MAX_EXPORT_ITEMS).default(DEFAULT_MAX_ITEMS).describe(`Maximum messages to export (default: ${DEFAULT_MAX_ITEMS}, max: ${MAX_EXPORT_ITEMS})`),\n  filename: z.string().trim().min(1).default('gmail-messages.csv').describe('Output filename (default: gmail-messages.csv)'),\n  contentType: EmailContentTypeSchema,\n  excludeThreadHistory: ExcludeThreadHistorySchema,\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  uri: z.string().describe('File URI (file:// or http://)'),\n  filename: z.string().describe('Stored filename'),\n  rowCount: z.number().describe('Number of messages exported'),\n  truncated: z.boolean().describe('Whether export was truncated at maxItems'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Export Gmail messages to CSV with streaming pagination. Returns file URI. Use query-syntax prompt for query reference.',\n  inputSchema: inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\n/**\n * Handler for gmail-messages-export-csv tool\n *\n * CRITICAL: Streaming implementation per user requirements\n * - Generate UUID upfront\n * - Write CSV header immediately\n * - Append rows as batches arrive\n * - Delete partial file on error\n * - NO RETRIES (fail fast on error)\n */\nasync function handler({ query, maxItems, filename, contentType, excludeThreadHistory }: Input, extra: EnrichedExtra & StorageExtra) {\n  const logger = extra.logger;\n  const { storageContext } = extra;\n  const { transport, storageDir, baseUrl } = storageContext;\n\n  logger.info('gmail.messages.export-csv called', {\n    query,\n    maxItems,\n    filename,\n    accountId: extra.authContext.accountId,\n  });\n\n  // Reserve file location for streaming write (creates directory, generates ID, formats filename)\n  const reservation = await reserveFile(filename, {\n    storageDir,\n  });\n  const { storedName, fullPath } = reservation;\n\n  logger.info('gmail.messages.export-csv starting streaming export', { path: fullPath, maxItems });\n\n  try {\n    const gmail = google.gmail({ version: 'v1', auth: extra.authContext.auth });\n\n    // Create CSV headers (all email fields)\n    const csvHeaders = ['id', 'threadId', 'from', 'to', 'cc', 'bcc', 'subject', 'date', 'snippet', 'body', 'provider', 'labels'];\n\n    // Create write stream and write headers immediately\n    const writeStream = createWriteStream(fullPath, { encoding: 'utf-8' });\n    const headerLine = stringify([csvHeaders], { header: false, quoted: true, quote: '\"', escape: '\"' });\n    writeStream.write(headerLine);\n\n    // Internal pagination loop - append to CSV with each batch\n    // NO RETRIES: If any error occurs, fail the whole operation and clean up\n    let totalRows = 0;\n    let nextPageToken: string | undefined;\n    const started = Date.now();\n\n    while (totalRows < maxItems) {\n      const remainingItems = maxItems - totalRows;\n      const pageSize = Math.min(remainingItems, DEFAULT_PAGE_SIZE);\n\n      const exec: {\n        items: CsvRow[];\n        metadata?: { nextPageToken?: string };\n      } = await executeGmailQuery(\n        query,\n        {\n          client: gmail,\n          logger,\n          pageSize,\n          ...(nextPageToken !== undefined && { pageToken: nextPageToken }),\n          includeBody: true, // Always include body for CSV export\n        },\n        (full: unknown): CsvRow => {\n          // Type-safe property access with guards\n          const fullData = full as {\n            id?: unknown;\n            threadId?: unknown;\n            snippet?: unknown;\n            labelIds?: unknown[];\n            payload?: { headers?: unknown[] };\n          };\n\n          const headersArray = Array.isArray(fullData?.payload?.headers) ? fullData.payload.headers : [];\n          const headers = Object.fromEntries(\n            headersArray.map((h: unknown) => {\n              const header = h as { name?: unknown; value?: unknown };\n              return [String(header.name ?? ''), String(header.value ?? '')];\n            })\n          );\n\n          const payload = fullData?.payload;\n          // Cast to Schema$MessagePart for extractBodyFromPayload\n          const body = payload ? extractBodyFromPayload(payload as gmail_v1.Schema$MessagePart, { contentType, excludeThreadHistory }) : '';\n\n          const labelIds = Array.isArray(fullData?.labelIds) ? fullData.labelIds.map((id) => String(id ?? '')) : [];\n\n          return {\n            id: String(fullData?.id ?? ''),\n            threadId: fullData?.threadId ? String(fullData.threadId) : '',\n            from: headers?.From || '',\n            to: headers?.To || '',\n            cc: headers?.Cc || '',\n            bcc: headers?.Bcc || '',\n            subject: headers?.Subject || '',\n            date: headers?.Date || '',\n            snippet: fullData?.snippet ? String(fullData.snippet) : '',\n            body,\n            provider: 'gmail',\n            labels: labelIds.join(';'),\n          };\n        }\n      );\n\n      // Type-safe CSV row mapping\n      const csvRows = exec.items.map((row) => {\n        return [row.id, row.threadId, row.from, row.to, row.cc, row.bcc, row.subject, row.date, row.snippet, row.body, row.provider, row.labels];\n      });\n\n      // Append rows to CSV file immediately\n      if (csvRows.length > 0) {\n        const rowsContent = stringify(csvRows, { header: false, quoted: true, quote: '\"', escape: '\"' });\n        writeStream.write(rowsContent);\n      }\n\n      totalRows += exec.items.length;\n      nextPageToken = exec.metadata?.nextPageToken;\n\n      logger.info('gmail.messages.export-csv batch written', {\n        batchSize: exec.items.length,\n        totalRows,\n        hasMore: Boolean(nextPageToken),\n      });\n\n      // Exit if no more results or reached maxItems\n      if (!nextPageToken || exec.items.length === 0) {\n        break;\n      }\n    }\n\n    // Close write stream\n    await new Promise<void>((resolve, reject) => {\n      writeStream.end(() => resolve());\n      writeStream.on('error', reject);\n    });\n\n    const durationMs = Date.now() - started;\n    const truncated = totalRows >= maxItems && Boolean(nextPageToken);\n\n    logger.info('gmail.messages.export-csv completed', {\n      rowCount: totalRows,\n      truncated,\n      durationMs,\n      filename: storedName,\n    });\n\n    // Generate URI based on transport type (stdio: file://, HTTP: http://)\n    const uri = getFileUri(storedName, transport, {\n      storageDir,\n      ...(baseUrl && { baseUrl }),\n      endpoint: '/files',\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      uri,\n      filename: storedName,\n      rowCount: totalRows,\n      truncated,\n    };\n\n    return {\n      content: [\n        {\n          type: 'text' as const,\n          text: JSON.stringify(result),\n        },\n      ],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    // CRITICAL: Clean up partial CSV file on error\n    try {\n      await unlink(fullPath);\n      logger.debug('Cleaned up partial CSV file after error', { path: fullPath });\n    } catch (_cleanupError) {\n      logger.debug('Could not clean up CSV file (may not exist)', { path: fullPath });\n    }\n\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('gmail.messages.export-csv error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error exporting messages to CSV: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'messages-export-csv',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["EmailContentTypeSchema","ExcludeThreadHistorySchema","schemas","AuthRequiredBranchSchema","getFileUri","reserveFile","ErrorCode","McpError","stringify","createWriteStream","unlink","google","z","DEFAULT_PAGE_SIZE","extractBodyFromPayload","executeQuery","executeGmailQuery","GmailQuerySchema","DEFAULT_MAX_ITEMS","MAX_EXPORT_ITEMS","inputSchema","object","query","optional","describe","maxItems","number","int","positive","max","default","filename","string","trim","min","contentType","excludeThreadHistory","successBranchSchema","type","literal","uri","rowCount","truncated","boolean","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","storageContext","transport","storageDir","baseUrl","info","accountId","authContext","reservation","storedName","fullPath","path","gmail","version","auth","csvHeaders","writeStream","encoding","headerLine","header","quoted","quote","escape","write","totalRows","nextPageToken","started","Date","now","exec","remainingItems","pageSize","Math","client","undefined","pageToken","includeBody","full","fullData","headersArray","Array","isArray","payload","headers","Object","fromEntries","map","h","String","name","value","body","labelIds","id","threadId","from","From","to","To","cc","Cc","bcc","Bcc","subject","Subject","date","snippet","provider","labels","join","csvRows","items","row","length","rowsContent","metadata","batchSize","hasMore","Boolean","Promise","resolve","reject","end","on","durationMs","endpoint","content","text","JSON","structuredContent","error","debug","_cleanupError","message","Error","InternalError","stack","createTool"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-gmail/src/mcp/tools/messages-export-csv.ts"],"sourcesContent":["import { EmailContentTypeSchema, ExcludeThreadHistorySchema } from '@mcp-z/email';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport { getFileUri, reserveFile, type ToolModule } from '@mcp-z/server';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\n\nimport { stringify } from 'csv-stringify/sync';\nimport { createWriteStream } from 'fs';\nimport { unlink } from 'fs/promises';\nimport { type gmail_v1, google } from 'googleapis';\nimport { z } from 'zod';\nimport { DEFAULT_PAGE_SIZE } from '../../constants.ts';\nimport { extractBodyFromPayload } from '../../email/parsing/html-processing.ts';\nimport { executeQuery as executeGmailQuery } from '../../email/querying/execute-query.ts';\nimport { GmailQuerySchema } from '../../schemas/gmail-query-schema.ts';\nimport type { StorageExtra } from '../../types.ts';\n\nconst DEFAULT_MAX_ITEMS = 10000;\nconst MAX_EXPORT_ITEMS = 50000;\n\n/**\n * CSV row format based on EmailDetail\n * All fields are strings (empty string instead of undefined)\n * Includes additional CSV-specific fields: provider and labels\n */\ninterface CsvRow {\n  id: string;\n  threadId: string;\n  from: string;\n  to: string;\n  cc: string;\n  bcc: string;\n  subject: string;\n  date: string;\n  snippet: string;\n  body: string;\n  provider: string;\n  labels: string;\n}\n\nconst inputSchema = z.object({\n  query: GmailQuerySchema.optional().describe('Structured query object for filtering messages. Use query-syntax prompt for reference.'),\n  maxItems: z.number().int().positive().max(MAX_EXPORT_ITEMS).default(DEFAULT_MAX_ITEMS).describe(`Maximum messages to export (default: ${DEFAULT_MAX_ITEMS}, max: ${MAX_EXPORT_ITEMS})`),\n  filename: z.string().trim().min(1).default('gmail-messages.csv').describe('Output filename (default: gmail-messages.csv)'),\n  contentType: EmailContentTypeSchema,\n  excludeThreadHistory: ExcludeThreadHistorySchema,\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  uri: z.string().describe('File URI (file:// or http://)'),\n  filename: z.string().describe('Stored filename'),\n  rowCount: z.number().describe('Number of messages exported'),\n  truncated: z.boolean().describe('Whether export was truncated at maxItems'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Export Gmail messages to CSV with streaming pagination. Returns file URI. Use query-syntax prompt for query reference.',\n  inputSchema: inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\n/**\n * Handler for gmail-messages-export-csv tool\n *\n * CRITICAL: Streaming implementation per user requirements\n * - Generate UUID upfront\n * - Write CSV header immediately\n * - Append rows as batches arrive\n * - Delete partial file on error\n * - NO RETRIES (fail fast on error)\n */\nasync function handler({ query, maxItems, filename, contentType, excludeThreadHistory }: Input, extra: EnrichedExtra & StorageExtra) {\n  const logger = extra.logger;\n  const { storageContext } = extra;\n  const { transport, resourceStoreUri, baseUrl } = storageContext;\n\n  logger.info('gmail.messages.export-csv called', {\n    query,\n    maxItems,\n    filename,\n    accountId: extra.authContext.accountId,\n  });\n\n  // Reserve file location for streaming write (creates directory, generates ID, formats filename)\n  const reservation = await reserveFile(filename, {\n    resourceStoreUri,\n  });\n  const { storedName, fullPath } = reservation;\n\n  logger.info('gmail.messages.export-csv starting streaming export', { path: fullPath, maxItems });\n\n  try {\n    const gmail = google.gmail({ version: 'v1', auth: extra.authContext.auth });\n\n    // Create CSV headers (all email fields)\n    const csvHeaders = ['id', 'threadId', 'from', 'to', 'cc', 'bcc', 'subject', 'date', 'snippet', 'body', 'provider', 'labels'];\n\n    // Create write stream and write headers immediately\n    const writeStream = createWriteStream(fullPath, { encoding: 'utf-8' });\n    const headerLine = stringify([csvHeaders], { header: false, quoted: true, quote: '\"', escape: '\"' });\n    writeStream.write(headerLine);\n\n    // Internal pagination loop - append to CSV with each batch\n    // NO RETRIES: If any error occurs, fail the whole operation and clean up\n    let totalRows = 0;\n    let nextPageToken: string | undefined;\n    const started = Date.now();\n\n    while (totalRows < maxItems) {\n      const remainingItems = maxItems - totalRows;\n      const pageSize = Math.min(remainingItems, DEFAULT_PAGE_SIZE);\n\n      const exec: {\n        items: CsvRow[];\n        metadata?: { nextPageToken?: string };\n      } = await executeGmailQuery(\n        query,\n        {\n          client: gmail,\n          logger,\n          pageSize,\n          ...(nextPageToken !== undefined && { pageToken: nextPageToken }),\n          includeBody: true, // Always include body for CSV export\n        },\n        (full: unknown): CsvRow => {\n          // Type-safe property access with guards\n          const fullData = full as {\n            id?: unknown;\n            threadId?: unknown;\n            snippet?: unknown;\n            labelIds?: unknown[];\n            payload?: { headers?: unknown[] };\n          };\n\n          const headersArray = Array.isArray(fullData?.payload?.headers) ? fullData.payload.headers : [];\n          const headers = Object.fromEntries(\n            headersArray.map((h: unknown) => {\n              const header = h as { name?: unknown; value?: unknown };\n              return [String(header.name ?? ''), String(header.value ?? '')];\n            })\n          );\n\n          const payload = fullData?.payload;\n          // Cast to Schema$MessagePart for extractBodyFromPayload\n          const body = payload ? extractBodyFromPayload(payload as gmail_v1.Schema$MessagePart, { contentType, excludeThreadHistory }) : '';\n\n          const labelIds = Array.isArray(fullData?.labelIds) ? fullData.labelIds.map((id) => String(id ?? '')) : [];\n\n          return {\n            id: String(fullData?.id ?? ''),\n            threadId: fullData?.threadId ? String(fullData.threadId) : '',\n            from: headers?.From || '',\n            to: headers?.To || '',\n            cc: headers?.Cc || '',\n            bcc: headers?.Bcc || '',\n            subject: headers?.Subject || '',\n            date: headers?.Date || '',\n            snippet: fullData?.snippet ? String(fullData.snippet) : '',\n            body,\n            provider: 'gmail',\n            labels: labelIds.join(';'),\n          };\n        }\n      );\n\n      // Type-safe CSV row mapping\n      const csvRows = exec.items.map((row) => {\n        return [row.id, row.threadId, row.from, row.to, row.cc, row.bcc, row.subject, row.date, row.snippet, row.body, row.provider, row.labels];\n      });\n\n      // Append rows to CSV file immediately\n      if (csvRows.length > 0) {\n        const rowsContent = stringify(csvRows, { header: false, quoted: true, quote: '\"', escape: '\"' });\n        writeStream.write(rowsContent);\n      }\n\n      totalRows += exec.items.length;\n      nextPageToken = exec.metadata?.nextPageToken;\n\n      logger.info('gmail.messages.export-csv batch written', {\n        batchSize: exec.items.length,\n        totalRows,\n        hasMore: Boolean(nextPageToken),\n      });\n\n      // Exit if no more results or reached maxItems\n      if (!nextPageToken || exec.items.length === 0) {\n        break;\n      }\n    }\n\n    // Close write stream\n    await new Promise<void>((resolve, reject) => {\n      writeStream.end(() => resolve());\n      writeStream.on('error', reject);\n    });\n\n    const durationMs = Date.now() - started;\n    const truncated = totalRows >= maxItems && Boolean(nextPageToken);\n\n    logger.info('gmail.messages.export-csv completed', {\n      rowCount: totalRows,\n      truncated,\n      durationMs,\n      filename: storedName,\n    });\n\n    // Generate URI based on transport type (stdio: file://, HTTP: http://)\n    const uri = getFileUri(storedName, transport, {\n      resourceStoreUri,\n      ...(baseUrl && { baseUrl }),\n      endpoint: '/files',\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      uri,\n      filename: storedName,\n      rowCount: totalRows,\n      truncated,\n    };\n\n    return {\n      content: [\n        {\n          type: 'text' as const,\n          text: JSON.stringify(result),\n        },\n      ],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    // CRITICAL: Clean up partial CSV file on error\n    try {\n      await unlink(fullPath);\n      logger.debug('Cleaned up partial CSV file after error', { path: fullPath });\n    } catch (_cleanupError) {\n      logger.debug('Could not clean up CSV file (may not exist)', { path: fullPath });\n    }\n\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('gmail.messages.export-csv error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error exporting messages to CSV: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'messages-export-csv',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["EmailContentTypeSchema","ExcludeThreadHistorySchema","schemas","AuthRequiredBranchSchema","getFileUri","reserveFile","ErrorCode","McpError","stringify","createWriteStream","unlink","google","z","DEFAULT_PAGE_SIZE","extractBodyFromPayload","executeQuery","executeGmailQuery","GmailQuerySchema","DEFAULT_MAX_ITEMS","MAX_EXPORT_ITEMS","inputSchema","object","query","optional","describe","maxItems","number","int","positive","max","default","filename","string","trim","min","contentType","excludeThreadHistory","successBranchSchema","type","literal","uri","rowCount","truncated","boolean","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","storageContext","transport","resourceStoreUri","baseUrl","info","accountId","authContext","reservation","storedName","fullPath","path","gmail","version","auth","csvHeaders","writeStream","encoding","headerLine","header","quoted","quote","escape","write","totalRows","nextPageToken","started","Date","now","exec","remainingItems","pageSize","Math","client","undefined","pageToken","includeBody","full","fullData","headersArray","Array","isArray","payload","headers","Object","fromEntries","map","h","String","name","value","body","labelIds","id","threadId","from","From","to","To","cc","Cc","bcc","Bcc","subject","Subject","date","snippet","provider","labels","join","csvRows","items","row","length","rowsContent","metadata","batchSize","hasMore","Boolean","Promise","resolve","reject","end","on","durationMs","endpoint","content","text","JSON","structuredContent","error","debug","_cleanupError","message","Error","InternalError","stack","createTool"],"mappings":"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"}

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

@@ -21,7 +21,7 @@ export declare function handleVersionHelp(args: string[]): {
  * - --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)
+ * - --resource-store-uri=<uri>    Resource store URI for CSV file storage (default: file://~/.mcp-z/mcp-gmail/files)
  * - --base-url=<url>       Base URL for HTTP file serving (optional)
  *
  * Environment Variables:
@@ -32,9 +32,10 @@ export declare function handleVersionHelp(args: string[]): {
  * - 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)
+ * - TOKEN_STORE_URI        Token storage URI (optional)
  * - PORT                   Default HTTP port (optional)
  * - LOG_LEVEL              Default logging level (optional)
- * - STORAGE_DIR            Default storage directory (optional)
+ * - RESOURCE_STORE_URI            Resource store URI (optional, file://)
  * - BASE_URL               Default base URL for file serving (optional)
  *
  * OAuth Scopes (from constants.ts):

package/dist/esm/setup/config.js

@@ -26,7 +26,7 @@ Options:
   --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)
+  --resource-store-uri=<uri>    Resource store URI for CSV file storage (default: file://~/.mcp-z/mcp-gmail/files)
   --base-url=<url>       Base URL for HTTP file serving (optional)
 
 Environment Variables:
@@ -37,9 +37,10 @@ Environment Variables:
   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)
+  TOKEN_STORE_URI        Token storage URI (optional)
   PORT                   Default HTTP port (optional)
   LOG_LEVEL              Default logging level (optional)
-  STORAGE_DIR            Default storage directory (optional)
+  RESOURCE_STORE_URI            Resource store URI (optional, file://)
   BASE_URL               Default base URL for file serving (optional)
 
 OAuth Scopes:
@@ -49,7 +50,7 @@ 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
+  mcp-gmail --resource-store-uri=file:///tmp/emails    # Custom resource store URI
   GOOGLE_CLIENT_ID=xxx mcp-gmail      # Set client ID via env var
 `.trim();
 /**
@@ -94,7 +95,7 @@ Examples:
  * - --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)
+ * - --resource-store-uri=<uri>    Resource store URI for CSV file storage (default: file://~/.mcp-z/mcp-gmail/files)
  * - --base-url=<url>       Base URL for HTTP file serving (optional)
  *
  * Environment Variables:
@@ -105,9 +106,10 @@ Examples:
  * - 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)
+ * - TOKEN_STORE_URI        Token storage URI (optional)
  * - PORT                   Default HTTP port (optional)
  * - LOG_LEVEL              Default logging level (optional)
- * - STORAGE_DIR            Default storage directory (optional)
+ * - RESOURCE_STORE_URI            Resource store URI (optional, file://)
  * - BASE_URL               Default base URL for file serving (optional)
  *
  * OAuth Scopes (from constants.ts):
@@ -118,7 +120,7 @@ Examples:
     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)
+    // Parse application-level config (LOG_LEVEL, RESOURCE_STORE_URI, BASE_URL)
     const { values } = parseArgs({
         args,
         options: {
@@ -128,7 +130,7 @@ Examples:
             'base-url': {
                 type: 'string'
             },
-            'storage-dir': {
+            'resource-store-uri': {
                 type: 'string'
             }
         },
@@ -155,10 +157,10 @@ Examples:
     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 cliResourceStoreUri = typeof values['resource-store-uri'] === 'string' ? values['resource-store-uri'] : undefined;
+    const envResourceStoreUri = env.RESOURCE_STORE_URI;
+    const defaultResourceStorePath = path.join(baseDir, name, 'files');
+    const resourceStoreUri = normalizeResourceStoreUri((_ref2 = cliResourceStoreUri !== null && cliResourceStoreUri !== void 0 ? cliResourceStoreUri : envResourceStoreUri) !== null && _ref2 !== void 0 ? _ref2 : defaultResourceStorePath);
     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;
@@ -171,7 +173,7 @@ Examples:
         name,
         version: pkg.version,
         repositoryUrl,
-        storageDir: path.resolve(storageDir)
+        resourceStoreUri
     };
     if (baseUrl) result.baseUrl = baseUrl;
     if (dcrConfig !== undefined) result.dcrConfig = dcrConfig;
@@ -183,3 +185,14 @@ Examples:
  */ export function createConfig() {
     return parseConfig(process.argv, process.env);
 }
+function normalizeResourceStoreUri(resourceStoreUri) {
+    const filePrefix = 'file://';
+    if (resourceStoreUri.startsWith(filePrefix)) {
+        const rawPath = resourceStoreUri.slice(filePrefix.length);
+        const expandedPath = rawPath.startsWith('~') ? rawPath.replace(/^~/, homedir()) : rawPath;
+        return `${filePrefix}${path.resolve(expandedPath)}`;
+    }
+    if (resourceStoreUri.includes('://')) return resourceStoreUri;
+    const expandedPath = resourceStoreUri.startsWith('~') ? resourceStoreUri.replace(/^~/, homedir()) : resourceStoreUri;
+    return `${filePrefix}${path.resolve(expandedPath)}`;
+}

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-gmail/src/setup/config.ts"],"sourcesContent":["import { parseDcrConfig, parseConfig as parseOAuthConfig } from '@mcp-z/oauth-google';\nimport { findConfigPath, 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.ts';\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      'base-url': { type: 'string' },\n      'storage-dir': { 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  let rootDir = homedir();\n  try {\n    const configPath = findConfigPath({ config: '.mcp.json', cwd: process.cwd(), stopDir: homedir() });\n    rootDir = path.dirname(configPath);\n  } catch {\n    rootDir = homedir();\n  }\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","findConfigPath","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","configPath","config","cwd","process","stopDir","dirname","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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"}
+{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-gmail/src/setup/config.ts"],"sourcesContent":["import { parseDcrConfig, parseConfig as parseOAuthConfig } from '@mcp-z/oauth-google';\nimport { findConfigPath, 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.ts';\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  --resource-store-uri=<uri>    Resource store URI for CSV file storage (default: file://~/.mcp-z/mcp-gmail/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  TOKEN_STORE_URI        Token storage URI (optional)\n  PORT                   Default HTTP port (optional)\n  LOG_LEVEL              Default logging level (optional)\n  RESOURCE_STORE_URI            Resource store URI (optional, file://)\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 --resource-store-uri=file:///tmp/emails    # Custom resource store URI\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 * - --resource-store-uri=<uri>    Resource store URI for CSV file storage (default: file://~/.mcp-z/mcp-gmail/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 * - TOKEN_STORE_URI        Token storage URI (optional)\n * - PORT                   Default HTTP port (optional)\n * - LOG_LEVEL              Default logging level (optional)\n * - RESOURCE_STORE_URI            Resource store URI (optional, file://)\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, RESOURCE_STORE_URI, BASE_URL)\n  const { values } = parseArgs({\n    args,\n    options: {\n      'log-level': { type: 'string' },\n      'base-url': { type: 'string' },\n      'resource-store-uri': { 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  let rootDir = homedir();\n  try {\n    const configPath = findConfigPath({ config: '.mcp.json', cwd: process.cwd(), stopDir: homedir() });\n    rootDir = path.dirname(configPath);\n  } catch {\n    rootDir = homedir();\n  }\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 cliResourceStoreUri = typeof values['resource-store-uri'] === 'string' ? values['resource-store-uri'] : undefined;\n  const envResourceStoreUri = env.RESOURCE_STORE_URI;\n  const defaultResourceStorePath = path.join(baseDir, name, 'files');\n  const resourceStoreUri = normalizeResourceStoreUri(cliResourceStoreUri ?? envResourceStoreUri ?? defaultResourceStorePath);\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    resourceStoreUri,\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\nfunction normalizeResourceStoreUri(resourceStoreUri: string): string {\n  const filePrefix = 'file://';\n  if (resourceStoreUri.startsWith(filePrefix)) {\n    const rawPath = resourceStoreUri.slice(filePrefix.length);\n    const expandedPath = rawPath.startsWith('~') ? rawPath.replace(/^~/, homedir()) : rawPath;\n    return `${filePrefix}${path.resolve(expandedPath)}`;\n  }\n\n  if (resourceStoreUri.includes('://')) return resourceStoreUri;\n\n  const expandedPath = resourceStoreUri.startsWith('~') ? resourceStoreUri.replace(/^~/, homedir()) : resourceStoreUri;\n  return `${filePrefix}${path.resolve(expandedPath)}`;\n}\n"],"names":["parseDcrConfig","parseConfig","parseOAuthConfig","findConfigPath","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","cliResourceStoreUri","transportConfig","oauthConfig","dcrConfig","auth","undefined","allowPositionals","name","replace","rawRepoUrl","repository","repositoryUrl","rootDir","configPath","config","cwd","process","stopDir","dirname","baseDir","envLogLevel","LOG_LEVEL","logLevel","envResourceStoreUri","RESOURCE_STORE_URI","defaultResourceStorePath","resourceStoreUri","normalizeResourceStoreUri","cliBaseUrl","envBaseUrl","BASE_URL","baseUrl","result","transport","createConfig","argv","filePrefix","startsWith","rawPath","slice","length","expandedPath","resolve","includes"],"mappings":"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"}

package/dist/esm/setup/http.js

@@ -36,7 +36,7 @@ export async function createHTTPServer(config, overrides) {
         logger.info('Mounted loopback OAuth callback router');
     }
     const fileRouter = createFileServingRouter({
-        storageDir: config.storageDir
+        resourceStoreUri: config.resourceStoreUri
     }, {
         contentType: 'text/csv',
         contentDisposition: 'attachment'

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/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.ts';\nimport { createDefaultRuntime } from './runtime.ts';\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  if (runtime.deps.oauthAdapters.loopbackRouter) {\n    app.use('/', runtime.deps.oauthAdapters.loopbackRouter);\n    logger.info('Mounted loopback OAuth callback router');\n  }\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","loopbackRouter","info","fileRouter","storageDir","contentType","contentDisposition","dcrRouter","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,IAAIzB,QAAQO,IAAI,CAACO,aAAa,CAACY,cAAc,EAAE;QAC7CJ,IAAIC,GAAG,CAAC,KAAKvB,QAAQO,IAAI,CAACO,aAAa,CAACY,cAAc;QACtDjB,OAAOkB,IAAI,CAAC;IACd;IAEA,MAAMC,aAAavC,wBAAwB;QAAEwC,YAAY/B,OAAO+B,UAAU;IAAC,GAAG;QAAEC,aAAa;QAAYC,oBAAoB;IAAa;IAC1IT,IAAIC,GAAG,CAAC,UAAUK;IAElB,IAAI5B,QAAQO,IAAI,CAACO,aAAa,CAACkB,SAAS,EAAE;QACxCV,IAAIC,GAAG,CAAC,KAAKvB,QAAQO,IAAI,CAACO,aAAa,CAACkB,SAAS;QACjDvB,OAAOkB,IAAI,CAAC;IACd;IAEAlB,OAAOkB,IAAI,CAAC,CAAC,SAAS,EAAE7B,OAAOqB,IAAI,CAAC,kBAAkB,CAAC;IACvD,MAAM,EAAEc,KAAK,EAAEC,UAAU,EAAE,GAAG,MAAM9C,YAAY8B,WAAW;QAAET;QAAQa;QAAKZ;IAAK;IAC/ED,OAAOkB,IAAI,CAAC;IAEZ,OAAO;QACLO;QACAhB;QACAT;QACAwB,OAAO;YACL,MAAMA;YACN,MAAMjC,QAAQiC,KAAK;QACrB;IACF;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/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.ts';\nimport { createDefaultRuntime } from './runtime.ts';\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  if (runtime.deps.oauthAdapters.loopbackRouter) {\n    app.use('/', runtime.deps.oauthAdapters.loopbackRouter);\n    logger.info('Mounted loopback OAuth callback router');\n  }\n\n  const fileRouter = createFileServingRouter({ resourceStoreUri: config.resourceStoreUri }, { 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","loopbackRouter","info","fileRouter","resourceStoreUri","contentType","contentDisposition","dcrRouter","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,IAAIzB,QAAQO,IAAI,CAACO,aAAa,CAACY,cAAc,EAAE;QAC7CJ,IAAIC,GAAG,CAAC,KAAKvB,QAAQO,IAAI,CAACO,aAAa,CAACY,cAAc;QACtDjB,OAAOkB,IAAI,CAAC;IACd;IAEA,MAAMC,aAAavC,wBAAwB;QAAEwC,kBAAkB/B,OAAO+B,gBAAgB;IAAC,GAAG;QAAEC,aAAa;QAAYC,oBAAoB;IAAa;IACtJT,IAAIC,GAAG,CAAC,UAAUK;IAElB,IAAI5B,QAAQO,IAAI,CAACO,aAAa,CAACkB,SAAS,EAAE;QACxCV,IAAIC,GAAG,CAAC,KAAKvB,QAAQO,IAAI,CAACO,aAAa,CAACkB,SAAS;QACjDvB,OAAOkB,IAAI,CAAC;IACd;IAEAlB,OAAOkB,IAAI,CAAC,CAAC,SAAS,EAAE7B,OAAOqB,IAAI,CAAC,kBAAkB,CAAC;IACvD,MAAM,EAAEc,KAAK,EAAEC,UAAU,EAAE,GAAG,MAAM9C,YAAY8B,WAAW;QAAET;QAAQa;QAAKZ;IAAK;IAC/ED,OAAOkB,IAAI,CAAC;IAEZ,OAAO;QACLO;QACAhB;QACAT;QACAwB,OAAO;YACL,MAAMA;YACN,MAAMjC,QAAQiC,KAAK;QACrB;IACF;AACF"}

package/dist/esm/setup/runtime.js

@@ -22,8 +22,8 @@ export function createLogger(config) {
     }) : pino.destination(1));
 }
 export async function createTokenStore(baseDir) {
-    const storeUri = process.env.STORE_URI || `file://${path.join(baseDir, 'tokens.json')}`;
-    return createStore(storeUri);
+    const tokenStoreUri = process.env.TOKEN_STORE_URI || `file://${path.join(baseDir, 'tokens.json')}`;
+    return createStore(tokenStoreUri);
 }
 export async function createDcrStore(baseDir, required) {
     if (!required) return undefined;
@@ -65,8 +65,8 @@ export function createStorageLayer(storageContext) {
     };
 }
 export function assertStorageConfig(config) {
-    if (!config.storageDir) {
-        throw new Error('gmail-messages-export-csv: Server configuration missing storageDir.');
+    if (!config.resourceStoreUri) {
+        throw new Error('gmail-messages-export-csv: Server configuration missing resourceStoreUri.');
     }
     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.');
@@ -101,7 +101,7 @@ export async function createDefaultRuntime(config, overrides) {
         ()=>createAuthLayer(oauthAdapters.middleware),
         ()=>createLoggingLayer(logger),
         ()=>createStorageLayer({
-                storageDir: config.storageDir,
+                resourceStoreUri: config.resourceStoreUri,
                 baseUrl: config.baseUrl,
                 transport: config.transport
             })

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-gmail/src/setup/runtime.ts"],"sourcesContent":["import { sanitizeForLoggingFormatter } from '@mcp-z/oauth';\nimport type { CachedToken } from '@mcp-z/oauth-google';\nimport type { Logger, MiddlewareLayer } from '@mcp-z/server';\nimport { createLoggingMiddleware } from '@mcp-z/server';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport pino from 'pino';\nimport createStore from '../lib/create-store.ts';\nimport * as mcp from '../mcp/index.ts';\nimport type { CommonRuntime, RuntimeDeps, RuntimeOverrides, ServerConfig, StorageContext } from '../types.ts';\nimport { createOAuthAdapters, type OAuthAdapters } from './oauth-google.ts';\n\nexport function createLogger(config: ServerConfig): Logger {\n  const hasStdio = config.transport.type === 'stdio';\n  const logsPath = path.join(config.baseDir, 'logs', `${config.name}.log`);\n  if (hasStdio) fs.mkdirSync(path.dirname(logsPath), { recursive: true });\n  return pino({ level: config.logLevel ?? 'info', formatters: sanitizeForLoggingFormatter() }, hasStdio ? pino.destination({ dest: logsPath, sync: false }) : pino.destination(1));\n}\n\nexport async function createTokenStore(baseDir: string) {\n  const storeUri = process.env.STORE_URI || `file://${path.join(baseDir, 'tokens.json')}`;\n  return createStore<CachedToken>(storeUri);\n}\n\nexport async function createDcrStore(baseDir: string, required: boolean) {\n  if (!required) return undefined;\n  const dcrStoreUri = process.env.DCR_STORE_URI || `file://${path.join(baseDir, 'dcr.json')}`;\n  return createStore<unknown>(dcrStoreUri);\n}\n\nexport function createAuthLayer(authMiddleware: OAuthAdapters['middleware']): MiddlewareLayer {\n  return {\n    withTool: authMiddleware.withToolAuth,\n    withResource: authMiddleware.withResourceAuth,\n    withPrompt: authMiddleware.withPromptAuth,\n  };\n}\n\nexport function createLoggingLayer(logger: Logger): MiddlewareLayer {\n  const logging = createLoggingMiddleware({ logger });\n  return {\n    withTool: logging.withToolLogging,\n    withResource: logging.withResourceLogging,\n    withPrompt: logging.withPromptLogging,\n  };\n}\n\nexport function createStorageLayer(storageContext: StorageContext): MiddlewareLayer {\n  const wrapAtPosition = <T extends { name: string; handler: unknown; [key: string]: unknown }>(module: T, extraPosition: number): T => {\n    const originalHandler = module.handler as (...args: unknown[]) => Promise<unknown>;\n\n    const wrappedHandler = async (...allArgs: unknown[]) => {\n      const extra = allArgs[extraPosition];\n      (extra as { storageContext?: StorageContext }).storageContext = storageContext;\n      return await originalHandler(...allArgs);\n    };\n\n    return {\n      ...module,\n      handler: wrappedHandler,\n    } as T;\n  };\n\n  return {\n    withTool: <T extends { name: string; config: unknown; handler: unknown }>(module: T): T => wrapAtPosition(module, 1) as T,\n  };\n}\n\nexport function assertStorageConfig(config: ServerConfig) {\n  if (!config.storageDir) {\n    throw new Error('gmail-messages-export-csv: Server configuration missing storageDir.');\n  }\n  if (config.transport.type === 'http' && !config.baseUrl && !config.transport.port) {\n    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.');\n  }\n}\n\nexport async function createDefaultRuntime(config: ServerConfig, overrides?: RuntimeOverrides): Promise<CommonRuntime> {\n  if (config.auth === 'dcr' && config.transport.type !== 'http') throw new Error('DCR mode requires an HTTP transport');\n\n  assertStorageConfig(config);\n  const logger = createLogger(config);\n  const tokenStore = await createTokenStore(config.baseDir);\n  const baseUrl = config.baseUrl ?? (config.transport.type === 'http' && config.transport.port ? `http://localhost:${config.transport.port}` : undefined);\n  const dcrStore = await createDcrStore(config.baseDir, config.auth === 'dcr');\n  const oauthAdapters = await createOAuthAdapters(config, { logger, tokenStore, dcrStore }, baseUrl);\n  const deps: RuntimeDeps = { config, logger, tokenStore, oauthAdapters, baseUrl };\n  const createDomainModules =\n    overrides?.createDomainModules ??\n    (() => ({\n      tools: Object.values(mcp.toolFactories).map((factory) => factory()),\n      resources: Object.values(mcp.resourceFactories).map((factory) => factory()),\n      prompts: Object.values(mcp.promptFactories).map((factory) => factory()),\n    }));\n  const middlewareFactories = overrides?.middlewareFactories ?? [() => createAuthLayer(oauthAdapters.middleware), () => createLoggingLayer(logger), () => createStorageLayer({ storageDir: config.storageDir, baseUrl: config.baseUrl, transport: config.transport })];\n\n  return {\n    deps,\n    middlewareFactories,\n    createDomainModules,\n    close: async () => {},\n  };\n}\n"],"names":["sanitizeForLoggingFormatter","createLoggingMiddleware","fs","path","pino","createStore","mcp","createOAuthAdapters","createLogger","config","hasStdio","transport","type","logsPath","join","baseDir","name","mkdirSync","dirname","recursive","level","logLevel","formatters","destination","dest","sync","createTokenStore","storeUri","process","env","STORE_URI","createDcrStore","required","undefined","dcrStoreUri","DCR_STORE_URI","createAuthLayer","authMiddleware","withTool","withToolAuth","withResource","withResourceAuth","withPrompt","withPromptAuth","createLoggingLayer","logger","logging","withToolLogging","withResourceLogging","withPromptLogging","createStorageLayer","storageContext","wrapAtPosition","module","extraPosition","originalHandler","handler","wrappedHandler","allArgs","extra","assertStorageConfig","storageDir","Error","baseUrl","port","createDefaultRuntime","overrides","auth","tokenStore","dcrStore","oauthAdapters","deps","createDomainModules","tools","Object","values","toolFactories","map","factory","resources","resourceFactories","prompts","promptFactories","middlewareFactories","middleware","close"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-gmail/src/setup/runtime.ts"],"sourcesContent":["import { sanitizeForLoggingFormatter } from '@mcp-z/oauth';\nimport type { CachedToken } from '@mcp-z/oauth-google';\nimport type { Logger, MiddlewareLayer } from '@mcp-z/server';\nimport { createLoggingMiddleware } from '@mcp-z/server';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport pino from 'pino';\nimport createStore from '../lib/create-store.ts';\nimport * as mcp from '../mcp/index.ts';\nimport type { CommonRuntime, RuntimeDeps, RuntimeOverrides, ServerConfig, StorageContext } from '../types.ts';\nimport { createOAuthAdapters, type OAuthAdapters } from './oauth-google.ts';\n\nexport function createLogger(config: ServerConfig): Logger {\n  const hasStdio = config.transport.type === 'stdio';\n  const logsPath = path.join(config.baseDir, 'logs', `${config.name}.log`);\n  if (hasStdio) fs.mkdirSync(path.dirname(logsPath), { recursive: true });\n  return pino({ level: config.logLevel ?? 'info', formatters: sanitizeForLoggingFormatter() }, hasStdio ? pino.destination({ dest: logsPath, sync: false }) : pino.destination(1));\n}\n\nexport async function createTokenStore(baseDir: string) {\n  const tokenStoreUri = process.env.TOKEN_STORE_URI || `file://${path.join(baseDir, 'tokens.json')}`;\n  return createStore<CachedToken>(tokenStoreUri);\n}\n\nexport async function createDcrStore(baseDir: string, required: boolean) {\n  if (!required) return undefined;\n  const dcrStoreUri = process.env.DCR_STORE_URI || `file://${path.join(baseDir, 'dcr.json')}`;\n  return createStore<unknown>(dcrStoreUri);\n}\n\nexport function createAuthLayer(authMiddleware: OAuthAdapters['middleware']): MiddlewareLayer {\n  return {\n    withTool: authMiddleware.withToolAuth,\n    withResource: authMiddleware.withResourceAuth,\n    withPrompt: authMiddleware.withPromptAuth,\n  };\n}\n\nexport function createLoggingLayer(logger: Logger): MiddlewareLayer {\n  const logging = createLoggingMiddleware({ logger });\n  return {\n    withTool: logging.withToolLogging,\n    withResource: logging.withResourceLogging,\n    withPrompt: logging.withPromptLogging,\n  };\n}\n\nexport function createStorageLayer(storageContext: StorageContext): MiddlewareLayer {\n  const wrapAtPosition = <T extends { name: string; handler: unknown; [key: string]: unknown }>(module: T, extraPosition: number): T => {\n    const originalHandler = module.handler as (...args: unknown[]) => Promise<unknown>;\n\n    const wrappedHandler = async (...allArgs: unknown[]) => {\n      const extra = allArgs[extraPosition];\n      (extra as { storageContext?: StorageContext }).storageContext = storageContext;\n      return await originalHandler(...allArgs);\n    };\n\n    return {\n      ...module,\n      handler: wrappedHandler,\n    } as T;\n  };\n\n  return {\n    withTool: <T extends { name: string; config: unknown; handler: unknown }>(module: T): T => wrapAtPosition(module, 1) as T,\n  };\n}\n\nexport function assertStorageConfig(config: ServerConfig) {\n  if (!config.resourceStoreUri) {\n    throw new Error('gmail-messages-export-csv: Server configuration missing resourceStoreUri.');\n  }\n  if (config.transport.type === 'http' && !config.baseUrl && !config.transport.port) {\n    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.');\n  }\n}\n\nexport async function createDefaultRuntime(config: ServerConfig, overrides?: RuntimeOverrides): Promise<CommonRuntime> {\n  if (config.auth === 'dcr' && config.transport.type !== 'http') throw new Error('DCR mode requires an HTTP transport');\n\n  assertStorageConfig(config);\n  const logger = createLogger(config);\n  const tokenStore = await createTokenStore(config.baseDir);\n  const baseUrl = config.baseUrl ?? (config.transport.type === 'http' && config.transport.port ? `http://localhost:${config.transport.port}` : undefined);\n  const dcrStore = await createDcrStore(config.baseDir, config.auth === 'dcr');\n  const oauthAdapters = await createOAuthAdapters(config, { logger, tokenStore, dcrStore }, baseUrl);\n  const deps: RuntimeDeps = { config, logger, tokenStore, oauthAdapters, baseUrl };\n  const createDomainModules =\n    overrides?.createDomainModules ??\n    (() => ({\n      tools: Object.values(mcp.toolFactories).map((factory) => factory()),\n      resources: Object.values(mcp.resourceFactories).map((factory) => factory()),\n      prompts: Object.values(mcp.promptFactories).map((factory) => factory()),\n    }));\n  const middlewareFactories = overrides?.middlewareFactories ?? [() => createAuthLayer(oauthAdapters.middleware), () => createLoggingLayer(logger), () => createStorageLayer({ resourceStoreUri: config.resourceStoreUri, baseUrl: config.baseUrl, transport: config.transport })];\n\n  return {\n    deps,\n    middlewareFactories,\n    createDomainModules,\n    close: async () => {},\n  };\n}\n"],"names":["sanitizeForLoggingFormatter","createLoggingMiddleware","fs","path","pino","createStore","mcp","createOAuthAdapters","createLogger","config","hasStdio","transport","type","logsPath","join","baseDir","name","mkdirSync","dirname","recursive","level","logLevel","formatters","destination","dest","sync","createTokenStore","tokenStoreUri","process","env","TOKEN_STORE_URI","createDcrStore","required","undefined","dcrStoreUri","DCR_STORE_URI","createAuthLayer","authMiddleware","withTool","withToolAuth","withResource","withResourceAuth","withPrompt","withPromptAuth","createLoggingLayer","logger","logging","withToolLogging","withResourceLogging","withPromptLogging","createStorageLayer","storageContext","wrapAtPosition","module","extraPosition","originalHandler","handler","wrappedHandler","allArgs","extra","assertStorageConfig","resourceStoreUri","Error","baseUrl","port","createDefaultRuntime","overrides","auth","tokenStore","dcrStore","oauthAdapters","deps","createDomainModules","tools","Object","values","toolFactories","map","factory","resources","resourceFactories","prompts","promptFactories","middlewareFactories","middleware","close"],"mappings":"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"}

package/dist/esm/types.d.ts

@@ -12,12 +12,12 @@ export interface ServerConfig extends BaseServerConfig, OAuthConfig {
     name: string;
     version: string;
     repositoryUrl: string;
-    storageDir: string;
+    resourceStoreUri: string;
     baseUrl?: string;
     dcrConfig?: DcrConfig;
 }
 export interface StorageContext {
-    storageDir: string;
+    resourceStoreUri: string;
     baseUrl?: string;
     transport: BaseServerConfig['transport'];
 }

package/dist/esm/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-gmail/src/types.ts"],"sourcesContent":["import type { CachedToken, DcrConfig, OAuthConfig } from '@mcp-z/oauth-google';\nimport type { BaseServerConfig, MiddlewareLayer, PromptModule, ResourceModule, Logger as ServerLogger, ToolModule } from '@mcp-z/server';\nimport type { Keyv } from 'keyv';\nimport type { OAuthAdapters } from './setup/oauth-google.ts';\n\nexport type Logger = Pick<Console, 'info' | 'error' | 'warn' | 'debug'>;\n\n/**\n * Composes transport config, OAuth config, and application-level config\n */\nexport interface ServerConfig extends BaseServerConfig, OAuthConfig {\n  logLevel: string;\n  baseDir: string;\n  name: string;\n  version: string;\n  repositoryUrl: string;\n\n  // File serving configuration for CSV exports\n  storageDir: string;\n  baseUrl?: string;\n\n  // DCR configuration (when auth === 'dcr')\n  dcrConfig?: DcrConfig;\n}\n\nexport interface StorageContext {\n  storageDir: string;\n  baseUrl?: string;\n  transport: BaseServerConfig['transport'];\n}\n\nexport interface StorageExtra {\n  storageContext: StorageContext;\n}\n\n/** Runtime dependencies exposed to middleware/factories. */\nexport interface RuntimeDeps {\n  config: ServerConfig;\n  logger: ServerLogger;\n  tokenStore: Keyv<CachedToken>;\n  oauthAdapters: OAuthAdapters;\n  baseUrl?: string;\n}\n\n/** Collections of MCP modules produced by domain factories. */\nexport type DomainModules = {\n  tools: ToolModule[];\n  resources: ResourceModule[];\n  prompts: PromptModule[];\n};\n\n/** Factory that produces a middleware layer given runtime dependencies. */\nexport type MiddlewareFactory = (deps: RuntimeDeps) => MiddlewareLayer;\n\n/** Shared runtime configuration returned by `createDefaultRuntime`. */\nexport interface CommonRuntime {\n  deps: RuntimeDeps;\n  middlewareFactories: MiddlewareFactory[];\n  createDomainModules: () => DomainModules;\n  close: () => Promise<void>;\n}\n\nexport interface RuntimeOverrides {\n  middlewareFactories?: MiddlewareFactory[];\n  createDomainModules?: () => DomainModules;\n}\n\nexport type { GmailQuery } from './schemas/index.ts';\n"],"names":[],"mappings":"AAmEA,WAAqD"}
+{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-gmail/src/types.ts"],"sourcesContent":["import type { CachedToken, DcrConfig, OAuthConfig } from '@mcp-z/oauth-google';\nimport type { BaseServerConfig, MiddlewareLayer, PromptModule, ResourceModule, Logger as ServerLogger, ToolModule } from '@mcp-z/server';\nimport type { Keyv } from 'keyv';\nimport type { OAuthAdapters } from './setup/oauth-google.ts';\n\nexport type Logger = Pick<Console, 'info' | 'error' | 'warn' | 'debug'>;\n\n/**\n * Composes transport config, OAuth config, and application-level config\n */\nexport interface ServerConfig extends BaseServerConfig, OAuthConfig {\n  logLevel: string;\n  baseDir: string;\n  name: string;\n  version: string;\n  repositoryUrl: string;\n\n  // File serving configuration for CSV exports\n  resourceStoreUri: string;\n  baseUrl?: string;\n\n  // DCR configuration (when auth === 'dcr')\n  dcrConfig?: DcrConfig;\n}\n\nexport interface StorageContext {\n  resourceStoreUri: string;\n  baseUrl?: string;\n  transport: BaseServerConfig['transport'];\n}\n\nexport interface StorageExtra {\n  storageContext: StorageContext;\n}\n\n/** Runtime dependencies exposed to middleware/factories. */\nexport interface RuntimeDeps {\n  config: ServerConfig;\n  logger: ServerLogger;\n  tokenStore: Keyv<CachedToken>;\n  oauthAdapters: OAuthAdapters;\n  baseUrl?: string;\n}\n\n/** Collections of MCP modules produced by domain factories. */\nexport type DomainModules = {\n  tools: ToolModule[];\n  resources: ResourceModule[];\n  prompts: PromptModule[];\n};\n\n/** Factory that produces a middleware layer given runtime dependencies. */\nexport type MiddlewareFactory = (deps: RuntimeDeps) => MiddlewareLayer;\n\n/** Shared runtime configuration returned by `createDefaultRuntime`. */\nexport interface CommonRuntime {\n  deps: RuntimeDeps;\n  middlewareFactories: MiddlewareFactory[];\n  createDomainModules: () => DomainModules;\n  close: () => Promise<void>;\n}\n\nexport interface RuntimeOverrides {\n  middlewareFactories?: MiddlewareFactory[];\n  createDomainModules?: () => DomainModules;\n}\n\nexport type { GmailQuery } from './schemas/index.ts';\n"],"names":[],"mappings":"AAmEA,WAAqD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-z/mcp-gmail",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "MCP server for Gmail integration with OAuth authentication, message search, batch operations, and Google Sheets export",
   "keywords": [
     "gmail",
@@ -59,7 +59,7 @@
     "bin"
   ],
   "scripts": {
-    "build": "tsc -p . --noEmit && tsds build",
+    "build": "tsds validate",
     "format": "tsds format",
     "prepublish:check": "ncp",
     "prepublishOnly": "tsds validate",
@@ -72,33 +72,32 @@
   },
   "dependencies": {
     "@mcp-z/email": "^1.0.0",
-    "@mcp-z/oauth": "^1.0.1",
-    "@mcp-z/oauth-google": "^1.0.3",
-    "@mcp-z/server": "^1.0.2",
-    "@modelcontextprotocol/sdk": "^1.25.1",
-    "cors": "^2.8.5",
-    "csv-stringify": "^6.6.0",
-    "express": "^5.2.1",
+    "@mcp-z/oauth": "^1.0.0",
+    "@mcp-z/oauth-google": "^1.0.0",
+    "@mcp-z/server": "^1.0.0",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "cors": "^2.0.0",
+    "csv-stringify": "^6.0.0",
+    "express": "^5.0.0",
     "googleapis": "^169.0.0",
-    "keyv-registry": "^0.4.0",
-    "module-root-sync": "^2.0.2",
-    "node-html-parser": "^7.0.1",
-    "pino": "^10.1.0",
-    "zod": "^4.3.4"
+    "keyv-registry": "^1.0.0",
+    "module-root-sync": "^2.0.0",
+    "node-html-parser": "^7.0.0",
+    "pino": "^10.0.0",
+    "zod": "^4.0.0"
   },
   "devDependencies": {
-    "@mcp-z/client": "^1.0.3",
+    "@mcp-z/client": "^1.0.5",
     "@types/cors": "^2.8.19",
     "@types/express": "^5.0.6",
     "@types/mocha": "^10.0.10",
     "@types/node": "^25.0.3",
     "dotenv": "^17.2.3",
     "get-port": "^7.1.0",
-    "keyv": "^5.5.5",
+    "keyv": "^5.0.0",
     "node-version-use": "^2.4.7",
     "ts-dev-stack": "^1.22.1",
-    "tsds-config": "^1.0.4",
-    "typescript": "^5.9.3"
+    "tsds-config": "^1.0.4"
   },
   "engines": {
     "node": ">=20"