@duckmind/dm-darwin-x64 0.67.2 → 0.67.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (605) hide show
  1. package/README.md +2 -2
  2. package/dm +1 -1
  3. package/extensions/.dm-extensions.json +611 -13
  4. package/extensions/dm-lens/clients/dispatch/runners/utils/runner-helpers.js +1 -1
  5. package/extensions/dm-lens/dist/clients/actionable-warnings-logger.js +24 -0
  6. package/extensions/dm-lens/dist/clients/actionable-warnings.js +1066 -0
  7. package/extensions/dm-lens/dist/clients/advisory-provenance.js +388 -0
  8. package/extensions/dm-lens/dist/clients/agent-behavior-client.js +94 -0
  9. package/extensions/dm-lens/dist/clients/agent-nudge.js +253 -0
  10. package/extensions/dm-lens/dist/clients/analysed-root.js +1 -0
  11. package/extensions/dm-lens/dist/clients/analysis-root.js +133 -0
  12. package/extensions/dm-lens/dist/clients/ast-grep-client.js +587 -0
  13. package/extensions/dm-lens/dist/clients/ast-grep-rule-manager.js +137 -0
  14. package/extensions/dm-lens/dist/clients/ast-grep-tool-logger.js +85 -0
  15. package/extensions/dm-lens/dist/clients/ast-grep-types.js +1 -0
  16. package/extensions/dm-lens/dist/clients/ast-grep-yaml-synth.js +109 -0
  17. package/extensions/dm-lens/dist/clients/atomic-write-staging.js +66 -0
  18. package/extensions/dm-lens/dist/clients/atomic-write.js +37 -0
  19. package/extensions/dm-lens/dist/clients/availability-probe-flight.js +11 -0
  20. package/extensions/dm-lens/dist/clients/bash-file-access.js +1257 -0
  21. package/extensions/dm-lens/dist/clients/biome-client.js +223 -0
  22. package/extensions/dm-lens/dist/clients/blocker-freshness.js +553 -0
  23. package/extensions/dm-lens/dist/clients/blocker-past-eof.js +51 -0
  24. package/extensions/dm-lens/dist/clients/bootstrap.js +246 -0
  25. package/extensions/dm-lens/dist/clients/bounded-cache.js +105 -0
  26. package/extensions/dm-lens/dist/clients/bounded-pid-file-lock.js +275 -0
  27. package/extensions/dm-lens/dist/clients/bounded-telemetry.js +110 -0
  28. package/extensions/dm-lens/dist/clients/build-identity.js +45 -0
  29. package/extensions/dm-lens/dist/clients/bundled-resource-health.js +41 -0
  30. package/extensions/dm-lens/dist/clients/bus-events-logger.js +48 -0
  31. package/extensions/dm-lens/dist/clients/bus-publish.js +117 -0
  32. package/extensions/dm-lens/dist/clients/cache/rule-cache.js +87 -0
  33. package/extensions/dm-lens/dist/clients/cache-manager.js +449 -0
  34. package/extensions/dm-lens/dist/clients/cache-observability.js +1105 -0
  35. package/extensions/dm-lens/dist/clients/call-graph.js +628 -0
  36. package/extensions/dm-lens/dist/clients/cargo-manifest.js +167 -0
  37. package/extensions/dm-lens/dist/clients/cascade-budget.js +52 -0
  38. package/extensions/dm-lens/dist/clients/cascade-format.js +301 -0
  39. package/extensions/dm-lens/dist/clients/cascade-logger.js +22 -0
  40. package/extensions/dm-lens/dist/clients/cascade-types.js +1 -0
  41. package/extensions/dm-lens/dist/clients/child-unref.js +59 -0
  42. package/extensions/dm-lens/dist/clients/code-quality-warnings.js +192 -0
  43. package/extensions/dm-lens/dist/clients/codebase-model.js +110 -0
  44. package/extensions/dm-lens/dist/clients/collateral-test-role.js +8 -0
  45. package/extensions/dm-lens/dist/clients/complexity-client.js +398 -0
  46. package/extensions/dm-lens/dist/clients/config-core/deny.js +117 -0
  47. package/extensions/dm-lens/dist/clients/config-core/index.js +2 -0
  48. package/extensions/dm-lens/dist/clients/config-core/merge.js +228 -0
  49. package/extensions/dm-lens/dist/clients/config-core/normalize.js +226 -0
  50. package/extensions/dm-lens/dist/clients/config-core/process-spec.js +147 -0
  51. package/extensions/dm-lens/dist/clients/config-core/provenance.js +54 -0
  52. package/extensions/dm-lens/dist/clients/config-core/records.js +79 -0
  53. package/extensions/dm-lens/dist/clients/config-core/resolve.js +48 -0
  54. package/extensions/dm-lens/dist/clients/config-core/safe-object.js +22 -0
  55. package/extensions/dm-lens/dist/clients/config-core/schema.js +93 -0
  56. package/extensions/dm-lens/dist/clients/config-diagnostic-codes.js +90 -0
  57. package/extensions/dm-lens/dist/clients/config-locations.js +169 -0
  58. package/extensions/dm-lens/dist/clients/config-resolve.js +359 -0
  59. package/extensions/dm-lens/dist/clients/config-schema.js +230 -0
  60. package/extensions/dm-lens/dist/clients/config-warn.js +146 -0
  61. package/extensions/dm-lens/dist/clients/confirmed-delete.js +11 -0
  62. package/extensions/dm-lens/dist/clients/console-guard-install.js +4 -0
  63. package/extensions/dm-lens/dist/clients/content-stamp.js +16 -0
  64. package/extensions/dm-lens/dist/clients/context-injection-ledger.js +157 -0
  65. package/extensions/dm-lens/dist/clients/cooperative-budget.js +36 -0
  66. package/extensions/dm-lens/dist/clients/custom-rule-locations.js +28 -0
  67. package/extensions/dm-lens/dist/clients/dead-code-client.js +408 -0
  68. package/extensions/dm-lens/dist/clients/dead-code-logger.js +18 -0
  69. package/extensions/dm-lens/dist/clients/deadline-utils.js +117 -0
  70. package/extensions/dm-lens/dist/clients/debug-handles.js +121 -0
  71. package/extensions/dm-lens/dist/clients/debug-heap.js +80 -0
  72. package/extensions/dm-lens/dist/clients/deferred-lsp-work.js +33 -0
  73. package/extensions/dm-lens/dist/clients/deferred-runner-blockers.js +146 -0
  74. package/extensions/dm-lens/dist/clients/deferred-test-targets.js +31 -0
  75. package/extensions/dm-lens/dist/clients/degradation-ledger.js +306 -0
  76. package/extensions/dm-lens/dist/clients/demoted-finding-render.js +64 -0
  77. package/extensions/dm-lens/dist/clients/dependency-checker.js +534 -0
  78. package/extensions/dm-lens/dist/clients/deps/ast-grep-napi.js +27 -0
  79. package/extensions/dm-lens/dist/clients/deps/dm-host-deps.js +10 -0
  80. package/extensions/dm-lens/dist/clients/deps/dm-tui-compat.js +58 -0
  81. package/extensions/dm-lens/dist/clients/deps/js-yaml.js +7 -0
  82. package/extensions/dm-lens/dist/clients/deps/minimatch.js +6 -0
  83. package/extensions/dm-lens/dist/clients/deps/pidusage.js +5 -0
  84. package/extensions/dm-lens/dist/clients/deps/typebox.js +5 -0
  85. package/extensions/dm-lens/dist/clients/deps/vscode-jsonrpc.js +8 -0
  86. package/extensions/dm-lens/dist/clients/deps/web-tree-sitter.js +11 -0
  87. package/extensions/dm-lens/dist/clients/diagnostic-dispositions.js +334 -0
  88. package/extensions/dm-lens/dist/clients/diagnostic-line-freshness.js +142 -0
  89. package/extensions/dm-lens/dist/clients/diagnostic-logger.js +60 -0
  90. package/extensions/dm-lens/dist/clients/diagnostic-tracker.js +89 -0
  91. package/extensions/dm-lens/dist/clients/diagnostics-publish.js +134 -0
  92. package/extensions/dm-lens/dist/clients/disk-change-consumers.js +312 -0
  93. package/extensions/dm-lens/dist/clients/disk-change-subscribers.js +191 -0
  94. package/extensions/dm-lens/dist/clients/disk-changes.js +165 -0
  95. package/extensions/dm-lens/dist/clients/dispatch/adopted-root-runners.js +22 -0
  96. package/extensions/dm-lens/dist/clients/dispatch/ast-grep-catalog.js +16 -0
  97. package/extensions/dm-lens/dist/clients/dispatch/auxiliary-lsp.js +162 -0
  98. package/extensions/dm-lens/dist/clients/dispatch/collect-later-tier.js +25 -0
  99. package/extensions/dm-lens/dist/clients/dispatch/diagnostic-taxonomy.js +58 -0
  100. package/extensions/dm-lens/dist/clients/dispatch/dispatcher.js +1240 -0
  101. package/extensions/dm-lens/dist/clients/dispatch/fact-provider-types.js +1 -0
  102. package/extensions/dm-lens/dist/clients/dispatch/fact-rule-runner.js +17 -0
  103. package/extensions/dm-lens/dist/clients/dispatch/fact-runner.js +18 -0
  104. package/extensions/dm-lens/dist/clients/dispatch/fact-scheduler.js +52 -0
  105. package/extensions/dm-lens/dist/clients/dispatch/fact-store.js +193 -0
  106. package/extensions/dm-lens/dist/clients/dispatch/facts/comment-facts.js +23 -0
  107. package/extensions/dm-lens/dist/clients/dispatch/facts/file-content.js +18 -0
  108. package/extensions/dm-lens/dist/clients/dispatch/facts/function-facts.js +274 -0
  109. package/extensions/dm-lens/dist/clients/dispatch/facts/import-facts.js +169 -0
  110. package/extensions/dm-lens/dist/clients/dispatch/facts/tree-sitter-facts.js +19 -0
  111. package/extensions/dm-lens/dist/clients/dispatch/facts/try-catch-facts.js +95 -0
  112. package/extensions/dm-lens/dist/clients/dispatch/finding-policy.js +188 -0
  113. package/extensions/dm-lens/dist/clients/dispatch/indent-detect.js +227 -0
  114. package/extensions/dm-lens/dist/clients/dispatch/inline-suppressions.js +52 -0
  115. package/extensions/dm-lens/dist/clients/dispatch/integration.js +1698 -0
  116. package/extensions/dm-lens/dist/clients/dispatch/known-runner-ids.js +13 -0
  117. package/extensions/dm-lens/dist/clients/dispatch/lane-copies.js +23 -0
  118. package/extensions/dm-lens/dist/clients/dispatch/lazy.js +8 -0
  119. package/extensions/dm-lens/dist/clients/dispatch/pending-runner-findings.js +133 -0
  120. package/extensions/dm-lens/dist/clients/dispatch/plan.js +284 -0
  121. package/extensions/dm-lens/dist/clients/dispatch/pre-edit-seed.js +57 -0
  122. package/extensions/dm-lens/dist/clients/dispatch/priorities.js +14 -0
  123. package/extensions/dm-lens/dist/clients/dispatch/rule-id-normalize.js +54 -0
  124. package/extensions/dm-lens/dist/clients/dispatch/rule-ignores.js +21 -0
  125. package/extensions/dm-lens/dist/clients/dispatch/rule-policy.js +102 -0
  126. package/extensions/dm-lens/dist/clients/dispatch/rules/async-noise.js +31 -0
  127. package/extensions/dm-lens/dist/clients/dispatch/rules/async-unnecessary-wrapper.js +27 -0
  128. package/extensions/dm-lens/dist/clients/dispatch/rules/cors-wildcard.js +35 -0
  129. package/extensions/dm-lens/dist/clients/dispatch/rules/error-obscuring.js +29 -0
  130. package/extensions/dm-lens/dist/clients/dispatch/rules/error-swallowing.js +29 -0
  131. package/extensions/dm-lens/dist/clients/dispatch/rules/framework-call-noise.js +31 -0
  132. package/extensions/dm-lens/dist/clients/dispatch/rules/high-complexity.js +41 -0
  133. package/extensions/dm-lens/dist/clients/dispatch/rules/high-fan-out.js +37 -0
  134. package/extensions/dm-lens/dist/clients/dispatch/rules/high-import-coupling.js +31 -0
  135. package/extensions/dm-lens/dist/clients/dispatch/rules/missing-error-propagation.js +45 -0
  136. package/extensions/dm-lens/dist/clients/dispatch/rules/no-commented-credentials.js +46 -0
  137. package/extensions/dm-lens/dist/clients/dispatch/rules/pass-through-wrappers.js +38 -0
  138. package/extensions/dm-lens/dist/clients/dispatch/rules/placeholder-comments.js +40 -0
  139. package/extensions/dm-lens/dist/clients/dispatch/rules/unsafe-boundary.js +101 -0
  140. package/extensions/dm-lens/dist/clients/dispatch/runner-context.js +41 -0
  141. package/extensions/dm-lens/dist/clients/dispatch/runners/actionlint.js +98 -0
  142. package/extensions/dm-lens/dist/clients/dispatch/runners/ast-grep-literal-anchors.js +58 -0
  143. package/extensions/dm-lens/dist/clients/dispatch/runners/ast-grep-napi.js +739 -0
  144. package/extensions/dm-lens/dist/clients/dispatch/runners/biome-check.js +196 -0
  145. package/extensions/dm-lens/dist/clients/dispatch/runners/cpp-check.js +190 -0
  146. package/extensions/dm-lens/dist/clients/dispatch/runners/credo.js +66 -0
  147. package/extensions/dm-lens/dist/clients/dispatch/runners/cue-vet.js +161 -0
  148. package/extensions/dm-lens/dist/clients/dispatch/runners/dart-analyze.js +151 -0
  149. package/extensions/dm-lens/dist/clients/dispatch/runners/detekt.js +158 -0
  150. package/extensions/dm-lens/dist/clients/dispatch/runners/dotnet-build.js +163 -0
  151. package/extensions/dm-lens/dist/clients/dispatch/runners/elixir-check.js +153 -0
  152. package/extensions/dm-lens/dist/clients/dispatch/runners/eslint.js +99 -0
  153. package/extensions/dm-lens/dist/clients/dispatch/runners/fact-rules.js +20 -0
  154. package/extensions/dm-lens/dist/clients/dispatch/runners/fish-indent.js +120 -0
  155. package/extensions/dm-lens/dist/clients/dispatch/runners/gleam-check.js +100 -0
  156. package/extensions/dm-lens/dist/clients/dispatch/runners/go-vet.js +52 -0
  157. package/extensions/dm-lens/dist/clients/dispatch/runners/golangci-lint.js +105 -0
  158. package/extensions/dm-lens/dist/clients/dispatch/runners/hadolint.js +83 -0
  159. package/extensions/dm-lens/dist/clients/dispatch/runners/helm-lint.js +147 -0
  160. package/extensions/dm-lens/dist/clients/dispatch/runners/helm-render.js +593 -0
  161. package/extensions/dm-lens/dist/clients/dispatch/runners/htmlhint.js +103 -0
  162. package/extensions/dm-lens/dist/clients/dispatch/runners/index.js +100 -0
  163. package/extensions/dm-lens/dist/clients/dispatch/runners/javac.js +82 -0
  164. package/extensions/dm-lens/dist/clients/dispatch/runners/ktlint.js +115 -0
  165. package/extensions/dm-lens/dist/clients/dispatch/runners/lsp.js +275 -0
  166. package/extensions/dm-lens/dist/clients/dispatch/runners/markdownlint.js +129 -0
  167. package/extensions/dm-lens/dist/clients/dispatch/runners/mypy.js +70 -0
  168. package/extensions/dm-lens/dist/clients/dispatch/runners/oxlint.js +296 -0
  169. package/extensions/dm-lens/dist/clients/dispatch/runners/php-lint.js +66 -0
  170. package/extensions/dm-lens/dist/clients/dispatch/runners/phpstan.js +90 -0
  171. package/extensions/dm-lens/dist/clients/dispatch/runners/prisma-validate.js +66 -0
  172. package/extensions/dm-lens/dist/clients/dispatch/runners/psscriptanalyzer.js +307 -0
  173. package/extensions/dm-lens/dist/clients/dispatch/runners/pyright.js +118 -0
  174. package/extensions/dm-lens/dist/clients/dispatch/runners/rubocop.js +79 -0
  175. package/extensions/dm-lens/dist/clients/dispatch/runners/ruff.js +69 -0
  176. package/extensions/dm-lens/dist/clients/dispatch/runners/rust-clippy.js +166 -0
  177. package/extensions/dm-lens/dist/clients/dispatch/runners/shellcheck.js +168 -0
  178. package/extensions/dm-lens/dist/clients/dispatch/runners/shfmt.js +92 -0
  179. package/extensions/dm-lens/dist/clients/dispatch/runners/spellcheck.js +74 -0
  180. package/extensions/dm-lens/dist/clients/dispatch/runners/spotbugs.js +208 -0
  181. package/extensions/dm-lens/dist/clients/dispatch/runners/sqlfluff.js +136 -0
  182. package/extensions/dm-lens/dist/clients/dispatch/runners/stylelint.js +118 -0
  183. package/extensions/dm-lens/dist/clients/dispatch/runners/swiftlint.js +143 -0
  184. package/extensions/dm-lens/dist/clients/dispatch/runners/taplo.js +109 -0
  185. package/extensions/dm-lens/dist/clients/dispatch/runners/terragrunt.js +110 -0
  186. package/extensions/dm-lens/dist/clients/dispatch/runners/tflint.js +104 -0
  187. package/extensions/dm-lens/dist/clients/dispatch/runners/tree-sitter.js +534 -0
  188. package/extensions/dm-lens/dist/clients/dispatch/runners/trivy-config.js +155 -0
  189. package/extensions/dm-lens/dist/clients/dispatch/runners/utils/availability-policy.js +313 -0
  190. package/extensions/dm-lens/dist/clients/dispatch/runners/utils/candidate-probe.js +66 -0
  191. package/extensions/dm-lens/dist/clients/dispatch/runners/utils/diagnostic-parsers.js +62 -0
  192. package/extensions/dm-lens/dist/clients/dispatch/runners/utils/lazy-installer.js +130 -0
  193. package/extensions/dm-lens/dist/clients/dispatch/runners/utils/runner-helpers.js +1143 -0
  194. package/extensions/dm-lens/dist/clients/dispatch/runners/utils/spawn-outcome.js +40 -0
  195. package/extensions/dm-lens/dist/clients/dispatch/runners/utils/tool-failure.js +110 -0
  196. package/extensions/dm-lens/dist/clients/dispatch/runners/utils/toolchain-availability.js +88 -0
  197. package/extensions/dm-lens/dist/clients/dispatch/runners/utils.js +8 -0
  198. package/extensions/dm-lens/dist/clients/dispatch/runners/vale.js +92 -0
  199. package/extensions/dm-lens/dist/clients/dispatch/runners/yaml-rule-parser.js +170 -0
  200. package/extensions/dm-lens/dist/clients/dispatch/runners/yamllint.js +83 -0
  201. package/extensions/dm-lens/dist/clients/dispatch/runners/zig-check.js +72 -0
  202. package/extensions/dm-lens/dist/clients/dispatch/suppress-writer.js +57 -0
  203. package/extensions/dm-lens/dist/clients/dispatch/tool-profile.js +30 -0
  204. package/extensions/dm-lens/dist/clients/dispatch/types.js +72 -0
  205. package/extensions/dm-lens/dist/clients/dispatch/utils/format-utils.js +58 -0
  206. package/extensions/dm-lens/dist/clients/dispatch/utils/lsp-diagnostics.js +32 -0
  207. package/extensions/dm-lens/dist/clients/disposition-logger.js +19 -0
  208. package/extensions/dm-lens/dist/clients/disposition-publish.js +88 -0
  209. package/extensions/dm-lens/dist/clients/durable-store.js +77 -0
  210. package/extensions/dm-lens/dist/clients/effective-config.js +170 -0
  211. package/extensions/dm-lens/dist/clients/env-utils.js +26 -0
  212. package/extensions/dm-lens/dist/clients/ephemeral-root.js +55 -0
  213. package/extensions/dm-lens/dist/clients/error-class.js +3 -0
  214. package/extensions/dm-lens/dist/clients/eval-timestamp.js +2 -0
  215. package/extensions/dm-lens/dist/clients/event-loop-hold.js +119 -0
  216. package/extensions/dm-lens/dist/clients/event-loop-monitor.js +84 -0
  217. package/extensions/dm-lens/dist/clients/extension-log.js +230 -0
  218. package/extensions/dm-lens/dist/clients/extension-mode.js +20 -0
  219. package/extensions/dm-lens/dist/clients/feature-hints.js +88 -0
  220. package/extensions/dm-lens/dist/clients/file-kinds.js +317 -0
  221. package/extensions/dm-lens/dist/clients/file-mutation-queue.js +91 -0
  222. package/extensions/dm-lens/dist/clients/file-role.js +50 -0
  223. package/extensions/dm-lens/dist/clients/file-time.js +112 -0
  224. package/extensions/dm-lens/dist/clients/file-utils.js +840 -0
  225. package/extensions/dm-lens/dist/clients/finding-delivery-gate.js +146 -0
  226. package/extensions/dm-lens/dist/clients/finding-identity.js +79 -0
  227. package/extensions/dm-lens/dist/clients/fix-run-restore.js +423 -0
  228. package/extensions/dm-lens/dist/clients/fix-worklog.js +75 -0
  229. package/extensions/dm-lens/dist/clients/format-events-publish.js +310 -0
  230. package/extensions/dm-lens/dist/clients/format-service.js +177 -0
  231. package/extensions/dm-lens/dist/clients/formatters-lazy.js +8 -0
  232. package/extensions/dm-lens/dist/clients/formatters.js +1367 -0
  233. package/extensions/dm-lens/dist/clients/freshness-cadence.js +1 -0
  234. package/extensions/dm-lens/dist/clients/freshness.js +8 -0
  235. package/extensions/dm-lens/dist/clients/generated-artifacts.js +209 -0
  236. package/extensions/dm-lens/dist/clients/generation-guard.js +147 -0
  237. package/extensions/dm-lens/dist/clients/generation-lock.js +181 -0
  238. package/extensions/dm-lens/dist/clients/git-guard.js +1208 -0
  239. package/extensions/dm-lens/dist/clients/git-tracked-ignore.js +120 -0
  240. package/extensions/dm-lens/dist/clients/gitleaks-client.js +290 -0
  241. package/extensions/dm-lens/dist/clients/go-client.js +47 -0
  242. package/extensions/dm-lens/dist/clients/govulncheck-client.js +416 -0
  243. package/extensions/dm-lens/dist/clients/gradle-ktfmt-style.js +177 -0
  244. package/extensions/dm-lens/dist/clients/grammar-source.js +263 -0
  245. package/extensions/dm-lens/dist/clients/grammar-wasm-imports.js +48 -0
  246. package/extensions/dm-lens/dist/clients/gzip-stage-write.js +174 -0
  247. package/extensions/dm-lens/dist/clients/hard-failure-summary.js +28 -0
  248. package/extensions/dm-lens/dist/clients/hashline-anchor.js +222 -0
  249. package/extensions/dm-lens/dist/clients/hook-budgets.js +17 -0
  250. package/extensions/dm-lens/dist/clients/host-edit-normalize.js +87 -0
  251. package/extensions/dm-lens/dist/clients/host-ports.js +35 -0
  252. package/extensions/dm-lens/dist/clients/indent-retarget.js +102 -0
  253. package/extensions/dm-lens/dist/clients/inline-blocker-dispositions.js +103 -0
  254. package/extensions/dm-lens/dist/clients/inline-blocker-fields.js +8 -0
  255. package/extensions/dm-lens/dist/clients/install-diagnostics.js +135 -0
  256. package/extensions/dm-lens/dist/clients/installer/index.js +3928 -0
  257. package/extensions/dm-lens/dist/clients/installer/managed-tool-refresh-session.js +17 -0
  258. package/extensions/dm-lens/dist/clients/installer/managed-tool-refresh.js +721 -0
  259. package/extensions/dm-lens/dist/clients/instance-reaper-state.js +3 -0
  260. package/extensions/dm-lens/dist/clients/instance-reaper.js +693 -0
  261. package/extensions/dm-lens/dist/clients/instance-registry-lock.js +166 -0
  262. package/extensions/dm-lens/dist/clients/instance-registry-tail.js +17 -0
  263. package/extensions/dm-lens/dist/clients/instance-registry.js +607 -0
  264. package/extensions/dm-lens/dist/clients/io-bridge-contract.js +7 -0
  265. package/extensions/dm-lens/dist/clients/io-bridge.js +357 -0
  266. package/extensions/dm-lens/dist/clients/jscpd-client.js +311 -0
  267. package/extensions/dm-lens/dist/clients/json-cache-read.js +25 -0
  268. package/extensions/dm-lens/dist/clients/knip-client.js +534 -0
  269. package/extensions/dm-lens/dist/clients/knip-scan-roots.js +26 -0
  270. package/extensions/dm-lens/dist/clients/language-policy.js +244 -0
  271. package/extensions/dm-lens/dist/clients/language-profile.js +259 -0
  272. package/extensions/dm-lens/dist/clients/language-registry.js +468 -0
  273. package/extensions/dm-lens/dist/clients/latency-logger.js +210 -0
  274. package/extensions/dm-lens/dist/clients/lazy-import.js +14 -0
  275. package/extensions/dm-lens/dist/clients/ledger-bounds.js +21 -0
  276. package/extensions/dm-lens/dist/clients/lens-config.js +254 -0
  277. package/extensions/dm-lens/dist/clients/lens-engine.js +188 -0
  278. package/extensions/dm-lens/dist/clients/lens-events.js +105 -0
  279. package/extensions/dm-lens/dist/clients/lens-flag-registry.js +308 -0
  280. package/extensions/dm-lens/dist/clients/lens-map.js +980 -0
  281. package/extensions/dm-lens/dist/clients/line-alignment.js +200 -0
  282. package/extensions/dm-lens/dist/clients/live-bus-emitter.js +53 -0
  283. package/extensions/dm-lens/dist/clients/log-cleanup.js +138 -0
  284. package/extensions/dm-lens/dist/clients/lsp/aggregation.js +89 -0
  285. package/extensions/dm-lens/dist/clients/lsp/auxiliary-lifecycle.js +23 -0
  286. package/extensions/dm-lens/dist/clients/lsp/capabilities.js +94 -0
  287. package/extensions/dm-lens/dist/clients/lsp/cascade-tier.js +318 -0
  288. package/extensions/dm-lens/dist/clients/lsp/client-registry.js +877 -0
  289. package/extensions/dm-lens/dist/clients/lsp/client.js +3232 -0
  290. package/extensions/dm-lens/dist/clients/lsp/config.js +571 -0
  291. package/extensions/dm-lens/dist/clients/lsp/content-limits.js +21 -0
  292. package/extensions/dm-lens/dist/clients/lsp/content-scan.js +69 -0
  293. package/extensions/dm-lens/dist/clients/lsp/created-import-targets.js +134 -0
  294. package/extensions/dm-lens/dist/clients/lsp/diagnostic-binding.js +113 -0
  295. package/extensions/dm-lens/dist/clients/lsp/document-drift.js +372 -0
  296. package/extensions/dm-lens/dist/clients/lsp/edits.js +1060 -0
  297. package/extensions/dm-lens/dist/clients/lsp/environment-gap.js +186 -0
  298. package/extensions/dm-lens/dist/clients/lsp/file-server-match.js +26 -0
  299. package/extensions/dm-lens/dist/clients/lsp/grouping.js +38 -0
  300. package/extensions/dm-lens/dist/clients/lsp/implicit-scope.js +205 -0
  301. package/extensions/dm-lens/dist/clients/lsp/index.js +4292 -0
  302. package/extensions/dm-lens/dist/clients/lsp/inferred-project.js +140 -0
  303. package/extensions/dm-lens/dist/clients/lsp/jvm-runtime.js +200 -0
  304. package/extensions/dm-lens/dist/clients/lsp/language.js +26 -0
  305. package/extensions/dm-lens/dist/clients/lsp/launch.js +606 -0
  306. package/extensions/dm-lens/dist/clients/lsp/lombok.js +133 -0
  307. package/extensions/dm-lens/dist/clients/lsp/path-utils.js +1 -0
  308. package/extensions/dm-lens/dist/clients/lsp/pending-aux-coverage.js +120 -0
  309. package/extensions/dm-lens/dist/clients/lsp/position-encoding.js +21 -0
  310. package/extensions/dm-lens/dist/clients/lsp/resolved-config.js +183 -0
  311. package/extensions/dm-lens/dist/clients/lsp/ruby-drive-dirs.js +42 -0
  312. package/extensions/dm-lens/dist/clients/lsp/server-config-files.js +11 -0
  313. package/extensions/dm-lens/dist/clients/lsp/server-covers.js +8 -0
  314. package/extensions/dm-lens/dist/clients/lsp/server-traits.js +45 -0
  315. package/extensions/dm-lens/dist/clients/lsp/server.js +2827 -0
  316. package/extensions/dm-lens/dist/clients/lsp/service-singleton.js +59 -0
  317. package/extensions/dm-lens/dist/clients/lsp/session-roots.js +83 -0
  318. package/extensions/dm-lens/dist/clients/lsp/spawn-history.js +15 -0
  319. package/extensions/dm-lens/dist/clients/lsp/sync-kind.js +30 -0
  320. package/extensions/dm-lens/dist/clients/lsp/tsserver-sync.js +156 -0
  321. package/extensions/dm-lens/dist/clients/lsp/wait-policy/capability-snapshot.js +1 -0
  322. package/extensions/dm-lens/dist/clients/lsp/wait-policy/classification.js +37 -0
  323. package/extensions/dm-lens/dist/clients/lsp/wait-policy/index.js +3 -0
  324. package/extensions/dm-lens/dist/clients/lsp/wait-policy/strategies.js +276 -0
  325. package/extensions/dm-lens/dist/clients/lsp/watch-queue.js +61 -0
  326. package/extensions/dm-lens/dist/clients/lsp/workspace-diagnostics-cache.js +395 -0
  327. package/extensions/dm-lens/dist/clients/lsp/workspace-diagnostics-session.js +42 -0
  328. package/extensions/dm-lens/dist/clients/lsp/workspace-sweep-hold.js +93 -0
  329. package/extensions/dm-lens/dist/clients/lsp-budget.js +87 -0
  330. package/extensions/dm-lens/dist/clients/lsp-document-symbols.js +93 -0
  331. package/extensions/dm-lens/dist/clients/lsp-lazy.js +8 -0
  332. package/extensions/dm-lens/dist/clients/lsp-mutation.js +309 -0
  333. package/extensions/dm-lens/dist/clients/lsp-status.js +35 -0
  334. package/extensions/dm-lens/dist/clients/map-with-concurrency.js +20 -0
  335. package/extensions/dm-lens/dist/clients/mcp/analyze.js +302 -0
  336. package/extensions/dm-lens/dist/clients/mcp/host-shim.js +14 -0
  337. package/extensions/dm-lens/dist/clients/mcp/ipc.js +344 -0
  338. package/extensions/dm-lens/dist/clients/mcp/review.js +137 -0
  339. package/extensions/dm-lens/dist/clients/mcp/session.js +300 -0
  340. package/extensions/dm-lens/dist/clients/memory-sampler.js +163 -0
  341. package/extensions/dm-lens/dist/clients/message-end-attribution.js +18 -0
  342. package/extensions/dm-lens/dist/clients/metrics-client.js +80 -0
  343. package/extensions/dm-lens/dist/clients/metrics-history.js +242 -0
  344. package/extensions/dm-lens/dist/clients/middle-man-analysis.js +161 -0
  345. package/extensions/dm-lens/dist/clients/model-provider.js +31 -0
  346. package/extensions/dm-lens/dist/clients/module-report-lsp.js +140 -0
  347. package/extensions/dm-lens/dist/clients/module-report.js +1648 -0
  348. package/extensions/dm-lens/dist/clients/mutating-tool.js +388 -0
  349. package/extensions/dm-lens/dist/clients/mutation-attribution.js +173 -0
  350. package/extensions/dm-lens/dist/clients/mutation-bridge.js +231 -0
  351. package/extensions/dm-lens/dist/clients/ndjson-logger.js +504 -0
  352. package/extensions/dm-lens/dist/clients/observed-mutation-sources.js +43 -0
  353. package/extensions/dm-lens/dist/clients/observed-mutation.js +735 -0
  354. package/extensions/dm-lens/dist/clients/oldtext-autopatch.js +100 -0
  355. package/extensions/dm-lens/dist/clients/opaque-mutation-scan.js +541 -0
  356. package/extensions/dm-lens/dist/clients/opengrep-client.js +224 -0
  357. package/extensions/dm-lens/dist/clients/opengrep-config.js +57 -0
  358. package/extensions/dm-lens/dist/clients/opengrep-rule-pack.js +19 -0
  359. package/extensions/dm-lens/dist/clients/out-of-band-changes.js +329 -0
  360. package/extensions/dm-lens/dist/clients/package-manager.js +332 -0
  361. package/extensions/dm-lens/dist/clients/package-root.js +21 -0
  362. package/extensions/dm-lens/dist/clients/partial-edit-apply.js +341 -0
  363. package/extensions/dm-lens/dist/clients/path-attribution-telemetry.js +31 -0
  364. package/extensions/dm-lens/dist/clients/path-birth.js +58 -0
  365. package/extensions/dm-lens/dist/clients/path-keyed-map.js +57 -0
  366. package/extensions/dm-lens/dist/clients/path-utils.js +654 -0
  367. package/extensions/dm-lens/dist/clients/performance-report.js +291 -0
  368. package/extensions/dm-lens/dist/clients/persist-debounce.js +37 -0
  369. package/extensions/dm-lens/dist/clients/persist-worker-stats.js +16 -0
  370. package/extensions/dm-lens/dist/clients/persistent-reverify.js +167 -0
  371. package/extensions/dm-lens/dist/clients/php-cs-fixer-config.js +15 -0
  372. package/extensions/dm-lens/dist/clients/pipeline.js +1473 -0
  373. package/extensions/dm-lens/dist/clients/post-autofix-notice.js +19 -0
  374. package/extensions/dm-lens/dist/clients/print-mode.js +3 -0
  375. package/extensions/dm-lens/dist/clients/probe-home-state.js +73 -0
  376. package/extensions/dm-lens/dist/clients/process-bridge.js +48 -0
  377. package/extensions/dm-lens/dist/clients/process-singletons.js +69 -0
  378. package/extensions/dm-lens/dist/clients/process-snapshot.js +130 -0
  379. package/extensions/dm-lens/dist/clients/project-changes.js +180 -0
  380. package/extensions/dm-lens/dist/clients/project-conventions.js +152 -0
  381. package/extensions/dm-lens/dist/clients/project-diagnostics/cache.js +91 -0
  382. package/extensions/dm-lens/dist/clients/project-diagnostics/extractors.js +53 -0
  383. package/extensions/dm-lens/dist/clients/project-diagnostics/fresh-fetch.js +413 -0
  384. package/extensions/dm-lens/dist/clients/project-diagnostics/runner-adapters/call-graph-impact.js +64 -0
  385. package/extensions/dm-lens/dist/clients/project-diagnostics/runner-adapters/dead-code.js +38 -0
  386. package/extensions/dm-lens/dist/clients/project-diagnostics/runner-adapters/gitleaks.js +21 -0
  387. package/extensions/dm-lens/dist/clients/project-diagnostics/runner-adapters/govulncheck.js +23 -0
  388. package/extensions/dm-lens/dist/clients/project-diagnostics/runner-adapters/jscpd.js +28 -0
  389. package/extensions/dm-lens/dist/clients/project-diagnostics/runner-adapters/knip.js +45 -0
  390. package/extensions/dm-lens/dist/clients/project-diagnostics/runner-adapters/madge.js +34 -0
  391. package/extensions/dm-lens/dist/clients/project-diagnostics/runner-adapters/opengrep.js +32 -0
  392. package/extensions/dm-lens/dist/clients/project-diagnostics/runner-adapters/runner-findings.js +79 -0
  393. package/extensions/dm-lens/dist/clients/project-diagnostics/runner-adapters/trivy.js +41 -0
  394. package/extensions/dm-lens/dist/clients/project-diagnostics/scanner.js +351 -0
  395. package/extensions/dm-lens/dist/clients/project-diagnostics/types.js +1 -0
  396. package/extensions/dm-lens/dist/clients/project-lens-config.js +462 -0
  397. package/extensions/dm-lens/dist/clients/project-report.js +527 -0
  398. package/extensions/dm-lens/dist/clients/project-root-markers.js +8 -0
  399. package/extensions/dm-lens/dist/clients/project-scale.js +60 -0
  400. package/extensions/dm-lens/dist/clients/project-scan-policy.js +4 -0
  401. package/extensions/dm-lens/dist/clients/project-snapshot-fingerprint.js +44 -0
  402. package/extensions/dm-lens/dist/clients/project-snapshot-persist-worker.js +31 -0
  403. package/extensions/dm-lens/dist/clients/project-snapshot.js +1355 -0
  404. package/extensions/dm-lens/dist/clients/project-trust.js +104 -0
  405. package/extensions/dm-lens/dist/clients/python-environment.js +388 -0
  406. package/extensions/dm-lens/dist/clients/python-provenance.js +551 -0
  407. package/extensions/dm-lens/dist/clients/quiet-window-config.js +16 -0
  408. package/extensions/dm-lens/dist/clients/quiet-window.js +129 -0
  409. package/extensions/dm-lens/dist/clients/read-bridge.js +53 -0
  410. package/extensions/dm-lens/dist/clients/read-expansion.js +218 -0
  411. package/extensions/dm-lens/dist/clients/read-guard-branch.js +126 -0
  412. package/extensions/dm-lens/dist/clients/read-guard-logger.js +186 -0
  413. package/extensions/dm-lens/dist/clients/read-guard-tool-lines.js +1044 -0
  414. package/extensions/dm-lens/dist/clients/read-guard.js +1517 -0
  415. package/extensions/dm-lens/dist/clients/recent-touches.js +126 -0
  416. package/extensions/dm-lens/dist/clients/redact/secrets.js +386 -0
  417. package/extensions/dm-lens/dist/clients/resource-sampler.js +344 -0
  418. package/extensions/dm-lens/dist/clients/reverse-deps.js +227 -0
  419. package/extensions/dm-lens/dist/clients/review-graph/builder.js +3780 -0
  420. package/extensions/dm-lens/dist/clients/review-graph/format.js +30 -0
  421. package/extensions/dm-lens/dist/clients/review-graph/git-identity.js +173 -0
  422. package/extensions/dm-lens/dist/clients/review-graph/import-resolvers.js +332 -0
  423. package/extensions/dm-lens/dist/clients/review-graph/persist-worker.js +8 -0
  424. package/extensions/dm-lens/dist/clients/review-graph/query.js +195 -0
  425. package/extensions/dm-lens/dist/clients/review-graph/revision-drift.js +3 -0
  426. package/extensions/dm-lens/dist/clients/review-graph/service.js +60 -0
  427. package/extensions/dm-lens/dist/clients/review-graph/shared-extraction-ir.js +54 -0
  428. package/extensions/dm-lens/dist/clients/review-graph/symbol-id.js +29 -0
  429. package/extensions/dm-lens/dist/clients/review-graph/tsconfig-paths.js +286 -0
  430. package/extensions/dm-lens/dist/clients/review-graph/types.js +1 -0
  431. package/extensions/dm-lens/dist/clients/review-graph/workspace-modules.js +374 -0
  432. package/extensions/dm-lens/dist/clients/review-graph-logger.js +51 -0
  433. package/extensions/dm-lens/dist/clients/ruff-client.js +107 -0
  434. package/extensions/dm-lens/dist/clients/rules-scanner.js +70 -0
  435. package/extensions/dm-lens/dist/clients/run-duration.js +9 -0
  436. package/extensions/dm-lens/dist/clients/runtime-agent-end.js +831 -0
  437. package/extensions/dm-lens/dist/clients/runtime-config.js +39 -0
  438. package/extensions/dm-lens/dist/clients/runtime-context.js +155 -0
  439. package/extensions/dm-lens/dist/clients/runtime-coordinator.js +1254 -0
  440. package/extensions/dm-lens/dist/clients/runtime-session.js +1806 -0
  441. package/extensions/dm-lens/dist/clients/runtime-tool-call.js +1026 -0
  442. package/extensions/dm-lens/dist/clients/runtime-tool-result.js +2068 -0
  443. package/extensions/dm-lens/dist/clients/runtime-turn.js +3198 -0
  444. package/extensions/dm-lens/dist/clients/rust-client.js +46 -0
  445. package/extensions/dm-lens/dist/clients/safe-spawn.js +1402 -0
  446. package/extensions/dm-lens/dist/clients/sanitize.js +5 -0
  447. package/extensions/dm-lens/dist/clients/scan-utils.js +7 -0
  448. package/extensions/dm-lens/dist/clients/scanner-temp-root.js +8 -0
  449. package/extensions/dm-lens/dist/clients/scratch-tree-policy.js +63 -0
  450. package/extensions/dm-lens/dist/clients/search-read-registration.js +76 -0
  451. package/extensions/dm-lens/dist/clients/secret-findings.js +69 -0
  452. package/extensions/dm-lens/dist/clients/security-scan-client.js +208 -0
  453. package/extensions/dm-lens/dist/clients/session-event-guard.js +111 -0
  454. package/extensions/dm-lens/dist/clients/session-lifecycle.js +309 -0
  455. package/extensions/dm-lens/dist/clients/session-repository.js +113 -0
  456. package/extensions/dm-lens/dist/clients/session-scope.js +451 -0
  457. package/extensions/dm-lens/dist/clients/session-start-observability.js +59 -0
  458. package/extensions/dm-lens/dist/clients/session-state-store.js +71 -0
  459. package/extensions/dm-lens/dist/clients/session-summary.js +8 -0
  460. package/extensions/dm-lens/dist/clients/sessionstart-logger.js +22 -0
  461. package/extensions/dm-lens/dist/clients/sg-runner.js +642 -0
  462. package/extensions/dm-lens/dist/clients/sgconfig.js +299 -0
  463. package/extensions/dm-lens/dist/clients/shared-checkout-guard.js +177 -0
  464. package/extensions/dm-lens/dist/clients/single-flight.js +53 -0
  465. package/extensions/dm-lens/dist/clients/situational-tool-telemetry.js +85 -0
  466. package/extensions/dm-lens/dist/clients/skills-resolver.js +38 -0
  467. package/extensions/dm-lens/dist/clients/slow-fs.js +77 -0
  468. package/extensions/dm-lens/dist/clients/smells-rollup.js +118 -0
  469. package/extensions/dm-lens/dist/clients/source-filter.js +323 -0
  470. package/extensions/dm-lens/dist/clients/source-walker.js +114 -0
  471. package/extensions/dm-lens/dist/clients/spawn-output-cap.js +35 -0
  472. package/extensions/dm-lens/dist/clients/spawn-timeout-cooldown.js +51 -0
  473. package/extensions/dm-lens/dist/clients/stale-marker.js +1 -0
  474. package/extensions/dm-lens/dist/clients/startup-scan.js +221 -0
  475. package/extensions/dm-lens/dist/clients/startup-timing.js +67 -0
  476. package/extensions/dm-lens/dist/clients/string-utils.js +6 -0
  477. package/extensions/dm-lens/dist/clients/subagent-mode.js +40 -0
  478. package/extensions/dm-lens/dist/clients/symbol-containment.js +16 -0
  479. package/extensions/dm-lens/dist/clients/symbol-types.js +1 -0
  480. package/extensions/dm-lens/dist/clients/test-runner-client.js +1686 -0
  481. package/extensions/dm-lens/dist/clients/test-runner-delivery.js +285 -0
  482. package/extensions/dm-lens/dist/clients/test-target-roots.js +17 -0
  483. package/extensions/dm-lens/dist/clients/todo-scanner.js +164 -0
  484. package/extensions/dm-lens/dist/clients/tool-agreement.js +640 -0
  485. package/extensions/dm-lens/dist/clients/tool-config.js +239 -0
  486. package/extensions/dm-lens/dist/clients/tool-cwd.js +236 -0
  487. package/extensions/dm-lens/dist/clients/tool-definition.js +22 -0
  488. package/extensions/dm-lens/dist/clients/tool-event.js +24 -0
  489. package/extensions/dm-lens/dist/clients/tool-policy.js +2386 -0
  490. package/extensions/dm-lens/dist/clients/tool-probe.js +13 -0
  491. package/extensions/dm-lens/dist/clients/tool-render.js +79 -0
  492. package/extensions/dm-lens/dist/clients/tool-set-policy.js +106 -0
  493. package/extensions/dm-lens/dist/clients/tree-sitter-cache.js +206 -0
  494. package/extensions/dm-lens/dist/clients/tree-sitter-client.js +3101 -0
  495. package/extensions/dm-lens/dist/clients/tree-sitter-logger.js +77 -0
  496. package/extensions/dm-lens/dist/clients/tree-sitter-navigator.js +198 -0
  497. package/extensions/dm-lens/dist/clients/tree-sitter-query-loader.js +401 -0
  498. package/extensions/dm-lens/dist/clients/tree-sitter-shared.js +87 -0
  499. package/extensions/dm-lens/dist/clients/tree-sitter-symbol-extractor.js +984 -0
  500. package/extensions/dm-lens/dist/clients/trivy-client.js +335 -0
  501. package/extensions/dm-lens/dist/clients/tui-fit.js +26 -0
  502. package/extensions/dm-lens/dist/clients/turn-context.js +48 -0
  503. package/extensions/dm-lens/dist/clients/turn-end/delivery-holds.js +59 -0
  504. package/extensions/dm-lens/dist/clients/turn-end/lane.js +1 -0
  505. package/extensions/dm-lens/dist/clients/turn-end/lanes/govulncheck.js +54 -0
  506. package/extensions/dm-lens/dist/clients/turn-end/lanes/secrets.js +131 -0
  507. package/extensions/dm-lens/dist/clients/turn-summary-render.js +56 -0
  508. package/extensions/dm-lens/dist/clients/turn-summary.js +84 -0
  509. package/extensions/dm-lens/dist/clients/typos-config.js +9 -0
  510. package/extensions/dm-lens/dist/clients/user-notify.js +15 -0
  511. package/extensions/dm-lens/dist/clients/vanished-instance-marker.js +18 -0
  512. package/extensions/dm-lens/dist/clients/warm-attach.js +232 -0
  513. package/extensions/dm-lens/dist/clients/widget-state.js +1014 -0
  514. package/extensions/dm-lens/dist/clients/word-index-logger.js +24 -0
  515. package/extensions/dm-lens/dist/clients/word-index-store.js +222 -0
  516. package/extensions/dm-lens/dist/clients/word-index.js +1503 -0
  517. package/extensions/dm-lens/dist/clients/workspace-topology.js +274 -0
  518. package/extensions/dm-lens/dist/clients/write-ordering-guard.js +28 -0
  519. package/extensions/dm-lens/dist/clients/zizmor-config.js +160 -0
  520. package/extensions/dm-lens/dist/i18n.js +67 -0
  521. package/extensions/dm-lens/dist/index.js +2144 -0
  522. package/extensions/dm-lens/dist/mcp/analyze-cli.js +205 -0
  523. package/extensions/dm-lens/dist/mcp/build-staleness.js +55 -0
  524. package/extensions/dm-lens/dist/mcp/cli.js +96 -0
  525. package/extensions/dm-lens/dist/mcp/server.js +1241 -0
  526. package/extensions/dm-lens/dist/mcp/tool-arguments.js +134 -0
  527. package/extensions/dm-lens/dist/mcp/worker.js +41 -0
  528. package/extensions/dm-lens/dist/scripts/lib/process-scan.mjs +375 -0
  529. package/extensions/dm-lens/dist/scripts/lib/skills-predicate.mjs +53 -0
  530. package/extensions/dm-lens/dist/scripts/lib/web-tree-sitter-dir.mjs +51 -0
  531. package/extensions/dm-lens/dist/tools/activate-tools.js +63 -0
  532. package/extensions/dm-lens/dist/tools/ast-grep-outline.js +128 -0
  533. package/extensions/dm-lens/dist/tools/ast-grep-replace.js +234 -0
  534. package/extensions/dm-lens/dist/tools/ast-grep-search.js +690 -0
  535. package/extensions/dm-lens/dist/tools/effective-config.js +59 -0
  536. package/extensions/dm-lens/dist/tools/lens-diagnostic-mark.js +251 -0
  537. package/extensions/dm-lens/dist/tools/lens-diagnostics.js +1693 -0
  538. package/extensions/dm-lens/dist/tools/lsp-diagnostics.js +1397 -0
  539. package/extensions/dm-lens/dist/tools/lsp-navigation.js +1301 -0
  540. package/extensions/dm-lens/dist/tools/lsp-structured-output.js +277 -0
  541. package/extensions/dm-lens/dist/tools/module-report.js +333 -0
  542. package/extensions/dm-lens/dist/tools/project-report.js +72 -0
  543. package/extensions/dm-lens/dist/tools/render-compact.js +272 -0
  544. package/extensions/dm-lens/dist/tools/scan-progress.js +31 -0
  545. package/extensions/dm-lens/dist/tools/shared.js +46 -0
  546. package/extensions/dm-lens/dist/tools/symbol-search.js +133 -0
  547. package/extensions/dm-mcp-adapter/dist/abort.js +35 -0
  548. package/extensions/dm-mcp-adapter/dist/agent-dir.js +45 -0
  549. package/extensions/dm-mcp-adapter/dist/agent-plugin-loader.js +392 -0
  550. package/extensions/dm-mcp-adapter/dist/agent-plugin-provenance.js +26 -0
  551. package/extensions/dm-mcp-adapter/dist/bearer-command-resolver.js +184 -0
  552. package/extensions/dm-mcp-adapter/dist/claude-plugin-loader.js +350 -0
  553. package/extensions/dm-mcp-adapter/dist/config.js +1984 -0
  554. package/extensions/dm-mcp-adapter/dist/consent-manager.js +84 -0
  555. package/extensions/dm-mcp-adapter/dist/elicitation-handler.js +374 -0
  556. package/extensions/dm-mcp-adapter/dist/errors.js +225 -0
  557. package/extensions/dm-mcp-adapter/dist/extraction-settings.js +43 -0
  558. package/extensions/dm-mcp-adapter/dist/http-ca.js +75 -0
  559. package/extensions/dm-mcp-adapter/dist/jev-client.js +359 -0
  560. package/extensions/dm-mcp-adapter/dist/jev-contracts.js +1 -0
  561. package/extensions/dm-mcp-adapter/dist/jev-key-store.js +189 -0
  562. package/extensions/dm-mcp-adapter/dist/json-schema-validator.js +70 -0
  563. package/extensions/dm-mcp-adapter/dist/lifecycle.js +387 -0
  564. package/extensions/dm-mcp-adapter/dist/logger.js +115 -0
  565. package/extensions/dm-mcp-adapter/dist/mcp-auth-fetch.js +86 -0
  566. package/extensions/dm-mcp-adapter/dist/mcp-auth-flow.js +956 -0
  567. package/extensions/dm-mcp-adapter/dist/mcp-auth.js +998 -0
  568. package/extensions/dm-mcp-adapter/dist/mcp-bearer-store.js +182 -0
  569. package/extensions/dm-mcp-adapter/dist/mcp-callback-server.js +380 -0
  570. package/extensions/dm-mcp-adapter/dist/mcp-oauth-provider.js +525 -0
  571. package/extensions/dm-mcp-adapter/dist/mcp-probe.js +151 -0
  572. package/extensions/dm-mcp-adapter/dist/mcp-tasks.js +339 -0
  573. package/extensions/dm-mcp-adapter/dist/mcp-trace.js +220 -0
  574. package/extensions/dm-mcp-adapter/dist/metadata-cache.js +411 -0
  575. package/extensions/dm-mcp-adapter/dist/npx-resolver.js +465 -0
  576. package/extensions/dm-mcp-adapter/dist/output-shape.js +312 -0
  577. package/extensions/dm-mcp-adapter/dist/package-mcp-loader.js +144 -0
  578. package/extensions/dm-mcp-adapter/dist/project-server-trust.js +274 -0
  579. package/extensions/dm-mcp-adapter/dist/request-headers-command.js +310 -0
  580. package/extensions/dm-mcp-adapter/dist/resource-tools.js +7 -0
  581. package/extensions/dm-mcp-adapter/dist/runtime-owner.js +95 -0
  582. package/extensions/dm-mcp-adapter/dist/sampling-handler.js +219 -0
  583. package/extensions/dm-mcp-adapter/dist/script-tools.js +72 -0
  584. package/extensions/dm-mcp-adapter/dist/secure-keyring.js +191 -0
  585. package/extensions/dm-mcp-adapter/dist/semantic-settings.js +51 -0
  586. package/extensions/dm-mcp-adapter/dist/server-log.js +19 -0
  587. package/extensions/dm-mcp-adapter/dist/server-manager.js +1635 -0
  588. package/extensions/dm-mcp-adapter/dist/session-approvals.js +127 -0
  589. package/extensions/dm-mcp-adapter/dist/session-recovery.js +83 -0
  590. package/extensions/dm-mcp-adapter/dist/state.js +1 -0
  591. package/extensions/dm-mcp-adapter/dist/task-entries.js +60 -0
  592. package/extensions/dm-mcp-adapter/dist/task-jobs.js +259 -0
  593. package/extensions/dm-mcp-adapter/dist/ts-shape.js +157 -0
  594. package/extensions/dm-mcp-adapter/dist/types.js +293 -0
  595. package/extensions/dm-mcp-adapter/dist/ui-app-bridge-helpers.js +36 -0
  596. package/extensions/dm-mcp-adapter/dist/ui-resource-handler.js +204 -0
  597. package/extensions/dm-mcp-adapter/dist/ui-stream-types.js +58 -0
  598. package/extensions/dm-mcp-adapter/dist/ui-tool-visibility.js +26 -0
  599. package/extensions/dm-mcp-adapter/dist/unix-socket-transport.js +83 -0
  600. package/extensions/dm-mcp-adapter/dist/utils.js +444 -0
  601. package/extensions/dm-mcp-adapter/mcp-keyring-helper.cjs +1 -1
  602. package/extensions/dm-ponytail/hooks/ponytail-activate.js +1 -1
  603. package/extensions/dm-ponytail/hooks/ponytail-instructions.js +1 -1
  604. package/extensions/dm-ponytail/hooks/ponytail-mode-tracker.js +1 -1
  605. package/package.json +1 -1
@@ -0,0 +1,1635 @@
1
+ import { mkdirSync, statSync } from "node:fs";
2
+ import { BlockList, isIP } from "node:net";
3
+ import { basename } from "node:path";
4
+ import { pathToFileURL } from "node:url";
5
+ import { isDeepStrictEqual } from "node:util";
6
+ import { Client, SdkError, SdkErrorCode, SdkHttpError, SseError, SSEClientTransport, StreamableHTTPClientTransport, UnauthorizedError, RegistrationRejectedError } from "@modelcontextprotocol/client";
7
+ import { StdioClientTransport } from "@modelcontextprotocol/client/stdio";
8
+ import { UnixSocketClientTransport } from "./unix-socket-transport.js";
9
+ import { probeMcpEndpoint } from "./mcp-probe.js";
10
+ import { isServerDisabled, SERVER_STREAM_RESULT_PATCH_METHOD, serverStreamResultPatchNotificationSchema } from "./types.js";
11
+ import { resolveNpxBinary } from "./npx-resolver.js";
12
+ import { createJsonSchemaValidator } from "./json-schema-validator.js";
13
+ import { logger } from "./logger.js";
14
+ import { RESOURCE_MIME_TYPE } from "./ui-app-bridge-helpers.js";
15
+ import { isBuiltInAgentPlugin } from "./agent-plugin-provenance.js";
16
+ import { McpOAuthProvider } from "./mcp-oauth-provider.js";
17
+ import { explainRegistrationRejection, extractOAuthConfig, supportsOAuth } from "./mcp-auth-flow.js";
18
+ import { captureOAuthAuthority, inspectAuthForUrl, invalidateAuthEntryCache } from "./mcp-auth.js";
19
+ import { getBearerTokenForUrl } from "./mcp-bearer-store.js";
20
+ import { handleSamplingRequest, registerSamplingHandler } from "./sampling-handler.js";
21
+ import { appendServerLogMessage } from "./server-log.js";
22
+ import { getAgentPath } from "./agent-dir.js";
23
+ import { handleElicitationRequest, handleFormElicitation, handleUrlElicitation, registerElicitationHandler, whileAdapterPromptOpen } from "./elicitation-handler.js";
24
+ import { attachTaskSession } from "./mcp-tasks.js";
25
+ import { interpolateEnvVars, expandHomePath, providerAuthUrlError, resolveBearerToken, resolveCommandSecretsRecord, resolveConfigPath, resolveServerUrl } from "./utils.js";
26
+ import { abortable, throwIfAborted } from "./abort.js";
27
+ import { combineAbortSignals } from "./runtime-owner.js";
28
+ import { createMcpTraceWriter, isMcpTraceEnabled, traceTransportKind, wrapTransportWithMcpTrace } from "./mcp-trace.js";
29
+ import { createOAuthFetch, resolveOAuthHeaders } from "./mcp-auth-fetch.js";
30
+ import { createRequestHeadersCommandFetch } from "./request-headers-command.js";
31
+ import { createCaFetch, validateCaFile } from "./http-ca.js";
32
+ import { BearerCommandResolver } from "./bearer-command-resolver.js";
33
+ const MAX_CAPTURED_STDERR_BYTES = 8 * 1024;
34
+ const MAX_CAPTURED_STDERR_LINES = 3;
35
+ const abortCleanupPromises = new WeakMap;
36
+ function isLiteralLocalAddress(url) {
37
+ const hostname = new URL(url).hostname.replace(/^\[|\]$/g, "");
38
+ const family = isIP(hostname);
39
+ if (!family)
40
+ return false;
41
+ const local = new BlockList;
42
+ local.addSubnet("10.0.0.0", 8);
43
+ local.addSubnet("172.16.0.0", 12);
44
+ local.addSubnet("192.168.0.0", 16);
45
+ local.addSubnet("169.254.0.0", 16);
46
+ local.addSubnet("fc00::", 7, "ipv6");
47
+ local.addSubnet("fe80::", 10, "ipv6");
48
+ return local.check(hostname, family === 6 ? "ipv6" : "ipv4");
49
+ }
50
+ function isLoopbackUrl(url) {
51
+ return ["localhost", "127.0.0.1", "[::1]"].includes(new URL(url).hostname);
52
+ }
53
+ const LOCAL_NETWORK_FAILURE_CODES = ["EHOSTUNREACH", "ENETUNREACH", "EACCES"];
54
+ function networkFailureCodes(error, wanted, seen = new Set) {
55
+ if (typeof error !== "object" || error === null || seen.has(error))
56
+ return [];
57
+ seen.add(error);
58
+ const codes = [];
59
+ if ("code" in error && typeof error.code === "string" && wanted.includes(error.code)) {
60
+ codes.push(error.code);
61
+ }
62
+ if ("cause" in error)
63
+ codes.push(...networkFailureCodes(error.cause, wanted, seen));
64
+ if (error instanceof SdkError && typeof error.data === "object" && error.data !== null && "cause" in error.data) {
65
+ codes.push(...networkFailureCodes(error.data.cause, wanted, seen));
66
+ }
67
+ if (error instanceof AggregateError) {
68
+ for (const nested of error.errors)
69
+ codes.push(...networkFailureCodes(nested, wanted, seen));
70
+ }
71
+ return [...new Set(codes)];
72
+ }
73
+ export function isUnauthorizedHttpError(error) {
74
+ return error instanceof UnauthorizedError || error instanceof SdkHttpError && error.status === 401 || error instanceof Error && /^Error POSTing to endpoint \(HTTP 401\):/.test(error.message);
75
+ }
76
+ function shouldFallbackToSse(error, definition) {
77
+ if (definition.protocolVersion === "2026-07-28")
78
+ return false;
79
+ return error instanceof SdkHttpError && [404, 405, 406, 415].includes(error.status);
80
+ }
81
+ function resolveVersionNegotiation(definition) {
82
+ switch (definition.protocolVersion) {
83
+ case undefined:
84
+ case "legacy":
85
+ return;
86
+ case "auto":
87
+ return { mode: "auto" };
88
+ case "2026-07-28":
89
+ return { mode: { pin: "2026-07-28" } };
90
+ default:
91
+ throw new Error(`Invalid MCP protocolVersion: ${String(definition.protocolVersion)}`);
92
+ }
93
+ }
94
+ function boundedStderrChunk(chunk) {
95
+ if (Buffer.isBuffer(chunk)) {
96
+ const start = Math.max(0, chunk.byteLength - MAX_CAPTURED_STDERR_BYTES);
97
+ return Buffer.from(chunk.subarray(start));
98
+ }
99
+ const suffix = chunk.length > MAX_CAPTURED_STDERR_BYTES ? chunk.slice(-MAX_CAPTURED_STDERR_BYTES) : chunk;
100
+ const bytes = Buffer.from(suffix, "utf8");
101
+ return bytes.byteLength > MAX_CAPTURED_STDERR_BYTES ? Buffer.from(bytes.subarray(bytes.byteLength - MAX_CAPTURED_STDERR_BYTES)) : bytes;
102
+ }
103
+ function appendStderrTail(tail, chunk) {
104
+ const bytes = boundedStderrChunk(chunk);
105
+ if (bytes.length === 0)
106
+ return tail;
107
+ if (tail.length === 0)
108
+ return bytes;
109
+ const combined = Buffer.concat([tail, bytes]);
110
+ return combined.length > MAX_CAPTURED_STDERR_BYTES ? Buffer.from(combined.subarray(combined.length - MAX_CAPTURED_STDERR_BYTES)) : combined;
111
+ }
112
+
113
+ class AdapterClient extends Client {
114
+ requestMetadata() {
115
+ return this._outboundMetaEnvelope();
116
+ }
117
+ }
118
+ const clientMetadata = new WeakMap;
119
+ const KEEP_ALIVE_REFRESH_TIMEOUT_MS = 5000;
120
+ const LISTEN_RETRY_DELAY_MS = 5000;
121
+ const RECENT_RESOURCE_TTL_MS = 10 * 60000;
122
+ const MAX_RESOURCE_SUBSCRIPTIONS = 32;
123
+ export function isTransientHttpConnectError(error) {
124
+ let current = error;
125
+ while (current instanceof Error) {
126
+ if (current instanceof SdkHttpError && current.status === 503)
127
+ return true;
128
+ current = current.cause;
129
+ }
130
+ return false;
131
+ }
132
+ function forwardInit(input, init, request, overrides = {}) {
133
+ const signal = init?.signal ?? (input instanceof Request ? input.signal : request.signal);
134
+ return [request.url, {
135
+ method: request.method,
136
+ headers: request.headers,
137
+ body: request.body,
138
+ cache: request.cache,
139
+ credentials: request.credentials,
140
+ integrity: request.integrity,
141
+ keepalive: request.keepalive,
142
+ mode: request.mode,
143
+ redirect: request.redirect,
144
+ referrer: request.referrer,
145
+ referrerPolicy: request.referrerPolicy,
146
+ signal,
147
+ ...request.body ? { duplex: "half" } : {},
148
+ ...overrides
149
+ }];
150
+ }
151
+ function createBearerCommandFetch(resolver, delegate) {
152
+ const innerFetch = delegate ? (input, init) => delegate(input, init) : (input, init) => globalThis.fetch(input, init);
153
+ return async (input, init) => {
154
+ const request = new Request(input, init);
155
+ const token = await resolver.resolve(request.signal);
156
+ const headers = new Headers(request.headers);
157
+ try {
158
+ headers.set("Authorization", `Bearer ${token}`);
159
+ } catch {
160
+ throw new TypeError("bearerTokenCommand returned a token that is not a valid header value");
161
+ }
162
+ return innerFetch(...forwardInit(input, init, request, { headers }));
163
+ };
164
+ }
165
+ function createProviderTokenFetch(serverUrl, provider, providerToken, delegate) {
166
+ const origin = new URL(serverUrl).origin;
167
+ const innerFetch = delegate ? (input, init) => delegate(input, init) : (input, init) => globalThis.fetch(input, init);
168
+ return async (input, init) => {
169
+ const request = new Request(input, init);
170
+ if (new URL(request.url).origin !== origin)
171
+ return innerFetch(...forwardInit(input, init, request));
172
+ const token = await providerToken(provider);
173
+ if (!token)
174
+ return new Response(null, { status: 401 });
175
+ const headers = new Headers(request.headers);
176
+ try {
177
+ headers.set("Authorization", `Bearer ${token}`);
178
+ } catch {
179
+ throw new TypeError(`DM provider "${provider}" returned a token that is not a valid header value`);
180
+ }
181
+ return innerFetch(...forwardInit(input, init, request, { headers, redirect: "error" }));
182
+ };
183
+ }
184
+
185
+ export class McpServerManager {
186
+ defaultCwd;
187
+ connections = new Map;
188
+ connectPromises = new Map;
189
+ connectOAuthAuthorities = new Map;
190
+ reconnectPromises = new Map;
191
+ reconnectOAuthAuthorities = new Map;
192
+ reconnectAttempts = new Map;
193
+ uiStreamListeners = new Map;
194
+ samplingConfig;
195
+ metadataListChangedListener;
196
+ listenStateChangedListener;
197
+ connectionReplacedListener;
198
+ connectionInitializedListener;
199
+ resourceUpdatedListeners = new Map;
200
+ pendingMetadataPublications = new Map;
201
+ elicitationConfig;
202
+ authStorageOptions = {};
203
+ oauthRuntime;
204
+ acceptedUrlElicitations = new Map;
205
+ defaultRequestTimeoutMs;
206
+ runtimeSignal;
207
+ closePromises = new Map;
208
+ closeGenerations = new Map;
209
+ connectAttempts = new Map;
210
+ traceSettings;
211
+ traceWriter;
212
+ providerToken;
213
+ stopped = false;
214
+ constructor(defaultCwd) {
215
+ this.defaultCwd = defaultCwd;
216
+ }
217
+ setSamplingConfig(config) {
218
+ this.samplingConfig = config;
219
+ }
220
+ setMetadataListChangedListener(listener) {
221
+ this.metadataListChangedListener = listener;
222
+ }
223
+ setListenStateChangedListener(listener) {
224
+ this.listenStateChangedListener = listener;
225
+ }
226
+ setConnectionReplacedListener(listener) {
227
+ this.connectionReplacedListener = listener;
228
+ }
229
+ setConnectionInitializedListener(listener) {
230
+ this.connectionInitializedListener = listener;
231
+ }
232
+ publishMetadataChanged(name, expectedConnection, reason) {
233
+ const current = this.connections.get(name);
234
+ if (current !== expectedConnection || current.status !== "connected")
235
+ return false;
236
+ try {
237
+ this.metadataListChangedListener?.(name, reason);
238
+ this.pendingMetadataPublications.delete(name);
239
+ return true;
240
+ } catch (error) {
241
+ this.pendingMetadataPublications.set(name, { connection: expectedConnection, reason });
242
+ const message = error instanceof Error ? error.message : String(error);
243
+ logger.debug(`MCP: metadata publication failed for ${name}; queued for retry: ${message}`);
244
+ return false;
245
+ }
246
+ }
247
+ setElicitationConfig(config) {
248
+ this.elicitationConfig = config;
249
+ }
250
+ async promptFormElicitation(name, params, signal) {
251
+ const config = this.elicitationConfig;
252
+ if (!config)
253
+ return;
254
+ return whileAdapterPromptOpen(this.connections.get(name)?.client, () => handleFormElicitation({ ...config, serverName: name }, params, signal));
255
+ }
256
+ urlElicitationPrompt(name) {
257
+ const config = this.elicitationConfig;
258
+ if (this.runtimeSignal?.aborted || !config?.allowUrl)
259
+ return;
260
+ return async (params, signal) => {
261
+ const result = await whileAdapterPromptOpen(this.connections.get(name)?.client, () => handleUrlElicitation({ ...config, serverName: name }, params, signal));
262
+ if (result.action === "accept")
263
+ this.touch(name);
264
+ return result;
265
+ };
266
+ }
267
+ setRuntimeSignal(signal) {
268
+ this.runtimeSignal = signal;
269
+ }
270
+ setDefaultRequestTimeoutMs(timeoutMs) {
271
+ this.defaultRequestTimeoutMs = normalizeRequestTimeoutMs(timeoutMs);
272
+ }
273
+ setTraceConfig(settings) {
274
+ this.traceSettings = settings;
275
+ }
276
+ setAuthStorageOptions(options) {
277
+ this.authStorageOptions = options;
278
+ }
279
+ setProviderToken(providerToken) {
280
+ this.providerToken = providerToken;
281
+ }
282
+ validateProviderAuth(name, definition) {
283
+ if (typeof definition.auth !== "object")
284
+ return;
285
+ const urlError = providerAuthUrlError(resolveServerUrl(definition) ?? "");
286
+ if (urlError)
287
+ throw new Error(`MCP server "${name}": ${urlError}`);
288
+ if (!this.providerToken) {
289
+ throw new Error(`MCP server "${name}": auth.provider isn't available here; it needs a DM session whose model registry provides provider tokens (DM 0.99.2 or later)`);
290
+ }
291
+ }
292
+ setOAuthRuntime(runtime) {
293
+ this.oauthRuntime = runtime;
294
+ }
295
+ getRequestOptions(name, signal) {
296
+ const connection = this.connections.get(name);
297
+ return this.buildRequestOptions(connection?.definition, signal);
298
+ }
299
+ getResolvedRequestTimeoutMs(definition) {
300
+ if (definition?.requestTimeoutMs !== undefined) {
301
+ return normalizeRequestTimeoutMs(definition.requestTimeoutMs);
302
+ }
303
+ return this.defaultRequestTimeoutMs;
304
+ }
305
+ buildRequestOptions(definition, signal) {
306
+ const timeout = this.getResolvedRequestTimeoutMs(definition);
307
+ const ownedSignal = combineAbortSignals(this.runtimeSignal, signal);
308
+ if (!ownedSignal && timeout === undefined) {
309
+ return;
310
+ }
311
+ return {
312
+ ...ownedSignal ? { signal: ownedSignal } : {},
313
+ ...timeout !== undefined ? { timeout } : {}
314
+ };
315
+ }
316
+ arbitrateConnectionAttempt(name, oauthAuthority, promises, authorities, attempts) {
317
+ const existingPromise = promises.get(name);
318
+ if (!existingPromise)
319
+ return;
320
+ const existingAuthority = authorities.get(name);
321
+ let reusable = oauthAuthority === undefined && existingAuthority === undefined;
322
+ if (oauthAuthority && existingAuthority) {
323
+ try {
324
+ existingAuthority();
325
+ reusable = true;
326
+ } catch {
327
+ reusable = false;
328
+ }
329
+ }
330
+ if (reusable)
331
+ return existingPromise;
332
+ const replacedAttempt = attempts.get(name);
333
+ replacedAttempt?.abort(new Error(`MCP connection ${name} was replaced`));
334
+ if (attempts.get(name) === replacedAttempt)
335
+ attempts.delete(name);
336
+ if (promises.get(name) === existingPromise)
337
+ promises.delete(name);
338
+ if (authorities.get(name) === existingAuthority)
339
+ authorities.delete(name);
340
+ return;
341
+ }
342
+ async connect(name, definition, signal) {
343
+ validateCaFile(definition);
344
+ this.validateProviderAuth(name, definition);
345
+ if (isServerDisabled(definition))
346
+ throw new Error(`MCP server "${name}" is disabled`);
347
+ if (this.stopped)
348
+ throw new Error("MCP server manager is closed");
349
+ const ownedSignal = combineAbortSignals(this.runtimeSignal, signal);
350
+ throwIfAborted(ownedSignal);
351
+ const oauthAuthority = definition.url && supportsOAuth(definition) ? captureOAuthAuthority(name, false) : undefined;
352
+ const closing = this.closePromises.get(name);
353
+ if (closing)
354
+ await abortable(closing, ownedSignal);
355
+ throwIfAborted(ownedSignal);
356
+ const existingConnect = this.arbitrateConnectionAttempt(name, oauthAuthority, this.connectPromises, this.connectOAuthAuthorities, this.connectAttempts);
357
+ if (existingConnect)
358
+ return abortable(existingConnect, ownedSignal);
359
+ const existing = this.connections.get(name);
360
+ if (existing?.status === "connected") {
361
+ existing.lastUsedAt = Date.now();
362
+ return existing;
363
+ }
364
+ const existingReconnect = this.arbitrateConnectionAttempt(name, oauthAuthority, this.reconnectPromises, this.reconnectOAuthAuthorities, this.reconnectAttempts);
365
+ if (existingReconnect)
366
+ return abortable(existingReconnect, ownedSignal);
367
+ const credentialsInvalidated = existing?.status === "needs-auth" && existing.credentialsInvalidated === true;
368
+ const generation = this.closeGenerations.get(name) ?? 0;
369
+ const attemptController = new AbortController;
370
+ const attemptSignal = combineAbortSignals(ownedSignal, attemptController.signal);
371
+ const promise = this.createConnection(name, definition, attemptSignal, ownedSignal, credentialsInvalidated, oauthAuthority, attemptController);
372
+ this.connectPromises.set(name, promise);
373
+ if (oauthAuthority)
374
+ this.connectOAuthAuthorities.set(name, oauthAuthority);
375
+ this.connectAttempts.set(name, attemptController);
376
+ try {
377
+ const connection = await promise;
378
+ if (attemptController.signal.aborted || (this.closeGenerations.get(name) ?? 0) !== generation) {
379
+ await this.disposeConnection(connection);
380
+ throwIfAborted(attemptSignal);
381
+ throw new Error(`MCP connection for ${name} was closed while connecting`);
382
+ }
383
+ this.connections.set(name, connection);
384
+ this.watchListenSubscription(name, connection, connection.listenSubscription);
385
+ if ([...this.resourceUpdatedListeners.values()].some((registration) => registration.serverName === name)) {
386
+ this.ensureListen(name, connection);
387
+ }
388
+ return connection;
389
+ } finally {
390
+ if (this.connectPromises.get(name) === promise)
391
+ this.connectPromises.delete(name);
392
+ if (this.connectOAuthAuthorities.get(name) === oauthAuthority) {
393
+ this.connectOAuthAuthorities.delete(name);
394
+ }
395
+ if (this.connectAttempts.get(name) === attemptController)
396
+ this.connectAttempts.delete(name);
397
+ }
398
+ }
399
+ async reconnect(name, definition, staleConnection, signal) {
400
+ validateCaFile(definition);
401
+ this.validateProviderAuth(name, definition);
402
+ if (isServerDisabled(definition))
403
+ throw new Error(`MCP server "${name}" is disabled`);
404
+ if (this.stopped)
405
+ throw new Error("MCP server manager is closed");
406
+ const ownedSignal = combineAbortSignals(this.runtimeSignal, signal);
407
+ throwIfAborted(ownedSignal);
408
+ const oauthAuthority = definition.url && supportsOAuth(definition) ? captureOAuthAuthority(name, false) : undefined;
409
+ const existingConnect = this.arbitrateConnectionAttempt(name, oauthAuthority, this.connectPromises, this.connectOAuthAuthorities, this.connectAttempts);
410
+ if (existingConnect)
411
+ return abortable(existingConnect, ownedSignal);
412
+ const inFlight = this.arbitrateConnectionAttempt(name, oauthAuthority, this.reconnectPromises, this.reconnectOAuthAuthorities, this.reconnectAttempts);
413
+ if (inFlight)
414
+ return abortable(inFlight, ownedSignal);
415
+ const attemptController = new AbortController;
416
+ const attemptSignal = combineAbortSignals(ownedSignal, attemptController.signal);
417
+ const promise = this.doReconnect(name, definition, staleConnection, attemptSignal, oauthAuthority, attemptController).catch((error) => {
418
+ if (attemptController.signal.aborted && !this.containsCleanupFailure(error)) {
419
+ throw new Error(`MCP connection for ${name} was closed while reconnecting`, { cause: error });
420
+ }
421
+ throw error;
422
+ }).finally(() => {
423
+ if (this.reconnectPromises.get(name) === promise) {
424
+ this.reconnectPromises.delete(name);
425
+ }
426
+ if (this.reconnectAttempts.get(name) === attemptController) {
427
+ this.reconnectAttempts.delete(name);
428
+ }
429
+ if (this.reconnectOAuthAuthorities.get(name) === oauthAuthority) {
430
+ this.reconnectOAuthAuthorities.delete(name);
431
+ }
432
+ });
433
+ this.reconnectPromises.set(name, promise);
434
+ if (oauthAuthority)
435
+ this.reconnectOAuthAuthorities.set(name, oauthAuthority);
436
+ this.reconnectAttempts.set(name, attemptController);
437
+ return abortable(promise, ownedSignal);
438
+ }
439
+ async refreshTools(name, expectedConnection, signal) {
440
+ if (this.stopped)
441
+ throw new Error("MCP server manager is closed");
442
+ const ownedSignal = combineAbortSignals(this.runtimeSignal, signal);
443
+ throwIfAborted(ownedSignal);
444
+ const current = this.connections.get(name);
445
+ if (current !== expectedConnection || current.status !== "connected") {
446
+ return "superseded";
447
+ }
448
+ await this.ensureListen(name, expectedConnection);
449
+ const requestOptions = this.buildRequestOptions(expectedConnection.definition, signal);
450
+ const timeout = Math.min(requestOptions?.timeout ?? KEEP_ALIVE_REFRESH_TIMEOUT_MS, KEEP_ALIVE_REFRESH_TIMEOUT_MS);
451
+ const healthOptions = {
452
+ ...requestOptions,
453
+ timeout
454
+ };
455
+ if (!expectedConnection.client.getServerCapabilities?.()?.tools) {
456
+ await expectedConnection.client.ping(healthOptions);
457
+ throwIfAborted(ownedSignal);
458
+ if (this.connections.get(name) !== expectedConnection || expectedConnection.status !== "connected") {
459
+ return "superseded";
460
+ }
461
+ this.retryPendingMetadataPublication(name, expectedConnection);
462
+ return "unchanged";
463
+ }
464
+ const toolsRevision = expectedConnection.toolsRevision ?? 0;
465
+ const refreshSignal = combineAbortSignals(healthOptions.signal, AbortSignal.timeout(timeout));
466
+ let toolResult;
467
+ try {
468
+ toolResult = await this.fetchAllTools(expectedConnection.client, {
469
+ ...healthOptions,
470
+ ...refreshSignal ? { signal: refreshSignal } : {},
471
+ cacheMode: "refresh"
472
+ });
473
+ } catch (error) {
474
+ throwIfAborted(ownedSignal);
475
+ if (this.connections.get(name) !== expectedConnection || expectedConnection.status !== "connected") {
476
+ return "superseded";
477
+ }
478
+ if (error instanceof SdkError && error.code === SdkErrorCode.RequestTimeout) {
479
+ return "refresh-timeout";
480
+ }
481
+ throw error;
482
+ }
483
+ throwIfAborted(ownedSignal);
484
+ if (this.connections.get(name) !== expectedConnection || expectedConnection.status !== "connected") {
485
+ return "superseded";
486
+ }
487
+ if ((expectedConnection.toolsRevision ?? 0) !== toolsRevision) {
488
+ return "superseded";
489
+ }
490
+ if (isDeepStrictEqual(expectedConnection.tools, toolResult.tools) && isDeepStrictEqual(expectedConnection.toolListHints, toolResult.hints)) {
491
+ this.retryPendingMetadataPublication(name, expectedConnection);
492
+ return "unchanged";
493
+ }
494
+ const previousTools = expectedConnection.tools;
495
+ const previousToolListHints = expectedConnection.toolListHints;
496
+ expectedConnection.tools = toolResult.tools;
497
+ expectedConnection.toolListHints = toolResult.hints;
498
+ expectedConnection.toolsRevision = toolsRevision + 1;
499
+ try {
500
+ await this.metadataListChangedListener?.(name, "keep-alive-refresh");
501
+ this.pendingMetadataPublications.delete(name);
502
+ } catch (error) {
503
+ if (this.connections.get(name) === expectedConnection && expectedConnection.tools === toolResult.tools && expectedConnection.toolListHints === toolResult.hints) {
504
+ expectedConnection.tools = previousTools;
505
+ expectedConnection.toolListHints = previousToolListHints;
506
+ expectedConnection.toolsRevision = toolsRevision;
507
+ }
508
+ throw error;
509
+ }
510
+ return "updated";
511
+ }
512
+ retryPendingMetadataPublication(name, connection) {
513
+ const pendingPublication = this.pendingMetadataPublications.get(name);
514
+ if (pendingPublication?.connection !== connection)
515
+ return;
516
+ this.metadataListChangedListener?.(name, pendingPublication.reason);
517
+ if (this.pendingMetadataPublications.get(name) === pendingPublication) {
518
+ this.pendingMetadataPublications.delete(name);
519
+ }
520
+ }
521
+ setListenState(name, connection, state) {
522
+ if (connection.listenState === state)
523
+ return;
524
+ connection.listenState = state;
525
+ if (this.connections.get(name) === connection) {
526
+ try {
527
+ this.listenStateChangedListener?.(name, state);
528
+ } catch {}
529
+ }
530
+ }
531
+ catalogListenFilter(connection) {
532
+ const capabilities = connection.client.getServerCapabilities?.();
533
+ return {
534
+ ...capabilities?.tools?.listChanged ? { toolsListChanged: true } : {},
535
+ ...capabilities?.prompts?.listChanged ? { promptsListChanged: true } : {},
536
+ ...capabilities?.resources?.listChanged ? { resourcesListChanged: true } : {}
537
+ };
538
+ }
539
+ currentListenFilter(name, connection) {
540
+ const now = Date.now();
541
+ const recent = connection.recentResourceUris;
542
+ if (recent) {
543
+ for (const [uri, touchedAt] of recent) {
544
+ if (now - touchedAt > RECENT_RESOURCE_TTL_MS)
545
+ recent.delete(uri);
546
+ }
547
+ }
548
+ const openResourceUris = [...new Set([...this.resourceUpdatedListeners.values()].filter((registration) => registration.serverName === name).map((registration) => registration.uri))].slice(-MAX_RESOURCE_SUBSCRIPTIONS);
549
+ const openSet = new Set(openResourceUris);
550
+ const recentSlots = MAX_RESOURCE_SUBSCRIPTIONS - openResourceUris.length;
551
+ const recentResourceUris = recentSlots > 0 ? [...recent?.keys() ?? []].filter((uri) => !openSet.has(uri)).slice(-recentSlots) : [];
552
+ const resourceSubscriptions = [...openResourceUris, ...recentResourceUris];
553
+ return {
554
+ ...this.catalogListenFilter(connection),
555
+ ...resourceSubscriptions.length > 0 ? { resourceSubscriptions } : {}
556
+ };
557
+ }
558
+ watchListenSubscription(name, connection, subscription) {
559
+ if (!subscription)
560
+ return;
561
+ subscription.closed.then((cause) => {
562
+ if (this.stopped || this.connections.get(name) !== connection || connection.status !== "connected" || connection.listenSubscription !== subscription)
563
+ return;
564
+ if (cause === "remote") {
565
+ const staleUris = connection.listenFilter?.resourceSubscriptions ?? [];
566
+ if (staleUris.length > 0)
567
+ connection.resourceReadRefreshUris = new Set(staleUris);
568
+ connection.listenCatalogStale = true;
569
+ connection.listenRetryAfter = Date.now();
570
+ this.setListenState(name, connection, "dropped");
571
+ } else if (cause === "graceful" || connection.listenState !== "re-establishing") {
572
+ connection.listenStopped = true;
573
+ this.setListenState(name, connection, "not-listening");
574
+ }
575
+ });
576
+ }
577
+ async ensureListen(name, expectedConnection) {
578
+ if (this.stopped || this.connections.get(name) !== expectedConnection || expectedConnection.status !== "connected" || expectedConnection.listenStopped || expectedConnection.client.getProtocolEra?.() !== "modern")
579
+ return;
580
+ const filter = this.currentListenFilter(name, expectedConnection);
581
+ if (Object.keys(filter).length === 0) {
582
+ this.setListenState(name, expectedConnection, "not-listening");
583
+ return;
584
+ }
585
+ if (expectedConnection.listenPromise) {
586
+ await expectedConnection.listenPromise;
587
+ return this.ensureListen(name, expectedConnection);
588
+ }
589
+ if ((expectedConnection.listenRetryAfter ?? 0) > Date.now())
590
+ return;
591
+ const sameFilter = isDeepStrictEqual(expectedConnection.listenFilter, filter);
592
+ if (expectedConnection.listenState === "active" && sameFilter) {
593
+ if (!expectedConnection.listenCatalogStale)
594
+ return;
595
+ const attempt = (async () => {
596
+ this.setListenState(name, expectedConnection, "re-establishing");
597
+ const confirmed = await this.reconcileCatalogAfterListen(name, expectedConnection, this.buildRequestOptions(expectedConnection.definition));
598
+ if (!confirmed)
599
+ expectedConnection.listenRetryAfter = Date.now() + LISTEN_RETRY_DELAY_MS;
600
+ this.setListenState(name, expectedConnection, "active");
601
+ })().finally(() => {
602
+ if (expectedConnection.listenPromise === attempt)
603
+ delete expectedConnection.listenPromise;
604
+ });
605
+ expectedConnection.listenPromise = attempt;
606
+ return attempt;
607
+ }
608
+ const attempt = (async () => {
609
+ const recoverDroppedListen = expectedConnection.listenState === "dropped";
610
+ this.setListenState(name, expectedConnection, "re-establishing");
611
+ const previous = expectedConnection.listenSubscription;
612
+ if (previous)
613
+ await previous.close().catch(() => {});
614
+ if (this.connections.get(name) !== expectedConnection || expectedConnection.status !== "connected")
615
+ return;
616
+ try {
617
+ const requestOptions = this.buildRequestOptions(expectedConnection.definition);
618
+ const subscription = await expectedConnection.client.listen(filter, {
619
+ ...requestOptions,
620
+ timeout: Math.min(requestOptions?.timeout ?? KEEP_ALIVE_REFRESH_TIMEOUT_MS, KEEP_ALIVE_REFRESH_TIMEOUT_MS)
621
+ });
622
+ if (this.connections.get(name) !== expectedConnection || expectedConnection.status !== "connected") {
623
+ await subscription.close().catch(() => {});
624
+ return;
625
+ }
626
+ expectedConnection.listenSubscription = subscription;
627
+ expectedConnection.listenFilter = filter;
628
+ delete expectedConnection.listenStopped;
629
+ delete expectedConnection.listenRetryAfter;
630
+ this.watchListenSubscription(name, expectedConnection, subscription);
631
+ const confirmed = recoverDroppedListen ? await this.reconcileCatalogAfterListen(name, expectedConnection, requestOptions) : true;
632
+ if (!confirmed)
633
+ expectedConnection.listenRetryAfter = Date.now() + LISTEN_RETRY_DELAY_MS;
634
+ this.setListenState(name, expectedConnection, "active");
635
+ } catch (error) {
636
+ if (this.connections.get(name) !== expectedConnection || expectedConnection.status !== "connected")
637
+ return;
638
+ if (expectedConnection.listenSubscription)
639
+ await expectedConnection.listenSubscription.close().catch(() => {});
640
+ expectedConnection.listenRetryAfter = Date.now() + LISTEN_RETRY_DELAY_MS;
641
+ this.setListenState(name, expectedConnection, "dropped");
642
+ logger.debug(`MCP: catalog listen repair failed for ${name}: ${error instanceof Error ? error.message : String(error)}`);
643
+ }
644
+ })().finally(() => {
645
+ if (expectedConnection.listenPromise === attempt)
646
+ delete expectedConnection.listenPromise;
647
+ });
648
+ expectedConnection.listenPromise = attempt;
649
+ return attempt;
650
+ }
651
+ async reconcileCatalogAfterListen(name, expectedConnection, requestOptions) {
652
+ const timeout = Math.min(requestOptions?.timeout ?? KEEP_ALIVE_REFRESH_TIMEOUT_MS, KEEP_ALIVE_REFRESH_TIMEOUT_MS);
653
+ const refreshSignal = combineAbortSignals(requestOptions?.signal, AbortSignal.timeout(timeout));
654
+ const refreshOptions = {
655
+ ...requestOptions,
656
+ timeout,
657
+ cacheMode: "refresh",
658
+ ...refreshSignal ? { signal: refreshSignal } : {}
659
+ };
660
+ const [toolResult, resources, promptResult] = await Promise.allSettled([
661
+ this.fetchAllTools(expectedConnection.client, refreshOptions),
662
+ this.fetchAllResources(expectedConnection.client, refreshOptions, true),
663
+ this.fetchAllPrompts(expectedConnection.client, refreshOptions)
664
+ ]);
665
+ if (this.connections.get(name) !== expectedConnection || expectedConnection.status !== "connected")
666
+ return false;
667
+ const nextTools = toolResult.status === "fulfilled" ? toolResult.value : undefined;
668
+ const nextResources = resources.status === "fulfilled" ? resources.value : undefined;
669
+ const nextPrompts = promptResult.status === "fulfilled" && !promptResult.value.failed ? promptResult.value : undefined;
670
+ const confirmed = nextTools !== undefined && nextResources !== undefined && nextPrompts !== undefined;
671
+ const changed = nextTools !== undefined && (!isDeepStrictEqual(expectedConnection.tools, nextTools.tools) || !isDeepStrictEqual(expectedConnection.toolListHints, nextTools.hints)) || nextResources !== undefined && (!isDeepStrictEqual(expectedConnection.resources, nextResources.resources) || expectedConnection.resourceDiscoveryFailed !== nextResources.failed) || nextPrompts !== undefined && (!isDeepStrictEqual(expectedConnection.prompts, nextPrompts.prompts) || expectedConnection.promptDiscoveryFailed !== false);
672
+ if (!changed) {
673
+ this.retryPendingMetadataPublication(name, expectedConnection);
674
+ if (confirmed)
675
+ delete expectedConnection.listenCatalogStale;
676
+ else
677
+ expectedConnection.listenCatalogStale = true;
678
+ return confirmed;
679
+ }
680
+ if (nextTools !== undefined) {
681
+ expectedConnection.tools = nextTools.tools;
682
+ expectedConnection.toolListHints = nextTools.hints;
683
+ expectedConnection.toolsRevision = (expectedConnection.toolsRevision ?? 0) + 1;
684
+ }
685
+ if (nextResources !== undefined) {
686
+ expectedConnection.resources = nextResources.resources;
687
+ expectedConnection.resourceDiscoveryFailed = nextResources.failed;
688
+ }
689
+ if (nextPrompts !== undefined) {
690
+ expectedConnection.prompts = nextPrompts.prompts;
691
+ expectedConnection.promptDiscoveryFailed = false;
692
+ }
693
+ if (confirmed)
694
+ delete expectedConnection.listenCatalogStale;
695
+ else
696
+ expectedConnection.listenCatalogStale = true;
697
+ this.metadataListChangedListener?.(name, "listen-recovered");
698
+ this.pendingMetadataPublications.delete(name);
699
+ return confirmed;
700
+ }
701
+ async prepareResourceUse(name, uri, expectedConnection) {
702
+ if (this.connections.get(name) !== expectedConnection || expectedConnection.status !== "connected")
703
+ return false;
704
+ const refreshRead = expectedConnection.listenState === "dropped" || expectedConnection.listenState === "re-establishing" || expectedConnection.resourceReadRefreshUris?.has(uri) === true;
705
+ const recent = expectedConnection.recentResourceUris ?? new Map;
706
+ recent.delete(uri);
707
+ recent.set(uri, Date.now());
708
+ while (recent.size > MAX_RESOURCE_SUBSCRIPTIONS) {
709
+ const oldest = recent.keys().next().value;
710
+ if (oldest === undefined)
711
+ break;
712
+ recent.delete(oldest);
713
+ }
714
+ expectedConnection.recentResourceUris = recent;
715
+ await this.ensureListen(name, expectedConnection);
716
+ expectedConnection.resourceReadRefreshUris?.delete(uri);
717
+ return refreshRead;
718
+ }
719
+ registerResourceUpdatedListener(token, serverName, uri, listener) {
720
+ this.removeResourceUpdatedListener(token);
721
+ this.resourceUpdatedListeners.set(token, { serverName, uri, listener });
722
+ const connection = this.connections.get(serverName);
723
+ if (!connection || connection.status !== "connected")
724
+ return;
725
+ this.prepareResourceUse(serverName, uri, connection);
726
+ }
727
+ removeResourceUpdatedListener(token) {
728
+ this.resourceUpdatedListeners.delete(token);
729
+ }
730
+ async doReconnect(name, definition, staleConnection, signal, oauthAuthority, attemptOwner) {
731
+ throwIfAborted(signal);
732
+ const current = this.connections.get(name);
733
+ if (current !== staleConnection) {
734
+ return current ?? this.connect(name, definition, signal);
735
+ }
736
+ const generation = this.closeGenerations.get(name) ?? 0;
737
+ const credentialsInvalidated = staleConnection.status === "needs-auth" && staleConnection.credentialsInvalidated === true;
738
+ const fresh = await this.createConnection(name, definition, signal, signal, credentialsInvalidated, oauthAuthority, attemptOwner);
739
+ if (signal?.aborted || this.reconnectAttempts.get(name) !== attemptOwner || (this.closeGenerations.get(name) ?? 0) !== generation) {
740
+ await this.disposeConnection(fresh);
741
+ throwIfAborted(signal);
742
+ throw new Error(`MCP connection for ${name} was closed while reconnecting`);
743
+ }
744
+ const routeAtPublish = this.connections.get(name);
745
+ if (routeAtPublish !== staleConnection) {
746
+ await this.disposeConnection(fresh);
747
+ return routeAtPublish ?? this.connect(name, definition, signal);
748
+ }
749
+ fresh.inFlight = Math.max(fresh.inFlight, staleConnection.inFlight);
750
+ this.connections.set(name, fresh);
751
+ this.watchListenSubscription(name, fresh, fresh.listenSubscription);
752
+ if ([...this.resourceUpdatedListeners.values()].some((registration) => registration.serverName === name)) {
753
+ this.ensureListen(name, fresh);
754
+ }
755
+ staleConnection.status = "closed";
756
+ try {
757
+ await this.connectionReplacedListener?.(name, fresh);
758
+ } catch (error) {
759
+ logger.warn(`MCP: handing work over to the new ${name} connection failed: ${error instanceof Error ? error.message : String(error)}`);
760
+ }
761
+ try {
762
+ await this.disposeConnection(staleConnection);
763
+ } catch (error) {
764
+ const failures = error instanceof AggregateError ? error.errors : [error];
765
+ const details = failures.map((failure) => failure instanceof Error ? failure.message : String(failure)).join("; ");
766
+ logger.debug(`MCP: stale connection cleanup failed for ${name}: ${details}`);
767
+ }
768
+ if ((this.closeGenerations.get(name) ?? 0) !== generation || this.connections.get(name) !== fresh || fresh.status === "closed") {
769
+ throw new Error(`MCP connection for ${name} was closed while reconnecting`);
770
+ }
771
+ return fresh;
772
+ }
773
+ async createConnection(name, definition, signal, requestSignal, credentialsInvalidated = false, oauthAuthority, attemptOwner) {
774
+ throwIfAborted(signal);
775
+ const tracingEnabled = isMcpTraceEnabled(definition, this.traceSettings);
776
+ const traceWriter = tracingEnabled ? this.traceWriter ??= createMcpTraceWriter(this.defaultCwd, this.traceSettings ?? {}) : undefined;
777
+ const traceObserver = traceWriter ? { record: (event) => traceWriter.write(event) } : undefined;
778
+ let client;
779
+ let transport;
780
+ let clientConnected = false;
781
+ let invalidated = credentialsInvalidated;
782
+ let transportAlreadyTraced = false;
783
+ let stderrTail = Buffer.alloc(0);
784
+ const configuredTransports = [definition.command, definition.url, definition.socket].filter((value) => typeof value === "string" && value.length > 0);
785
+ if (configuredTransports.length !== 1) {
786
+ throw new Error(`Server ${name} must configure exactly one of command, url, or socket`);
787
+ }
788
+ const requestOptions = this.buildRequestOptions(definition, requestSignal);
789
+ if (definition.command) {
790
+ client = this.createClient(name, definition);
791
+ let command = resolveConfigPath(definition.command) ?? definition.command;
792
+ const literalArgs = isBuiltInAgentPlugin(definition, "args");
793
+ const literalCwd = isBuiltInAgentPlugin(definition, "cwd");
794
+ let args = literalArgs ? [...definition.args ?? []] : (definition.args ?? []).map((argument) => expandHomePath(interpolateEnvVars(argument)) ?? argument);
795
+ const cwd = (literalCwd ? expandHomePath(definition.cwd) : resolveConfigPath(definition.cwd)) ?? this.defaultCwd;
796
+ if (definition.pluginDataDir)
797
+ mkdirSync(definition.pluginDataDir, { recursive: true });
798
+ if (cwd !== undefined) {
799
+ const cwdStats = statSync(cwd, { throwIfNoEntry: false });
800
+ if (!cwdStats)
801
+ throw new Error(`MCP server "${name}" configured cwd does not exist: "${cwd}"`);
802
+ if (!cwdStats.isDirectory())
803
+ throw new Error(`MCP server "${name}" configured cwd is not a directory: "${cwd}"`);
804
+ }
805
+ if (command === "npx" || command === "npm") {
806
+ const resolved = await resolveNpxBinary(command, args, signal);
807
+ if (resolved) {
808
+ command = resolved.isJs ? "node" : resolved.binPath;
809
+ args = resolved.isJs ? [resolved.binPath, ...resolved.extraArgs] : resolved.extraArgs;
810
+ logger.debug(`${name} resolved to ${resolved.binPath} (skipping npm parent)`);
811
+ }
812
+ }
813
+ throwIfAborted(signal);
814
+ const stdioTransport = new StdioClientTransport({
815
+ command,
816
+ args,
817
+ env: resolveEnv(definition.env, name, isBuiltInAgentPlugin(definition, "env") || definition.literalEnv === true, definition.inheritEnv !== false),
818
+ ...cwd !== undefined ? { cwd } : {},
819
+ stderr: definition.debug ? "inherit" : "pipe"
820
+ });
821
+ if (stdioTransport.stderr) {
822
+ stdioTransport.stderr.on("data", (chunk) => {
823
+ stderrTail = appendStderrTail(stderrTail, chunk);
824
+ });
825
+ }
826
+ transport = stdioTransport;
827
+ } else if (definition.url) {
828
+ const httpConnection = await this.connectHttpClient(definition, name, requestOptions, signal, traceObserver, invalidated, oauthAuthority, attemptOwner).catch(async (error) => {
829
+ throw await this.enrichHttpConnectionError(definition, error);
830
+ });
831
+ client = httpConnection.client;
832
+ transport = httpConnection.transport;
833
+ invalidated = httpConnection.credentialsInvalidated;
834
+ if (httpConnection.status === "needs-auth") {
835
+ return {
836
+ client,
837
+ transport,
838
+ definition,
839
+ tools: [],
840
+ resources: [],
841
+ prompts: [],
842
+ lastUsedAt: Date.now(),
843
+ inFlight: 0,
844
+ status: "needs-auth",
845
+ listenState: "disconnected",
846
+ credentialsInvalidated: invalidated
847
+ };
848
+ }
849
+ clientConnected = true;
850
+ transportAlreadyTraced = traceObserver !== undefined;
851
+ } else {
852
+ client = this.createClient(name, definition);
853
+ transport = new UnixSocketClientTransport(resolveConfigPath(definition.socket));
854
+ }
855
+ if (traceObserver && !transportAlreadyTraced) {
856
+ const traceTransportKindValue = traceTransportKind(definition, transport);
857
+ transport = wrapTransportWithMcpTrace(transport, name, traceTransportKindValue, traceObserver);
858
+ }
859
+ try {
860
+ throwIfAborted(signal);
861
+ if (!clientConnected) {
862
+ await this.connectClientWithAbort(client, transport, requestOptions, signal);
863
+ }
864
+ this.connectionInitializedListener?.(name);
865
+ this.attachAdapterNotificationHandlers(name, client);
866
+ const instructions = client.getInstructions?.();
867
+ const protocolEra = client.getProtocolEra?.();
868
+ const autoOpenedSubscription = client.autoOpenedSubscription;
869
+ const connection = {
870
+ client,
871
+ transport,
872
+ requestMetadata: () => clientMetadata.get(client)?.(),
873
+ definition,
874
+ tools: [],
875
+ toolsRevision: 0,
876
+ resources: [],
877
+ prompts: [],
878
+ ...instructions !== undefined ? { instructions } : {},
879
+ lastUsedAt: Date.now(),
880
+ inFlight: 0,
881
+ status: "connected",
882
+ listenState: protocolEra === "modern" ? autoOpenedSubscription ? "active" : "not-listening" : "legacy",
883
+ ...autoOpenedSubscription ? {
884
+ listenSubscription: autoOpenedSubscription
885
+ } : {}
886
+ };
887
+ if (autoOpenedSubscription)
888
+ connection.listenFilter = this.catalogListenFilter(connection);
889
+ client.onclose = () => {
890
+ if (connection.status === "closed")
891
+ return;
892
+ connection.status = "closed";
893
+ if (this.connections.get(name) !== connection)
894
+ return;
895
+ this.metadataListChangedListener?.(name, "remote-close");
896
+ };
897
+ const [toolResult, resources, promptResult] = await Promise.all([
898
+ this.fetchAllTools(client, requestOptions),
899
+ this.fetchAllResources(client, requestOptions),
900
+ this.fetchAllPrompts(client, requestOptions)
901
+ ]);
902
+ if (connection.status !== "connected") {
903
+ throw new Error(`MCP connection for ${name} closed during metadata discovery`);
904
+ }
905
+ connection.tools = toolResult.tools;
906
+ connection.toolListHints = toolResult.hints;
907
+ connection.resources = resources.resources;
908
+ connection.resourceDiscoveryFailed = resources.failed;
909
+ connection.prompts = promptResult.prompts;
910
+ connection.promptDiscoveryFailed = promptResult.failed;
911
+ if (definition.tasks !== false) {
912
+ try {
913
+ const attachment = await attachTaskSession({
914
+ client,
915
+ serverName: name,
916
+ definition,
917
+ transport,
918
+ requestTimeoutMs: this.getResolvedRequestTimeoutMs(definition),
919
+ clientInfo: { name: `dm-mcp-${name}`, version: "1.0.0" },
920
+ clientCapabilities: this.buildClientCapabilities(definition),
921
+ roots: this.rootsFor(definition),
922
+ ...this.elicitationConfig ? {
923
+ onElicitation: (request, signal) => handleElicitationRequest({
924
+ ...this.elicitationConfig,
925
+ serverName: name,
926
+ onUrlAccepted: (elicitationId) => this.rememberUrlElicitation(name, elicitationId)
927
+ }, request, signal)
928
+ } : {},
929
+ ...this.samplingConfig ? {
930
+ onSampling: (request, signal) => handleSamplingRequest({
931
+ ...this.samplingConfig,
932
+ serverName: name,
933
+ getSignal: () => combineAbortSignals(this.runtimeSignal, signal)
934
+ }, request)
935
+ } : {}
936
+ });
937
+ if (attachment && connection.status === "connected") {
938
+ connection.taskSession = attachment.session;
939
+ connection.taskChannel = attachment.channel;
940
+ } else if (attachment) {
941
+ attachment.channel.rejectAll("MCP connection closed");
942
+ await attachment.session.close().catch(() => {});
943
+ }
944
+ } catch (error) {
945
+ logger.debug(`Task session attach failed for ${name}: ${String(error)}`);
946
+ }
947
+ }
948
+ return connection;
949
+ } catch (error) {
950
+ const abortCleanup = abortCleanupPromises.get(transport);
951
+ const abortCleanupFailed = error instanceof AggregateError && error.message === "MCP connection abort cleanup failed";
952
+ const cleanupResults = abortCleanupFailed ? [] : await Promise.allSettled([
953
+ abortCleanup ?? Promise.resolve().then(() => client.close())
954
+ ]);
955
+ const cleanupFailures = cleanupResults.flatMap((result) => result.status === "rejected" ? [result.reason] : []);
956
+ let reportedError = error;
957
+ if (cleanupFailures.length > 0) {
958
+ reportedError = new AggregateError([error, ...cleanupFailures], "MCP connection setup failed");
959
+ }
960
+ if (isUnauthorizedHttpError(error) && (supportsOAuth(definition) || typeof definition.auth === "object") && cleanupFailures.length === 0) {
961
+ if (!invalidated) {
962
+ invalidateAuthEntryCache(name);
963
+ invalidated = true;
964
+ }
965
+ return {
966
+ client,
967
+ transport,
968
+ definition,
969
+ tools: [],
970
+ resources: [],
971
+ prompts: [],
972
+ lastUsedAt: Date.now(),
973
+ inFlight: 0,
974
+ status: "needs-auth",
975
+ listenState: "disconnected",
976
+ credentialsInvalidated: invalidated
977
+ };
978
+ }
979
+ if (stderrTail.length > 0) {
980
+ const stderrText = stderrTail.toString("utf8").trim();
981
+ const lines = stderrText.split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
982
+ if (lines.length > 0) {
983
+ const baseMessage = reportedError instanceof Error ? reportedError.message : String(reportedError);
984
+ const detail = lines.slice(-MAX_CAPTURED_STDERR_LINES).join(" — ");
985
+ throw new Error(`${baseMessage} (${detail})`, { cause: reportedError });
986
+ }
987
+ }
988
+ throw reportedError;
989
+ }
990
+ }
991
+ async enrichHttpConnectionError(definition, error) {
992
+ if (error instanceof RegistrationRejectedError)
993
+ return explainRegistrationRejection(error, resolveServerUrl(definition));
994
+ const originalMessage = error instanceof Error ? error.message : String(error);
995
+ if (networkFailureCodes(error, ["ECONNREFUSED"]).length > 0 && isLoopbackUrl(resolveServerUrl(definition))) {
996
+ const url = new URL(resolveServerUrl(definition));
997
+ return new Error(`${originalMessage} — Nothing is listening at ${url.origin}${url.pathname}. Start the app or local process that serves this MCP server.`, { cause: error });
998
+ }
999
+ if (process.platform === "darwin") {
1000
+ const codes = networkFailureCodes(error, LOCAL_NETWORK_FAILURE_CODES);
1001
+ if (codes.length > 0 && isLiteralLocalAddress(resolveServerUrl(definition))) {
1002
+ return new Error(`${originalMessage} — ${codes.join(", ")} — macOS Local Network Privacy may be blocking access. Check System Settings > Privacy & Security > Local Network for the app hosting DM; enable access if listed and restart it. Try launching DM from Terminal.app or SSH. Routing or firewall problems can also cause this error.`, { cause: error });
1003
+ }
1004
+ }
1005
+ if (isTransientHttpConnectError(error)) {
1006
+ return new Error(`${originalMessage} — endpoint is temporarily unavailable (HTTP 503)`, { cause: error });
1007
+ }
1008
+ try {
1009
+ const probe = await probeMcpEndpoint(resolveServerUrl(definition));
1010
+ return new Error(`${originalMessage} — probe: ${probe.classification}`, { cause: error });
1011
+ } catch {
1012
+ return error instanceof Error ? error : new Error(originalMessage);
1013
+ }
1014
+ }
1015
+ async connectClientWithAbort(client, transport, requestOptions, signal) {
1016
+ throwIfAborted(signal);
1017
+ let abortCleanup;
1018
+ const closeTransport = () => {
1019
+ abortCleanup = Promise.resolve().then(() => transport.close());
1020
+ abortCleanupPromises.set(transport, abortCleanup);
1021
+ };
1022
+ signal?.addEventListener("abort", closeTransport, { once: true });
1023
+ try {
1024
+ await abortable(client.connect(transport, requestOptions), signal);
1025
+ await abortCleanup;
1026
+ } catch (error) {
1027
+ if (abortCleanup) {
1028
+ try {
1029
+ await abortCleanup;
1030
+ } catch (cleanupError) {
1031
+ throw new AggregateError([error, cleanupError], "MCP connection abort cleanup failed");
1032
+ }
1033
+ }
1034
+ throw error;
1035
+ } finally {
1036
+ signal?.removeEventListener("abort", closeTransport);
1037
+ }
1038
+ }
1039
+ buildClientCapabilities(definition) {
1040
+ return {
1041
+ ...definition.openUi === false ? {} : { extensions: { "io.modelcontextprotocol/ui": { mimeTypes: [RESOURCE_MIME_TYPE] } } },
1042
+ ...this.samplingConfig ? { sampling: {} } : {},
1043
+ ...this.rootsFor(definition) ? { roots: {} } : {},
1044
+ ...this.elicitationConfig ? {
1045
+ elicitation: {
1046
+ form: {},
1047
+ ...this.elicitationConfig.allowUrl ? { url: {} } : {}
1048
+ }
1049
+ } : {}
1050
+ };
1051
+ }
1052
+ rootsFor(definition) {
1053
+ if (this.defaultCwd === undefined || definition.roots === false)
1054
+ return;
1055
+ return [{ uri: pathToFileURL(this.defaultCwd).href, name: basename(this.defaultCwd) }];
1056
+ }
1057
+ createClient(serverName, definition) {
1058
+ const capabilities = this.buildClientCapabilities(definition);
1059
+ const versionNegotiation = resolveVersionNegotiation(definition);
1060
+ let client;
1061
+ client = new AdapterClient({ name: `dm-mcp-${serverName}`, version: "1.0.0" }, {
1062
+ jsonSchemaValidator: createJsonSchemaValidator(),
1063
+ ...versionNegotiation ? { versionNegotiation } : {},
1064
+ ...Object.keys(capabilities).length > 0 ? { capabilities } : {},
1065
+ listChanged: {
1066
+ tools: {
1067
+ onChanged: (error, tools) => {
1068
+ this.handleToolsListChanged(serverName, client, error, tools);
1069
+ }
1070
+ },
1071
+ resources: {
1072
+ onChanged: (error, resources) => {
1073
+ this.handleResourcesListChanged(serverName, client, error, resources);
1074
+ }
1075
+ },
1076
+ prompts: {
1077
+ onChanged: (error, prompts) => {
1078
+ this.handlePromptsListChanged(serverName, client, error, prompts);
1079
+ }
1080
+ }
1081
+ }
1082
+ });
1083
+ clientMetadata.set(client, () => client.requestMetadata());
1084
+ const roots = this.rootsFor(definition);
1085
+ if (roots)
1086
+ client.setRequestHandler("roots/list", () => ({ roots }));
1087
+ let logPath;
1088
+ client.setNotificationHandler("notifications/message", (notification) => {
1089
+ appendServerLogMessage(logPath ??= getAgentPath("mcp.log"), serverName, notification.params);
1090
+ });
1091
+ if (this.samplingConfig) {
1092
+ registerSamplingHandler(client, { ...this.samplingConfig, serverName });
1093
+ }
1094
+ if (this.elicitationConfig) {
1095
+ registerElicitationHandler(client, {
1096
+ ...this.elicitationConfig,
1097
+ serverName,
1098
+ onUrlAccepted: (elicitationId) => this.rememberUrlElicitation(serverName, elicitationId)
1099
+ });
1100
+ if (this.elicitationConfig.allowUrl) {
1101
+ client.setNotificationHandler("notifications/elicitation/complete", (notification) => {
1102
+ if (this.runtimeSignal?.aborted)
1103
+ return;
1104
+ const accepted = this.acceptedUrlElicitations.get(serverName);
1105
+ if (!accepted?.delete(notification.params.elicitationId))
1106
+ return;
1107
+ this.touch(serverName);
1108
+ this.elicitationConfig?.ui.notify(`MCP browser interaction for ${serverName} completed. You can retry the tool now.`, "info");
1109
+ });
1110
+ }
1111
+ }
1112
+ return client;
1113
+ }
1114
+ handleToolsListChanged(serverName, client, error, tools) {
1115
+ if (error) {
1116
+ logger.debug(`MCP: tools/list_changed refresh failed for ${serverName}: ${error.message}`);
1117
+ return;
1118
+ }
1119
+ if (!tools)
1120
+ return;
1121
+ const connection = this.connections.get(serverName);
1122
+ if (!connection || connection.client !== client || connection.status !== "connected")
1123
+ return;
1124
+ connection.tools = tools;
1125
+ connection.toolsRevision = (connection.toolsRevision ?? 0) + 1;
1126
+ this.publishMetadataChanged(serverName, connection, "tools-list-changed");
1127
+ }
1128
+ handlePromptsListChanged(serverName, client, error, prompts) {
1129
+ if (error) {
1130
+ logger.debug(`MCP: prompts/list_changed refresh failed for ${serverName}: ${error.message}`);
1131
+ return;
1132
+ }
1133
+ if (!prompts)
1134
+ return;
1135
+ const connection = this.connections.get(serverName);
1136
+ if (!connection || connection.client !== client || connection.status !== "connected")
1137
+ return;
1138
+ connection.prompts = prompts;
1139
+ connection.promptDiscoveryFailed = false;
1140
+ this.publishMetadataChanged(serverName, connection, "prompts-list-changed");
1141
+ }
1142
+ handleResourcesListChanged(serverName, client, error, resources) {
1143
+ if (error) {
1144
+ logger.debug(`MCP: resources/list_changed refresh failed for ${serverName}: ${error.message}`);
1145
+ return;
1146
+ }
1147
+ if (!resources)
1148
+ return;
1149
+ const connection = this.connections.get(serverName);
1150
+ if (!connection || connection.client !== client || connection.status !== "connected")
1151
+ return;
1152
+ connection.resources = resources;
1153
+ connection.resourceDiscoveryFailed = false;
1154
+ this.publishMetadataChanged(serverName, connection, "resources-list-changed");
1155
+ }
1156
+ async handleUrlElicitationRequired(serverName, error) {
1157
+ if (this.runtimeSignal?.aborted || !this.elicitationConfig?.allowUrl)
1158
+ return "cancel";
1159
+ for (const params of error.elicitations) {
1160
+ const result = await handleUrlElicitation({
1161
+ ...this.elicitationConfig,
1162
+ serverName,
1163
+ onUrlAccepted: (elicitationId) => this.rememberUrlElicitation(serverName, elicitationId)
1164
+ }, params);
1165
+ if (result.action !== "accept")
1166
+ return result.action;
1167
+ }
1168
+ return "accept";
1169
+ }
1170
+ rememberUrlElicitation(serverName, elicitationId) {
1171
+ if (this.runtimeSignal?.aborted)
1172
+ return;
1173
+ this.touch(serverName);
1174
+ let accepted = this.acceptedUrlElicitations.get(serverName);
1175
+ if (!accepted) {
1176
+ accepted = new Set;
1177
+ this.acceptedUrlElicitations.set(serverName, accepted);
1178
+ }
1179
+ accepted.add(elicitationId);
1180
+ }
1181
+ async connectHttpClient(definition, serverName, requestOptions, signal, traceObserver, credentialsInvalidated = false, oauthAuthority, attemptOwner) {
1182
+ throwIfAborted(signal);
1183
+ const serverUrl = resolveServerUrl(definition);
1184
+ const url = new URL(serverUrl);
1185
+ const provider = typeof definition.auth === "object" ? definition.auth.provider : undefined;
1186
+ const literalHeaders = isBuiltInAgentPlugin(definition, "headers");
1187
+ const oauthEnabled = supportsOAuth(definition);
1188
+ let headers;
1189
+ if (literalHeaders) {
1190
+ headers = { ...definition.headers };
1191
+ } else if (oauthEnabled) {
1192
+ headers = Object.fromEntries(resolveOAuthHeaders(definition.headers));
1193
+ } else {
1194
+ headers = resolveCommandSecretsRecord(definition.headers, (key) => `MCP server "${serverName}" HTTP header "${key}"`) ?? {};
1195
+ }
1196
+ const commandBearer = definition.bearerToken?.startsWith("!") && !definition.bearerToken.startsWith("!!") ? definition.bearerToken : undefined;
1197
+ let bearerCommandResolver;
1198
+ if (definition.auth === "bearer") {
1199
+ if (commandBearer) {
1200
+ bearerCommandResolver = new BearerCommandResolver(commandBearer, `MCP server "${serverName}" HTTP bearer token`);
1201
+ await bearerCommandResolver.resolve(signal);
1202
+ } else {
1203
+ const token = resolveBearerToken(definition) ?? (definition.bearerToken === undefined && definition.bearerTokenEnv === undefined && definition.bearerTokenStore === true ? getBearerTokenForUrl(serverName, serverUrl) : undefined);
1204
+ if (token)
1205
+ headers["Authorization"] = `Bearer ${token}`;
1206
+ }
1207
+ }
1208
+ for (const [name, value] of Object.entries(headers)) {
1209
+ try {
1210
+ new Headers({ [name]: value });
1211
+ } catch {
1212
+ throw new Error(`MCP server "${serverName}" HTTP header "${name}" has an invalid name or value`);
1213
+ }
1214
+ }
1215
+ const requestInit = !oauthEnabled && Object.keys(headers).length > 0 ? { headers } : undefined;
1216
+ const serviceHeaders = oauthEnabled ? new Headers(headers) : new Headers;
1217
+ let caFetch = createCaFetch(definition);
1218
+ try {
1219
+ const createAuthProvider = () => {
1220
+ const currentConnectAttempt = this.connectAttempts.get(serverName);
1221
+ const currentReconnectAttempt = this.reconnectAttempts.get(serverName);
1222
+ if (currentConnectAttempt && currentConnectAttempt !== attemptOwner || currentReconnectAttempt && currentReconnectAttempt !== attemptOwner) {
1223
+ throw new Error(`MCP connection for ${serverName} was replaced while connecting`);
1224
+ }
1225
+ if (!oauthAuthority)
1226
+ throw new Error(`Missing OAuth authority for ${serverName}`);
1227
+ const provider = new McpOAuthProvider(serverName, serverUrl, extractOAuthConfig(definition), { onRedirect: async () => {} }, this.authStorageOptions, this.oauthRuntime?.signal, undefined, oauthAuthority);
1228
+ provider.setAuthFetch(createOAuthFetch(serverUrl, () => serviceHeaders, combineAbortSignals(this.oauthRuntime?.signal, signal), {
1229
+ ...caFetch ? { delegate: caFetch.fetch } : {}
1230
+ }));
1231
+ return provider;
1232
+ };
1233
+ let implicitStoredAuth;
1234
+ if (definition.auth === undefined && supportsOAuth(definition)) {
1235
+ try {
1236
+ implicitStoredAuth = inspectAuthForUrl(serverName, serverUrl, this.authStorageOptions);
1237
+ } catch {}
1238
+ }
1239
+ const hasImplicitStoredTokens = implicitStoredAuth?.status === "present" && implicitStoredAuth.entry.tokens !== undefined;
1240
+ if (hasImplicitStoredTokens)
1241
+ invalidateAuthEntryCache(serverName);
1242
+ let authState = supportsOAuth(definition) ? definition.auth === undefined ? hasImplicitStoredTokens ? { status: "implicit-stored", provider: createAuthProvider() } : { status: "implicit-deferred" } : { status: "explicit", provider: createAuthProvider() } : { status: "disabled" };
1243
+ const commandFetch = definition.requestHeadersCommand ? createRequestHeadersCommandFetch(definition.requestHeadersCommand, caFetch?.fetch) : caFetch?.fetch;
1244
+ const bearerFetch = bearerCommandResolver ? createBearerCommandFetch(bearerCommandResolver, commandFetch) : provider !== undefined ? createProviderTokenFetch(serverUrl, provider, this.providerToken, commandFetch) : commandFetch;
1245
+ const requestFetch = oauthEnabled ? createOAuthFetch(serverUrl, () => serviceHeaders, this.oauthRuntime?.signal, {
1246
+ timeout: false,
1247
+ ...bearerFetch ? { delegate: bearerFetch } : {}
1248
+ }) : bearerFetch;
1249
+ const attempt = async (kind) => {
1250
+ const authProvider = "provider" in authState ? authState.provider : undefined;
1251
+ let sseFetchFailure;
1252
+ const sseFailureCodes = kind !== "sse" ? [] : isLoopbackUrl(serverUrl) ? ["ECONNREFUSED"] : process.platform === "darwin" && isLiteralLocalAddress(serverUrl) ? LOCAL_NETWORK_FAILURE_CODES : [];
1253
+ const transportFetch = sseFailureCodes.length > 0 ? async (input, init) => {
1254
+ try {
1255
+ return await (requestFetch ?? globalThis.fetch)(input, init);
1256
+ } catch (error) {
1257
+ if (networkFailureCodes(error, sseFailureCodes).length > 0)
1258
+ sseFetchFailure = error;
1259
+ throw error;
1260
+ }
1261
+ } : requestFetch;
1262
+ const transportOptions = {
1263
+ ...requestInit !== undefined ? { requestInit } : {},
1264
+ ...transportFetch !== undefined ? { fetch: transportFetch } : {},
1265
+ ...authProvider !== undefined ? { authProvider } : {},
1266
+ ...authProvider !== undefined && definition.oauth !== false && definition.oauth?.skipIssuerMetadataValidation === true ? { skipIssuerMetadataValidation: true } : {}
1267
+ };
1268
+ const baseTransport = kind === "streamable-http" ? new StreamableHTTPClientTransport(url, transportOptions) : new SSEClientTransport(url, transportOptions);
1269
+ const transport = traceObserver ? wrapTransportWithMcpTrace(baseTransport, serverName, kind, traceObserver) : baseTransport;
1270
+ const client = this.createClient(serverName, definition);
1271
+ try {
1272
+ await this.connectClientWithAbort(client, transport, requestOptions, signal);
1273
+ return { status: "connected", client, transport };
1274
+ } catch (error) {
1275
+ if (error instanceof SseError && sseFetchFailure !== undefined) {
1276
+ error = new AggregateError([error, sseFetchFailure], error.message);
1277
+ }
1278
+ const abortCleanupFailed = error instanceof AggregateError && error.message === "MCP connection abort cleanup failed";
1279
+ if (!abortCleanupFailed) {
1280
+ try {
1281
+ await (abortCleanupPromises.get(transport) ?? client.close());
1282
+ } catch (cleanupError) {
1283
+ throw new AggregateError([error, cleanupError], "MCP HTTP connection cleanup failed");
1284
+ }
1285
+ }
1286
+ return { status: "failed", client, transport, error };
1287
+ }
1288
+ };
1289
+ let kind = definition.httpTransport ?? "streamable-http";
1290
+ let invalidated = credentialsInvalidated;
1291
+ for (;; ) {
1292
+ const result = await attempt(kind);
1293
+ if (result.status === "connected") {
1294
+ const ownedCa = caFetch;
1295
+ if (ownedCa) {
1296
+ const close = result.transport.close.bind(result.transport);
1297
+ const onclose = result.transport.onclose;
1298
+ result.transport.onclose = () => {
1299
+ ownedCa.close().catch((error) => {
1300
+ logger.debug(`MCP: CA dispatcher cleanup failed for ${serverName}: ${String(error)}`);
1301
+ });
1302
+ onclose?.();
1303
+ };
1304
+ result.transport.close = async () => {
1305
+ try {
1306
+ await close();
1307
+ } finally {
1308
+ await ownedCa.close();
1309
+ }
1310
+ };
1311
+ caFetch = undefined;
1312
+ }
1313
+ return { ...result, credentialsInvalidated: invalidated };
1314
+ }
1315
+ if (result.error instanceof AggregateError && result.error.message === "MCP connection abort cleanup failed") {
1316
+ throw result.error;
1317
+ }
1318
+ if (signal?.aborted)
1319
+ throwIfAborted(signal);
1320
+ if (authState.status === "implicit-deferred" && isUnauthorizedHttpError(result.error)) {
1321
+ authState = { status: "implicit-challenged", provider: createAuthProvider() };
1322
+ continue;
1323
+ }
1324
+ if (isUnauthorizedHttpError(result.error)) {
1325
+ if (supportsOAuth(definition) || provider !== undefined) {
1326
+ if (!invalidated) {
1327
+ invalidateAuthEntryCache(serverName);
1328
+ invalidated = true;
1329
+ }
1330
+ return {
1331
+ client: result.client,
1332
+ transport: result.transport,
1333
+ status: "needs-auth",
1334
+ credentialsInvalidated: invalidated
1335
+ };
1336
+ }
1337
+ throw result.error;
1338
+ }
1339
+ if (definition.httpTransport === undefined && kind === "streamable-http" && shouldFallbackToSse(result.error, definition)) {
1340
+ kind = "sse";
1341
+ continue;
1342
+ }
1343
+ throw result.error;
1344
+ }
1345
+ } finally {
1346
+ await caFetch?.close();
1347
+ }
1348
+ }
1349
+ async fetchAllTools(client, requestOptions) {
1350
+ const allTools = [];
1351
+ let cursor;
1352
+ let hints;
1353
+ let firstPage = true;
1354
+ do {
1355
+ const result = await client.listTools(cursor ? { cursor } : undefined, requestOptions);
1356
+ if (firstPage) {
1357
+ const ttlMs = typeof result.ttlMs === "number" && Number.isSafeInteger(result.ttlMs) && result.ttlMs >= 0 ? result.ttlMs : undefined;
1358
+ const cacheScope = result.cacheScope === "public" || result.cacheScope === "private" ? result.cacheScope : undefined;
1359
+ if (ttlMs !== undefined || cacheScope !== undefined) {
1360
+ hints = {
1361
+ ...ttlMs !== undefined ? { ttlMs } : {},
1362
+ ...cacheScope !== undefined ? { cacheScope } : {}
1363
+ };
1364
+ }
1365
+ firstPage = false;
1366
+ }
1367
+ allTools.push(...result.tools ?? []);
1368
+ cursor = result.nextCursor;
1369
+ } while (cursor);
1370
+ return { tools: allTools, ...hints !== undefined ? { hints } : {} };
1371
+ }
1372
+ async fetchAllPrompts(client, requestOptions) {
1373
+ const capabilities = client.getServerCapabilities?.();
1374
+ if (!capabilities?.prompts)
1375
+ return { prompts: [], failed: false };
1376
+ try {
1377
+ const prompts = [];
1378
+ let cursor;
1379
+ do {
1380
+ const result = await client.listPrompts(cursor ? { cursor } : undefined, requestOptions);
1381
+ prompts.push(...result.prompts ?? []);
1382
+ cursor = result.nextCursor;
1383
+ } while (cursor);
1384
+ return { prompts, failed: false };
1385
+ } catch (error) {
1386
+ if (requestOptions?.signal?.aborted)
1387
+ throwIfAborted(requestOptions.signal);
1388
+ if (isUnauthorizedHttpError(error))
1389
+ throw error;
1390
+ const message = error instanceof Error ? error.message : String(error);
1391
+ logger.debug(`MCP: prompts/list failed: ${message}`);
1392
+ return { prompts: [], failed: true };
1393
+ }
1394
+ }
1395
+ async fetchAllResources(client, requestOptions, strict = false) {
1396
+ const capabilities = client.getServerCapabilities?.();
1397
+ if (!capabilities?.resources)
1398
+ return { resources: [], failed: false };
1399
+ try {
1400
+ const allResources = [];
1401
+ let cursor;
1402
+ do {
1403
+ const result = await client.listResources(cursor ? { cursor } : undefined, requestOptions);
1404
+ allResources.push(...result.resources ?? []);
1405
+ cursor = result.nextCursor;
1406
+ } while (cursor);
1407
+ return { resources: allResources, failed: false };
1408
+ } catch (error) {
1409
+ if (requestOptions?.signal?.aborted) {
1410
+ throwIfAborted(requestOptions.signal);
1411
+ }
1412
+ if (isUnauthorizedHttpError(error))
1413
+ throw error;
1414
+ if (strict)
1415
+ throw error;
1416
+ return { resources: [], failed: true };
1417
+ }
1418
+ }
1419
+ attachAdapterNotificationHandlers(serverName, client) {
1420
+ client.setNotificationHandler("notifications/resources/updated", (notification) => {
1421
+ const uri = notification.params.uri;
1422
+ const connection = this.connections.get(serverName);
1423
+ if (!connection || connection.client !== client || connection.status !== "connected")
1424
+ return;
1425
+ for (const registration of this.resourceUpdatedListeners.values()) {
1426
+ if (registration.serverName === serverName && registration.uri === uri) {
1427
+ try {
1428
+ registration.listener(serverName, uri);
1429
+ } catch {}
1430
+ }
1431
+ }
1432
+ });
1433
+ client.setNotificationHandler(SERVER_STREAM_RESULT_PATCH_METHOD, { params: serverStreamResultPatchNotificationSchema.shape.params }, (params) => {
1434
+ const listener = this.uiStreamListeners.get(params.streamToken);
1435
+ if (!listener)
1436
+ return;
1437
+ listener(serverName, params);
1438
+ });
1439
+ }
1440
+ registerUiStreamListener(streamToken, listener) {
1441
+ this.uiStreamListeners.set(streamToken, listener);
1442
+ }
1443
+ removeUiStreamListener(streamToken) {
1444
+ this.uiStreamListeners.delete(streamToken);
1445
+ }
1446
+ async getPrompt(name, promptName, args, signal) {
1447
+ const connection = this.connections.get(name);
1448
+ if (!connection || connection.status !== "connected") {
1449
+ throw new Error(`Server "${name}" is not connected`);
1450
+ }
1451
+ try {
1452
+ this.touch(name);
1453
+ this.incrementInFlight(name);
1454
+ await this.ensureListen(name, connection);
1455
+ return await connection.client.getPrompt({ name: promptName, ...args ? { arguments: args } : {} }, this.getRequestOptions(name, signal));
1456
+ } finally {
1457
+ this.decrementInFlight(name);
1458
+ this.touch(name);
1459
+ }
1460
+ }
1461
+ async readResource(name, uri, signal) {
1462
+ if (isServerDisabled(this.connections.get(name)?.definition)) {
1463
+ throw new Error(`MCP server "${name}" is disabled`);
1464
+ }
1465
+ const connection = this.connections.get(name);
1466
+ if (!connection || connection.status !== "connected") {
1467
+ throw new Error(`Server "${name}" is not connected`);
1468
+ }
1469
+ try {
1470
+ this.touch(name);
1471
+ this.incrementInFlight(name);
1472
+ const refreshRead = await this.prepareResourceUse(name, uri, connection);
1473
+ const requestOptions = this.getRequestOptions(name, signal);
1474
+ return await connection.client.readResource({ uri }, refreshRead ? { ...requestOptions, cacheMode: "refresh" } : requestOptions);
1475
+ } finally {
1476
+ this.decrementInFlight(name);
1477
+ this.touch(name);
1478
+ }
1479
+ }
1480
+ async close(name) {
1481
+ this.closeGenerations.set(name, (this.closeGenerations.get(name) ?? 0) + 1);
1482
+ this.connectAttempts.get(name)?.abort(new Error(`MCP connection ${name} was closed`));
1483
+ this.reconnectAttempts.get(name)?.abort(new Error(`MCP connection ${name} was closed`));
1484
+ this.pendingMetadataPublications.delete(name);
1485
+ const pendingReconnect = this.reconnectPromises.get(name);
1486
+ const connection = this.connections.get(name);
1487
+ if (!connection) {
1488
+ const pendingClose = this.closePromises.get(name);
1489
+ if (pendingClose) {
1490
+ await pendingClose;
1491
+ return;
1492
+ }
1493
+ const pendingConnect = this.connectPromises.get(name);
1494
+ for (const pending of [pendingConnect, pendingReconnect]) {
1495
+ if (!pending)
1496
+ continue;
1497
+ try {
1498
+ await pending;
1499
+ } catch (error) {
1500
+ if (this.containsCleanupFailure(error))
1501
+ throw error;
1502
+ }
1503
+ }
1504
+ return;
1505
+ }
1506
+ connection.status = "closed";
1507
+ this.connections.delete(name);
1508
+ this.acceptedUrlElicitations.delete(name);
1509
+ const closing = this.disposeConnection(connection).finally(() => {
1510
+ if (this.closePromises.get(name) === closing)
1511
+ this.closePromises.delete(name);
1512
+ });
1513
+ this.closePromises.set(name, closing);
1514
+ await closing;
1515
+ if (pendingReconnect) {
1516
+ try {
1517
+ await pendingReconnect;
1518
+ } catch (error) {
1519
+ if (this.containsCleanupFailure(error))
1520
+ throw error;
1521
+ }
1522
+ }
1523
+ }
1524
+ async disposeConnection(connection) {
1525
+ const results = await Promise.allSettled([
1526
+ Promise.resolve().then(async () => {
1527
+ connection.taskChannel?.rejectAll("MCP connection closed");
1528
+ await connection.taskSession?.close();
1529
+ }).catch(() => {}),
1530
+ Promise.resolve().then(() => connection.client.close()),
1531
+ this.traceWriter?.flush() ?? Promise.resolve()
1532
+ ]);
1533
+ const failures = results.flatMap((result) => result.status === "rejected" ? [result.reason] : []);
1534
+ if (failures.length > 0)
1535
+ throw new AggregateError(failures, "MCP connection cleanup failed");
1536
+ }
1537
+ async closeAll() {
1538
+ this.stopped = true;
1539
+ const names = new Set([
1540
+ ...this.connections.keys(),
1541
+ ...this.connectPromises.keys(),
1542
+ ...this.reconnectPromises.keys()
1543
+ ]);
1544
+ for (const name of names) {
1545
+ this.closeGenerations.set(name, (this.closeGenerations.get(name) ?? 0) + 1);
1546
+ this.connectAttempts.get(name)?.abort(new Error(`MCP connection ${name} was closed`));
1547
+ this.reconnectAttempts.get(name)?.abort(new Error(`MCP connection ${name} was closed`));
1548
+ }
1549
+ const pendingConnects = [...this.connectPromises.values(), ...this.reconnectPromises.values()];
1550
+ const currentNames = [...this.connections.keys()];
1551
+ const pendingResults = await Promise.allSettled(pendingConnects);
1552
+ const results = await Promise.allSettled(currentNames.map((name) => this.close(name)));
1553
+ const lateNames = [...this.connections.keys()];
1554
+ const lateResults = await Promise.allSettled(lateNames.map((name) => this.close(name)));
1555
+ const failures = [...pendingResults, ...results, ...lateResults].flatMap((result) => result.status === "rejected" ? [result.reason] : []).filter((error) => this.containsCleanupFailure(error));
1556
+ this.uiStreamListeners.clear();
1557
+ this.resourceUpdatedListeners.clear();
1558
+ this.acceptedUrlElicitations.clear();
1559
+ this.pendingMetadataPublications.clear();
1560
+ this.samplingConfig = undefined;
1561
+ this.elicitationConfig = undefined;
1562
+ await this.traceWriter?.flush();
1563
+ if (failures.length > 0)
1564
+ throw new AggregateError(failures, "MCP manager cleanup failed");
1565
+ }
1566
+ containsCleanupFailure(error) {
1567
+ const pending = [error];
1568
+ const seen = new Set;
1569
+ while (pending.length > 0) {
1570
+ const current = pending.pop();
1571
+ if (!(current instanceof Error) || seen.has(current))
1572
+ continue;
1573
+ seen.add(current);
1574
+ if (current instanceof AggregateError) {
1575
+ if (/cleanup failed|setup failed/.test(current.message))
1576
+ return true;
1577
+ pending.push(...current.errors);
1578
+ }
1579
+ if (current.cause !== undefined)
1580
+ pending.push(current.cause);
1581
+ }
1582
+ return false;
1583
+ }
1584
+ isConnecting(name) {
1585
+ return this.connectPromises.has(name);
1586
+ }
1587
+ getConnection(name) {
1588
+ return this.connections.get(name);
1589
+ }
1590
+ getAllConnections() {
1591
+ return new Map(this.connections);
1592
+ }
1593
+ touch(name) {
1594
+ const connection = this.connections.get(name);
1595
+ if (connection) {
1596
+ connection.lastUsedAt = Date.now();
1597
+ }
1598
+ }
1599
+ incrementInFlight(name) {
1600
+ const connection = this.connections.get(name);
1601
+ if (connection) {
1602
+ connection.inFlight = (connection.inFlight ?? 0) + 1;
1603
+ }
1604
+ }
1605
+ decrementInFlight(name) {
1606
+ const connection = this.connections.get(name);
1607
+ if (connection && connection.inFlight) {
1608
+ connection.inFlight--;
1609
+ }
1610
+ }
1611
+ isIdle(name, timeoutMs) {
1612
+ const connection = this.connections.get(name);
1613
+ if (!connection || connection.status !== "connected")
1614
+ return false;
1615
+ if (connection.inFlight > 0 || (connection.activeProtocolOperations ?? 0) > 0)
1616
+ return false;
1617
+ return Date.now() - connection.lastUsedAt > timeoutMs;
1618
+ }
1619
+ }
1620
+ function resolveEnv(env, serverName, literalEnv = false, inheritEnv = true) {
1621
+ const resolved = {};
1622
+ if (inheritEnv) {
1623
+ for (const [key, value] of Object.entries(process.env)) {
1624
+ if (value !== undefined)
1625
+ resolved[key] = value;
1626
+ }
1627
+ }
1628
+ if (literalEnv)
1629
+ return env ? { ...resolved, ...env } : resolved;
1630
+ const overrides = resolveCommandSecretsRecord(env, (key) => `MCP server "${serverName}" stdio env "${key}"`);
1631
+ return overrides ? { ...resolved, ...overrides } : resolved;
1632
+ }
1633
+ function normalizeRequestTimeoutMs(timeoutMs) {
1634
+ return typeof timeoutMs === "number" && Number.isFinite(timeoutMs) && timeoutMs > 0 ? timeoutMs : undefined;
1635
+ }