@loop_ouroboros/mcp-hub-lite 1.0.2 → 1.1.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 (333) hide show
  1. package/CHANGELOG.md +32 -0
  2. package/dist/client/assets/{HomeView-7rMg9C6t.js → HomeView-Bu2joUvW.js} +1 -1
  3. package/dist/client/assets/ResourceDetailView-BvrhDCD1.js +1 -0
  4. package/dist/client/assets/ResourceDetailView-DUJZbegl.css +1 -0
  5. package/dist/client/assets/ResourcesView-Cc8RHtia.css +1 -0
  6. package/dist/client/assets/ResourcesView-LjqioF_s.js +1 -0
  7. package/dist/client/assets/ServerDashboard-BfLeFDGw.css +1 -0
  8. package/dist/client/assets/ServerDashboard-FhHJFvUi.js +1 -0
  9. package/dist/client/assets/ServerDetail-BKV-M4qT.js +2 -0
  10. package/dist/client/assets/ServerDetail-CtnNKJGx.css +1 -0
  11. package/dist/client/assets/{ServerListView-Bws09jNR.css → ServerListView-B-bPljsO.css} +1 -1
  12. package/dist/client/assets/ServerListView-BXgtDyt3.js +36 -0
  13. package/dist/client/assets/ServerStatusTags.vue_vue_type_script_setup_true_lang-D-ooYNdN.js +1 -0
  14. package/dist/client/assets/SettingsView-CMFG91Z4.js +1 -0
  15. package/dist/client/assets/SettingsView-GkBOKL0V.css +1 -0
  16. package/dist/client/assets/ToolCallDialog-Bf4Xe4gH.js +1 -0
  17. package/dist/client/assets/ToolsView-DFpha1z0.js +1 -0
  18. package/dist/client/assets/{_baseClone-5q1b0P3O.js → _baseClone-Bp9Rjwd7.js} +1 -1
  19. package/dist/client/assets/el-form-item-B4LbJ6OO.css +1 -0
  20. package/dist/client/assets/el-form-item-DdSUWYsl.js +12 -0
  21. package/dist/client/assets/el-input-99gMrutP.js +1 -0
  22. package/dist/client/assets/el-input-BH4BZKnG.css +1 -0
  23. package/dist/client/assets/{el-loading-H85n3BUC.js → el-loading-CIQ5pD5u.js} +1 -1
  24. package/dist/client/assets/el-overlay-BVM6msGX.js +1 -0
  25. package/dist/client/assets/{el-select-C0U_l4IZ.css → el-overlay-CBvdpA69.css} +1 -1
  26. package/dist/client/assets/{ResourceDetailView-BdOaL_-o.css → el-radio-group-B0bauIRR.css} +1 -1
  27. package/dist/client/assets/el-radio-group-DhXWy7ry.js +1 -0
  28. package/dist/client/assets/el-skeleton-item-BLY1jEuR.css +1 -0
  29. package/dist/client/assets/el-skeleton-item-DJz-Us12.js +1 -0
  30. package/dist/client/assets/el-switch-BBrS-_6y.css +1 -0
  31. package/dist/client/assets/el-switch-Bu8AQ5uM.js +1 -0
  32. package/dist/client/assets/el-tab-pane-BnGMaV56.js +1 -0
  33. package/dist/client/assets/el-table-column-BMWOaLS_.js +1 -0
  34. package/dist/client/assets/el-table-column-BdvRS9Y2.css +1 -0
  35. package/dist/client/assets/index-C2V-ZGji.js +1 -0
  36. package/dist/client/assets/{index-BsDWtoIl.css → index-DpH6ZSbs.css} +1 -1
  37. package/dist/client/assets/index-vhkqgpmN.js +2 -0
  38. package/dist/client/assets/{omit-DPsOVNIJ.js → omit-CqPQN3XP.js} +1 -1
  39. package/dist/client/assets/{raf-DY5mgbuB.js → raf-C2wXzaVU.js} +1 -1
  40. package/dist/client/assets/{vue-vendor-6ny5zj9i.js → vue-vendor-BLHLXXJK.js} +1 -1
  41. package/dist/client/index.html +3 -3
  42. package/dist/server/shared/models/resource.model.d.ts +2 -1
  43. package/dist/server/shared/models/resource.model.d.ts.map +1 -1
  44. package/dist/server/shared/models/server.model.d.ts +362 -5
  45. package/dist/server/shared/models/server.model.d.ts.map +1 -1
  46. package/dist/server/shared/models/server.model.js +220 -1
  47. package/dist/server/shared/models/session.model.d.ts +1 -57
  48. package/dist/server/shared/models/session.model.d.ts.map +1 -1
  49. package/dist/server/shared/models/session.model.js +1 -55
  50. package/dist/server/shared/models/tool.model.d.ts +4 -2
  51. package/dist/server/shared/models/tool.model.d.ts.map +1 -1
  52. package/dist/server/shared/types/session-context.types.d.ts +0 -2
  53. package/dist/server/shared/types/session-context.types.d.ts.map +1 -1
  54. package/dist/server/shared/types/websocket.types.d.ts +17 -10
  55. package/dist/server/shared/types/websocket.types.d.ts.map +1 -1
  56. package/dist/server/src/api/mcp/gateway.d.ts +1 -3
  57. package/dist/server/src/api/mcp/gateway.d.ts.map +1 -1
  58. package/dist/server/src/api/mcp/gateway.js +19 -50
  59. package/dist/server/src/api/mcp/session-context-extractor.d.ts.map +1 -1
  60. package/dist/server/src/api/mcp/session-context-extractor.js +5 -14
  61. package/dist/server/src/api/web/hub-tools.d.ts +2 -2
  62. package/dist/server/src/api/web/hub-tools.d.ts.map +1 -1
  63. package/dist/server/src/api/web/hub-tools.js +3 -54
  64. package/dist/server/src/api/web/mcp-status.d.ts +1 -1
  65. package/dist/server/src/api/web/mcp-status.d.ts.map +1 -1
  66. package/dist/server/src/api/web/mcp-status.js +71 -30
  67. package/dist/server/src/api/web/resources.d.ts.map +1 -1
  68. package/dist/server/src/api/web/resources.js +28 -22
  69. package/dist/server/src/api/web/search.d.ts +2 -16
  70. package/dist/server/src/api/web/search.d.ts.map +1 -1
  71. package/dist/server/src/api/web/search.js +24 -45
  72. package/dist/server/src/api/web/servers.d.ts +3 -3
  73. package/dist/server/src/api/web/servers.d.ts.map +1 -1
  74. package/dist/server/src/api/web/servers.js +70 -25
  75. package/dist/server/src/api/ws/ws-handler.d.ts.map +1 -1
  76. package/dist/server/src/api/ws/ws-handler.js +4 -2
  77. package/dist/server/src/app.d.ts.map +1 -1
  78. package/dist/server/src/app.js +0 -2
  79. package/dist/server/src/cli/commands/list.js +2 -2
  80. package/dist/server/src/cli/commands/status.d.ts.map +1 -1
  81. package/dist/server/src/cli/commands/status.js +41 -30
  82. package/dist/server/src/cli/index.d.ts.map +1 -1
  83. package/dist/server/src/cli/index.js +2 -1
  84. package/dist/server/src/cli/server.d.ts +11 -2
  85. package/dist/server/src/cli/server.d.ts.map +1 -1
  86. package/dist/server/src/config/config-change-logger.d.ts +22 -0
  87. package/dist/server/src/config/config-change-logger.d.ts.map +1 -1
  88. package/dist/server/src/config/config-change-logger.js +135 -11
  89. package/dist/server/src/config/config-loader.d.ts +6 -5
  90. package/dist/server/src/config/config-loader.d.ts.map +1 -1
  91. package/dist/server/src/config/config-loader.js +54 -16
  92. package/dist/server/src/config/config-manager.d.ts +51 -43
  93. package/dist/server/src/config/config-manager.d.ts.map +1 -1
  94. package/dist/server/src/config/config-manager.js +84 -66
  95. package/dist/server/src/config/config-migrator.d.ts +82 -0
  96. package/dist/server/src/config/config-migrator.d.ts.map +1 -0
  97. package/dist/server/src/config/config-migrator.js +348 -0
  98. package/dist/server/src/config/config-saver.d.ts +2 -0
  99. package/dist/server/src/config/config-saver.d.ts.map +1 -1
  100. package/dist/server/src/config/config-saver.js +8 -2
  101. package/dist/server/src/config/config.schema.d.ts +10 -104
  102. package/dist/server/src/config/config.schema.d.ts.map +1 -1
  103. package/dist/server/src/config/config.schema.js +15 -99
  104. package/dist/server/src/config/path-validator.d.ts +27 -0
  105. package/dist/server/src/config/path-validator.d.ts.map +1 -0
  106. package/dist/server/src/config/path-validator.js +53 -0
  107. package/dist/server/src/config/server-config-manager.d.ts +37 -31
  108. package/dist/server/src/config/server-config-manager.d.ts.map +1 -1
  109. package/dist/server/src/config/server-config-manager.js +222 -66
  110. package/dist/server/src/config/type-converter.d.ts.map +1 -1
  111. package/dist/server/src/config/type-converter.js +3 -2
  112. package/dist/server/src/models/event.model.d.ts +17 -10
  113. package/dist/server/src/models/event.model.d.ts.map +1 -1
  114. package/dist/server/src/models/server.model.d.ts +17 -3
  115. package/dist/server/src/models/server.model.d.ts.map +1 -1
  116. package/dist/server/src/models/server.model.js +2 -1
  117. package/dist/server/src/models/system-tools.constants.d.ts +10 -27
  118. package/dist/server/src/models/system-tools.constants.d.ts.map +1 -1
  119. package/dist/server/src/models/system-tools.constants.js +4 -8
  120. package/dist/server/src/pid/manager.d.ts.map +1 -1
  121. package/dist/server/src/pid/manager.js +2 -1
  122. package/dist/server/src/server/dev-server.js +34 -20
  123. package/dist/server/src/server/runner.d.ts.map +1 -1
  124. package/dist/server/src/server/runner.js +41 -26
  125. package/dist/server/src/services/connection/connection-manager.d.ts +85 -103
  126. package/dist/server/src/services/connection/connection-manager.d.ts.map +1 -1
  127. package/dist/server/src/services/connection/connection-manager.js +286 -241
  128. package/dist/server/src/services/connection/tool-cache.d.ts +27 -25
  129. package/dist/server/src/services/connection/tool-cache.d.ts.map +1 -1
  130. package/dist/server/src/services/connection/tool-cache.js +50 -55
  131. package/dist/server/src/services/gateway/gateway.service.d.ts +2 -0
  132. package/dist/server/src/services/gateway/gateway.service.d.ts.map +1 -1
  133. package/dist/server/src/services/gateway/gateway.service.js +15 -19
  134. package/dist/server/src/services/gateway/global-transport.d.ts +10 -0
  135. package/dist/server/src/services/gateway/global-transport.d.ts.map +1 -0
  136. package/dist/server/src/services/gateway/global-transport.js +42 -0
  137. package/dist/server/src/services/gateway/request-handlers/call-tool-handler.d.ts.map +1 -1
  138. package/dist/server/src/services/gateway/request-handlers/call-tool-handler.js +67 -65
  139. package/dist/server/src/services/gateway/request-handlers/index.d.ts +1 -1
  140. package/dist/server/src/services/gateway/request-handlers/index.d.ts.map +1 -1
  141. package/dist/server/src/services/gateway/request-handlers/index.js +1 -1
  142. package/dist/server/src/services/gateway/request-handlers/initialize-handler.d.ts +1 -4
  143. package/dist/server/src/services/gateway/request-handlers/initialize-handler.d.ts.map +1 -1
  144. package/dist/server/src/services/gateway/request-handlers/initialize-handler.js +10 -81
  145. package/dist/server/src/services/gateway/request-handlers/initialize.constants.d.ts +35 -0
  146. package/dist/server/src/services/gateway/request-handlers/initialize.constants.d.ts.map +1 -0
  147. package/dist/server/src/services/gateway/request-handlers/initialize.constants.js +44 -0
  148. package/dist/server/src/services/gateway/request-handlers/resources-handler.d.ts.map +1 -1
  149. package/dist/server/src/services/gateway/request-handlers/resources-handler.js +5 -4
  150. package/dist/server/src/services/gateway/request-handlers/system-tools-handler.d.ts.map +1 -1
  151. package/dist/server/src/services/gateway/request-handlers/system-tools-handler.js +32 -77
  152. package/dist/server/src/services/gateway/request-handlers/tools-handler.d.ts.map +1 -1
  153. package/dist/server/src/services/gateway/request-handlers/tools-handler.js +4 -3
  154. package/dist/server/src/services/gateway/tool-list-generator.d.ts.map +1 -1
  155. package/dist/server/src/services/gateway/tool-list-generator.js +37 -16
  156. package/dist/server/src/services/gateway/types.d.ts +2 -1
  157. package/dist/server/src/services/gateway/types.d.ts.map +1 -1
  158. package/dist/server/src/services/hub-manager.service.d.ts +32 -238
  159. package/dist/server/src/services/hub-manager.service.d.ts.map +1 -1
  160. package/dist/server/src/services/hub-manager.service.js +89 -267
  161. package/dist/server/src/services/hub-tools/index.d.ts +1 -3
  162. package/dist/server/src/services/hub-tools/index.d.ts.map +1 -1
  163. package/dist/server/src/services/hub-tools/index.js +1 -2
  164. package/dist/server/src/services/hub-tools/instance-matcher.d.ts +62 -0
  165. package/dist/server/src/services/hub-tools/instance-matcher.d.ts.map +1 -0
  166. package/dist/server/src/services/hub-tools/instance-matcher.js +132 -0
  167. package/dist/server/src/services/hub-tools/instance-selector.d.ts +29 -0
  168. package/dist/server/src/services/hub-tools/instance-selector.d.ts.map +1 -0
  169. package/dist/server/src/services/hub-tools/instance-selector.js +103 -0
  170. package/dist/server/src/services/hub-tools/resource-generator.d.ts +24 -1
  171. package/dist/server/src/services/hub-tools/resource-generator.d.ts.map +1 -1
  172. package/dist/server/src/services/hub-tools/resource-generator.js +259 -39
  173. package/dist/server/src/services/hub-tools/server-selector.d.ts +26 -13
  174. package/dist/server/src/services/hub-tools/server-selector.d.ts.map +1 -1
  175. package/dist/server/src/services/hub-tools/server-selector.js +44 -37
  176. package/dist/server/src/services/hub-tools/system-tool-definitions.d.ts +1 -4
  177. package/dist/server/src/services/hub-tools/system-tool-definitions.d.ts.map +1 -1
  178. package/dist/server/src/services/hub-tools/system-tool-definitions.js +17 -80
  179. package/dist/server/src/services/hub-tools/tool-search.d.ts +7 -7
  180. package/dist/server/src/services/hub-tools/tool-search.d.ts.map +1 -1
  181. package/dist/server/src/services/hub-tools/tool-search.js +10 -4
  182. package/dist/server/src/services/hub-tools/types.d.ts +2 -2
  183. package/dist/server/src/services/hub-tools/types.d.ts.map +1 -1
  184. package/dist/server/src/services/hub-tools.service.d.ts +43 -72
  185. package/dist/server/src/services/hub-tools.service.d.ts.map +1 -1
  186. package/dist/server/src/services/hub-tools.service.js +185 -110
  187. package/dist/server/src/services/search/search-core.service.d.ts +5 -5
  188. package/dist/server/src/services/search/search-core.service.js +11 -11
  189. package/dist/server/src/services/session/session-manager.d.ts +12 -256
  190. package/dist/server/src/services/session/session-manager.d.ts.map +1 -1
  191. package/dist/server/src/services/session/session-manager.js +23 -585
  192. package/dist/server/src/services/session-tracker.service.d.ts +2 -10
  193. package/dist/server/src/services/session-tracker.service.d.ts.map +1 -1
  194. package/dist/server/src/services/session-tracker.service.js +2 -53
  195. package/dist/server/src/services/system-tool-handler.d.ts.map +1 -1
  196. package/dist/server/src/services/system-tool-handler.js +7 -17
  197. package/dist/server/src/utils/composite-key.d.ts +29 -0
  198. package/dist/server/src/utils/composite-key.d.ts.map +1 -0
  199. package/dist/server/src/utils/composite-key.js +39 -0
  200. package/dist/server/src/utils/error-handler.d.ts.map +1 -1
  201. package/dist/server/src/utils/error-handler.js +3 -2
  202. package/dist/server/src/utils/index.d.ts +2 -0
  203. package/dist/server/src/utils/index.d.ts.map +1 -1
  204. package/dist/server/src/utils/index.js +2 -0
  205. package/dist/server/src/utils/instance-id.d.ts +22 -0
  206. package/dist/server/src/utils/instance-id.d.ts.map +1 -0
  207. package/dist/server/src/utils/instance-id.js +59 -0
  208. package/dist/server/src/utils/json-utils.d.ts +4 -4
  209. package/dist/server/src/utils/json-utils.d.ts.map +1 -1
  210. package/dist/server/src/utils/json-utils.js +4 -4
  211. package/dist/server/src/utils/logger/dev-logger.d.ts +2 -1
  212. package/dist/server/src/utils/logger/dev-logger.d.ts.map +1 -1
  213. package/dist/server/src/utils/logger/log-formatter.d.ts.map +1 -1
  214. package/dist/server/src/utils/logger/log-formatter.js +82 -5
  215. package/dist/server/src/utils/logger/log-modules.d.ts +15 -9
  216. package/dist/server/src/utils/logger/log-modules.d.ts.map +1 -1
  217. package/dist/server/src/utils/logger/log-modules.js +8 -6
  218. package/dist/server/src/utils/parameter-validator.d.ts +10 -0
  219. package/dist/server/src/utils/parameter-validator.d.ts.map +1 -0
  220. package/dist/server/src/utils/parameter-validator.js +53 -0
  221. package/dist/server/src/utils/process-tree.d.ts +49 -0
  222. package/dist/server/src/utils/process-tree.d.ts.map +1 -0
  223. package/dist/server/src/utils/process-tree.js +285 -0
  224. package/dist/server/src/utils/request-context.d.ts +0 -18
  225. package/dist/server/src/utils/request-context.d.ts.map +1 -1
  226. package/dist/server/src/utils/request-context.js +0 -20
  227. package/dist/server/src/utils/sort-utils.d.ts +40 -0
  228. package/dist/server/src/utils/sort-utils.d.ts.map +1 -0
  229. package/dist/server/src/utils/sort-utils.js +131 -0
  230. package/dist/server/src/utils/transports/sse-transport.d.ts +16 -1
  231. package/dist/server/src/utils/transports/sse-transport.d.ts.map +1 -1
  232. package/dist/server/src/utils/transports/sse-transport.js +55 -9
  233. package/dist/server/src/utils/transports/stdio-transport.d.ts +24 -53
  234. package/dist/server/src/utils/transports/stdio-transport.d.ts.map +1 -1
  235. package/dist/server/src/utils/transports/stdio-transport.js +66 -247
  236. package/dist/server/src/utils/transports/streamable-http-transport.d.ts +24 -1
  237. package/dist/server/src/utils/transports/streamable-http-transport.d.ts.map +1 -1
  238. package/dist/server/src/utils/transports/streamable-http-transport.js +68 -8
  239. package/dist/server/src/utils/transports/transport-factory.d.ts +9 -4
  240. package/dist/server/src/utils/transports/transport-factory.d.ts.map +1 -1
  241. package/dist/server/src/utils/transports/transport-factory.js +31 -11
  242. package/dist/server/src/utils/transports/transport.interface.d.ts +6 -0
  243. package/dist/server/src/utils/transports/transport.interface.d.ts.map +1 -1
  244. package/dist/server/src/utils/version.d.ts +11 -0
  245. package/dist/server/src/utils/version.d.ts.map +1 -0
  246. package/dist/server/src/utils/version.js +57 -0
  247. package/dist/server/tests/contract/mcp-protocol/initialize.test.js +24 -24
  248. package/dist/server/tests/contract/mcp-protocol/tools-call.test.js +49 -45
  249. package/dist/server/tests/contract/mcp-protocol/tools-list.test.js +35 -36
  250. package/dist/server/tests/evaluation/evaluation.test.js +10 -9
  251. package/dist/server/tests/integration/api/gateway.test.js +2 -2
  252. package/dist/server/tests/integration/gateway/fault-tolerance.test.js +65 -25
  253. package/dist/server/tests/integration/gateway/mcp-connection.test.js +53 -61
  254. package/dist/server/tests/server.test.js +27 -16
  255. package/dist/server/tests/temp/temp-run-docling.d.ts +2 -0
  256. package/dist/server/tests/temp/temp-run-docling.d.ts.map +1 -0
  257. package/dist/server/tests/temp/temp-run-docling.js +53 -0
  258. package/dist/server/tests/types/test-helpers.d.ts +1 -2
  259. package/dist/server/tests/types/test-helpers.d.ts.map +1 -1
  260. package/dist/server/tests/unit/config/config-loader-automatic-migration.test.d.ts +2 -0
  261. package/dist/server/tests/unit/config/config-loader-automatic-migration.test.d.ts.map +1 -0
  262. package/dist/server/tests/unit/config/config-loader-automatic-migration.test.js +199 -0
  263. package/dist/server/tests/unit/config/config-migrator.test.d.ts +2 -0
  264. package/dist/server/tests/unit/config/config-migrator.test.d.ts.map +1 -0
  265. package/dist/server/tests/unit/config/config-migrator.test.js +316 -0
  266. package/dist/server/tests/unit/config/config-saver.test.d.ts +2 -0
  267. package/dist/server/tests/unit/config/config-saver.test.d.ts.map +1 -0
  268. package/dist/server/tests/unit/config/config-saver.test.js +200 -0
  269. package/dist/server/tests/unit/config/config.schema.test.d.ts +2 -0
  270. package/dist/server/tests/unit/config/config.schema.test.d.ts.map +1 -0
  271. package/dist/server/tests/unit/config/config.schema.test.js +347 -0
  272. package/dist/server/tests/unit/server/runner.test.js +86 -62
  273. package/dist/server/tests/unit/services/connection/connection-manager.test.d.ts +2 -0
  274. package/dist/server/tests/unit/services/connection/connection-manager.test.d.ts.map +1 -0
  275. package/dist/server/tests/unit/services/connection/connection-manager.test.js +112 -0
  276. package/dist/server/tests/unit/services/hub-manager-service.test.js +112 -46
  277. package/dist/server/tests/unit/services/hub-manager.test.js +25 -15
  278. package/dist/server/tests/unit/services/hub-tools/instance-selector.test.d.ts +2 -0
  279. package/dist/server/tests/unit/services/hub-tools/instance-selector.test.d.ts.map +1 -0
  280. package/dist/server/tests/unit/services/hub-tools/instance-selector.test.js +195 -0
  281. package/dist/server/tests/unit/services/hub-tools/server-selector.test.d.ts +2 -0
  282. package/dist/server/tests/unit/services/hub-tools/server-selector.test.d.ts.map +1 -0
  283. package/dist/server/tests/unit/services/hub-tools/server-selector.test.js +190 -0
  284. package/dist/server/tests/unit/services/hub-tools.service.test.js +560 -320
  285. package/dist/server/tests/unit/services/instance-matcher.test.d.ts +2 -0
  286. package/dist/server/tests/unit/services/instance-matcher.test.d.ts.map +1 -0
  287. package/dist/server/tests/unit/services/instance-matcher.test.js +256 -0
  288. package/dist/server/tests/unit/services/session-manager.test.js +26 -436
  289. package/dist/server/tests/unit/utils/config.test.js +88 -186
  290. package/dist/server/tests/unit/utils/json-utils.test.js +18 -18
  291. package/dist/server/tests/unit/utils/logger-formatter.test.d.ts +2 -0
  292. package/dist/server/tests/unit/utils/logger-formatter.test.d.ts.map +1 -0
  293. package/dist/server/tests/unit/utils/logger-formatter.test.js +66 -0
  294. package/dist/server/tests/unit/utils/parameter-validator.test.d.ts +2 -0
  295. package/dist/server/tests/unit/utils/parameter-validator.test.d.ts.map +1 -0
  296. package/dist/server/tests/unit/utils/parameter-validator.test.js +63 -0
  297. package/dist/server/tests/unit/utils/process-tree.test.d.ts +2 -0
  298. package/dist/server/tests/unit/utils/process-tree.test.d.ts.map +1 -0
  299. package/dist/server/tests/unit/utils/process-tree.test.js +129 -0
  300. package/dist/server/tests/unit/utils/request-context.test.js +5 -24
  301. package/dist/server/tests/unit/utils/sort-utils.test.d.ts +2 -0
  302. package/dist/server/tests/unit/utils/sort-utils.test.d.ts.map +1 -0
  303. package/dist/server/tests/unit/utils/sort-utils.test.js +220 -0
  304. package/dist/server/tests/unit/utils/transport-factory.test.d.ts +2 -0
  305. package/dist/server/tests/unit/utils/transport-factory.test.d.ts.map +1 -0
  306. package/dist/server/tests/unit/utils/transport-factory.test.js +55 -0
  307. package/package.json +1 -1
  308. package/dist/client/assets/ResourceDetailView-Bf-1ffbk.js +0 -1
  309. package/dist/client/assets/ResourcesView-CjMklkyv.css +0 -1
  310. package/dist/client/assets/ResourcesView-g5x4xCPh.js +0 -1
  311. package/dist/client/assets/ServerDashboard-Chpne8Q0.css +0 -1
  312. package/dist/client/assets/ServerDashboard-G8Wmp4hF.js +0 -2
  313. package/dist/client/assets/ServerListView-dV2XrPjo.js +0 -32
  314. package/dist/client/assets/ServerStatusTags.vue_vue_type_script_setup_true_lang-BHiTFM7-.js +0 -1
  315. package/dist/client/assets/SessionsView-Ckd38lj1.js +0 -1
  316. package/dist/client/assets/SettingsView-BJUdepEQ.js +0 -1
  317. package/dist/client/assets/ToolCallDialog-C_bTCpHC.js +0 -1
  318. package/dist/client/assets/ToolsView-0c2eputu.js +0 -1
  319. package/dist/client/assets/el-form-item-BVMLpmVC.css +0 -1
  320. package/dist/client/assets/el-form-item-ClFnj49k.js +0 -12
  321. package/dist/client/assets/el-input-CDnuSKVZ.js +0 -1
  322. package/dist/client/assets/el-input-CmuHb8HS.css +0 -1
  323. package/dist/client/assets/el-overlay-B2ZKM6Up.css +0 -1
  324. package/dist/client/assets/el-overlay-CzMkXyYy.js +0 -1
  325. package/dist/client/assets/el-select-DvjGddk_.js +0 -1
  326. package/dist/client/assets/el-tab-pane-C_DQMcwe.js +0 -1
  327. package/dist/client/assets/el-table-column-CASRIbZM.js +0 -1
  328. package/dist/client/assets/el-table-column-T_mV9jNw.css +0 -1
  329. package/dist/client/assets/el-tag-DjxZVOpb.css +0 -1
  330. package/dist/client/assets/el-tag-npbwux4f.js +0 -1
  331. package/dist/client/assets/index-CCnAxNF8.js +0 -2
  332. package/dist/client/assets/index-d1DZeSfz.js +0 -1
  333. package/dist/client/assets/vnode-CHomNjgN.js +0 -1
@@ -3,35 +3,19 @@ import { gateway } from '../gateway.service.js';
3
3
  import { logger, LOG_MODULES, formatMcpMessageForLogging, logNotificationMessage } from '../../utils/logger.js';
4
4
  import { configManager } from '../../config/config-manager.js';
5
5
  import { formatDuration } from '../../utils/format-utils.js';
6
- import { SessionStateSchema, createEmptySessionStore } from '../../../shared/models/session.model.js';
7
- import { sessionTrackerService } from '../session-tracker.service.js';
8
6
  import { getSessionDebugSetting, getMcpCommDebugSetting } from '../../utils/json-utils.js';
9
- import * as fs from 'fs';
10
- import path from 'path';
11
- import os from 'os';
12
7
  /**
13
- * Enhanced MCP Session Manager with comprehensive persistence and lifecycle management.
8
+ * Lightweight MCP Session Manager with in-memory session management only.
14
9
  *
15
- * This service manages MCP sessions with full state persistence, automatic cleanup,
16
- * and graceful shutdown handling. It provides session isolation through unique
10
+ * This service manages MCP sessions with basic in-memory storage and automatic
11
+ * cleanup of stale sessions. It provides session isolation through unique
17
12
  * server and transport instances per session while maintaining shared resources
18
13
  * for efficiency.
19
14
  *
20
- * Key features include:
21
- * - Session state persistence to disk with individual session files and index
22
- * - Dirty tracking with 5-second batch flushing to minimize I/O operations
15
+ * Key features:
16
+ * - In-memory session storage only (no persistence)
23
17
  * - Automatic cleanup of stale sessions based on configurable timeout (default 30 minutes)
24
- * - Graceful shutdown handling with SIGTERM/SIGINT signal capture
25
- * - Client metadata integration from client tracker service
26
- * - Environment variable controlled debugging (SESSION_DEBUG)
27
- *
28
- * Session storage structure:
29
- * ```
30
- * ~/.mcp-hub-lite/
31
- * └── sessions/
32
- * ├── index.json # Session index file
33
- * └── {sessionId}.json # Individual session state files
34
- * ```
18
+ * - Session ID generation for internal use
35
19
  *
36
20
  * @example
37
21
  * ```typescript
@@ -40,15 +24,10 @@ import os from 'os';
40
24
  * // Use session.server and session.transport for MCP communication
41
25
  * ```
42
26
  *
43
- * @since 1.0.0
27
+ * @since 2.0.0
44
28
  */
45
29
  export class McpSessionManager {
46
30
  sessions = new Map();
47
- sessionStates = new Map();
48
- dirtySessions = new Set();
49
- sessionsPath;
50
- flushTimeout = null; // Replace with one-time delay
51
- isInitialized = false;
52
31
  get SESSION_TIMEOUT() {
53
32
  return configManager.getConfig().security.sessionTimeout;
54
33
  }
@@ -56,430 +35,15 @@ export class McpSessionManager {
56
35
  return configManager.getConfig().security.sessionFlushInterval;
57
36
  }
58
37
  constructor() {
59
- // Initialize sessions directory path
60
- const configPath = process.env.MCP_HUB_CONFIG_PATH ||
61
- path.join(os.homedir(), '.mcp-hub-lite', 'config', '.mcp-hub.json');
62
- const mcpHubDir = path.dirname(path.dirname(configPath)); // Get ~/.mcp-hub-lite directory
63
- this.sessionsPath = path.join(mcpHubDir, 'sessions');
64
- logger.info(`Using sessions directory: ${this.sessionsPath}`, LOG_MODULES.SESSION_MANAGER);
65
38
  // Start cleanup interval
66
39
  setInterval(() => this.cleanup(), this.CLEANUP_INTERVAL);
67
- // Register graceful shutdown handler
68
- this.registerShutdownHandler();
69
- // Initialize by restoring sessions
70
- this.restoreSessions().catch((error) => {
71
- logger.error('Failed to restore sessions during initialization:', error, LOG_MODULES.SESSION_MANAGER);
72
- });
73
- }
74
- /**
75
- * Registers process shutdown handlers for graceful session cleanup.
76
- *
77
- * This method sets up event listeners for SIGTERM and SIGINT signals to ensure
78
- * that all dirty sessions are flushed to disk before the process terminates.
79
- * This prevents data loss during unexpected shutdowns or service restarts.
80
- *
81
- * The shutdown handler performs a final flush of all dirty sessions and
82
- * clears any pending flush timeouts to ensure clean termination.
83
- *
84
- * @returns {void}
85
- *
86
- * @example
87
- * ```typescript
88
- * // Called automatically in constructor
89
- * sessionManager.registerShutdownHandler();
90
- * ```
91
- */
92
- registerShutdownHandler() {
93
- const gracefulShutdown = async () => {
94
- logger.info('Shutting down, flushing dirty sessions...', LOG_MODULES.SESSION_MANAGER);
95
- try {
96
- await this.flushDirtySessions();
97
- }
98
- catch (error) {
99
- logger.error('Error during shutdown flush:', error, LOG_MODULES.SESSION_MANAGER);
100
- }
101
- if (this.flushTimeout) {
102
- clearTimeout(this.flushTimeout);
103
- }
104
- };
105
- process.on('SIGTERM', gracefulShutdown);
106
- process.on('SIGINT', gracefulShutdown);
107
- }
108
- /**
109
- * Marks a session as dirty, indicating it needs to be persisted to disk.
110
- *
111
- * This method adds the session ID to the dirty sessions set and initiates
112
- * a delayed batch flush operation with a 5-second timeout. This optimization
113
- * prevents excessive I/O operations by batching multiple session updates
114
- * that occur in quick succession.
115
- *
116
- * When the SESSION_DEBUG environment variable is set, detailed logging
117
- * is enabled for debugging session persistence behavior.
118
- *
119
- * @param {string} sessionId - Unique identifier of the session to mark as dirty
120
- * @returns {void}
121
- *
122
- * @example
123
- * ```typescript
124
- * sessionManager.markAsDirty('my-session-id');
125
- * // Session will be flushed to disk within 5 seconds
126
- * ```
127
- */
128
- markAsDirty(sessionId) {
129
- this.dirtySessions.add(sessionId);
130
- if (getSessionDebugSetting()) {
131
- logger.debug(`Session marked as dirty: ${sessionId}`, LOG_MODULES.SESSION_MANAGER);
132
- }
133
- // Set one-time delayed flush to avoid frequent writes (configurable delay, batch processing)
134
- if (!this.flushTimeout) {
135
- const flushInterval = configManager.getConfig().security.sessionFlushInterval || 5000;
136
- this.flushTimeout = setTimeout(() => {
137
- this.flushDirtySessions();
138
- this.flushTimeout = null;
139
- }, flushInterval);
140
- }
141
- }
142
- /**
143
- * Loads the complete session store from disk, including all individual session files.
144
- *
145
- * This method reads the sessions index file and loads each individual session state
146
- * file, validating each session state against the SessionStateSchema. Invalid
147
- * session states are skipped with warning logs, ensuring robust recovery from
148
- * corrupted data.
149
- *
150
- * The method creates the sessions directory and index file if they don't exist,
151
- * providing a clean initialization path for first-time usage.
152
- *
153
- * @returns {Promise<SessionStore>} Complete session store with all valid sessions
154
- * @throws {Error} If critical I/O operations fail (non-recoverable errors)
155
- *
156
- * @example
157
- * ```typescript
158
- * const store = await sessionManager.loadSessionStore();
159
- * console.log(`Loaded ${Object.keys(store.sessions).length} sessions`);
160
- * ```
161
- */
162
- async loadSessionStore() {
163
- try {
164
- if (!fs.existsSync(this.sessionsPath)) {
165
- if (getSessionDebugSetting()) {
166
- logger.debug('Sessions directory not found, creating new one', LOG_MODULES.SESSION_MANAGER);
167
- }
168
- fs.mkdirSync(this.sessionsPath, { recursive: true });
169
- return createEmptySessionStore();
170
- }
171
- const indexPath = path.join(this.sessionsPath, 'index.json');
172
- if (!fs.existsSync(indexPath)) {
173
- if (getSessionDebugSetting()) {
174
- logger.debug('Sessions index file not found, creating new one', LOG_MODULES.SESSION_MANAGER);
175
- }
176
- return createEmptySessionStore();
177
- }
178
- const indexContent = fs.readFileSync(indexPath, 'utf-8');
179
- const index = JSON.parse(indexContent);
180
- if (!index.sessions || !Array.isArray(index.sessions)) {
181
- logger.error('Invalid sessions index file, creating new one', LOG_MODULES.SESSION_MANAGER);
182
- return createEmptySessionStore();
183
- }
184
- const store = createEmptySessionStore();
185
- for (const sessionId of index.sessions) {
186
- const sessionPath = path.join(this.sessionsPath, `${sessionId}.json`);
187
- if (fs.existsSync(sessionPath)) {
188
- try {
189
- const sessionContent = fs.readFileSync(sessionPath, 'utf-8');
190
- const sessionState = JSON.parse(sessionContent);
191
- const validated = SessionStateSchema.parse(sessionState);
192
- store.sessions[sessionId] = validated;
193
- }
194
- catch (error) {
195
- logger.warn(`Failed to load session ${sessionId}:`, error, LOG_MODULES.SESSION_MANAGER);
196
- }
197
- }
198
- }
199
- if (getSessionDebugSetting()) {
200
- logger.debug(`Loaded ${Object.keys(store.sessions).length} sessions from store`, LOG_MODULES.SESSION_MANAGER);
201
- }
202
- return store;
203
- }
204
- catch (error) {
205
- logger.error('Failed to load sessions store:', error, LOG_MODULES.SESSION_MANAGER);
206
- return createEmptySessionStore();
207
- }
208
- }
209
- /**
210
- * Saves the complete session store to disk, writing individual session files and index.
211
- *
212
- * This method persists all session states by writing individual JSON files for each
213
- * session and updating the sessions index file. The operation is atomic at the
214
- * file level, ensuring data integrity even if the process is interrupted.
215
- *
216
- * @param {SessionStore} store - Complete session store to persist
217
- * @returns {Promise<void>} Resolves when all files are successfully written
218
- * @throws {Error} If any file write operations fail
219
- *
220
- * @example
221
- * ```typescript
222
- * await sessionManager.saveSessionStore(mySessionStore);
223
- * console.log('Session store saved successfully');
224
- * ```
225
- */
226
- async saveSessionStore(store) {
227
- try {
228
- if (!fs.existsSync(this.sessionsPath)) {
229
- fs.mkdirSync(this.sessionsPath, { recursive: true });
230
- }
231
- // Save individual session files
232
- for (const [sessionId, state] of Object.entries(store.sessions)) {
233
- const sessionPath = path.join(this.sessionsPath, `${sessionId}.json`);
234
- fs.writeFileSync(sessionPath, JSON.stringify(state, null, 2));
235
- }
236
- // Save index file
237
- const indexPath = path.join(this.sessionsPath, 'index.json');
238
- fs.writeFileSync(indexPath, JSON.stringify({
239
- sessions: Object.keys(store.sessions)
240
- }, null, 2));
241
- }
242
- catch (error) {
243
- logger.error('Failed to save sessions store:', error, LOG_MODULES.SESSION_MANAGER);
244
- throw error;
245
- }
246
- }
247
- /**
248
- * Restores all sessions from disk during service startup.
249
- *
250
- * This method is called automatically during initialization to recover session states
251
- * from persistent storage. It loads the session store, validates each session state,
252
- * and populates the in-memory session state cache. Invalid sessions are skipped
253
- * with warning logs to ensure robust startup even with corrupted data.
254
- *
255
- * The method ensures idempotent execution by checking the initialization flag,
256
- * preventing multiple restoration attempts.
257
- *
258
- * @returns {Promise<void>} Resolves when all valid sessions are restored
259
- *
260
- * @example
261
- * ```typescript
262
- * await sessionManager.restoreSessions();
263
- * console.log('Sessions restored from disk');
264
- * ```
265
- */
266
- async restoreSessions() {
267
- if (this.isInitialized) {
268
- return;
269
- }
270
- try {
271
- logger.info('Restoring sessions from disk...', LOG_MODULES.SESSION_MANAGER);
272
- const store = await this.loadSessionStore();
273
- let restoredCount = 0;
274
- let expiredCount = 0;
275
- const now = Date.now();
276
- for (const [sessionId, state] of Object.entries(store.sessions)) {
277
- try {
278
- // Validate individual session state
279
- const validatedState = SessionStateSchema.parse(state);
280
- // Check if session has expired
281
- if (now - validatedState.lastAccessedAt > this.SESSION_TIMEOUT) {
282
- expiredCount++;
283
- if (getSessionDebugSetting()) {
284
- logger.debug(`Expired session: ${sessionId} (last accessed ${formatDuration(now - validatedState.lastAccessedAt)} ago)`, LOG_MODULES.SESSION_MANAGER);
285
- }
286
- }
287
- else {
288
- restoredCount++;
289
- }
290
- // Always restore to memory - cleanup() will handle deletion
291
- this.sessionStates.set(sessionId, validatedState);
292
- if (getSessionDebugSetting()) {
293
- logger.debug(`Restored session state: ${sessionId}`, LOG_MODULES.SESSION_MANAGER);
294
- }
295
- }
296
- catch (error) {
297
- logger.warn(`Skipping invalid session state for ${sessionId}:`, error, LOG_MODULES.SESSION_MANAGER);
298
- }
299
- }
300
- this.isInitialized = true;
301
- logger.info(`Successfully restored ${restoredCount} valid, ${expiredCount} expired session(s)`, LOG_MODULES.SESSION_MANAGER);
302
- // Immediately run cleanup on startup to clean up any expired sessions
303
- this.cleanup();
304
- }
305
- catch (error) {
306
- logger.error('Failed to restore sessions:', error, LOG_MODULES.SESSION_MANAGER);
307
- // Continue with empty state rather than failing
308
- this.isInitialized = true;
309
- }
310
- }
311
- /**
312
- * Flushes all dirty sessions to disk in a single batch operation.
313
- *
314
- * This method collects all sessions marked as dirty, loads the current session store,
315
- * updates it with the dirty sessions, and saves the complete store back to disk.
316
- * This batch approach minimizes I/O operations and ensures data consistency.
317
- *
318
- * The method includes comprehensive error handling to prevent partial writes and
319
- * maintains detailed logging for debugging and monitoring purposes.
320
- *
321
- * @returns {Promise<void>} Resolves when all dirty sessions are successfully flushed
322
- *
323
- * @example
324
- * ```typescript
325
- * await sessionManager.flushDirtySessions();
326
- * console.log('All dirty sessions flushed to disk');
327
- * ```
328
- */
329
- async flushDirtySessions() {
330
- if (this.dirtySessions.size === 0) {
331
- return;
332
- }
333
- try {
334
- logger.info(`Flushing ${this.dirtySessions.size} dirty session(s) to disk`, LOG_MODULES.SESSION_MANAGER);
335
- // Load current store
336
- const currentStore = await this.loadSessionStore();
337
- const newStore = {
338
- ...currentStore,
339
- sessions: { ...currentStore.sessions }
340
- };
341
- // Process all dirty sessions
342
- for (const sessionId of this.dirtySessions) {
343
- const sessionState = this.sessionStates.get(sessionId);
344
- if (sessionState) {
345
- // Session exists - update it
346
- newStore.sessions[sessionId] = sessionState;
347
- }
348
- else {
349
- // Session does not exist - remove it
350
- delete newStore.sessions[sessionId];
351
- // Also remove the individual session file
352
- const sessionPath = path.join(this.sessionsPath, `${sessionId}.json`);
353
- if (fs.existsSync(sessionPath)) {
354
- fs.unlinkSync(sessionPath);
355
- logger.debug(`Deleted session file: ${sessionId}.json`, LOG_MODULES.SESSION_MANAGER);
356
- }
357
- }
358
- }
359
- await this.saveSessionStore(newStore);
360
- const flushedCount = this.dirtySessions.size;
361
- this.dirtySessions.clear();
362
- logger.info(`Successfully flushed ${flushedCount} session(s)`, LOG_MODULES.SESSION_MANAGER);
363
- }
364
- catch (error) {
365
- logger.error('Failed to flush dirty sessions:', error, LOG_MODULES.SESSION_MANAGER);
366
- }
367
- }
368
- /**
369
- * Updates session metadata by retrieving client information from the client tracker service.
370
- *
371
- * This method fetches current client information including name, version, working directory,
372
- * and project context from the client tracker service and returns a partial session state
373
- * update object containing only the relevant metadata fields.
374
- *
375
- * @param {string} sessionId - Unique identifier of the session to update
376
- * @returns {Partial<SessionState>} Partial session state with updated client metadata
377
- *
378
- * @example
379
- * ```typescript
380
- * const metadata = sessionManager.updateSessionMetadataFromClient('my-session-id');
381
- * console.log('Updated client metadata:', metadata);
382
- * ```
383
- */
384
- updateSessionMetadataFromClient(sessionId) {
385
- const sessionInfo = sessionTrackerService.getSession(sessionId);
386
- return {
387
- clientName: sessionInfo?.clientName,
388
- clientVersion: sessionInfo?.clientVersion,
389
- protocolVersion: sessionInfo?.protocolVersion,
390
- capabilities: sessionInfo?.capabilities,
391
- cwd: sessionInfo?.cwd,
392
- project: sessionInfo?.project,
393
- userAgent: sessionInfo?.userAgent,
394
- ip: sessionInfo?.ip
395
- };
396
- }
397
- /**
398
- * Creates or updates a session state with current metadata and timestamps.
399
- *
400
- * This method merges existing session state (if any) with current client metadata
401
- * from the client tracker service, updates access timestamps, and ensures proper
402
- * session state structure. The updated state is stored in memory and marked as dirty
403
- * for persistence.
404
- *
405
- * @param {string} sessionId - Unique identifier of the session to create or update
406
- * @returns {SessionState} Complete updated session state object
407
- *
408
- * @example
409
- * ```typescript
410
- * const state = sessionManager.upsertSessionState('my-session-id');
411
- * console.log('Session state updated:', state);
412
- * ```
413
- */
414
- upsertSessionState(sessionId) {
415
- const existing = this.sessionStates.get(sessionId);
416
- const now = Date.now();
417
- const clientMetadata = this.updateSessionMetadataFromClient(sessionId);
418
- const state = {
419
- sessionId,
420
- clientName: clientMetadata.clientName || existing?.clientName,
421
- clientVersion: clientMetadata.clientVersion || existing?.clientVersion,
422
- protocolVersion: clientMetadata.protocolVersion || existing?.protocolVersion,
423
- capabilities: clientMetadata.capabilities || existing?.capabilities,
424
- cwd: clientMetadata.cwd || existing?.cwd,
425
- project: clientMetadata.project || existing?.project,
426
- userAgent: clientMetadata.userAgent || existing?.userAgent,
427
- ip: clientMetadata.ip || existing?.ip,
428
- createdAt: existing?.createdAt || now,
429
- lastAccessedAt: now,
430
- metadata: existing?.metadata || {}
431
- };
432
- this.sessionStates.set(sessionId, state);
433
- this.markAsDirty(sessionId);
434
- return state;
435
- }
436
- /**
437
- * Updates session metadata explicitly with provided key-value pairs.
438
- *
439
- * This method merges the provided metadata object with existing session metadata,
440
- * updates the last accessed timestamp, and marks the session as dirty for persistence.
441
- * It's useful for storing custom session-specific information that needs to be persisted.
442
- *
443
- * @param {string} sessionId - Unique identifier of the session to update
444
- * @param {Record<string, unknown>} metadata - Key-value pairs to merge into session metadata
445
- * @returns {Promise<void>} Resolves when metadata is updated and marked for persistence
446
- *
447
- * @example
448
- * ```typescript
449
- * await sessionManager.updateSessionMetadata('my-session-id', {
450
- * userPreferences: { theme: 'dark' },
451
- * lastProject: 'my-project'
452
- * });
453
- * ```
454
- */
455
- async updateSessionMetadata(sessionId, metadata) {
456
- const existing = this.sessionStates.get(sessionId);
457
- if (existing) {
458
- const now = Date.now();
459
- const updated = {
460
- ...existing,
461
- lastAccessedAt: now,
462
- metadata: {
463
- ...existing.metadata,
464
- ...metadata
465
- }
466
- };
467
- this.sessionStates.set(sessionId, updated);
468
- this.markAsDirty(sessionId);
469
- if (getSessionDebugSetting()) {
470
- logger.debug(`Updated metadata for session: ${sessionId}`, LOG_MODULES.SESSION_MANAGER);
471
- }
472
- }
473
40
  }
474
41
  /**
475
42
  * Retrieves an existing session or creates a new one if it doesn't exist.
476
43
  *
477
44
  * This method provides access to active sessions, creating new ones on demand with
478
45
  * proper initialization based on the requireInitialize parameter. It updates session
479
- * access timestamps and persists session state changes to ensure data consistency.
480
- *
481
- * The method includes optimization to prevent excessive timestamp updates for rapid
482
- * successive requests by only updating when at least 100ms have passed since the last access.
46
+ * access timestamps.
483
47
  *
484
48
  * @param {string} sessionId - Unique identifier of the session to retrieve or create
485
49
  * @param {boolean} [requireInitialize=true] - Whether to require MCP protocol initialization
@@ -489,48 +53,28 @@ export class McpSessionManager {
489
53
  * ```typescript
490
54
  * // Get or create session with default initialization
491
55
  * const session = await sessionManager.getSession('my-session-id');
492
- *
493
- * // Get or create session without requiring initialization (for restored sessions)
494
- * const restoredSession = await sessionManager.getSession('restored-session-id', false);
495
56
  * ```
496
57
  */
497
58
  async getSession(sessionId, requireInitialize = true) {
498
59
  if (getSessionDebugSetting()) {
499
- const hasSessionState = this.sessionStates.has(sessionId);
500
60
  const hasSessionObject = this.sessions.has(sessionId);
501
- logger.debug(`getSession called for ${sessionId} (requireInitialize: ${requireInitialize}). State exists: ${hasSessionState}, Object exists: ${hasSessionObject}`, LOG_MODULES.SESSION_MANAGER);
61
+ logger.debug(`getSession called for ${sessionId} (requireInitialize: ${requireInitialize}). Object exists: ${hasSessionObject}`, LOG_MODULES.SESSION_MANAGER);
502
62
  }
503
63
  let session = this.sessions.get(sessionId);
504
- // Check if session state exists but session object doesn't (inconsistency case)
505
- const hasSessionState = this.sessionStates.has(sessionId);
506
- const hasSessionObject = this.sessions.has(sessionId);
507
- if (hasSessionState && !hasSessionObject) {
508
- // Session state exists but session object is missing - recreate session
509
- if (getSessionDebugSetting()) {
510
- logger.debug(`Session state exists but session object missing for ${sessionId}, recreating...`, LOG_MODULES.SESSION_MANAGER);
511
- }
512
- session = await this.createSession(sessionId, requireInitialize);
513
- this.sessions.set(sessionId, session);
514
- }
515
- else if (!session) {
64
+ if (!session) {
516
65
  // Normal case: create new session
517
66
  session = await this.createSession(sessionId, requireInitialize);
518
67
  this.sessions.set(sessionId, session);
519
68
  }
520
69
  else {
521
- // Enhanced check: ensure transport session state is correctly initialized
522
- // This fixes the "Session not found" error when transport has lost session context
523
- const hasRestoredState = this.sessionStates.has(sessionId);
524
- const shouldManuallyInitialize = !requireInitialize || hasRestoredState;
525
- // Always ensure sessionId is set on transport, regardless of initialization status
526
- // This fixes the "Session not found" error for non-initialization requests
70
+ // Ensure transport session state is correctly initialized
527
71
  const webTransport = session.transport
528
72
  ._webStandardTransport;
529
73
  if (webTransport) {
530
74
  const currentSessionId = webTransport.sessionId;
531
75
  const isInitialized = webTransport._initialized;
532
76
  if (getSessionDebugSetting()) {
533
- logger.debug(`Transport state check - Expected: ${sessionId} (initialized: ${shouldManuallyInitialize}), Actual: ${currentSessionId} (initialized: ${isInitialized})`, LOG_MODULES.SESSION_MANAGER);
77
+ logger.debug(`Transport state check - Expected: ${sessionId} (initialized: ${!requireInitialize}), Actual: ${currentSessionId} (initialized: ${isInitialized})`, LOG_MODULES.SESSION_MANAGER);
534
78
  }
535
79
  if (webTransport.sessionId !== sessionId) {
536
80
  logger.warn(`Session ID mismatch detected for ${sessionId}. Resetting transport sessionId.`, LOG_MODULES.SESSION_MANAGER);
@@ -539,7 +83,7 @@ export class McpSessionManager {
539
83
  webTransport._session = sessionId;
540
84
  }
541
85
  }
542
- if (shouldManuallyInitialize && !webTransport._initialized) {
86
+ if (!requireInitialize && !webTransport._initialized) {
543
87
  logger.warn(`Session initialization state mismatch detected for ${sessionId}. Setting initialized flag.`, LOG_MODULES.SESSION_MANAGER);
544
88
  webTransport._initialized = true;
545
89
  }
@@ -548,56 +92,14 @@ export class McpSessionManager {
548
92
  const now = Date.now();
549
93
  const timeDiff = Math.abs(now - session.lastAccessed);
550
94
  // Only update lastAccessed if meaningful time has passed
551
- // This prevents excessive updates for rapid successive requests
552
95
  if (timeDiff >= 100) {
553
96
  session.lastAccessed = now;
554
- // Also update and persist session state
555
- this.upsertSessionState(sessionId);
556
97
  }
557
98
  if (getSessionDebugSetting()) {
558
99
  logger.debug(`Returning session for ${sessionId}`, LOG_MODULES.SESSION_MANAGER);
559
100
  }
560
101
  return session;
561
102
  }
562
- /**
563
- * Retrieves all persisted session states for API exposure.
564
- *
565
- * This method returns an array of all current session states, providing a complete
566
- * snapshot of all active sessions and their metadata. It's primarily used by the
567
- * web API to expose session information to clients.
568
- *
569
- * @returns {SessionState[]} Array of all current session states
570
- *
571
- * @example
572
- * ```typescript
573
- * const allStates = sessionManager.getAllSessionStates();
574
- * console.log(`Total active sessions: ${allStates.length}`);
575
- * ```
576
- */
577
- getAllSessionStates() {
578
- return Array.from(this.sessionStates.values());
579
- }
580
- /**
581
- * Retrieves a specific session state by session ID for API exposure.
582
- *
583
- * This method returns the current state of a specific session or undefined if
584
- * the session doesn't exist. It's primarily used by the web API to provide
585
- * detailed information about individual sessions.
586
- *
587
- * @param {string} sessionId - Unique identifier of the session to retrieve
588
- * @returns {SessionState | undefined} Session state object or undefined if not found
589
- *
590
- * @example
591
- * ```typescript
592
- * const state = sessionManager.getSessionState('my-session-id');
593
- * if (state) {
594
- * console.log('Session client:', state.clientName);
595
- * }
596
- * ```
597
- */
598
- getSessionState(sessionId) {
599
- return this.sessionStates.get(sessionId);
600
- }
601
103
  /**
602
104
  * Checks if a session object exists in the active sessions map.
603
105
  *
@@ -608,11 +110,9 @@ export class McpSessionManager {
608
110
  return this.sessions.has(sessionId);
609
111
  }
610
112
  /**
611
- * Deletes a session and removes it from persistent storage.
113
+ * Deletes a session from memory.
612
114
  *
613
- * This method gracefully closes the session's MCP server, removes it from memory,
614
- * and ensures it's removed from persistent storage by marking it as dirty and
615
- * performing an immediate flush. It returns true if the session existed and was deleted.
115
+ * This method gracefully closes the session's MCP server and removes it from memory.
616
116
  *
617
117
  * @param {string} sessionId - Unique identifier of the session to delete
618
118
  * @returns {Promise<boolean>} True if session existed and was deleted, false otherwise
@@ -635,30 +135,15 @@ export class McpSessionManager {
635
135
  logger.error(`Error closing session ${sessionId}:`, e, LOG_MODULES.SESSION_MANAGER);
636
136
  }
637
137
  this.sessions.delete(sessionId);
138
+ return true;
638
139
  }
639
- const existed = this.sessionStates.has(sessionId);
640
- if (existed) {
641
- this.sessionStates.delete(sessionId);
642
- // Mark as dirty to remove from persistence
643
- this.markAsDirty(sessionId);
644
- // Flush immediately to remove from disk
645
- await this.flushDirtySessions();
646
- }
647
- return existed;
140
+ return false;
648
141
  }
649
142
  /**
650
143
  * Creates a new MCP session with proper initialization and transport setup.
651
144
  *
652
145
  * This method sets up a complete MCP session including server, transport, and
653
- * communication logging. It handles both fresh sessions and restored sessions,
654
- * with special logic for skipping initialization when appropriate.
655
- *
656
- * Key features:
657
- * - Creates StreamableHTTPServerTransport with custom session ID generation
658
- * - Sets up comprehensive message logging for debugging
659
- * - Handles restored sessions by manually initializing transport state
660
- * - Integrates with client tracker service for metadata
661
- * - Creates/updates session state and marks as dirty for persistence
146
+ * communication logging.
662
147
  *
663
148
  * @param {string} sessionId - Unique identifier for the new session
664
149
  * @param {boolean} [requireInitialize=true] - Whether to require MCP protocol initialization
@@ -688,46 +173,26 @@ export class McpSessionManager {
688
173
  }
689
174
  });
690
175
  // Directly set sessionId property to avoid validateSession failure
691
- // because WebStandardStreamableHTTPServerTransport only calls sessionIdGenerator during initialize
692
176
  const webTransport = transport._webStandardTransport;
693
177
  if (webTransport) {
694
178
  webTransport.sessionId = sessionId;
695
- // Do not set _initialized = true here because it will cause initialize request to fail
696
- // _initialized flag will be set as needed in the shouldManuallyInitialize logic
697
179
  if (getSessionDebugSetting()) {
698
180
  logger.debug(`Directly set sessionId on transport: ${sessionId}`, LOG_MODULES.SESSION_MANAGER);
699
181
  }
700
182
  }
701
- // Check if we have a restored state for this session
702
- const restoredState = this.sessionStates.get(sessionId);
703
- if (restoredState) {
704
- logger.info(`Reusing restored session state for: ${sessionId}`, LOG_MODULES.SESSION_MANAGER);
705
- }
706
- // For restored sessions or when explicitly requested to skip initialization, manually set the initialized flag
707
- // This allows sending requests like tools/list directly without needing to initialize first
708
- const shouldManuallyInitialize = !requireInitialize || !!restoredState;
709
- if (getSessionDebugSetting()) {
710
- logger.debug(`shouldManuallyInitialize: ${shouldManuallyInitialize} (!requireInitialize: ${!requireInitialize} || restored: ${!!restoredState})`, LOG_MODULES.SESSION_MANAGER);
711
- }
712
- if (shouldManuallyInitialize) {
183
+ // For sessions that need to skip initialization, manually set the initialized flag
184
+ if (!requireInitialize) {
713
185
  const webTransport = transport._webStandardTransport;
714
186
  if (webTransport) {
715
187
  webTransport.sessionId = sessionId;
716
188
  webTransport._initialized = true;
717
- // Ensure session property is also set if it exists
718
189
  if (webTransport._session !== undefined) {
719
190
  webTransport._session = sessionId;
720
191
  }
721
192
  if (getSessionDebugSetting()) {
722
- logger.debug(`Manually initialized transport for session: ${sessionId} (skipInitialize: ${!requireInitialize}, restored: ${!!restoredState})`, LOG_MODULES.SESSION_MANAGER);
723
- logger.debug(`Transport state after manual init - sessionId: ${webTransport.sessionId}, _initialized: ${webTransport._initialized}, _session: ${webTransport._session}`, LOG_MODULES.SESSION_MANAGER);
193
+ logger.debug(`Manually initialized transport for session: ${sessionId} (skipInitialize: ${!requireInitialize}`, LOG_MODULES.SESSION_MANAGER);
724
194
  }
725
195
  }
726
- else {
727
- logger.error(`Failed to get _webStandardTransport from transport!`, LOG_MODULES.SESSION_MANAGER);
728
- // Even if we can't manually initialize, continue with normal initialization
729
- // The transport will be initialized when the first request arrives
730
- }
731
196
  }
732
197
  // Always set up message handler for notifications/message
733
198
  transport.onmessage = (message) => {
@@ -757,14 +222,9 @@ export class McpSessionManager {
757
222
  const server = gateway.createConnectionServer();
758
223
  // Ensure server is fully connected before returning session
759
224
  await server.connect(transport);
760
- // Note: StreamableHTTPServerTransport's onsessioninitialized callback is triggered
761
- // when the first actual request (GET /mcp) arrives, not during connect().
762
- // Therefore, we don't need to wait for this event - the transport is ready to receive requests.
763
225
  if (getSessionDebugSetting()) {
764
226
  logger.debug(`StreamableHTTPServerTransport ready for session: ${sessionId}`, LOG_MODULES.SESSION_MANAGER);
765
227
  }
766
- // Create/update session state
767
- this.upsertSessionState(sessionId);
768
228
  logger.info(`MCP session created successfully: ${sessionId}`, LOG_MODULES.SESSION_MANAGER);
769
229
  const session = {
770
230
  server,
@@ -777,14 +237,11 @@ export class McpSessionManager {
777
237
  /**
778
238
  * Cleans up stale sessions based on the configured session timeout.
779
239
  *
780
- * This method is called periodically (every 60 seconds) to identify and close
240
+ * This method is called periodically to identify and close
781
241
  * sessions that haven't been accessed within the configured timeout period
782
242
  * (default 30 minutes). It gracefully closes MCP servers and removes sessions
783
243
  * from memory to prevent resource leaks.
784
244
  *
785
- * The method logs detailed information about cleaned sessions and maintains
786
- * active session count for monitoring purposes.
787
- *
788
245
  * @returns {void}
789
246
  *
790
247
  * @example
@@ -810,27 +267,8 @@ export class McpSessionManager {
810
267
  this.sessions.delete(sessionId);
811
268
  }
812
269
  }
813
- // Cleanup persisted session states
814
- const expiredSessionIds = [];
815
- for (const [sessionId, session] of this.sessionStates.entries()) {
816
- if (now - session.lastAccessedAt > this.SESSION_TIMEOUT) {
817
- expiredSessionIds.push(sessionId);
818
- cleanedCount++;
819
- }
820
- }
821
- for (const sessionId of expiredSessionIds) {
822
- this.sessionStates.delete(sessionId);
823
- this.markAsDirty(sessionId);
824
- logger.debug(`Marking expired session for deletion: ${sessionId}`, LOG_MODULES.SESSION_MANAGER);
825
- }
826
- // Immediately flush to delete session files from disk
827
- if (expiredSessionIds.length > 0) {
828
- this.flushDirtySessions().catch((error) => {
829
- logger.error('Failed to flush expired sessions:', error, LOG_MODULES.SESSION_MANAGER);
830
- });
831
- }
832
270
  if (cleanedCount > 0) {
833
- logger.info(`Cleaned up ${cleanedCount} stale sessions. Active sessions: ${this.sessions.size}, Persisted states: ${this.sessionStates.size}`, LOG_MODULES.SESSION_MANAGER);
271
+ logger.info(`Cleaned up ${cleanedCount} stale sessions. Active sessions: ${this.sessions.size}`, LOG_MODULES.SESSION_MANAGER);
834
272
  }
835
273
  }
836
274
  }