@layervai/qurl-mcp 0.8.3 → 0.10.0

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 (131) hide show
  1. package/README.md +118 -6
  2. package/dist/auth/hosted-oauth.d.ts +30 -0
  3. package/dist/auth/hosted-oauth.d.ts.map +1 -0
  4. package/dist/auth/hosted-oauth.js +232 -0
  5. package/dist/auth/hosted-oauth.js.map +1 -0
  6. package/dist/client.d.ts +2 -0
  7. package/dist/client.d.ts.map +1 -1
  8. package/dist/client.js.map +1 -1
  9. package/dist/config.d.ts +4 -0
  10. package/dist/config.d.ts.map +1 -1
  11. package/dist/config.js +38 -0
  12. package/dist/config.js.map +1 -1
  13. package/dist/http-config.d.ts +5 -0
  14. package/dist/http-config.d.ts.map +1 -1
  15. package/dist/http-config.js +6 -36
  16. package/dist/http-config.js.map +1 -1
  17. package/dist/http-feedback.d.ts +3 -0
  18. package/dist/http-feedback.d.ts.map +1 -0
  19. package/dist/http-feedback.js +90 -0
  20. package/dist/http-feedback.js.map +1 -0
  21. package/dist/http-public-routes.d.ts +19 -0
  22. package/dist/http-public-routes.d.ts.map +1 -0
  23. package/dist/http-public-routes.js +183 -0
  24. package/dist/http-public-routes.js.map +1 -0
  25. package/dist/http-routes.d.ts +4 -1
  26. package/dist/http-routes.d.ts.map +1 -1
  27. package/dist/http-routes.js +6 -0
  28. package/dist/http-routes.js.map +1 -1
  29. package/dist/http-sessions.d.ts +39 -0
  30. package/dist/http-sessions.d.ts.map +1 -0
  31. package/dist/http-sessions.js +140 -0
  32. package/dist/http-sessions.js.map +1 -0
  33. package/dist/http.d.ts +1 -1
  34. package/dist/http.d.ts.map +1 -1
  35. package/dist/http.js +153 -302
  36. package/dist/http.js.map +1 -1
  37. package/dist/logging.d.ts.map +1 -1
  38. package/dist/logging.js +2 -0
  39. package/dist/logging.js.map +1 -1
  40. package/dist/prompts/rotate-access.js +1 -1
  41. package/dist/prompts/rotate-access.js.map +1 -1
  42. package/dist/prompts/secure-a-service.d.ts.map +1 -1
  43. package/dist/prompts/secure-a-service.js +1 -0
  44. package/dist/prompts/secure-a-service.js.map +1 -1
  45. package/dist/server.d.ts +24 -37
  46. package/dist/server.d.ts.map +1 -1
  47. package/dist/server.js +116 -30
  48. package/dist/server.js.map +1 -1
  49. package/dist/services/feedback.d.ts +30 -0
  50. package/dist/services/feedback.d.ts.map +1 -0
  51. package/dist/services/feedback.js +133 -0
  52. package/dist/services/feedback.js.map +1 -0
  53. package/dist/tools/_shared.d.ts +6 -2
  54. package/dist/tools/_shared.d.ts.map +1 -1
  55. package/dist/tools/_shared.js +13 -0
  56. package/dist/tools/_shared.js.map +1 -1
  57. package/dist/tools/batch-create.d.ts +4 -8
  58. package/dist/tools/batch-create.d.ts.map +1 -1
  59. package/dist/tools/consumer-access.d.ts +174 -16
  60. package/dist/tools/consumer-access.d.ts.map +1 -1
  61. package/dist/tools/consumer-access.js +67 -4
  62. package/dist/tools/consumer-access.js.map +1 -1
  63. package/dist/tools/create-qurl.d.ts +4 -8
  64. package/dist/tools/create-qurl.d.ts.map +1 -1
  65. package/dist/tools/create-qurl.js +6 -2
  66. package/dist/tools/create-qurl.js.map +1 -1
  67. package/dist/tools/delete-qurl.d.ts +1 -8
  68. package/dist/tools/delete-qurl.d.ts.map +1 -1
  69. package/dist/tools/duration.d.ts.map +1 -1
  70. package/dist/tools/duration.js +20 -5
  71. package/dist/tools/duration.js.map +1 -1
  72. package/dist/tools/extend-qurl.d.ts +5 -12
  73. package/dist/tools/extend-qurl.d.ts.map +1 -1
  74. package/dist/tools/get-qurl.d.ts +5 -12
  75. package/dist/tools/get-qurl.d.ts.map +1 -1
  76. package/dist/tools/list-qurl-sessions.d.ts +1 -8
  77. package/dist/tools/list-qurl-sessions.d.ts.map +1 -1
  78. package/dist/tools/list-qurls.d.ts +5 -12
  79. package/dist/tools/list-qurls.d.ts.map +1 -1
  80. package/dist/tools/local-cli.d.ts.map +1 -1
  81. package/dist/tools/local-cli.js +20 -13
  82. package/dist/tools/local-cli.js.map +1 -1
  83. package/dist/tools/mint-link.d.ts +1 -8
  84. package/dist/tools/mint-link.d.ts.map +1 -1
  85. package/dist/tools/mint-link.js +1 -1
  86. package/dist/tools/mint-link.js.map +1 -1
  87. package/dist/tools/mint-uploaded-file-link.d.ts +53 -0
  88. package/dist/tools/mint-uploaded-file-link.d.ts.map +1 -0
  89. package/dist/tools/mint-uploaded-file-link.js +43 -0
  90. package/dist/tools/mint-uploaded-file-link.js.map +1 -0
  91. package/dist/tools/output-schemas.d.ts +37 -24
  92. package/dist/tools/output-schemas.d.ts.map +1 -1
  93. package/dist/tools/output-schemas.js +40 -14
  94. package/dist/tools/output-schemas.js.map +1 -1
  95. package/dist/tools/resolve-qurl.d.ts +1 -8
  96. package/dist/tools/resolve-qurl.d.ts.map +1 -1
  97. package/dist/tools/revoke-qurl-token.d.ts +1 -8
  98. package/dist/tools/revoke-qurl-token.d.ts.map +1 -1
  99. package/dist/tools/share-by-crid.d.ts +1 -8
  100. package/dist/tools/share-by-crid.d.ts.map +1 -1
  101. package/dist/tools/share-by-crid.js +2 -2
  102. package/dist/tools/share-by-crid.js.map +1 -1
  103. package/dist/tools/submit-feedback.d.ts +47 -0
  104. package/dist/tools/submit-feedback.d.ts.map +1 -0
  105. package/dist/tools/submit-feedback.js +81 -0
  106. package/dist/tools/submit-feedback.js.map +1 -0
  107. package/dist/tools/terminate-qurl-sessions.d.ts +1 -8
  108. package/dist/tools/terminate-qurl-sessions.d.ts.map +1 -1
  109. package/dist/tools/update-qurl-token.d.ts +3 -10
  110. package/dist/tools/update-qurl-token.d.ts.map +1 -1
  111. package/dist/tools/update-qurl.d.ts +5 -12
  112. package/dist/tools/update-qurl.d.ts.map +1 -1
  113. package/dist/tools/upload-file-data-qurl.d.ts +1 -8
  114. package/dist/tools/upload-file-data-qurl.d.ts.map +1 -1
  115. package/dist/tools/upload-file-data-qurl.js +1 -1
  116. package/dist/tools/upload-file-data-qurl.js.map +1 -1
  117. package/dist/tools/upload-file-qurl.d.ts +1 -8
  118. package/dist/tools/upload-file-qurl.d.ts.map +1 -1
  119. package/dist/tools/upload-file-qurl.js +1 -1
  120. package/dist/tools/upload-file-qurl.js.map +1 -1
  121. package/dist/tools/upload-file-shared.d.ts +22 -8
  122. package/dist/tools/upload-file-shared.d.ts.map +1 -1
  123. package/dist/tools/upload-file-shared.js +47 -34
  124. package/dist/tools/upload-file-shared.js.map +1 -1
  125. package/dist/tools/upload-mint-options.d.ts +2 -1
  126. package/dist/tools/upload-mint-options.d.ts.map +1 -1
  127. package/dist/tools/upload-mint-options.js +4 -2
  128. package/dist/tools/upload-mint-options.js.map +1 -1
  129. package/dist/tools/upload-text-qurl.d.ts +4 -11
  130. package/dist/tools/upload-text-qurl.d.ts.map +1 -1
  131. package/package.json +7 -7
@@ -0,0 +1,183 @@
1
+ import { createHash } from "node:crypto";
2
+ import { createReadStream } from "node:fs";
3
+ import { lstat } from "node:fs/promises";
4
+ import { rateLimit } from "express-rate-limit";
5
+ import { formatErrorForLog, logInfo } from "./logging.js";
6
+ import { getLegalDocuments, renderLegalDocumentHtml } from "./services/legal-pages.js";
7
+ import { getPublicVideoFileRoute, renderPublicVideoPageHtml } from "./services/video-page.js";
8
+ export function createPublicRateLimiter(config) {
9
+ return rateLimit({
10
+ windowMs: 60_000,
11
+ limit: config.publicFileRateLimitPerMinute,
12
+ ipv6Subnet: 56,
13
+ standardHeaders: "draft-8",
14
+ legacyHeaders: false,
15
+ handler: (_req, res) => {
16
+ res.status(429).send("Too many requests.");
17
+ },
18
+ });
19
+ }
20
+ export function createPublicHttpRoutes(config, options) {
21
+ const baseUrl = config.baseUrl;
22
+ // Page traffic, byte ranges, and the runtime's health limiter use separate buckets.
23
+ const publicRouteRateLimiter = createPublicRateLimiter(config);
24
+ const videoFileRateLimiter = createPublicRateLimiter(config);
25
+ let legalDocuments = [];
26
+ async function streamPublicVideo(req, res, filePath) {
27
+ setPublicPageSecurityHeaders(res);
28
+ let stats;
29
+ try {
30
+ // Refuse a final-component symlink so a public video path cannot be
31
+ // retargeted to a different local file after operator configuration.
32
+ // Intermediate directory symlinks retain normal resolution because this
33
+ // absolute path is trusted operator config, never request-derived input.
34
+ stats = await lstat(filePath);
35
+ }
36
+ catch (error) {
37
+ console.error(`[public-video] file inspection failed (${formatErrorForLog(error)})`);
38
+ res.status(404).send("Configured video file was not found.");
39
+ return;
40
+ }
41
+ if (stats.isSymbolicLink() || !stats.isFile() || stats.size === 0) {
42
+ res.status(404).send("Configured video file was not found.");
43
+ return;
44
+ }
45
+ // Content-Length is a request-time snapshot. Public media is trusted,
46
+ // operator-owned configuration and should be replaced atomically; if it
47
+ // is truncated in place, the stream error path below destroys the response
48
+ // rather than serving a silently successful partial body.
49
+ const fileSize = stats.size;
50
+ const range = req.headers.range;
51
+ const pipeFile = (start, end) => {
52
+ const stream = options.fileStreamFactory
53
+ ? options.fileStreamFactory(filePath, { start, end })
54
+ : createReadStream(filePath, { start, end });
55
+ const destroyStream = () => stream.destroy();
56
+ res.once("close", destroyStream);
57
+ stream.once("close", () => res.off("close", destroyStream));
58
+ stream.once("error", (error) => {
59
+ console.error(`[public-video] stream failed (${formatErrorForLog(error)})`);
60
+ res.destroy(error);
61
+ });
62
+ stream.pipe(res);
63
+ };
64
+ res.setHeader("Accept-Ranges", "bytes");
65
+ res.setHeader("Content-Type", "video/mp4");
66
+ res.setHeader("Cache-Control", "public, max-age=300");
67
+ res.setHeader("Cross-Origin-Resource-Policy", "same-origin");
68
+ res.vary("Range");
69
+ const rejectRange = () => {
70
+ res.status(416);
71
+ res.setHeader("Content-Range", `bytes */${fileSize}`);
72
+ // Do not let a shared cache retain a malformed/unsatisfiable request's
73
+ // response under the public representation's cache policy.
74
+ res.setHeader("Cache-Control", "no-store");
75
+ res.end();
76
+ };
77
+ if (!range) {
78
+ res.setHeader("Content-Length", fileSize);
79
+ pipeFile();
80
+ return;
81
+ }
82
+ // Single ranges cover browser video playback. RFC 9110 permits a server to
83
+ // reject unsupported multi-range requests, which we answer with 416.
84
+ const match = /^bytes=(\d*)-(\d*)$/.exec(range);
85
+ if (!match) {
86
+ rejectRange();
87
+ return;
88
+ }
89
+ const parsedStart = match[1] ? Number(match[1]) : undefined;
90
+ const parsedEnd = match[2] ? Number(match[2]) : undefined;
91
+ if ((parsedStart === undefined && parsedEnd === undefined) ||
92
+ (parsedStart !== undefined && !Number.isSafeInteger(parsedStart)) ||
93
+ (parsedEnd !== undefined && !Number.isSafeInteger(parsedEnd))) {
94
+ rejectRange();
95
+ return;
96
+ }
97
+ let start = parsedStart ?? 0;
98
+ let end = parsedEnd ?? fileSize - 1;
99
+ if (parsedStart === undefined && parsedEnd !== undefined) {
100
+ start = Math.max(fileSize - parsedEnd, 0);
101
+ end = fileSize - 1;
102
+ }
103
+ else {
104
+ // RFC 9110 treats an explicit last-byte position beyond the selected
105
+ // representation as the representation's final byte.
106
+ end = Math.min(end, fileSize - 1);
107
+ }
108
+ if (start < 0 || end < 0 || start >= fileSize || start > end) {
109
+ rejectRange();
110
+ return;
111
+ }
112
+ const chunkSize = end - start + 1;
113
+ res.status(206);
114
+ res.setHeader("Content-Range", `bytes ${start}-${end}/${fileSize}`);
115
+ res.setHeader("Content-Length", chunkSize);
116
+ pipeFile(start, end);
117
+ }
118
+ function getInlineStyleSources(html) {
119
+ // Page renderers must keep style blocks static. Interpolating request or
120
+ // config data into CSS would make this live-content hash authorize it.
121
+ return [...html.matchAll(/<style[^>]*>([\s\S]*?)<\/style>/gi)].map((match) => `'sha256-${createHash("sha256").update(match[1], "utf8").digest("base64")}'`);
122
+ }
123
+ function setPublicPageSecurityHeaders(res, styleSources = [], allowSameOriginMedia = false) {
124
+ const stylePolicy = styleSources.length > 0 ? styleSources.join(" ") : "'none'";
125
+ const mediaPolicy = allowSameOriginMedia ? "'self'" : "'none'";
126
+ res.set({
127
+ "Content-Security-Policy": `default-src 'none'; style-src ${stylePolicy}; img-src 'none'; media-src ${mediaPolicy}; base-uri 'none'; form-action 'none'; frame-ancestors 'none'`,
128
+ "Referrer-Policy": "no-referrer",
129
+ "X-Content-Type-Options": "nosniff",
130
+ "X-Frame-Options": "DENY",
131
+ });
132
+ }
133
+ function register(app) {
134
+ legalDocuments = config.serveLayerVLegalPages ? getLegalDocuments() : [];
135
+ for (const document of legalDocuments) {
136
+ const html = renderLegalDocumentHtml(document.path, baseUrl);
137
+ if (!html)
138
+ continue;
139
+ const styleSources = getInlineStyleSources(html);
140
+ app.get(document.path, publicRouteRateLimiter, (_req, res) => {
141
+ setPublicPageSecurityHeaders(res, styleSources);
142
+ res.type("html").send(html);
143
+ });
144
+ }
145
+ if (config.publicVideo) {
146
+ const publicVideo = config.publicVideo;
147
+ const videoPagePath = publicVideo.pagePath;
148
+ const videoFileRoute = getPublicVideoFileRoute(videoPagePath);
149
+ const videoPageHtml = renderPublicVideoPageHtml(publicVideo, baseUrl);
150
+ const videoStyleSources = getInlineStyleSources(videoPageHtml);
151
+ app.get(videoPagePath, publicRouteRateLimiter, (_req, res) => {
152
+ setPublicPageSecurityHeaders(res, videoStyleSources, true);
153
+ res.type("html").send(videoPageHtml);
154
+ });
155
+ app.get(videoFileRoute, videoFileRateLimiter, async (req, res) => {
156
+ await streamPublicVideo(req, res, publicVideo.filePath);
157
+ });
158
+ }
159
+ }
160
+ function logStartupStatus() {
161
+ logInfo(`Public legal pages enabled: ${legalDocuments.length}`);
162
+ if (config.publicVideo) {
163
+ logInfo("Public video page enabled.");
164
+ // The video is an optional public asset, not an MCP readiness
165
+ // dependency. Warn at boot but keep /healthz and MCP available; the
166
+ // request path independently fails closed until the asset is usable.
167
+ void lstat(config.publicVideo.filePath)
168
+ .then((stats) => {
169
+ if (stats.isSymbolicLink() || !stats.isFile()) {
170
+ console.warn("[public-video] configured path is not a regular file at startup");
171
+ }
172
+ else if (stats.size === 0) {
173
+ console.warn("[public-video] configured video file is empty at startup");
174
+ }
175
+ })
176
+ .catch(() => {
177
+ console.warn("[public-video] configured video file is unavailable at startup");
178
+ });
179
+ }
180
+ }
181
+ return { register, logStartupStatus, streamPublicVideo, publicRouteRateLimiter };
182
+ }
183
+ //# sourceMappingURL=http-public-routes.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"http-public-routes.js","sourceRoot":"","sources":["../src/http-public-routes.ts"],"names":[],"mappings":"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"}
@@ -1,5 +1,8 @@
1
+ export declare const FEEDBACK_HTTP_PATH = "/feedback";
1
2
  export declare const MCP_HTTP_PATH = "/mcp";
3
+ export declare const GOOGLE_CONNECTED_APPS_VERIFICATION_PATH = "/.well-known/google-connected-apps";
2
4
  export declare const HEALTH_HTTP_PATH = "/healthz";
3
5
  export declare const LEGAL_HTTP_PATH_PREFIX = "/legal";
4
- export declare const RESERVED_PUBLIC_PATH_PREFIXES: readonly ["/mcp", "/healthz", "/legal"];
6
+ export declare const OAUTH_RESOURCE_METADATA_PATH = "/.well-known/oauth-protected-resource";
7
+ export declare const RESERVED_PUBLIC_PATH_PREFIXES: readonly ["/mcp", "/feedback", "/healthz", "/legal", "/.well-known/oauth-protected-resource", "/.well-known/google-connected-apps"];
5
8
  //# sourceMappingURL=http-routes.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"http-routes.d.ts","sourceRoot":"","sources":["../src/http-routes.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,SAAS,CAAC;AACpC,eAAO,MAAM,gBAAgB,aAAa,CAAC;AAC3C,eAAO,MAAM,sBAAsB,WAAW,CAAC;AAK/C,eAAO,MAAM,6BAA6B,yCAIhC,CAAC"}
1
+ {"version":3,"file":"http-routes.d.ts","sourceRoot":"","sources":["../src/http-routes.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAC9C,eAAO,MAAM,aAAa,SAAS,CAAC;AACpC,eAAO,MAAM,uCAAuC,uCAAuC,CAAC;AAC5F,eAAO,MAAM,gBAAgB,aAAa,CAAC;AAC3C,eAAO,MAAM,sBAAsB,WAAW,CAAC;AAC/C,eAAO,MAAM,4BAA4B,0CAA0C,CAAC;AAKpF,eAAO,MAAM,6BAA6B,qIAOhC,CAAC"}
@@ -1,12 +1,18 @@
1
+ export const FEEDBACK_HTTP_PATH = "/feedback";
1
2
  export const MCP_HTTP_PATH = "/mcp";
3
+ export const GOOGLE_CONNECTED_APPS_VERIFICATION_PATH = "/.well-known/google-connected-apps";
2
4
  export const HEALTH_HTTP_PATH = "/healthz";
3
5
  export const LEGAL_HTTP_PATH_PREFIX = "/legal";
6
+ export const OAUTH_RESOURCE_METADATA_PATH = "/.well-known/oauth-protected-resource";
4
7
  // Public-video paths must not shadow protocol, health, or legal routes. Keep
5
8
  // this list derived from the route constants so adding or renaming one cannot
6
9
  // silently diverge from config validation.
7
10
  export const RESERVED_PUBLIC_PATH_PREFIXES = [
8
11
  MCP_HTTP_PATH,
12
+ FEEDBACK_HTTP_PATH,
9
13
  HEALTH_HTTP_PATH,
10
14
  LEGAL_HTTP_PATH_PREFIX,
15
+ OAUTH_RESOURCE_METADATA_PATH,
16
+ GOOGLE_CONNECTED_APPS_VERIFICATION_PATH,
11
17
  ];
12
18
  //# sourceMappingURL=http-routes.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"http-routes.js","sourceRoot":"","sources":["../src/http-routes.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC;AACpC,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAC;AAC3C,MAAM,CAAC,MAAM,sBAAsB,GAAG,QAAQ,CAAC;AAE/C,6EAA6E;AAC7E,8EAA8E;AAC9E,2CAA2C;AAC3C,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,aAAa;IACb,gBAAgB;IAChB,sBAAsB;CACd,CAAC"}
1
+ {"version":3,"file":"http-routes.js","sourceRoot":"","sources":["../src/http-routes.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,WAAW,CAAC;AAC9C,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC;AACpC,MAAM,CAAC,MAAM,uCAAuC,GAAG,oCAAoC,CAAC;AAC5F,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAC;AAC3C,MAAM,CAAC,MAAM,sBAAsB,GAAG,QAAQ,CAAC;AAC/C,MAAM,CAAC,MAAM,4BAA4B,GAAG,uCAAuC,CAAC;AAEpF,6EAA6E;AAC7E,8EAA8E;AAC9E,2CAA2C;AAC3C,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,aAAa;IACb,kBAAkB;IAClB,gBAAgB;IAChB,sBAAsB;IACtB,4BAA4B;IAC5B,uCAAuC;CAC/B,CAAC"}
@@ -0,0 +1,39 @@
1
+ import type { Buffer } from "node:buffer";
2
+ import type { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
3
+ import type { createServer } from "./server.js";
4
+ import type { HttpServerConfig } from "./http-config.js";
5
+ export type SessionContext = {
6
+ sessionId: string;
7
+ transport: StreamableHTTPServerTransport;
8
+ server: ReturnType<typeof createServer>;
9
+ bearerTokenForRedaction: string;
10
+ bearerTokenDigest: Buffer;
11
+ createdAt: number;
12
+ lastActivityAt: number;
13
+ activeRequests: number;
14
+ credentialValidated: boolean;
15
+ disconnectedAt?: number;
16
+ };
17
+ export type StatelessRequestContext = {
18
+ transport: StreamableHTTPServerTransport;
19
+ server: ReturnType<typeof createServer>;
20
+ bearerToken: string;
21
+ closePromise?: Promise<void>;
22
+ };
23
+ type WithRequestAuth = <T>(sessionId: string | undefined, bearerToken: string, fn: () => Promise<T>) => Promise<T>;
24
+ export interface HttpSessionRegistry {
25
+ closingSessions: Map<string, Promise<void>>;
26
+ sessions: Map<string, SessionContext>;
27
+ activeStatelessRequests: Set<StatelessRequestContext>;
28
+ closingStatelessRequests: Set<Promise<void>>;
29
+ markSessionDisconnected(sessionId: string | undefined): void;
30
+ closeSession(sessionId: string): Promise<void>;
31
+ sweepExpiredSessions(now?: number): Promise<number>;
32
+ closeAllSessions(): Promise<void>;
33
+ closeStatelessRequest(request: StatelessRequestContext): Promise<void>;
34
+ trackSessionActivity<T>(session: SessionContext, fn: () => Promise<T>): Promise<T>;
35
+ getActiveSessionCount(): number;
36
+ }
37
+ export declare function createHttpSessionRegistry(config: HttpServerConfig, withRequestAuth: WithRequestAuth): HttpSessionRegistry;
38
+ export {};
39
+ //# sourceMappingURL=http-sessions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"http-sessions.d.ts","sourceRoot":"","sources":["../src/http-sessions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACxG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGzD,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,6BAA6B,CAAC;IACzC,MAAM,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;IAIxC,uBAAuB,EAAE,MAAM,CAAC;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,SAAS,EAAE,6BAA6B,CAAC;IACzC,MAAM,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAAC;AAEF,KAAK,eAAe,GAAG,CAAC,CAAC,EACvB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KACjB,OAAO,CAAC,CAAC,CAAC,CAAC;AAEhB,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5C,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACtC,uBAAuB,EAAE,GAAG,CAAC,uBAAuB,CAAC,CAAC;IACtD,wBAAwB,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7C,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IAC7D,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,oBAAoB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpD,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,qBAAqB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,oBAAoB,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACnF,qBAAqB,IAAI,MAAM,CAAC;CACjC;AAID,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,gBAAgB,EACxB,eAAe,EAAE,eAAe,GAC/B,mBAAmB,CAqJrB"}
@@ -0,0 +1,140 @@
1
+ import { clearSensitiveLogValues, formatErrorForLog } from "./logging.js";
2
+ const DISCONNECTED_SESSION_GRACE_MS = 30_000;
3
+ export function createHttpSessionRegistry(config, withRequestAuth) {
4
+ const sessions = new Map();
5
+ const closingSessions = new Map();
6
+ const activeStatelessRequests = new Set();
7
+ const closingStatelessRequests = new Set();
8
+ function markSessionDisconnected(sessionId) {
9
+ if (!sessionId)
10
+ return;
11
+ const session = sessions.get(sessionId);
12
+ if (!session)
13
+ return;
14
+ const disconnectedAt = Date.now();
15
+ session.lastActivityAt = disconnectedAt;
16
+ session.disconnectedAt = disconnectedAt;
17
+ }
18
+ async function closeSession(sessionId) {
19
+ const existingClose = closingSessions.get(sessionId);
20
+ if (existingClose) {
21
+ await existingClose;
22
+ return;
23
+ }
24
+ const session = sessions.get(sessionId);
25
+ if (!session)
26
+ return;
27
+ // Admission replacement relies on removal before the first await.
28
+ sessions.delete(sessionId);
29
+ const closePromise = withRequestAuth(session.sessionId, session.bearerTokenForRedaction, async () => {
30
+ try {
31
+ await session.server.close();
32
+ }
33
+ catch (error) {
34
+ // Format while the credential-scoped redaction context is still active.
35
+ console.error(`[mcp-http] session close failed (${formatErrorForLog(error)})`);
36
+ }
37
+ });
38
+ closingSessions.set(sessionId, closePromise);
39
+ try {
40
+ await closePromise;
41
+ }
42
+ finally {
43
+ closingSessions.delete(sessionId);
44
+ clearSensitiveLogValues(`http-session:${sessionId}`);
45
+ }
46
+ }
47
+ async function sweepExpiredSessions(now = Date.now()) {
48
+ const expiredIds = [...sessions.values()]
49
+ .filter((session) => {
50
+ if (now - session.createdAt >= config.sessionAbsoluteTtlMs) {
51
+ // The absolute lifetime applies even to active tool/SSE requests so
52
+ // keepalives cannot pin a validated session slot indefinitely.
53
+ return true;
54
+ }
55
+ if (session.activeRequests === 0 &&
56
+ session.disconnectedAt !== undefined &&
57
+ now - session.disconnectedAt >=
58
+ // A deliberately shorter configured idle TTL remains authoritative.
59
+ Math.min(DISCONNECTED_SESSION_GRACE_MS, config.sessionIdleTtlMs)) {
60
+ return true;
61
+ }
62
+ if (!session.credentialValidated) {
63
+ // The pending-session window is an absolute validation deadline.
64
+ // Close even an active SSE stream so it cannot hold an unvalidated
65
+ // slot indefinitely.
66
+ return now - session.createdAt >= config.unvalidatedSessionTtlMs;
67
+ }
68
+ return (session.activeRequests === 0 && now - session.lastActivityAt >= config.sessionIdleTtlMs);
69
+ })
70
+ .map((session) => session.sessionId);
71
+ await Promise.all(expiredIds.map((sessionId) => closeSession(sessionId)));
72
+ return expiredIds.length;
73
+ }
74
+ async function closeAllSessions() {
75
+ await Promise.all([...sessions.keys()].map((sessionId) => closeSession(sessionId)));
76
+ // A concurrent DELETE/sweep may have removed its registry entry while its
77
+ // asynchronous server.close() is still settling. Shutdown callers wait for
78
+ // that ownership cleanup too rather than observing an empty registry early.
79
+ await Promise.all([...closingSessions.values()]);
80
+ await Promise.all([...activeStatelessRequests].map((request) => closeStatelessRequest(request)));
81
+ await Promise.all([...closingStatelessRequests]);
82
+ }
83
+ async function closeStatelessRequest(request) {
84
+ if (request.closePromise) {
85
+ await request.closePromise;
86
+ return;
87
+ }
88
+ activeStatelessRequests.delete(request);
89
+ const bearerToken = request.bearerToken;
90
+ const closePromise = withRequestAuth(undefined, bearerToken, async () => {
91
+ try {
92
+ await request.transport.close();
93
+ }
94
+ catch (error) {
95
+ console.error(`[mcp-http] stateless transport close failed (${formatErrorForLog(error)})`);
96
+ }
97
+ try {
98
+ await request.server.close();
99
+ }
100
+ catch (error) {
101
+ console.error(`[mcp-http] stateless server close failed (${formatErrorForLog(error)})`);
102
+ }
103
+ }).finally(() => {
104
+ request.bearerToken = "";
105
+ closingStatelessRequests.delete(closePromise);
106
+ });
107
+ request.closePromise = closePromise;
108
+ closingStatelessRequests.add(closePromise);
109
+ await closePromise;
110
+ }
111
+ async function trackSessionActivity(session, fn) {
112
+ session.lastActivityAt = Date.now();
113
+ session.disconnectedAt = undefined;
114
+ session.activeRequests += 1;
115
+ try {
116
+ return await fn();
117
+ }
118
+ finally {
119
+ session.activeRequests -= 1;
120
+ session.lastActivityAt = Date.now();
121
+ }
122
+ }
123
+ function getActiveSessionCount() {
124
+ return sessions.size;
125
+ }
126
+ return {
127
+ sessions,
128
+ closingSessions,
129
+ activeStatelessRequests,
130
+ closingStatelessRequests,
131
+ markSessionDisconnected,
132
+ closeSession,
133
+ sweepExpiredSessions,
134
+ closeAllSessions,
135
+ closeStatelessRequest,
136
+ trackSessionActivity,
137
+ getActiveSessionCount,
138
+ };
139
+ }
140
+ //# sourceMappingURL=http-sessions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"http-sessions.js","sourceRoot":"","sources":["../src/http-sessions.ts"],"names":[],"mappings":"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"}
package/dist/http.d.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  #!/usr/bin/env node
2
- import { createReadStream } from "node:fs";
2
+ import { type createReadStream } from "node:fs";
3
3
  import type { Server } from "node:http";
4
4
  import express from "express";
5
5
  import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
@@ -1 +1 @@
1
- {"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":";AAKA,OAAO,EAAE,gBAAgB,EAA4B,MAAM,SAAS,CAAC;AAErE,OAAO,KAAK,EAAmB,MAAM,EAAkB,MAAM,WAAW,CAAC;AAWzE,OAAO,OAAO,MAAM,SAAS,CAAC;AAK9B,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAKnG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAa/C,OAAO,EAQL,KAAK,gBAAgB,EACtB,MAAM,kBAAkB,CAAC;AAK1B,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,kCAAkC,CAAC;AAuD1C,MAAM,WAAW,kBAAkB;IACjC,aAAa,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,WAAW,CAAC;IACrD,iBAAiB,CAAC,EAAE,CAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,KACtC,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;IACzC,gBAAgB,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,6BAA6B,CAAC;IAI1E,wBAAwB,CAAC,EAAE,wBAAwB,CAAC;IACpD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,kBAAkB;;4BAgUlD,OAAO,CAAC,IAAI,CAAC;;iCAsDd,MAAM;;sBAkqBX,OAAO,CAAC,IAAI,CAAC;kCAyKV,MAAM;2BApKV,MAAM;6BA7kB3B,OAAO,CAAC,OAAO,OACf,OAAO,CAAC,QAAQ,YACX,MAAM,KACf,OAAO,CAAC,IAAI,CAAC;4CAnLuC,OAAO,CAAC,MAAM,CAAC;EAs6BvE;AAMD,wBAAsB,WAAW,CAC/B,KAAK,SAAa,OAAO,CAAC,IAAI,CAQ7B,GACA,OAAO,CAAC,IAAI,CAAC,CAaf"}
1
+ {"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":";AAYA,OAAO,EAAE,KAAK,gBAAgB,EAA4B,MAAM,SAAS,CAAC;AAC1E,OAAO,KAAK,EAAmB,MAAM,EAAkB,MAAM,WAAW,CAAC;AAWzE,OAAO,OAAO,MAAM,SAAS,CAAC;AAK9B,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAgBnG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAa/C,OAAO,EAQL,KAAK,gBAAgB,EACtB,MAAM,kBAAkB,CAAC;AAQ1B,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,kCAAkC,CAAC;AA+B1C,MAAM,WAAW,kBAAkB;IACjC,aAAa,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,WAAW,CAAC;IACrD,iBAAiB,CAAC,EAAE,CAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,KACtC,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;IACzC,gBAAgB,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,6BAA6B,CAAC;IAI1E,wBAAwB,CAAC,EAAE,wBAAwB,CAAC;IACpD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AASD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,kBAAkB;;;;;;sBAs4BxD,OAAO,CAAC,IAAI,CAAC;kCA0JV,MAAM;2BArJV,MAAM;;;EA0JnC;AAMD,wBAAsB,WAAW,CAC/B,KAAK,SAAa,OAAO,CAAC,IAAI,CAQ7B,GACA,OAAO,CAAC,IAAI,CAAC,CAaf"}