@onyxsecurity/mcp-gateway 1.0.63 → 1.0.65

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 (30) hide show
  1. package/dist/bin/mcp-gateway.js +1 -1
  2. package/dist/cli-CKYhylKw.js +3 -0
  3. package/dist/cli-CKYhylKw.js.map +1 -0
  4. package/dist/{env-JHfIqf7O.js → env-BWJ8ud_g.js} +2 -2
  5. package/dist/{env-JHfIqf7O.js.map → env-BWJ8ud_g.js.map} +1 -1
  6. package/dist/{env-Bz3l4xR7.js → env-BhLIGX1J.js} +1 -1
  7. package/dist/index.js +1 -1
  8. package/dist/{logger-CxuXnoy8.js → logger-CZbmmqeM.js} +2 -2
  9. package/dist/{logger-CxuXnoy8.js.map → logger-CZbmmqeM.js.map} +1 -1
  10. package/dist/main-27K-iFJ4.js +8 -0
  11. package/dist/main-27K-iFJ4.js.map +1 -0
  12. package/dist/{normalizeUrl-u9rsNRmG.js → normalizeUrl-fkFv5Mfb.js} +2 -2
  13. package/dist/{normalizeUrl-u9rsNRmG.js.map → normalizeUrl-fkFv5Mfb.js.map} +1 -1
  14. package/dist/{oauthProvidersClient-CA99rXX6.js → oauthProvidersClient-DJfrkdEi.js} +2 -2
  15. package/dist/{oauthProvidersClient-CA99rXX6.js.map → oauthProvidersClient-DJfrkdEi.js.map} +1 -1
  16. package/dist/oauthProvidersClient-DP3TZ44j.js +1 -0
  17. package/dist/{providers-DlG5fsS1.js → providers-Cn2j18Ew.js} +2 -2
  18. package/dist/{providers-DlG5fsS1.js.map → providers-Cn2j18Ew.js.map} +1 -1
  19. package/dist/{stdio-DPNPM5VR.js → stdio-N_9V53d5.js} +2 -2
  20. package/dist/{stdio-DPNPM5VR.js.map → stdio-N_9V53d5.js.map} +1 -1
  21. package/dist/transportDetection-eBY0es0F.js +136 -0
  22. package/dist/transportDetection-eBY0es0F.js.map +1 -0
  23. package/package.json +1 -1
  24. package/dist/cli-D7NTuJNr.js +0 -3
  25. package/dist/cli-D7NTuJNr.js.map +0 -1
  26. package/dist/main-BP88lLlU.js +0 -8
  27. package/dist/main-BP88lLlU.js.map +0 -1
  28. package/dist/oauthProvidersClient-DXFLCVgt.js +0 -1
  29. package/dist/transportDetection-DOLigM8S.js +0 -136
  30. package/dist/transportDetection-DOLigM8S.js.map +0 -1
@@ -0,0 +1,136 @@
1
+ import{OAuthError as e,SSEClientTransport as t,StreamableHTTPClientTransport as n,discoverAuthorizationServerMetadata as r,discoverOAuthProtectedResourceMetadata as i,exchangeAuthorization as a,normalizeUrl as o,refreshAuthorization as s,registerClient as c,startAuthorization as l}from"./normalizeUrl-fkFv5Mfb.js";import{config as u}from"./env-BWJ8ud_g.js";import{logger as d}from"./logger-CZbmmqeM.js";import{findProviderForUrl as f}from"./providers-Cn2j18Ew.js";import{platform as p}from"node:os";import{createServer as m}from"node:http";import{execFile as h}from"node:child_process";import{URL as g}from"node:url";async function _(e){let t=e.toString(),n=p(),r=x(t);return new Promise((e,i)=>{let a,o;if(n===`win32`){let e=`Start-Process ${y(t)}`,n=v(e);a=b(),o=[`-NoProfile`,`-NonInteractive`,`-ExecutionPolicy`,`Bypass`,`-EncodedCommand`,n]}else n===`darwin`?(a=`open`,o=[t]):(a=`xdg-open`,o=[t]);h(a,o,(t,o,s)=>{if(t){let e={command:a,os:n,stderr:s,url:r};d.warn(`Failed to open browser automatically`,{...e,error:t.message});let o=Error(`Failed to open browser: ${t.message} (command: ${a}, os: ${n}, url: ${r})`);o.cause=t,i(o)}else d.debug(`Browser opened successfully`,{url:r}),e()})})}function v(e){return Buffer.from(e,`utf16le`).toString(`base64`)}function y(e){return`'${e.replaceAll(`'`,`''`)}'`}function b(){return`${process.env.SYSTEMROOT||process.env.windir||`C:\\Windows`}\\System32\\WindowsPowerShell\\v1.0\\powershell.exe`}function x(e){try{let t=new URL(e);return t.search?`${t.protocol}//${t.host}${t.pathname}?[REDACTED]`:`${t.protocol}//${t.host}${t.pathname}`}catch{return`[INVALID_URL]`}}const S={CALLBACK_FAILED:`mcp_auth_callback_failed`,DCR_FAILED:`mcp_auth_dcr_failed`,REFRESH_FAILED:`mcp_auth_refresh_failed`,SERVER_METADATA_FAILED:`mcp_auth_server_metadata_failed`,STATE_MISMATCH:`mcp_auth_state_mismatch`,TOKEN_EXCHANGE_FAILED:`mcp_auth_token_exchange_failed`},C=49152;function w(){return Math.floor(Math.random()*(65535-C+1))+C}function T(e,t){return new Promise((n,r)=>{let i=t=>{e.removeListener(`listening`,a),r(t)},a=()=>{e.removeListener(`error`,i),n()};e.once(`error`,i),e.once(`listening`,a),e.listen(t,`127.0.0.1`)})}async function E(e={}){let{maxAttempts:t=5,preferredPort:n,serverUrl:r,timeoutMs:i=3e5}=e,a=r?k(r):void 0,o,s,c={},l=new Promise((e,t)=>{o=e,s=t}),u,f=m((e,t)=>{if(e.url===`/favicon.ico`){t.writeHead(404),t.end();return}if(!e.url?.startsWith(`/callback`)){t.writeHead(404),t.end(`Not Found`);return}try{let n=new g(e.url,`http://localhost:${u}`),r=n.searchParams.get(`code`),i=n.searchParams.get(`error`),l=n.searchParams.get(`error_description`),p=n.searchParams.get(`state`);if(i){d.error(`OAuth authorization error`,{error:i,errorDescription:l,eventType:S.CALLBACK_FAILED,...a?{serverUrl:a}:{}}),t.writeHead(400,{"Content-Type":`text/html`}),t.end(O(i,l||void 0)),clearTimeout(c.id),s(Error(`OAuth authorization failed: ${i}${l?` - ${l}`:``}`));return}if(!r){d.error(`OAuth callback missing authorization code`,{eventType:S.CALLBACK_FAILED,reason:`missing_code`,...a?{serverUrl:a}:{}}),t.writeHead(400,{"Content-Type":`text/html`}),t.end(O(`missing_code`,`No authorization code was provided`)),clearTimeout(c.id),s(Error(`OAuth callback missing authorization code`));return}d.info(`OAuth authorization code received`,{codePrefix:`${r.substring(0,10)}...`,hasState:!!p}),t.writeHead(200,{"Content-Type":`text/html`}),t.end(`<!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Authorization Successful</title>
7
+ <style>
8
+ body {
9
+ font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
10
+ display: flex;
11
+ justify-content: center;
12
+ align-items: center;
13
+ min-height: 100vh;
14
+ margin: 0;
15
+ background: linear-gradient(135deg, #1a1a2e 0%, #16213e 100%);
16
+ color: #fff;
17
+ }
18
+ .container {
19
+ text-align: center;
20
+ padding: 2rem;
21
+ }
22
+ .checkmark {
23
+ width: 80px;
24
+ height: 80px;
25
+ border-radius: 50%;
26
+ background: #10b981;
27
+ display: flex;
28
+ align-items: center;
29
+ justify-content: center;
30
+ margin: 0 auto 1.5rem;
31
+ animation: pop 0.3s ease-out;
32
+ }
33
+ .checkmark svg {
34
+ width: 40px;
35
+ height: 40px;
36
+ stroke: white;
37
+ stroke-width: 3;
38
+ }
39
+ h1 {
40
+ margin: 0 0 0.5rem;
41
+ font-size: 1.75rem;
42
+ font-weight: 600;
43
+ }
44
+ p {
45
+ margin: 0;
46
+ color: #a0aec0;
47
+ font-size: 1rem;
48
+ }
49
+ @keyframes pop {
50
+ 0% { transform: scale(0); }
51
+ 50% { transform: scale(1.1); }
52
+ 100% { transform: scale(1); }
53
+ }
54
+ </style>
55
+ </head>
56
+ <body>
57
+ <div class="container">
58
+ <div class="checkmark">
59
+ <svg viewBox="0 0 24 24" fill="none">
60
+ <path d="M5 13l4 4L19 7" stroke-linecap="round" stroke-linejoin="round"/>
61
+ </svg>
62
+ </div>
63
+ <h1>Authorization Successful</h1>
64
+ <p>You can close this window and return to the terminal.</p>
65
+ </div>
66
+ <script>setTimeout(() => window.close(), 3000);<\/script>
67
+ </body>
68
+ </html>`),clearTimeout(c.id),o({code:r,state:p||void 0}),setTimeout(()=>f.close(),1e3)}catch(e){d.error(`Error processing OAuth callback`,{error:String(e),eventType:S.CALLBACK_FAILED,reason:`callback_processing_error`,...a?{serverUrl:a}:{}}),t.writeHead(500),t.end(`Internal Server Error`),clearTimeout(c.id),s(e instanceof Error?e:Error(String(e)))}});c.id=setTimeout(()=>{s(Error(`OAuth callback timeout after ${i}ms`)),f.close()},i);let p=[],h;for(;p.length<t;){let e;if(p.length===0&&n!==void 0)e=n;else for(e=w();p.includes(e);)e=w();p.push(e);try{await T(f,e),u=e;let t=`http://localhost:${u}/callback`;return d.info(`OAuth callback server started`,{attempt:p.length,callbackUrl:t,port:u}),{callbackUrl:t,close:()=>new Promise(e=>{clearTimeout(c.id),f.close(()=>e()),f.closeAllConnections()}),port:u,waitForCallback:()=>l}}catch(n){if(n.code===`EADDRINUSE`)d.debug(`Port in use, trying another port`,{attempt:p.length,maxAttempts:t,port:e}),h=Error(`Port ${e} is already in use`);else throw clearTimeout(c.id),f.close(),n}}throw clearTimeout(c.id),f.close(),Error(`Failed to start OAuth callback server after ${t} attempts. Tried ports: ${p.join(`, `)}. Last error: ${h?.message||`unknown`}`)}function D(e){return e.replace(/&/g,`&amp;`).replace(/</g,`&lt;`).replace(/>/g,`&gt;`).replace(/"/g,`&quot;`).replace(/'/g,`&#039;`)}function O(e,t){return`<!DOCTYPE html>
69
+ <html lang="en">
70
+ <head>
71
+ <meta charset="UTF-8">
72
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
73
+ <title>Authorization Failed</title>
74
+ <style>
75
+ body {
76
+ font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
77
+ display: flex;
78
+ justify-content: center;
79
+ align-items: center;
80
+ min-height: 100vh;
81
+ margin: 0;
82
+ background: linear-gradient(135deg, #1a1a2e 0%, #16213e 100%);
83
+ color: #fff;
84
+ }
85
+ .container {
86
+ text-align: center;
87
+ padding: 2rem;
88
+ max-width: 400px;
89
+ }
90
+ .error-icon {
91
+ width: 80px;
92
+ height: 80px;
93
+ border-radius: 50%;
94
+ background: #ef4444;
95
+ display: flex;
96
+ align-items: center;
97
+ justify-content: center;
98
+ margin: 0 auto 1.5rem;
99
+ }
100
+ .error-icon svg {
101
+ width: 40px;
102
+ height: 40px;
103
+ stroke: white;
104
+ stroke-width: 3;
105
+ }
106
+ h1 {
107
+ margin: 0 0 0.5rem;
108
+ font-size: 1.75rem;
109
+ font-weight: 600;
110
+ }
111
+ .error-code {
112
+ color: #f87171;
113
+ font-family: monospace;
114
+ margin-bottom: 0.5rem;
115
+ }
116
+ p {
117
+ margin: 0;
118
+ color: #a0aec0;
119
+ font-size: 1rem;
120
+ }
121
+ </style>
122
+ </head>
123
+ <body>
124
+ <div class="container">
125
+ <div class="error-icon">
126
+ <svg viewBox="0 0 24 24" fill="none">
127
+ <path d="M6 18L18 6M6 6l12 12" stroke-linecap="round" stroke-linejoin="round"/>
128
+ </svg>
129
+ </div>
130
+ <h1>Authorization Failed</h1>
131
+ <p class="error-code">${D(e)}</p>
132
+ ${t?`<p>${D(t)}</p>`:``}
133
+ </div>
134
+ </body>
135
+ </html>`}function k(e){try{let t=new g(e);return t.username=``,t.password=``,t.search=``,t.hash=``,t.toString()}catch{return e}}var A=class extends Error{constructor(e,t){let n=t instanceof Error?t.message:String(t);super(`Auth server metadata discovery failed for ${e}: ${n}`),this.authServerUrl=e,this.cause=t,this.name=`AuthServerDiscoveryError`}};async function j(e,t={}){let{logger:n,signal:a}=t,o=a?M(a):void 0;n?.debug(`Discovering OAuth protected resource metadata...`);let s;try{s=o?await i(e,void 0,o):await i(e),n?.info(`Discovered protected resource metadata`,{authorizationServers:s?.authorization_servers,resource:s?.resource,scopesSupported:s?.scopes_supported})}catch(e){n?.warn(`Could not discover protected resource metadata, will try direct discovery`,{error:String(e)})}let c;s?.authorization_servers?.length?(c=new URL(s.authorization_servers[0]),n?.debug(`Using authorization server from resource metadata`,{authServerUrl:c.toString()})):(c=e,n?.debug(`Using server URL as authorization server`,{authServerUrl:c.toString()})),n?.debug(`Discovering authorization server metadata...`);let l;try{l=o?await r(c,{fetchFn:o}):await r(c)}catch(e){throw new A(c,e)}return l&&n?.info(`Discovered authorization server metadata`,{authorizationEndpoint:l.authorization_endpoint,issuer:l.issuer,registrationEndpoint:l.registration_endpoint,tokenEndpoint:l.token_endpoint}),{authMetadata:l,authServerUrl:c,resourceMetadata:s}}function M(e){return(t,n)=>{let r=n?.signal,i=r?AbortSignal.any([e,r]):e;return fetch(t,{...n,signal:i})}}function N(e){return P(e,new WeakSet)}function P(t,n){if(t==null)return!1;if(t instanceof e)return t.errorCode===`invalid_grant`;if(typeof t==`object`){if(n.has(t))return!1;n.add(t);let e=t.error;if(typeof e==`string`&&e===`invalid_grant`)return!0;for(let e of[`response`,`data`,`body`,`cause`]){let r=t[e];if(r!==void 0&&P(r,n))return!0}}return t instanceof Error&&typeof t.message==`string`?/"error"\s*:\s*"invalid_grant"/.test(t.message)||/\berror\s*=\s*invalid_grant\b/.test(t.message)||/\berror\s*:\s*invalid_grant\b/.test(t.message):!1}const F={"claude-code":`Claude Code (mcp-gateway)`,codex:`Codex`,copilot:`Visual Studio Code`,cursor:`Cursor`,opencode:`OpenCode`},I={cursor:{"mcp.figma.com":`cursor://anysphere.cursor-mcp/oauth/callback`}};function L(){return B(u.clientAppName)}function R(e,t){return V(u.clientAppName,e,t)}async function z(e,t={}){let{credentialStore:n,scope:r,timeoutMs:i}=t,s=o(e),u=new URL(s);if(d.info(`Starting OAuth flow`,{serverUrl:s}),n){let e=await G(u,n);if(e)return d.info(`Using existing OAuth credentials`,{clientId:e.clientInfo.client_id,serverUrl:s}),e}d.debug(`Starting OAuth callback server...`);let p=await E({serverUrl:s,timeoutMs:i}),m=p.callbackUrl;d.info(`OAuth callback server started`,{callbackUrl:m,port:p.port});try{let e=f(u);if(e)return d.info(`Using pre-configured OAuth provider`,{providerId:e.id,providerName:e.name}),await W(u,e,p,n,r);let i,o;try{({authMetadata:i,authServerUrl:o}=await j(u,{logger:d}))}catch(e){throw d.error(`Auth server metadata discovery failed`,{error:String(e),eventType:S.SERVER_METADATA_FAILED,serverUrl:s,...e instanceof A?{authServer:e.authServerUrl.toString()}:{}}),e}if(!i)throw d.error(`Auth server metadata absent (server may not support OAuth 2.0)`,{authServer:o.toString(),eventType:S.SERVER_METADATA_FAILED,reason:`metadata_absent`,serverUrl:s}),Error(`Could not discover OAuth metadata from ${o}. The server may not support OAuth 2.0 or the metadata endpoint is not accessible.`);let h,g=n?await n.load(s):void 0,v=g?.clientInfo?.redirect_uris||[];if(g?.clientInfo&&v.includes(m)&&g?.clientInfo)d.info(`Reusing existing DCR client registration`,{clientId:g.clientInfo.client_id,clientName:g.clientInfo.client_name,redirectUri:m}),h=g.clientInfo;else{g?.clientInfo&&d.info(`Existing DCR client has different redirect_uri, re-registering`,{existingRedirectUris:v,newRedirectUri:m});let e={client_name:t.clientMetadata?.client_name||L(),grant_types:t.clientMetadata?.grant_types||[`authorization_code`,`refresh_token`],redirect_uris:R(u,m),response_types:t.clientMetadata?.response_types||[`code`],token_endpoint_auth_method:t.clientMetadata?.token_endpoint_auth_method||`none`,...r&&{scope:r}};if(d.debug(`Client metadata for DCR`,{clientMetadata:e}),!i.registration_endpoint)throw d.error(`DCR registration unsupported by auth server`,{authServer:o.toString(),eventType:S.DCR_FAILED,reason:`no_registration_endpoint`,serverUrl:s}),Error(`Authorization server does not support Dynamic Client Registration. No registration_endpoint found in metadata.`);d.info(`Registering client via DCR...`,{registrationEndpoint:i.registration_endpoint});try{h=await c(o,{clientMetadata:e,metadata:i})}catch(e){throw d.error(`DCR registration failed`,{authServer:o.toString(),error:String(e),eventType:S.DCR_FAILED,registrationEndpoint:i.registration_endpoint,serverUrl:s}),e}d.info(`Client registered successfully via DCR`,{clientId:h.client_id,clientName:h.client_name,clientSecretExpiresAt:h.client_secret_expires_at}),n&&await n.update(s,{clientInfo:h})}let y=crypto.randomUUID();d.debug(`Starting authorization flow...`);let{authorizationUrl:b,codeVerifier:x}=await l(o,{clientInformation:h,metadata:i,redirectUrl:m,scope:r,state:y});await _(b),d.debug(`Waiting for OAuth callback...`);let C=await p.waitForCallback();if(C.state!==y)throw d.error(`OAuth state mismatch — possible CSRF attack`,{authServer:o.toString(),eventType:S.STATE_MISMATCH,serverUrl:s}),Error(`OAuth state mismatch - possible CSRF attack`);d.info(`Authorization code received`,{codePrefix:`${C.code.substring(0,10)}...`}),d.debug(`Exchanging authorization code for tokens...`);let w;try{w=await a(o,{authorizationCode:C.code,clientInformation:h,codeVerifier:x,metadata:i,redirectUri:m})}catch(e){throw d.error(`Token exchange failed`,{authServer:o.toString(),clientId:h.client_id,error:String(e),eventType:S.TOKEN_EXCHANGE_FAILED,grantType:`authorization_code`,serverUrl:s}),e}if(d.info(`OAuth tokens obtained successfully`,{expiresIn:w.expires_in,hasRefreshToken:!!w.refresh_token,tokenType:w.token_type}),n){let e=new Date().toISOString();await n.update(s,{tokens:w,tokensObtainedAt:e}),d.info(`OAuth credentials persisted to disk`,{serverUrl:s})}return{clientInfo:h,fromCache:!1,tokens:w}}finally{await p.close()}}function B(e){let t=e?.trim().toLowerCase();return t?F[t]??`MCP Gateway`:`MCP Gateway`}function V(e,t,n){let r=e?.trim().toLowerCase();if(!r)return[n];let i=I[r];if(!i)return[n];let a;try{a=(t instanceof URL?t:new URL(t)).hostname.toLowerCase()}catch{return[n]}let o=i[a];return o?[o,n]:[n]}async function H(e,t){let n=typeof e==`string`?new URL(e):e,r=await t.load(n.toString());if(!(!r?.clientInfo||!r.tokens?.refresh_token))return K(n,r,t)}async function U(e,t,n,r){let i=e.tokenEndpoint,a=e.tokenEndpointAuthMethod||(e.clientSecret?`client_secret_post`:`none`),o=new URLSearchParams;o.set(`grant_type`,`authorization_code`),o.set(`code`,t),o.set(`redirect_uri`,n),r&&o.set(`code_verifier`,r);let s={Accept:`application/json`,"Content-Type":`application/x-www-form-urlencoded`};a===`client_secret_basic`&&e.clientSecret?s.Authorization=`Basic ${Buffer.from(`${e.clientId}:${e.clientSecret}`).toString(`base64`)}`:a===`client_secret_post`&&e.clientSecret?(o.set(`client_id`,e.clientId),o.set(`client_secret`,e.clientSecret)):o.set(`client_id`,e.clientId),d.debug(`Sending token request`,{authMethod:a,providerId:e.id,tokenEndpoint:i});let c=await fetch(i,{body:o.toString(),headers:s,method:`POST`});if(!c.ok){let t=await c.text();throw d.error(`Token exchange failed`,{authMethod:a,error:t,eventType:S.TOKEN_EXCHANGE_FAILED,grantType:`authorization_code`,httpStatus:c.status,providerId:e.id,tokenEndpoint:i}),Error(`Token exchange failed: ${c.status} ${t}`)}let l=c.headers.get(`content-type`)||``,u;if(l.includes(`application/json`))u=await c.json();else if(l.includes(`application/x-www-form-urlencoded`)||l.includes(`text/plain`)){let e=await c.text(),t=new URLSearchParams(e);u=Object.fromEntries(t.entries())}else{let e=await c.text();try{u=JSON.parse(e)}catch{let t=new URLSearchParams(e);u=Object.fromEntries(t.entries())}}return typeof u.expires_in==`string`&&(u.expires_in=parseInt(u.expires_in,10)),{access_token:u.access_token,expires_in:u.expires_in,refresh_token:u.refresh_token,scope:u.scope,token_type:u.token_type||`bearer`}}async function W(e,t,n,r,i){let a=e.toString(),o=n.callbackUrl,s={client_id:t.clientId,client_name:t.name,client_secret:t.clientSecret,redirect_uris:[o],token_endpoint_auth_method:t.tokenEndpointAuthMethod||(t.clientSecret?`client_secret_post`:`none`)};d.info(`Using pre-configured OAuth client`,{clientId:t.clientId,hasClientSecret:!!t.clientSecret,providerId:t.id,tokenEndpointAuthMethod:s.token_endpoint_auth_method});let c=i||t.scopes?.join(` `),l=t.usePkce!==!1,u,f,p;if(l){let{generateCodeChallenge:e,generateCodeVerifier:t}=await import(`./pkce-CYE2WffE.js`);u=t(),f=await e(u),p=`S256`}let m=new URL(t.authorizationEndpoint);m.searchParams.set(`client_id`,t.clientId),m.searchParams.set(`redirect_uri`,o),m.searchParams.set(`response_type`,`code`),c&&m.searchParams.set(`scope`,c);let h=crypto.randomUUID();m.searchParams.set(`state`,h),f&&p&&(m.searchParams.set(`code_challenge`,f),m.searchParams.set(`code_challenge_method`,p)),await _(m),d.debug(`Waiting for OAuth callback...`);let g=await n.waitForCallback();if(g.state!==h)throw d.error(`OAuth state mismatch — possible CSRF attack`,{eventType:S.STATE_MISMATCH,providerId:t.id,serverUrl:a}),Error(`OAuth state mismatch - possible CSRF attack`);d.info(`Authorization code received`,{codePrefix:`${g.code.substring(0,10)}...`,providerId:t.id}),d.debug(`Exchanging authorization code for tokens...`);let v=await U(t,g.code,o,u);if(d.info(`OAuth tokens obtained successfully`,{expiresIn:v.expires_in,hasRefreshToken:!!v.refresh_token,providerId:t.id,tokenType:v.token_type}),r){let e=new Date().toISOString();await r.update(a,{clientInfo:s,tokens:v,tokensObtainedAt:e}),d.info(`OAuth credentials persisted to disk`,{providerId:t.id,serverUrl:a})}return{clientInfo:s,fromCache:!1,tokens:v}}async function G(e,t){let n=await t.load(e.toString());if(!n){d.debug(`No stored credentials found`,{serverUrl:e.toString()});return}if(!n.clientInfo){d.debug(`Stored credentials have no client info`,{serverUrl:e.toString()});return}if(t.hasValidAccessToken(n)&&n.tokens)return d.info(`Using cached OAuth credentials with valid access token`,{clientId:n.clientInfo.client_id,serverUrl:e.toString()}),{clientInfo:n.clientInfo,fromCache:!0,tokens:n.tokens};if(t.hasRefreshToken(n)){let r=await K(e,n,t);if(r)return r}d.debug(`Stored credentials are expired and no valid refresh token`,{serverUrl:e.toString()})}async function K(e,t,n){if(!(!t.clientInfo||!t.tokens?.refresh_token)){d.info(`Attempting to refresh expired access token`,{clientId:t.clientInfo.client_id,serverUrl:e.toString()});try{let a;try{a=await i(e)}catch{}let o;o=a?.authorization_servers?.length?new URL(a.authorization_servers[0]):e;let c=await r(o),l=await s(o,{clientInformation:t.clientInfo,metadata:c,refreshToken:t.tokens.refresh_token});d.info(`Successfully refreshed access token`,{clientId:t.clientInfo.client_id,expiresIn:l.expires_in,hasNewRefreshToken:!!l.refresh_token});let u=l.refresh_token?l:{...l,refresh_token:t.tokens.refresh_token},f=new Date().toISOString();return await n.update(e.toString(),{tokens:u,tokensObtainedAt:f}),{clientInfo:t.clientInfo,fromCache:!0,tokens:u}}catch(r){let i=N(r);d.warn(i?`Refresh token rejected by OAuth server (invalid_grant); clearing stored tokens`:`Token refresh failed transiently; retaining refresh_token for the next attempt`,{clientId:t.clientInfo.client_id,error:String(r),eventType:S.REFRESH_FAILED,invalidGrant:i,serverUrl:e.toString()}),i&&await n.update(e.toString(),{tokens:void 0,tokensObtainedAt:void 0});return}}}const q=[`streamable-http`,`sse`];async function J(e,t,n,r){let{result:i,transportType:a}=await Z(async i=>{let a=e(),o=Y(t,i,n,r);return await a.connect(o),a});return{client:i,transportType:a}}function Y(e,r,i,a){let o=new URL(e);return r===`streamable-http`?new n(o,{fetch:a,requestInit:i}):new t(o,{fetch:a,requestInit:i})}function X(e){if(!e||typeof e!=`object`)return!1;let t=e.status,n=e.code,r=e.message;return!!(t===404||t===405||n===404||n===405||r&&/404|not found|405|method not allowed/i.test(String(r)))}async function Z(e){let t=[];for(let n of q)try{return{result:await e(n),transportType:n}}catch(e){if(X(e)){d.info(`${n} not supported, trying next transport...`),t.push({err:e,transport:n});continue}throw e}let n=t.map(({err:e,transport:t})=>{let n=e?.status;if(n!==void 0)return`${t}: ${n}`;let r=e instanceof Error?e.message:String(e);return`${t}: ${r}`}).join(`, `),r=t.length>0?Error(`all transports returned not-supported (${n})`):Error(`No compatible transport found`);throw r.cause=t,r}export{A as AuthServerDiscoveryError,J as connectWithTransportFallback,j as discoverAuthServer,L as getDcrClientName,R as getDcrRedirectUris,z as performOAuthFlow,H as tryRefreshCachedToken,Z as walkTransports};
136
+ //# sourceMappingURL=transportDetection-eBY0es0F.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"transportDetection-eBY0es0F.js","names":["command: string","args: string[]","resolveCallback: (result: CallbackServerResult) => void","rejectCallback: (error: Error) => void","timeoutRef: { id?: ReturnType<typeof setTimeout> }","boundPort: number","URL","attemptedPorts: number[]","lastError: Error | undefined","portToTry: number","authServerUrl: URL","cause: unknown","resourceMetadata: OAuthProtectedResourceMetadata | undefined","authMetadata: Awaited<ReturnType<typeof discoverAuthorizationServerMetadata>>","DCR_CLIENT_NAME_BY_APP: Record<string, string>","DECOY_REDIRECT_URI_BY_APP_AND_HOST: Record<string, Record<string, string>>","authMetadata: Awaited<ReturnType<typeof discoverAuthServer>>[\"authMetadata\"]","authServerUrl: URL","clientInfo: OAuthClientInformationFull","clientMetadata: OAuthClientMetadata","hostname: string","hostname","headers: Record<string, string>","tokenData: Record<string, unknown>","codeVerifier: string | undefined","codeChallenge: string | undefined","codeChallengeMethod: string | undefined","resourceMetadata: OAuthProtectedResourceMetadata | undefined","mergedTokens: OAuthTokens","TRANSPORT_PRIORITY: TransportType[]","client","transportType","failures: Array<{ err: unknown; transport: TransportType }>"],"sources":["../src/auth/browser.ts","../src/auth/events.ts","../src/auth/callbackServer.ts","../src/auth/discovery.ts","../src/auth/errors.ts","../src/auth/oauthFlow.ts","../src/lib/transportDetection.ts"],"sourcesContent":["import { execFile } from \"node:child_process\";\nimport { platform } from \"node:os\";\n\nimport { logger } from \"../lib/logger.js\";\n\n/**\n * Opens the given URL in the user's default browser.\n *\n * Cross-platform support:\n * - macOS: uses `open`\n * - Windows: uses PowerShell Start-Process with Base64-encoded command (injection-safe)\n * - Linux: uses `xdg-open`\n *\n * @param url The URL to open\n * @returns A promise that resolves when the browser command is executed\n */\nexport async function openBrowser(url: string | URL): Promise<void> {\n const urlString = url.toString();\n const os = platform();\n const redactedUrl = redactUrlForLogging(urlString);\n\n return new Promise((resolve, reject) => {\n let command: string;\n let args: string[];\n\n if (os === \"win32\") {\n // Windows - use PowerShell with Base64-encoded command to prevent injection\n // This is the same approach used by the popular 'open' npm package.\n // The command is Base64-encoded (UTF-16LE) so no shell metacharacters can escape.\n const psCommand = `Start-Process ${escapePowerShellArgument(urlString)}`;\n const encodedCommand = encodePowerShellCommand(psCommand);\n\n command = getPowerShellPath();\n args = [\"-NoProfile\", \"-NonInteractive\", \"-ExecutionPolicy\", \"Bypass\", \"-EncodedCommand\", encodedCommand];\n } else if (os === \"darwin\") {\n // macOS\n command = \"open\";\n args = [urlString];\n } else {\n // Linux and others - use xdg-open\n command = \"xdg-open\";\n args = [urlString];\n }\n\n execFile(command, args, (error, _stdout, stderr) => {\n if (error) {\n const errorContext = {\n command,\n os,\n stderr,\n url: redactedUrl,\n };\n\n logger.warn(\"Failed to open browser automatically\", {\n ...errorContext,\n error: error.message,\n });\n\n const launchError = new Error(\n `Failed to open browser: ${error.message} (command: ${command}, os: ${os}, url: ${redactedUrl})`\n );\n launchError.cause = error;\n reject(launchError);\n } else {\n logger.debug(\"Browser opened successfully\", { url: redactedUrl });\n resolve();\n }\n });\n });\n}\n\n/**\n * Encodes a PowerShell command as Base64 UTF-16LE for use with -EncodedCommand.\n * This is the safest way to pass commands to PowerShell as it prevents any\n * shell metacharacter interpretation.\n */\nfunction encodePowerShellCommand(command: string): string {\n // PowerShell's -EncodedCommand expects UTF-16LE encoded Base64\n const buffer = Buffer.from(command, \"utf16le\");\n return buffer.toString(\"base64\");\n}\n\n/**\n * Escapes a string for use as a PowerShell single-quoted string argument.\n * Single quotes inside the string are escaped by doubling them.\n */\nfunction escapePowerShellArgument(value: string): string {\n return `'${value.replaceAll(\"'\", \"''\")}'`;\n}\n\n/**\n * Gets the path to Windows PowerShell.\n * PowerShell is included by default since Windows 7 SP1 and Windows Server 2008 R2.\n */\nfunction getPowerShellPath(): string {\n const systemRoot = process.env.SYSTEMROOT || process.env.windir || \"C:\\\\Windows\";\n return `${systemRoot}\\\\System32\\\\WindowsPowerShell\\\\v1.0\\\\powershell.exe`;\n}\n\n/**\n * Redacts sensitive query parameters from a URL for safe logging.\n * Preserves the base URL structure while hiding potentially sensitive data.\n *\n * @param url The URL to redact\n * @returns A redacted version of the URL safe for logging\n */\nfunction redactUrlForLogging(url: string): string {\n try {\n const parsed = new URL(url);\n if (parsed.search) {\n return `${parsed.protocol}//${parsed.host}${parsed.pathname}?[REDACTED]`;\n }\n return `${parsed.protocol}//${parsed.host}${parsed.pathname}`;\n } catch {\n // If URL parsing fails, return a generic redacted string\n return \"[INVALID_URL]\";\n }\n}\n","/**\n * Structured `eventType` values emitted from the OAuth code paths in this\n * package. groundcover monitors filter on these strings, so renames here are\n * breaking changes for the monitoring pipeline — bump the monitor YAMLs in\n * the infrastructure repo when you change anything below.\n *\n * Naming convention: `mcp_auth_*_failed` for unrecoverable errors; the\n * `mcp_auth_performed` happy-path event lives in src/bin/main.ts because it\n * is emitted by the proxy boot code, not by this auth subpackage.\n */\nexport const AuthEventType = {\n /** OAuth callback server received error= or no code, or failed to parse. */\n CALLBACK_FAILED: \"mcp_auth_callback_failed\",\n /** registerClient threw or auth server has no registration_endpoint. */\n DCR_FAILED: \"mcp_auth_dcr_failed\",\n /** Refresh-token grant rejected by the auth server. */\n REFRESH_FAILED: \"mcp_auth_refresh_failed\",\n /**\n * `discoverAuthorizationServerMetadata` threw, or returned an empty\n * document. NOTE: resource-metadata soft-fails are NOT emitted as failed\n * events — the SDK silently falls back to using the server URL as the\n * auth server, which is expected for some MCP servers.\n */\n SERVER_METADATA_FAILED: \"mcp_auth_server_metadata_failed\",\n /** OAuth state parameter mismatch — possible CSRF, definitely a failure. */\n STATE_MISMATCH: \"mcp_auth_state_mismatch\",\n /** Authorization-code or refresh-token POST to /token failed (non-2xx). */\n TOKEN_EXCHANGE_FAILED: \"mcp_auth_token_exchange_failed\",\n} as const;\n\nexport type AuthEventType = (typeof AuthEventType)[keyof typeof AuthEventType];\n","import { createServer, type Server } from \"node:http\";\nimport { URL } from \"node:url\";\n\nimport { logger } from \"../lib/logger.js\";\nimport { AuthEventType } from \"./events.js\";\n\n/**\n * Port range for OAuth callback server (IANA dynamic/private ports)\n */\nconst MIN_PORT = 49152;\nconst MAX_PORT = 65535;\nconst MAX_PORT_ATTEMPTS = 5;\n\nexport interface CallbackServerOptions {\n /**\n * Maximum number of port binding attempts before giving up.\n * Default: 5\n */\n maxAttempts?: number;\n /**\n * Preferred port to use. If unavailable, random ports will be tried.\n */\n preferredPort?: number;\n /**\n * MCP server URL whose OAuth flow this callback is serving. Threaded\n * through to the callback's error logs so groundcover monitors can\n * attribute mcp_auth_callback_failed events to a specific remote.\n * Optional — when omitted, the field is simply absent from the logs.\n */\n serverUrl?: string;\n /**\n * Timeout in milliseconds to wait for the callback.\n * Default: 5 minutes (300000ms)\n */\n timeoutMs?: number;\n}\n\nexport interface CallbackServerResult {\n /**\n * The authorization code received from the OAuth server.\n */\n code: string;\n /**\n * The state parameter, if provided.\n */\n state?: string;\n}\n\n/**\n * Generates a random port number in the dynamic/private port range.\n */\nfunction getRandomPort(): number {\n return Math.floor(Math.random() * (MAX_PORT - MIN_PORT + 1)) + MIN_PORT;\n}\n\n/**\n * Attempts to start the HTTP server on the given port.\n * Returns a promise that resolves with the server if successful, or rejects if the port is in use.\n */\nfunction tryListenOnPort(server: Server, port: number): Promise<void> {\n return new Promise<void>((resolve, reject) => {\n const onError = (err: NodeJS.ErrnoException) => {\n server.removeListener(\"listening\", onListening);\n reject(err);\n };\n\n const onListening = () => {\n server.removeListener(\"error\", onError);\n resolve();\n };\n\n server.once(\"error\", onError);\n server.once(\"listening\", onListening);\n server.listen(port, \"127.0.0.1\");\n });\n}\n\nconst DEFAULT_TIMEOUT_MS = 5 * 60 * 1000; // 5 minutes\n\n/**\n * HTML page shown to the user after successful authorization.\n */\nconst SUCCESS_HTML = `<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n <meta charset=\"UTF-8\">\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n <title>Authorization Successful</title>\n <style>\n body {\n font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;\n display: flex;\n justify-content: center;\n align-items: center;\n min-height: 100vh;\n margin: 0;\n background: linear-gradient(135deg, #1a1a2e 0%, #16213e 100%);\n color: #fff;\n }\n .container {\n text-align: center;\n padding: 2rem;\n }\n .checkmark {\n width: 80px;\n height: 80px;\n border-radius: 50%;\n background: #10b981;\n display: flex;\n align-items: center;\n justify-content: center;\n margin: 0 auto 1.5rem;\n animation: pop 0.3s ease-out;\n }\n .checkmark svg {\n width: 40px;\n height: 40px;\n stroke: white;\n stroke-width: 3;\n }\n h1 {\n margin: 0 0 0.5rem;\n font-size: 1.75rem;\n font-weight: 600;\n }\n p {\n margin: 0;\n color: #a0aec0;\n font-size: 1rem;\n }\n @keyframes pop {\n 0% { transform: scale(0); }\n 50% { transform: scale(1.1); }\n 100% { transform: scale(1); }\n }\n </style>\n</head>\n<body>\n <div class=\"container\">\n <div class=\"checkmark\">\n <svg viewBox=\"0 0 24 24\" fill=\"none\">\n <path d=\"M5 13l4 4L19 7\" stroke-linecap=\"round\" stroke-linejoin=\"round\"/>\n </svg>\n </div>\n <h1>Authorization Successful</h1>\n <p>You can close this window and return to the terminal.</p>\n </div>\n <script>setTimeout(() => window.close(), 3000);</script>\n</body>\n</html>`;\n\n/**\n * Starts a local HTTP server to receive the OAuth callback.\n * Uses random port selection with retry logic to handle port conflicts.\n *\n * @returns A promise that resolves with the port number and a function to wait for the callback.\n */\nexport async function startCallbackServer(options: CallbackServerOptions = {}): Promise<{\n callbackUrl: string;\n close: () => Promise<void>;\n port: number;\n waitForCallback: () => Promise<CallbackServerResult>;\n}> {\n const { maxAttempts = MAX_PORT_ATTEMPTS, preferredPort, serverUrl, timeoutMs = DEFAULT_TIMEOUT_MS } = options;\n // Strip userinfo + query params before logging — a configured MCP URL\n // can carry tokens or basic-auth credentials, and these errors get\n // persisted to logs/alerts. Keep the protocol+host+path so the log is\n // still useful for triage.\n const safeServerUrl = serverUrl ? sanitizeServerUrl(serverUrl) : undefined;\n\n let resolveCallback: (result: CallbackServerResult) => void;\n let rejectCallback: (error: Error) => void;\n // Using an object to hold the timeout ID so it can be set after server creation\n // but still referenced in the close() function\n const timeoutRef: { id?: ReturnType<typeof setTimeout> } = {};\n\n const callbackPromise = new Promise<CallbackServerResult>((resolve, reject) => {\n resolveCallback = resolve;\n rejectCallback = reject;\n });\n\n // Track the actual bound port for use in request handler\n let boundPort: number;\n\n const server = createServer((req, res) => {\n // Ignore favicon requests\n if (req.url === \"/favicon.ico\") {\n res.writeHead(404);\n res.end();\n return;\n }\n\n // Only handle the callback path\n if (!req.url?.startsWith(\"/callback\")) {\n res.writeHead(404);\n res.end(\"Not Found\");\n return;\n }\n\n try {\n const parsedUrl = new URL(req.url, `http://localhost:${boundPort}`);\n const code = parsedUrl.searchParams.get(\"code\");\n const error = parsedUrl.searchParams.get(\"error\");\n const errorDescription = parsedUrl.searchParams.get(\"error_description\");\n const state = parsedUrl.searchParams.get(\"state\");\n\n if (error) {\n logger.error(\"OAuth authorization error\", {\n error,\n errorDescription,\n eventType: AuthEventType.CALLBACK_FAILED,\n ...(safeServerUrl ? { serverUrl: safeServerUrl } : {}),\n });\n res.writeHead(400, { \"Content-Type\": \"text/html\" });\n res.end(getErrorHtml(error, errorDescription || undefined));\n clearTimeout(timeoutRef.id);\n rejectCallback(\n new Error(`OAuth authorization failed: ${error}${errorDescription ? ` - ${errorDescription}` : \"\"}`)\n );\n return;\n }\n\n if (!code) {\n logger.error(\"OAuth callback missing authorization code\", {\n eventType: AuthEventType.CALLBACK_FAILED,\n reason: \"missing_code\",\n ...(safeServerUrl ? { serverUrl: safeServerUrl } : {}),\n });\n res.writeHead(400, { \"Content-Type\": \"text/html\" });\n res.end(getErrorHtml(\"missing_code\", \"No authorization code was provided\"));\n clearTimeout(timeoutRef.id);\n rejectCallback(new Error(\"OAuth callback missing authorization code\"));\n return;\n }\n\n logger.info(\"OAuth authorization code received\", {\n codePrefix: `${code.substring(0, 10)}...`,\n hasState: !!state,\n });\n\n res.writeHead(200, { \"Content-Type\": \"text/html\" });\n res.end(SUCCESS_HTML);\n\n clearTimeout(timeoutRef.id);\n resolveCallback({ code, state: state || undefined });\n\n // Close server after a short delay to ensure response is sent\n setTimeout(() => server.close(), 1000);\n } catch (err) {\n logger.error(\"Error processing OAuth callback\", {\n error: String(err),\n eventType: AuthEventType.CALLBACK_FAILED,\n reason: \"callback_processing_error\",\n ...(safeServerUrl ? { serverUrl: safeServerUrl } : {}),\n });\n res.writeHead(500);\n res.end(\"Internal Server Error\");\n clearTimeout(timeoutRef.id);\n rejectCallback(err instanceof Error ? err : new Error(String(err)));\n }\n });\n\n // Set up timeout (now that server exists)\n timeoutRef.id = setTimeout(() => {\n rejectCallback(new Error(`OAuth callback timeout after ${timeoutMs}ms`));\n server.close();\n }, timeoutMs);\n\n // Try to bind to a port with retry logic\n const attemptedPorts: number[] = [];\n let lastError: Error | undefined;\n\n while (attemptedPorts.length < maxAttempts) {\n // First attempt uses preferred port if provided, otherwise random\n let portToTry: number;\n if (attemptedPorts.length === 0 && preferredPort !== undefined) {\n portToTry = preferredPort;\n } else {\n // Generate a random port that hasn't been tried yet\n portToTry = getRandomPort();\n while (attemptedPorts.includes(portToTry)) {\n portToTry = getRandomPort();\n }\n }\n attemptedPorts.push(portToTry);\n\n try {\n await tryListenOnPort(server, portToTry);\n boundPort = portToTry;\n const callbackUrl = `http://localhost:${boundPort}/callback`;\n logger.info(\"OAuth callback server started\", { attempt: attemptedPorts.length, callbackUrl, port: boundPort });\n\n return {\n callbackUrl,\n close: () =>\n new Promise<void>((resolve) => {\n clearTimeout(timeoutRef.id);\n server.close(() => resolve());\n // Browsers hold the keep-alive socket open after the OAuth success\n // page loads. Without forcing existing connections closed, Node's\n // server.close() waits indefinitely for them to drain and the\n // OAuth flow hangs after persisting tokens.\n server.closeAllConnections();\n }),\n port: boundPort,\n waitForCallback: () => callbackPromise,\n };\n } catch (err) {\n const nodeErr = err as NodeJS.ErrnoException;\n if (nodeErr.code === \"EADDRINUSE\") {\n logger.debug(\"Port in use, trying another port\", {\n attempt: attemptedPorts.length,\n maxAttempts,\n port: portToTry,\n });\n lastError = new Error(`Port ${portToTry} is already in use`);\n } else {\n // For non-EADDRINUSE errors, clean up and throw immediately\n clearTimeout(timeoutRef.id);\n server.close();\n throw err;\n }\n }\n }\n\n // All attempts failed\n clearTimeout(timeoutRef.id);\n server.close();\n throw new Error(\n `Failed to start OAuth callback server after ${maxAttempts} attempts. ` +\n `Tried ports: ${attemptedPorts.join(\", \")}. Last error: ${lastError?.message || \"unknown\"}`\n );\n}\n\nfunction escapeHtml(text: string): string {\n return text\n .replace(/&/g, \"&amp;\")\n .replace(/</g, \"&lt;\")\n .replace(/>/g, \"&gt;\")\n .replace(/\"/g, \"&quot;\")\n .replace(/'/g, \"&#039;\");\n}\n\n/**\n * HTML page shown to the user when authorization fails.\n */\nfunction getErrorHtml(error: string, description?: string): string {\n return `<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n <meta charset=\"UTF-8\">\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n <title>Authorization Failed</title>\n <style>\n body {\n font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;\n display: flex;\n justify-content: center;\n align-items: center;\n min-height: 100vh;\n margin: 0;\n background: linear-gradient(135deg, #1a1a2e 0%, #16213e 100%);\n color: #fff;\n }\n .container {\n text-align: center;\n padding: 2rem;\n max-width: 400px;\n }\n .error-icon {\n width: 80px;\n height: 80px;\n border-radius: 50%;\n background: #ef4444;\n display: flex;\n align-items: center;\n justify-content: center;\n margin: 0 auto 1.5rem;\n }\n .error-icon svg {\n width: 40px;\n height: 40px;\n stroke: white;\n stroke-width: 3;\n }\n h1 {\n margin: 0 0 0.5rem;\n font-size: 1.75rem;\n font-weight: 600;\n }\n .error-code {\n color: #f87171;\n font-family: monospace;\n margin-bottom: 0.5rem;\n }\n p {\n margin: 0;\n color: #a0aec0;\n font-size: 1rem;\n }\n </style>\n</head>\n<body>\n <div class=\"container\">\n <div class=\"error-icon\">\n <svg viewBox=\"0 0 24 24\" fill=\"none\">\n <path d=\"M6 18L18 6M6 6l12 12\" stroke-linecap=\"round\" stroke-linejoin=\"round\"/>\n </svg>\n </div>\n <h1>Authorization Failed</h1>\n <p class=\"error-code\">${escapeHtml(error)}</p>\n ${description ? `<p>${escapeHtml(description)}</p>` : \"\"}\n </div>\n</body>\n</html>`;\n}\n\n/**\n * Strip credentials and query params from a URL before logging. Keeps\n * protocol + host + path so the log is still useful for triage. Returns\n * the original string when parsing fails (better to over-log than to\n * silently drop the attribution field).\n */\nfunction sanitizeServerUrl(url: string): string {\n try {\n const u = new URL(url);\n u.username = \"\";\n u.password = \"\";\n u.search = \"\";\n u.hash = \"\";\n return u.toString();\n } catch {\n return url;\n }\n}\n","import {\n discoverAuthorizationServerMetadata,\n discoverOAuthProtectedResourceMetadata,\n} from \"@modelcontextprotocol/sdk/client/auth.js\";\nimport type { OAuthProtectedResourceMetadata } from \"@modelcontextprotocol/sdk/shared/auth.js\";\n\nexport interface DiscoverAuthServerOptions {\n /**\n * Optional logger. When provided, emits the same debug/info/warn lines that\n * `performOAuthFlow` used to emit inline. When omitted, discovery runs\n * silently.\n */\n logger?: DiscoveryLogger;\n /**\n * Optional AbortSignal, threaded into both SDK discovery calls via a fetch\n * wrapper. When omitted, the SDK calls are made with no fetch override —\n * preserving the existing `performOAuthFlow` call shape exactly.\n */\n signal?: AbortSignal;\n}\n\n/**\n * Minimal logging surface used by the discovery helper. Matches the shape of\n * `../lib/logger.ts`'s singleton so callers can pass it directly. Omit to run\n * discovery silently (the probe's call pattern).\n */\nexport interface DiscoveryLogger {\n debug(message: string, meta?: Record<string, unknown>): void;\n info(message: string, meta?: Record<string, unknown>): void;\n warn(message: string, meta?: Record<string, unknown>): void;\n}\n\nexport interface DiscoveryResult {\n /** Auth-server metadata. May be undefined — caller decides how to respond. */\n authMetadata: Awaited<ReturnType<typeof discoverAuthorizationServerMetadata>>;\n /**\n * The chosen auth server URL: the first entry of `resourceMetadata.authorization_servers`\n * when present, otherwise `serverUrl` itself.\n */\n authServerUrl: URL;\n /** Protected-resource metadata. Undefined when the document is missing or lookup soft-failed. */\n resourceMetadata: OAuthProtectedResourceMetadata | undefined;\n}\n\n/**\n * Thrown when `discoverAuthorizationServerMetadata` fails. Preserves the\n * computed `authServerUrl` so callers can include it in error messages /\n * probe results — the pre-refactor inline code had it in scope naturally.\n */\nexport class AuthServerDiscoveryError extends Error {\n constructor(\n public readonly authServerUrl: URL,\n public readonly cause: unknown\n ) {\n const msg = cause instanceof Error ? cause.message : String(cause);\n super(`Auth server metadata discovery failed for ${authServerUrl}: ${msg}`);\n this.name = \"AuthServerDiscoveryError\";\n }\n}\n\n/**\n * Runs the OAuth metadata discovery sequence shared by the full OAuth flow and\n * the install-time DCR probe:\n *\n * 1. Look up the protected-resource metadata (soft-fails on error).\n * 2. Pick the auth server URL — the first `authorization_servers` entry, or\n * `serverUrl` as a fallback.\n * 3. Look up the auth-server metadata. Throws iff the SDK call itself throws;\n * does NOT throw when the SDK returns undefined (caller decides).\n *\n * No policy decisions baked in — both callers (`performOAuthFlow` and `probeOne`)\n * apply their own handling to the result.\n */\nexport async function discoverAuthServer(\n serverUrl: URL,\n options: DiscoverAuthServerOptions = {}\n): Promise<DiscoveryResult> {\n const { logger, signal } = options;\n const fetchFn = signal ? signaledFetch(signal) : undefined;\n\n logger?.debug(\"Discovering OAuth protected resource metadata...\");\n let resourceMetadata: OAuthProtectedResourceMetadata | undefined;\n try {\n // Preserve the exact SDK call arity used by performOAuthFlow when no\n // signal is provided (single-arg form) — some SDKs treat an explicit\n // `undefined` differently from an omitted arg.\n resourceMetadata = fetchFn\n ? await discoverOAuthProtectedResourceMetadata(serverUrl, undefined, fetchFn)\n : await discoverOAuthProtectedResourceMetadata(serverUrl);\n logger?.info(\"Discovered protected resource metadata\", {\n authorizationServers: resourceMetadata?.authorization_servers,\n resource: resourceMetadata?.resource,\n scopesSupported: resourceMetadata?.scopes_supported,\n });\n } catch (err) {\n logger?.warn(\"Could not discover protected resource metadata, will try direct discovery\", {\n error: String(err),\n });\n }\n\n let authServerUrl: URL;\n if (resourceMetadata?.authorization_servers?.length) {\n authServerUrl = new URL(resourceMetadata.authorization_servers[0]);\n logger?.debug(\"Using authorization server from resource metadata\", {\n authServerUrl: authServerUrl.toString(),\n });\n } else {\n authServerUrl = serverUrl;\n logger?.debug(\"Using server URL as authorization server\", {\n authServerUrl: authServerUrl.toString(),\n });\n }\n\n logger?.debug(\"Discovering authorization server metadata...\");\n let authMetadata: Awaited<ReturnType<typeof discoverAuthorizationServerMetadata>>;\n try {\n authMetadata = fetchFn\n ? await discoverAuthorizationServerMetadata(authServerUrl, { fetchFn })\n : await discoverAuthorizationServerMetadata(authServerUrl);\n } catch (err) {\n throw new AuthServerDiscoveryError(authServerUrl, err);\n }\n\n if (authMetadata) {\n logger?.info(\"Discovered authorization server metadata\", {\n authorizationEndpoint: authMetadata.authorization_endpoint,\n issuer: authMetadata.issuer,\n registrationEndpoint: authMetadata.registration_endpoint,\n tokenEndpoint: authMetadata.token_endpoint,\n });\n }\n\n return { authMetadata, authServerUrl, resourceMetadata };\n}\n\n/** Wraps global fetch so the SDK inherits a caller-supplied AbortSignal. */\nfunction signaledFetch(probeSignal: AbortSignal): typeof fetch {\n return (input, init) => {\n const sdkSignal = init?.signal;\n const combined =\n sdkSignal ? AbortSignal.any([probeSignal, sdkSignal]) : probeSignal;\n return fetch(input, { ...init, signal: combined });\n };\n}\n","import { OAuthError } from \"@modelcontextprotocol/sdk/server/auth/errors.js\";\n\n/**\n * Detects whether an error from `refreshAuthorization` (or any OAuth token-endpoint\n * call) represents the spec-defined `invalid_grant` response.\n *\n * Per RFC 6749 §5.2, `invalid_grant` is the only error code that means the\n * refresh_token itself is dead. All other errors (network failures, timeouts,\n * 5xx, rate limits, etc.) are transient or unrelated to the refresh_token's\n * validity and MUST NOT trigger destructive credential cleanup.\n *\n * Returns false on anything ambiguous — the safer default, since wrongly\n * classifying a transient error as `invalid_grant` would wipe a perfectly good\n * refresh_token and force the user through a browser re-auth.\n *\n * String comparisons here are intentionally case-sensitive lowercase. RFC 6749\n * §5.2 defines `error` as a case-sensitive ASCII token; the spec value is\n * always lowercase `invalid_grant`. Non-compliant servers that return\n * `INVALID_GRANT` are out of scope — being permissive on case would risk\n * false positives on similarly-cased non-OAuth errors.\n */\nexport function isInvalidGrantError(error: unknown): boolean {\n return checkInvalidGrant(error, new WeakSet());\n}\n\n/**\n * Recursively unwraps the common shapes a refresh failure can arrive in.\n * The MCP SDK's `refreshAuthorization` typically throws an `OAuthError`\n * subclass when the response was a well-formed RFC 6749 error body, but\n * non-spec-compliant servers, intermediate proxies, and downstream wrappers\n * can produce:\n *\n * - plain `{ error: \"invalid_grant\" }`\n * - `{ response: { body: { error: \"invalid_grant\" }}}` (some SDK wraps)\n * - `{ data: { error: \"invalid_grant\" }}` (other SDK wraps)\n * - an `Error` whose `.cause` carries any of the above (Node.js error chain)\n * - an `Error` whose `.message` mentions `invalid_grant` as last resort\n *\n * The `seen` set prevents infinite recursion on cyclic `.cause` chains\n * (rare but possible).\n */\nfunction checkInvalidGrant(error: unknown, seen: WeakSet<object>): boolean {\n if (error == null) return false;\n\n // SDK OAuth error class (covers the happy path)\n if (error instanceof OAuthError) {\n return error.errorCode === \"invalid_grant\";\n }\n\n // Cycle guard for nested .cause / .response / .data traversal\n if (typeof error === \"object\") {\n if (seen.has(error)) return false;\n seen.add(error);\n\n // Plain RFC 6749 error body\n const errField = (error as { error?: unknown }).error;\n if (typeof errField === \"string\" && errField === \"invalid_grant\") {\n return true;\n }\n\n // Common SDK wrap shapes — each may itself contain the error body\n for (const key of [\"response\", \"data\", \"body\", \"cause\"] as const) {\n const inner = (error as Record<string, unknown>)[key];\n if (inner !== undefined && checkInvalidGrant(inner, seen)) return true;\n }\n }\n\n // Message-based fallback as the LAST resort. Some SDK wrappers stringify\n // the RFC 6749 error envelope into the Error's `message` instead of\n // preserving structured `.cause` / `.response` / `.data`. Recognize those\n // cases — but ONLY when the message looks like a serialized error envelope,\n // not when \"invalid_grant\" merely appears as a token somewhere in the prose\n // (e.g., enum listings or negation: `\"expected one of: invalid_grant, ...\"`\n // or `\"not the invalid_grant code\"`). False positives here are expensive:\n // they wipe a perfectly good refresh_token. Require the textual shape of\n // an actual error assignment: a quoted JSON field, an `error=invalid_grant`\n // form-encoded assignment, or an `error: invalid_grant` colon assignment.\n if (error instanceof Error && typeof error.message === \"string\") {\n return (\n /\"error\"\\s*:\\s*\"invalid_grant\"/.test(error.message) ||\n /\\berror\\s*=\\s*invalid_grant\\b/.test(error.message) ||\n /\\berror\\s*:\\s*invalid_grant\\b/.test(error.message)\n );\n }\n\n return false;\n}\n","import {\n discoverAuthorizationServerMetadata,\n discoverOAuthProtectedResourceMetadata,\n exchangeAuthorization,\n extractResourceMetadataUrl,\n refreshAuthorization,\n registerClient,\n startAuthorization,\n} from \"@modelcontextprotocol/sdk/client/auth.js\";\nimport type {\n OAuthClientInformationFull,\n OAuthClientMetadata,\n OAuthProtectedResourceMetadata,\n OAuthTokens,\n} from \"@modelcontextprotocol/sdk/shared/auth.js\";\n\nimport type { OAuthProviderConfig } from \"../config/config.js\";\nimport { config } from \"../config/env.js\";\nimport { logger } from \"../lib/logger.js\";\nimport { normalizeUrl } from \"../utils/normalizeUrl.js\";\nimport { openBrowser } from \"./browser.js\";\nimport { startCallbackServer } from \"./callbackServer.js\";\nimport { AuthServerDiscoveryError, discoverAuthServer } from \"./discovery.js\";\nimport { isInvalidGrantError } from \"./errors.js\";\nimport { AuthEventType } from \"./events.js\";\nimport type { OAuthCredentialStore, StoredCredentials } from \"./OAuthCredentialStore.js\";\nimport { findProviderForUrl } from \"./providers.js\";\n\n// Maps CLIENT_APP_NAME (set by the scanner installer per agent) to the\n// human-friendly client_name we present during Dynamic Client Registration.\nconst DCR_CLIENT_NAME_BY_APP: Record<string, string> = {\n \"claude-code\": \"Claude Code (mcp-gateway)\",\n codex: \"Codex\",\n copilot: \"Visual Studio Code\",\n cursor: \"Cursor\",\n opencode: \"OpenCode\",\n};\n\n// Per-(agent, server-host) decoy redirect_uri used at DCR-registration time only.\n//\n// Some auth servers (notably Figma) gate Dynamic Client Registration on\n// `redirect_uris[0].scheme`. They allowlist schemes owned by registered\n// partners (e.g. `cursor://` for Cursor.app's native OAuth) but reject\n// `http://localhost:*` for those same agents. The gateway can't use\n// `cursor://` for its actual callback (the URL would route to Cursor.app via\n// macOS Launch Services, not to our local HTTP listener), so for affected\n// (agent, server) pairs we register BOTH URIs with the decoy at index 0:\n//\n// redirect_uris: [<decoy>, \"http://localhost:<port>/callback\"]\n//\n// Allowlist clause passes because index 0 carries the registered scheme;\n// the actual OAuth flow uses the localhost URI by selecting it at the\n// authorize step via the `redirect_uri` query parameter (RFC 6749 §3.1.2.3:\n// the auth server must honor any registered URI the client requests).\n//\n// The decoy URI is NEVER used to receive a callback; it exists purely to\n// satisfy the registration-time scheme check.\n//\n// Keyed on (agent, server-host) rather than agent alone so the decoy only\n// fires for known-figma-like servers. Some servers (e.g. asana) actively\n// reject unknown `cursor://` URIs with `invalid_redirect_uri` — applying\n// the decoy to them would silently break cursor for that server. Exact-host\n// match keeps the override surgical.\nconst DECOY_REDIRECT_URI_BY_APP_AND_HOST: Record<string, Record<string, string>> = {\n cursor: {\n \"mcp.figma.com\": \"cursor://anysphere.cursor-mcp/oauth/callback\",\n },\n};\n\nexport interface OAuthFlowOptions {\n /**\n * Custom client metadata for DCR registration.\n * If not provided, default metadata will be used.\n */\n clientMetadata?: Partial<OAuthClientMetadata>;\n /**\n * Credential store for persisting OAuth credentials.\n * If provided, credentials will be loaded from and saved to disk.\n */\n credentialStore?: OAuthCredentialStore;\n /**\n * OAuth scope to request.\n */\n scope?: string;\n /**\n * Timeout in milliseconds for the OAuth callback.\n * Default: 5 minutes\n */\n timeoutMs?: number;\n}\n\nexport interface OAuthFlowResult {\n clientInfo: OAuthClientInformationFull;\n /**\n * Whether the result came from stored credentials (true) or a fresh OAuth flow (false).\n */\n fromCache?: boolean;\n tokens: OAuthTokens;\n}\n\n/**\n * Attempts to detect if a server requires OAuth by making a test request.\n * Returns the resource metadata URL from the WWW-Authenticate header if OAuth is required.\n *\n * @param serverUrl The MCP server URL to check\n * @returns The resource metadata URL if OAuth is required, undefined otherwise\n */\nexport async function detectOAuthRequirement(serverUrl: string | URL): Promise<undefined | URL> {\n // Normalize URL to avoid redirect issues on Windows\n const normalizedUrl = normalizeUrl(serverUrl);\n const serverUrlObj = new URL(normalizedUrl);\n\n try {\n const response = await fetch(serverUrlObj, {\n headers: {\n Accept: \"application/json\",\n },\n method: \"POST\",\n });\n\n if (response.status === 401) {\n // Check for resource metadata URL in response\n const resourceMetadataUrl = extractResourceMetadataUrl(response);\n if (resourceMetadataUrl) {\n logger.debug(\"OAuth required, found resource metadata URL\", {\n resourceMetadataUrl: resourceMetadataUrl.toString(),\n });\n return resourceMetadataUrl;\n }\n\n // Check WWW-Authenticate header for Bearer realm\n const wwwAuth = response.headers.get(\"WWW-Authenticate\");\n if (wwwAuth && wwwAuth.toLowerCase().includes(\"bearer\")) {\n logger.debug(\"OAuth required based on WWW-Authenticate header\", { wwwAuth });\n return undefined; // OAuth required but no metadata URL\n }\n }\n\n return undefined;\n } catch (err) {\n logger.debug(\"Error detecting OAuth requirement\", { error: String(err) });\n return undefined;\n }\n}\n\n/**\n * Returns the DCR `client_name` to advertise based on the current\n * `CLIENT_APP_NAME` env var. Exported so the probe (`src/probe/index.ts`)\n * can use the exact same value the runtime OAuth flow would send — this is\n * how allowlist-style DCR endpoints (e.g., Figma) get the same answer from\n * both paths, instead of probe seeing `\"MCP Gateway\"` (rejected) while the\n * runtime flow sees the agent-specific name (accepted).\n */\nexport function getDcrClientName(): string {\n return resolveDcrClientName(config.clientAppName);\n}\n\n/**\n * Returns the `redirect_uris` array to register at DCR.\n *\n * For (agent, server-host) pairs listed in `DECOY_REDIRECT_URI_BY_APP_AND_HOST`,\n * the decoy URI is prepended at index 0 to satisfy allowlist-style DCR\n * endpoints that gate on `redirect_uris[0].scheme`. The real localhost URI\n * is at index 1 and is what the gateway selects at the authorize step via\n * the `redirect_uri` query parameter.\n *\n * For all other pairs the registered array is just `[localRedirectUrl]`,\n * preserving existing behavior.\n *\n * Exported so the probe (`src/probe/index.ts`) can use the exact same shape\n * the runtime OAuth flow would send — without this, the probe and runtime\n * would register different redirect_uris arrays for the same (agent,\n * server), and allowlist-style endpoints could give divergent verdicts.\n */\nexport function getDcrRedirectUris(serverUrl: string | URL, localRedirectUrl: string): string[] {\n return resolveDcrRedirectUris(config.clientAppName, serverUrl, localRedirectUrl);\n}\n\n/**\n * Performs the complete OAuth 2.0 Authorization Code flow with DCR.\n *\n * This function:\n * 1. Checks for existing valid credentials (if credentialStore provided)\n * 2. Attempts token refresh if access token expired (if credentialStore provided)\n * 3. Discovers OAuth protected resource metadata\n * 4. Discovers authorization server metadata\n * 5. Dynamically registers the client (DCR)\n * 6. Opens browser for user authorization\n * 7. Waits for the callback with authorization code\n * 8. Exchanges the code for tokens\n * 9. Persists credentials (if credentialStore provided)\n *\n * @param serverUrl The MCP server URL that requires OAuth\n * @param options Optional configuration\n * @returns The client info and tokens from successful authorization\n */\nexport async function performOAuthFlow(\n serverUrl: string | URL,\n options: OAuthFlowOptions = {}\n): Promise<OAuthFlowResult> {\n const { credentialStore, scope, timeoutMs } = options;\n // Normalize URL to avoid redirect issues on Windows (POST to GET conversion)\n const serverUrlString = normalizeUrl(serverUrl);\n const serverUrlObj = new URL(serverUrlString);\n\n logger.info(\"Starting OAuth flow\", { serverUrl: serverUrlString });\n\n // Step 0: Check for existing valid credentials\n if (credentialStore) {\n const existingCredentials = await tryLoadExistingCredentials(serverUrlObj, credentialStore);\n if (existingCredentials) {\n logger.info(\"Using existing OAuth credentials\", {\n clientId: existingCredentials.clientInfo.client_id,\n serverUrl: serverUrlString,\n });\n return existingCredentials;\n }\n }\n\n // Step 1: Start the callback server to get a dynamic port. Threading\n // serverUrl in lets the callback's error logs carry it for monitoring.\n logger.debug(\"Starting OAuth callback server...\");\n const callbackServer = await startCallbackServer({ serverUrl: serverUrlString, timeoutMs });\n const redirectUrl = callbackServer.callbackUrl;\n\n logger.info(\"OAuth callback server started\", {\n callbackUrl: redirectUrl,\n port: callbackServer.port,\n });\n\n try {\n // Step 2: Check for pre-configured OAuth provider (non-DCR servers)\n const preConfiguredProvider = findProviderForUrl(serverUrlObj);\n\n if (preConfiguredProvider) {\n logger.info(\"Using pre-configured OAuth provider\", {\n providerId: preConfiguredProvider.id,\n providerName: preConfiguredProvider.name,\n });\n\n // Use pre-configured provider flow - pass the callback server instance\n return await performPreConfiguredProviderFlow(\n serverUrlObj,\n preConfiguredProvider,\n callbackServer,\n credentialStore,\n scope\n );\n }\n\n // Steps 3-5: Discover OAuth protected-resource + authorization-server metadata.\n // The helper emits the same debug/info/warn log lines that used to live inline\n // here — passing `logger` preserves the existing observable log output.\n let authMetadata: Awaited<ReturnType<typeof discoverAuthServer>>[\"authMetadata\"];\n let authServerUrl: URL;\n try {\n ({ authMetadata, authServerUrl } = await discoverAuthServer(serverUrlObj, { logger }));\n } catch (err) {\n // AuthServerDiscoveryError carries the chosen authServerUrl. Other\n // errors (rare — only the resource-metadata fetch swallows its own\n // errors) won't have one to attribute, so omit the field.\n logger.error(\"Auth server metadata discovery failed\", {\n error: String(err),\n eventType: AuthEventType.SERVER_METADATA_FAILED,\n serverUrl: serverUrlString,\n ...(err instanceof AuthServerDiscoveryError ? { authServer: err.authServerUrl.toString() } : {}),\n });\n throw err;\n }\n\n if (!authMetadata) {\n logger.error(\"Auth server metadata absent (server may not support OAuth 2.0)\", {\n authServer: authServerUrl.toString(),\n eventType: AuthEventType.SERVER_METADATA_FAILED,\n reason: \"metadata_absent\",\n serverUrl: serverUrlString,\n });\n throw new Error(\n `Could not discover OAuth metadata from ${authServerUrl}. ` +\n `The server may not support OAuth 2.0 or the metadata endpoint is not accessible.`\n );\n }\n\n // Step 6: Check if we have existing client info that can be reused\n let clientInfo: OAuthClientInformationFull;\n const existingCredentials = credentialStore ? await credentialStore.load(serverUrlString) : undefined;\n\n // Check if existing client registration has a matching redirect_uri\n const existingRedirectUris = existingCredentials?.clientInfo?.redirect_uris || [];\n const canReuseClient = existingCredentials?.clientInfo && existingRedirectUris.includes(redirectUrl);\n\n if (canReuseClient && existingCredentials?.clientInfo) {\n // Reuse existing client registration - redirect_uri matches\n logger.info(\"Reusing existing DCR client registration\", {\n clientId: existingCredentials.clientInfo.client_id,\n clientName: existingCredentials.clientInfo.client_name,\n redirectUri: redirectUrl,\n });\n clientInfo = existingCredentials.clientInfo;\n } else {\n // Need to register new client (either no existing client, or redirect_uri doesn't match)\n if (existingCredentials?.clientInfo) {\n logger.info(\"Existing DCR client has different redirect_uri, re-registering\", {\n existingRedirectUris,\n newRedirectUri: redirectUrl,\n });\n }\n\n // Step 6b: Build client metadata for DCR\n const clientMetadata: OAuthClientMetadata = {\n client_name: options.clientMetadata?.client_name || getDcrClientName(),\n grant_types: options.clientMetadata?.grant_types || [\"authorization_code\", \"refresh_token\"],\n // For most (agent, server) pairs this is just [redirectUrl]. For\n // pairs in DECOY_REDIRECT_URI_BY_APP_AND_HOST (e.g. cursor + figma)\n // the decoy is prepended at index 0 to pass allowlist-style DCR\n // gates. The actual callback still goes to redirectUrl because the\n // authorize step's `redirect_uri` query param selects it.\n redirect_uris: getDcrRedirectUris(serverUrlObj, redirectUrl),\n response_types: options.clientMetadata?.response_types || [\"code\"],\n // Public client - no client secret\n token_endpoint_auth_method: options.clientMetadata?.token_endpoint_auth_method || \"none\",\n ...(scope && { scope }),\n };\n\n logger.debug(\"Client metadata for DCR\", { clientMetadata });\n\n // Step 7: Register client via DCR\n if (!authMetadata.registration_endpoint) {\n logger.error(\"DCR registration unsupported by auth server\", {\n authServer: authServerUrl.toString(),\n eventType: AuthEventType.DCR_FAILED,\n reason: \"no_registration_endpoint\",\n serverUrl: serverUrlString,\n });\n throw new Error(\n `Authorization server does not support Dynamic Client Registration. ` +\n `No registration_endpoint found in metadata.`\n );\n }\n\n logger.info(\"Registering client via DCR...\", {\n registrationEndpoint: authMetadata.registration_endpoint,\n });\n\n try {\n clientInfo = await registerClient(authServerUrl, {\n clientMetadata,\n metadata: authMetadata,\n });\n } catch (err) {\n logger.error(\"DCR registration failed\", {\n authServer: authServerUrl.toString(),\n error: String(err),\n eventType: AuthEventType.DCR_FAILED,\n registrationEndpoint: authMetadata.registration_endpoint,\n serverUrl: serverUrlString,\n });\n throw err;\n }\n\n logger.info(\"Client registered successfully via DCR\", {\n clientId: clientInfo.client_id,\n clientName: clientInfo.client_name,\n clientSecretExpiresAt: clientInfo.client_secret_expires_at,\n });\n\n // Persist the client info immediately\n if (credentialStore) {\n await credentialStore.update(serverUrlString, { clientInfo });\n }\n }\n\n // Step 8: RFC 8707 Resource Indicators\n // NOTE: We intentionally do NOT send the resource parameter. Some OAuth servers (e.g., Notion)\n // ignore the client's requested resource and always issue tokens with their configured default\n // audience. When we then present that token to a different path (e.g., /mcp), the resource\n // server rejects it with \"Token audience does not match resource server\".\n // By omitting the resource parameter entirely, we let the OAuth server use its default\n // behavior, which typically issues tokens that work with the resource server.\n // This matches how Linear works (no protected resource metadata = no resource param sent).\n\n // Step 9: Start authorization flow (generates PKCE challenge)\n // Generate state for CSRF protection — some OAuth servers (e.g., Okta) require it\n const state = crypto.randomUUID();\n logger.debug(\"Starting authorization flow...\");\n const { authorizationUrl, codeVerifier } = await startAuthorization(authServerUrl, {\n clientInformation: clientInfo,\n metadata: authMetadata,\n redirectUrl,\n scope,\n state,\n });\n\n await openBrowser(authorizationUrl);\n\n // Step 11: Wait for callback with authorization code\n logger.debug(\"Waiting for OAuth callback...\");\n const callbackResult = await callbackServer.waitForCallback();\n\n // Verify state matches to prevent CSRF attacks\n if (callbackResult.state !== state) {\n logger.error(\"OAuth state mismatch — possible CSRF attack\", {\n authServer: authServerUrl.toString(),\n eventType: AuthEventType.STATE_MISMATCH,\n serverUrl: serverUrlString,\n });\n throw new Error(\"OAuth state mismatch - possible CSRF attack\");\n }\n\n logger.info(\"Authorization code received\", {\n codePrefix: `${callbackResult.code.substring(0, 10)}...`,\n });\n\n // Step 12: Exchange authorization code for tokens\n logger.debug(\"Exchanging authorization code for tokens...\");\n let tokens;\n try {\n tokens = await exchangeAuthorization(authServerUrl, {\n authorizationCode: callbackResult.code,\n clientInformation: clientInfo,\n codeVerifier,\n metadata: authMetadata,\n redirectUri: redirectUrl,\n });\n } catch (err) {\n logger.error(\"Token exchange failed\", {\n authServer: authServerUrl.toString(),\n clientId: clientInfo.client_id,\n error: String(err),\n eventType: AuthEventType.TOKEN_EXCHANGE_FAILED,\n grantType: \"authorization_code\",\n serverUrl: serverUrlString,\n });\n throw err;\n }\n\n logger.info(\"OAuth tokens obtained successfully\", {\n expiresIn: tokens.expires_in,\n hasRefreshToken: !!tokens.refresh_token,\n tokenType: tokens.token_type,\n });\n\n // Step 13: Persist tokens\n if (credentialStore) {\n const tokensObtainedAt = new Date().toISOString();\n await credentialStore.update(serverUrlString, {\n tokens,\n tokensObtainedAt,\n });\n logger.info(\"OAuth credentials persisted to disk\", { serverUrl: serverUrlString });\n }\n\n return {\n clientInfo,\n fromCache: false,\n tokens,\n };\n } finally {\n // Always close the callback server\n await callbackServer.close();\n }\n}\n\nexport function resolveDcrClientName(rawAppName: null | string | undefined): string {\n const normalized = rawAppName?.trim().toLowerCase();\n if (!normalized) return \"MCP Gateway\";\n return DCR_CLIENT_NAME_BY_APP[normalized] ?? \"MCP Gateway\";\n}\n\n/**\n * Pure helper backing `getDcrRedirectUris`. Exported so unit tests can\n * exercise the decoy-lookup matrix without depending on the\n * `config.clientAppName` module singleton.\n */\nexport function resolveDcrRedirectUris(\n rawAppName: null | string | undefined,\n serverUrl: string | URL,\n localRedirectUrl: string,\n): string[] {\n const normalized = rawAppName?.trim().toLowerCase();\n if (!normalized) return [localRedirectUrl];\n const hostMap = DECOY_REDIRECT_URI_BY_APP_AND_HOST[normalized];\n if (!hostMap) return [localRedirectUrl];\n let hostname: string;\n try {\n // Use hostname (not host) so port-bearing URLs like https://mcp.figma.com:443/...\n // still match the bare-hostname keys in DECOY_REDIRECT_URI_BY_APP_AND_HOST.\n // Lowercased because hostnames are case-insensitive (RFC 3986 §3.2.2).\n hostname = (serverUrl instanceof URL ? serverUrl : new URL(serverUrl)).hostname.toLowerCase();\n } catch {\n return [localRedirectUrl];\n }\n const decoy = hostMap[hostname];\n // Decoy MUST be index 0 — allowlist endpoints check redirect_uris[0].scheme.\n return decoy ? [decoy, localRedirectUrl] : [localRedirectUrl];\n}\n\n/**\n * Refreshes the cached OAuth token for a given server URL using its stored\n * refresh_token. Returns the new tokens on success, or undefined if no\n * refresh_token is on disk or the refresh attempt failed.\n *\n * On transient failures (network / 5xx / timeout) the stored refresh_token is\n * preserved so the next attempt can retry. On RFC 6749 §5.2 `invalid_grant`\n * the tokens are cleared (the refresh_token itself is dead).\n *\n * Use this from request-time error handlers (e.g., on upstream 401) when you\n * want a silent refresh before falling back to the interactive OAuth flow.\n */\nexport async function tryRefreshCachedToken(\n serverUrl: string | URL,\n credentialStore: OAuthCredentialStore\n): Promise<OAuthFlowResult | undefined> {\n const url = typeof serverUrl === \"string\" ? new URL(serverUrl) : serverUrl;\n const credentials = await credentialStore.load(url.toString());\n if (!credentials?.clientInfo || !credentials.tokens?.refresh_token) {\n return undefined;\n }\n return tryRefreshToken(url, credentials, credentialStore);\n}\n\n/**\n * Exchanges an authorization code for tokens using a pre-configured provider.\n * Handles different token endpoint authentication methods.\n */\nasync function exchangeCodeForTokens(\n provider: OAuthProviderConfig,\n code: string,\n redirectUri: string,\n codeVerifier?: string\n): Promise<OAuthTokens> {\n const tokenEndpoint = provider.tokenEndpoint;\n const authMethod = provider.tokenEndpointAuthMethod || (provider.clientSecret ? \"client_secret_post\" : \"none\");\n\n // Build token request body\n const body = new URLSearchParams();\n body.set(\"grant_type\", \"authorization_code\");\n body.set(\"code\", code);\n body.set(\"redirect_uri\", redirectUri);\n\n // Add PKCE verifier if present\n if (codeVerifier) {\n body.set(\"code_verifier\", codeVerifier);\n }\n\n // Build request headers\n const headers: Record<string, string> = {\n Accept: \"application/json\",\n \"Content-Type\": \"application/x-www-form-urlencoded\",\n };\n\n // Add client authentication based on method\n if (authMethod === \"client_secret_basic\" && provider.clientSecret) {\n // HTTP Basic authentication\n const credentials = Buffer.from(`${provider.clientId}:${provider.clientSecret}`).toString(\"base64\");\n headers.Authorization = `Basic ${credentials}`;\n } else if (authMethod === \"client_secret_post\" && provider.clientSecret) {\n // Client credentials in POST body\n body.set(\"client_id\", provider.clientId);\n body.set(\"client_secret\", provider.clientSecret);\n } else {\n // Public client - just client_id\n body.set(\"client_id\", provider.clientId);\n }\n\n logger.debug(\"Sending token request\", {\n authMethod,\n providerId: provider.id,\n tokenEndpoint,\n });\n\n const response = await fetch(tokenEndpoint, {\n body: body.toString(),\n headers,\n method: \"POST\",\n });\n\n if (!response.ok) {\n const errorText = await response.text();\n logger.error(\"Token exchange failed\", {\n authMethod,\n error: errorText,\n eventType: AuthEventType.TOKEN_EXCHANGE_FAILED,\n grantType: \"authorization_code\",\n httpStatus: response.status,\n providerId: provider.id,\n tokenEndpoint,\n });\n throw new Error(`Token exchange failed: ${response.status} ${errorText}`);\n }\n\n // GitHub returns tokens as application/x-www-form-urlencoded by default\n // unless Accept: application/json is set\n const contentType = response.headers.get(\"content-type\") || \"\";\n let tokenData: Record<string, unknown>;\n\n if (contentType.includes(\"application/json\")) {\n tokenData = (await response.json()) as Record<string, unknown>;\n } else if (contentType.includes(\"application/x-www-form-urlencoded\") || contentType.includes(\"text/plain\")) {\n // Parse URL-encoded response (GitHub's default format)\n const text = await response.text();\n const params = new URLSearchParams(text);\n tokenData = Object.fromEntries(params.entries()) as Record<string, unknown>;\n } else {\n // Try JSON first, fall back to URL-encoded\n const text = await response.text();\n try {\n tokenData = JSON.parse(text) as Record<string, unknown>;\n } catch {\n const params = new URLSearchParams(text);\n tokenData = Object.fromEntries(params.entries()) as Record<string, unknown>;\n }\n }\n\n // Convert expires_in to number if it's a string\n if (typeof tokenData.expires_in === \"string\") {\n tokenData.expires_in = parseInt(tokenData.expires_in, 10);\n }\n\n return {\n access_token: tokenData.access_token as string,\n expires_in: tokenData.expires_in as number | undefined,\n refresh_token: tokenData.refresh_token as string | undefined,\n scope: tokenData.scope as string | undefined,\n token_type: (tokenData.token_type as string) || \"bearer\",\n };\n}\n\n/**\n * Performs OAuth flow using a pre-configured provider (non-DCR).\n * This is used for OAuth servers that don't support Dynamic Client Registration.\n */\nasync function performPreConfiguredProviderFlow(\n serverUrl: URL,\n provider: OAuthProviderConfig,\n callbackServerInstance: {\n callbackUrl: string;\n close: () => Promise<void>;\n waitForCallback: () => Promise<{ code: string; state?: string }>;\n },\n credentialStore: OAuthCredentialStore | undefined,\n scope: string | undefined\n): Promise<OAuthFlowResult> {\n const serverUrlString = serverUrl.toString();\n const redirectUrl = callbackServerInstance.callbackUrl;\n\n // Build client info from pre-configured provider\n const clientInfo: OAuthClientInformationFull = {\n client_id: provider.clientId,\n client_name: provider.name,\n client_secret: provider.clientSecret,\n redirect_uris: [redirectUrl],\n token_endpoint_auth_method:\n provider.tokenEndpointAuthMethod || (provider.clientSecret ? \"client_secret_post\" : \"none\"),\n };\n\n logger.info(\"Using pre-configured OAuth client\", {\n clientId: provider.clientId,\n hasClientSecret: !!provider.clientSecret,\n providerId: provider.id,\n tokenEndpointAuthMethod: clientInfo.token_endpoint_auth_method,\n });\n\n // Determine scope to use\n const effectiveScope = scope || provider.scopes?.join(\" \");\n\n // Generate PKCE challenge if enabled for this provider\n const usePkce = provider.usePkce !== false; // Default to true unless explicitly disabled\n let codeVerifier: string | undefined;\n let codeChallenge: string | undefined;\n let codeChallengeMethod: string | undefined;\n\n if (usePkce) {\n // Generate PKCE code verifier and challenge\n const { generateCodeChallenge, generateCodeVerifier } = await import(\"./pkce.js\");\n codeVerifier = generateCodeVerifier();\n codeChallenge = await generateCodeChallenge(codeVerifier);\n codeChallengeMethod = \"S256\";\n }\n\n // Build authorization URL manually\n const authUrl = new URL(provider.authorizationEndpoint);\n authUrl.searchParams.set(\"client_id\", provider.clientId);\n authUrl.searchParams.set(\"redirect_uri\", redirectUrl);\n authUrl.searchParams.set(\"response_type\", \"code\");\n\n if (effectiveScope) {\n authUrl.searchParams.set(\"scope\", effectiveScope);\n }\n\n // Add state for security\n const state = crypto.randomUUID();\n authUrl.searchParams.set(\"state\", state);\n\n // Add PKCE challenge if enabled\n if (codeChallenge && codeChallengeMethod) {\n authUrl.searchParams.set(\"code_challenge\", codeChallenge);\n authUrl.searchParams.set(\"code_challenge_method\", codeChallengeMethod);\n }\n\n await openBrowser(authUrl);\n\n // Wait for callback on the existing callback server\n logger.debug(\"Waiting for OAuth callback...\");\n const callbackResult = await callbackServerInstance.waitForCallback();\n\n // Verify state matches\n if (callbackResult.state !== state) {\n logger.error(\"OAuth state mismatch — possible CSRF attack\", {\n eventType: AuthEventType.STATE_MISMATCH,\n providerId: provider.id,\n serverUrl: serverUrlString,\n });\n throw new Error(\"OAuth state mismatch - possible CSRF attack\");\n }\n\n logger.info(\"Authorization code received\", {\n codePrefix: `${callbackResult.code.substring(0, 10)}...`,\n providerId: provider.id,\n });\n\n // Exchange authorization code for tokens\n logger.debug(\"Exchanging authorization code for tokens...\");\n const tokens = await exchangeCodeForTokens(provider, callbackResult.code, redirectUrl, codeVerifier);\n\n logger.info(\"OAuth tokens obtained successfully\", {\n expiresIn: tokens.expires_in,\n hasRefreshToken: !!tokens.refresh_token,\n providerId: provider.id,\n tokenType: tokens.token_type,\n });\n\n // Persist credentials\n if (credentialStore) {\n const tokensObtainedAt = new Date().toISOString();\n await credentialStore.update(serverUrlString, {\n clientInfo,\n tokens,\n tokensObtainedAt,\n });\n logger.info(\"OAuth credentials persisted to disk\", {\n providerId: provider.id,\n serverUrl: serverUrlString,\n });\n }\n\n return {\n clientInfo,\n fromCache: false,\n tokens,\n };\n}\n\n/**\n * Checks for existing valid credentials and returns them if available.\n * Handles token refresh if the access token is expired but refresh token exists.\n */\nasync function tryLoadExistingCredentials(\n serverUrl: URL,\n credentialStore: OAuthCredentialStore\n): Promise<OAuthFlowResult | undefined> {\n const credentials = await credentialStore.load(serverUrl.toString());\n\n if (!credentials) {\n logger.debug(\"No stored credentials found\", { serverUrl: serverUrl.toString() });\n return undefined;\n }\n\n if (!credentials.clientInfo) {\n logger.debug(\"Stored credentials have no client info\", { serverUrl: serverUrl.toString() });\n return undefined;\n }\n\n // Check if we have a valid access token\n if (credentialStore.hasValidAccessToken(credentials) && credentials.tokens) {\n logger.info(\"Using cached OAuth credentials with valid access token\", {\n clientId: credentials.clientInfo.client_id,\n serverUrl: serverUrl.toString(),\n });\n\n return {\n clientInfo: credentials.clientInfo,\n fromCache: true,\n tokens: credentials.tokens,\n };\n }\n\n // Access token is expired or missing, try to refresh\n if (credentialStore.hasRefreshToken(credentials)) {\n const refreshResult = await tryRefreshToken(serverUrl, credentials, credentialStore);\n if (refreshResult) {\n return refreshResult;\n }\n }\n\n logger.debug(\"Stored credentials are expired and no valid refresh token\", {\n serverUrl: serverUrl.toString(),\n });\n\n return undefined;\n}\n\n/**\n * Attempts to refresh an expired access token using the refresh token.\n * Returns new tokens if successful, undefined if refresh fails.\n */\nasync function tryRefreshToken(\n serverUrl: URL,\n credentials: StoredCredentials,\n credentialStore: OAuthCredentialStore\n): Promise<OAuthFlowResult | undefined> {\n if (!credentials.clientInfo || !credentials.tokens?.refresh_token) {\n return undefined;\n }\n\n logger.info(\"Attempting to refresh expired access token\", {\n clientId: credentials.clientInfo.client_id,\n serverUrl: serverUrl.toString(),\n });\n\n try {\n // Discover authorization server metadata\n let resourceMetadata: OAuthProtectedResourceMetadata | undefined;\n try {\n resourceMetadata = await discoverOAuthProtectedResourceMetadata(serverUrl);\n } catch {\n // Continue without resource metadata\n }\n\n let authServerUrl: URL;\n if (resourceMetadata?.authorization_servers?.length) {\n authServerUrl = new URL(resourceMetadata.authorization_servers[0]);\n } else {\n authServerUrl = serverUrl;\n }\n\n const authMetadata = await discoverAuthorizationServerMetadata(authServerUrl);\n // NOTE: We don't send the resource parameter (same reasoning as in performOAuthFlow)\n\n // Attempt token refresh\n const newTokens = await refreshAuthorization(authServerUrl, {\n clientInformation: credentials.clientInfo,\n metadata: authMetadata,\n refreshToken: credentials.tokens.refresh_token,\n });\n\n logger.info(\"Successfully refreshed access token\", {\n clientId: credentials.clientInfo.client_id,\n expiresIn: newTokens.expires_in,\n hasNewRefreshToken: !!newTokens.refresh_token,\n });\n\n // Per RFC 6749 §6, the server MAY omit `refresh_token` in a refresh\n // response (it keeps the old one valid). Naively persisting `newTokens`\n // as-is would replace our existing refresh_token with `undefined`,\n // re-introducing the silent destructive-wipe failure mode that PRDCT-3666\n // is meant to fix. Carry the existing refresh_token forward when the\n // server didn't send a new one.\n const mergedTokens: OAuthTokens = newTokens.refresh_token\n ? newTokens\n : { ...newTokens, refresh_token: credentials.tokens.refresh_token };\n\n // Persist the new tokens\n const tokensObtainedAt = new Date().toISOString();\n await credentialStore.update(serverUrl.toString(), {\n tokens: mergedTokens,\n tokensObtainedAt,\n });\n\n return {\n clientInfo: credentials.clientInfo,\n fromCache: true,\n tokens: mergedTokens,\n };\n } catch (error) {\n const invalidGrant = isInvalidGrantError(error);\n logger.warn(\n invalidGrant\n ? \"Refresh token rejected by OAuth server (invalid_grant); clearing stored tokens\"\n : \"Token refresh failed transiently; retaining refresh_token for the next attempt\",\n {\n clientId: credentials.clientInfo.client_id,\n error: String(error),\n eventType: AuthEventType.REFRESH_FAILED,\n invalidGrant,\n serverUrl: serverUrl.toString(),\n }\n );\n\n // Per RFC 6749 §5.2, invalid_grant is the only error that means the\n // refresh_token itself is dead. For any other error (network failure, 5xx,\n // timeout, rate limit), keep the refresh_token so a future attempt can use\n // it — wiping it here is what historically forced users into browser\n // re-auth on transient failures (PRDCT-3666).\n if (invalidGrant) {\n await credentialStore.update(serverUrl.toString(), {\n tokens: undefined,\n tokensObtainedAt: undefined,\n });\n }\n\n return undefined;\n }\n}\n","/**\n * MCP Transport Utilities\n *\n * Simple transport creation for remote MCP servers.\n * Transport type is determined by trying Streamable HTTP first,\n * falling back to SSE if the endpoint doesn't support it.\n */\n\nimport type { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { SSEClientTransport } from \"@modelcontextprotocol/sdk/client/sse.js\";\nimport { StreamableHTTPClientTransport } from \"@modelcontextprotocol/sdk/client/streamableHttp.js\";\nimport type { FetchLike } from \"@modelcontextprotocol/sdk/shared/transport.js\";\n\nimport { logger } from \"./logger.js\";\n\nexport type TransportType = \"sse\" | \"streamable-http\";\n\n/** Order in which transports are tried (per MCP spec: Streamable HTTP first, SSE fallback) */\nconst TRANSPORT_PRIORITY: TransportType[] = [\"streamable-http\", \"sse\"];\n\n/** Result of a successful transport connection */\nexport interface TransportConnectionResult {\n /** The connected client instance */\n client: Client;\n /** The transport type that successfully connected */\n transportType: TransportType;\n}\n\n/**\n * Connects to a remote MCP server, trying transports in order.\n * Per MCP spec: tries Streamable HTTP first, falls back to SSE if not supported (404/405).\n *\n * Creates a fresh client for each transport attempt to avoid state issues.\n * The MCP SDK Client maintains internal connection state that does not properly\n * reset after a failed connect attempt, so reusing the same client instance\n * across transport fallbacks can cause \"already connected\" or similar errors.\n *\n * @param createClient - Factory function to create a new Client instance\n * @param url - The URL of the remote MCP server\n * @param requestInit - Optional request init for the transport (headers, etc.)\n * @returns The connected client and transport type\n * @throws The error from the last transport attempt if none succeed,\n * or immediately if an error is not a \"transport not supported\" error\n */\nexport async function connectWithTransportFallback(\n createClient: () => Client,\n url: string,\n requestInit?: RequestInit,\n customFetch?: FetchLike\n): Promise<TransportConnectionResult> {\n const { result: client, transportType } = await walkTransports(async (transportType) => {\n // Create a fresh client for each transport attempt to avoid state issues\n const client = createClient();\n const transport = createTransport(url, transportType, requestInit, customFetch);\n await client.connect(transport);\n return client;\n });\n return { client, transportType };\n}\n\n/**\n * Creates a transport instance for the given type.\n *\n * Pass `customFetch` to intercept every HTTP request the transport makes — the\n * gateway uses this to inject a dynamic Authorization header and recover from\n * mid-session 401s via silent refresh (PRDCT-3666 Tier 2).\n *\n * Auth-refresh coverage matrix:\n *\n * Streamable HTTP — every JSON-RPC message is a separate POST, all of which\n * go through `customFetch`. A 401 on any request triggers the wrapper's\n * silent-refresh-and-retry. Fully covered.\n *\n * SSE — has two channels:\n * 1. The long-lived `GET /mcp` event-stream. The SDK passes our\n * `customFetch` to the `eventsource` (v4+) polyfill via its `fetch`\n * option, so our wrapper attaches a fresh Authorization header on the\n * initial GET AND on every auto-reconnect after a disconnect.\n * 2. The short `POST /messages/<sessionId>` client→server messages — also\n * routed through `customFetch`.\n * Both channels are covered for the cases where the server closes the\n * stream on token expiry (EventSource auto-reconnects → new fetch call →\n * fresh bearer attached).\n *\n * ====================================================================\n * NOT SUPPORTED — known gap, intentional:\n *\n * SSE \"silent mid-stream drop\" case\n * If the bearer expires while the long-lived GET stream is OPEN and the\n * server chooses to keep the connection open but stop emitting events\n * (or only 401 *new* requests on a different channel), the gateway has no\n * way to detect that the stream has gone stale — EventSource doesn't fire\n * `onerror` because the connection is still alive at the TCP level.\n *\n * Recovering from this would need either:\n * (a) a proactive timer that fires at ~90% of `expires_in`, refreshes\n * the bearer, and tears down + reopens the EventSource before TTL;\n * (b) a heartbeat / liveness probe that detects extended silence and\n * triggers a reconnect.\n *\n * Neither is implemented. Impact today is zero — every OAuth-wrapped MCP\n * server in scope (Notion, Lucid, ClickUp, GitHub Copilot, Sentry, Linear,\n * Asana V2, Atlassian post-2026-06-30) uses Streamable HTTP. The only\n * surviving major SSE+OAuth server is Atlassian, sunsetting on\n * 2026-06-30. None of the surviving SSE+OAuth servers have been observed\n * to use the long-lived GET stream for server-push features (notifications,\n * sampling requests, streaming partial tool results) that would expose\n * this gap — they use it as a generic request/response substrate, in\n * which case any silent-drop manifests as the next POST returning 401,\n * which IS handled.\n * ====================================================================\n */\nexport function createTransport(\n url: string,\n type: TransportType,\n requestInit?: RequestInit,\n customFetch?: FetchLike\n): SSEClientTransport | StreamableHTTPClientTransport {\n const parsedUrl = new URL(url);\n\n if (type === \"streamable-http\") {\n return new StreamableHTTPClientTransport(parsedUrl, { fetch: customFetch, requestInit });\n }\n\n return new SSEClientTransport(parsedUrl, { fetch: customFetch, requestInit });\n}\n\n/**\n * Checks if an error indicates the transport/endpoint is not supported (404/405).\n * This means we should try a different transport type.\n */\nexport function isTransportNotSupportedError(err: unknown): boolean {\n if (!err || typeof err !== \"object\") return false;\n\n const status = (err as { status?: number }).status;\n const code = (err as { code?: number }).code;\n const message = (err as { message?: string }).message;\n\n // Check status codes that indicate endpoint doesn't support this transport\n if (status === 404 || status === 405 || code === 404 || code === 405) {\n return true;\n }\n\n // Check error message for these status codes\n if (message && /404|not found|405|method not allowed/i.test(String(message))) {\n return true;\n }\n\n return false;\n}\n\n/**\n * Walks transports in priority order, calling `attempt` for each. Returns the\n * first successful result. Continues to the next transport on\n * `isTransportNotSupportedError` (404/405); propagates any other error.\n *\n * Shared primitive for both connect-style attempts (the runtime proxy via\n * `connectWithTransportFallback`) and probe-style attempts (the install-time\n * scan in `src/probe`). Callers supply the per-transport request shape; this\n * helper owns only the priority-order + fallback-on-404/405 logic.\n *\n * When every transport fails with a not-supported error, throws an aggregate\n * error whose message lists each transport's status — so callers can tell\n * \"URL is dead\" from \"URL only speaks one transport\". The original errors are\n * available via `error.cause` (an array of `{ transport, err }`).\n *\n * @param attempt - Per-transport function. Throw an error matching\n * `isTransportNotSupportedError` to trigger fallback; throw anything else\n * (or any one transport's non-fallback error) to propagate.\n * @returns The first transport that succeeded and its result.\n * @throws The propagated non-fallback error, or an aggregate of every\n * transport's not-supported error when all transports fail.\n */\nexport async function walkTransports<T>(\n attempt: (transportType: TransportType) => Promise<T>\n): Promise<{ result: T; transportType: TransportType }> {\n const failures: Array<{ err: unknown; transport: TransportType }> = [];\n\n for (const transportType of TRANSPORT_PRIORITY) {\n try {\n const result = await attempt(transportType);\n return { result, transportType };\n } catch (err) {\n if (isTransportNotSupportedError(err)) {\n logger.info(`${transportType} not supported, trying next transport...`);\n failures.push({ err, transport: transportType });\n continue;\n }\n\n // Non-transport error (e.g., 401, network error) - propagate immediately\n throw err;\n }\n }\n\n // All transports failed with \"not supported\" errors. Build a message that\n // lists every transport's status (or message), so callers don't see only\n // the last transport's failure and assume the others were never tried.\n const summary = failures\n .map(({ err, transport }) => {\n const status = (err as { status?: number } | null)?.status;\n if (status !== undefined) return `${transport}: ${status}`;\n const message = err instanceof Error ? err.message : String(err);\n return `${transport}: ${message}`;\n })\n .join(\", \");\n const aggregate =\n failures.length > 0\n ? new Error(`all transports returned not-supported (${summary})`)\n : new Error(\"No compatible transport found\");\n // Preserve original errors for callers that need to introspect them.\n (aggregate as { cause?: unknown } & Error).cause = failures;\n throw aggregate;\n}\n"],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@onyxsecurity/mcp-gateway",
3
- "version": "1.0.63",
3
+ "version": "1.0.65",
4
4
  "main": "dist/index.js",
5
5
  "scripts": {
6
6
  "prebuild": "npx tsx scripts/generate-config.ts",
@@ -1,3 +0,0 @@
1
- import"./normalizeUrl-u9rsNRmG.js";import"./env-JHfIqf7O.js";import"./logger-CxuXnoy8.js";import{findProviderForUrl as e}from"./providers-DlG5fsS1.js";import{AuthServerDiscoveryError as t,discoverAuthServer as n,getDcrClientName as r,walkTransports as i}from"./transportDetection-DOLigM8S.js";async function a(e,t={}){let n=t.perServerTimeoutMs??15e3,r=t.maxRetries??1,i=t.retryDelayMs??200;return{results:await Promise.all(e.servers.map(e=>_(e.url,n,r,i)))}}async function o(e,t,n){let r=await fetch(e,{body:JSON.stringify(t),headers:{Accept:`application/json`,"Content-Type":`application/json`},method:`POST`,signal:n});if(r.status===200||r.status===201)try{let e=await r.json();return typeof e.client_id!=`string`||e.client_id.length===0?{status:r.status}:{body:e,status:r.status}}catch{return{status:r.status}}let i;try{i=(await r.text()).trim()}catch{}let a;return(r.status===429||r.status>=500)&&(a=m(r.headers.get(`Retry-After`))),{errorBody:i,retryAfterMs:a,status:r.status}}async function s(e,t){let{result:n}=await i(async n=>{let r=n===`streamable-http`?await h(e,t):await d(e,t);if(r.body?.cancel().catch(()=>{}),r.status===404||r.status===405)throw Object.assign(Error(`${n} returned ${r.status}`),{status:r.status});return r});return n}function c(e){return e<=0?0:Math.min(e,5e3)}function l(e){return e instanceof Error?e.message:String(e)}function u(e){if(e){try{let t=JSON.parse(e);if(t.error_description)return t.error_description;if(t.error)return t.error}catch{}return e.length>200?`${e.slice(0,200)}...`:e}}async function d(e,t){return fetch(e,{headers:{Accept:`text/event-stream`},method:`GET`,signal:t})}function f(e){return!!(e.reason===`network_error`&&!e.authServer||e.reason===`dcr_rejected`&&p(e.httpStatus))}function p(e){return e?e===429?!0:e>=500&&e<600:!1}function m(e){if(!e)return;let t=e.trim();if(!t)return;let n=Number(t);if(Number.isFinite(n))return c(n*1e3);let r=Date.parse(t);if(Number.isFinite(r)){let e=r-Date.now();return e>0?c(e):0}}async function h(e,t){return fetch(e,{body:JSON.stringify({id:1,jsonrpc:`2.0`,method:`initialize`,params:{capabilities:{},clientInfo:{name:`mcp-gateway-probe`,version:`1.0`},protocolVersion:`2024-11-05`}}),headers:{Accept:`application/json, text/event-stream`,"Content-Type":`application/json`},method:`POST`,signal:t})}async function g(i,a){let c=new URL(i);if(e(c))return{authType:`oauth_pre_registered`,reason:`pre_registered_provider`,url:i};let d;try{d=await s(i,a)}catch(e){return{authType:`probe_failed`,errorDetail:l(e),reason:`network_error`,url:i}}if(d.ok)return{authType:`public`,reason:`no_auth_required`,url:i};if(d.status!==401)return{authType:`probe_failed`,errorDetail:`initialize returned status ${d.status}`,httpStatus:d.status,reason:`network_error`,url:i};let f,p;try{let e=await n(c,{signal:a});f=e.authMetadata,p=e.authServerUrl}catch(e){return{authServer:e instanceof t?e.authServerUrl.toString():void 0,authType:`probe_failed`,errorDetail:l(e),reason:`auth_metadata_discovery_failed`,url:i}}if(!f)return{authServer:p.toString(),authType:`oauth_dcr_not_supported`,reason:`no_auth_metadata`,url:i};if(!f.registration_endpoint)return{authServer:p.toString(),authType:`oauth_dcr_not_supported`,reason:`no_registration_endpoint`,url:i};let m={client_name:r(),grant_types:[`authorization_code`,`refresh_token`],redirect_uris:[`http://localhost:0/callback`],response_types:[`code`],token_endpoint_auth_method:`none`},h;try{h=await o(f.registration_endpoint,m,a)}catch(e){return{authServer:p.toString(),authType:`probe_failed`,errorDetail:l(e),reason:`network_error`,url:i}}return h.status!==200&&h.status!==201?{authServer:p.toString(),authType:`oauth_dcr_not_supported`,errorDetail:u(h.errorBody),httpStatus:h.status,reason:`dcr_rejected`,retryAfterMs:h.retryAfterMs,url:i}:h.body?{authServer:p.toString(),authType:`oauth_dcr`,reason:`dcr_success`,url:i}:{authServer:p.toString(),authType:`oauth_dcr_not_supported`,errorDetail:`DCR returned ${h.status} with unparseable body`,httpStatus:h.status,reason:`dcr_rejected`,url:i}}async function _(e,t,n,r){let i=await v(e,t);for(let a=0;a<n;a++){if(!f(i))return i;let n=Math.max(r,i.retryAfterMs??0);n>0&&await new Promise(e=>setTimeout(e,n)),i=await v(e,t)}return i}async function v(e,t){let n=new AbortController,r,i=new Promise(i=>{r=setTimeout(()=>{n.abort(),i({authType:`probe_failed`,errorDetail:`probe timed out after ${t}ms`,reason:`probe_timeout`,url:e})},t)}),a=g(e,n.signal).catch(r=>({authType:`probe_failed`,errorDetail:n.signal.aborted?`probe timed out after ${t}ms`:l(r),reason:n.signal.aborted?`probe_timeout`:`network_error`,url:e}));try{return await Promise.race([a,i])}finally{r&&clearTimeout(r)}}async function y(){let e;try{e=await x()}catch(e){let t=e instanceof Error?e.message:String(e);return process.stderr.write(`probe: failed to read stdin: ${t}\n`),2}let t;try{t=JSON.parse(e)}catch(e){let t=e instanceof Error?e.message:String(e);return process.stderr.write(`probe: stdin was not valid JSON: ${t}\n`),2}if(!b(t))return process.stderr.write(`probe: invalid input — expected {"servers":[{"url":"..."}]}
2
- `),2;let n=await a(t);return process.stdout.write(`${JSON.stringify(n)}\n`),0}function b(e){if(!e||typeof e!=`object`)return!1;let t=e.servers;return Array.isArray(t)?t.every(e=>e&&typeof e==`object`&&typeof e.url==`string`):!1}async function x(){let e=[];for await(let t of process.stdin)e.push(t);return Buffer.concat(e).toString(`utf8`)}export{y as runProbeCli};
3
- //# sourceMappingURL=cli-D7NTuJNr.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"cli-D7NTuJNr.js","names":["errorBody: string | undefined","retryAfterMs: number | undefined","initResponse: Response","authMetadata: Awaited<ReturnType<typeof discoverAuthServer>>[\"authMetadata\"]","authServerUrl: URL","clientMetadata: OAuthClientMetadata","dcr: Awaited<ReturnType<typeof attemptDcr>>","timerId: ReturnType<typeof setTimeout> | undefined","raw: string","parsed: unknown","chunks: Buffer[]"],"sources":["../src/probe/index.ts","../src/probe/cli.ts"],"sourcesContent":["import type { OAuthClientMetadata } from \"@modelcontextprotocol/sdk/shared/auth.js\";\n\nimport { AuthServerDiscoveryError, discoverAuthServer } from \"../auth/discovery.js\";\nimport { getDcrClientName } from \"../auth/oauthFlow.js\";\nimport { findProviderForUrl } from \"../auth/providers.js\";\nimport { walkTransports } from \"../lib/transportDetection.js\";\n\nexport type AuthType =\n | \"oauth_dcr_not_supported\"\n | \"oauth_dcr\"\n | \"oauth_pre_registered\"\n | \"probe_failed\"\n | \"public\";\n\nexport interface ProbeInput {\n servers: Array<{ url: string }>;\n}\n\nexport interface ProbeOptions {\n /**\n * Maximum number of retries on transient pre-DCR network errors, on top of\n * the initial attempt. So `maxRetries=1` means up to 2 total attempts per\n * server. Defaults to 1.\n *\n * Retries fire only when the result is `network_error` AND no auth server\n * was discovered yet (i.e. POST initialize failed or returned a non-2xx\n * non-401 status). DCR network failures do NOT retry — they include the\n * discovered `authServer` in the result, which the retry filter excludes.\n * This prevents the rare case where a network blip after the DCR POST\n * was sent could cause duplicate orphan client registrations at the vendor.\n */\n maxRetries?: number;\n /** Per-server wall-clock timeout covering all HTTP calls for that server. */\n perServerTimeoutMs?: number;\n /** Delay between retry attempts. Defaults to 200ms. */\n retryDelayMs?: number;\n}\n\nexport interface ProbeOutput {\n results: ProbeResult[];\n}\n\nexport type ProbeReason =\n | \"auth_metadata_discovery_failed\"\n | \"dcr_rejected\"\n | \"dcr_success\"\n | \"network_error\"\n | \"no_auth_metadata\"\n | \"no_auth_required\"\n | \"no_registration_endpoint\"\n | \"pre_registered_provider\"\n | \"probe_timeout\";\n\nexport interface ProbeResult {\n authServer?: string;\n authType: AuthType;\n errorDetail?: string;\n httpStatus?: number;\n reason: ProbeReason;\n /**\n * For transient `dcr_rejected` results (429/5xx), the server's\n * `Retry-After` value in milliseconds, when provided. The retry wrapper\n * uses this as the inter-attempt delay; callers don't normally read it.\n */\n retryAfterMs?: number;\n url: string;\n}\n\n/**\n * The probe re-runs the same pre-browser steps as `performOAuthFlow` in\n * `oauthFlow.ts` — same SDK calls, same order — so we classify servers using\n * the exact code path the real OAuth flow would take. We stop just before the\n * browser-consent step (step 9+ in performOAuthFlow) because the probe runs\n * non-interactively at install time.\n *\n * Flow parity with performOAuthFlow:\n * - POST initialize (probe-specific: classify 200 vs 401 vs other)\n * - findProviderForUrl — same as performOAuthFlow step 2\n * - discoverOAuthProtectedResourceMetadata — same as step 3\n * - pick authorization_servers[0] with fallback — same as step 4\n * - discoverAuthorizationServerMetadata — same as step 5\n * - check registration_endpoint — same as step 7 precondition\n * - registerClient (SDK) — same as step 7\n * - return authType verdict (probe-only — OAuth flow would open browser here)\n *\n * authType mapping (kept alongside `reason` for callers that want diagnostics):\n * no_auth_required → public\n * pre_registered_provider → oauth_pre_registered\n * dcr_success → oauth_dcr\n * dcr_rejected → oauth_dcr_not_supported\n * no_registration_endpoint → oauth_dcr_not_supported\n * no_auth_metadata → oauth_dcr_not_supported\n * network_error → probe_failed\n */\n\nconst DCR_REDIRECT_URI = \"http://localhost:0/callback\";\nconst DEFAULT_PER_SERVER_TIMEOUT_MS = 15_000;\nconst DEFAULT_MAX_RETRIES = 1;\nconst DEFAULT_RETRY_DELAY_MS = 200;\n/**\n * Cap on `Retry-After` we'll honor before falling back to the default delay.\n * Prevents a misconfigured (or hostile) vendor from parking the install for\n * minutes/hours by setting `Retry-After: 3600`.\n */\nconst MAX_RETRY_AFTER_MS = 5_000;\n\nexport async function runProbeBatch(input: ProbeInput, options: ProbeOptions = {}): Promise<ProbeOutput> {\n const timeoutMs = options.perServerTimeoutMs ?? DEFAULT_PER_SERVER_TIMEOUT_MS;\n const maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;\n const retryDelayMs = options.retryDelayMs ?? DEFAULT_RETRY_DELAY_MS;\n\n const results = await Promise.all(\n input.servers.map((srv) => probeOneWithRetry(srv.url, timeoutMs, maxRetries, retryDelayMs))\n );\n\n return { results };\n}\n\n/**\n * Attempts DCR directly via fetch rather than SDK's `registerClient`.\n *\n * Reason we don't use the SDK here specifically: `registerClient` consumes the\n * response and throws, dropping the numeric HTTP status on success-with-bad-body\n * and on 4xx with a well-formed OAuth error body (e.g. Airtable). Probe needs\n * the status code for monitoring and to distinguish dcr_rejected from\n * network_error precisely. Everything else (discovery of resource and auth\n * server metadata) still goes through the SDK.\n *\n * Returns:\n * - { status, body } on 2xx with parseable JSON → caller classifies dcr_success\n * - { status, errorBody? } on non-2xx → caller classifies dcr_rejected\n * - throws on network failure/timeout → caller classifies network_error\n */\nasync function attemptDcr(\n registrationEndpoint: string,\n clientMetadata: OAuthClientMetadata,\n signal: AbortSignal\n): Promise<{\n body?: Record<string, unknown>;\n errorBody?: string;\n retryAfterMs?: number;\n status: number;\n}> {\n const res = await fetch(registrationEndpoint, {\n body: JSON.stringify(clientMetadata),\n headers: {\n Accept: \"application/json\",\n \"Content-Type\": \"application/json\",\n },\n method: \"POST\",\n signal,\n });\n\n if (res.status === 200 || res.status === 201) {\n try {\n const body = (await res.json()) as Record<string, unknown>;\n // RFC 7591 §3.2.1 requires `client_id` in a successful registration\n // response. Some servers return a 2xx with a JSON error envelope or\n // a partial/malformed body; treating those as success would\n // false-positive `oauth_dcr` even though the OAuth flow can't\n // proceed. Require the mandatory field before classifying success.\n if (typeof body.client_id !== \"string\" || body.client_id.length === 0) {\n return { status: res.status };\n }\n return { body, status: res.status };\n } catch {\n // 2xx with unparseable body — caller treats as failure.\n return { status: res.status };\n }\n }\n\n // Non-2xx — try to surface the error body to errorDetail for humans.\n let errorBody: string | undefined;\n try {\n errorBody = (await res.text()).trim();\n } catch {\n // ignore\n }\n\n // Capture Retry-After (RFC 7231) on rate-limit / server-error responses so\n // probeOneWithRetry can wait the requested interval before re-attempting.\n // Anything outside the transient class (429 / 5xx) doesn't need this — we\n // won't retry those anyway.\n let retryAfterMs: number | undefined;\n if (res.status === 429 || res.status >= 500) {\n retryAfterMs = parseRetryAfter(res.headers.get(\"Retry-After\"));\n }\n\n return { errorBody, retryAfterMs, status: res.status };\n}\n\n/**\n * Performs the per-transport liveness/auth probe, falling back from Streamable\n * HTTP to SSE on 404/405 (the same priority order the runtime proxy uses via\n * `connectWithTransportFallback`). Returns the first response whose status is\n * not \"transport not supported\"; throws on any non-fallback error.\n *\n * The response body is cancelled before returning — the probe classifies on\n * `status` only and never reads body or headers. For SSE 200 responses this is\n * load-bearing: the event stream stays open indefinitely otherwise, leaking\n * connections at batch scale.\n */\nasync function attemptInitialize(url: string, signal: AbortSignal): Promise<Response> {\n const { result } = await walkTransports(async (transportType) => {\n const response =\n transportType === \"streamable-http\"\n ? await postInitialize(url, signal)\n : await getSseHandshake(url, signal);\n // Probe never reads body — cancel to avoid leaking SSE streams on 200.\n response.body?.cancel().catch(() => {\n /* already closed */\n });\n if (response.status === 404 || response.status === 405) {\n // Throw a status-bearing error so walkTransports' isTransportNotSupportedError\n // check matches and falls through to the next transport.\n throw Object.assign(new Error(`${transportType} returned ${response.status}`), {\n status: response.status,\n });\n }\n return response;\n });\n return result;\n}\n\nfunction clampRetryAfter(ms: number): number {\n if (ms <= 0) return 0;\n return Math.min(ms, MAX_RETRY_AFTER_MS);\n}\n\nfunction errMsg(err: unknown): string {\n if (err instanceof Error) return err.message;\n return String(err);\n}\n\n/** Parses an OAuth error body (RFC 6749) into a human-friendly one-liner. */\nfunction formatDcrErrorBody(body: string | undefined): string | undefined {\n if (!body) return undefined;\n try {\n const parsed = JSON.parse(body) as { error?: string; error_description?: string };\n if (parsed.error_description) return parsed.error_description;\n if (parsed.error) return parsed.error;\n } catch {\n // Non-JSON body — return as-is, capped to avoid dumping HTML pages.\n }\n return body.length > 200 ? `${body.slice(0, 200)}...` : body;\n}\n\nasync function getSseHandshake(url: string, signal: AbortSignal): Promise<Response> {\n return fetch(url, {\n headers: { Accept: \"text/event-stream\" },\n method: \"GET\",\n signal,\n });\n}\n\nfunction isRetryableResult(result: ProbeResult): boolean {\n // Pre-DCR network error — fetch threw before discovery finished.\n if (result.reason === \"network_error\" && !result.authServer) return true;\n // DCR returned a transient HTTP status — server responded but can't help yet.\n if (result.reason === \"dcr_rejected\" && isTransientStatus(result.httpStatus)) return true;\n return false;\n}\n\nfunction isTransientStatus(status: number | undefined): boolean {\n if (!status) return false;\n if (status === 429) return true;\n return status >= 500 && status < 600;\n}\n\n/**\n * Parses the Retry-After header (RFC 7231) in either of its two forms:\n * - delta-seconds: \"120\"\n * - HTTP-date: \"Wed, 21 Oct 2026 07:28:00 GMT\"\n *\n * Caps the result at MAX_RETRY_AFTER_MS so a misconfigured / malicious\n * server can't park our install for an hour. Returns undefined for\n * missing/unparseable values; callers fall back to the default delay.\n */\nfunction parseRetryAfter(header: null | string): number | undefined {\n if (!header) return undefined;\n const trimmed = header.trim();\n if (!trimmed) return undefined;\n\n const asNumber = Number(trimmed);\n if (Number.isFinite(asNumber)) {\n return clampRetryAfter(asNumber * 1000);\n }\n\n const asDate = Date.parse(trimmed);\n if (Number.isFinite(asDate)) {\n const ms = asDate - Date.now();\n return ms > 0 ? clampRetryAfter(ms) : 0;\n }\n\n return undefined;\n}\n\nasync function postInitialize(url: string, signal: AbortSignal): Promise<Response> {\n return fetch(url, {\n body: JSON.stringify({\n id: 1,\n jsonrpc: \"2.0\",\n method: \"initialize\",\n params: {\n capabilities: {},\n clientInfo: { name: \"mcp-gateway-probe\", version: \"1.0\" },\n protocolVersion: \"2024-11-05\",\n },\n }),\n headers: {\n Accept: \"application/json, text/event-stream\",\n \"Content-Type\": \"application/json\",\n },\n method: \"POST\",\n signal,\n });\n}\n\nasync function probeOne(url: string, signal: AbortSignal): Promise<ProbeResult> {\n const serverUrlObj = new URL(url);\n\n // Step 0: pre-configured OAuth provider — short-circuit before any network\n // call. OAUTH_PROVIDERS holds servers we've baked credentials into the\n // gateway for at build time; if a URL matches, we already know it needs\n // OAuth and we already have credentials, so probing the server itself\n // is wasted work.\n //\n // performOAuthFlow does this check at its step 2 (after starting a callback\n // server), but the probe never opens a browser, so we can hoist it earlier\n // and avoid the network calls oauthFlow's structure forces.\n if (findProviderForUrl(serverUrlObj)) {\n return { authType: \"oauth_pre_registered\", reason: \"pre_registered_provider\", url };\n }\n\n // Step 1: liveness/auth probe with transport fallback (Streamable HTTP → SSE,\n // matching the runtime proxy's priority order). Classify:\n // 200 → wrap (no_auth_required)\n // 401 → continue with auth discovery (same path performOAuthFlow takes)\n // else → skip (network_error)\n // attemptInitialize walks transports via walkTransports and falls through\n // 404/405 — so a server like cf-docs (POST /sse 404, GET /sse 200) classifies\n // as public on the SSE attempt rather than failing on the streamable-HTTP one.\n let initResponse: Response;\n try {\n initResponse = await attemptInitialize(url, signal);\n } catch (err) {\n return { authType: \"probe_failed\", errorDetail: errMsg(err), reason: \"network_error\", url };\n }\n if (initResponse.ok) {\n return { authType: \"public\", reason: \"no_auth_required\", url };\n }\n if (initResponse.status !== 401) {\n return {\n authType: \"probe_failed\",\n errorDetail: `initialize returned status ${initResponse.status}`,\n httpStatus: initResponse.status,\n reason: \"network_error\",\n url,\n };\n }\n\n // Steps 3-5: shared discovery with performOAuthFlow — see ../auth/discovery.ts.\n // The helper performs resource-metadata lookup, auth-server-URL selection, and\n // auth-server-metadata lookup in that order. It silences resource-metadata\n // errors (soft-fail) but throws AuthServerDiscoveryError when the auth-server\n // metadata call fails — preserving the computed authServerUrl on the error.\n let authMetadata: Awaited<ReturnType<typeof discoverAuthServer>>[\"authMetadata\"];\n let authServerUrl: URL;\n try {\n // Pass the per-server signal so a probeOneWithTimeout abort cancels the\n // SDK's well-known fetches too — otherwise orphaned requests outlive\n // the probe verdict and leak connections in batch runs.\n const discovered = await discoverAuthServer(serverUrlObj, { signal });\n authMetadata = discovered.authMetadata;\n authServerUrl = discovered.authServerUrl;\n } catch (err) {\n const authServer =\n err instanceof AuthServerDiscoveryError ? err.authServerUrl.toString() : undefined;\n // Thrown errors here are transport failures (DNS/timeout/5xx) on the\n // auth-server metadata fetch, NOT the \"metadata is genuinely absent\"\n // case. Folding them into oauth_dcr_not_supported would let the\n // server-side cache persist a transient outage as a permanent\n // negative verdict. Surface as probe_failed instead so the scanner\n // filter drops it from the cache write (transient state stays\n // transient). The definitive metadata-absent path lives in the\n // !authMetadata branch below.\n return {\n authServer,\n authType: \"probe_failed\",\n errorDetail: errMsg(err),\n reason: \"auth_metadata_discovery_failed\",\n url,\n };\n }\n if (!authMetadata) {\n return {\n authServer: authServerUrl.toString(),\n authType: \"oauth_dcr_not_supported\",\n reason: \"no_auth_metadata\",\n url,\n };\n }\n\n // Step 7 precondition: registration_endpoint present?\n // (performOAuthFlow throws here; probe classifies as oauth_dcr_not_supported instead.)\n if (!authMetadata.registration_endpoint) {\n return {\n authServer: authServerUrl.toString(),\n authType: \"oauth_dcr_not_supported\",\n reason: \"no_registration_endpoint\",\n url,\n };\n }\n\n // Step 7: DCR. Same body/method as performOAuthFlow, but attemptDcr gives us\n // the raw status code so we can distinguish dcr_rejected (4xx/5xx) from\n // network_error (fetch throw) and report httpStatus for monitoring.\n //\n // client_name is sourced from the same `CLIENT_APP_NAME` env the runtime\n // OAuth flow reads (see performOAuthFlow / getDcrClientName) so that\n // allowlist-style DCR endpoints (e.g. Figma) give the probe the same\n // verdict the runtime flow would produce for this agent. Without this,\n // probe would always send \"MCP Gateway\" and false-classify Figma as\n // oauth_dcr_not_supported even though a Cursor/Code/Copilot install\n // would succeed.\n const clientMetadata: OAuthClientMetadata = {\n client_name: getDcrClientName(),\n grant_types: [\"authorization_code\", \"refresh_token\"],\n redirect_uris: [DCR_REDIRECT_URI],\n response_types: [\"code\"],\n token_endpoint_auth_method: \"none\",\n };\n let dcr: Awaited<ReturnType<typeof attemptDcr>>;\n try {\n dcr = await attemptDcr(authMetadata.registration_endpoint, clientMetadata, signal);\n } catch (err) {\n // fetch itself threw — network layer failure, not a policy decision\n // from the auth server.\n return {\n authServer: authServerUrl.toString(),\n authType: \"probe_failed\",\n errorDetail: errMsg(err),\n reason: \"network_error\",\n url,\n };\n }\n\n if (dcr.status !== 200 && dcr.status !== 201) {\n return {\n authServer: authServerUrl.toString(),\n authType: \"oauth_dcr_not_supported\",\n errorDetail: formatDcrErrorBody(dcr.errorBody),\n httpStatus: dcr.status,\n reason: \"dcr_rejected\",\n retryAfterMs: dcr.retryAfterMs,\n url,\n };\n }\n if (!dcr.body) {\n // 2xx but body didn't parse — treat as rejection rather than silently wrap.\n return {\n authServer: authServerUrl.toString(),\n authType: \"oauth_dcr_not_supported\",\n errorDetail: `DCR returned ${dcr.status} with unparseable body`,\n httpStatus: dcr.status,\n reason: \"dcr_rejected\",\n url,\n };\n }\n\n // NOTE: performOAuthFlow would open the browser and complete the flow here.\n // The probe stops at successful DCR.\n return {\n authServer: authServerUrl.toString(),\n authType: \"oauth_dcr\",\n reason: \"dcr_success\",\n url,\n };\n}\n\n/**\n * Wraps `probeOneWithTimeout` with retry-on-transient-error.\n *\n * Retries up to `maxRetries` times when the result is transient. Two\n * categories of transient are recognized:\n *\n * 1. Pre-DCR network error — `reason === \"network_error\" && !authServer`.\n * The fetch threw or returned non-401/non-2xx before discovery\n * finished. No registration request reached any vendor; retrying is\n * structurally safe (no orphan multiplication).\n *\n * 2. DCR transient — `reason === \"dcr_rejected\" && (httpStatus === 429\n * || httpStatus >= 500)`. The vendor responded definitively that they\n * can't help right now (rate-limited or server error). Because we got\n * a complete response, the server explicitly did NOT create a\n * registration; retrying is also safe and may succeed once the\n * transient condition clears.\n *\n * Notably NOT retried:\n * - DCR network failures (`network_error` WITH `authServer`) — fetch\n * threw mid-flight; the request may have arrived at the vendor.\n * - DCR 4xx (other than 429) — definitive policy refusal.\n * - `no_auth_metadata`, `no_registration_endpoint` — definitive answers.\n *\n * For DCR transients, the actual delay is `max(retryDelayMs, retryAfterMs)`\n * if the server provided a `Retry-After` header (capped to MAX_RETRY_AFTER_MS).\n */\nasync function probeOneWithRetry(\n url: string,\n timeoutMs: number,\n maxRetries: number,\n retryDelayMs: number\n): Promise<ProbeResult> {\n let result = await probeOneWithTimeout(url, timeoutMs);\n for (let attempt = 0; attempt < maxRetries; attempt++) {\n if (!isRetryableResult(result)) return result;\n const delay = Math.max(retryDelayMs, result.retryAfterMs ?? 0);\n if (delay > 0) {\n await new Promise<void>((resolve) => setTimeout(resolve, delay));\n }\n result = await probeOneWithTimeout(url, timeoutMs);\n }\n return result;\n}\n\nasync function probeOneWithTimeout(url: string, timeoutMs: number): Promise<ProbeResult> {\n const controller = new AbortController();\n let timerId: ReturnType<typeof setTimeout> | undefined;\n\n // Race the probe against a wall-clock timeout. AbortSignal alone isn't\n // enough — some fetch implementations (or test mocks) may ignore it. This\n // guarantees we always return within timeoutMs.\n const timeoutPromise = new Promise<ProbeResult>((resolve) => {\n timerId = setTimeout(() => {\n controller.abort();\n // Distinct reason \"probe_timeout\" — NOT \"network_error\". The\n // wall-clock timeout fires from outside probeOne, so we don't\n // know which phase aborted: discovery, registration POST, or\n // anything in between. If the timeout struck after the\n // registration POST went through, retrying would create a second\n // DCR client_id. Marking timeouts non-retryable (see\n // isRetryableResult) errs on the side of one orphan probe over\n // duplicate DCR registrations.\n resolve({\n authType: \"probe_failed\",\n errorDetail: `probe timed out after ${timeoutMs}ms`,\n reason: \"probe_timeout\",\n url,\n });\n }, timeoutMs);\n });\n\n const probePromise = probeOne(url, controller.signal).catch((err) => ({\n authType: \"probe_failed\" as const,\n errorDetail: controller.signal.aborted ? `probe timed out after ${timeoutMs}ms` : errMsg(err),\n // controller.signal.aborted means the wall-clock timeoutPromise\n // fired and aborted us mid-flight. Same retry-safety reasoning as\n // the timeoutPromise branch — surface as probe_timeout so we\n // don't reissue DCR.\n reason: controller.signal.aborted ? (\"probe_timeout\" as const) : (\"network_error\" as const),\n url,\n }));\n\n try {\n return await Promise.race([probePromise, timeoutPromise]);\n } finally {\n if (timerId) clearTimeout(timerId);\n }\n}\n","import type { ProbeInput } from \"./index.js\";\n\nimport { runProbeBatch } from \"./index.js\";\n\nconst EXIT_OK = 0;\nconst EXIT_BAD_INPUT = 2;\n\n/**\n * Entry point for the `mcp-gateway probe` subcommand.\n *\n * Reads a JSON batch of server URLs from stdin, runs the DCR/auth probe for\n * each in parallel, and writes the aggregated result JSON to stdout.\n *\n * Intended to be invoked by the scanner during install to decide which remote\n * MCP servers are safe to wrap vs. leave alone.\n */\nexport async function runProbeCli(): Promise<number> {\n let raw: string;\n try {\n raw = await readStdin();\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n process.stderr.write(`probe: failed to read stdin: ${msg}\\n`);\n return EXIT_BAD_INPUT;\n }\n\n let parsed: unknown;\n try {\n parsed = JSON.parse(raw);\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n process.stderr.write(`probe: stdin was not valid JSON: ${msg}\\n`);\n return EXIT_BAD_INPUT;\n }\n\n if (!isValidInput(parsed)) {\n process.stderr.write(`probe: invalid input — expected {\"servers\":[{\"url\":\"...\"}]}\\n`);\n return EXIT_BAD_INPUT;\n }\n\n const output = await runProbeBatch(parsed);\n process.stdout.write(`${JSON.stringify(output)}\\n`);\n return EXIT_OK;\n}\n\nfunction isValidInput(value: unknown): value is ProbeInput {\n if (!value || typeof value !== \"object\") return false;\n const servers = (value as { servers?: unknown }).servers;\n if (!Array.isArray(servers)) return false;\n return servers.every((s) => s && typeof s === \"object\" && typeof (s as { url?: unknown }).url === \"string\");\n}\n\nasync function readStdin(): Promise<string> {\n const chunks: Buffer[] = [];\n for await (const chunk of process.stdin) {\n chunks.push(chunk as Buffer);\n }\n return Buffer.concat(chunks).toString(\"utf8\");\n}\n"],"mappings":"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"}
@@ -1,8 +0,0 @@
1
- import{AccessControlBlockError as e,Client as t,ConfigurationError as n,ProxyConnectionError as r,ReadBuffer as i,Server as a,StdioServerTransport as o,compressClientInfo as s,getSessionData as c,initializeTrafficMirror as l,logRequestCounts as u,proxyServer as d,serializeMessage as f,startHTTPServer as p}from"./stdio-DPNPM5VR.js";import{UnauthorizedError as m,createParser as h,normalizeUrl as g}from"./normalizeUrl-u9rsNRmG.js";import{config as _}from"./env-JHfIqf7O.js";import{chownToRealUser as v,extractTraceIdFromHeaders as ee,flushLogs as y,logger as b}from"./logger-CxuXnoy8.js";import{emitProxySetupLog as te,hideBin as ne,yargs_default as re}from"./helpers-yvgumKoO.js";import"./providers-DlG5fsS1.js";import{initializeOAuthProviders as ie}from"./oauthProvidersClient-CA99rXX6.js";import"./pkce-DKfQXsGm.js";import{connectWithTransportFallback as ae,performOAuthFlow as oe}from"./transportDetection-DOLigM8S.js";import{createHash as x}from"node:crypto";import{join as S}from"node:path";import{chmod as C,mkdir as w,readFile as T,rm as E,writeFile as D}from"node:fs/promises";import{StringDecoder as se}from"node:string_decoder";import{setTimeout as ce}from"node:timers";import O from"node:util";import{execSync as le,spawn as k,spawnSync as A}from"node:child_process";import{PassThrough as j,Transform as ue}from"node:stream";var de=class extends Event{constructor(e,t){super(e),this.code=t?.code??void 0,this.message=t?.message??void 0}[Symbol.for(`nodejs.util.inspect.custom`)](e,t,n){return n(me(this),t)}[Symbol.for(`Deno.customInspect`)](e,t){return e(me(this),t)}};function fe(e){let t=globalThis.DOMException;return typeof t==`function`?new t(e,`SyntaxError`):SyntaxError(e)}function pe(e){return e instanceof Error?`errors`in e&&Array.isArray(e.errors)?e.errors.map(pe).join(`, `):`cause`in e&&e.cause instanceof Error?`${e}: ${pe(e.cause)}`:e.message:`${e}`}function me(e){return{type:e.type,message:e.message,code:e.code,defaultPrevented:e.defaultPrevented,cancelable:e.cancelable,timeStamp:e.timeStamp}}var he=e=>{throw TypeError(e)},M=(e,t,n)=>t.has(e)||he(`Cannot `+n),N=(e,t,n)=>(M(e,t,`read from private field`),n?n.call(e):t.get(e)),P=(e,t,n)=>t.has(e)?he(`Cannot add the same private member more than once`):t instanceof WeakSet?t.add(e):t.set(e,n),F=(e,t,n,r)=>(M(e,t,`write to private field`),t.set(e,n),n),I=(e,t,n)=>(M(e,t,`access private method`),n),L,R,z,B,V,H,U,W,G,K,q,J,Y,X,ge,_e,ve,ye,be,xe,Z,Se,Q,$=class extends EventTarget{constructor(e,t){super(),P(this,X),this.CONNECTING=0,this.OPEN=1,this.CLOSED=2,P(this,L),P(this,R),P(this,z),P(this,B),P(this,V),P(this,H),P(this,U),P(this,W,null),P(this,G),P(this,K),P(this,q,null),P(this,J,null),P(this,Y,null),P(this,_e,async e=>{var t;N(this,K).reset();let{body:n,redirected:r,status:i,headers:a}=e;if(i===204){I(this,X,Z).call(this,`Server sent HTTP 204, not reconnecting`,204),this.close();return}if(r?F(this,z,new URL(e.url)):F(this,z,void 0),i!==200){I(this,X,Z).call(this,`Non-200 status code (${i})`,i);return}if(!(a.get(`content-type`)||``).startsWith(`text/event-stream`)){I(this,X,Z).call(this,`Invalid content type, expected "text/event-stream"`,i);return}if(N(this,L)===this.CLOSED)return;F(this,L,this.OPEN);let o=new Event(`open`);if((t=N(this,Y))==null||t.call(this,o),this.dispatchEvent(o),typeof n!=`object`||!n||!(`getReader`in n)){I(this,X,Z).call(this,`Invalid response body, expected a web ReadableStream`,i),this.close();return}let s=new TextDecoder,c=n.getReader(),l=!0;do{let{done:e,value:t}=await c.read();t&&N(this,K).feed(s.decode(t,{stream:!e})),e&&(l=!1,N(this,K).reset(),I(this,X,Se).call(this))}while(l)}),P(this,ve,e=>{F(this,G,void 0),!(e.name===`AbortError`||e.type===`aborted`)&&I(this,X,Se).call(this,pe(e))}),P(this,be,e=>{typeof e.id==`string`&&F(this,W,e.id);let t=new MessageEvent(e.event||`message`,{data:e.data,origin:N(this,z)?N(this,z).origin:N(this,R).origin,lastEventId:e.id||``});N(this,J)&&(!e.event||e.event===`message`)&&N(this,J).call(this,t),this.dispatchEvent(t)}),P(this,xe,e=>{F(this,H,e)}),P(this,Q,()=>{F(this,U,void 0),N(this,L)===this.CONNECTING&&I(this,X,ge).call(this)});try{if(e instanceof URL)F(this,R,e);else if(typeof e==`string`)F(this,R,new URL(e,Ce()));else throw Error(`Invalid URL`)}catch{throw fe(`An invalid or illegal string was specified`)}F(this,K,h({onEvent:N(this,be),onRetry:N(this,xe)})),F(this,L,this.CONNECTING),F(this,H,3e3),F(this,V,t?.fetch??globalThis.fetch),F(this,B,t?.withCredentials??!1),I(this,X,ge).call(this)}get readyState(){return N(this,L)}get url(){return N(this,R).href}get withCredentials(){return N(this,B)}get onerror(){return N(this,q)}set onerror(e){F(this,q,e)}get onmessage(){return N(this,J)}set onmessage(e){F(this,J,e)}get onopen(){return N(this,Y)}set onopen(e){F(this,Y,e)}addEventListener(e,t,n){let r=t;super.addEventListener(e,r,n)}removeEventListener(e,t,n){let r=t;super.removeEventListener(e,r,n)}close(){N(this,U)&&clearTimeout(N(this,U)),N(this,L)!==this.CLOSED&&(N(this,G)&&N(this,G).abort(),F(this,L,this.CLOSED),F(this,G,void 0))}};L=new WeakMap,R=new WeakMap,z=new WeakMap,B=new WeakMap,V=new WeakMap,H=new WeakMap,U=new WeakMap,W=new WeakMap,G=new WeakMap,K=new WeakMap,q=new WeakMap,J=new WeakMap,Y=new WeakMap,X=new WeakSet,ge=function(){F(this,L,this.CONNECTING),F(this,G,new AbortController),N(this,V)(N(this,R),I(this,X,ye).call(this)).then(N(this,_e)).catch(N(this,ve))},_e=new WeakMap,ve=new WeakMap,ye=function(){let e={mode:`cors`,redirect:`follow`,headers:{Accept:`text/event-stream`,...N(this,W)?{"Last-Event-ID":N(this,W)}:void 0},cache:`no-store`,signal:N(this,G)?.signal};return`window`in globalThis&&(e.credentials=this.withCredentials?`include`:`same-origin`),e},be=new WeakMap,xe=new WeakMap,Z=function(e,t){var n;N(this,L)!==this.CLOSED&&F(this,L,this.CLOSED);let r=new de(`error`,{code:t,message:e});(n=N(this,q))==null||n.call(this,r),this.dispatchEvent(r)},Se=function(e,t){var n;if(N(this,L)===this.CLOSED)return;F(this,L,this.CONNECTING);let r=new de(`error`,{code:t,message:e});(n=N(this,q))==null||n.call(this,r),this.dispatchEvent(r),F(this,U,setTimeout(N(this,Q),N(this,H)))},Q=new WeakMap,$.CONNECTING=0,$.OPEN=1,$.CLOSED=2;function Ce(){let e=`document`in globalThis?globalThis.document:void 0;return e&&typeof e==`object`&&`baseURI`in e&&typeof e.baseURI==`string`?e.baseURI:void 0}var we=class{client;enabled;lastBlockReason;serverName;constructor(e){this.enabled=e.enabled,this.client=e.client,this.serverName=e.serverName,b.info(`AccessControlAuthorizer initialized`,{enabled:this.enabled,hasClient:!!this.client,serverName:this.serverName})}getBlockReason(){return this.lastBlockReason?this.lastBlockReason:`MCP server${this.serverName?` '${this.serverName}'`:``} is not authorized for use in your organization and has been blocked by Onyx.`}async isAllowed(){if(!this.enabled)return!0;if(this.client)try{let e=await this.client.authorize();return e.action===`block`?(e.reason?this.lastBlockReason=e.reason:this.lastBlockReason=`MCP server${this.serverName?` '${this.serverName}'`:``} is not authorized for use in your organization and has been blocked by Onyx.`,!1):!0}catch(e){return b.error(`Access control authorization failed with unexpected error`,{error:String(e)}),!0}return b.warn(`No access control client configured, allowing by default`),!0}},Te=class{clientInfoBase64;config;constructor(e){this.config=e,this.clientInfoBase64=this.getClientInfoBase64(),b.info(`AccessControlClient initialized`,{timeoutMs:e.timeoutMs,url:e.url})}async authorize(){try{let e=await this.sendAuthorizeRequest();return b.debug(`Access control check successful`,{action:e.action}),e}catch(e){return b.warn(`Access control check failed, failing open (allowing by default)`,{error:String(e)}),{action:`allow`}}}getClientInfoBase64(){return s(this.config.sessionData)}async sendAuthorizeRequest(){let e=new AbortController,t=setTimeout(()=>e.abort(),this.config.timeoutMs);try{let t=`${this.config.url}/${this.config.apiKey}/mcp/${this.clientInfoBase64}`,n=await fetch(t,{headers:{...this.config.headers},method:`POST`,signal:e.signal});if(!n.ok)throw Error(`Access control service returned ${n.status}: ${n.statusText}`);let r=await n.json();if(!r.action||![`allow`,`block`].includes(r.action))throw Error(`Invalid access control response format: action="${r.action}"`);return r}catch(e){throw e instanceof Error&&e.name===`AbortError`?Error(`Access control check timed out after ${this.config.timeoutMs}ms`):e}finally{clearTimeout(t)}}},Ee=class{storageDir;constructor(e){this.storageDir=e.storageDir}async delete(e){let t=g(e),n=this.getFilePath(t);try{await E(n),b.debug(`Deleted stored credentials`,{filePath:n,serverUrl:t})}catch(e){e.code!==`ENOENT`&&b.warn(`Failed to delete stored credentials`,{error:String(e),filePath:n,serverUrl:t})}}hasRefreshToken(e){return!!e.tokens?.refresh_token}hasValidAccessToken(e){return!!e.tokens?.access_token&&!this.isAccessTokenExpired(e)}isAccessTokenExpired(e){if(!e.tokens||!e.tokensObtainedAt)return!0;let{expires_in:t}=e.tokens;if(!t)return!1;let n=new Date(e.tokensObtainedAt).getTime()+t*1e3,r=Date.now(),i=r>=n-3e4;return b.debug(`Checked access token expiration`,{expiresAt:new Date(n).toISOString(),expiresIn:t,isExpired:i,now:new Date(r).toISOString(),obtainedAt:e.tokensObtainedAt}),i}async load(e){let t=g(e),n=this.getFilePath(t);try{let e=await T(n,`utf-8`),r=JSON.parse(e);if(g(r.serverUrl)!==t){b.warn(`Credential file server URL mismatch`,{expected:t,filePath:n,found:r.serverUrl});return}return b.debug(`Loaded stored credentials`,{clientId:r.clientInfo?.client_id,hasRefreshToken:!!r.tokens?.refresh_token,hasTokens:!!r.tokens,serverUrl:t}),r}catch(e){if(e.code===`ENOENT`){b.debug(`No stored credentials found`,{serverUrl:t});return}b.warn(`Failed to load stored credentials`,{error:String(e),filePath:n,serverUrl:t});return}}async save(e){await this.ensureStorageDir();let t=this.getFilePath(e.serverUrl),n=JSON.stringify(e,null,2);try{await D(t,n,{encoding:`utf-8`,mode:384}),await C(t,384),b.debug(`Saved credentials to disk`,{clientId:e.clientInfo?.client_id,filePath:t,hasTokens:!!e.tokens,serverUrl:e.serverUrl})}catch(n){throw b.error(`Failed to save credentials`,{error:String(n),filePath:t,serverUrl:e.serverUrl}),n}}async update(e,t){let n=g(e),r=await this.load(n),i=new Date().toISOString(),a=r?{...r,...t,serverUrl:n,updatedAt:i}:{createdAt:i,serverUrl:n,updatedAt:i,...t};return await this.save(a),a}async ensureStorageDir(){try{await w(this.storageDir,{mode:448,recursive:!0})}catch(e){if(e.code!==`EEXIST`)throw e}try{await v(this.storageDir)}catch(e){b.warn(`Failed to fix OAuth storage directory ownership`,{error:String(e),storageDir:this.storageDir})}}generateKey(e){return x(`sha256`).update(e).digest(`hex`).substring(0,16)}getFilePath(e){let t=this.generateKey(e);return S(this.storageDir,`${t}.json`)}},De=class extends ue{buffer=``;droppedLinesLogged=0;constructor(){super({objectMode:!1})}_flush(e){this.buffer.trim().startsWith(`{`)?e(null,Buffer.from(this.buffer)):(this.buffer.trim().length>0&&this.logDroppedLine(this.buffer),e(null,null))}_transform(e,t,n){this.buffer+=e.toString();let r=this.buffer.split(`
2
- `);this.buffer=r.pop()||``;let i=[];for(let e of r)e.trim().startsWith(`{`)?i.push(e):e.trim().length>0&&this.logDroppedLine(e);if(i.length>0){let e=`${i.join(`
3
- `)}\n`;n(null,Buffer.from(e))}else n(null,null)}logDroppedLine(e){if(!(this.droppedLinesLogged>50)){if(this.droppedLinesLogged===50){this.droppedLinesLogged+=1,b.info(`Suppressing further non-JSON stdout lines`,{eventType:`mcp_server_stdout_dropped_suppressed`,loggedSoFar:50});return}this.droppedLinesLogged+=1,b.info(`MCP server stdout (non-JSON, dropped)`,{eventType:`mcp_server_stdout_dropped`,line:e.length>1024?`${e.slice(0,1024)}…`:e})}}},Oe=class{onclose;onerror;onmessage;get pid(){return this._process?.pid??null}get stderr(){return this._stderrStream?this._stderrStream:this._process?.stderr??null}_abortController=new AbortController;_process;_readBuffer=new i;_serverParams;_stderrStream=null;onEvent;constructor(e){this._serverParams=e,(e.stderr===`pipe`||e.stderr===`overlapped`)&&(this._stderrStream=new j),this.onEvent=e.onEvent}async close(){if(this.onEvent?.({type:`close`}),this._process?.pid)try{if(process.platform===`win32`){let e=A(`taskkill`,[`/PID`,String(this._process.pid),`/T`,`/F`],{stdio:`ignore`});if(e.error)throw e.error;if(e.status!==0)throw Error(`taskkill exited with status ${e.status}`)}else process.kill(-this._process.pid,`SIGTERM`)}catch(e){b.debug(`Process tree cleanup failed (process may already be dead)`,{error:e.message,pid:this._process.pid})}this._abortController.abort(),this._process=void 0,this._readBuffer.clear()}send(e){return new Promise(t=>{if(!this._process?.stdin)throw Error(`Not connected`);let n=f(e);this._process.stdin.write(n)?t():this._process.stdin.once(`drain`,t)})}async start(){if(this._process)throw Error(`StdioClientTransport already started! If using Client class, note that connect() calls start() automatically.`);return new Promise((e,t)=>{this._process=k(this._serverParams.command,this._serverParams.args??[],{cwd:this._serverParams.cwd,detached:process.platform!==`win32`,env:this._serverParams.env,shell:this._serverParams.shell??!1,signal:this._abortController.signal,stdio:[`pipe`,`pipe`,this._serverParams.stderr??`inherit`]}),this._process.on(`error`,e=>{if(e.name===`AbortError`){this.onclose?.();return}b.error(`Process spawn error`,{args:this._serverParams.args,command:this._serverParams.command,cwd:this._serverParams.cwd,error:e.message,errorCode:e.code,errorErrno:e.errno,errorSyscall:e.syscall,operation:`spawn`,shell:this._serverParams.shell,transportType:`stdio`}),t(e),this.onerror?.(e)});let n,r;this._process.on(`spawn`,()=>{n=Date.now(),r=this._process?.pid,b.info(`MCP server process spawned`,{argCount:this._serverParams.args?.length,command:this._serverParams.command,eventType:`mcp_server_process_spawned`,pid:r}),e()}),this._process.on(`close`,(e,t)=>{let i=n===void 0?void 0:Date.now()-n;b[e===0&&t===null?`info`:`warn`](`MCP server process closed`,{argCount:this._serverParams.args?.length,code:e,command:this._serverParams.command,eventType:`mcp_server_process_closed`,pid:r,signal:t,uptimeMs:i}),this.onEvent?.({type:`close`}),this._process=void 0,this.onclose?.()}),this._process.stdin?.on(`error`,e=>{b.error(`Stdin error`,{command:this._serverParams.command,error:e.message,operation:`write`,pid:this._process?.pid,transportType:`stdio`}),this.onEvent?.({error:e,type:`error`}),this.onerror?.(e)});let i=new De;this._process.stdout?.pipe(i),i.on(`data`,e=>{this.onEvent?.({chunk:e.toString(),type:`data`}),this._readBuffer.append(e),this.processReadBuffer()}),i.on(`error`,e=>{b.error(`JSON filter error`,{command:this._serverParams.command,error:e.message,operation:`parse`,pid:this._process?.pid,transportType:`stdio`}),this.onEvent?.({error:e,type:`error`}),this.onerror?.(e)}),this._stderrStream&&this._process.stderr&&this._process.stderr.pipe(this._stderrStream)})}processReadBuffer(){for(;;)try{let e=this._readBuffer.readMessage();if(e===null)break;this.onEvent?.({message:e,type:`message`}),this.onmessage?.(e)}catch(e){let t=`unknown`;try{let e=this._readBuffer.readMessage();e&&(t=typeof e)}catch{}b.error(`Message processing error`,{command:this._serverParams.command,error:e.message,messageType:t,operation:`process`,pid:this._process?.pid,transportType:`stdio`}),this.onEvent?.({error:e,type:`error`}),this.onerror?.(e)}}};function ke(e){let t=e.toLowerCase().split(/[/\\]/).pop()||``;return t===`docker`||t===`docker.exe`?`docker`:t===`podman`||t===`podman.exe`?`podman`:t===`nerdctl`||t===`nerdctl.exe`?`nerdctl`:t===`finch`||t===`finch.exe`?`finch`:`unknown`}function Ae(e){let t=e.indexOf(`run`);if(t===-1)return;let n=e.slice(t+1),r=new Set(`--add-host.--annotation.--arch.--attach.--blkio-weight.--blkio-weight-device.--cap-add.--cap-drop.--cgroup-parent.--cgroupns.--cidfile.--cosign-key.--cpu-period.--cpu-quota.--cpu-rt-period.--cpu-rt-runtime.--cpu-shares.--cpus.--cpuset-cpus.--cpuset-mems.--decryption-key.--device.--device-cgroup-rule.--device-read-bps.--device-read-iops.--device-write-bps.--device-write-iops.--dns.--dns-option.--dns-search.--domainname.--entrypoint.--env.--env-file.--env-host.--expose.--gidmap.--gpus.--group-add.--health-cmd.--health-interval.--health-retries.--health-start-period.--health-timeout.--hostname.--image-volume.--ip.--ip6.--ipc.--isolation.--kernel-memory.--label.--label-file.--link.--link-local-ip.--log-driver.--log-opt.--mac-address.--memory.--memory-reservation.--memory-swap.--memory-swappiness.--mount.--name.--network.--network-alias.--oom-kill-disable.--oom-score-adj.--os.--pid.--pidfile.--pids-limit.--platform.--pod.--privileged.--publish.--publish-all.--pull.--requires.--restart.--rootfs.--runtime.--secret.--security-opt.--shm-size.--stop-signal.--stop-timeout.--storage-opt.--subgidname.--subuidname.--sysctl.--systemd.--timeout.--tmpfs.--tz.--uidmap.--ulimit.--user.--userns.--uts.--variant.--volume.--volume-driver.--volumes-from.--workdir.-a.-c.-e.-h.-l.-m.-p.-P.-u.-v.-w`.split(`.`)),i=0;for(;i<n.length;){let e=n[i];if(e.startsWith(`-`)){if(e.includes(`=`)){i++;continue}if(r.has(e)){i+=2;continue}i++;continue}return e}}function je(e,t){try{let n=le(`${t===`unknown`?`docker`:t} image inspect --format "{{json .RepoDigests}}" ${JSON.stringify(e)}`,{encoding:`utf-8`,stdio:[`pipe`,`pipe`,`pipe`],timeout:5e3}).trim(),r;try{r=JSON.parse(n)}catch{return b.debug(`Could not parse RepoDigests JSON`,{imageName:e,result:n,runtime:t}),[]}let i=[];for(let e of r){let t=e.match(/sha256:[a-f0-9]{64}/i);t?i.push(t[0]):/^sha256:[a-f0-9]{64}$/i.test(e)&&i.push(e)}return i.length>0?(b.debug(`Container image digests retrieved`,{digests:i,imageName:e,runtime:t}),i):(b.debug(`No digests available for image (may be locally built)`,{imageName:e,runtime:t}),[])}catch(n){return b.debug(`Could not get container image digests`,{error:n instanceof Error?n.message:String(n),imageName:e,runtime:t}),[]}}function Me(e,t){let n=ke(e);if(n===`unknown`)return{imageDigests:[],imageName:``,isContainerMCP:!1,runtime:`unknown`};if(!t||!t.includes(`run`))return{imageDigests:[],imageName:``,isContainerMCP:!1,runtime:n};let r=Ae(t);return r?{imageDigests:je(r,n),imageName:r,isContainerMCP:!0,runtime:n}:(b.debug(`Container command detected but could not extract image name`,{args:t,command:e,runtime:n}),{imageDigests:[],imageName:``,isContainerMCP:!0,runtime:n})}O.inspect.defaultOptions.depth=8,`EventSource`in global||(global.EventSource=$);const Ne=async()=>{te(b);let i=await re(ne(process.argv)).scriptName(`mcp-gateway`).command(`stdio [command] [args...]`,`Run a local command with stdio transport (default)`,e=>e.positional(`command`,{describe:`The command to run`,type:`string`}).positional(`args`,{array:!0,describe:`The arguments to pass to the command`,type:`string`})).command(`remote`,`Connect to a remote MCP server`,e=>e.options({"bearer-token-env":{describe:`Environment variable name containing a bearer token for remote authentication`,type:`string`},"env-http-headers":{describe:`HTTP headers resolved from environment variables (format: HeaderName:ENV_VAR_NAME)`,string:!0,type:`array`},headers:{deprecated:`Use --env-http-headers with env var names instead. --headers exposes values in process listings.`,describe:`Legacy: headers with literal values (format: key:value)`,string:!0,type:`array`},"remote-transport":{choices:[`sse`,`stream`],deprecated:`Transport is now auto-detected per MCP spec. This option is ignored.`,describe:`(Deprecated) The transport type - now auto-detected`,type:`string`},url:{demandOption:!0,describe:`The URL of the remote MCP server`,type:`string`}})).command(`$0 [command] [args...]`,`Run a command with MCP arguments (backward compatible)`,e=>e.positional(`command`,{describe:`The command to run`,type:`string`}).positional(`args`,{array:!0,describe:`The arguments to pass to the command`,type:`string`})).env(`MCP_GATEWAY`).parserConfiguration({"populate--":!0,"unknown-options-as-args":!0}).options({"access-control-url":{describe:`URL of the access control service (overrides MCP_GATEWAY_ACCESS_CONTROL_URL)`,type:`string`},debug:{default:!1,describe:`Enable debug logging`,type:`boolean`},env:{describe:`Environment variables to pass to the command (format: KEY=value)`,string:!0,type:`array`},gracefulShutdownTimeout:{default:5e3,describe:`The timeout (in milliseconds) for graceful shutdown`,type:`number`},"oauth-providers-url":{describe:`URL of the OAuth providers config endpoint (overrides MCP_GATEWAY_OAUTH_PROVIDERS_URL)`,type:`string`},port:{describe:`Run as HTTP server on the specified port instead of stdio`,type:`number`},"scanner-api-key":{describe:`API key for scanner authentication (overrides MCP_GATEWAY_SCANNER_API_KEY)`,type:`string`},"scanner-fail-open":{describe:`Allow requests when scanner is unavailable (overrides MCP_GATEWAY_SCANNER_FAIL_OPEN)`,type:`boolean`},"scanner-timeout-ms":{describe:`Scanner request timeout in milliseconds (overrides MCP_GATEWAY_SCANNER_TIMEOUT_MS)`,type:`number`},"scanner-url":{describe:`URL of the scanner/evaluator service (overrides MCP_GATEWAY_SCANNER_URL)`,type:`string`},shell:{default:process.platform===`win32`,describe:`Spawn the server via the user's shell (defaults to true on Windows)`,type:`boolean`}}).help().parseAsync();await ie(_.oauthProviders);let s,f,h,v,x,S={},C={};if(i.env)for(let e of i.env){let[t,...n]=e.split(`=`);t&&n.length>0&&(C[t.trim()]=n.join(`=`).trim())}let w=e=>{if(e.includes("${")){let t,n=e.replace(/\$\{([A-Za-z_][A-Za-z0-9_]*)\}/g,(e,n)=>process.env[n]||(t=n,``));return t?{missingVar:t,resolved:``}:{resolved:n}}let t=process.env[e];return t?{resolved:t}:{missingVar:e,resolved:``}};if(i.headers)for(let e of i.headers){let[t,...n]=e.split(`:`);t&&n.length>0&&(S[t.trim()]=n.join(`:`).trim())}if(i.bearerTokenEnv){let e=i.bearerTokenEnv,{missingVar:t,resolved:n}=w(e);t&&(b.error(`Bearer token env var specified but not set`,{envVar:t,eventType:`mcp_auth_bearer_env_missing`}),process.exit(1)),S.Authorization=`Bearer ${n}`,b.info(`Bearer token loaded from environment variable`,{authType:`bearer_token`,envVar:e,eventType:`mcp_auth_bearer_env`,remoteUrl:i.url})}if(i.envHttpHeaders)for(let e of i.envHttpHeaders){let[t,...n]=e.split(`:`),r=n.join(`:`).trim();if(t&&r){let e=t.trim(),{missingVar:n,resolved:a}=w(r);n&&(b.error(`Env var for HTTP header not set`,{envVar:n,eventType:`mcp_auth_env_header_missing`,header:e}),process.exit(1)),S[e]=a,b.info(`HTTP header loaded from environment`,{eventType:`mcp_auth_env_header`,header:e,remoteUrl:i.url})}}let T=ee(S);if(T&&b.setTraceId(T),S.Authorization){let e=S.Authorization.startsWith(`Bearer `)?`bearer_token`:S.Authorization.startsWith(`Basic `)?`basic`:`api_key`;b.info(`Authorization header provided`,{authType:e,eventType:`mcp_auth_header_provided`,remoteUrl:i.url})}let E={..._.scanner.headers};if(b.debug(`Initializing traffic scanner`,{failOpen:_.scanner.failOpen,hasApiKey:!!_.scanner.apiKey,scannerEnabled:_.scanner.enabled,scannerUrl:_.scanner.url,timeoutMs:_.scanner.timeoutMs}),i._[0]===`remote`){s=`remote`,i[`remote-transport`]&&b.warn(`The --remote-transport option is deprecated and will be ignored. Transport is now auto-detected per MCP spec (Streamable HTTP with SSE fallback).`,{providedTransport:i[`remote-transport`]});let e=i.url;if(!e)throw new n(`Remote URL is required for remote proxy type`,`url`);v=g(e),v!==e&&b.debug(`Normalized remote URL`,{normalizedUrl:v,originalUrl:e})}else{if(s=`stdio`,i[`--`]&&i[`--`].length>0){let e=i[`--`];f=e[0],h=e.slice(1).map(String)}else f=i.command,h=(i.args||[]).map(String);if(!f)throw new n(`No command specified for stdio proxy`,`command`)}let D;s===`stdio`&&f&&(D=Me(f,h),D.isContainerMCP&&b.info(`Container MCP detected`,{imageDigests:D.imageDigests,imageName:D.imageName,runtime:D.runtime}));let O;if(_.accessControl.url&&_.scanner.apiKey){let e=await c(),t=s===`stdio`?{...e,proxyType:`stdio`,stdioCliArgs:{args:h,command:f,dockerImageDigests:D?.imageDigests,dockerImageName:D?.imageName,proxyType:`stdio`}}:{...e,proxyType:`remote`,remoteCliArgs:{proxyType:`remote`,url:v}};O=new Te({apiKey:_.scanner.apiKey,headers:_.accessControl.headers,sessionData:t,timeoutMs:_.accessControl.timeoutMs,url:_.accessControl.url})}let le=s===`remote`?v:f,k=new we({client:O,enabled:_.accessControl.enabled,serverName:le}),A=new Ee({storageDir:_.oauthDir}),j=()=>new t({name:`mcp-gateway`,version:_.appVersion},{capabilities:{}}),ue=async t=>{if(!await k.isAllowed()){let t=k.getBlockReason();throw b.warn(`MCP server blocked by access control`,{proxyType:s,reason:t}),new e(t,`policy_block`)}if(b.info(`MCP server allowed by access control`),s===`stdio`){let e={...process.env,...C},n=new Oe({args:h,command:f,env:e,onEvent:e=>{i.debug&&b.debug(`Transport event`,{event:e})},shell:i.shell,stderr:`pipe`}),a=1024;a*8;let o=e=>e.length>a?`${e.slice(0,a)}…`:e,c=``,l=[],u=e=>{let t=o(e);l.push(t),l.length>100&&l.shift(),b.info(`MCP server stderr`,{command:f,eventType:`mcp_server_stderr`,line:t})},d=()=>{c.length!==0&&(u(c),c=``)},p=new se(`utf8`),m=!1,g=()=>{if(m)return;m=!0;let e=p.end();e&&(c+=e),d()};n.stderr?.on(`data`,e=>{process.stderr.write(e),c+=p.write(e);let t=c.split(`
4
- `);c=t.pop()??``;for(let e of t){if(e.length===0)continue;u(e)}c.length>8192&&d()}),n.stderr?.once(`end`,g),n.stderr?.once(`close`,g);try{return await t.connect(n),t}catch(e){throw g(),b.warn(`Failed original server access`,{command:f,error:e instanceof Error?e.message:String(e),eventType:`mcp_server_access_failed`,proxyType:s,stderrTail:l.slice(-20)}),new r(`Failed to connect to stdio process: ${e}`,void 0,`stdio`,{argCount:h?.length,command:f})}}else if(s===`remote`){let e=v,t=e=>{let t={...S};return e&&(t.Authorization=`Bearer ${e}`),Object.keys(t).length>0?{headers:t}:void 0},n=e=>{if(e instanceof m)return!0;if(e&&typeof e==`object`){let t=e.status,n=e.code,r=e.message;if(t===401||n===401||r&&/unauthorized|401/i.test(String(r)))return!0}return!1},i=async()=>{let t=await oe(e,{credentialStore:A});return b.info(`Authentication performed`,{authType:`oauth`,eventType:`mcp_auth_performed`,fromCache:t.fromCache,remoteUrl:e}),t.tokens.access_token},a;try{let r=await A.load(e),o=r&&A.hasValidAccessToken(r)?r.tokens?.access_token:void 0,s=!1;try{let n=await ae(j,e,t(o));a=n.client,x=n.transportType,b.info(`Connected to remote server`,{hasAuth:!!o,transport:x})}catch(r){if(n(r)){if(s)throw r;o?(b.info(`Cached OAuth token rejected (possibly revoked), invalidating and re-authorizing...`),await A.update(e,{tokens:void 0,tokensObtainedAt:void 0})):b.info(`Server requires OAuth, starting authentication flow...`),o=await i(),s=!0;let n=await ae(j,e,t(o));a=n.client,x=n.transportType,b.info(`Connected to remote server with OAuth`,{transport:x})}else throw r}return a}catch(t){throw b.warn(`Failed original server access`,{error:t instanceof Error?t.message:String(t),eventType:`mcp_server_access_failed`,proxyType:s,remoteUrl:e}),t instanceof r?t:new r(`Failed to connect to remote server: ${t instanceof Error?t.message:String(t)}`,e,x,{headerCount:Object.keys(S).length})}}return t},de=async()=>{if(i.port){let e=s===`stdio`?{args:h,command:f,dockerImageDigests:D?.imageDigests,dockerImageName:D?.imageName,proxyType:s}:{proxyType:s,url:v};await l({cliArgs:e,scanApiKey:_.scanner.apiKey,scanEnabled:_.scanner.enabled,scanFailOpen:_.scanner.failOpen,scanHeaders:E,scanTimeoutMs:_.scanner.timeoutMs,scanUrl:_.scanner.url||``});let t,n=await p({createServer:async()=>{let e=j();t=await ue(e);let n=t.getServerVersion(),r=t.getServerCapabilities(),i=new a(n,{capabilities:r});return d({authorizer:k,client:t,server:i,serverCapabilities:r}),i},onClose:async e=>{t&&await t.close(),await e.close()},port:i.port});return b.info(`MCP gateway started`,{eventType:`mcp_gateway_started`,mode:`http`,port:i.port,proxyType:s}),s===`stdio`?b.info(`MCP server configuration`,{args:h?.join(` `)||``,command:f,eventType:`mcp_server_config`,proxyType:s}):b.info(`MCP server configuration`,{eventType:`mcp_server_config`,proxyType:s,remoteUrl:v}),{close:()=>n.close()}}let e=j(),t=await ue(e),n=t.getServerVersion(),r=t.getServerCapabilities(),c=new a(n,{capabilities:r});d({authorizer:k,client:t,server:c,serverCapabilities:r});let u=new o,m=s===`stdio`?{args:h,command:f,dockerImageDigests:D?.imageDigests,dockerImageName:D?.imageName,proxyType:s}:{proxyType:s,url:v};return await l({cliArgs:m,scanApiKey:_.scanner.apiKey,scanEnabled:_.scanner.enabled,scanFailOpen:_.scanner.failOpen,scanHeaders:E,scanTimeoutMs:_.scanner.timeoutMs,scanUrl:_.scanner.url||``}),await c.connect(u),b.info(`MCP gateway started`,{eventType:`mcp_gateway_started`,mode:`stdio`,proxyType:s}),b.info(`MCP server configuration`,{capabilities:Object.keys(r||{}),eventType:`mcp_server_config`,proxyType:s,serverName:n?.name,serverVersion:n?.version,...s===`stdio`?{args:h?.join(` `)||``,command:f}:{remoteUrl:v,transport:x}}),{close:()=>t.close()}},fe=({server:e,timeout:t})=>{let n=!1,r=async r=>{if(!n){n=!0,b.info(`MCP gateway stopping`,{eventType:`mcp_gateway_stopping`,signal:r});try{await e.close(),u(),await y(2e3),process.exit(0)}catch(e){let n=`Error during shutdown: ${e}`;b.error(`Error during shutdown`,{error:n,eventType:`mcp_gateway_stopped`,shutdownTimeout:t}),await y(2e3),process.exit(1)}}},i=e=>async()=>{ce(()=>{b.error(`Graceful shutdown timeout exceeded, forcing exit`),process.exit(1)},t).unref(),await r(e)};return process.once(`SIGTERM`,i(`SIGTERM`)),process.once(`SIGINT`,i(`SIGINT`)),process.stdin.once(`end`,i(`stdin-end`)),()=>e.close()};b.info(`MCP gateway starting`,{command:f,eventType:`mcp_gateway_starting`,proxyType:s,transport:s===`remote`?`auto-detect`:`stdio`,url:v});try{let e=await de();fe({server:e,timeout:i.gracefulShutdownTimeout})}catch(t){t instanceof e&&(console.error(`
5
- ❌ ACCESS DENIED`),console.error(`━`.repeat(60)),console.error(`
6
- This MCP server has been blocked by Onyx because it is not authorized by your organization's access control policy. Please contact your administrator if you believe this is an error.
7
- `),b.error(`MCP server blocked by access control policy`,{error:t.message,reason:t.reason}),await y(2e3),process.exit(1));let n=`Could not start the proxy: ${t}`;b.error(`MCP server failed to start`,{args:h,command:f,error:n,eventType:`mcp_server_start_failed`,proxyType:s,remoteUrl:v,transport:x}),await y(2e3),process.exit(1)}};export{Ne as main};
8
- //# sourceMappingURL=main-BP88lLlU.js.map