@mcp-z/mcp-outlook 2.4.1 → 2.4.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (78) hide show
  1. package/README.md +5 -1
  2. package/dist/cjs/constants.d.cts +1 -0
  3. package/dist/cjs/constants.d.ts +1 -0
  4. package/dist/cjs/constants.js +4 -0
  5. package/dist/cjs/constants.js.map +1 -1
  6. package/dist/cjs/email/querying/next-link.d.cts +5 -0
  7. package/dist/cjs/email/querying/next-link.d.ts +5 -0
  8. package/dist/cjs/email/querying/next-link.js +30 -0
  9. package/dist/cjs/email/querying/next-link.js.map +1 -0
  10. package/dist/cjs/email/querying/pagination-token.d.cts +3 -4
  11. package/dist/cjs/email/querying/pagination-token.d.ts +3 -4
  12. package/dist/cjs/email/querying/pagination-token.js +71 -49
  13. package/dist/cjs/email/querying/pagination-token.js.map +1 -1
  14. package/dist/cjs/email/querying/paging-decisions.d.cts +14 -0
  15. package/dist/cjs/email/querying/paging-decisions.d.ts +14 -0
  16. package/dist/cjs/email/querying/paging-decisions.js +91 -0
  17. package/dist/cjs/email/querying/paging-decisions.js.map +1 -0
  18. package/dist/cjs/email/querying/search-execution.js +130 -88
  19. package/dist/cjs/email/querying/search-execution.js.map +1 -1
  20. package/dist/cjs/lib/create-store.js +1 -1
  21. package/dist/cjs/lib/create-store.js.map +1 -1
  22. package/dist/cjs/mcp/tools/message-search.d.cts +1 -1
  23. package/dist/cjs/mcp/tools/message-search.d.ts +1 -1
  24. package/dist/cjs/mcp/tools/message-search.js +1 -1
  25. package/dist/cjs/mcp/tools/message-search.js.map +1 -1
  26. package/dist/cjs/mcp/tools/messages-export-csv.js +10 -6
  27. package/dist/cjs/mcp/tools/messages-export-csv.js.map +1 -1
  28. package/dist/cjs/setup/config.d.cts +2 -6
  29. package/dist/cjs/setup/config.d.ts +2 -6
  30. package/dist/cjs/setup/config.js +22 -0
  31. package/dist/cjs/setup/config.js.map +1 -1
  32. package/dist/cjs/setup/http.js +2 -1
  33. package/dist/cjs/setup/http.js.map +1 -1
  34. package/dist/cjs/setup/oauth-microsoft.d.cts +6 -1
  35. package/dist/cjs/setup/oauth-microsoft.d.ts +6 -1
  36. package/dist/cjs/setup/oauth-microsoft.js +5 -1
  37. package/dist/cjs/setup/oauth-microsoft.js.map +1 -1
  38. package/dist/cjs/setup/runtime.d.cts +1 -1
  39. package/dist/cjs/setup/runtime.d.ts +1 -1
  40. package/dist/cjs/setup/runtime.js +11 -6
  41. package/dist/cjs/setup/runtime.js.map +1 -1
  42. package/dist/cjs/setup/version-help.js +1 -1
  43. package/dist/cjs/setup/version-help.js.map +1 -1
  44. package/dist/esm/constants.d.ts +1 -0
  45. package/dist/esm/constants.js +2 -0
  46. package/dist/esm/constants.js.map +1 -1
  47. package/dist/esm/email/querying/next-link.d.ts +5 -0
  48. package/dist/esm/email/querying/next-link.js +22 -0
  49. package/dist/esm/email/querying/next-link.js.map +1 -0
  50. package/dist/esm/email/querying/pagination-token.d.ts +3 -4
  51. package/dist/esm/email/querying/pagination-token.js +22 -44
  52. package/dist/esm/email/querying/pagination-token.js.map +1 -1
  53. package/dist/esm/email/querying/paging-decisions.d.ts +14 -0
  54. package/dist/esm/email/querying/paging-decisions.js +21 -0
  55. package/dist/esm/email/querying/paging-decisions.js.map +1 -0
  56. package/dist/esm/email/querying/search-execution.js +82 -77
  57. package/dist/esm/email/querying/search-execution.js.map +1 -1
  58. package/dist/esm/lib/create-store.js +1 -1
  59. package/dist/esm/lib/create-store.js.map +1 -1
  60. package/dist/esm/mcp/tools/message-search.d.ts +1 -1
  61. package/dist/esm/mcp/tools/message-search.js +1 -1
  62. package/dist/esm/mcp/tools/message-search.js.map +1 -1
  63. package/dist/esm/mcp/tools/messages-export-csv.js +10 -6
  64. package/dist/esm/mcp/tools/messages-export-csv.js.map +1 -1
  65. package/dist/esm/setup/config.d.ts +2 -6
  66. package/dist/esm/setup/config.js +24 -6
  67. package/dist/esm/setup/config.js.map +1 -1
  68. package/dist/esm/setup/http.js +2 -1
  69. package/dist/esm/setup/http.js.map +1 -1
  70. package/dist/esm/setup/oauth-microsoft.d.ts +6 -1
  71. package/dist/esm/setup/oauth-microsoft.js +6 -2
  72. package/dist/esm/setup/oauth-microsoft.js.map +1 -1
  73. package/dist/esm/setup/runtime.d.ts +1 -1
  74. package/dist/esm/setup/runtime.js +11 -5
  75. package/dist/esm/setup/runtime.js.map +1 -1
  76. package/dist/esm/setup/version-help.js +3 -7
  77. package/dist/esm/setup/version-help.js.map +1 -1
  78. package/package.json +10 -4
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-outlook/src/setup/runtime.ts"],"sourcesContent":["import { pathToFileURL } from 'node:url';\nimport { sanitizeForLoggingFormatter } from '@mcp-z/oauth';\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-microsoft.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, logger: Logger) {\n const tokenStoreUri = process.env.TOKEN_STORE_URI || pathToFileURL(path.join(baseDir, 'tokens.json')).href;\n return createStore<unknown>(tokenStoreUri, logger);\n}\n\nexport async function createDcrStore(baseDir: string, required: boolean, logger: Logger) {\n if (!required) return undefined;\n const dcrStoreUri = process.env.DCR_STORE_URI || pathToFileURL(path.join(baseDir, 'dcr.json')).href;\n return createStore<unknown>(dcrStoreUri, logger);\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 validateStorageConfig(config: ServerConfig, logger: Logger) {\n if (config.auth === 'dcr') {\n if (config.resourceStoreUri) {\n logger.warn('DCR mode does not support file storage; resourceStoreUri will be ignored.');\n }\n return;\n }\n if (!config.resourceStoreUri) {\n throw new Error('outlook-messages-export-csv: Server configuration missing resourceStoreUri.');\n }\n if (config.transport.type === 'http' && !config.baseUrl && !config.transport.port) {\n throw new Error('outlook-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 const logger = createLogger(config);\n validateStorageConfig(config, logger);\n const tokenStore = await createTokenStore(config.baseDir, logger);\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', logger);\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), ...(config.auth === 'dcr' ? [] : [() => 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":["createAuthLayer","createDcrStore","createDefaultRuntime","createLogger","createLoggingLayer","createStorageLayer","createTokenStore","validateStorageConfig","config","hasStdio","transport","type","logsPath","path","join","baseDir","name","fs","mkdirSync","dirname","recursive","pino","level","logLevel","formatters","sanitizeForLoggingFormatter","destination","dest","sync","logger","tokenStoreUri","process","env","TOKEN_STORE_URI","pathToFileURL","href","createStore","required","dcrStoreUri","undefined","DCR_STORE_URI","authMiddleware","withTool","withToolAuth","withResource","withResourceAuth","withPrompt","withPromptAuth","logging","createLoggingMiddleware","withToolLogging","withResourceLogging","withPromptLogging","storageContext","wrapAtPosition","module","extraPosition","originalHandler","handler","wrappedHandler","allArgs","extra","auth","resourceStoreUri","warn","Error","baseUrl","port","overrides","tokenStore","dcrStore","oauthAdapters","deps","createDomainModules","middlewareFactories","createOAuthAdapters","tools","Object","values","mcp","toolFactories","map","factory","resources","resourceFactories","prompts","promptFactories","middleware","close"],"mappings":"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"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-outlook/src/setup/runtime.ts"],"sourcesContent":["import { pathToFileURL } from 'node:url';\nimport { sanitizeForLoggingFormatter } from '@mcp-z/oauth';\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 { SHARED_FILE_PROTOCOL } from '../constants.ts';\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-microsoft.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: true }) : pino.destination(1));\n}\n\n// Several mcp-z processes share these files, so the default store merges each write under a lock.\nfunction sharedFileUri(file: string): string {\n return pathToFileURL(file).href.replace(/^file:/, SHARED_FILE_PROTOCOL);\n}\n\nexport async function createTokenStore(baseDir: string, logger: Logger) {\n const tokenStoreUri = process.env.TOKEN_STORE_URI || sharedFileUri(path.join(baseDir, 'tokens.json'));\n return createStore<unknown>(tokenStoreUri, logger);\n}\n\nexport async function createDcrStore(baseDir: string, required: boolean, logger: Logger, storeUri?: string) {\n if (!required) return undefined;\n const dcrStoreUri = storeUri || process.env.DCR_STORE_URI || sharedFileUri(path.join(baseDir, 'dcr.json'));\n return createStore<unknown>(dcrStoreUri, logger);\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 validateStorageConfig(config: ServerConfig, logger: Logger) {\n if (config.auth === 'dcr') {\n if (config.resourceStoreUri) {\n logger.warn('DCR mode does not support file storage; resourceStoreUri will be ignored.');\n }\n return;\n }\n if (!config.resourceStoreUri) {\n throw new Error('outlook-messages-export-csv: Server configuration missing resourceStoreUri.');\n }\n if (config.transport.type === 'http' && !config.baseUrl && !config.transport.port) {\n throw new Error('outlook-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 const logger = createLogger(config);\n validateStorageConfig(config, logger);\n const tokenStore = await createTokenStore(config.baseDir, logger);\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', logger, config.dcrConfig?.storeUri);\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), ...(config.auth === 'dcr' ? [] : [() => 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":["createAuthLayer","createDcrStore","createDefaultRuntime","createLogger","createLoggingLayer","createStorageLayer","createTokenStore","validateStorageConfig","config","hasStdio","transport","type","logsPath","path","join","baseDir","name","fs","mkdirSync","dirname","recursive","pino","level","logLevel","formatters","sanitizeForLoggingFormatter","destination","dest","sync","sharedFileUri","file","pathToFileURL","href","replace","SHARED_FILE_PROTOCOL","logger","tokenStoreUri","process","env","TOKEN_STORE_URI","createStore","required","storeUri","dcrStoreUri","undefined","DCR_STORE_URI","authMiddleware","withTool","withToolAuth","withResource","withResourceAuth","withPrompt","withPromptAuth","logging","createLoggingMiddleware","withToolLogging","withResourceLogging","withPromptLogging","storageContext","wrapAtPosition","module","extraPosition","originalHandler","handler","wrappedHandler","allArgs","extra","auth","resourceStoreUri","warn","Error","baseUrl","port","overrides","tokenStore","dcrStore","oauthAdapters","deps","createDomainModules","middlewareFactories","dcrConfig","createOAuthAdapters","tools","Object","values","mcp","toolFactories","map","factory","resources","resourceFactories","prompts","promptFactories","middleware","close"],"mappings":"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"}
@@ -60,7 +60,7 @@ function _interop_require_wildcard(obj, nodeInterop) {
60
60
  // resolve nothing beyond Node startup: config.ts's parseConfig pulls in @mcp-z/oauth-microsoft
61
61
  // and @mcp-z/server, which this path must not touch.
62
62
  var pkg = JSON.parse(_fs.readFileSync(_path.join((0, _modulerootsync.default)(_url.fileURLToPath(require("url").pathToFileURL(__filename).toString())), 'package.json'), 'utf-8'));
63
- var HELP_TEXT = '\nUsage: mcp-outlook [options]\n\nMCP server for Outlook/Microsoft 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, device-code, dcr\n --headless Disable browser auto-open, return auth URL instead\n --redirect-uri=<uri> OAuth redirect URI (default: ephemeral loopback)\n --tenant-id=<id> Microsoft tenant ID (overrides MS_TENANT_ID env var)\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-outlook/files)\n --base-url=<url> Base URL for HTTP file serving (default: http://localhost for HTTP transports)\n\nEnvironment Variables:\n MS_CLIENT_ID OAuth client ID (REQUIRED)\n MS_TENANT_ID Microsoft tenant ID (REQUIRED)\n MS_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 Base URL for HTTP file serving (optional)\n\nConfiguration Files:\n Variables may also be set in the first of these files that exists:\n 1. .mcp-z/mcp-outlook/.env beside the nearest .mcp.json (else ~/.mcp-z/mcp-outlook/.env)\n 2. ~/.config/mcp-z/mcp-outlook/.env (~ is your home directory, on every OS)\n Values already in the environment, including .mcp.json "env", take precedence.\n On macOS and Linux the file must be private (chmod 600), or the server will not start.\n\nStorage Backends:\n TOKEN_STORE_URI and DCR_STORE_URI accept any keyv-registry protocol.\n file:// (the default) and memory:// work out of the box. Any other backend\n needs its adapter installed alongside this server:\n npm install -g @keyv/redis@6\n TOKEN_STORE_URI=redis://localhost:6379 mcp-outlook\n\nOAuth Scopes:\n openid profile offline_access https://graph.microsoft.com/User.Read https://graph.microsoft.com/Mail.ReadWrite https://graph.microsoft.com/Mail.Send https://graph.microsoft.com/MailboxSettings.ReadWrite\n\nExamples:\n mcp-outlook # Use default settings\n mcp-outlook --auth=device-code # Use device code auth\n mcp-outlook --port=3000 # HTTP transport on port 3000\n mcp-outlook --tenant-id=xxx # Set tenant ID\n mcp-outlook --resource-store-uri=file:///tmp/emails # Custom resource store URI\n MS_CLIENT_ID=xxx mcp-outlook # Set client ID via env var\n'.trim();
63
+ var HELP_TEXT = '\nUsage: mcp-outlook [options]\n\nMCP server for Outlook/Microsoft 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, device-code, dcr\n --headless Disable browser auto-open, return auth URL instead\n --redirect-uri=<uri> OAuth redirect URI (default: ephemeral loopback)\n --tenant-id=<id> Microsoft tenant ID (overrides MS_TENANT_ID env var)\n --dcr-store-uri=<uri> DCR client storage URI (default: .mcp-z/dcr.json)\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: .mcp-z/mcp-outlook/files beside the nearest .mcp.json, else ~/.mcp-z/mcp-outlook/files)\n --base-url=<url> Base URL for HTTP file serving (default: http://localhost for HTTP transports)\n\nEnvironment Variables:\n MS_CLIENT_ID OAuth client ID (REQUIRED)\n MS_TENANT_ID Microsoft tenant ID (REQUIRED)\n MS_CLIENT_SECRET OAuth client secret (optional)\n AUTH_MODE Default authentication mode (optional)\n HEADLESS Disable browser auto-open (optional)\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 Base URL for HTTP file serving (optional)\n\nConfiguration Files:\n Variables may also be set in the first of these files that exists:\n 1. .mcp-z/mcp-outlook/.env beside the nearest .mcp.json (else ~/.mcp-z/mcp-outlook/.env)\n 2. ~/.config/mcp-z/mcp-outlook/.env (~ is your home directory, on every OS)\n Values already in the environment, including .mcp.json "env", take precedence.\n On macOS and Linux the file must be private (chmod 600), or the server will not start.\n\nStorage Backends:\n TOKEN_STORE_URI and DCR_STORE_URI accept any keyv-registry protocol.\n file+shared:// (the default), file:// and memory:// work out of the box. Any other backend\n needs its adapter installed alongside this server:\n npm install -g @keyv/redis@6\n TOKEN_STORE_URI=redis://localhost:6379 mcp-outlook\n\nOAuth Scopes:\n openid profile offline_access https://graph.microsoft.com/User.Read https://graph.microsoft.com/Mail.ReadWrite https://graph.microsoft.com/Mail.Send https://graph.microsoft.com/MailboxSettings.ReadWrite\n\nExamples:\n mcp-outlook # Use default settings\n mcp-outlook --auth=device-code # Use device code auth\n mcp-outlook --port=3000 # HTTP transport on port 3000\n mcp-outlook --tenant-id=xxx # Set tenant ID\n mcp-outlook --resource-store-uri=file:///tmp/emails # Custom resource store URI\n MS_CLIENT_ID=xxx mcp-outlook # Set client ID via env var\n'.trim();
64
64
  function readPkg() {
65
65
  return pkg;
66
66
  }
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-outlook/src/setup/version-help.ts"],"sourcesContent":["import * as fs from 'fs';\nimport moduleRoot from 'module-root-sync';\nimport * as path from 'path';\nimport * as url from 'url';\nimport { parseArgs } from 'util';\n\n// Kept dependency-free (fs/path/url/module-root-sync only) so `--version`/`--help`\n// resolve nothing beyond Node startup: config.ts's parseConfig pulls in @mcp-z/oauth-microsoft\n// and @mcp-z/server, which this path must not touch.\nconst pkg = JSON.parse(fs.readFileSync(path.join(moduleRoot(url.fileURLToPath(import.meta.url)), 'package.json'), 'utf-8'));\n\nconst HELP_TEXT = `\nUsage: mcp-outlook [options]\n\nMCP server for Outlook/Microsoft 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, device-code, dcr\n --headless Disable browser auto-open, return auth URL instead\n --redirect-uri=<uri> OAuth redirect URI (default: ephemeral loopback)\n --tenant-id=<id> Microsoft tenant ID (overrides MS_TENANT_ID env var)\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-outlook/files)\n --base-url=<url> Base URL for HTTP file serving (default: http://localhost for HTTP transports)\n\nEnvironment Variables:\n MS_CLIENT_ID OAuth client ID (REQUIRED)\n MS_TENANT_ID Microsoft tenant ID (REQUIRED)\n MS_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 Base URL for HTTP file serving (optional)\n\nConfiguration Files:\n Variables may also be set in the first of these files that exists:\n 1. .mcp-z/mcp-outlook/.env beside the nearest .mcp.json (else ~/.mcp-z/mcp-outlook/.env)\n 2. ~/.config/mcp-z/mcp-outlook/.env (~ is your home directory, on every OS)\n Values already in the environment, including .mcp.json \"env\", take precedence.\n On macOS and Linux the file must be private (chmod 600), or the server will not start.\n\nStorage Backends:\n TOKEN_STORE_URI and DCR_STORE_URI accept any keyv-registry protocol.\n file:// (the default) and memory:// work out of the box. Any other backend\n needs its adapter installed alongside this server:\n npm install -g @keyv/redis@6\n TOKEN_STORE_URI=redis://localhost:6379 mcp-outlook\n\nOAuth Scopes:\n openid profile offline_access https://graph.microsoft.com/User.Read https://graph.microsoft.com/Mail.ReadWrite https://graph.microsoft.com/Mail.Send https://graph.microsoft.com/MailboxSettings.ReadWrite\n\nExamples:\n mcp-outlook # Use default settings\n mcp-outlook --auth=device-code # Use device code auth\n mcp-outlook --port=3000 # HTTP transport on port 3000\n mcp-outlook --tenant-id=xxx # Set tenant ID\n mcp-outlook --resource-store-uri=file:///tmp/emails # Custom resource store URI\n MS_CLIENT_ID=xxx mcp-outlook # Set client ID via env var\n`.trim();\n\n/** Package metadata read from package.json, resolved relative to this file. */\nexport function readPkg(): { name: string; version: string; repository?: string | { url?: string } } {\n return pkg;\n}\n\n/**\n * Handle --version/--help flags before config parsing.\n * These must work without requiring any configuration or heavy dependency.\n */\nexport function handleVersionHelp(args: string[]): { handled: boolean; output?: string } {\n const { values } = parseArgs({\n args,\n options: {\n version: { type: 'boolean', short: 'v' },\n help: { type: 'boolean', short: 'h' },\n },\n strict: false,\n allowPositionals: true,\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"],"names":["handleVersionHelp","readPkg","pkg","JSON","parse","fs","readFileSync","path","join","moduleRoot","url","fileURLToPath","HELP_TEXT","trim","args","values","parseArgs","options","version","type","short","help","strict","allowPositionals","handled","output"],"mappings":";;;;;;;;;;;QAmFgBA;eAAAA;;QARAC;eAAAA;;;0DA3EI;qEACG;4DACD;2DACD;oBACK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAE1B,mFAAmF;AACnF,+FAA+F;AAC/F,qDAAqD;AACrD,IAAMC,MAAMC,KAAKC,KAAK,CAACC,IAAGC,YAAY,CAACC,MAAKC,IAAI,CAACC,IAAAA,uBAAU,EAACC,KAAIC,aAAa,CAAC,uDAAmB,iBAAiB;AAElH,IAAMC,YAAY,28GA6DhBC,IAAI;AAGC,SAASZ;IACd,OAAOC;AACT;AAMO,SAASF,kBAAkBc,IAAc;IAC9C,IAAM,AAAEC,SAAWC,IAAAA,eAAS,EAAC;QAC3BF,MAAAA;QACAG,SAAS;YACPC,SAAS;gBAAEC,MAAM;gBAAWC,OAAO;YAAI;YACvCC,MAAM;gBAAEF,MAAM;gBAAWC,OAAO;YAAI;QACtC;QACAE,QAAQ;QACRC,kBAAkB;IACpB,GARQR;IAUR,IAAIA,OAAOG,OAAO,EAAE,OAAO;QAAEM,SAAS;QAAMC,QAAQvB,IAAIgB,OAAO;IAAC;IAChE,IAAIH,OAAOM,IAAI,EAAE,OAAO;QAAEG,SAAS;QAAMC,QAAQb;IAAU;IAC3D,OAAO;QAAEY,SAAS;IAAM;AAC1B"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-outlook/src/setup/version-help.ts"],"sourcesContent":["import * as fs from 'fs';\nimport moduleRoot from 'module-root-sync';\nimport * as path from 'path';\nimport * as url from 'url';\nimport { parseArgs } from 'util';\n\n// Kept dependency-free (fs/path/url/module-root-sync only) so `--version`/`--help`\n// resolve nothing beyond Node startup: config.ts's parseConfig pulls in @mcp-z/oauth-microsoft\n// and @mcp-z/server, which this path must not touch.\nconst pkg = JSON.parse(fs.readFileSync(path.join(moduleRoot(url.fileURLToPath(import.meta.url)), 'package.json'), 'utf-8'));\n\nconst HELP_TEXT = `\nUsage: mcp-outlook [options]\n\nMCP server for Outlook/Microsoft 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, device-code, dcr\n --headless Disable browser auto-open, return auth URL instead\n --redirect-uri=<uri> OAuth redirect URI (default: ephemeral loopback)\n --tenant-id=<id> Microsoft tenant ID (overrides MS_TENANT_ID env var)\n --dcr-store-uri=<uri> DCR client storage URI (default: .mcp-z/dcr.json)\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: .mcp-z/mcp-outlook/files beside the nearest .mcp.json, else ~/.mcp-z/mcp-outlook/files)\n --base-url=<url> Base URL for HTTP file serving (default: http://localhost for HTTP transports)\n\nEnvironment Variables:\n MS_CLIENT_ID OAuth client ID (REQUIRED)\n MS_TENANT_ID Microsoft tenant ID (REQUIRED)\n MS_CLIENT_SECRET OAuth client secret (optional)\n AUTH_MODE Default authentication mode (optional)\n HEADLESS Disable browser auto-open (optional)\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 Base URL for HTTP file serving (optional)\n\nConfiguration Files:\n Variables may also be set in the first of these files that exists:\n 1. .mcp-z/mcp-outlook/.env beside the nearest .mcp.json (else ~/.mcp-z/mcp-outlook/.env)\n 2. ~/.config/mcp-z/mcp-outlook/.env (~ is your home directory, on every OS)\n Values already in the environment, including .mcp.json \"env\", take precedence.\n On macOS and Linux the file must be private (chmod 600), or the server will not start.\n\nStorage Backends:\n TOKEN_STORE_URI and DCR_STORE_URI accept any keyv-registry protocol.\n file+shared:// (the default), file:// and memory:// work out of the box. Any other backend\n needs its adapter installed alongside this server:\n npm install -g @keyv/redis@6\n TOKEN_STORE_URI=redis://localhost:6379 mcp-outlook\n\nOAuth Scopes:\n openid profile offline_access https://graph.microsoft.com/User.Read https://graph.microsoft.com/Mail.ReadWrite https://graph.microsoft.com/Mail.Send https://graph.microsoft.com/MailboxSettings.ReadWrite\n\nExamples:\n mcp-outlook # Use default settings\n mcp-outlook --auth=device-code # Use device code auth\n mcp-outlook --port=3000 # HTTP transport on port 3000\n mcp-outlook --tenant-id=xxx # Set tenant ID\n mcp-outlook --resource-store-uri=file:///tmp/emails # Custom resource store URI\n MS_CLIENT_ID=xxx mcp-outlook # Set client ID via env var\n`.trim();\n\n/** Package metadata read from package.json, resolved relative to this file. */\nexport function readPkg(): { name: string; version: string; repository?: string | { url?: string } } {\n return pkg;\n}\n\n/**\n * Handle --version/--help flags before config parsing.\n * These must work without requiring any configuration or heavy dependency.\n */\nexport function handleVersionHelp(args: string[]): { handled: boolean; output?: string } {\n const { values } = parseArgs({\n args,\n options: {\n version: { type: 'boolean', short: 'v' },\n help: { type: 'boolean', short: 'h' },\n },\n strict: false,\n allowPositionals: true,\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"],"names":["handleVersionHelp","readPkg","pkg","JSON","parse","fs","readFileSync","path","join","moduleRoot","url","fileURLToPath","HELP_TEXT","trim","args","values","parseArgs","options","version","type","short","help","strict","allowPositionals","handled","output"],"mappings":";;;;;;;;;;;QA+EgBA;eAAAA;;QARAC;eAAAA;;;0DAvEI;qEACG;4DACD;2DACD;oBACK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAE1B,mFAAmF;AACnF,+FAA+F;AAC/F,qDAAqD;AACrD,IAAMC,MAAMC,KAAKC,KAAK,CAACC,IAAGC,YAAY,CAACC,MAAKC,IAAI,CAACC,IAAAA,uBAAU,EAACC,KAAIC,aAAa,CAAC,uDAAmB,iBAAiB;AAElH,IAAMC,YAAY,gsGAyDhBC,IAAI;AAGC,SAASZ;IACd,OAAOC;AACT;AAMO,SAASF,kBAAkBc,IAAc;IAC9C,IAAM,AAAEC,SAAWC,IAAAA,eAAS,EAAC;QAC3BF,MAAAA;QACAG,SAAS;YACPC,SAAS;gBAAEC,MAAM;gBAAWC,OAAO;YAAI;YACvCC,MAAM;gBAAEF,MAAM;gBAAWC,OAAO;YAAI;QACtC;QACAE,QAAQ;QACRC,kBAAkB;IACpB,GARQR;IAUR,IAAIA,OAAOG,OAAO,EAAE,OAAO;QAAEM,SAAS;QAAMC,QAAQvB,IAAIgB,OAAO;IAAC;IAChE,IAAIH,OAAOM,IAAI,EAAE,OAAO;QAAEG,SAAS;QAAMC,QAAQb;IAAU;IAC3D,OAAO;QAAEY,SAAS;IAAM;AAC1B"}
@@ -5,6 +5,7 @@
5
5
  * rather than externally configured since this server knows its own requirements.
6
6
  */
7
7
  export declare const MS_SCOPE = "openid profile offline_access https://graph.microsoft.com/User.Read https://graph.microsoft.com/Mail.ReadWrite https://graph.microsoft.com/Mail.Send https://graph.microsoft.com/MailboxSettings.ReadWrite";
8
+ export declare const SHARED_FILE_PROTOCOL = "file+shared:";
8
9
  export declare const CHUNK_SIZE = 10;
9
10
  export declare const MAX_BATCH_SIZE = 500;
10
11
  export declare const MAX_PAGE_SIZE = 1000;
@@ -6,6 +6,8 @@
6
6
  */ import { EMAIL_CHUNK_SIZE, EMAIL_MAX_BATCH_SIZE } from '@mcp-z/email';
7
7
  // Microsoft OAuth scopes required for Outlook operations
8
8
  export const MS_SCOPE = 'openid profile offline_access https://graph.microsoft.com/User.Read https://graph.microsoft.com/Mail.ReadWrite https://graph.microsoft.com/Mail.Send https://graph.microsoft.com/MailboxSettings.ReadWrite';
9
+ // Default token and DCR stores: a JSON file several processes can share
10
+ export const SHARED_FILE_PROTOCOL = 'file+shared:';
9
11
  // Batch processing configuration (from shared email constants)
10
12
  export const CHUNK_SIZE = EMAIL_CHUNK_SIZE;
11
13
  export const MAX_BATCH_SIZE = EMAIL_MAX_BATCH_SIZE;
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-outlook/src/constants.ts"],"sourcesContent":["/**\n * Outlook MCP Server Constants\n *\n * These scopes are required for Microsoft Outlook functionality and are hardcoded\n * rather than externally configured since this server knows its own requirements.\n */\n\nimport { EMAIL_CHUNK_SIZE, EMAIL_MAX_BATCH_SIZE } from '@mcp-z/email';\n\n// Microsoft OAuth scopes required for Outlook operations\nexport const MS_SCOPE = 'openid profile offline_access https://graph.microsoft.com/User.Read https://graph.microsoft.com/Mail.ReadWrite https://graph.microsoft.com/Mail.Send https://graph.microsoft.com/MailboxSettings.ReadWrite';\n\n// Batch processing configuration (from shared email constants)\nexport const CHUNK_SIZE = EMAIL_CHUNK_SIZE;\nexport const MAX_BATCH_SIZE = EMAIL_MAX_BATCH_SIZE;\n\n// Pagination configuration\nexport const MAX_PAGE_SIZE = 1000; // Maximum number of items per page\n"],"names":["EMAIL_CHUNK_SIZE","EMAIL_MAX_BATCH_SIZE","MS_SCOPE","CHUNK_SIZE","MAX_BATCH_SIZE","MAX_PAGE_SIZE"],"mappings":"AAAA;;;;;CAKC,GAED,SAASA,gBAAgB,EAAEC,oBAAoB,QAAQ,eAAe;AAEtE,yDAAyD;AACzD,OAAO,MAAMC,WAAW,6MAA6M;AAErO,+DAA+D;AAC/D,OAAO,MAAMC,aAAaH,iBAAiB;AAC3C,OAAO,MAAMI,iBAAiBH,qBAAqB;AAEnD,2BAA2B;AAC3B,OAAO,MAAMI,gBAAgB,KAAK,CAAC,mCAAmC"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-outlook/src/constants.ts"],"sourcesContent":["/**\n * Outlook MCP Server Constants\n *\n * These scopes are required for Microsoft Outlook functionality and are hardcoded\n * rather than externally configured since this server knows its own requirements.\n */\n\nimport { EMAIL_CHUNK_SIZE, EMAIL_MAX_BATCH_SIZE } from '@mcp-z/email';\n\n// Microsoft OAuth scopes required for Outlook operations\nexport const MS_SCOPE = 'openid profile offline_access https://graph.microsoft.com/User.Read https://graph.microsoft.com/Mail.ReadWrite https://graph.microsoft.com/Mail.Send https://graph.microsoft.com/MailboxSettings.ReadWrite';\n\n// Default token and DCR stores: a JSON file several processes can share\nexport const SHARED_FILE_PROTOCOL = 'file+shared:';\n\n// Batch processing configuration (from shared email constants)\nexport const CHUNK_SIZE = EMAIL_CHUNK_SIZE;\nexport const MAX_BATCH_SIZE = EMAIL_MAX_BATCH_SIZE;\n\n// Pagination configuration\nexport const MAX_PAGE_SIZE = 1000; // Maximum number of items per page\n"],"names":["EMAIL_CHUNK_SIZE","EMAIL_MAX_BATCH_SIZE","MS_SCOPE","SHARED_FILE_PROTOCOL","CHUNK_SIZE","MAX_BATCH_SIZE","MAX_PAGE_SIZE"],"mappings":"AAAA;;;;;CAKC,GAED,SAASA,gBAAgB,EAAEC,oBAAoB,QAAQ,eAAe;AAEtE,yDAAyD;AACzD,OAAO,MAAMC,WAAW,6MAA6M;AAErO,wEAAwE;AACxE,OAAO,MAAMC,uBAAuB,eAAe;AAEnD,+DAA+D;AAC/D,OAAO,MAAMC,aAAaJ,iBAAiB;AAC3C,OAAO,MAAMK,iBAAiBJ,qBAAqB;AAEnD,2BAA2B;AAC3B,OAAO,MAAMK,gBAAgB,KAAK,CAAC,mCAAmC"}
@@ -0,0 +1,5 @@
1
+ /**
2
+ * Check an `@odata.nextLink` and return its path and query after the version (`/me/messages?...`),
3
+ * as the URL parser writes them. Microsoft says to follow the whole link and not to rebuild it, so nothing is decoded or reordered.
4
+ */
5
+ export declare function checkNextLink(link: string): string;
@@ -0,0 +1,22 @@
1
+ import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
2
+ const GRAPH_HOST = 'graph.microsoft.com';
3
+ const GRAPH_VERSION_PATH = '/v1.0';
4
+ const MESSAGES_PATH = `${GRAPH_VERSION_PATH}/me/messages`;
5
+ function refuse(reason) {
6
+ throw new ProtocolError(ProtocolErrorCode.InternalError, `Microsoft Graph returned a next-page link that cannot be followed (${reason}); results would be incomplete`);
7
+ }
8
+ /**
9
+ * Check an `@odata.nextLink` and return its path and query after the version (`/me/messages?...`),
10
+ * as the URL parser writes them. Microsoft says to follow the whole link and not to rebuild it, so nothing is decoded or reordered.
11
+ */ export function checkNextLink(link) {
12
+ let url;
13
+ try {
14
+ url = new URL(link);
15
+ } catch {
16
+ return refuse('not a URL');
17
+ }
18
+ if (url.protocol !== 'https:') return refuse(`scheme ${url.protocol.slice(0, -1)}`);
19
+ if (url.host !== GRAPH_HOST) return refuse(`host ${url.host}`);
20
+ if (url.pathname !== MESSAGES_PATH) return refuse(`path ${url.pathname}`);
21
+ return url.pathname.slice(GRAPH_VERSION_PATH.length) + url.search;
22
+ }
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-outlook/src/email/querying/next-link.ts"],"sourcesContent":["import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\n\nconst GRAPH_HOST = 'graph.microsoft.com';\nconst GRAPH_VERSION_PATH = '/v1.0';\nconst MESSAGES_PATH = `${GRAPH_VERSION_PATH}/me/messages`;\n\nfunction refuse(reason: string): never {\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Microsoft Graph returned a next-page link that cannot be followed (${reason}); results would be incomplete`);\n}\n\n/**\n * Check an `@odata.nextLink` and return its path and query after the version (`/me/messages?...`),\n * as the URL parser writes them. Microsoft says to follow the whole link and not to rebuild it, so nothing is decoded or reordered.\n */\nexport function checkNextLink(link: string): string {\n let url: URL;\n try {\n url = new URL(link);\n } catch {\n return refuse('not a URL');\n }\n if (url.protocol !== 'https:') return refuse(`scheme ${url.protocol.slice(0, -1)}`);\n if (url.host !== GRAPH_HOST) return refuse(`host ${url.host}`);\n if (url.pathname !== MESSAGES_PATH) return refuse(`path ${url.pathname}`);\n return url.pathname.slice(GRAPH_VERSION_PATH.length) + url.search;\n}\n"],"names":["ProtocolError","ProtocolErrorCode","GRAPH_HOST","GRAPH_VERSION_PATH","MESSAGES_PATH","refuse","reason","InternalError","checkNextLink","link","url","URL","protocol","slice","host","pathname","length","search"],"mappings":"AAAA,SAASA,aAAa,EAAEC,iBAAiB,QAAQ,gBAAgB;AAEjE,MAAMC,aAAa;AACnB,MAAMC,qBAAqB;AAC3B,MAAMC,gBAAgB,GAAGD,mBAAmB,YAAY,CAAC;AAEzD,SAASE,OAAOC,MAAc;IAC5B,MAAM,IAAIN,cAAcC,kBAAkBM,aAAa,EAAE,CAAC,mEAAmE,EAAED,OAAO,8BAA8B,CAAC;AACvK;AAEA;;;CAGC,GACD,OAAO,SAASE,cAAcC,IAAY;IACxC,IAAIC;IACJ,IAAI;QACFA,MAAM,IAAIC,IAAIF;IAChB,EAAE,OAAM;QACN,OAAOJ,OAAO;IAChB;IACA,IAAIK,IAAIE,QAAQ,KAAK,UAAU,OAAOP,OAAO,CAAC,OAAO,EAAEK,IAAIE,QAAQ,CAACC,KAAK,CAAC,GAAG,CAAC,IAAI;IAClF,IAAIH,IAAII,IAAI,KAAKZ,YAAY,OAAOG,OAAO,CAAC,KAAK,EAAEK,IAAII,IAAI,EAAE;IAC7D,IAAIJ,IAAIK,QAAQ,KAAKX,eAAe,OAAOC,OAAO,CAAC,KAAK,EAAEK,IAAIK,QAAQ,EAAE;IACxE,OAAOL,IAAIK,QAAQ,CAACF,KAAK,CAACV,mBAAmBa,MAAM,IAAIN,IAAIO,MAAM;AACnE"}
@@ -1,12 +1,11 @@
1
- export declare const FIRST_PAGE_SKIP_TOKEN = "__mcp_outlook_first_page__";
2
1
  export interface DecodeNextPageTokenResult {
3
- skipToken?: string;
2
+ /** Path and query of the Graph next-page link that fetches the page, absent for the first page. */
3
+ link?: string;
4
4
  offset: number;
5
5
  mode?: string;
6
- legacy: boolean;
7
6
  }
8
7
  export declare function encodeNextPageToken(params: {
9
- skipToken?: string;
8
+ link?: string;
10
9
  offset: number;
11
10
  mode?: string;
12
11
  }): string;
@@ -1,59 +1,37 @@
1
1
  import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
2
- const PREFIX = 'v2:';
3
- export const FIRST_PAGE_SKIP_TOKEN = '__mcp_outlook_first_page__';
2
+ const PREFIX = 'v3:';
4
3
  export function encodeNextPageToken(params) {
5
- var _params_skipToken;
6
- const sanitizedOffset = Math.max(0, Math.trunc(params.offset));
7
4
  const payload = {
8
- v: 2,
9
- skipToken: (_params_skipToken = params.skipToken) !== null && _params_skipToken !== void 0 ? _params_skipToken : FIRST_PAGE_SKIP_TOKEN,
10
- offset: sanitizedOffset
5
+ v: 3,
6
+ offset: Math.max(0, Math.trunc(params.offset))
11
7
  };
12
- if (typeof params.mode === 'string' && params.mode.length > 0) {
13
- payload.mode = params.mode;
14
- }
15
- const serialized = JSON.stringify(payload);
16
- return `${PREFIX}${base64UrlEncode(serialized)}`;
8
+ if (params.link) payload.link = params.link;
9
+ if (typeof params.mode === 'string' && params.mode.length > 0) payload.mode = params.mode;
10
+ return `${PREFIX}${Buffer.from(JSON.stringify(payload), 'utf8').toString('base64url')}`;
17
11
  }
18
12
  export function decodeNextPageToken(token) {
19
- if (!token) {
20
- return {
21
- offset: 0,
22
- legacy: true
23
- };
24
- }
13
+ if (!token) return {
14
+ offset: 0
15
+ };
25
16
  if (!token.startsWith(PREFIX)) {
26
- return {
27
- skipToken: token,
28
- offset: 0,
29
- legacy: true
30
- };
17
+ throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'pageToken was issued by an earlier mcp-outlook version and cannot be used; repeat the search without pageToken');
31
18
  }
32
- const encoded = token.slice(PREFIX.length);
33
19
  try {
34
- const decodedJson = base64UrlDecode(encoded);
35
- const parsed = JSON.parse(decodedJson);
36
- if (parsed.v !== 2) throw new Error('unsupported token version');
37
- const skipTokenRaw = parsed.skipToken;
38
- const offsetRaw = parsed.offset;
39
- if (typeof skipTokenRaw !== 'string' || skipTokenRaw.trim() === '') throw new Error('missing skipToken');
40
- if (typeof offsetRaw !== 'number' || !Number.isInteger(offsetRaw) || offsetRaw < 0) throw new Error('invalid offset');
20
+ const parsed = JSON.parse(Buffer.from(token.slice(PREFIX.length), 'base64url').toString('utf8'));
21
+ if (parsed.v !== 3) throw new Error('unsupported token version');
22
+ const { link, offset, mode } = parsed;
23
+ if (link !== undefined && (typeof link !== 'string' || link === '')) throw new Error('invalid link');
24
+ if (typeof offset !== 'number' || !Number.isInteger(offset) || offset < 0) throw new Error('invalid offset');
41
25
  return {
42
- skipToken: skipTokenRaw === FIRST_PAGE_SKIP_TOKEN ? undefined : skipTokenRaw,
43
- offset: offsetRaw,
44
- mode: typeof parsed.mode === 'string' ? parsed.mode : undefined,
45
- legacy: false
26
+ ...typeof link === 'string' && {
27
+ link
28
+ },
29
+ offset,
30
+ ...typeof mode === 'string' && {
31
+ mode
32
+ }
46
33
  };
47
34
  } catch {
48
35
  throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Invalid pageToken');
49
36
  }
50
37
  }
51
- function base64UrlEncode(value) {
52
- return Buffer.from(value, 'utf8').toString('base64').replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
53
- }
54
- function base64UrlDecode(value) {
55
- const padded = value.replace(/-/g, '+').replace(/_/g, '/');
56
- const padLength = (4 - padded.length % 4) % 4;
57
- const normalized = padded + '='.repeat(padLength);
58
- return Buffer.from(normalized, 'base64').toString('utf8');
59
- }
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-outlook/src/email/querying/pagination-token.ts"],"sourcesContent":["import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\n\nconst PREFIX = 'v2:';\nexport const FIRST_PAGE_SKIP_TOKEN = '__mcp_outlook_first_page__';\n\ninterface V2Payload {\n v: 2;\n skipToken: string;\n offset: number;\n mode?: string;\n}\n\nexport interface DecodeNextPageTokenResult {\n skipToken?: string;\n offset: number;\n mode?: string;\n legacy: boolean;\n}\n\nexport function encodeNextPageToken(params: { skipToken?: string; offset: number; mode?: string }): string {\n const sanitizedOffset = Math.max(0, Math.trunc(params.offset));\n const payload: V2Payload = {\n v: 2,\n skipToken: params.skipToken ?? FIRST_PAGE_SKIP_TOKEN,\n offset: sanitizedOffset,\n };\n if (typeof params.mode === 'string' && params.mode.length > 0) {\n payload.mode = params.mode;\n }\n const serialized = JSON.stringify(payload);\n return `${PREFIX}${base64UrlEncode(serialized)}`;\n}\n\nexport function decodeNextPageToken(token: string | undefined): DecodeNextPageTokenResult {\n if (!token) {\n return { offset: 0, legacy: true };\n }\n\n if (!token.startsWith(PREFIX)) {\n return { skipToken: token, offset: 0, legacy: true };\n }\n\n const encoded = token.slice(PREFIX.length);\n try {\n const decodedJson = base64UrlDecode(encoded);\n const parsed = JSON.parse(decodedJson) as Record<string, unknown>;\n if (parsed.v !== 2) throw new Error('unsupported token version');\n const skipTokenRaw = parsed.skipToken;\n const offsetRaw = parsed.offset;\n if (typeof skipTokenRaw !== 'string' || skipTokenRaw.trim() === '') throw new Error('missing skipToken');\n if (typeof offsetRaw !== 'number' || !Number.isInteger(offsetRaw) || offsetRaw < 0) throw new Error('invalid offset');\n\n return {\n skipToken: skipTokenRaw === FIRST_PAGE_SKIP_TOKEN ? undefined : skipTokenRaw,\n offset: offsetRaw,\n mode: typeof parsed.mode === 'string' ? parsed.mode : undefined,\n legacy: false,\n };\n } catch {\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Invalid pageToken');\n }\n}\n\nfunction base64UrlEncode(value: string): string {\n return Buffer.from(value, 'utf8').toString('base64').replace(/\\+/g, '-').replace(/\\//g, '_').replace(/=+$/, '');\n}\n\nfunction base64UrlDecode(value: string): string {\n const padded = value.replace(/-/g, '+').replace(/_/g, '/');\n const padLength = (4 - (padded.length % 4)) % 4;\n const normalized = padded + '='.repeat(padLength);\n return Buffer.from(normalized, 'base64').toString('utf8');\n}\n"],"names":["ProtocolError","ProtocolErrorCode","PREFIX","FIRST_PAGE_SKIP_TOKEN","encodeNextPageToken","params","sanitizedOffset","Math","max","trunc","offset","payload","v","skipToken","mode","length","serialized","JSON","stringify","base64UrlEncode","decodeNextPageToken","token","legacy","startsWith","encoded","slice","decodedJson","base64UrlDecode","parsed","parse","Error","skipTokenRaw","offsetRaw","trim","Number","isInteger","undefined","InvalidParams","value","Buffer","from","toString","replace","padded","padLength","normalized","repeat"],"mappings":"AAAA,SAASA,aAAa,EAAEC,iBAAiB,QAAQ,gBAAgB;AAEjE,MAAMC,SAAS;AACf,OAAO,MAAMC,wBAAwB,6BAA6B;AAgBlE,OAAO,SAASC,oBAAoBC,MAA6D;QAIlFA;IAHb,MAAMC,kBAAkBC,KAAKC,GAAG,CAAC,GAAGD,KAAKE,KAAK,CAACJ,OAAOK,MAAM;IAC5D,MAAMC,UAAqB;QACzBC,GAAG;QACHC,SAAS,GAAER,oBAAAA,OAAOQ,SAAS,cAAhBR,+BAAAA,oBAAoBF;QAC/BO,QAAQJ;IACV;IACA,IAAI,OAAOD,OAAOS,IAAI,KAAK,YAAYT,OAAOS,IAAI,CAACC,MAAM,GAAG,GAAG;QAC7DJ,QAAQG,IAAI,GAAGT,OAAOS,IAAI;IAC5B;IACA,MAAME,aAAaC,KAAKC,SAAS,CAACP;IAClC,OAAO,GAAGT,SAASiB,gBAAgBH,aAAa;AAClD;AAEA,OAAO,SAASI,oBAAoBC,KAAyB;IAC3D,IAAI,CAACA,OAAO;QACV,OAAO;YAAEX,QAAQ;YAAGY,QAAQ;QAAK;IACnC;IAEA,IAAI,CAACD,MAAME,UAAU,CAACrB,SAAS;QAC7B,OAAO;YAAEW,WAAWQ;YAAOX,QAAQ;YAAGY,QAAQ;QAAK;IACrD;IAEA,MAAME,UAAUH,MAAMI,KAAK,CAACvB,OAAOa,MAAM;IACzC,IAAI;QACF,MAAMW,cAAcC,gBAAgBH;QACpC,MAAMI,SAASX,KAAKY,KAAK,CAACH;QAC1B,IAAIE,OAAOhB,CAAC,KAAK,GAAG,MAAM,IAAIkB,MAAM;QACpC,MAAMC,eAAeH,OAAOf,SAAS;QACrC,MAAMmB,YAAYJ,OAAOlB,MAAM;QAC/B,IAAI,OAAOqB,iBAAiB,YAAYA,aAAaE,IAAI,OAAO,IAAI,MAAM,IAAIH,MAAM;QACpF,IAAI,OAAOE,cAAc,YAAY,CAACE,OAAOC,SAAS,CAACH,cAAcA,YAAY,GAAG,MAAM,IAAIF,MAAM;QAEpG,OAAO;YACLjB,WAAWkB,iBAAiB5B,wBAAwBiC,YAAYL;YAChErB,QAAQsB;YACRlB,MAAM,OAAOc,OAAOd,IAAI,KAAK,WAAWc,OAAOd,IAAI,GAAGsB;YACtDd,QAAQ;QACV;IACF,EAAE,OAAM;QACN,MAAM,IAAItB,cAAcC,kBAAkBoC,aAAa,EAAE;IAC3D;AACF;AAEA,SAASlB,gBAAgBmB,KAAa;IACpC,OAAOC,OAAOC,IAAI,CAACF,OAAO,QAAQG,QAAQ,CAAC,UAAUC,OAAO,CAAC,OAAO,KAAKA,OAAO,CAAC,OAAO,KAAKA,OAAO,CAAC,OAAO;AAC9G;AAEA,SAASf,gBAAgBW,KAAa;IACpC,MAAMK,SAASL,MAAMI,OAAO,CAAC,MAAM,KAAKA,OAAO,CAAC,MAAM;IACtD,MAAME,YAAY,AAAC,CAAA,IAAKD,OAAO5B,MAAM,GAAG,CAAC,IAAK;IAC9C,MAAM8B,aAAaF,SAAS,IAAIG,MAAM,CAACF;IACvC,OAAOL,OAAOC,IAAI,CAACK,YAAY,UAAUJ,QAAQ,CAAC;AACpD"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-outlook/src/email/querying/pagination-token.ts"],"sourcesContent":["import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\n\nconst PREFIX = 'v3:';\n\ninterface V3Payload {\n v: 3;\n link?: string;\n offset: number;\n mode?: string;\n}\n\nexport interface DecodeNextPageTokenResult {\n /** Path and query of the Graph next-page link that fetches the page, absent for the first page. */\n link?: string;\n offset: number;\n mode?: string;\n}\n\nexport function encodeNextPageToken(params: { link?: string; offset: number; mode?: string }): string {\n const payload: V3Payload = { v: 3, offset: Math.max(0, Math.trunc(params.offset)) };\n if (params.link) payload.link = params.link;\n if (typeof params.mode === 'string' && params.mode.length > 0) payload.mode = params.mode;\n return `${PREFIX}${Buffer.from(JSON.stringify(payload), 'utf8').toString('base64url')}`;\n}\n\nexport function decodeNextPageToken(token: string | undefined): DecodeNextPageTokenResult {\n if (!token) return { offset: 0 };\n\n if (!token.startsWith(PREFIX)) {\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'pageToken was issued by an earlier mcp-outlook version and cannot be used; repeat the search without pageToken');\n }\n\n try {\n const parsed = JSON.parse(Buffer.from(token.slice(PREFIX.length), 'base64url').toString('utf8')) as Record<string, unknown>;\n if (parsed.v !== 3) throw new Error('unsupported token version');\n const { link, offset, mode } = parsed;\n if (link !== undefined && (typeof link !== 'string' || link === '')) throw new Error('invalid link');\n if (typeof offset !== 'number' || !Number.isInteger(offset) || offset < 0) throw new Error('invalid offset');\n return {\n ...(typeof link === 'string' && { link }),\n offset,\n ...(typeof mode === 'string' && { mode }),\n };\n } catch {\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Invalid pageToken');\n }\n}\n"],"names":["ProtocolError","ProtocolErrorCode","PREFIX","encodeNextPageToken","params","payload","v","offset","Math","max","trunc","link","mode","length","Buffer","from","JSON","stringify","toString","decodeNextPageToken","token","startsWith","InvalidParams","parsed","parse","slice","Error","undefined","Number","isInteger"],"mappings":"AAAA,SAASA,aAAa,EAAEC,iBAAiB,QAAQ,gBAAgB;AAEjE,MAAMC,SAAS;AAgBf,OAAO,SAASC,oBAAoBC,MAAwD;IAC1F,MAAMC,UAAqB;QAAEC,GAAG;QAAGC,QAAQC,KAAKC,GAAG,CAAC,GAAGD,KAAKE,KAAK,CAACN,OAAOG,MAAM;IAAG;IAClF,IAAIH,OAAOO,IAAI,EAAEN,QAAQM,IAAI,GAAGP,OAAOO,IAAI;IAC3C,IAAI,OAAOP,OAAOQ,IAAI,KAAK,YAAYR,OAAOQ,IAAI,CAACC,MAAM,GAAG,GAAGR,QAAQO,IAAI,GAAGR,OAAOQ,IAAI;IACzF,OAAO,GAAGV,SAASY,OAAOC,IAAI,CAACC,KAAKC,SAAS,CAACZ,UAAU,QAAQa,QAAQ,CAAC,cAAc;AACzF;AAEA,OAAO,SAASC,oBAAoBC,KAAyB;IAC3D,IAAI,CAACA,OAAO,OAAO;QAAEb,QAAQ;IAAE;IAE/B,IAAI,CAACa,MAAMC,UAAU,CAACnB,SAAS;QAC7B,MAAM,IAAIF,cAAcC,kBAAkBqB,aAAa,EAAE;IAC3D;IAEA,IAAI;QACF,MAAMC,SAASP,KAAKQ,KAAK,CAACV,OAAOC,IAAI,CAACK,MAAMK,KAAK,CAACvB,OAAOW,MAAM,GAAG,aAAaK,QAAQ,CAAC;QACxF,IAAIK,OAAOjB,CAAC,KAAK,GAAG,MAAM,IAAIoB,MAAM;QACpC,MAAM,EAAEf,IAAI,EAAEJ,MAAM,EAAEK,IAAI,EAAE,GAAGW;QAC/B,IAAIZ,SAASgB,aAAc,CAAA,OAAOhB,SAAS,YAAYA,SAAS,EAAC,GAAI,MAAM,IAAIe,MAAM;QACrF,IAAI,OAAOnB,WAAW,YAAY,CAACqB,OAAOC,SAAS,CAACtB,WAAWA,SAAS,GAAG,MAAM,IAAImB,MAAM;QAC3F,OAAO;YACL,GAAI,OAAOf,SAAS,YAAY;gBAAEA;YAAK,CAAC;YACxCJ;YACA,GAAI,OAAOK,SAAS,YAAY;gBAAEA;YAAK,CAAC;QAC1C;IACF,EAAE,OAAM;QACN,MAAM,IAAIZ,cAAcC,kBAAkBqB,aAAa,EAAE;IAC3D;AACF"}
@@ -0,0 +1,14 @@
1
+ /** Token that resumes inside the page fetched by `link`, one message past the last one taken. */
2
+ export declare function midPageToken(params: {
3
+ link?: string;
4
+ pageStart: number;
5
+ index: number;
6
+ mode: 'search' | 'filter';
7
+ }): string;
8
+ /** Which collection a page token resumes: a fallback-filter token resumes the filter collection, anything else the search. */
9
+ export declare function resumeCollection(mode: string | undefined): 'search' | 'filter';
10
+ /** Cut a batch to what still fits under maxItems; truncated when rows were cut or a link remains at the limit. */
11
+ export declare function cutToMaxItems<T>(rows: T[], taken: number, maxItems: number, hasMore: boolean): {
12
+ rows: T[];
13
+ truncated: boolean;
14
+ };
@@ -0,0 +1,21 @@
1
+ import { encodeNextPageToken } from './pagination-token.js';
2
+ /** Token that resumes inside the page fetched by `link`, one message past the last one taken. */ export function midPageToken(params) {
3
+ return encodeNextPageToken({
4
+ ...params.link && {
5
+ link: params.link
6
+ },
7
+ offset: params.pageStart + params.index + 1,
8
+ mode: params.mode
9
+ });
10
+ }
11
+ /** Which collection a page token resumes: a fallback-filter token resumes the filter collection, anything else the search. */ export function resumeCollection(mode) {
12
+ return mode === 'filter' ? 'filter' : 'search';
13
+ }
14
+ /** Cut a batch to what still fits under maxItems; truncated when rows were cut or a link remains at the limit. */ export function cutToMaxItems(rows, taken, maxItems, hasMore) {
15
+ const kept = rows.slice(0, Math.max(0, maxItems - taken));
16
+ const truncated = kept.length < rows.length || taken + kept.length >= maxItems && hasMore;
17
+ return {
18
+ rows: kept,
19
+ truncated
20
+ };
21
+ }
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-outlook/src/email/querying/paging-decisions.ts"],"sourcesContent":["import { encodeNextPageToken } from './pagination-token.ts';\n\n/** Token that resumes inside the page fetched by `link`, one message past the last one taken. */\nexport function midPageToken(params: { link?: string; pageStart: number; index: number; mode: 'search' | 'filter' }): string {\n return encodeNextPageToken({ ...(params.link && { link: params.link }), offset: params.pageStart + params.index + 1, mode: params.mode });\n}\n\n/** Which collection a page token resumes: a fallback-filter token resumes the filter collection, anything else the search. */\nexport function resumeCollection(mode: string | undefined): 'search' | 'filter' {\n return mode === 'filter' ? 'filter' : 'search';\n}\n\n/** Cut a batch to what still fits under maxItems; truncated when rows were cut or a link remains at the limit. */\nexport function cutToMaxItems<T>(rows: T[], taken: number, maxItems: number, hasMore: boolean): { rows: T[]; truncated: boolean } {\n const kept = rows.slice(0, Math.max(0, maxItems - taken));\n const truncated = kept.length < rows.length || (taken + kept.length >= maxItems && hasMore);\n return { rows: kept, truncated };\n}\n"],"names":["encodeNextPageToken","midPageToken","params","link","offset","pageStart","index","mode","resumeCollection","cutToMaxItems","rows","taken","maxItems","hasMore","kept","slice","Math","max","truncated","length"],"mappings":"AAAA,SAASA,mBAAmB,QAAQ,wBAAwB;AAE5D,+FAA+F,GAC/F,OAAO,SAASC,aAAaC,MAAsF;IACjH,OAAOF,oBAAoB;QAAE,GAAIE,OAAOC,IAAI,IAAI;YAAEA,MAAMD,OAAOC,IAAI;QAAC,CAAC;QAAGC,QAAQF,OAAOG,SAAS,GAAGH,OAAOI,KAAK,GAAG;QAAGC,MAAML,OAAOK,IAAI;IAAC;AACzI;AAEA,4HAA4H,GAC5H,OAAO,SAASC,iBAAiBD,IAAwB;IACvD,OAAOA,SAAS,WAAW,WAAW;AACxC;AAEA,gHAAgH,GAChH,OAAO,SAASE,cAAiBC,IAAS,EAAEC,KAAa,EAAEC,QAAgB,EAAEC,OAAgB;IAC3F,MAAMC,OAAOJ,KAAKK,KAAK,CAAC,GAAGC,KAAKC,GAAG,CAAC,GAAGL,WAAWD;IAClD,MAAMO,YAAYJ,KAAKK,MAAM,GAAGT,KAAKS,MAAM,IAAKR,QAAQG,KAAKK,MAAM,IAAIP,YAAYC;IACnF,OAAO;QAAEH,MAAMI;QAAMI;IAAU;AACjC"}