universal-agent-protocol 0.5.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 (415) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +462 -0
  3. package/dist/analyzers/index.d.ts +3 -0
  4. package/dist/analyzers/index.d.ts.map +1 -0
  5. package/dist/analyzers/index.js +656 -0
  6. package/dist/analyzers/index.js.map +1 -0
  7. package/dist/bin/cli.d.ts +3 -0
  8. package/dist/bin/cli.d.ts.map +1 -0
  9. package/dist/bin/cli.js +506 -0
  10. package/dist/bin/cli.js.map +1 -0
  11. package/dist/bin/tool-calls.d.ts +3 -0
  12. package/dist/bin/tool-calls.d.ts.map +1 -0
  13. package/dist/bin/tool-calls.js +4 -0
  14. package/dist/bin/tool-calls.js.map +1 -0
  15. package/dist/cli/agent.d.ts +20 -0
  16. package/dist/cli/agent.d.ts.map +1 -0
  17. package/dist/cli/agent.js +434 -0
  18. package/dist/cli/agent.js.map +1 -0
  19. package/dist/cli/analyze.d.ts +7 -0
  20. package/dist/cli/analyze.d.ts.map +1 -0
  21. package/dist/cli/analyze.js +103 -0
  22. package/dist/cli/analyze.js.map +1 -0
  23. package/dist/cli/coord.d.ts +7 -0
  24. package/dist/cli/coord.d.ts.map +1 -0
  25. package/dist/cli/coord.js +138 -0
  26. package/dist/cli/coord.js.map +1 -0
  27. package/dist/cli/dashboard.d.ts +8 -0
  28. package/dist/cli/dashboard.d.ts.map +1 -0
  29. package/dist/cli/dashboard.js +704 -0
  30. package/dist/cli/dashboard.js.map +1 -0
  31. package/dist/cli/deploy.d.ts +19 -0
  32. package/dist/cli/deploy.d.ts.map +1 -0
  33. package/dist/cli/deploy.js +267 -0
  34. package/dist/cli/deploy.js.map +1 -0
  35. package/dist/cli/droids.d.ts +9 -0
  36. package/dist/cli/droids.d.ts.map +1 -0
  37. package/dist/cli/droids.js +227 -0
  38. package/dist/cli/droids.js.map +1 -0
  39. package/dist/cli/generate.d.ts +17 -0
  40. package/dist/cli/generate.d.ts.map +1 -0
  41. package/dist/cli/generate.js +432 -0
  42. package/dist/cli/generate.js.map +1 -0
  43. package/dist/cli/hooks.d.ts +9 -0
  44. package/dist/cli/hooks.d.ts.map +1 -0
  45. package/dist/cli/hooks.js +374 -0
  46. package/dist/cli/hooks.js.map +1 -0
  47. package/dist/cli/init.d.ts +11 -0
  48. package/dist/cli/init.d.ts.map +1 -0
  49. package/dist/cli/init.js +316 -0
  50. package/dist/cli/init.js.map +1 -0
  51. package/dist/cli/mcp-router.d.ts +16 -0
  52. package/dist/cli/mcp-router.d.ts.map +1 -0
  53. package/dist/cli/mcp-router.js +143 -0
  54. package/dist/cli/mcp-router.js.map +1 -0
  55. package/dist/cli/memory.d.ts +24 -0
  56. package/dist/cli/memory.d.ts.map +1 -0
  57. package/dist/cli/memory.js +877 -0
  58. package/dist/cli/memory.js.map +1 -0
  59. package/dist/cli/model.d.ts +15 -0
  60. package/dist/cli/model.d.ts.map +1 -0
  61. package/dist/cli/model.js +270 -0
  62. package/dist/cli/model.js.map +1 -0
  63. package/dist/cli/patterns.d.ts +26 -0
  64. package/dist/cli/patterns.d.ts.map +1 -0
  65. package/dist/cli/patterns.js +587 -0
  66. package/dist/cli/patterns.js.map +1 -0
  67. package/dist/cli/setup-mcp-router.d.ts +8 -0
  68. package/dist/cli/setup-mcp-router.d.ts.map +1 -0
  69. package/dist/cli/setup-mcp-router.js +163 -0
  70. package/dist/cli/setup-mcp-router.js.map +1 -0
  71. package/dist/cli/setup.d.ts +13 -0
  72. package/dist/cli/setup.d.ts.map +1 -0
  73. package/dist/cli/setup.js +146 -0
  74. package/dist/cli/setup.js.map +1 -0
  75. package/dist/cli/sync.d.ts +7 -0
  76. package/dist/cli/sync.d.ts.map +1 -0
  77. package/dist/cli/sync.js +26 -0
  78. package/dist/cli/sync.js.map +1 -0
  79. package/dist/cli/task.d.ts +33 -0
  80. package/dist/cli/task.d.ts.map +1 -0
  81. package/dist/cli/task.js +616 -0
  82. package/dist/cli/task.js.map +1 -0
  83. package/dist/cli/tool-calls.d.ts +8 -0
  84. package/dist/cli/tool-calls.d.ts.map +1 -0
  85. package/dist/cli/tool-calls.js +239 -0
  86. package/dist/cli/tool-calls.js.map +1 -0
  87. package/dist/cli/update.d.ts +10 -0
  88. package/dist/cli/update.d.ts.map +1 -0
  89. package/dist/cli/update.js +300 -0
  90. package/dist/cli/update.js.map +1 -0
  91. package/dist/cli/visualize.d.ts +77 -0
  92. package/dist/cli/visualize.d.ts.map +1 -0
  93. package/dist/cli/visualize.js +287 -0
  94. package/dist/cli/visualize.js.map +1 -0
  95. package/dist/cli/worktree.d.ts +9 -0
  96. package/dist/cli/worktree.d.ts.map +1 -0
  97. package/dist/cli/worktree.js +175 -0
  98. package/dist/cli/worktree.js.map +1 -0
  99. package/dist/coordination/capability-router.d.ts +79 -0
  100. package/dist/coordination/capability-router.d.ts.map +1 -0
  101. package/dist/coordination/capability-router.js +324 -0
  102. package/dist/coordination/capability-router.js.map +1 -0
  103. package/dist/coordination/database.d.ts +13 -0
  104. package/dist/coordination/database.d.ts.map +1 -0
  105. package/dist/coordination/database.js +131 -0
  106. package/dist/coordination/database.js.map +1 -0
  107. package/dist/coordination/deploy-batcher.d.ts +101 -0
  108. package/dist/coordination/deploy-batcher.d.ts.map +1 -0
  109. package/dist/coordination/deploy-batcher.js +565 -0
  110. package/dist/coordination/deploy-batcher.js.map +1 -0
  111. package/dist/coordination/index.d.ts +5 -0
  112. package/dist/coordination/index.d.ts.map +1 -0
  113. package/dist/coordination/index.js +5 -0
  114. package/dist/coordination/index.js.map +1 -0
  115. package/dist/coordination/service.d.ts +81 -0
  116. package/dist/coordination/service.d.ts.map +1 -0
  117. package/dist/coordination/service.js +603 -0
  118. package/dist/coordination/service.js.map +1 -0
  119. package/dist/generators/claude-md.d.ts +3 -0
  120. package/dist/generators/claude-md.d.ts.map +1 -0
  121. package/dist/generators/claude-md.js +977 -0
  122. package/dist/generators/claude-md.js.map +1 -0
  123. package/dist/generators/template-loader.d.ts +105 -0
  124. package/dist/generators/template-loader.d.ts.map +1 -0
  125. package/dist/generators/template-loader.js +291 -0
  126. package/dist/generators/template-loader.js.map +1 -0
  127. package/dist/index.d.ts +47 -0
  128. package/dist/index.d.ts.map +1 -0
  129. package/dist/index.js +59 -0
  130. package/dist/index.js.map +1 -0
  131. package/dist/mcp-router/config/parser.d.ts +9 -0
  132. package/dist/mcp-router/config/parser.d.ts.map +1 -0
  133. package/dist/mcp-router/config/parser.js +174 -0
  134. package/dist/mcp-router/config/parser.js.map +1 -0
  135. package/dist/mcp-router/executor/client.d.ts +31 -0
  136. package/dist/mcp-router/executor/client.d.ts.map +1 -0
  137. package/dist/mcp-router/executor/client.js +187 -0
  138. package/dist/mcp-router/executor/client.js.map +1 -0
  139. package/dist/mcp-router/index.d.ts +22 -0
  140. package/dist/mcp-router/index.d.ts.map +1 -0
  141. package/dist/mcp-router/index.js +18 -0
  142. package/dist/mcp-router/index.js.map +1 -0
  143. package/dist/mcp-router/output-compressor.d.ts +26 -0
  144. package/dist/mcp-router/output-compressor.d.ts.map +1 -0
  145. package/dist/mcp-router/output-compressor.js +236 -0
  146. package/dist/mcp-router/output-compressor.js.map +1 -0
  147. package/dist/mcp-router/search/fuzzy.d.ts +26 -0
  148. package/dist/mcp-router/search/fuzzy.d.ts.map +1 -0
  149. package/dist/mcp-router/search/fuzzy.js +94 -0
  150. package/dist/mcp-router/search/fuzzy.js.map +1 -0
  151. package/dist/mcp-router/server.d.ts +50 -0
  152. package/dist/mcp-router/server.d.ts.map +1 -0
  153. package/dist/mcp-router/server.js +229 -0
  154. package/dist/mcp-router/server.js.map +1 -0
  155. package/dist/mcp-router/session-stats.d.ts +37 -0
  156. package/dist/mcp-router/session-stats.d.ts.map +1 -0
  157. package/dist/mcp-router/session-stats.js +56 -0
  158. package/dist/mcp-router/session-stats.js.map +1 -0
  159. package/dist/mcp-router/tools/discover.d.ts +37 -0
  160. package/dist/mcp-router/tools/discover.d.ts.map +1 -0
  161. package/dist/mcp-router/tools/discover.js +65 -0
  162. package/dist/mcp-router/tools/discover.js.map +1 -0
  163. package/dist/mcp-router/tools/execute.d.ts +43 -0
  164. package/dist/mcp-router/tools/execute.d.ts.map +1 -0
  165. package/dist/mcp-router/tools/execute.js +103 -0
  166. package/dist/mcp-router/tools/execute.js.map +1 -0
  167. package/dist/mcp-router/types.d.ts +62 -0
  168. package/dist/mcp-router/types.d.ts.map +1 -0
  169. package/dist/mcp-router/types.js +6 -0
  170. package/dist/mcp-router/types.js.map +1 -0
  171. package/dist/memory/adaptive-context.d.ts +146 -0
  172. package/dist/memory/adaptive-context.d.ts.map +1 -0
  173. package/dist/memory/adaptive-context.js +1022 -0
  174. package/dist/memory/adaptive-context.js.map +1 -0
  175. package/dist/memory/agent-scoped-memory.d.ts +67 -0
  176. package/dist/memory/agent-scoped-memory.d.ts.map +1 -0
  177. package/dist/memory/agent-scoped-memory.js +126 -0
  178. package/dist/memory/agent-scoped-memory.js.map +1 -0
  179. package/dist/memory/backends/base.d.ts +18 -0
  180. package/dist/memory/backends/base.d.ts.map +1 -0
  181. package/dist/memory/backends/base.js +2 -0
  182. package/dist/memory/backends/base.js.map +1 -0
  183. package/dist/memory/backends/factory.d.ts +4 -0
  184. package/dist/memory/backends/factory.d.ts.map +1 -0
  185. package/dist/memory/backends/factory.js +53 -0
  186. package/dist/memory/backends/factory.js.map +1 -0
  187. package/dist/memory/backends/github.d.ts +22 -0
  188. package/dist/memory/backends/github.d.ts.map +1 -0
  189. package/dist/memory/backends/github.js +118 -0
  190. package/dist/memory/backends/github.js.map +1 -0
  191. package/dist/memory/backends/qdrant-cloud.d.ts +32 -0
  192. package/dist/memory/backends/qdrant-cloud.d.ts.map +1 -0
  193. package/dist/memory/backends/qdrant-cloud.js +168 -0
  194. package/dist/memory/backends/qdrant-cloud.js.map +1 -0
  195. package/dist/memory/context-compressor.d.ts +74 -0
  196. package/dist/memory/context-compressor.d.ts.map +1 -0
  197. package/dist/memory/context-compressor.js +289 -0
  198. package/dist/memory/context-compressor.js.map +1 -0
  199. package/dist/memory/correction-propagator.d.ts +44 -0
  200. package/dist/memory/correction-propagator.d.ts.map +1 -0
  201. package/dist/memory/correction-propagator.js +156 -0
  202. package/dist/memory/correction-propagator.js.map +1 -0
  203. package/dist/memory/daily-log.d.ts +67 -0
  204. package/dist/memory/daily-log.d.ts.map +1 -0
  205. package/dist/memory/daily-log.js +143 -0
  206. package/dist/memory/daily-log.js.map +1 -0
  207. package/dist/memory/dynamic-retrieval.d.ts +110 -0
  208. package/dist/memory/dynamic-retrieval.d.ts.map +1 -0
  209. package/dist/memory/dynamic-retrieval.js +688 -0
  210. package/dist/memory/dynamic-retrieval.js.map +1 -0
  211. package/dist/memory/embeddings.d.ts +116 -0
  212. package/dist/memory/embeddings.d.ts.map +1 -0
  213. package/dist/memory/embeddings.js +461 -0
  214. package/dist/memory/embeddings.js.map +1 -0
  215. package/dist/memory/hierarchical-memory.d.ts +141 -0
  216. package/dist/memory/hierarchical-memory.d.ts.map +1 -0
  217. package/dist/memory/hierarchical-memory.js +477 -0
  218. package/dist/memory/hierarchical-memory.js.map +1 -0
  219. package/dist/memory/memory-consolidator.d.ts +124 -0
  220. package/dist/memory/memory-consolidator.d.ts.map +1 -0
  221. package/dist/memory/memory-consolidator.js +514 -0
  222. package/dist/memory/memory-consolidator.js.map +1 -0
  223. package/dist/memory/memory-maintenance.d.ts +39 -0
  224. package/dist/memory/memory-maintenance.d.ts.map +1 -0
  225. package/dist/memory/memory-maintenance.js +305 -0
  226. package/dist/memory/memory-maintenance.js.map +1 -0
  227. package/dist/memory/model-router.d.ts +102 -0
  228. package/dist/memory/model-router.d.ts.map +1 -0
  229. package/dist/memory/model-router.js +448 -0
  230. package/dist/memory/model-router.js.map +1 -0
  231. package/dist/memory/multi-view-memory.d.ts +134 -0
  232. package/dist/memory/multi-view-memory.d.ts.map +1 -0
  233. package/dist/memory/multi-view-memory.js +420 -0
  234. package/dist/memory/multi-view-memory.js.map +1 -0
  235. package/dist/memory/prepopulate.d.ts +76 -0
  236. package/dist/memory/prepopulate.d.ts.map +1 -0
  237. package/dist/memory/prepopulate.js +815 -0
  238. package/dist/memory/prepopulate.js.map +1 -0
  239. package/dist/memory/semantic-compression.d.ts +77 -0
  240. package/dist/memory/semantic-compression.d.ts.map +1 -0
  241. package/dist/memory/semantic-compression.js +348 -0
  242. package/dist/memory/semantic-compression.js.map +1 -0
  243. package/dist/memory/serverless-qdrant.d.ts +102 -0
  244. package/dist/memory/serverless-qdrant.d.ts.map +1 -0
  245. package/dist/memory/serverless-qdrant.js +369 -0
  246. package/dist/memory/serverless-qdrant.js.map +1 -0
  247. package/dist/memory/short-term/factory.d.ts +26 -0
  248. package/dist/memory/short-term/factory.d.ts.map +1 -0
  249. package/dist/memory/short-term/factory.js +28 -0
  250. package/dist/memory/short-term/factory.js.map +1 -0
  251. package/dist/memory/short-term/indexeddb.d.ts +25 -0
  252. package/dist/memory/short-term/indexeddb.d.ts.map +1 -0
  253. package/dist/memory/short-term/indexeddb.js +64 -0
  254. package/dist/memory/short-term/indexeddb.js.map +1 -0
  255. package/dist/memory/short-term/schema.d.ts +6 -0
  256. package/dist/memory/short-term/schema.d.ts.map +1 -0
  257. package/dist/memory/short-term/schema.js +119 -0
  258. package/dist/memory/short-term/schema.js.map +1 -0
  259. package/dist/memory/short-term/sqlite.d.ts +50 -0
  260. package/dist/memory/short-term/sqlite.d.ts.map +1 -0
  261. package/dist/memory/short-term/sqlite.js +221 -0
  262. package/dist/memory/short-term/sqlite.js.map +1 -0
  263. package/dist/memory/speculative-cache.d.ts +111 -0
  264. package/dist/memory/speculative-cache.d.ts.map +1 -0
  265. package/dist/memory/speculative-cache.js +409 -0
  266. package/dist/memory/speculative-cache.js.map +1 -0
  267. package/dist/memory/task-classifier.d.ts +34 -0
  268. package/dist/memory/task-classifier.d.ts.map +1 -0
  269. package/dist/memory/task-classifier.js +300 -0
  270. package/dist/memory/task-classifier.js.map +1 -0
  271. package/dist/memory/terminal-bench-knowledge.d.ts +48 -0
  272. package/dist/memory/terminal-bench-knowledge.d.ts.map +1 -0
  273. package/dist/memory/terminal-bench-knowledge.js +399 -0
  274. package/dist/memory/terminal-bench-knowledge.js.map +1 -0
  275. package/dist/memory/write-gate.d.ts +39 -0
  276. package/dist/memory/write-gate.d.ts.map +1 -0
  277. package/dist/memory/write-gate.js +190 -0
  278. package/dist/memory/write-gate.js.map +1 -0
  279. package/dist/models/executor.d.ts +130 -0
  280. package/dist/models/executor.d.ts.map +1 -0
  281. package/dist/models/executor.js +383 -0
  282. package/dist/models/executor.js.map +1 -0
  283. package/dist/models/index.d.ts +15 -0
  284. package/dist/models/index.d.ts.map +1 -0
  285. package/dist/models/index.js +17 -0
  286. package/dist/models/index.js.map +1 -0
  287. package/dist/models/planner.d.ts +71 -0
  288. package/dist/models/planner.d.ts.map +1 -0
  289. package/dist/models/planner.js +344 -0
  290. package/dist/models/planner.js.map +1 -0
  291. package/dist/models/router.d.ts +75 -0
  292. package/dist/models/router.d.ts.map +1 -0
  293. package/dist/models/router.js +344 -0
  294. package/dist/models/router.js.map +1 -0
  295. package/dist/models/types.d.ts +370 -0
  296. package/dist/models/types.d.ts.map +1 -0
  297. package/dist/models/types.js +181 -0
  298. package/dist/models/types.js.map +1 -0
  299. package/dist/tasks/coordination.d.ts +74 -0
  300. package/dist/tasks/coordination.d.ts.map +1 -0
  301. package/dist/tasks/coordination.js +237 -0
  302. package/dist/tasks/coordination.js.map +1 -0
  303. package/dist/tasks/database.d.ts +14 -0
  304. package/dist/tasks/database.d.ts.map +1 -0
  305. package/dist/tasks/database.js +128 -0
  306. package/dist/tasks/database.js.map +1 -0
  307. package/dist/tasks/index.d.ts +5 -0
  308. package/dist/tasks/index.d.ts.map +1 -0
  309. package/dist/tasks/index.js +5 -0
  310. package/dist/tasks/index.js.map +1 -0
  311. package/dist/tasks/service.d.ts +39 -0
  312. package/dist/tasks/service.d.ts.map +1 -0
  313. package/dist/tasks/service.js +582 -0
  314. package/dist/tasks/service.js.map +1 -0
  315. package/dist/tasks/types.d.ts +224 -0
  316. package/dist/tasks/types.d.ts.map +1 -0
  317. package/dist/tasks/types.js +64 -0
  318. package/dist/tasks/types.js.map +1 -0
  319. package/dist/types/analysis.d.ts +82 -0
  320. package/dist/types/analysis.d.ts.map +1 -0
  321. package/dist/types/analysis.js +2 -0
  322. package/dist/types/analysis.js.map +1 -0
  323. package/dist/types/config.d.ts +3023 -0
  324. package/dist/types/config.d.ts.map +1 -0
  325. package/dist/types/config.js +292 -0
  326. package/dist/types/config.js.map +1 -0
  327. package/dist/types/coordination.d.ts +240 -0
  328. package/dist/types/coordination.d.ts.map +1 -0
  329. package/dist/types/coordination.js +43 -0
  330. package/dist/types/coordination.js.map +1 -0
  331. package/dist/types/index.d.ts +4 -0
  332. package/dist/types/index.d.ts.map +1 -0
  333. package/dist/types/index.js +4 -0
  334. package/dist/types/index.js.map +1 -0
  335. package/dist/utils/calculate-average.d.ts +15 -0
  336. package/dist/utils/calculate-average.d.ts.map +1 -0
  337. package/dist/utils/calculate-average.js +21 -0
  338. package/dist/utils/calculate-average.js.map +1 -0
  339. package/dist/utils/config-manager.d.ts +30 -0
  340. package/dist/utils/config-manager.d.ts.map +1 -0
  341. package/dist/utils/config-manager.js +41 -0
  342. package/dist/utils/config-manager.js.map +1 -0
  343. package/dist/utils/dijkstra.d.ts +17 -0
  344. package/dist/utils/dijkstra.d.ts.map +1 -0
  345. package/dist/utils/dijkstra.js +91 -0
  346. package/dist/utils/dijkstra.js.map +1 -0
  347. package/dist/utils/fetch-with-retry.d.ts +5 -0
  348. package/dist/utils/fetch-with-retry.d.ts.map +1 -0
  349. package/dist/utils/fetch-with-retry.js +61 -0
  350. package/dist/utils/fetch-with-retry.js.map +1 -0
  351. package/dist/utils/merge-claude-md.d.ts +28 -0
  352. package/dist/utils/merge-claude-md.d.ts.map +1 -0
  353. package/dist/utils/merge-claude-md.js +342 -0
  354. package/dist/utils/merge-claude-md.js.map +1 -0
  355. package/dist/utils/order-processor-refactored.d.ts +126 -0
  356. package/dist/utils/order-processor-refactored.d.ts.map +1 -0
  357. package/dist/utils/order-processor-refactored.js +165 -0
  358. package/dist/utils/order-processor-refactored.js.map +1 -0
  359. package/dist/utils/order-processor-strategy.d.ts +72 -0
  360. package/dist/utils/order-processor-strategy.d.ts.map +1 -0
  361. package/dist/utils/order-processor-strategy.js +158 -0
  362. package/dist/utils/order-processor-strategy.js.map +1 -0
  363. package/dist/utils/order-processor.d.ts +242 -0
  364. package/dist/utils/order-processor.d.ts.map +1 -0
  365. package/dist/utils/order-processor.js +370 -0
  366. package/dist/utils/order-processor.js.map +1 -0
  367. package/dist/utils/rate-limiter-simple.d.ts +58 -0
  368. package/dist/utils/rate-limiter-simple.d.ts.map +1 -0
  369. package/dist/utils/rate-limiter-simple.js +100 -0
  370. package/dist/utils/rate-limiter-simple.js.map +1 -0
  371. package/dist/utils/rate-limiter.d.ts +62 -0
  372. package/dist/utils/rate-limiter.d.ts.map +1 -0
  373. package/dist/utils/rate-limiter.js +150 -0
  374. package/dist/utils/rate-limiter.js.map +1 -0
  375. package/dist/utils/string-similarity.d.ts +37 -0
  376. package/dist/utils/string-similarity.d.ts.map +1 -0
  377. package/dist/utils/string-similarity.js +114 -0
  378. package/dist/utils/string-similarity.js.map +1 -0
  379. package/dist/utils/validate-json.d.ts +51 -0
  380. package/dist/utils/validate-json.d.ts.map +1 -0
  381. package/dist/utils/validate-json.js +99 -0
  382. package/dist/utils/validate-json.js.map +1 -0
  383. package/package.json +96 -0
  384. package/templates/CLAUDE.template.md +11 -0
  385. package/templates/CLAUDE_ARCHITECTURE.template.md +103 -0
  386. package/templates/CLAUDE_CODING.template.md +125 -0
  387. package/templates/CLAUDE_DROIDS.template.md +109 -0
  388. package/templates/CLAUDE_MEMORY.template.md +130 -0
  389. package/templates/CLAUDE_WORKFLOWS.template.md +136 -0
  390. package/templates/PROJECT.template.md +209 -0
  391. package/templates/SCHEMA.md +57 -0
  392. package/templates/archive/CLAUDE.template.root-v6.md +762 -0
  393. package/templates/archive/CLAUDE.template.v6.md +762 -0
  394. package/templates/hooks/pre-compact.sh +68 -0
  395. package/templates/hooks/session-start.sh +106 -0
  396. package/tools/agents/README.md +224 -0
  397. package/tools/agents/UAP/README.md +351 -0
  398. package/tools/agents/UAP/__init__.py +9 -0
  399. package/tools/agents/UAP/cli.py +675 -0
  400. package/tools/agents/UAP/version.py +2 -0
  401. package/tools/agents/benchmarks/benchmark_memory_systems.py +637 -0
  402. package/tools/agents/benchmarks/results/benchmark_20260106_064817.json +170 -0
  403. package/tools/agents/benchmarks/results/benchmark_20260106_064817.md +51 -0
  404. package/tools/agents/config/chat_template.jinja +172 -0
  405. package/tools/agents/docker-compose.qdrant.yml +24 -0
  406. package/tools/agents/migrations/apply.py +256 -0
  407. package/tools/agents/scripts/fix_qwen_chat_template.py +314 -0
  408. package/tools/agents/scripts/init_qdrant.py +151 -0
  409. package/tools/agents/scripts/memory_migration.py +518 -0
  410. package/tools/agents/scripts/migrate_memory_to_qdrant.py +113 -0
  411. package/tools/agents/scripts/query_memory.py +189 -0
  412. package/tools/agents/scripts/qwen_tool_call_test.py +419 -0
  413. package/tools/agents/scripts/qwen_tool_call_wrapper.py +517 -0
  414. package/tools/agents/scripts/start-services.sh +96 -0
  415. package/tools/agents/tests/test_uap_compliance.py +257 -0
@@ -0,0 +1,236 @@
1
+ /**
2
+ * MCP Router Output Compressor
3
+ *
4
+ * Compresses large tool outputs before they enter the LLM context window.
5
+ * - Small outputs (<5KB): pass through unchanged
6
+ * - Medium outputs (5-10KB): head+tail smart truncation
7
+ * - Large outputs (>10KB) with intent: FTS5 index-then-search, return only matching snippets
8
+ */
9
+ import Database from 'better-sqlite3';
10
+ import { smartTruncate } from '../memory/context-compressor.js';
11
+ const DEFAULT_MAX_BYTES = 5120; // 5KB threshold for truncation
12
+ const INDEX_THRESHOLD = 10240; // 10KB threshold for auto-indexing
13
+ const MAX_SNIPPETS = 3;
14
+ /**
15
+ * Compress a tool output for context efficiency.
16
+ */
17
+ export function compressToolOutput(result, options = {}) {
18
+ const { maxBytes = DEFAULT_MAX_BYTES, intent } = options;
19
+ const serialized = typeof result === 'string' ? result : JSON.stringify(result, null, 2);
20
+ const originalBytes = Buffer.byteLength(serialized, 'utf-8');
21
+ // Small output: pass through
22
+ if (originalBytes <= maxBytes) {
23
+ return {
24
+ output: result,
25
+ stats: {
26
+ originalBytes,
27
+ compressedBytes: originalBytes,
28
+ savings: '0%',
29
+ method: 'passthrough',
30
+ },
31
+ };
32
+ }
33
+ // Large output with intent: index and search
34
+ if (intent && originalBytes >= INDEX_THRESHOLD) {
35
+ const indexed = indexAndSearch(serialized, intent);
36
+ const compressedBytes = Buffer.byteLength(indexed, 'utf-8');
37
+ return {
38
+ output: indexed,
39
+ stats: {
40
+ originalBytes,
41
+ compressedBytes,
42
+ savings: `${Math.round((1 - compressedBytes / originalBytes) * 100)}%`,
43
+ method: 'indexed',
44
+ },
45
+ };
46
+ }
47
+ // Medium/large output without intent: head+tail truncation
48
+ const truncated = smartTruncate(serialized, maxBytes);
49
+ const compressedBytes = Buffer.byteLength(truncated, 'utf-8');
50
+ return {
51
+ output: truncated,
52
+ stats: {
53
+ originalBytes,
54
+ compressedBytes,
55
+ savings: `${Math.round((1 - compressedBytes / originalBytes) * 100)}%`,
56
+ method: 'truncated',
57
+ },
58
+ };
59
+ }
60
+ /**
61
+ * Index large output into in-memory FTS5 and return intent-matching snippets.
62
+ */
63
+ function indexAndSearch(content, intent) {
64
+ const chunks = chunkByStructure(content);
65
+ if (chunks.length === 0) {
66
+ return smartTruncate(content, DEFAULT_MAX_BYTES);
67
+ }
68
+ let db = null;
69
+ try {
70
+ db = new Database(':memory:');
71
+ db.exec(`
72
+ CREATE VIRTUAL TABLE IF NOT EXISTS output_fts USING fts5(
73
+ content,
74
+ chunk_index,
75
+ tokenize='porter'
76
+ );
77
+ `);
78
+ const insert = db.prepare('INSERT INTO output_fts (content, chunk_index) VALUES (?, ?)');
79
+ const insertMany = db.transaction((items) => {
80
+ for (const item of items) {
81
+ insert.run(item.content, String(item.index));
82
+ }
83
+ });
84
+ insertMany(chunks.map((c, i) => ({ content: c, index: i })));
85
+ // Search with BM25 ranking
86
+ const sanitizedIntent = sanitizeFTS5Query(intent);
87
+ const results = db.prepare(`
88
+ SELECT content, rank
89
+ FROM output_fts
90
+ WHERE output_fts MATCH ?
91
+ ORDER BY rank
92
+ LIMIT ?
93
+ `).all(sanitizedIntent, MAX_SNIPPETS);
94
+ // Extract vocabulary from all chunks for follow-up queries
95
+ const vocabulary = extractVocabulary(chunks);
96
+ if (results.length === 0) {
97
+ // No FTS5 matches, fall back to keyword search in chunks
98
+ const keywordResults = keywordSearch(chunks, intent);
99
+ if (keywordResults.length > 0) {
100
+ return formatIndexedResponse(keywordResults, vocabulary, chunks.length, content.length);
101
+ }
102
+ // Nothing matched, fall back to truncation
103
+ return smartTruncate(content, DEFAULT_MAX_BYTES);
104
+ }
105
+ const snippets = results.map(r => r.content);
106
+ return formatIndexedResponse(snippets, vocabulary, chunks.length, content.length);
107
+ }
108
+ catch {
109
+ // FTS5 unavailable or error, fall back to truncation
110
+ return smartTruncate(content, DEFAULT_MAX_BYTES);
111
+ }
112
+ finally {
113
+ db?.close();
114
+ }
115
+ }
116
+ function formatIndexedResponse(snippets, vocabulary, totalChunks, totalBytes) {
117
+ const header = `[Indexed ${totalChunks} sections from ${formatBytes(totalBytes)} output — showing ${snippets.length} matching sections]`;
118
+ const body = snippets.map((s, i) => `--- Match ${i + 1} ---\n${s}`).join('\n\n');
119
+ const footer = vocabulary.length > 0
120
+ ? `\n[Searchable terms: ${vocabulary.slice(0, 20).join(', ')}]`
121
+ : '';
122
+ return `${header}\n\n${body}${footer}`;
123
+ }
124
+ /**
125
+ * Chunk content by markdown headings, blank-line-separated paragraphs, or fixed line count.
126
+ */
127
+ function chunkByStructure(content) {
128
+ const chunks = [];
129
+ // Try markdown heading splits first
130
+ const headingSplit = content.split(/^(?=#{1,4}\s)/m);
131
+ if (headingSplit.length > 2) {
132
+ for (const section of headingSplit) {
133
+ const trimmed = section.trim();
134
+ if (trimmed.length > 0)
135
+ chunks.push(trimmed);
136
+ }
137
+ return chunks;
138
+ }
139
+ // Try blank-line paragraph splits
140
+ const paragraphSplit = content.split(/\n\s*\n/);
141
+ if (paragraphSplit.length > 2) {
142
+ let current = '';
143
+ for (const para of paragraphSplit) {
144
+ const trimmed = para.trim();
145
+ if (!trimmed)
146
+ continue;
147
+ if (current.length + trimmed.length > 2000 && current.length > 0) {
148
+ chunks.push(current.trim());
149
+ current = trimmed;
150
+ }
151
+ else {
152
+ current += (current ? '\n\n' : '') + trimmed;
153
+ }
154
+ }
155
+ if (current.trim())
156
+ chunks.push(current.trim());
157
+ return chunks;
158
+ }
159
+ // Fall back to fixed-size line chunks
160
+ const lines = content.split('\n');
161
+ const chunkSize = Math.max(10, Math.ceil(lines.length / 20));
162
+ for (let i = 0; i < lines.length; i += chunkSize) {
163
+ const chunk = lines.slice(i, i + chunkSize).join('\n').trim();
164
+ if (chunk)
165
+ chunks.push(chunk);
166
+ }
167
+ return chunks;
168
+ }
169
+ function sanitizeFTS5Query(query) {
170
+ const words = query.trim().split(/\s+/).filter(w => w.length > 1);
171
+ if (words.length === 0)
172
+ return '""';
173
+ return words.map(w => `"${w.replace(/"/g, '""')}"`).join(' OR ');
174
+ }
175
+ /**
176
+ * Fallback keyword search when FTS5 match returns nothing.
177
+ */
178
+ function keywordSearch(chunks, intent) {
179
+ const keywords = intent.toLowerCase().split(/\s+/).filter(w => w.length > 2);
180
+ if (keywords.length === 0)
181
+ return [];
182
+ const scored = chunks.map(chunk => {
183
+ const lower = chunk.toLowerCase();
184
+ const score = keywords.reduce((sum, kw) => {
185
+ const matches = lower.split(kw).length - 1;
186
+ return sum + matches;
187
+ }, 0);
188
+ return { chunk, score };
189
+ });
190
+ return scored
191
+ .filter(s => s.score > 0)
192
+ .sort((a, b) => b.score - a.score)
193
+ .slice(0, MAX_SNIPPETS)
194
+ .map(s => s.chunk);
195
+ }
196
+ /**
197
+ * Extract high-signal vocabulary terms from chunks for follow-up queries.
198
+ */
199
+ function extractVocabulary(chunks) {
200
+ const wordFreq = new Map();
201
+ const stopWords = new Set([
202
+ 'the', 'a', 'an', 'is', 'are', 'was', 'were', 'be', 'been', 'being',
203
+ 'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'could',
204
+ 'should', 'may', 'might', 'shall', 'can', 'need', 'dare', 'ought',
205
+ 'used', 'to', 'of', 'in', 'for', 'on', 'with', 'at', 'by', 'from',
206
+ 'as', 'into', 'through', 'during', 'before', 'after', 'above', 'below',
207
+ 'and', 'but', 'or', 'nor', 'not', 'so', 'yet', 'both', 'either',
208
+ 'neither', 'each', 'every', 'all', 'any', 'few', 'more', 'most',
209
+ 'other', 'some', 'such', 'no', 'only', 'own', 'same', 'than',
210
+ 'too', 'very', 'just', 'because', 'this', 'that', 'these', 'those',
211
+ 'it', 'its', 'itself', 'they', 'them', 'their', 'what', 'which',
212
+ 'who', 'whom', 'how', 'when', 'where', 'why', 'if', 'then', 'else',
213
+ 'true', 'false', 'null', 'undefined', 'function', 'return', 'const',
214
+ 'let', 'var', 'import', 'export', 'default', 'class', 'new', 'type',
215
+ ]);
216
+ for (const chunk of chunks) {
217
+ const words = chunk.toLowerCase().match(/[a-z_][a-z0-9_-]{2,}/g) || [];
218
+ for (const word of words) {
219
+ if (!stopWords.has(word) && word.length >= 3) {
220
+ wordFreq.set(word, (wordFreq.get(word) || 0) + 1);
221
+ }
222
+ }
223
+ }
224
+ return Array.from(wordFreq.entries())
225
+ .filter(([_, count]) => count >= 2)
226
+ .sort((a, b) => b[1] - a[1])
227
+ .map(([word]) => word);
228
+ }
229
+ function formatBytes(bytes) {
230
+ if (bytes < 1024)
231
+ return `${bytes} B`;
232
+ if (bytes < 1024 * 1024)
233
+ return `${(bytes / 1024).toFixed(1)} KB`;
234
+ return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
235
+ }
236
+ //# sourceMappingURL=output-compressor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"output-compressor.js","sourceRoot":"","sources":["../../src/mcp-router/output-compressor.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,26 @@
1
+ /**
2
+ * Fuzzy Search for MCP Tools
3
+ * Uses Fuse.js for semantic-like matching
4
+ */
5
+ import type { ToolDefinition, ToolSearchResult } from '../types.js';
6
+ interface FuzzyOptions {
7
+ threshold?: number;
8
+ keys?: string[];
9
+ }
10
+ export declare class ToolSearchIndex {
11
+ private tools;
12
+ private options;
13
+ constructor(options?: FuzzyOptions);
14
+ addTools(tools: ToolDefinition[]): void;
15
+ clear(): void;
16
+ search(query: string, limit?: number): ToolSearchResult[];
17
+ searchByServer(serverName: string, limit?: number): ToolSearchResult[];
18
+ getAllTools(): ToolDefinition[];
19
+ getToolByPath(path: string): ToolDefinition | undefined;
20
+ getStats(): {
21
+ servers: number;
22
+ tools: number;
23
+ };
24
+ }
25
+ export {};
26
+ //# sourceMappingURL=fuzzy.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fuzzy.d.ts","sourceRoot":"","sources":["../../../src/mcp-router/search/fuzzy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAKpE,UAAU,YAAY;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AA+BD,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,OAAO,CAAe;gBAElB,OAAO,GAAE,YAAiB;IAOtC,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,IAAI;IAIvC,KAAK,IAAI,IAAI;IAIb,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,gBAAgB,EAAE;IA4BrD,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,gBAAgB,EAAE;IAalE,WAAW,IAAI,cAAc,EAAE;IAI/B,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAKvD,QAAQ,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;CAO/C"}
@@ -0,0 +1,94 @@
1
+ /**
2
+ * Fuzzy Search for MCP Tools
3
+ * Uses Fuse.js for semantic-like matching
4
+ */
5
+ function tokenize(str) {
6
+ return str.toLowerCase().split(/[\s_\-./]+/).filter(Boolean);
7
+ }
8
+ function calculateScore(query, target) {
9
+ const queryTokens = tokenize(query);
10
+ const targetTokens = tokenize(target);
11
+ if (queryTokens.length === 0 || targetTokens.length === 0)
12
+ return 0;
13
+ let matchCount = 0;
14
+ let partialMatches = 0;
15
+ for (const qToken of queryTokens) {
16
+ for (const tToken of targetTokens) {
17
+ if (tToken === qToken) {
18
+ matchCount++;
19
+ break;
20
+ }
21
+ else if (tToken.includes(qToken) || qToken.includes(tToken)) {
22
+ partialMatches += 0.5;
23
+ break;
24
+ }
25
+ }
26
+ }
27
+ const totalMatches = matchCount + partialMatches;
28
+ return totalMatches / queryTokens.length;
29
+ }
30
+ export class ToolSearchIndex {
31
+ tools = [];
32
+ options;
33
+ constructor(options = {}) {
34
+ this.options = {
35
+ threshold: options.threshold ?? 0.3,
36
+ keys: options.keys ?? ['name', 'description'],
37
+ };
38
+ }
39
+ addTools(tools) {
40
+ this.tools.push(...tools);
41
+ }
42
+ clear() {
43
+ this.tools = [];
44
+ }
45
+ search(query, limit = 10) {
46
+ const results = [];
47
+ for (const tool of this.tools) {
48
+ // Calculate score across all searchable fields
49
+ const nameScore = calculateScore(query, tool.name) * 1.5; // Weight name higher
50
+ const descScore = calculateScore(query, tool.description);
51
+ const serverScore = calculateScore(query, tool.serverName) * 0.5;
52
+ const score = Math.max(nameScore, descScore, serverScore);
53
+ if (score >= this.options.threshold) {
54
+ results.push({ tool, score });
55
+ }
56
+ }
57
+ // Sort by score descending
58
+ results.sort((a, b) => b.score - a.score);
59
+ return results.slice(0, limit).map(({ tool, score }) => ({
60
+ path: `${tool.serverName}.${tool.name}`,
61
+ name: tool.name,
62
+ description: tool.description,
63
+ server: tool.serverName,
64
+ score: Math.round(score * 100) / 100,
65
+ }));
66
+ }
67
+ searchByServer(serverName, limit = 50) {
68
+ return this.tools
69
+ .filter(t => t.serverName === serverName)
70
+ .slice(0, limit)
71
+ .map(tool => ({
72
+ path: `${tool.serverName}.${tool.name}`,
73
+ name: tool.name,
74
+ description: tool.description,
75
+ server: tool.serverName,
76
+ score: 1.0,
77
+ }));
78
+ }
79
+ getAllTools() {
80
+ return [...this.tools];
81
+ }
82
+ getToolByPath(path) {
83
+ const [serverName, toolName] = path.split('.');
84
+ return this.tools.find(t => t.serverName === serverName && t.name === toolName);
85
+ }
86
+ getStats() {
87
+ const servers = new Set(this.tools.map(t => t.serverName));
88
+ return {
89
+ servers: servers.size,
90
+ tools: this.tools.length,
91
+ };
92
+ }
93
+ }
94
+ //# sourceMappingURL=fuzzy.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fuzzy.js","sourceRoot":"","sources":["../../../src/mcp-router/search/fuzzy.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,50 @@
1
+ /**
2
+ * MCP Router Server
3
+ * Exposes 2 meta-tools: discover_tools and execute_tool
4
+ * Achieves 98%+ token reduction by hiding individual tool definitions
5
+ */
6
+ import { DISCOVER_TOOLS_DEFINITION } from './tools/discover.js';
7
+ import { EXECUTE_TOOL_DEFINITION } from './tools/execute.js';
8
+ import type { McpConfig, RouterStats } from './types.js';
9
+ export interface RouterOptions {
10
+ configPath?: string;
11
+ autoDiscover?: boolean;
12
+ verbose?: boolean;
13
+ }
14
+ export declare class McpRouter {
15
+ private config;
16
+ private searchIndex;
17
+ private clientPool;
18
+ private options;
19
+ private toolsLoaded;
20
+ constructor(options?: RouterOptions);
21
+ /**
22
+ * Load tools from all configured MCP servers
23
+ */
24
+ loadTools(): Promise<void>;
25
+ /**
26
+ * Get the 2 meta-tool definitions (for MCP tools/list)
27
+ */
28
+ getToolDefinitions(): Array<typeof DISCOVER_TOOLS_DEFINITION | typeof EXECUTE_TOOL_DEFINITION>;
29
+ /**
30
+ * Handle tool call
31
+ */
32
+ handleToolCall(name: string, args: unknown): Promise<unknown>;
33
+ /**
34
+ * Get router statistics
35
+ */
36
+ getStats(): RouterStats;
37
+ /**
38
+ * Shutdown - cleanup all connections
39
+ */
40
+ shutdown(): Promise<void>;
41
+ /**
42
+ * Get loaded config
43
+ */
44
+ getConfig(): McpConfig;
45
+ }
46
+ /**
47
+ * Run as stdio MCP server
48
+ */
49
+ export declare function runStdioServer(options?: RouterOptions): Promise<void>;
50
+ //# sourceMappingURL=server.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp-router/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EACL,yBAAyB,EAG1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,uBAAuB,EAGxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,SAAS,EAAkB,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzE,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,GAAE,aAAkB;IAkBvC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAuChC;;OAEG;IACH,kBAAkB,IAAI,KAAK,CAAC,OAAO,yBAAyB,GAAG,OAAO,uBAAuB,CAAC;IAI9F;;OAEG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAsBnE;;OAEG;IACH,QAAQ,IAAI,WAAW;IAsBvB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B;;OAEG;IACH,SAAS,IAAI,SAAS;CAGvB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsH/E"}
@@ -0,0 +1,229 @@
1
+ /**
2
+ * MCP Router Server
3
+ * Exposes 2 meta-tools: discover_tools and execute_tool
4
+ * Achieves 98%+ token reduction by hiding individual tool definitions
5
+ */
6
+ import { loadConfigFromPaths, loadConfigFromFile } from './config/parser.js';
7
+ import { ToolSearchIndex } from './search/fuzzy.js';
8
+ import { McpClient, McpClientPool } from './executor/client.js';
9
+ import { DISCOVER_TOOLS_DEFINITION, handleDiscoverTools, estimateDiscoverToolsTokens, } from './tools/discover.js';
10
+ import { EXECUTE_TOOL_DEFINITION, handleExecuteTool, estimateExecuteToolTokens, } from './tools/execute.js';
11
+ export class McpRouter {
12
+ config;
13
+ searchIndex;
14
+ clientPool;
15
+ options;
16
+ toolsLoaded = false;
17
+ constructor(options = {}) {
18
+ this.options = {
19
+ autoDiscover: true,
20
+ verbose: false,
21
+ ...options,
22
+ };
23
+ // Load config
24
+ if (options.configPath) {
25
+ this.config = loadConfigFromFile(options.configPath);
26
+ }
27
+ else {
28
+ this.config = loadConfigFromPaths();
29
+ }
30
+ this.searchIndex = new ToolSearchIndex({ threshold: 0.2 });
31
+ this.clientPool = new McpClientPool();
32
+ }
33
+ /**
34
+ * Load tools from all configured MCP servers
35
+ */
36
+ async loadTools() {
37
+ if (this.toolsLoaded)
38
+ return;
39
+ const servers = Object.entries(this.config.mcpServers);
40
+ if (this.options.verbose) {
41
+ console.error(`[router] Loading tools from ${servers.length} servers...`);
42
+ }
43
+ const allTools = [];
44
+ for (const [serverName, serverConfig] of servers) {
45
+ try {
46
+ const client = new McpClient(serverName, serverConfig);
47
+ await client.connect();
48
+ const tools = await client.listTools();
49
+ allTools.push(...tools);
50
+ client.disconnect();
51
+ if (this.options.verbose) {
52
+ console.error(`[router] ${serverName}: ${tools.length} tools`);
53
+ }
54
+ }
55
+ catch (error) {
56
+ if (this.options.verbose) {
57
+ console.error(`[router] ${serverName}: failed to load - ${error}`);
58
+ }
59
+ }
60
+ }
61
+ this.searchIndex.clear();
62
+ this.searchIndex.addTools(allTools);
63
+ this.toolsLoaded = true;
64
+ if (this.options.verbose) {
65
+ const stats = this.searchIndex.getStats();
66
+ console.error(`[router] Loaded ${stats.tools} tools from ${stats.servers} servers`);
67
+ }
68
+ }
69
+ /**
70
+ * Get the 2 meta-tool definitions (for MCP tools/list)
71
+ */
72
+ getToolDefinitions() {
73
+ return [DISCOVER_TOOLS_DEFINITION, EXECUTE_TOOL_DEFINITION];
74
+ }
75
+ /**
76
+ * Handle tool call
77
+ */
78
+ async handleToolCall(name, args) {
79
+ // Ensure tools are loaded
80
+ if (!this.toolsLoaded && this.options.autoDiscover) {
81
+ await this.loadTools();
82
+ }
83
+ switch (name) {
84
+ case 'discover_tools':
85
+ return handleDiscoverTools(args, this.searchIndex);
86
+ case 'execute_tool':
87
+ return handleExecuteTool(args, this.searchIndex, this.clientPool);
88
+ default:
89
+ throw new Error(`Unknown tool: ${name}`);
90
+ }
91
+ }
92
+ /**
93
+ * Get router statistics
94
+ */
95
+ getStats() {
96
+ const { servers, tools } = this.searchIndex.getStats();
97
+ // Estimate traditional token usage: ~500 tokens per tool
98
+ const traditionalTokens = tools * 500;
99
+ // Router uses only 2 tools
100
+ const routerTokens = estimateDiscoverToolsTokens() + estimateExecuteToolTokens();
101
+ const savings = traditionalTokens > 0
102
+ ? ((traditionalTokens - routerTokens) / traditionalTokens * 100).toFixed(1) + '%'
103
+ : '0%';
104
+ return {
105
+ totalServers: servers,
106
+ totalTools: tools,
107
+ traditionalTokens,
108
+ routerTokens,
109
+ savings,
110
+ };
111
+ }
112
+ /**
113
+ * Shutdown - cleanup all connections
114
+ */
115
+ async shutdown() {
116
+ await this.clientPool.disconnectAll();
117
+ }
118
+ /**
119
+ * Get loaded config
120
+ */
121
+ getConfig() {
122
+ return this.config;
123
+ }
124
+ }
125
+ /**
126
+ * Run as stdio MCP server
127
+ */
128
+ export async function runStdioServer(options = {}) {
129
+ const router = new McpRouter({ ...options, verbose: true });
130
+ let buffer = '';
131
+ function send(message) {
132
+ process.stdout.write(JSON.stringify(message) + '\n');
133
+ }
134
+ function handleMessage(message) {
135
+ const { id, method, params } = message;
136
+ switch (method) {
137
+ case 'initialize':
138
+ send({
139
+ jsonrpc: '2.0',
140
+ id,
141
+ result: {
142
+ protocolVersion: '2024-11-05',
143
+ capabilities: {
144
+ tools: {},
145
+ },
146
+ serverInfo: {
147
+ name: 'uap-mcp-router',
148
+ version: '1.0.0',
149
+ },
150
+ },
151
+ });
152
+ break;
153
+ case 'notifications/initialized':
154
+ // No response needed
155
+ break;
156
+ case 'tools/list':
157
+ send({
158
+ jsonrpc: '2.0',
159
+ id,
160
+ result: {
161
+ tools: router.getToolDefinitions(),
162
+ },
163
+ });
164
+ break;
165
+ case 'tools/call': {
166
+ const { name, arguments: args } = params;
167
+ router.handleToolCall(name, args)
168
+ .then(result => {
169
+ send({
170
+ jsonrpc: '2.0',
171
+ id,
172
+ result: {
173
+ content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
174
+ },
175
+ });
176
+ })
177
+ .catch(error => {
178
+ send({
179
+ jsonrpc: '2.0',
180
+ id,
181
+ error: {
182
+ code: -32000,
183
+ message: error instanceof Error ? error.message : String(error),
184
+ },
185
+ });
186
+ });
187
+ break;
188
+ }
189
+ default:
190
+ if (id !== undefined) {
191
+ send({
192
+ jsonrpc: '2.0',
193
+ id,
194
+ error: {
195
+ code: -32601,
196
+ message: `Method not found: ${method}`,
197
+ },
198
+ });
199
+ }
200
+ }
201
+ }
202
+ process.stdin.on('data', (data) => {
203
+ buffer += data.toString();
204
+ const lines = buffer.split('\n');
205
+ buffer = lines.pop() || '';
206
+ for (const line of lines) {
207
+ if (!line.trim())
208
+ continue;
209
+ try {
210
+ const message = JSON.parse(line);
211
+ handleMessage(message);
212
+ }
213
+ catch (e) {
214
+ console.error('[router] Invalid JSON:', e);
215
+ }
216
+ }
217
+ });
218
+ process.stdin.on('end', async () => {
219
+ await router.shutdown();
220
+ process.exit(0);
221
+ });
222
+ process.on('SIGINT', async () => {
223
+ await router.shutdown();
224
+ process.exit(0);
225
+ });
226
+ console.error('[router] MCP Router server started (stdio)');
227
+ console.error('[router] Exposing 2 tools: discover_tools, execute_tool');
228
+ }
229
+ //# sourceMappingURL=server.js.map